mycontext-cli 4.2.14 → 4.2.15

package/README.md

@@ -9,66 +9,85 @@ MyContext is not an AI code generator—it's a natural-language-to-project compi
 
 ---
 
-## 🚀 NEW: Phase 0.7 — Premium Product Engineering (VERIFIED ✓)
+## 🧠 Core Philosophy
 
-MyContext has evolved from a basic scaffolder into a high-fidelity **Product Engineering Partner**.
+### Zero-Hallucination Compilation
+Most AI tools act as "chat-driven coders" that guess your requirements. MyContext acts as a **Natural Language Compiler**:
+1. **Analyze**: LLM parses your intent into a strict JSON manifest (FSR).
+2. **Clarify**: The CLI identifies gaps and prompts you *before* any code is written.
+3. **Generate**: Deterministic script templates render valid, typed Next.js code.
 
-### 1. Smart Layout Engine (8/12 Grid)
-MyContext now intelligently places components based on their functional `weight`.
-- **Primary Components**: Automatically assigned to the 8-column main content area.
-- **Secondary Components**: Placed in a 4-column side-rail for tools, status, or navigation.
-- **Result**: Perfectly balanced, premium-grade layouts without manual CSS tweaking.
+### The Living Brain (`.mycontext/`)
+Every project is governed by a local "brain" folder that ensures your code, types, and design tokens never drift:
+- `context.json`: The master source of truth for your project features.
+- `design_manifest.json`: Your premium design tokens and layout rules.
+- `registry/`: Automated tracking of all generated components and actions.
 
-### 2. Test-Mode Fast-Forward
-Generated stateful components are now "test-aware."
-- When `window.__MYCONTEXT_TEST_MODE__` is detected, 3-second "AI thinking" simulations fast-forward to **100ms**.
-- **Result**: Blazing fast automated test suites (60x speed improvement).
+---
+
+## 🚀 NEW: Phase 0.7 Premium Features (VERIFIED ✓)
+
+- **Smart Layout Engine**: Autonomic 8/12 grid placement based on component `weight`.
+- **Test-Mode Fast-Forward**: Detects `__MYCONTEXT_TEST_MODE__` to speed up animations 60x.
+- **Auto-Test Generation**: `mycontext test:generate` creates Playwright specs from your FSR.
+- **Density Guardrails**: Visual checks to prevent "rammed UI" and visual clutter.
+
+---
+
+## 🏗️ Full Project Workflow
 
-### 3. FSR-Driven Test Generation (`mycontext test:generate`)
-Stop writing boilerplate tests. MyContext now generates Playwright specs directly from your FSR (Feature Structured Representation).
+### 1. Initialization (`mycontext init`)
+Set up your framework (InstantDB, Next.js, or shadcn) and establish the project brain.
 ```bash
-mycontext test:generate --feature <feature-name>
+mycontext init --interactive
 ```
-- **Result**: Functional test coverage for your entire feature flow in seconds.
+*AI auto-infers 90% of your spec, reducing setup from 15 mins to 2 mins.*
 
-### 4. Visual Density Guardrails
-Built-in vision-test detection for "Rammed UI" syndrome.
+### 2. Feature Planning (`mycontext plan`)
+Translate a feature request into a strict FSR (Feature Structured Representation).
 ```bash
-mycontext test:vision --check-density
+mycontext plan "A gallery for removed background images with token display"
 ```
-- Automatically flags nested card patterns and visual clutter to maintain a premium aesthetic score.
-
----
 
-## 🏗️ How it Works
+### 3. Deterministic Build (`mycontext build`)
+Compile your FSR into production-ready code.
+```bash
+mycontext build --feature gallery
+```
 
-### 1. The Planner (`mycontext plan`)
-Listens to your natural language intent and auto-infers up to **90% of your specification**. 
-- It decomposes your project into a strict, validated JSON AST called the **Feature Structured Representation (FSR)**.
-- Reduces setup time from 15 minutes to **2 minutes**.
+### 4. Continuous Sync (`mycontext sync`)
+Automatically update your documentation and `context.json` brain as your code evolves.
+```bash
+mycontext sync --readme
+```
 
-### 2. The Generator (`mycontext build`)
-Deterministically renders the FSR AST into high-fidelity Next.js output files.
-- **Pages & Layouts**: Next.js 15+ App Router patterns.
-- **Components**: shadcn/ui integration with premium design tokens.
-- **Logic**: Decoupled event-driven architecture using DOM events.
+### 5. Diagnostics (`mycontext doctor`)
+Verify type safety, catch schema drift, and check for "as any" usage.
+```bash
+mycontext doctor --verbose
+```
 
 ---
 
-## 📦 Quick Start
-
-### Installation
+## 📦 Installation
 ```bash
-# Install globally
 npm install -g mycontext-cli
 ```
 
-### Usage Workflow
-1. **Plan**: `mycontext plan "build a background removal tool with token tracking"`
-2. **Review**: Adjust the generated `.fsr.json` blueprint.
-3. **Build**: `mycontext build --feature removebg`
-4. **Test**: `mycontext test:generate --feature removebg`
-5. **Score**: `mycontext build --score` (Verify premium design tokens)
+---
+
+## 🛣️ Roadmap
+- [x] **Phase 0.6**: Deterministic Scaffolding & Token Tracking
+- [x] **Phase 0.7**: Premium Layout Engine & Test-Mode
+- [ ] **Phase 1**: Global Registry & Multi-Agent Orchestration
+- [ ] **Phase 2**: Granular component-level targeted LLM refactors
+
+---
+
+## 📄 License & Links
+MIT © [MyContext Team](https://github.com/farajabien/mycontext-cli)
+- [Documentation](https://mycontext.framer.website)
+- [NPM: mycontext-cli](https://www.npmjs.com/package/mycontext-cli)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mycontext-cli",
-  "version": "4.2.14",
+  "version": "4.2.15",
   "description": "CLI tool for spec-driven development - Generate comprehensive context, visual screens, and scaffolding for AI-powered coding",
   "main": "dist/cli.js",
   "bin": {