multimodel-dev-os 1.1.0 → 2.0.1

package/examples/expo-react-native-android/src/services/api-client.ts

@@ -0,0 +1,106 @@
+import Constants from 'expo-constants';
+
+export interface ApiResponse<T> {
+  data: T | null;
+  error: string | null;
+  status: number;
+}
+
+export class ApiClient {
+  private baseUrl: string;
+  private timeoutMs: number = 10000;
+  private maxRetries: number = 3;
+  private useMockData: boolean = false; // Toggle true for offline mock validations
+
+  constructor() {
+    // Dynamically retrieve base API URL configured in app.config.ts extras
+    const extra = Constants.expoConfig?.extra || {};
+    this.baseUrl = extra.apiUrl || 'http://10.0.2.2:3000/api';
+  }
+
+  async request<T>(path: string, options: RequestInit = {}): Promise<ApiResponse<T>> {
+    if (this.useMockData) {
+      // Mock response resolver
+      return new Promise((resolve) => {
+        setTimeout(() => {
+          resolve({
+            data: { message: "Mock Success data from ApiClient" } as unknown as T,
+            error: null,
+            status: 200
+          });
+        }, 500);
+      });
+    }
+
+    const url = `${this.baseUrl}${path}`;
+    const defaultHeaders = {
+      'Content-Type': 'application/json',
+      'Accept': 'application/json'
+    };
+
+    let attempt = 0;
+    while (attempt < this.maxRetries) {
+      attempt++;
+      const controller = new AbortController();
+      const id = setTimeout(() => controller.abort(), this.timeoutMs);
+
+      try {
+        const response = await fetch(url, {
+          ...options,
+          headers: {
+            ...defaultHeaders,
+            ...options.headers
+          },
+          signal: controller.signal
+        });
+
+        clearTimeout(id);
+
+        // Retry on Server Error (5xx)
+        if (response.status >= 500 && attempt < this.maxRetries) {
+          console.warn(`[ApiClient] Attempt ${attempt} failed with status ${response.status}. Retrying...`);
+          continue;
+        }
+
+        if (!response.ok) {
+          return {
+            data: null,
+            error: `HTTP Error: ${response.status} ${response.statusText}`,
+            status: response.status
+          };
+        }
+
+        const data = await response.json();
+        return {
+          data: data as T,
+          error: null,
+          status: response.status
+        };
+      } catch (e: any) {
+        clearTimeout(id);
+        const isTimeout = e.name === 'AbortError';
+        
+        // Retry on timeout or transient network failures
+        if (attempt < this.maxRetries) {
+          console.warn(`[ApiClient] Attempt ${attempt} failed: ${e.message}. Retrying...`);
+          await new Promise((res) => setTimeout(res, 1000 * attempt)); // Exponential backoff
+          continue;
+        }
+
+        return {
+          data: null,
+          error: isTimeout ? 'Request Timeout' : e.message || 'Unknown network error',
+          status: 0
+        };
+      }
+    }
+
+    return {
+      data: null,
+      error: 'Max retries exceeded',
+      status: 0
+    };
+  }
+}
+
+export const apiClient = new ApiClient();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multimodel-dev-os",
-  "version": "1.1.0",
+  "version": "2.0.1",
   "bin": {
     "multimodel-dev-os": "bin/multimodel-dev-os.js"
   },
@@ -45,7 +45,8 @@
     "pack": "bash scripts/pack-template.sh",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
-    "docs:preview": "vitepress preview docs"
+    "docs:preview": "vitepress preview docs",
+    "prepublishOnly": "node scripts/prepublish-guard.js"
   },
   "devDependencies": {
     "vitepress": "^1.6.4"

package/scripts/install.ps1

@@ -1,230 +1,230 @@
-# multimodel-dev-os installer for Windows (PowerShell)
-# Usage: irm https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/install.ps1 | iex
-# Flags: -Caveman  (use minimal-token templates)
-#        -All      (install all adapters)
-#        -DryRun   (show what would be created without creating)
-
-param(
-  [switch]$Caveman,
-  [switch]$All,
-  [switch]$DryRun,
-  [switch]$Help
-)
-
-$Version = "0.5.1"
-$RepoUrl = "https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main"
-
-if ($Help) {
-  Write-Host "multimodel-dev-os installer v$Version" -ForegroundColor Blue
-  Write-Host ""
-  Write-Host "Usage: irm .../install.ps1 | iex"
-  Write-Host ""
-  Write-Host "Options:"
-  Write-Host "  -Caveman   Use minimal-token templates (~79% fewer tokens)"
-  Write-Host "  -All       Install all adapters"
-  Write-Host "  -DryRun    Show what would be created without creating"
-  Write-Host "  -Help      Show this help message"
-  return
-}
-
-Write-Host "multimodel-dev-os installer v$Version" -ForegroundColor Blue
-Write-Host ""
-
-# --- Helper Functions ---
-
-function New-ProjectFile {
-  param(
-    [string]$Path,
-    [string]$Url
-  )
-
-  if (Test-Path $Path) {
-    Write-Host "  SKIP $Path (already exists)" -ForegroundColor Yellow
-    return
-  }
-
-  if ($DryRun) {
-    Write-Host "  WOULD CREATE $Path" -ForegroundColor Blue
-    return
-  }
-
-  $dir = Split-Path -Parent $Path
-  if ($dir -and !(Test-Path $dir)) {
-    New-Item -ItemType Directory -Path $dir -Force | Out-Null
-  }
-
-  try {
-    Invoke-WebRequest -Uri $Url -OutFile $Path -UseBasicParsing -ErrorAction Stop
-    Write-Host "  CREATE $Path" -ForegroundColor Green
-  }
-  catch {
-    Write-Host "  FAIL $Path (download failed)" -ForegroundColor Red
-  }
-}
-
-function New-ProjectDir {
-  param([string]$Path)
-
-  if (Test-Path $Path) {
-    Write-Host "  SKIP $Path/ (already exists)" -ForegroundColor Yellow
-    return
-  }
-
-  if ($DryRun) {
-    Write-Host "  WOULD CREATE $Path/" -ForegroundColor Blue
-    return
-  }
-
-  New-Item -ItemType Directory -Path $Path -Force | Out-Null
-  Write-Host "  CREATE $Path/" -ForegroundColor Green
-}
-
-# --- Phase 1: Core Files ---
-
-Write-Host "Creating core files..." -ForegroundColor Blue
-
-if ($Caveman) {
-  New-ProjectFile "AGENTS.md" "$RepoUrl/.ai/templates/AGENTS.caveman.md"
-  New-ProjectFile "MEMORY.md" "$RepoUrl/.ai/templates/MEMORY.caveman.md"
-  New-ProjectFile "TASKS.md" "$RepoUrl/.ai/templates/TASKS.caveman.md"
-  New-ProjectFile "RUNBOOK.md" "$RepoUrl/.ai/templates/RUNBOOK.caveman.md"
-}
-else {
-  New-ProjectFile "AGENTS.md" "$RepoUrl/AGENTS.md"
-  New-ProjectFile "MEMORY.md" "$RepoUrl/MEMORY.md"
-  New-ProjectFile "TASKS.md" "$RepoUrl/TASKS.md"
-  New-ProjectFile "RUNBOOK.md" "$RepoUrl/RUNBOOK.md"
-}
-New-ProjectFile ".gitattributes" "$RepoUrl/.gitattributes"
-New-ProjectFile "bin/multimodel-dev-os.js" "$RepoUrl/bin/multimodel-dev-os.js"
-
-# --- Phase 2: .ai/ Directory ---
-
-Write-Host ""
-Write-Host "Creating .ai/ directory..." -ForegroundColor Blue
-
-New-ProjectFile ".ai/config.yaml" "$RepoUrl/.ai/config.yaml"
-New-ProjectDir ".ai/context"
-New-ProjectFile ".ai/context/README.md" "$RepoUrl/.ai/context/README.md"
-New-ProjectDir ".ai/agents"
-New-ProjectFile ".ai/agents/README.md" "$RepoUrl/.ai/agents/README.md"
-New-ProjectFile ".ai/agents/multimodel-orchestrator.md" "$RepoUrl/.ai/agents/multimodel-orchestrator.md"
-New-ProjectDir ".ai/skills"
-New-ProjectFile ".ai/skills/README.md" "$RepoUrl/.ai/skills/README.md"
-New-ProjectFile ".ai/skills/example-skill.md" "$RepoUrl/.ai/skills/example-skill.md"
-New-ProjectDir ".ai/prompts"
-New-ProjectFile ".ai/prompts/README.md" "$RepoUrl/.ai/prompts/README.md"
-New-ProjectDir ".ai/checks"
-New-ProjectFile ".ai/checks/README.md" "$RepoUrl/.ai/checks/README.md"
-New-ProjectFile ".ai/checks/pre-commit.md" "$RepoUrl/.ai/checks/pre-commit.md"
-New-ProjectDir ".ai/session-logs"
-New-ProjectFile ".ai/session-logs/README.md" "$RepoUrl/.ai/session-logs/README.md"
-New-ProjectDir ".ai/templates"
-New-ProjectFile ".ai/templates/AGENTS.caveman.md" "$RepoUrl/.ai/templates/AGENTS.caveman.md"
-New-ProjectFile ".ai/templates/MEMORY.caveman.md" "$RepoUrl/.ai/templates/MEMORY.caveman.md"
-New-ProjectFile ".ai/templates/TASKS.caveman.md" "$RepoUrl/.ai/templates/TASKS.caveman.md"
-New-ProjectFile ".ai/templates/RUNBOOK.caveman.md" "$RepoUrl/.ai/templates/RUNBOOK.caveman.md"
-
-# --- Phase 3: Adapters ---
-
-Write-Host ""
-
-function Install-Adapter {
-  param([string]$Name)
-
-  Write-Host "Installing $Name adapter..." -ForegroundColor Blue
-
-  switch ($Name) {
-    "codex" {
-      New-ProjectFile "adapters/codex/AGENTS.md" "$RepoUrl/adapters/codex/AGENTS.md"
-      New-ProjectFile "adapters/codex/setup.md" "$RepoUrl/adapters/codex/setup.md"
-    }
-    "antigravity" {
-      New-ProjectFile "adapters/antigravity/AGENTS.md" "$RepoUrl/adapters/antigravity/AGENTS.md"
-      New-ProjectFile "adapters/antigravity/.gemini/settings.json" "$RepoUrl/adapters/antigravity/.gemini/settings.json"
-      New-ProjectFile "adapters/antigravity/setup.md" "$RepoUrl/adapters/antigravity/setup.md"
-    }
-    "cursor" {
-      New-ProjectFile "adapters/cursor/.cursorrules" "$RepoUrl/adapters/cursor/.cursorrules"
-      New-ProjectFile "adapters/cursor/setup.md" "$RepoUrl/adapters/cursor/setup.md"
-    }
-    "claude" {
-      New-ProjectFile "adapters/claude/CLAUDE.md" "$RepoUrl/adapters/claude/CLAUDE.md"
-      New-ProjectFile "adapters/claude/setup.md" "$RepoUrl/adapters/claude/setup.md"
-    }
-    "gemini" {
-      New-ProjectFile "adapters/gemini/GEMINI.md" "$RepoUrl/adapters/gemini/GEMINI.md"
-      New-ProjectFile "adapters/gemini/setup.md" "$RepoUrl/adapters/gemini/setup.md"
-    }
-    "vscode" {
-      New-ProjectFile "adapters/vscode/.vscode/settings.json" "$RepoUrl/adapters/vscode/.vscode/settings.json"
-      New-ProjectFile "adapters/vscode/setup.md" "$RepoUrl/adapters/vscode/setup.md"
-    }
-  }
-}
-
-if ($All) {
-  foreach ($adapter in @("codex", "antigravity", "cursor", "claude", "gemini", "vscode")) {
-    Install-Adapter $adapter
-  }
-}
-else {
-  Write-Host "Which adapters do you want to install?" -ForegroundColor Yellow
-  Write-Host "  1) all"
-  Write-Host "  2) codex"
-  Write-Host "  3) antigravity"
-  Write-Host "  4) cursor"
-  Write-Host "  5) claude"
-  Write-Host "  6) gemini"
-  Write-Host "  7) vscode"
-  Write-Host "  8) none"
-  Write-Host ""
-  $choices = Read-Host "Enter choices (comma-separated, e.g., 2,4,5)"
-
-  if ([string]::IsNullOrWhiteSpace($choices) -or $choices -eq "8") {
-    Write-Host "Skipping adapters." -ForegroundColor Yellow
-  }
-  elseif ($choices -eq "1") {
-    foreach ($adapter in @("codex", "antigravity", "cursor", "claude", "gemini", "vscode")) {
-      Install-Adapter $adapter
-    }
-  }
-  else {
-    $selected = $choices -split "," | ForEach-Object { $_.Trim() }
-    foreach ($choice in $selected) {
-      switch ($choice) {
-        "2" { Install-Adapter "codex" }
-        "3" { Install-Adapter "antigravity" }
-        "4" { Install-Adapter "cursor" }
-        "5" { Install-Adapter "claude" }
-        "6" { Install-Adapter "gemini" }
-        "7" { Install-Adapter "vscode" }
-        default { Write-Host "Unknown choice: $choice" -ForegroundColor Red }
-      }
-    }
-  }
-}
-
-# --- Summary ---
-
-Write-Host ""
-Write-Host "multimodel-dev-os installed!" -ForegroundColor Green
-Write-Host ""
-Write-Host "Next steps:"
-Write-Host "  1. Edit AGENTS.md with your project details"
-Write-Host "  2. Edit .ai/config.yaml to enable your adapters"
-Write-Host "  3. Copy adapter files to your project root as needed:"
-Write-Host "     - Cursor: Copy-Item adapters/cursor/.cursorrules .cursorrules"
-Write-Host "     - Claude: Copy-Item adapters/claude/CLAUDE.md CLAUDE.md"
-Write-Host "     - VS Code: Copy-Item -Recurse adapters/vscode/.vscode/ .vscode/"
-Write-Host ""
-Write-Host "  Docs: https://github.com/rizvee/multimodel-dev-os"
-Write-Host ""
-
-if ($Caveman) {
-  Write-Host "  Caveman Mode active - minimal-token templates installed" -ForegroundColor Yellow
-}
-
-if ($DryRun) {
-  Write-Host "  Dry run - no files were created" -ForegroundColor Blue
-}
+# multimodel-dev-os installer for Windows (PowerShell)
+# Usage: irm https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/install.ps1 | iex
+# Flags: -Caveman  (use minimal-token templates)
+#        -All      (install all adapters)
+#        -DryRun   (show what would be created without creating)
+
+param(
+  [switch]$Caveman,
+  [switch]$All,
+  [switch]$DryRun,
+  [switch]$Help
+)
+
+$Version = "2.0.1"
+$RepoUrl = "https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main"
+
+if ($Help) {
+  Write-Host "multimodel-dev-os installer v$Version" -ForegroundColor Blue
+  Write-Host ""
+  Write-Host "Usage: irm .../install.ps1 | iex"
+  Write-Host ""
+  Write-Host "Options:"
+  Write-Host "  -Caveman   Use minimal-token templates (~79% fewer tokens)"
+  Write-Host "  -All       Install all adapters"
+  Write-Host "  -DryRun    Show what would be created without creating"
+  Write-Host "  -Help      Show this help message"
+  return
+}
+
+Write-Host "multimodel-dev-os installer v$Version" -ForegroundColor Blue
+Write-Host ""
+
+# --- Helper Functions ---
+
+function New-ProjectFile {
+  param(
+    [string]$Path,
+    [string]$Url
+  )
+
+  if (Test-Path $Path) {
+    Write-Host "  SKIP $Path (already exists)" -ForegroundColor Yellow
+    return
+  }
+
+  if ($DryRun) {
+    Write-Host "  WOULD CREATE $Path" -ForegroundColor Blue
+    return
+  }
+
+  $dir = Split-Path -Parent $Path
+  if ($dir -and !(Test-Path $dir)) {
+    New-Item -ItemType Directory -Path $dir -Force | Out-Null
+  }
+
+  try {
+    Invoke-WebRequest -Uri $Url -OutFile $Path -UseBasicParsing -ErrorAction Stop
+    Write-Host "  CREATE $Path" -ForegroundColor Green
+  }
+  catch {
+    Write-Host "  FAIL $Path (download failed)" -ForegroundColor Red
+  }
+}
+
+function New-ProjectDir {
+  param([string]$Path)
+
+  if (Test-Path $Path) {
+    Write-Host "  SKIP $Path/ (already exists)" -ForegroundColor Yellow
+    return
+  }
+
+  if ($DryRun) {
+    Write-Host "  WOULD CREATE $Path/" -ForegroundColor Blue
+    return
+  }
+
+  New-Item -ItemType Directory -Path $Path -Force | Out-Null
+  Write-Host "  CREATE $Path/" -ForegroundColor Green
+}
+
+# --- Phase 1: Core Files ---
+
+Write-Host "Creating core files..." -ForegroundColor Blue
+
+if ($Caveman) {
+  New-ProjectFile "AGENTS.md" "$RepoUrl/.ai/templates/AGENTS.caveman.md"
+  New-ProjectFile "MEMORY.md" "$RepoUrl/.ai/templates/MEMORY.caveman.md"
+  New-ProjectFile "TASKS.md" "$RepoUrl/.ai/templates/TASKS.caveman.md"
+  New-ProjectFile "RUNBOOK.md" "$RepoUrl/.ai/templates/RUNBOOK.caveman.md"
+}
+else {
+  New-ProjectFile "AGENTS.md" "$RepoUrl/AGENTS.md"
+  New-ProjectFile "MEMORY.md" "$RepoUrl/MEMORY.md"
+  New-ProjectFile "TASKS.md" "$RepoUrl/TASKS.md"
+  New-ProjectFile "RUNBOOK.md" "$RepoUrl/RUNBOOK.md"
+}
+New-ProjectFile ".gitattributes" "$RepoUrl/.gitattributes"
+New-ProjectFile "bin/multimodel-dev-os.js" "$RepoUrl/bin/multimodel-dev-os.js"
+
+# --- Phase 2: .ai/ Directory ---
+
+Write-Host ""
+Write-Host "Creating .ai/ directory..." -ForegroundColor Blue
+
+New-ProjectFile ".ai/config.yaml" "$RepoUrl/.ai/config.yaml"
+New-ProjectDir ".ai/context"
+New-ProjectFile ".ai/context/README.md" "$RepoUrl/.ai/context/README.md"
+New-ProjectDir ".ai/agents"
+New-ProjectFile ".ai/agents/README.md" "$RepoUrl/.ai/agents/README.md"
+New-ProjectFile ".ai/agents/multimodel-orchestrator.md" "$RepoUrl/.ai/agents/multimodel-orchestrator.md"
+New-ProjectDir ".ai/skills"
+New-ProjectFile ".ai/skills/README.md" "$RepoUrl/.ai/skills/README.md"
+New-ProjectFile ".ai/skills/example-skill.md" "$RepoUrl/.ai/skills/example-skill.md"
+New-ProjectDir ".ai/prompts"
+New-ProjectFile ".ai/prompts/README.md" "$RepoUrl/.ai/prompts/README.md"
+New-ProjectDir ".ai/checks"
+New-ProjectFile ".ai/checks/README.md" "$RepoUrl/.ai/checks/README.md"
+New-ProjectFile ".ai/checks/pre-commit.md" "$RepoUrl/.ai/checks/pre-commit.md"
+New-ProjectDir ".ai/session-logs"
+New-ProjectFile ".ai/session-logs/README.md" "$RepoUrl/.ai/session-logs/README.md"
+New-ProjectDir ".ai/templates"
+New-ProjectFile ".ai/templates/AGENTS.caveman.md" "$RepoUrl/.ai/templates/AGENTS.caveman.md"
+New-ProjectFile ".ai/templates/MEMORY.caveman.md" "$RepoUrl/.ai/templates/MEMORY.caveman.md"
+New-ProjectFile ".ai/templates/TASKS.caveman.md" "$RepoUrl/.ai/templates/TASKS.caveman.md"
+New-ProjectFile ".ai/templates/RUNBOOK.caveman.md" "$RepoUrl/.ai/templates/RUNBOOK.caveman.md"
+
+# --- Phase 3: Adapters ---
+
+Write-Host ""
+
+function Install-Adapter {
+  param([string]$Name)
+
+  Write-Host "Installing $Name adapter..." -ForegroundColor Blue
+
+  switch ($Name) {
+    "codex" {
+      New-ProjectFile "adapters/codex/AGENTS.md" "$RepoUrl/adapters/codex/AGENTS.md"
+      New-ProjectFile "adapters/codex/setup.md" "$RepoUrl/adapters/codex/setup.md"
+    }
+    "antigravity" {
+      New-ProjectFile "adapters/antigravity/AGENTS.md" "$RepoUrl/adapters/antigravity/AGENTS.md"
+      New-ProjectFile "adapters/antigravity/.gemini/settings.json" "$RepoUrl/adapters/antigravity/.gemini/settings.json"
+      New-ProjectFile "adapters/antigravity/setup.md" "$RepoUrl/adapters/antigravity/setup.md"
+    }
+    "cursor" {
+      New-ProjectFile "adapters/cursor/.cursorrules" "$RepoUrl/adapters/cursor/.cursorrules"
+      New-ProjectFile "adapters/cursor/setup.md" "$RepoUrl/adapters/cursor/setup.md"
+    }
+    "claude" {
+      New-ProjectFile "adapters/claude/CLAUDE.md" "$RepoUrl/adapters/claude/CLAUDE.md"
+      New-ProjectFile "adapters/claude/setup.md" "$RepoUrl/adapters/claude/setup.md"
+    }
+    "gemini" {
+      New-ProjectFile "adapters/gemini/GEMINI.md" "$RepoUrl/adapters/gemini/GEMINI.md"
+      New-ProjectFile "adapters/gemini/setup.md" "$RepoUrl/adapters/gemini/setup.md"
+    }
+    "vscode" {
+      New-ProjectFile "adapters/vscode/.vscode/settings.json" "$RepoUrl/adapters/vscode/.vscode/settings.json"
+      New-ProjectFile "adapters/vscode/setup.md" "$RepoUrl/adapters/vscode/setup.md"
+    }
+  }
+}
+
+if ($All) {
+  foreach ($adapter in @("codex", "antigravity", "cursor", "claude", "gemini", "vscode")) {
+    Install-Adapter $adapter
+  }
+}
+else {
+  Write-Host "Which adapters do you want to install?" -ForegroundColor Yellow
+  Write-Host "  1) all"
+  Write-Host "  2) codex"
+  Write-Host "  3) antigravity"
+  Write-Host "  4) cursor"
+  Write-Host "  5) claude"
+  Write-Host "  6) gemini"
+  Write-Host "  7) vscode"
+  Write-Host "  8) none"
+  Write-Host ""
+  $choices = Read-Host "Enter choices (comma-separated, e.g., 2,4,5)"
+
+  if ([string]::IsNullOrWhiteSpace($choices) -or $choices -eq "8") {
+    Write-Host "Skipping adapters." -ForegroundColor Yellow
+  }
+  elseif ($choices -eq "1") {
+    foreach ($adapter in @("codex", "antigravity", "cursor", "claude", "gemini", "vscode")) {
+      Install-Adapter $adapter
+    }
+  }
+  else {
+    $selected = $choices -split "," | ForEach-Object { $_.Trim() }
+    foreach ($choice in $selected) {
+      switch ($choice) {
+        "2" { Install-Adapter "codex" }
+        "3" { Install-Adapter "antigravity" }
+        "4" { Install-Adapter "cursor" }
+        "5" { Install-Adapter "claude" }
+        "6" { Install-Adapter "gemini" }
+        "7" { Install-Adapter "vscode" }
+        default { Write-Host "Unknown choice: $choice" -ForegroundColor Red }
+      }
+    }
+  }
+}
+
+# --- Summary ---
+
+Write-Host ""
+Write-Host "multimodel-dev-os installed!" -ForegroundColor Green
+Write-Host ""
+Write-Host "Next steps:"
+Write-Host "  1. Edit AGENTS.md with your project details"
+Write-Host "  2. Edit .ai/config.yaml to enable your adapters"
+Write-Host "  3. Copy adapter files to your project root as needed:"
+Write-Host "     - Cursor: Copy-Item adapters/cursor/.cursorrules .cursorrules"
+Write-Host "     - Claude: Copy-Item adapters/claude/CLAUDE.md CLAUDE.md"
+Write-Host "     - VS Code: Copy-Item -Recurse adapters/vscode/.vscode/ .vscode/"
+Write-Host ""
+Write-Host "  Docs: https://github.com/rizvee/multimodel-dev-os"
+Write-Host ""
+
+if ($Caveman) {
+  Write-Host "  Caveman Mode active - minimal-token templates installed" -ForegroundColor Yellow
+}
+
+if ($DryRun) {
+  Write-Host "  Dry run - no files were created" -ForegroundColor Blue
+}

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.1"
+VERSION="2.0.1"
 REPO_URL="https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main"
 CAVEMAN=false
 DRY_RUN=false

package/scripts/prepublish-guard.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+/**
+ * MultiModel Dev OS - Prepublish Guard
+ * Blocks accidental npm publications.
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const projectRoot = join(__dirname, '..');
+
+// 1. Check environment variable override
+if (process.env.MMDO_ALLOW_PUBLISH !== 'true') {
+  console.error('\n\x1b[31m[ABORT] Publishing requires explicit release approval. Set MMDO_ALLOW_PUBLISH=true only during an approved npm publish.\x1b[0m');
+  console.error('To override this guard during the approved release, set the environment variable:');
+  console.log('  \x1b[33mMMDO_ALLOW_PUBLISH=true\x1b[0m\n');
+  process.exit(1);
+}
+
+// 2. Enforce package version begins with '2.'
+try {
+  const packageJsonPath = join(projectRoot, 'package.json');
+  if (existsSync(packageJsonPath)) {
+    const pkgData = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    const version = pkgData.version || '';
+    if (!version.startsWith('2.')) {
+      console.error(`\n\x1b[31m[ABORT] Blocked publishing version ${version}.\x1b[0m`);
+      console.error('Only major v2 version package releases (version starting with "2.") are permitted.');
+      console.log('Update the version in package.json to v2.0.0 or higher.\n');
+      process.exit(1);
+    }
+  }
+} catch (e) {
+  console.error(`\n\x1b[31m[ERROR] Failed to read package.json version: ${e.message}\x1b[0m\n`);
+  process.exit(1);
+}
+
+console.log('\x1b[32m✔ Prepublish guard passed. Proceeding with approved publication...\x1b[0m');
+process.exit(0);