multimodel-dev-os 0.5.1 → 0.6.1

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multimodel-dev-os",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "bin": {
     "multimodel-dev-os": "bin/multimodel-dev-os.js"
   },
@@ -31,6 +31,8 @@
     "adapters/",
     "scripts/",
     "docs/",
+    "!docs/.vitepress/dist/",
+    "!docs/.vitepress/cache/",
     "examples/",
     "bin/"
   ],
@@ -39,6 +41,12 @@
     "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/verify.js

@@ -198,14 +198,16 @@ 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
+// Verify package.json version dynamically
+let expectedVersion = '';
 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})`);
+  expectedVersion = pkgData.version;
+  if (!expectedVersion || !/^\d+\.\d+\.\d+/.test(expectedVersion)) {
+    console.error(`  ${RED}✗${NC} package.json version is invalid (found ${expectedVersion})`);
     fail++;
   } else {
-    console.log(`  ${GREEN}✓${NC} package.json version is exactly 0.5.1`);
+    console.log(`  ${GREEN}✓${NC} package.json version is valid: ${expectedVersion}`);
     pass++;
   }
 } catch (e) {
@@ -213,14 +215,14 @@ try {
   fail++;
 }
 
-// Verify CLI help displays v0.5.1
+// Verify CLI help displays current version dynamically
 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`);
+  if (!helpOutput.includes(`v${expectedVersion}`)) {
+    console.error(`  ${RED}✗${NC} CLI help does not display v${expectedVersion}`);
     fail++;
   } else {
-    console.log(`  ${GREEN}✓${NC} CLI help displays v0.5.1`);
+    console.log(`  ${GREEN}✓${NC} CLI help displays v${expectedVersion}`);
     pass++;
   }
 } catch (e) {
@@ -228,25 +230,24 @@ try {
   fail++;
 }
 
-// Verify npm pack dry-run shows v0.5.1
+// Verify npm pack dry-run shows current version dynamically
 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`);
+  if (packOutput.includes(`multimodel-dev-os@${expectedVersion}`) || packOutput.includes(`multimodel-dev-os-${expectedVersion}.tgz`) || packOutput.includes(`version: ${expectedVersion}`)) {
+    console.log(`  ${GREEN}✓${NC} npm pack --dry-run reports version ${expectedVersion}`);
     pass++;
   } else {
-    // Check stderr
-    console.error(`  ${RED}✗${NC} npm pack --dry-run did not report 0.5.1 in stdout`);
+    console.error(`  ${RED}✗${NC} npm pack --dry-run did not report ${expectedVersion} 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`);
+  if (stdErrOut.includes(`multimodel-dev-os@${expectedVersion}`) || stdErrOut.includes(`multimodel-dev-os-${expectedVersion}.tgz`) || stdOutOut.includes(`multimodel-dev-os-${expectedVersion}.tgz`)) {
+    console.log(`  ${GREEN}✓${NC} npm pack --dry-run reports version ${expectedVersion}`);
     pass++;
   } else {
-    console.error(`  ${RED}✗${NC} npm pack --dry-run failed or did not report 0.5.1: ${e.message}`);
+    console.error(`  ${RED}✗${NC} npm pack --dry-run failed or did not report ${expectedVersion}: ${e.message}`);
     fail++;
   }
 }

package/scripts/verify.sh

@@ -197,30 +197,33 @@ check_file "docs/npm-publishing.md"
 echo ""
 echo "Running CLI & Packaging Pre-Flight Tests..."
 
-# 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"
+# Extract version dynamically from package.json
+VERSION=$(node -e "import fs from 'fs'; console.log(JSON.parse(fs.readFileSync('package.json')).version)")
+
+# Verify package.json version exists and is valid
+if [ -z "$VERSION" ]; then
+  echo -e "  ${RED}✗${NC} package.json version could not be resolved"
   FAIL=$((FAIL + 1))
 else
-  echo -e "  ${GREEN}✓${NC} package.json version is exactly 0.5.1"
+  echo -e "  ${GREEN}✓${NC} package.json version dynamically resolved: $VERSION"
   PASS=$((PASS + 1))
 fi
 
-# 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"
+# Verify CLI version matches dynamically
+if ! node bin/multimodel-dev-os.js --help | grep -q "v$VERSION"; then
+  echo -e "  ${RED}✗${NC} CLI help does not display v$VERSION"
   FAIL=$((FAIL + 1))
 else
-  echo -e "  ${GREEN}✓${NC} CLI help displays v0.5.1"
+  echo -e "  ${GREEN}✓${NC} CLI help displays v$VERSION"
   PASS=$((PASS + 1))
 fi
 
-# 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"
+# Verify npm pack dry-run shows correct version dynamically
+if ! npm pack --dry-run 2>&1 | grep -q "multimodel-dev-os@$VERSION\|multimodel-dev-os-$VERSION.tgz"; then
+  echo -e "  ${RED}✗${NC} npm pack --dry-run does not report version $VERSION"
   FAIL=$((FAIL + 1))
 else
-  echo -e "  ${GREEN}✓${NC} npm pack --dry-run reports version 0.5.1"
+  echo -e "  ${GREEN}✓${NC} npm pack --dry-run reports version $VERSION"
   PASS=$((PASS + 1))
 fi