multimodel-dev-os 2.0.1 → 2.8.0

package/docs/npm-publishing.md

@@ -12,13 +12,13 @@ Before publishing, always test the built package locally by compiling a compress
    ```bash
    npm pack
    ```
-   This creates a file named like `multimodel-dev-os-2.0.1.tgz` in your directory root.
+   This creates a file named like `multimodel-dev-os-2.6.0.tgz` in your directory root.
 
 2. **Verify bundle contents:**
    Create an empty temporary workspace, extract the tarball, and confirm that only required scaffold folders are included (no `.github/`, test configurations, or local system files):
    ```bash
    mkdir -p /tmp/package-test && cd /tmp/package-test
-   tar -xzf /path/to/multimodel-dev-os-2.0.1.tgz
+   tar -xzf /path/to/multimodel-dev-os-2.6.0.tgz
    ls -la package/
    ```
 
@@ -34,7 +34,7 @@ Before publishing, always test the built package locally by compiling a compress
 Execute these validation actions strictly in sequence before triggering a release:
 
 1. **Verify structural health:**
-   Ensure all 96 file assertions in our verification script pass successfully:
+   Ensure all 214+ assertions in our verification script pass successfully:
    ```bash
    npm run verify
    ```
@@ -75,13 +75,13 @@ Execute these validation actions strictly in sequence before triggering a releas
 
 ---
 
-## 4. Prepublish Safety Guard (v2.0.1 Stable)
+## 4. Prepublish Safety Guard
 
 > [!IMPORTANT]
-> **v2.0.1 is the active stable release.** NPM publishing is no longer paused.
+> **v2.6.0 is the active stable release.** NPM publishing is live.
 
 ### Source vs. Registry Strategy
-* **GitHub main branch (Source)**: Contains the current stable `v2.0.1` codebase.
+* **GitHub main branch (Source)**: Contains the current stable `v2.6.0` codebase.
 * **npm latest (Registry)**: Pulled and installed globally or via npx.
 
 ### Prepublish Safety Guard

package/docs/plugin-authoring.md

@@ -0,0 +1,99 @@
+# Plugin Authoring Guide
+
+MultiModel Dev OS declarative plugins allow you to share templates, rules, custom workflows, and adapters across different repositories. This guide walks you through authoring and packaging a compliant plugin.
+
+---
+
+## Plugin Manifest Schema
+
+A plugin is defined by a single YAML or JSON file. The manifest schema structure is enforced by [.ai/schema/plugin.schema.json](file:///f:/multimodel-dev-os/.ai/schema/plugin.schema.json).
+
+### Required Fields
+
+* **`name`** (string): The human-readable name of the plugin (e.g. `Git Integration Plugin`).
+* **`slug`** (string): A unique, URL-friendly slug identifier (e.g. `git-integration`). This slug determines the filename under `.ai/plugins/<slug>.yaml` after installation.
+* **`version`** (string): Semantic version string (e.g. `1.0.0`).
+* **`description`** (string): A brief summary of the capabilities introduced by the plugin.
+* **`author`** (string): The creator's name or team.
+
+### Optional Config Fields
+
+* **`allowed_file_patterns`** (array of strings): A list of relative paths within the whitelist directory boundaries (`.ai/` or `adapters/`) that this plugin plans to install.
+* **`denied_file_patterns`** (array of strings): Explicit glob patterns of forbidden locations.
+* **`templates`** (object): Custom project templates registered by the plugin.
+* **`workflows`** (object): Custom workflows added by the plugin (reused by `multimodel-dev-os workflow run`).
+* **`adapters`** (object): Custom adapter settings mappings.
+* **`safety_notes`** (string): Security disclosures printed to the user before they approve installation.
+
+---
+
+## Example Manifest
+
+Here is a standard example manifest mapping custom git operations and rules:
+
+```yaml
+name: "Example Git Integration Plugin"
+slug: "git-integration"
+version: "1.0.0"
+description: "Declarative plugin extending MultiModel Dev OS with custom git workflows and rules"
+author: "MultiModel Dev OS Team"
+allowed_file_patterns:
+  - ".ai/skills/git-operations.md"
+  - ".ai/checks/pre-push-audit.md"
+denied_file_patterns:
+  - "src/**"
+  - ".env"
+  - "node_modules/**"
+templates:
+  git-commit-helper:
+    name: "Git Commit Message Assistant"
+    description: "Generates semantic commit messages based on staged diffs"
+workflows:
+  git-audit:
+    name: "Pre-Push Git Audit"
+    description: "Scan branch status and verify all local commits pass verification before pushing code"
+    steps:
+      - name: "Status Check"
+        command: "status"
+      - name: "Doctor Pre-flight Audit"
+        command: "doctor"
+      - name: "Integrity Verify"
+        command: "verify"
+adapters:
+  git-rules:
+    name: "Git Rules Configuration"
+    targetFile: ".gitattributes"
+safety_notes: "This plugin only writes configurations to .ai/skills/ and .ai/checks/ to aid developer git workflows. No binary code is executed."
+```
+
+---
+
+## Local Validation
+
+Before distributing your plugin, always validate the manifest structure using the built-in validation CLI:
+
+```bash
+npx multimodel-dev-os@latest plugin validate path/to/your-plugin.yaml
+```
+
+If the validation fails, it outputs detailed error reports indicating which schema constraint was violated.
+
+---
+
+## Packaging Guidelines
+
+A packaged plugin folder should mirror the workspace directory structure. For example, if a plugin copies `.ai/skills/git-operations.md`, the folder layout must look like:
+
+```txt
+your-plugin-folder/
+├── plugin.yaml
+└── .ai/
+    └── skills/
+        └── git-operations.md
+```
+
+To install this plugin locally, users run:
+
+```bash
+npx multimodel-dev-os@latest plugin install your-plugin-folder/plugin.yaml --approved
+```

package/docs/plugin-hooks.md

@@ -0,0 +1,80 @@
+# Declarative Plugin Hooks System
+
+MultiModel Dev OS features a secure, registry-based **Declarative Plugin System** designed to extend workspace templates, rules, workflows, and skills without exposing repositories to arbitrary third-party code execution or dependency vulnerabilities.
+
+---
+
+## Safety & Security Boundaries
+
+To maintain absolute containment, plugins in MMDO are **strictly declarative configs (YAML)**.
+
+| Allowed Operations | Forbidden Operations (Hard Blocked) |
+|:---|:---|
+| Copying markdown templates into `.ai/templates/` | Arbitrary JavaScript execution (`eval` or `vm`) |
+| Injecting custom skills into `.ai/skills/` | Running external shell scripts, npm install, or binaries |
+| Registering advisory checks in `.ai/checks/` | Writing files to source directories (e.g. `src/`, `lib/`) |
+| Mapping adapter rules in `adapters/` | Modifying `.env`, `.git/`, `.npmrc`, or `package.json` |
+| Setting up custom read-only workflow lists | Fetching remote packages or making network calls |
+
+Every file copy operation requested by a plugin must match against a strict whitelist of safe directories:
+* `.ai/plugins/`
+* `.ai/registries/`
+* `.ai/templates/`
+* `.ai/skills/`
+* `.ai/checks/`
+* `.ai/prompts/`
+* `.ai/adapters/`
+
+---
+
+## Plugin Commands
+
+### 1. `plugin list`
+Lists all plugins currently installed in the workspace directory.
+
+```bash
+npx multimodel-dev-os@latest plugin list [--json]
+```
+
+### 2. `plugin show`
+Inspect the specifications, capabilities, and safety notes of an installed plugin.
+
+```bash
+npx multimodel-dev-os@latest plugin show <slug>
+```
+
+### 3. `plugin validate`
+Validate a plugin manifest YAML file locally before submitting it to a repository. Ensures the manifest conforms to the JSON Schema and contains no safety violations.
+
+```bash
+npx multimodel-dev-os@latest plugin validate <path-to-yaml>
+```
+
+### 4. `plugin install`
+Install a plugin from a local manifest file.
+
+```bash
+# Preview the planned copy actions (Dry Run)
+npx multimodel-dev-os@latest plugin install <path-to-yaml>
+
+# Apply the copy actions (Execution Gate)
+npx multimodel-dev-os@latest plugin install <path-to-yaml> --approved
+
+# Force overwrite of conflicting files (creates .bak backups)
+npx multimodel-dev-os@latest plugin install <path-to-yaml> --approved --force
+```
+
+### 5. `plugin status`
+Check the health status of installed plugins. Verifies if all declared templates, skills, or rules are present in their target `.ai/` directories.
+
+```bash
+npx multimodel-dev-os@latest plugin status [--target <path>]
+```
+
+---
+
+## Overwrite Protection & Backup System
+
+When a plugin installation causes file conflicts:
+* By default, the installer aborts and prints a list of conflicting files.
+* Running with `--force` overwrites the destination files but automatically copies the existing file to `<filename>.bak` in the same directory.

package/docs/public/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/docs/public/assets/onboarding-flow.svg

@@ -0,0 +1,79 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 340" 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="340" rx="16" fill="url(#bg)" />
+  <rect x="1" y="1" width="898" height="338" 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">EXISTING REPO ONBOARDING FLOW</text>
+  <rect x="150" y="48" width="600" height="2" rx="1" fill="url(#accent)" opacity="0.4" />
+
+  <!-- Step 1 -->
+  <rect x="30" y="75" width="160" height="100" rx="12" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="110" y="100" text-anchor="middle" font-size="28">🔍</text>
+  <text x="110" y="124" text-anchor="middle" font-size="13" font-weight="700" fill="#f8fafc">1. Analyze</text>
+  <text x="110" y="142" text-anchor="middle" font-size="10" fill="#94a3b8">Scan frameworks,</text>
+  <text x="110" y="155" text-anchor="middle" font-size="10" fill="#94a3b8">languages, config</text>
+  <text x="110" y="168" text-anchor="middle" font-size="9" fill="#10b981" font-weight="600">READ-ONLY</text>
+
+  <!-- Arrow 1→2 -->
+  <line x1="195" y1="125" x2="225" y2="125" stroke="#6366f1" stroke-width="2" />
+  <polygon points="225,120 235,125 225,130" fill="#6366f1" />
+
+  <!-- Step 2 -->
+  <rect x="240" y="75" width="160" height="100" rx="12" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="320" y="100" text-anchor="middle" font-size="28">📋</text>
+  <text x="320" y="124" text-anchor="middle" font-size="13" font-weight="700" fill="#f8fafc">2. Recommend</text>
+  <text x="320" y="142" text-anchor="middle" font-size="10" fill="#94a3b8">Template match,</text>
+  <text x="320" y="155" text-anchor="middle" font-size="10" fill="#94a3b8">adapter suggestions</text>
+  <text x="320" y="168" text-anchor="middle" font-size="9" fill="#10b981" font-weight="600">READ-ONLY</text>
+
+  <!-- Arrow 2→3 -->
+  <line x1="405" y1="125" x2="435" y2="125" stroke="#6366f1" stroke-width="2" />
+  <polygon points="435,120 445,125 435,130" fill="#6366f1" />
+
+  <!-- Step 3 -->
+  <rect x="450" y="75" width="160" height="100" rx="12" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="530" y="100" text-anchor="middle" font-size="28">📝</text>
+  <text x="530" y="124" text-anchor="middle" font-size="13" font-weight="700" fill="#f8fafc">3. Plan</text>
+  <text x="530" y="142" text-anchor="middle" font-size="10" fill="#94a3b8">Generate onboarding</text>
+  <text x="530" y="155" text-anchor="middle" font-size="10" fill="#94a3b8">plan + report</text>
+  <text x="530" y="168" text-anchor="middle" font-size="9" fill="#10b981" font-weight="600">GITIGNORED OUTPUT</text>
+
+  <!-- Arrow 3→4 -->
+  <line x1="615" y1="125" x2="645" y2="125" stroke="#6366f1" stroke-width="2" />
+  <polygon points="645,120 655,125 645,130" fill="#6366f1" />
+
+  <!-- Step 4 -->
+  <rect x="660" y="75" width="210" height="100" rx="12" fill="url(#card)" stroke="#4f46e5" stroke-width="1.5" />
+  <text x="765" y="100" text-anchor="middle" font-size="28">✅</text>
+  <text x="765" y="124" text-anchor="middle" font-size="13" font-weight="700" fill="#f8fafc">4. Apply + Status</text>
+  <text x="765" y="142" text-anchor="middle" font-size="10" fill="#94a3b8">Bootstrap configs,</text>
+  <text x="765" y="155" text-anchor="middle" font-size="10" fill="#94a3b8">auto-backups, verify</text>
+  <text x="765" y="168" text-anchor="middle" font-size="9" fill="#f59e0b" font-weight="600">REQUIRES --approved</text>
+
+  <!-- Command examples -->
+  <rect x="30" y="200" width="840" height="120" rx="12" fill="#090d16" stroke="#1e293b" stroke-width="1" />
+  <text x="50" y="228" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="13" fill="#34d399">$</text>
+  <text x="68" y="228" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="13" fill="#e2e8f0">npx multimodel-dev-os@latest onboard analyze</text>
+  <text x="50" y="252" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="13" fill="#34d399">$</text>
+  <text x="68" y="252" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="13" fill="#e2e8f0">npx multimodel-dev-os@latest onboard recommend</text>
+  <text x="50" y="276" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="13" fill="#34d399">$</text>
+  <text x="68" y="276" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="13" fill="#e2e8f0">npx multimodel-dev-os@latest onboard plan</text>
+  <text x="50" y="300" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="13" fill="#34d399">$</text>
+  <text x="68" y="300" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="13" fill="#e2e8f0">npx multimodel-dev-os@latest onboard apply --approved</text>
+</svg>

package/docs/public/llms-full.txt

@@ -1,4 +1,4 @@
-# MultiModel Dev OS — Comprehensive AI Assistant Discoverability Guide (v2.0.1 Stable Release)
+# MultiModel Dev OS — Comprehensive AI Assistant Discoverability Guide (v2.8.0 Stable Release)
 
 MultiModel Dev OS is a repository-level porting specification designed to align context and instructions across diverse developer tools and AI models.
 
@@ -16,12 +16,17 @@ The protocol decouples the centralized workspace context from the individual too
 └──────────────────────────┬─────────────────────────────┘
                            │ Centralizes project context
 ┌──────────────────────────▼─────────────────────────────┐
-│ LAYER 2: Configuration & Modules (.ai/)                │
+│ LAYER 2: Configuration & Intelligence (.ai/)            │
 │ context/ • agents/ • skills/ • prompts/ • checks/      │
 └──────────────────────────┬─────────────────────────────┘
                            │ Routes files dynamically
 ┌──────────────────────────▼─────────────────────────────┐
-│ LAYER 3: Tool & IDE Adapters                           │
+│ LAYER 3: Engine Workflows & Safety Gates               │
+│ onboard • adapter sync • improve • verify doctor       │
+└──────────────────────────┬─────────────────────────────┘
+                           │ Runs compliance checkups
+┌──────────────────────────▼─────────────────────────────┐
+│ LAYER 4: Tool & IDE Adapters                           │
 │ .cursorrules • CLAUDE.md • .vscode/ • .gemini/ • etc.  │
 └────────────────────────────────────────────────────────┘
 ```
@@ -38,13 +43,50 @@ The protocol decouples the centralized workspace context from the individual too
 
 All compliant MultiModel Dev OS CLIs strictly enforce the following command contracts:
 - **`init`**: Scaffolds the standard `.ai/` context configuration directories. Supports `--template`, `--caveman`, `--adapter`, and dynamic registries mapping.
+- **`status`**: Displays a compact project intelligence dashboard summarizing package details, frameworks, memory freshness, feedback logs, improvement proposals, and audit execution metrics.
+- **`scan`**: Performs a read-only codebase scan to detect frameworks, package managers, MultiModel Dev OS configurations, and potential context-bloat or security risks.
+- **`onboard`**: Safely integrates MultiModel Dev OS into existing repositories. Subcommands:
+  - `analyze`: Scans repository structure, frameworks, languages, and risk markers. Read-only.
+  - `recommend`: Runs scanner diagnostics and recommendations for templates and adapters. Read-only.
+  - `plan`: Generates onboarding plan `.ai/intelligence/onboarding.plan.json` and report `.ai/intelligence/onboarding.report.md`. Read-only.
+  - `apply`: Copies configuration templates to target directory. Overwrites require `--force` and automatically generate backups.
+  - `status`: Show progress and completeness percentage dashboard.
+- **`adapter`**: Manage and sync rule/settings files for IDE adapters. Subcommands:
+  - `status`: Show rules files status and enable/disable states from config.
+  - `diff <adapter>`: Show rules diff between bundled template and target root file.
+  - `sync <adapter|all>`: Synchronizes rule files (requires `--approved`). Overwrites require `--force` and automatically generate backups.
+- **`memory`**: Compiles or reviews codebase hash-compressed memory. Subcommands:
+  - `build`: Scans target codebase and writes memory metadata to `.ai/intelligence/memory.hash.json` and `.ai/intelligence/memory.summary.md`.
+  - `refresh`: Incremental update comparing changed file hashes to update the memory files.
+  - `diff`: Prints added, removed, or changed files compared to `memory.hash.json` without executing writes.
+- **`feedback`**: Manage developer feedback loops. Subcommands:
+  - `add`: Logs raw developer feedback to `feedback-log.jsonl`.
+  - `list`: Lists logged feedback entries.
+  - `summarize`: Compiles feedback entries into `learning-rules.md`.
+- **`improve`**: Manage codebase self-improvement proposals. Subcommands:
+  - `propose`: Scans context and writes a proposal file under `.ai/proposals/`.
+  - `review`: Lists proposals and their active statuses.
+  - `status`: Shows aggregates of proposal statuses.
+  - `validate`: Validate proposal safety gates and operations block.
+  - `diff`: Preview proposed changes in unified diff format without modifying files.
+  - `apply`: Deterministically apply approved operations to the target codebase (requires `--approved`).
+  - `log`: Display Applied Proposals Audit Log execution history.
+- **`workflow`**: Orchestrate read-only development workflows (list, show, plan, run). Steps are restricted to safe, non-destructive CLI functions.
+- **`handoff`**: Compile token-compressed session context (build, show) at `.ai/intelligence/handoff.md` to transfer state to a new agent or model session.
+- **`dashboard`** (alias **`ui`**): Launches the zero-dependency interactive TUI dashboard. Automatically falls back to a clean list of equivalent commands when stdin/stdout are non-TTY.
+- **`plugin`**: Manage declarative plugins. Subcommands:
+  - `list`: Lists installed plugins.
+  - `show <slug>`: Shows detailed capabilities and safety notes of the plugin.
+  - `validate <path>`: Validates a YAML config file against the plugin JSON schema.
+  - `install <path>`: Previews file copy actions, and copies them to whitelisted paths under `.ai/` or `adapters/` if `--approved` is specified.
+  - `status`: Audits target directory to ensure all declared plugin assets are present.
 - **`verify`**: Automated release script that checks structure integrity.
 - **`templates`**: Lists built-in template profiles (supports overrides via `--registry <path>`).
 - **`validate`**: Strict Quality Gate checking the layout rules on disk (supports `--all-registries`).
 - **`validate-template`**: Scans a template registry entry and source directory structure for completeness.
 - **`validate-adapter`**: Audits an adapter config file and directory setup compliance.
 - **`validate-skill`**: Checks a custom skill file against standard Markdown headers.
-- **`doctor`**: Advisory checkup auditing ignored folders and token footprint (supports `--tokens` and `--release`).
+- **`doctor`**: Advisory checkup auditing ignored folders and token footprint (supports `--tokens`, `--release`, `--intelligence`, and `--onboarding`).
 
 ---
 
@@ -75,6 +117,7 @@ npx multimodel-dev-os@latest init --caveman
 
 ## 5. Canonical Links
 - **Documentation site**: https://rizvee.github.io/multimodel-dev-os/
+- **Guided Demo Workflows**: https://rizvee.github.io/multimodel-dev-os/demos/
 - **GitHub Codebase**: https://github.com/rizvee/multimodel-dev-os
 - **v2.0.0 Roadmap**: https://rizvee.github.io/multimodel-dev-os/v2-roadmap
 - **Release Policies**: https://rizvee.github.io/multimodel-dev-os/release-policy

package/docs/public/llms.txt

@@ -1,10 +1,62 @@
-# MultiModel Dev OS (v2.0.1 Stable Release)
+# MultiModel Dev OS (v2.8.0 Stable Release)
 
 Portable, vendor-neutral workspace configuration standard for multi-agent AI pair-programming workflows.
 
-## Fast Setup (Stable npm @latest)
+## Fast Setup & Commands (Stable npm @latest)
 ```bash
+# Initialize workspace
 npx multimodel-dev-os@latest init
+
+# Launch interactive terminal command center (TUI Dashboard)
+npx multimodel-dev-os@latest dashboard
+npx multimodel-dev-os@latest ui
+
+# Manage declarative plugins securely
+npx multimodel-dev-os@latest plugin list
+npx multimodel-dev-os@latest plugin show git-integration
+npx multimodel-dev-os@latest plugin validate path/to/plugin.yaml
+npx multimodel-dev-os@latest plugin install path/to/plugin.yaml --approved
+npx multimodel-dev-os@latest plugin status
+
+# Scan codebase signals & check status
+npx multimodel-dev-os@latest scan
+npx multimodel-dev-os@latest status
+
+# Onboard existing repositories safely
+npx multimodel-dev-os@latest onboard analyze
+npx multimodel-dev-os@latest onboard recommend
+npx multimodel-dev-os@latest onboard plan
+npx multimodel-dev-os@latest onboard apply --approved
+npx multimodel-dev-os@latest onboard status
+
+# Manage and sync IDE adapter configuration files
+npx multimodel-dev-os@latest adapter status
+npx multimodel-dev-os@latest adapter diff cursor
+npx multimodel-dev-os@latest adapter sync cursor --approved
+
+# Build/refresh memory index
+npx multimodel-dev-os@latest memory build
+npx multimodel-dev-os@latest memory refresh
+
+# Run automated workflow cycles
+npx multimodel-dev-os@latest workflow run repo-health
+npx multimodel-dev-os@latest workflow list
+
+# Compile session handoff spec
+npx multimodel-dev-os@latest handoff build
+npx multimodel-dev-os@latest handoff show
+
+# Manage developer feedback loop
+npx multimodel-dev-os@latest feedback add "Avoid Tailwind CSS" --type preference
+npx multimodel-dev-os@latest feedback summarize
+
+# Draft, review, validate, and apply codebase improvement proposals
+npx multimodel-dev-os@latest improve propose --title "Fix config issues"
+npx multimodel-dev-os@latest improve review
+npx multimodel-dev-os@latest improve validate .ai/proposals/proposal-xxxx.md
+npx multimodel-dev-os@latest improve diff .ai/proposals/proposal-xxxx.md
+npx multimodel-dev-os@latest improve apply .ai/proposals/proposal-xxxx.md --approved
+npx multimodel-dev-os@latest improve log
 ```
 
 ## Supported Tools
@@ -23,6 +75,7 @@ npx multimodel-dev-os@latest init
 - **Canonical Website**: https://rizvee.github.io/multimodel-dev-os/
 - **GitHub Repository**: https://github.com/rizvee/multimodel-dev-os
 - **NPM Package**: https://www.npmjs.com/package/multimodel-dev-os
+- **Guided Demo Workflows**: https://rizvee.github.io/multimodel-dev-os/demos/
 - **Stable Protocol Specification**: https://rizvee.github.io/multimodel-dev-os/stable-protocol
 - **Model Compatibility & Routing Guide**: https://rizvee.github.io/multimodel-dev-os/model-compatibility
 - **Cost/Context Optimization Playbook**: https://rizvee.github.io/multimodel-dev-os/cost-optimization

package/docs/public/sitemap.xml

@@ -115,4 +115,89 @@
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/future-proof-architecture</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/self-improving-codebase</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/hash-compressed-memory</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/feedback-learning</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/capability-registry</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/tool-registry</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/demos/</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/demos/existing-repo-onboarding</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/demos/multi-agent-handoff</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/demos/safe-improvement-loop</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/demos/adapter-sync</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/demos/release-check</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/distribution</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/dashboard</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/plugin-hooks</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/plugin-authoring</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/tui-safety</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
 </urlset>