multimodel-dev-os 2.0.1 → 2.8.0

package/README.md

@@ -5,12 +5,13 @@
 </p>
 
 <p align="center">
-  <b>One portable AI Dev OS for multimodel coding workflows.</b>
+  <b>One workspace config. Every AI coding tool. Zero lock-in.</b><br>
+  <sub>Stop copy-pasting AI rules between Cursor, Claude, Gemini, Codex, and VS Code. Start shipping.</sub>
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/multimodel-dev-os"><img src="https://img.shields.io/npm/v/multimodel-dev-os.svg?color=blue&style=flat-square" alt="NPM Version"></a>
-  <a href="https://www.npmjs.com/package/multimodel-dev-os"><img src="https://img.shields.io/badge/npm-package-cb3837.svg?style=flat-square" alt="NPM Package"></a>
+  <a href="https://www.npmjs.com/package/multimodel-dev-os"><img src="https://img.shields.io/npm/dm/multimodel-dev-os.svg?color=orange&style=flat-square" alt="NPM Downloads"></a>
   <a href="https://github.com/rizvee/multimodel-dev-os/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/multimodel-dev-os.svg?color=green&style=flat-square" alt="License"></a>
   <a href="https://github.com/rizvee/multimodel-dev-os/releases"><img src="https://img.shields.io/github/v/release/rizvee/multimodel-dev-os?color=indigo&style=flat-square" alt="GitHub Release"></a>
   <a href="https://github.com/rizvee/multimodel-dev-os/actions"><img src="https://img.shields.io/github/actions/workflow/status/rizvee/multimodel-dev-os/verify.yml?branch=main&style=flat-square&label=verification" alt="Build Verification"></a>
@@ -19,194 +20,171 @@
 
 ---
 
-## One portable AI Dev OS for Codex, Antigravity, Cursor, Claude, Gemini, VS Code, and multimodel coding workflows.
+## The Problem
 
-Initialize a stable workspace instantly:
+You use **Cursor** for autocomplete, **Claude Code** for terminal ops, **Gemini** for deep audits. Every tool switch loses your context. Every `.cursorrules` / `CLAUDE.md` / `.vscode/settings.json` change drifts out of sync with the others. Prompts bloat, tokens waste, onboarding breaks.
+
+## The Fix: 30 Seconds
 
 ```bash
 npx multimodel-dev-os@latest init
 ```
 
----
+Your workspace now has a **single source of truth** that every AI coding tool reads automatically — no config duplication, no context loss, no vendor lock-in.
 
-<p align="center">
-  <img src="assets/social-preview.svg" alt="MultiModel Dev OS Banner" width="100%">
-</p>
+> Already have a project? Onboard it safely:
+> ```bash
+> npx multimodel-dev-os@latest onboard analyze
+> ```
 
 ---
 
-## Why This Exists
-
-AI pair programmers are lightning-fast, but switching between them introduces context fragmentation:
-1. **Context Loss:** You use **Cursor** for autocomplete, **Claude Code** for command execution, and **Gemini/Antigravity** for deep audits. Every switch forces you to rebuild context.
-2. **Instruction Drift:** Different tools look for different config files (`.cursorrules`, `CLAUDE.md`, `.vscode/settings.json`, `.gemini/settings.json`). Modifying style rules or build parameters in one place leaves the others outdated.
+## Key Features
 
-`multimodel-dev-os` solves this by establishing a single source of truth in your repository: four root contracts (`AGENTS.md`, `MEMORY.md`, `TASKS.md`, `RUNBOOK.md`) and a `.ai/` directory that bridges them to all major tools dynamically.
+| | Feature | What It Does |
+|:---|:---|:---|
+| 🔄 | **Universal Adapter Sync** | Write rules once → auto-syncs to `.cursorrules`, `CLAUDE.md`, `.vscode/`, `.gemini/`, and more |
+| ⚡ | **Caveman Mode** | Slash prompt token overhead by **~79%** for tight API budgets |
+| 🧠 | **Intelligence Engine** | Hash-compressed memory, feedback learning, self-improvement proposals with HITL safety gates |
+| 📁 | **Repo Onboarding** | Analyze existing projects, recommend templates, and bootstrap configs without breaking anything |
+| 🔧 | **Zero Dependencies** | Pure Node.js CLI — no runtime, no build step, no package manager lock-in |
+| 🛡️ | **214+ Quality Gates** | Built-in `validate`, `doctor`, and `verify` commands with strict structural assertions |
 
 ---
 
-## What You Get
-
-A standard installation scaffolds a lightweight, zero-runtime-dependency workspace hierarchy:
-
-```
-┌────────────────────────────────────────────────────────┐
-│ LAYER 1: Root Contracts (Single Source of Truth)       │
-│ AGENTS.md • MEMORY.md • TASKS.md • RUNBOOK.md          │
-└──────────────────────────┬─────────────────────────────┘
-                           │ Centralizes project context
-┌──────────────────────────▼─────────────────────────────┐
-│ LAYER 2: Configuration & Modules (.ai/)                │
-│ context/ • agents/ • skills/ • prompts/ • checks/      │
-└──────────────────────────┬─────────────────────────────┘
-                           │ Routes files dynamically
-┌──────────────────────────▼─────────────────────────────┐
-│ LAYER 3: Tool & IDE Adapters                           │
-│ .cursorrules • CLAUDE.md • .vscode/ • .gemini/        │
-└────────────────────────────────────────────────────────┘
-```
-
-<p align="center">
-  <img src="assets/architecture-preview.svg" alt="Architecture Diagram" width="100%">
-</p>
+## Supported Tools & Agents
 
----
+| Tool / Agent | Adapter File | Status |
+|:---|:---|:---|
+| **Codex** (OpenAI) | `adapters/codex/AGENTS.md` | ✅ Full support |
+| **Antigravity** (Google DeepMind) | `.gemini/settings.json` | ✅ Full support |
+| **Cursor** | `.cursorrules` | ✅ Full support |
+| **Claude Code** (Anthropic) | `CLAUDE.md` | ✅ Full support |
+| **Gemini** (Google) | `GEMINI.md` | ✅ Full support |
+| **VS Code** (Copilot) | `.vscode/settings.json` | ✅ Full support |
+| **Cline / Continue / Roo Code** | Via adapter registry | 🔌 Adapter-ready |
+| **Aider / Windsurf** | Via adapter registry | 🔌 Adapter-ready |
+| **MCP Tools** (gcloud, Chrome DevTools) | Via tool registry | 🔌 Registry-ready |
 
-## Supported Tools
-
-| Tool / Agent | Target Adapter File | Setup Instructions | Behavior Setup |
-| :--- | :--- | :--- | :--- |
-| **Codex** | `adapters/codex/AGENTS.md` | `adapters/codex/setup.md` | Automated code scaffolding |
-| **Antigravity** | `.gemini/settings.json` | `adapters/antigravity/setup.md` | Security and audit parameters |
-| **Cursor** | `.cursorrules` | `adapters/cursor/setup.md` | Inline autocomplete guidelines |
-| **Claude Code** | `CLAUDE.md` | `adapters/claude/setup.md` | Terminal build and run controls |
-| **Gemini** | `GEMINI.md` | `adapters/gemini/setup.md` | Prompt system context logs |
-| **VS Code** | `.vscode/settings.json` | `adapters/vscode/setup.md` | Editor layout and search limits |
+> **Zero lock-in.** Switch tools freely — your context, rules, and memory travel with you.
 
 ---
 
-## Why Not Just a Manual AGENTS.md?
-
-While you can write a raw markdown file manually, `multimodel-dev-os` offers a standardized development workflow:
+## How It Works
 
-| Feature | Manual Rules File | MultiModel Dev OS |
-| :--- | :--- | :--- |
-| **Tool Synchronization** | Manual copy-paste across tools | Automated dynamic adapters |
-| **Context Budgets** | Bloats prompts, wasting cost | **Caveman Mode** slashes tokens by **~79%** |
-| **Standards Enforcement**| Easy to drift and corrupt | Built-in CLI `validate` and `doctor` checks |
-| **Onboarding baseline**  | Start from scratch | 5 production-ready real-world templates |
+```
+┌─────────────────────────────────────────────────────────────┐
+│  LAYER 1: Central Root Contracts (Single Source of Truth)   │
+│  AGENTS.md  •  MEMORY.md  •  TASKS.md  •  RUNBOOK.md      │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+┌─────────────────────────▼───────────────────────────────────┐
+│  LAYER 2: Configuration & Intelligence (.ai/)                │
+│  context/  agents/  skills/  prompts/  checks/  session/    │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+┌─────────────────────────▼───────────────────────────────────┐
+│  LAYER 3: Engine Workflows & Safety Gates                   │
+│  onboard analyze  •  adapter sync  •  improve apply         │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+┌─────────────────────────▼───────────────────────────────────┐
+│  LAYER 4: Tool & IDE Adapters                               │
+│  .cursorrules  •  CLAUDE.md  •  .vscode/  •  .gemini/      │
+└─────────────────────────────────────────────────────────────┘
+```
 
 ---
 
-## Interactive Command Line Interface (CLI)
-
-MultiModel Dev OS is powered by a pure Node.js CLI with **zero runtime external npm dependencies**.
-
-<p align="center">
-  <img src="assets/terminal-demo.svg" alt="Terminal Demo Sequence" width="100%">
-</p>
-
-### 1. Scaffolding Templates (Stable npm @latest)
-Initialize customized stack specifications for stable releases:
-- **Next.js SaaS:** `npx multimodel-dev-os@latest init --template nextjs-saas`
-- **WordPress Theme/Plugin:** `npx multimodel-dev-os@latest init --template wordpress-site`
-- **E-Commerce Store:** `npx multimodel-dev-os@latest init --template ecommerce-store`
-- **SEO Landing Page:** `npx multimodel-dev-os@latest init --template seo-landing-page`
-- **General Fallback:** `npx multimodel-dev-os@latest init --template general-app`
+## Essential Commands
 
-### 2. Adapter Linking (Stable npm @latest)
-Inject rules specifically for a developer tool:
 ```bash
-npx multimodel-dev-os@latest init --adapter cursor
-npx multimodel-dev-os@latest init --adapter claude
-```
+# Initialize & Onboard
+npx multimodel-dev-os@latest init --template nextjs-saas
+npx multimodel-dev-os@latest onboard analyze
 
-### 3. Caveman Mode (Stable npm @latest)
-Cuts prompt rules overhead down by **~79%** using highly optimized short-hand declarations:
-```bash
-npx multimodel-dev-os@latest init --caveman
-```
+# Scan, Status & Memory
+npx multimodel-dev-os@latest scan
+npx multimodel-dev-os@latest status
+npx multimodel-dev-os@latest memory build
 
-### 4. Registry & Model Commands (v2.0.0 Stable Release)
-Run model capabilities registries, adapter registers, and scaffold mobile templates directly:
-```bash
-# List model or adapter registries
-npx multimodel-dev-os@latest models
-npx multimodel-dev-os@latest adapters
+# Sync IDE Adapters
+npx multimodel-dev-os@latest adapter sync all --approved
 
-# Scaffold the Android Expo template
-npx multimodel-dev-os@latest init --template expo-react-native-android
+# Run Workflows & Handoffs
+npx multimodel-dev-os@latest workflow run repo-health
+npx multimodel-dev-os@latest handoff build
 ```
 
-For more details, see the [Model Capabilities Registry Guide](https://rizvee.github.io/multimodel-dev-os/model-compatibility).
-
-### 5. Quality Gates
-Run assertions and diagnostic checkups:
-- **`validate`** (Strict schema checkup): `npx multimodel-dev-os@latest validate`
-- **`doctor`** (Advisory compatibility warning): `npx multimodel-dev-os@latest doctor`
+📖 **[Full CLI Reference →](https://rizvee.github.io/multimodel-dev-os/CLI)**
 
 ---
 
-## Cost & Context Optimization
-
-Minimize prompt overhead and API billing by mapping key context-reduction techniques to MultiModel Dev OS features:
-
-<p align="center">
-  <img src="assets/cost-optimization.svg" alt="Cost Optimization Funnel" width="100%">
-</p>
+## Why Not Just a Manual AGENTS.md?
 
-For a full deep dive, see our [Cost Optimization Playbook](https://rizvee.github.io/multimodel-dev-os/cost-optimization).
+| Capability | Manual Rules File | MultiModel Dev OS |
+|:---|:---|:---|
+| **Tool Sync** | Manual copy-paste across tools | ✅ Automated dynamic adapters |
+| **Context Budgets** | Bloats prompts, wastes tokens | ✅ Caveman Mode cuts **~79%** overhead |
+| **Standards** | Easy to drift and corrupt | ✅ CLI `validate` + `doctor` + 214-assertion `verify` |
+| **Templates** | Start from scratch | ✅ 6 production-ready real-world templates |
+| **Model Registry** | Hardcoded model names | ✅ Dynamic capability-scored routing presets |
+| **Self-Improvement** | None | ✅ Feedback → Proposals → Apply with safety gates |
+| **Onboarding** | Manual setup every time | ✅ `onboard analyze` bootstraps existing repos |
 
 ---
 
-## 5-Day Adoption Roadmap
+## What's New in v2.8
 
-Deploying MultiModel Dev OS across your team is straightforward and tool-neutral:
-
-<p align="center">
-  <img src="assets/ai-dev-os-roadmap.svg" alt="5-Day Adoption Roadmap" width="100%">
-</p>
+- 🧠 **Interactive TUI Dashboard** — Launches an interactive menu wrapper (`dashboard` or `ui`) for keyboard-driven navigation across all MultiModel Dev OS commands with non-TTY automated fallbacks.
+- 🔌 **Declarative Plugin Hooks** — Fully offline, declarative system (`plugin`) to list, show, validate, and install plugin rules to whitelisted directories with overwrite backups.
+- 🛡️ **Zero-Dependency CLI** — Custom keypress menu handling built on Node.js's native `readline` module.
 
-See our step-by-step timeline: [5-Day Adoption Roadmap Playbook](https://rizvee.github.io/multimodel-dev-os/5-day-roadmap).
+**[Full Changelog →](CHANGELOG.md)**
 
 ---
 
-## Real-World Case Studies
-
-Discover how engineering teams deploy MultiModel Dev OS:
-- 📦 [Full-Stack Next.js SaaS: Database Schema Synchronization](https://rizvee.github.io/multimodel-dev-os/case-studies/nextjs-saas)
-- 🔌 [WordPress Theme Scaffolding: Folder Boundary Protections](https://rizvee.github.io/multimodel-dev-os/case-studies/wordpress-site)
-- 🛒 [E-Commerce Webhooks: State Verification Alignment](https://rizvee.github.io/multimodel-dev-os/case-studies/ecommerce-store)
-- 📈 [SEO Landing Pages: Core Web Vitals Linter Budgets](https://rizvee.github.io/multimodel-dev-os/case-studies/seo-landing-page)
-- 🚀 [Multi-Model Handoff: Sequential Session Logging](https://rizvee.github.io/multimodel-dev-os/case-studies/multimodel-handoff)
+## Roadmap
 
----
+| Version | Focus | Status |
+|:---|:---|:---|
+| **v2.0.0** | Template Galaxy, Model Registry, Stable Protocol | ✅ Released |
+| **v2.2.0** | Codebase Scanner & Hash-Compressed Memory Engine | ✅ Released |
+| **v2.3.0** | Feedback Learning & Proposal Engine | ✅ Released |
+| **v2.4.0** | Approved Proposal Application Engine | ✅ Released |
+| **v2.5.0** | Repository Intelligence Command Center | ✅ Released |
+| **v2.6.0** | Real-Repo Onboarding & Adapter Sync | ✅ Released |
+| **v2.7.0** | Website, Demo & Distribution System | ✅ Released |
+| **v2.8.0** | Interactive TUI Dashboard & Plugin Hooks | ✅ Released |
+| **v3.0.0** | Unified Autonomous Co-Pilot Ecosystem | 🔮 Future |
 
-## Stable Protocol Specification & Roadmap
-
-MultiModel Dev OS v2.x packages the stable Layer 1, Layer 2, and Layer 3 specifications alongside the Model Compatibility and Template Galaxy registries.
-- 🏁 [v2 Release Checklist](/docs/v2-release-checklist.md) (Release quality checklist)
-- 🛡️ [Stable Protocol Specification](https://rizvee.github.io/multimodel-dev-os/stable-protocol)
-- 🔌 [Multi-Agent Compatibility Guides](https://rizvee.github.io/multimodel-dev-os/compatibility)
-- 📈 [Upgrade & Migration Guide](https://rizvee.github.io/multimodel-dev-os/migration-guide)
-- 🏁 [v1.0.0 Release Quality Checklist](https://rizvee.github.io/multimodel-dev-os/v1-checklist)
+**[Full Roadmap →](https://rizvee.github.io/multimodel-dev-os/v2-roadmap)**
 
 ---
 
-## Contributing
+## Documentation & Resources
 
-We love contributions! Propose new adapters, request built-in templates, or report issues safely.
-Read our [Contributing Onboarding Guidelines](CONTRIBUTING.md) to get started.
+| Resource | Link |
+|:---|:---|
+| 📖 Documentation Portal | **[rizvee.github.io/multimodel-dev-os](https://rizvee.github.io/multimodel-dev-os/)** |
+| 🐙 GitHub Repository | **[github.com/rizvee/multimodel-dev-os](https://github.com/rizvee/multimodel-dev-os)** |
+| 📦 NPM Registry | **[npmjs.com/package/multimodel-dev-os](https://www.npmjs.com/package/multimodel-dev-os)** |
+| 🤖 AI Discoverability | **[llms.txt](https://rizvee.github.io/multimodel-dev-os/llms.txt)** |
+| 🚀 Quick Start | **[Quickstart Guide](https://rizvee.github.io/multimodel-dev-os/quickstart)** |
+| 🏗️ Architecture | **[Architecture Deep Dive](https://rizvee.github.io/multimodel-dev-os/architecture)** |
+| ⚔️ Comparison | **[vs Alternatives](https://rizvee.github.io/multimodel-dev-os/comparison)** |
+| 🛡️ Stable Protocol | **[Protocol Specification](https://rizvee.github.io/multimodel-dev-os/stable-protocol)** |
 
 ---
 
-## Docs & Staging Links
+## Contributing & Community
+
+We welcome contributions! Propose new adapters, request templates, improve docs, or report issues.
 
-Explore detailed specifications, guides, and playbooks at the official docs portal:
-👉 **[Documentation site](https://rizvee.github.io/multimodel-dev-os/)**
-👉 **[GitHub repository](https://github.com/rizvee/multimodel-dev-os)**
-👉 **[NPM registry](https://www.npmjs.com/package/multimodel-dev-os)**
-👉 **[llms.txt discoverability guide](https://rizvee.github.io/multimodel-dev-os/llms.txt)**
+- 📖 **[Contributing Guidelines](CONTRIBUTING.md)**
+- 🐛 **[Report a Bug](https://github.com/rizvee/multimodel-dev-os/issues/new)**
+- 💡 **[Request a Feature](https://github.com/rizvee/multimodel-dev-os/issues/new)**
+- ⭐ **[Star us on GitHub](https://github.com/rizvee/multimodel-dev-os)** — it helps others discover this project
 
 ---
 

package/assets/adapter-sync-flow.svg

@@ -0,0 +1,84 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 320" width="100%" height="100%" style="font-family: 'Outfit', 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#070a13" />
+      <stop offset="100%" stop-color="#0d111d" />
+    </linearGradient>
+    <linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#6366f1" />
+      <stop offset="100%" stop-color="#10b981" />
+    </linearGradient>
+    <linearGradient id="card" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.06" />
+      <stop offset="100%" stop-color="#ffffff" stop-opacity="0.02" />
+    </linearGradient>
+  </defs>
+
+  <!-- Background -->
+  <rect width="900" height="320" rx="16" fill="url(#bg)" />
+  <rect x="1" y="1" width="898" height="318" rx="15" fill="none" stroke="#1e293b" stroke-width="1" />
+
+  <!-- Title -->
+  <text x="450" y="38" text-anchor="middle" font-size="18" font-weight="800" fill="#e2e8f0" letter-spacing="0.5">ADAPTER SYNC FLOW</text>
+  <rect x="200" y="48" width="500" height="2" rx="1" fill="url(#accent)" opacity="0.4" />
+
+  <!-- Source: AGENTS.md -->
+  <rect x="30" y="75" width="180" height="90" rx="12" fill="url(#card)" stroke="#4f46e5" stroke-width="1.5" />
+  <text x="120" y="105" text-anchor="middle" font-size="15" font-weight="800" fill="#a78bfa">AGENTS.md</text>
+  <text x="120" y="125" text-anchor="middle" font-size="10" fill="#94a3b8">Single source of truth</text>
+  <text x="120" y="140" text-anchor="middle" font-size="10" fill="#94a3b8">for all AI coding rules</text>
+  <text x="120" y="155" text-anchor="middle" font-size="9" fill="#10b981" font-weight="600">YOUR RULES</text>
+
+  <!-- Arrow source → adapter sync -->
+  <line x1="215" y1="120" x2="275" y2="120" stroke="url(#accent)" stroke-width="2" />
+  <polygon points="275,115 285,120 275,125" fill="#10b981" />
+
+  <!-- Adapter Sync Engine -->
+  <rect x="290" y="70" width="160" height="100" rx="12" fill="url(#card)" stroke="#10b981" stroke-width="1.5" />
+  <text x="370" y="100" text-anchor="middle" font-size="28">🔄</text>
+  <text x="370" y="125" text-anchor="middle" font-size="13" font-weight="700" fill="#f8fafc">adapter sync</text>
+  <text x="370" y="143" text-anchor="middle" font-size="10" fill="#94a3b8">Diff + copy with</text>
+  <text x="370" y="156" text-anchor="middle" font-size="10" fill="#94a3b8">backup protection</text>
+
+  <!-- Arrows to targets -->
+  <line x1="455" y1="95" x2="540" y2="55" stroke="#6366f1" stroke-width="1.5" />
+  <line x1="455" y1="110" x2="540" y2="95" stroke="#6366f1" stroke-width="1.5" />
+  <line x1="455" y1="125" x2="540" y2="135" stroke="#6366f1" stroke-width="1.5" />
+  <line x1="455" y1="140" x2="540" y2="175" stroke="#6366f1" stroke-width="1.5" />
+  <line x1="455" y1="155" x2="540" y2="215" stroke="#6366f1" stroke-width="1.5" />
+  <line x1="455" y1="165" x2="540" y2="255" stroke="#6366f1" stroke-width="1.5" />
+
+  <!-- Target: Cursor -->
+  <rect x="545" y="35" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="58" font-size="14">🎯</text>
+  <text x="578" y="58" font-size="12" font-weight="600" fill="#f8fafc">.cursorrules</text>
+
+  <!-- Target: Claude -->
+  <rect x="545" y="78" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="101" font-size="14">⚡</text>
+  <text x="578" y="101" font-size="12" font-weight="600" fill="#f8fafc">CLAUDE.md</text>
+
+  <!-- Target: VS Code -->
+  <rect x="545" y="121" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="144" font-size="14">💻</text>
+  <text x="578" y="144" font-size="12" font-weight="600" fill="#f8fafc">.vscode/settings.json</text>
+
+  <!-- Target: Gemini -->
+  <rect x="545" y="164" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="187" font-size="14">🧠</text>
+  <text x="578" y="187" font-size="12" font-weight="600" fill="#f8fafc">GEMINI.md</text>
+
+  <!-- Target: Antigravity -->
+  <rect x="545" y="207" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="230" font-size="14">🪐</text>
+  <text x="578" y="230" font-size="12" font-weight="600" fill="#f8fafc">.gemini/settings.json</text>
+
+  <!-- Target: More -->
+  <rect x="545" y="250" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="273" font-size="14">🔌</text>
+  <text x="578" y="273" font-size="12" font-weight="600" fill="#94a3b8">+ Cline, Aider, ...</text>
+
+  <!-- Footer command -->
+  <rect x="30" y="280" width="500" height="30" rx="8" fill="#090d16" stroke="#1e293b" stroke-width="1" />
+  <text x="45" y="300" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="12" fill="#34d399">$ <tspan fill="#e2e8f0">npx multimodel-dev-os@latest adapter sync all --approved</tspan></text>
+</svg>

package/assets/architecture-preview.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 820 400" width="100%" height="100%" style="font-family: 'Outfit', 'Inter', -apple-system, sans-serif;">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 820 420" width="100%" height="100%" style="font-family: 'Outfit', 'Inter', -apple-system, sans-serif;">
   <defs>
     <!-- Card Gradients -->
     <linearGradient id="rootCard" x1="0%" y1="0%" x2="100%" y2="100%">
@@ -9,6 +9,10 @@
       <stop offset="0%" stop-color="#111827" />
       <stop offset="100%" stop-color="#1f2937" />
     </linearGradient>
+    <linearGradient id="engineCard" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#064e3b" />
+      <stop offset="100%" stop-color="#022c22" />
+    </linearGradient>
     
     <!-- Flow Connector -->
     <linearGradient id="flowGrad" x1="0%" y1="0%" x2="0%" y2="100%">
@@ -18,75 +22,86 @@
   </defs>
 
   <!-- Canvas Container -->
-  <rect width="820" height="400" rx="12" fill="#090d16" stroke="#1e293b" stroke-width="1.5"/>
+  <rect width="820" height="420" rx="12" fill="#090d16" stroke="#1e293b" stroke-width="1.5"/>
+
+  <!-- Layer 1: Central Root Contracts -->
+  <g transform="translate(110, 15)">
+    <rect width="600" height="60" rx="12" fill="url(#rootCard)" stroke="#4f46e5" stroke-width="2"/>
+    <text x="300" y="24" font-size="12" font-weight="800" fill="#a5b4fc" text-anchor="middle" letter-spacing="1">LAYER 1: CENTRAL ROOT CONTRACTS (SINGLE SOURCE)</text>
+    <text x="300" y="46" font-size="14" font-weight="700" fill="#f8fafc" text-anchor="middle">AGENTS.md • MEMORY.md • TASKS.md • RUNBOOK.md</text>
+  </g>
+
+  <!-- Flow Connector L1 -> L2 -->
+  <path d="M 410,75 L 410,95" stroke="url(#flowGrad)" stroke-width="3" stroke-dasharray="4,4" fill="none"/>
 
-  <!-- Layer 1: Root Files Single Source of Truth -->
-  <g transform="translate(110, 25)">
-    <rect width="600" height="85" rx="12" fill="url(#rootCard)" stroke="#4f46e5" stroke-width="2"/>
-    <text x="300" y="32" font-size="14" font-weight="800" fill="#a5b4fc" text-anchor="middle" letter-spacing="1">LAYER 1: CENTRAL ROOT CONTRACTS</text>
-    <text x="300" y="62" font-size="16" font-weight="700" fill="#f8fafc" text-anchor="middle">AGENTS.md • MEMORY.md • TASKS.md • RUNBOOK.md</text>
+  <!-- Layer 2: Configuration & Intelligence (.ai/) -->
+  <g transform="translate(110, 95)">
+    <rect width="600" height="60" rx="12" fill="url(#aiCard)" stroke="#8b5cf6" stroke-width="1.5"/>
+    <text x="300" y="22" font-size="11" font-weight="800" fill="#c084fc" text-anchor="middle" letter-spacing="1">LAYER 2: .AI/ CONFIGURATION & INTELLIGENCE</text>
+    <text x="300" y="44" font-size="13" font-weight="700" fill="#e2e8f0" text-anchor="middle">context • agents • skills • prompts • checks • session logs</text>
   </g>
 
-  <!-- Flow Connector 1 -->
-  <path d="M 410,110 L 410,140" stroke="url(#flowGrad)" stroke-width="3" stroke-dasharray="4,4" fill="none"/>
+  <!-- Flow Connector L2 -> L3 -->
+  <path d="M 410,155 L 410,175" stroke="url(#flowGrad)" stroke-width="3" fill="none"/>
+  <polygon points="410,175 405,165 415,165" fill="#10b981"/>
 
-  <!-- Layer 2: The .ai/ Config Layer -->
-  <g transform="translate(110, 140)">
-    <rect width="600" height="85" rx="12" fill="url(#aiCard)" stroke="#8b5cf6" stroke-width="1.5"/>
-    <text x="300" y="30" font-size="13" font-weight="800" fill="#c084fc" text-anchor="middle" letter-spacing="1">LAYER 2: .AI/ CONFIGURATION DIRECTORY</text>
-    <text x="300" y="60" font-size="15" font-weight="700" fill="#e2e8f0" text-anchor="middle">context • agents • skills • prompts • checks • session logs</text>
+  <!-- Layer 3: Dev OS Engine & Safety -->
+  <g transform="translate(110, 175)">
+    <rect width="600" height="60" rx="12" fill="url(#engineCard)" stroke="#10b981" stroke-width="1.5"/>
+    <text x="300" y="22" font-size="11" font-weight="800" fill="#34d399" text-anchor="middle" letter-spacing="1">LAYER 3: ENGINE WORKFLOWS & SAFETY GATES</text>
+    <text x="300" y="44" font-size="13" font-weight="700" fill="#e2e8f0" text-anchor="middle">onboard analyze • adapter sync • improve propose • verify doctor</text>
   </g>
 
-  <!-- Flow Connector 2 -->
-  <path d="M 410,225 L 410,255" stroke="url(#flowGrad)" stroke-width="3" fill="none"/>
-  <polygon points="410,260 405,250 415,250" fill="#10b981"/>
+  <!-- Flow Connector L3 -> L4 -->
+  <path d="M 410,235 L 410,260" stroke="#334155" stroke-width="3" fill="none"/>
+  <polygon points="410,260 405,250 415,250" fill="#334155"/>
 
-  <!-- Layer 3: Adapters Connection Tree -->
-  <path d="M 100,265 L 720,265 L 720,280" stroke="#334155" stroke-width="2" fill="none"/>
-  <path d="M 100,265 L 100,280" stroke="#334155" stroke-width="2" fill="none"/>
-  <path d="M 224,265 L 224,280" stroke="#334155" stroke-width="2" fill="none"/>
-  <path d="M 348,265 L 348,280" stroke="#334155" stroke-width="2" fill="none"/>
-  <path d="M 472,265 L 472,280" stroke="#334155" stroke-width="2" fill="none"/>
-  <path d="M 596,265 L 596,280" stroke="#334155" stroke-width="2" fill="none"/>
+  <!-- Layer 4: Target Tools Connection Tree -->
+  <path d="M 100,265 L 725,265 L 725,285" stroke="#334155" stroke-width="2" fill="none"/>
+  <path d="M 100,265 L 100,285" stroke="#334155" stroke-width="2" fill="none"/>
+  <path d="M 225,265 L 225,285" stroke="#334155" stroke-width="2" fill="none"/>
+  <path d="M 350,265 L 350,285" stroke="#334155" stroke-width="2" fill="none"/>
+  <path d="M 475,265 L 475,285" stroke="#334155" stroke-width="2" fill="none"/>
+  <path d="M 600,265 L 600,285" stroke="#334155" stroke-width="2" fill="none"/>
 
-  <!-- Adapter Output Nodes -->
+  <!-- Universal Adapter Nodes -->
   <!-- Node 1: Codex -->
-  <g transform="translate(40, 280)">
+  <g transform="translate(40, 285)">
     <rect width="120" height="50" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1"/>
     <text x="60" y="24" font-size="12" font-weight="700" fill="#f8fafc" text-anchor="middle">Codex</text>
     <text x="60" y="40" font-size="10" fill="#94a3b8" text-anchor="middle">adapters/codex/</text>
   </g>
 
   <!-- Node 2: Antigravity -->
-  <g transform="translate(165, 280)">
+  <g transform="translate(165, 285)">
     <rect width="120" height="50" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1"/>
     <text x="60" y="24" font-size="12" font-weight="700" fill="#f8fafc" text-anchor="middle">Antigravity</text>
     <text x="60" y="40" font-size="10" fill="#94a3b8" text-anchor="middle">.gemini/settings</text>
   </g>
 
   <!-- Node 3: Cursor -->
-  <g transform="translate(290, 280)">
+  <g transform="translate(290, 285)">
     <rect width="120" height="50" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1"/>
     <text x="60" y="24" font-size="12" font-weight="700" fill="#f8fafc" text-anchor="middle">Cursor</text>
     <text x="60" y="40" font-size="10" fill="#94a3b8" text-anchor="middle">.cursorrules</text>
   </g>
 
   <!-- Node 4: Claude -->
-  <g transform="translate(415, 280)">
+  <g transform="translate(415, 285)">
     <rect width="120" height="50" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1"/>
     <text x="60" y="24" font-size="12" font-weight="700" fill="#f8fafc" text-anchor="middle">Claude</text>
     <text x="60" y="40" font-size="10" fill="#94a3b8" text-anchor="middle">CLAUDE.md</text>
   </g>
 
   <!-- Node 5: Gemini -->
-  <g transform="translate(540, 280)">
+  <g transform="translate(540, 285)">
     <rect width="120" height="50" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1"/>
     <text x="60" y="24" font-size="12" font-weight="700" fill="#f8fafc" text-anchor="middle">Gemini</text>
     <text x="60" y="40" font-size="10" fill="#94a3b8" text-anchor="middle">GEMINI.md</text>
   </g>
 
   <!-- Node 6: VS Code -->
-  <g transform="translate(665, 280)">
+  <g transform="translate(665, 285)">
     <rect width="120" height="50" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1"/>
     <text x="60" y="24" font-size="12" font-weight="700" fill="#f8fafc" text-anchor="middle">VS Code</text>
     <text x="60" y="40" font-size="10" fill="#94a3b8" text-anchor="middle">.vscode/settings</text>