@noorm/marie-cli 0.1.0 β 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +83 -49
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,94 +1,128 @@
|
|
|
1
1
|
# Marie: The Sovereign AI Architecture πΈ
|
|
2
2
|
|
|
3
|
-
[](https://www.npmjs.com/package/marie-cli)
|
|
3
|
+
[](https://www.npmjs.com/package/@noorm/marie-cli)
|
|
4
4
|
[](LICENSE.md)
|
|
5
5
|
[](CONTRIBUTING.md)
|
|
6
6
|
|
|
7
|
-
>
|
|
7
|
+
> **Marie is a high-fidelity AI coding agent for developers who care about performance and architecture.**
|
|
8
8
|
|
|
9
|
-
Marie is
|
|
9
|
+
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.
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
##
|
|
13
|
+
## π The Philosophy: Joy Zoning
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
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:
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
* **
|
|
20
|
-
|
|
21
|
-
|
|
17
|
+
* **Joyful Code β¨ (Domain)**: Pure logic. No adapters. No leakage. This is where your intent lives.
|
|
18
|
+
* **Infrastructure ποΈ**: Coordination and integration. The layer that absorbs the world's complexity.
|
|
19
|
+
* **Plumbing π§**: Execution mechanics and side effects. The reliable primitives that move the bytes.
|
|
20
|
+
|
|
21
|
+
> **Every file must have a home. Every layer must respect its boundary. Entropy must not rise.**
|
|
22
22
|
|
|
23
23
|
---
|
|
24
24
|
|
|
25
|
-
##
|
|
25
|
+
## π‘ The Sentinel Engine
|
|
26
|
+
|
|
27
|
+
Marie includes a built-in architecture guardian. She watches the evolution of your codebase with absolute precision:
|
|
26
28
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
* **
|
|
30
|
-
* **
|
|
31
|
-
* **
|
|
29
|
+
* **High-fidelity import resolution** through real path analysis.
|
|
30
|
+
* **Circular dependency detection** to prevent vertical rot.
|
|
31
|
+
* **Semantic duplication detection** using token-normalized hashing.
|
|
32
|
+
* **Weighted entropy scoring** to monitor system health.
|
|
33
|
+
* **Monotonic "no regression" enforcement** for architectural rules.
|
|
34
|
+
* **Persistent structural state tracking** across sessions.
|
|
32
35
|
|
|
33
|
-
|
|
34
|
-
A deep, spatial integration into your primary development environment.
|
|
35
|
-
* **Contextual Anchoring**: Marie maintains a durable strategic map of your architecture.
|
|
36
|
-
* **Autonomy Calibration**: Orchestrate the agent's agencyβfrom `Balanced` collaboration to `High-Autonomy` execution.
|
|
37
|
-
* **Webview Mastery**: A premium, responsive UI that feels like a natural extension of the editor.
|
|
36
|
+
**Architecture isnβt documentation. Itβs enforced.**
|
|
38
37
|
|
|
39
38
|
---
|
|
40
39
|
|
|
41
|
-
##
|
|
40
|
+
## π° Two Interfaces. One Intelligence.
|
|
41
|
+
|
|
42
|
+
Marie bridges the gap between the editor and the executor, providing a consistent intelligence across two primary interfaces:
|
|
42
43
|
|
|
43
|
-
|
|
44
|
+
### 1οΈβ£ CLI β The Command Deck
|
|
45
|
+
*A high-velocity terminal experience built for flow.*
|
|
46
|
+
* **Real-time reasoning stream**: Watch the cognitive process as it unfolds.
|
|
47
|
+
* **Structured multi-pass execution**: Planning, implementation, and verification in one loop.
|
|
48
|
+
* **Surgical lint repair**: Automatic correction of mechanical errors.
|
|
49
|
+
* **Architectural enforcement on write**: Preventing violations before they hit the disk.
|
|
50
|
+
* **Provider-agnostic model support**: Switch engines without losing the mission.
|
|
44
51
|
|
|
45
|
-
|
|
46
|
-
*
|
|
47
|
-
* **
|
|
52
|
+
### 2οΈβ£ VS Code β The Integrated Bridge
|
|
53
|
+
*Deep editor integration for strategic oversight.*
|
|
54
|
+
* **Persistent architectural context**: Marie lives inside your project structure.
|
|
55
|
+
* **Autonomy calibration**: From "Balanced" assistance to "High Autonomy" execution.
|
|
56
|
+
* **Strategic multi-file transformations**: Coordinated changes across multiple modules.
|
|
57
|
+
* **Visual Sentinel awareness**: Real-time feedback on Joy Zoning violations.
|
|
58
|
+
|
|
59
|
+
**Marie understands your codebase as a system β not a prompt.**
|
|
48
60
|
|
|
49
61
|
---
|
|
50
62
|
|
|
51
|
-
##
|
|
63
|
+
## β‘ The Ascension Engine
|
|
52
64
|
|
|
53
|
-
|
|
65
|
+
Marie's execution model is state-driven, powered by the **Ascension Protocol**:
|
|
54
66
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
67
|
+
* **Multi-pass structured planning**: Logic is derived before a single line is written.
|
|
68
|
+
* **Self-correction loops**: Continuous validation against test suites and linters.
|
|
69
|
+
* **Entropy-aware repair**: Fixing bugs without introducing architectural debt.
|
|
70
|
+
* **Architecture-safe refactoring**: Moving code across zones with safety guarantees.
|
|
59
71
|
|
|
60
|
-
|
|
72
|
+
**High confidence enables high autonomy. Low confidence triggers surgical correction.**
|
|
61
73
|
|
|
62
|
-
|
|
63
|
-
# Launch the Command Deck
|
|
64
|
-
marie
|
|
65
|
-
```
|
|
74
|
+
---
|
|
66
75
|
|
|
67
|
-
|
|
76
|
+
## π Installation
|
|
68
77
|
|
|
69
|
-
Marie
|
|
78
|
+
Install Marie globally for universal sovereignty:
|
|
70
79
|
|
|
71
80
|
```bash
|
|
72
|
-
|
|
81
|
+
npm install -g @noorm/marie-cli
|
|
73
82
|
```
|
|
74
83
|
|
|
84
|
+
### Quick Start
|
|
85
|
+
1. **Launch**: Simply type `marie` in your terminal.
|
|
86
|
+
2. **Credentials**:
|
|
87
|
+
```bash
|
|
88
|
+
export ANTHROPIC_API_KEY=your_key_here
|
|
89
|
+
```
|
|
90
|
+
*Or configure via persistent storage at `~/.marie/config.json`*
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## π Provider-Agnostic Core
|
|
95
|
+
|
|
96
|
+
Choose your engine. Marie adapts her execution style to the provider while maintaining the doctrine:
|
|
97
|
+
* **Anthropic** (Claude 3.5 Sonnet)
|
|
98
|
+
* **OpenRouter** (For the vast frontier of models)
|
|
99
|
+
* **Cerebras** (For high-velocity inference)
|
|
100
|
+
* **Any compatible endpoint**
|
|
101
|
+
|
|
75
102
|
---
|
|
76
103
|
|
|
77
|
-
##
|
|
104
|
+
## π― Why Marie Exists
|
|
105
|
+
|
|
106
|
+
AI coding tools are powerful β but chaotic. Most tools optimize for *completion*; Marie optimizes for *system health*.
|
|
78
107
|
|
|
79
|
-
Marie
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
108
|
+
**Marie exists for developers who:**
|
|
109
|
+
* Want structure, not spray-and-pray.
|
|
110
|
+
* Care about separation of concerns.
|
|
111
|
+
* Value long-term code health.
|
|
112
|
+
* Refuse entropy creep.
|
|
113
|
+
* Want autonomy without architectural collapse.
|
|
114
|
+
|
|
115
|
+
**Engineering is not just output. Itβs discipline.**
|
|
83
116
|
|
|
84
117
|
---
|
|
85
118
|
|
|
86
119
|
## π€ Join the Convergence
|
|
87
120
|
|
|
88
|
-
Marie is
|
|
121
|
+
Marie is an invitation to build intentionally. Not louder. Not faster. **Better.**
|
|
89
122
|
|
|
90
|
-
|
|
123
|
+
Welcome to Marie.
|
|
91
124
|
|
|
92
125
|
---
|
|
93
|
-
|
|
94
|
-
|
|
126
|
+
|
|
127
|
+
**License**: Apache-2.0
|
|
128
|
+
**Crafted by CardSorting** | [GitHub](https://github.com/CardSorting/Marie-Coder-New-the-vatican)
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@noorm/marie-cli",
|
|
3
3
|
"displayName": "Marie",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.2",
|
|
5
5
|
"description": "Marie: A high-fidelity, autonomous AI coding architecture designed for Technical Sovereignty.",
|
|
6
6
|
"publisher": "cardsorting",
|
|
7
7
|
"author": "CardSorting <https://github.com/CardSorting>",
|