multimodel-dev-os 0.5.0 → 0.6.0

package/bin/multimodel-dev-os.js

@@ -13,7 +13,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const sourceRoot = resolve(__dirname, '..');
 
-let version = '0.5.0';
+let version = '0.5.1';
 try {
   const pkgData = JSON.parse(readFileSync(resolve(sourceRoot, 'package.json'), 'utf8'));
   version = pkgData.version;
@@ -333,6 +333,73 @@ function handleInit(options) {
     }
   });
 
+  // Copy root-level adapter rule files if selected
+  if (!options.dryRun) {
+    options.adapters.forEach(adapter => {
+      if (adapter === 'cursor') {
+        const srcFile = join(sourceRoot, 'adapters/cursor/.cursorrules');
+        const destFile = join(options.target, '.cursorrules');
+        if (existsSync(srcFile)) {
+          writeFileSync(destFile, readFileSync(srcFile));
+          console.log(`  \x1b[32mCREATE ROOT ADAPTER FILE:\x1b[0m .cursorrules`);
+        }
+      } else if (adapter === 'claude') {
+        const srcFile = join(sourceRoot, 'adapters/claude/CLAUDE.md');
+        const destFile = join(options.target, 'CLAUDE.md');
+        if (existsSync(srcFile)) {
+          writeFileSync(destFile, readFileSync(srcFile));
+          console.log(`  \x1b[32mCREATE ROOT ADAPTER FILE:\x1b[0m CLAUDE.md`);
+        }
+      } else if (adapter === 'vscode') {
+        const srcFile = join(sourceRoot, 'adapters/vscode/.vscode/settings.json');
+        const destDir = join(options.target, '.vscode');
+        const destFile = join(destDir, 'settings.json');
+        if (existsSync(srcFile)) {
+          if (!existsSync(destDir)) mkdirSync(destDir, { recursive: true });
+          writeFileSync(destFile, readFileSync(srcFile));
+          console.log(`  \x1b[32mCREATE ROOT ADAPTER FILE:\x1b[0m .vscode/settings.json`);
+        }
+      } else if (adapter === 'gemini') {
+        const srcFile = join(sourceRoot, 'adapters/gemini/GEMINI.md');
+        const destFile = join(options.target, 'GEMINI.md');
+        if (existsSync(srcFile)) {
+          writeFileSync(destFile, readFileSync(srcFile));
+          console.log(`  \x1b[32mCREATE ROOT ADAPTER FILE:\x1b[0m GEMINI.md`);
+        }
+      } else if (adapter === 'antigravity') {
+        const srcFile = join(sourceRoot, 'adapters/antigravity/.gemini/settings.json');
+        const destDir = join(options.target, '.gemini');
+        const destFile = join(destDir, 'settings.json');
+        if (existsSync(srcFile)) {
+          if (!existsSync(destDir)) mkdirSync(destDir, { recursive: true });
+          writeFileSync(destFile, readFileSync(srcFile));
+          console.log(`  \x1b[32mCREATE ROOT ADAPTER FILE:\x1b[0m .gemini/settings.json`);
+        }
+      }
+    });
+
+    // Dynamically enable selected adapters in the target .ai/config.yaml
+    const targetConfigPath = join(options.target, '.ai/config.yaml');
+    if (existsSync(targetConfigPath) && options.adapters.length > 0) {
+      let configContent = readFileSync(targetConfigPath, 'utf8');
+      options.adapters.forEach(adapter => {
+        const regex = new RegExp(`${adapter}:\\s*false`, 'g');
+        configContent = configContent.replace(regex, `${adapter}: true`);
+      });
+      writeFileSync(targetConfigPath, configContent, 'utf8');
+      console.log(`  \x1b[32mUPDATE CONFIG:\x1b[0m Enabled selected adapters [${options.adapters.join(', ')}] in .ai/config.yaml`);
+    }
+  } else {
+    // Dry run notes
+    options.adapters.forEach(adapter => {
+      if (adapter === 'cursor') console.log(`  \x1b[36m[DRY-RUN] WOULD CREATE ROOT ADAPTER FILE:\x1b[0m .cursorrules`);
+      else if (adapter === 'claude') console.log(`  \x1b[36m[DRY-RUN] WOULD CREATE ROOT ADAPTER FILE:\x1b[0m CLAUDE.md`);
+      else if (adapter === 'vscode') console.log(`  \x1b[36m[DRY-RUN] WOULD CREATE ROOT ADAPTER FILE:\x1b[0m .vscode/settings.json`);
+      else if (adapter === 'gemini') console.log(`  \x1b[36m[DRY-RUN] WOULD CREATE ROOT ADAPTER FILE:\x1b[0m GEMINI.md`);
+      else if (adapter === 'antigravity') console.log(`  \x1b[36m[DRY-RUN] WOULD CREATE ROOT ADAPTER FILE:\x1b[0m .gemini/settings.json`);
+    });
+  }
+
   console.log(`\n\x1b[32m✔ Project initialized successfully! [Total Operations: ${operations.length}]\x1b[0m\n`);
 }
 
@@ -468,6 +535,7 @@ function handleDoctor(options) {
     checkAdapter('claude', 'CLAUDE.md');
     checkAdapter('gemini', 'GEMINI.md');
     checkAdapter('vscode', '.vscode/settings.json');
+    checkAdapter('antigravity', '.gemini/settings.json');
   } else {
     warn('.ai/config.yaml is missing from project. Active adapters could not be audited.');
   }
@@ -570,6 +638,7 @@ function handleValidate(options) {
     assertAdapter('claude', 'CLAUDE.md');
     assertAdapter('gemini', 'GEMINI.md');
     assertAdapter('vscode', '.vscode/settings.json');
+    assertAdapter('antigravity', '.gemini/settings.json');
   }
 
   console.log('\n==================================================');

package/docs/.vitepress/config.js

@@ -0,0 +1,57 @@
+export default {
+  base: '/multimodel-dev-os/',
+  title: 'MultiModel Dev OS',
+  description: 'Portable, vendor-neutral AI Developer OS for multi-agent coding workflows.',
+  ignoreDeadLinks: true,
+  themeConfig: {
+    logo: '/logo.png',
+    nav: [
+      { text: 'Home', link: '/' },
+      { text: 'Quickstart', link: '/quickstart' },
+      { text: 'Templates', link: '/templates/' },
+      { text: 'GitHub', link: 'https://github.com/rizvee/multimodel-dev-os' }
+    ],
+    sidebar: [
+      {
+        text: 'Getting Started',
+        items: [
+          { text: 'Introduction', link: '/' },
+          { text: 'Quickstart', link: '/quickstart' },
+          { text: 'FAQ', link: '/faq' }
+        ]
+      },
+      {
+        text: 'Core Features',
+        items: [
+          { text: 'Command Line Reference', link: '/CLI' },
+          { text: 'Architecture Specifications', link: '/architecture' },
+          { text: 'Adapters Setup Guide', link: '/adapters' },
+          { text: 'Caveman Mode Specifications', link: '/caveman-mode' }
+        ]
+      },
+      {
+        text: 'Templates & Use Cases',
+        items: [
+          { text: 'Template Gallery', link: '/templates/' },
+          { text: 'Use Cases Guide', link: '/use-cases' },
+          { text: 'Templates Architecture', link: '/templates-guide' }
+        ]
+      },
+      {
+        text: 'Operations & Publishing',
+        items: [
+          { text: 'CLI Roadmap', link: '/cli-roadmap' },
+          { text: 'NPM Publishing Runbook', link: '/npm-publishing' },
+          { text: 'Pre-flight Release Testing', link: '/testing-v0.2' }
+        ]
+      }
+    ],
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/rizvee/multimodel-dev-os' }
+    ],
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: 'Copyright © 2026-present MultiModel Dev OS team.'
+    }
+  }
+}

package/docs/CLI.md

@@ -0,0 +1,50 @@
+# CLI Command Reference
+
+`multimodel-dev-os` features a lightweight, dependency-free local CLI utility. It allows standard bootstraps, structural integrity checks, and rule validations natively.
+
+## Execution
+
+Execute the CLI globally or inside target folder contexts using `npx`:
+
+```bash
+npx multimodel-dev-os@latest <command> [options]
+```
+
+Or execute locally within a cloned workspace:
+
+```bash
+node bin/multimodel-dev-os.js <command> [options]
+```
+
+---
+
+## Commands
+
+### 1. `init`
+Scaffold `multimodel-dev-os` files and adapters cleanly.
+* **Usage:** `node bin/multimodel-dev-os.js init [options]`
+* **Options:**
+  - `-t, --target <path>`: Specifies target destination (default: current working directory).
+  - `--template <name>`: Stack blueprint: `nextjs-saas`, `wordpress-site`, `ecommerce-store`, `seo-landing-page`, `general-app`.
+  - `-a, --adapter <name>`: Inject rules file directly (`cursor`, `claude`, `vscode`, `gemini`, `antigravity`, `codex`).
+  - `--caveman`: Installs ultra-lightweight variant profiles.
+  - `-d, --dry-run`: Previews actions without mutated files.
+  - `-f, --force`: Overwrites conflicts.
+
+### 2. `validate`
+Strict directory schema compliance gate checks.
+* **Usage:** `node bin/multimodel-dev-os.js validate [options]`
+* **Assertions:** Checks for the presence of crucial root files and enabled adapters' rule targets. If assertions fail, exits with status 1.
+
+### 3. `doctor`
+Advisory checkups for gitignores and large token-sinks.
+* **Usage:** `node bin/multimodel-dev-os.js doctor [options]`
+* **Audits:** Missing `.env` gates in gitignores, missing build steps inside `AGENTS.md`, and large unignored directories (e.g. `node_modules`, `.next`). Reports warnings without blocking execution.
+
+### 4. `templates` / `list-templates`
+Inspection map of all built-in stacks.
+* **Usage:** `node bin/multimodel-dev-os.js templates`
+
+### 5. `show-template <name>`
+Detailed layout specifications and skill blueprints audit.
+* **Usage:** `node bin/multimodel-dev-os.js show-template nextjs-saas`

package/docs/index.md

@@ -0,0 +1,55 @@
+---
+layout: home
+
+hero:
+  name: "MultiModel Dev OS"
+  text: "Standardize your AI pair-programmers"
+  tagline: "Portable, vendor-neutral workspace configurations for multi-agent coding loops."
+  image:
+    src: /logo.png
+    alt: MultiModel Dev OS Logo
+  actions:
+    - theme: brand
+      text: Get Started Quick
+      link: /quickstart
+    - theme: alt
+      text: View Template Gallery
+      link: /templates/
+    - theme: alt
+      text: View on GitHub
+      link: https://github.com/rizvee/multimodel-dev-os
+
+features:
+  - icon: 🧠
+    title: Universal Portability
+    details: Supports Codex, Antigravity, Cursor, Claude Code, Gemini, and VS Code with dynamic adapters sync.
+  - icon: ⚡
+    title: Ultra-Low Token Footprint
+    details: Includes Caveman Mode to slash model context footprint by ~79%, saving massive API bill budgets.
+  - icon: 🛡️
+    title: Local Quality Gates
+    details: Build-in zero-dependency validate and doctor checkups ensure pristine workspace rules layout.
+---
+
+<style>
+:root {
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: linear-gradient(135deg, #646cff 0%, #42b883 100%);
+}
+</style>
+
+## 10-Second Quickstart
+
+Bootstrap your project instantly via `npx`:
+
+```bash
+npx multimodel-dev-os@latest init
+```
+
+## Why MultiModel Dev OS?
+
+AI coding tools are incredibly fast, but switching between them introduces context fragmentation:
+1. **Context Loss:** You use **Cursor** for quick code completions, **Claude Code** for command-line implementations, and **Gemini/Antigravity** for auditing large code volumes. Every context switch drops your operational parameters.
+2. **Instruction Drift:** Different tools look for different files (`.cursorrules`, `CLAUDE.md`, `.vscode/settings.json`, `.gemini/settings.json`). If you modify build scripts or styling rules in one place, they quickly drift across others, causing confusing compile failures.
+
+`multimodel-dev-os` establishes a single source of truth inside your repository using a standardized root structure (`AGENTS.md`, `MEMORY.md`, `TASKS.md`, `RUNBOOK.md`) and a `.ai/` context configuration directory.

package/docs/templates/index.md

@@ -0,0 +1,30 @@
+# Scaffolding Template Gallery
+
+`multimodel-dev-os` provides high-fidelity, real-world scaffolding profiles for common architectural targets.
+
+## Stacks Blueprints
+
+### [Next.js SaaS Stack](/use-cases.html#_1-next-js-saas-stack)
+- **Tech Stack:** Next.js 14 App Router, TypeScript, React Server Actions, Prisma, Stripe.
+- **Skill File:** `.ai/skills/nextjs-action-build.md` (form parameters validation and isolation conventions).
+- **Audit Target:** `npx multimodel-dev-os init --template nextjs-saas`
+
+### [WordPress Theme & Plugin Custom Site](/use-cases.html#_4-wordpress-custom-site)
+- **Tech Stack:** WordPress Core, PHP 8.1+, Gutenberg custom blocks, MySQL.
+- **Skill File:** `.ai/skills/plugin-boilerplate.md` (database escape statements and esc_html gates).
+- **Audit Target:** `npx multimodel-dev-os init --template wordpress-site`
+
+### [Headless E-commerce Cart](/use-cases.html#_2-headless-e-commerce-store)
+- **Tech Stack:** MedusaJS, Stripe API, cart session structures.
+- **Skill File:** `.ai/skills/webhook-handler.md` (Checkout validation loops and webhook signatures auditing).
+- **Audit Target:** `npx multimodel-dev-os init --template ecommerce-store`
+
+### [SEO Astro Landing Layout](/use-cases.html#_3-seo-landing-page)
+- **Tech Stack:** Astro, Tailwind, HTML5, structured JSON-LD schemas.
+- **Skill File:** `.ai/skills/seo-audit.md` (Image compression parameters and meta validations).
+- **Audit Target:** `npx multimodel-dev-os init --template seo-landing-page`
+
+### [General Universal App API](/use-cases.html#_5-general-application-scaffolding)
+- **Tech Stack:** Node, Express, PostgreSQL, Jest.
+- **Skill File:** `.ai/skills/example-skill.md` (Standardized environment variables and validation middleware).
+- **Audit Target:** `npx multimodel-dev-os init --template general-app`

package/examples/ecommerce-store/.ai/config.yaml

@@ -1,7 +1,7 @@
 adapters:
-  cursor: true
-  claude: true
-  vscode: true
+  cursor: false
+  claude: false
+  vscode: false
 mode: standard
 orchestrator:
   mode: sequential

package/examples/general-app/.ai/config.yaml

@@ -1,7 +1,7 @@
 adapters:
-  cursor: true
-  claude: true
-  vscode: true
+  cursor: false
+  claude: false
+  vscode: false
 mode: standard
 orchestrator:
   mode: sequential

package/examples/nextjs-saas/.ai/config.yaml

@@ -1,7 +1,7 @@
 adapters:
-  cursor: true
-  claude: true
-  vscode: true
+  cursor: false
+  claude: false
+  vscode: false
 mode: standard
 orchestrator:
   mode: sequential

package/examples/wordpress-site/.ai/config.yaml

@@ -1,7 +1,7 @@
 adapters:
-  cursor: true
-  claude: true
-  vscode: true
+  cursor: false
+  claude: false
+  vscode: false
 mode: standard
 orchestrator:
   mode: sequential

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multimodel-dev-os",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "bin": {
     "multimodel-dev-os": "bin/multimodel-dev-os.js"
   },
@@ -31,13 +31,22 @@
     "adapters/",
     "scripts/",
     "docs/",
+    "!docs/.vitepress/dist/",
+    "!docs/.vitepress/cache/",
     "examples/",
     "bin/"
   ],
   "scripts": {
-    "verify": "bash scripts/verify.sh",
+    "verify": "node scripts/verify.js",
+    "verify:bash": "bash scripts/verify.sh",
     "test:cli": "node bin/multimodel-dev-os.js verify",
     "pack:template": "bash scripts/pack-template.sh",
-    "pack": "bash scripts/pack-template.sh"
+    "pack": "bash scripts/pack-template.sh",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "devDependencies": {
+    "vitepress": "^1.6.4"
   }
 }

package/scripts/install.ps1

@@ -11,7 +11,7 @@ param(
   [switch]$Help
 )
 
-$Version = "0.5.0"
+$Version = "0.5.1"
 $RepoUrl = "https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main"
 
 if ($Help) {

package/scripts/install.sh

@@ -7,7 +7,7 @@ set -euo pipefail
 #        --all      (install all adapters)
 #        --dry-run  (show what would be created without creating)
 
-VERSION="0.5.0"
+VERSION="0.5.1"
 REPO_URL="https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main"
 CAVEMAN=false
 DRY_RUN=false

package/scripts/verify.js

@@ -0,0 +1,274 @@
+#!/usr/bin/env node
+
+/**
+ * multimodel-dev-os strict cross-platform release verification script.
+ * Checks that all required files and directories exist in their exact locations.
+ * Runs on Windows, macOS, and Linux with zero external dependencies.
+ */
+
+import { existsSync, readFileSync, statSync } from 'fs';
+import { join, resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const projectRoot = resolve(__dirname, '..');
+
+let pass = 0;
+let fail = 0;
+let warn = 0;
+
+const RED = '\x1b[31m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const NC = '\x1b[0m';
+
+function checkFile(relPath, required = true) {
+  const fullPath = join(projectRoot, relPath);
+  if (existsSync(fullPath) && statSync(fullPath).isFile()) {
+    console.log(`  ${GREEN}✓${NC} ${relPath}`);
+    pass++;
+    return true;
+  } else if (required) {
+    console.error(`  ${RED}✗${NC} ${relPath} (missing)`);
+    fail++;
+    return false;
+  } else {
+    console.log(`  ${YELLOW}?${NC} ${relPath} (optional, not found)`);
+    warn++;
+    return false;
+  }
+}
+
+function checkDir(relPath) {
+  const fullPath = join(projectRoot, relPath);
+  if (existsSync(fullPath) && statSync(fullPath).isDirectory()) {
+    console.log(`  ${GREEN}✓${NC} ${relPath}/`);
+    pass++;
+    return true;
+  } else {
+    console.error(`  ${RED}✗${NC} ${relPath}/ (missing)`);
+    fail++;
+    return false;
+  }
+}
+
+console.log('multimodel-dev-os - Strict Release Audit Verification');
+console.log('=====================================================');
+console.log('');
+
+// --- Root Files ---
+console.log('Root files:');
+checkFile('AGENTS.md');
+checkFile('MEMORY.md');
+checkFile('TASKS.md');
+checkFile('RUNBOOK.md');
+checkFile('README.md');
+checkFile('LICENSE');
+checkFile('CONTRIBUTING.md');
+checkFile('CODE_OF_CONDUCT.md');
+checkFile('SECURITY.md');
+checkFile('CHANGELOG.md');
+checkFile('package.json');
+checkFile('.gitignore');
+checkFile('.gitattributes');
+checkFile('.editorconfig', false);
+
+// --- .ai/ Core Directory & YAML ---
+console.log('\n.ai/ directory & config:');
+checkDir('.ai');
+checkFile('.ai/config.yaml');
+
+// --- .ai/context/ ---
+console.log('\n.ai/context/ files:');
+checkFile('.ai/context/project-brief.md');
+checkFile('.ai/context/architecture.md');
+checkFile('.ai/context/business-rules.md');
+checkFile('.ai/context/seo-rules.md');
+checkFile('.ai/context/deployment-rules.md');
+checkFile('.ai/context/model-map.md');
+checkFile('.ai/context/context-budget.md');
+
+// --- .ai/agents/ ---
+console.log('\n.ai/agents/ files:');
+checkFile('.ai/agents/multimodel-orchestrator.md');
+checkFile('.ai/agents/planner.md');
+checkFile('.ai/agents/coder.md');
+checkFile('.ai/agents/reviewer.md');
+checkFile('.ai/agents/qa-tester.md');
+checkFile('.ai/agents/security-auditor.md');
+checkFile('.ai/agents/seo-auditor.md');
+checkFile('.ai/agents/devops.md');
+
+// --- .ai/skills/ ---
+console.log('\n.ai/skills/ files:');
+checkFile('.ai/skills/model-routing.md');
+checkFile('.ai/skills/context-routing.md');
+checkFile('.ai/skills/nextjs-feature-build.md');
+checkFile('.ai/skills/bug-fix.md');
+checkFile('.ai/skills/refactor.md');
+checkFile('.ai/skills/seo-implementation.md');
+checkFile('.ai/skills/landing-page-optimization.md');
+checkFile('.ai/skills/cpanel-deploy.md');
+checkFile('.ai/skills/caveman-bug-fix.md');
+checkFile('.ai/skills/caveman-feature-build.md');
+checkFile('.ai/skills/caveman-context-handoff.md');
+
+// --- .ai/prompts/ ---
+console.log('\n.ai/prompts/ files:');
+checkFile('.ai/prompts/plan-first.md');
+checkFile('.ai/prompts/implement-safely.md');
+checkFile('.ai/prompts/review-diff.md');
+checkFile('.ai/prompts/generate-tests.md');
+checkFile('.ai/prompts/summarize-session.md');
+checkFile('.ai/prompts/handoff-to-next-model.md');
+
+// --- .ai/checks/ ---
+console.log('\n.ai/checks/ files:');
+checkFile('.ai/checks/pre-implementation.md');
+checkFile('.ai/checks/pre-commit.md');
+checkFile('.ai/checks/pre-deploy.md');
+checkFile('.ai/checks/regression-checklist.md');
+checkFile('.ai/checks/context-budget.md');
+
+// --- .ai/templates/ ---
+console.log('\n.ai/templates/ files:');
+checkFile('.ai/templates/task-template.md');
+checkFile('.ai/templates/feature-spec-template.md');
+checkFile('.ai/templates/bug-report-template.md');
+checkFile('.ai/templates/session-log-template.md');
+checkFile('.ai/templates/project-memory-template.md');
+
+// --- Adapters ---
+console.log('\nAdapters:');
+checkFile('adapters/codex/AGENTS.md');
+checkFile('adapters/codex/setup.md');
+checkFile('adapters/antigravity/AGENTS.md');
+checkFile('adapters/antigravity/.gemini/settings.json');
+checkFile('adapters/antigravity/setup.md');
+checkFile('adapters/cursor/.cursorrules');
+checkFile('adapters/cursor/setup.md');
+checkFile('adapters/claude/CLAUDE.md');
+checkFile('adapters/claude/setup.md');
+checkFile('adapters/gemini/GEMINI.md');
+checkFile('adapters/gemini/setup.md');
+checkFile('adapters/vscode/.vscode/settings.json');
+checkFile('adapters/vscode/setup.md');
+
+// --- Examples ---
+console.log('\nExamples:');
+checkFile('examples/nextjs-saas/AGENTS.md');
+checkFile('examples/nextjs-saas/MEMORY.md');
+checkFile('examples/wordpress-site/AGENTS.md');
+checkFile('examples/wordpress-site/MEMORY.md');
+checkFile('examples/ecommerce-store/AGENTS.md');
+checkFile('examples/ecommerce-store/MEMORY.md');
+checkFile('examples/seo-landing-page/AGENTS.md');
+checkFile('examples/seo-landing-page/MEMORY.md');
+checkFile('examples/general-app/AGENTS.md');
+checkFile('examples/general-app/MEMORY.md');
+
+// --- Scripts & bin ---
+console.log('\nScripts & Executables:');
+checkFile('scripts/install.sh');
+checkFile('scripts/install.ps1');
+checkFile('scripts/verify.sh');
+checkFile('scripts/pack-template.sh');
+checkFile('bin/multimodel-dev-os.js');
+
+// --- GitHub Integration ---
+console.log('\nGitHub Workflows:');
+checkFile('.github/workflows/verify.yml');
+
+// --- Documentation ---
+console.log('\nExtended Documentation:');
+checkFile('docs/quickstart.md');
+checkFile('docs/architecture.md');
+checkFile('docs/multimodel-workflow.md');
+checkFile('docs/caveman-mode.md');
+checkFile('docs/adapters.md');
+checkFile('docs/installers.md');
+checkFile('docs/cli-roadmap.md');
+checkFile('docs/faq.md');
+checkFile('docs/testing-v0.2.md');
+checkFile('docs/npm-publishing.md');
+checkFile('docs/templates-guide.md');
+
+// --- CLI & Packaging Pre-Flight Tests ---
+console.log('\nRunning CLI & Packaging Pre-Flight Tests...');
+
+// Verify package.json version is exactly 0.5.1
+try {
+  const pkgData = JSON.parse(readFileSync(join(projectRoot, 'package.json'), 'utf8'));
+  if (pkgData.version !== '0.5.1') {
+    console.error(`  ${RED}✗${NC} package.json version is not 0.5.1 (found ${pkgData.version})`);
+    fail++;
+  } else {
+    console.log(`  ${GREEN}✓${NC} package.json version is exactly 0.5.1`);
+    pass++;
+  }
+} catch (e) {
+  console.error(`  ${RED}✗${NC} Failed to parse package.json: ${e.message}`);
+  fail++;
+}
+
+// Verify CLI help displays v0.5.1
+try {
+  const helpOutput = execSync('node bin/multimodel-dev-os.js --help', { cwd: projectRoot, encoding: 'utf8' });
+  if (!helpOutput.includes('v0.5.1')) {
+    console.error(`  ${RED}✗${NC} CLI help does not display v0.5.1`);
+    fail++;
+  } else {
+    console.log(`  ${GREEN}✓${NC} CLI help displays v0.5.1`);
+    pass++;
+  }
+} catch (e) {
+  console.error(`  ${RED}✗${NC} node bin/multimodel-dev-os.js --help failed: ${e.message}`);
+  fail++;
+}
+
+// Verify npm pack dry-run shows v0.5.1
+try {
+  const packOutput = execSync('npm pack --dry-run', { cwd: projectRoot, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+  if (packOutput.includes('multimodel-dev-os@0.5.1') || packOutput.includes('multimodel-dev-os-0.5.1.tgz') || packOutput.includes('version: 0.5.1')) {
+    console.log(`  ${GREEN}✓${NC} npm pack --dry-run reports version 0.5.1`);
+    pass++;
+  } else {
+    // Check stderr
+    console.error(`  ${RED}✗${NC} npm pack --dry-run did not report 0.5.1 in stdout`);
+    fail++;
+  }
+} catch (e) {
+  const stdErrOut = e.stderr ? e.stderr.toString() : '';
+  const stdOutOut = e.stdout ? e.stdout.toString() : '';
+  if (stdErrOut.includes('multimodel-dev-os@0.5.1') || stdErrOut.includes('multimodel-dev-os-0.5.1.tgz') || stdOutOut.includes('multimodel-dev-os-0.5.1.tgz')) {
+    console.log(`  ${GREEN}✓${NC} npm pack --dry-run reports version 0.5.1`);
+    pass++;
+  } else {
+    console.error(`  ${RED}✗${NC} npm pack --dry-run failed or did not report 0.5.1: ${e.message}`);
+    fail++;
+  }
+}
+
+// Dry run verify command runs cleanly
+try {
+  execSync('node bin/multimodel-dev-os.js verify', { cwd: projectRoot, stdio: 'ignore' });
+  console.log(`  ${GREEN}✓${NC} node bin/multimodel-dev-os.js verify`);
+  pass++;
+} catch (e) {
+  console.error(`  ${RED}✗${NC} node bin/multimodel-dev-os.js verify failed: ${e.message}`);
+  fail++;
+}
+
+console.log('\n=====================================================');
+const total = pass + fail + warn;
+console.log(`  Pass: ${GREEN}${pass}${NC}  Fail: ${RED}${fail}${NC}  Warn: ${YELLOW}${warn}${NC}  Total: ${total}`);
+
+if (fail > 0) {
+  console.error(`\n${RED}Verification failed. Fix issues listed above.${NC}`);
+  process.exit(1);
+} else {
+  console.log(`\n${GREEN}Verification passed successfully.${NC}`);
+  process.exit(0);
+}

package/scripts/verify.sh

@@ -197,30 +197,30 @@ check_file "docs/npm-publishing.md"
 echo ""
 echo "Running CLI & Packaging Pre-Flight Tests..."
 
-# Verify package.json version is exactly 0.5.0
-if ! grep -q '"version": "0.5.0"' package.json; then
-  echo -e "  ${RED}✗${NC} package.json version is not 0.5.0"
+# Verify package.json version is exactly 0.5.1
+if ! grep -q '"version": "0.5.1"' package.json; then
+  echo -e "  ${RED}✗${NC} package.json version is not 0.5.1"
   FAIL=$((FAIL + 1))
 else
-  echo -e "  ${GREEN}✓${NC} package.json version is exactly 0.5.0"
+  echo -e "  ${GREEN}✓${NC} package.json version is exactly 0.5.1"
   PASS=$((PASS + 1))
 fi
 
-# Verify CLI version matches v0.5.0
-if ! node bin/multimodel-dev-os.js --help | grep -q 'v0.5.0'; then
-  echo -e "  ${RED}✗${NC} CLI help does not display v0.5.0"
+# Verify CLI version matches v0.5.1
+if ! node bin/multimodel-dev-os.js --help | grep -q 'v0.5.1'; then
+  echo -e "  ${RED}✗${NC} CLI help does not display v0.5.1"
   FAIL=$((FAIL + 1))
 else
-  echo -e "  ${GREEN}✓${NC} CLI help displays v0.5.0"
+  echo -e "  ${GREEN}✓${NC} CLI help displays v0.5.1"
   PASS=$((PASS + 1))
 fi
 
-# Verify npm pack dry-run shows v0.5.0
-if ! npm pack --dry-run 2>&1 | grep -q 'multimodel-dev-os@0.5.0'; then
-  echo -e "  ${RED}✗${NC} npm pack --dry-run does not report version 0.5.0"
+# Verify npm pack dry-run shows v0.5.1
+if ! npm pack --dry-run 2>&1 | grep -q 'multimodel-dev-os@0.5.1'; then
+  echo -e "  ${RED}✗${NC} npm pack --dry-run does not report version 0.5.1"
   FAIL=$((FAIL + 1))
 else
-  echo -e "  ${GREEN}✓${NC} npm pack --dry-run reports version 0.5.0"
+  echo -e "  ${GREEN}✓${NC} npm pack --dry-run reports version 0.5.1"
   PASS=$((PASS + 1))
 fi