npm package: @noorm/marie-cli
Description: A sentient AI pair programmer for your terminal
Author: DreamBeesAI
Latest version: 0.1.25

# Marie: The Sovereign AI Architecture 🌸

[![NPM Version](https://img.shields.io/npm/v/@noorm/marie-cli.svg?style=flat-square&color=FF69B4)](https://www.npmjs.com/package/@noorm/marie-cli)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg?style=flat-square)](LICENSE.md)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](CONTRIBUTING.md)

> **Marie is a high-fidelity AI coding agent for developers who care about performance and architecture.**

Marie is an autonomous coding agent designed to transform chaotic AI-assisted development into structured, disciplined execution. She doesn’t just generate code — she enforces architectural integrity.

---

## 🏛 The Philosophy: Joy Zoning

Marie operates on a strict three-layer model to protect your cognitive flow. This isn't just a suggestion; it is the fundamental law of the ecosystem:

*   **Joyful Code ✨ (Domain)**: Pure logic. No adapters. No leakage. This is where your intent lives.
*   **Infrastructure 🏗️**: Coordination and integration. The layer that absorbs the world's complexity.
*   **Plumbing 🔧**: Execution mechanics and side effects. The reliable primitives that move the bytes.

> **Every file must have a home. Every layer must respect its boundary. Entropy must not rise.**

---

## 🛡 The Sentinel Engine

Marie includes a built-in architecture guardian. She watches the evolution of your codebase with absolute precision:

*   **High-fidelity import resolution** through real path analysis.
*   **Circular dependency detection** to prevent vertical rot.
*   **Semantic duplication detection** using token-normalized hashing.
*   **Weighted entropy scoring** to monitor system health.
*   **Monotonic "no regression" enforcement** for architectural rules.
*   **Persistent structural state tracking** across sessions.

**Architecture isn’t documentation. It’s enforced.**

---

## 🛰 The Command Deck: CLI Supremacy

Marie provides a high-velocity terminal experience built for flow.

*   **Real-time reasoning stream**: Watch the cognitive process as it unfolds via Ink-powered UI.
*   **Structured multi-pass execution**: Planning, implementation, and verification in one loop.
*   **Surgical lint repair**: Automatic correction of mechanical errors.
*   **Architectural enforcement on write**: Preventing violations before they hit the disk.
*   **Provider-agnostic model support**: Switch engines without losing the mission.

**Marie understands your codebase as a system — not a prompt.**

---

## ⚡ The Ascension Engine

Marie's execution model is state-driven, powered by the **Ascension Protocol**:

*   **Multi-pass structured planning**: Logic is derived before a single line is written.
*   **Self-correction loops**: Continuous validation against test suites and linters.
*   **Entropy-aware repair**: Fixing bugs without introducing architectural debt.
*   **Architecture-safe refactoring**: Moving code across zones with safety guarantees.

**High confidence enables high autonomy. Low confidence triggers surgical correction.**

---

## 🚀 Installation

Install Marie globally for universal sovereignty:

```bash
npm install -g @noorm/marie-cli
```

### Quick Start
1.  **Launch**: Simply type `marie` in your terminal.
2.  **Credentials**: 
    ```bash
    export MARIECODER_API_KEY=your_key_here
    # OR
    export OPENROUTER_API_KEY=your_key_here
    ```
    *Or configure via persistent storage at `~/.marie/config.json`*

---

## 💠 Provider-Agnostic Core

Choose your engine. Marie adapts her execution style to the provider while maintaining the doctrine:
*   **MarieCoder** (OptimizedGLM)
*   **OpenRouter** (For the vast frontier of models)
*   **Any compatible endpoint**

---

## 🎯 Why Marie Exists

AI coding tools are powerful — but chaotic. Most tools optimize for *completion*; Marie optimizes for *system health*.

**Marie exists for developers who:**
*   Want structure, not spray-and-pray.
*   Care about separation of concerns.
*   Value long-term code health.
*   Refuse entropy creep.
*   Want autonomy without architectural collapse.

**Engineering is not just output. It’s discipline.**

---

## 🤝 Join the Convergence

Marie is an invitation to build intentionally. Not louder. Not faster. **Better.**

Welcome to Marie.

---

**License**: Apache-2.0  
**Crafted by CardSorting** | [GitHub](https://github.com/CardSorting/Marie-Coder-New-the-vatican)