multimodel-dev-os 2.0.0 → 2.6.0

package/.ai/intelligence/README.md

@@ -0,0 +1,14 @@
+# Repository Intelligence Layer
+
+This directory contains the schemas, structures, and indices that govern the repository intelligence and feedback systems for MultiModel Dev OS.
+
+## Directory Structure
+
+*   `memory.schema.json` — The JSON schema defining the token-efficient representation of codebase state (hashes, summaries, and dependencies).
+*   `feedback.schema.json` — The JSON schema mapping developer feedback logs and instruction overrides.
+
+## Indices & Learning Files (Workspace Specific)
+
+When configured, developer agents will generate:
+*   `memory.json` — The compiled state index mapping files to fingerprints and semantic summaries.
+*   `learnings.yaml` — The database of rule modifications learned from developer feedback.

package/.ai/intelligence/apply-log.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Proposal Apply Log Record Schema",
+  "description": "Schema for capturing individual proposal application audit log records.",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique execution run identifier (e.g. apply-YYYYMMDD-HHMMSS)."
+    },
+    "proposal_id": {
+      "type": "string",
+      "description": "The unique proposal identifier."
+    },
+    "applied_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Timestamp when the operations were applied."
+    },
+    "target": {
+      "type": "string",
+      "description": "Absolute or relative path to the target workspace root."
+    },
+    "operations_count": {
+      "type": "integer",
+      "description": "Total number of operations executed."
+    },
+    "files_changed": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Files modified or created during this execution."
+    },
+    "before_hashes": {
+      "type": "object",
+      "additionalProperties": { "type": ["string", "null"] },
+      "description": "SHA-256 hashes of affected files before modifications."
+    },
+    "after_hashes": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "SHA-256 hashes of affected files after modifications."
+    },
+    "status": {
+      "type": "string",
+      "enum": ["success", "failed"],
+      "description": "Execution status of the applied proposal."
+    },
+    "notes": {
+      "type": "string",
+      "description": "Summary notes or error details."
+    }
+  },
+  "required": [
+    "id",
+    "proposal_id",
+    "applied_at",
+    "target",
+    "operations_count",
+    "files_changed",
+    "before_hashes",
+    "after_hashes",
+    "status",
+    "notes"
+  ]
+}

package/.ai/intelligence/feedback-log.example.jsonl

@@ -0,0 +1,2 @@
+{"id":"f10e42b2-6523-4c91-9e73-d8c36034e3fb","created_at":"2026-06-10T17:20:00Z","source":"user","type":"preference","text":"Prefer vanilla CSS or CSS Modules over Tailwind CSS in legacy components.","tags":["styling","legacy"],"related_files":["src/components/legacy/Button.js"],"hash":"b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c"}
+{"id":"a23c56d1-8192-4d02-a19c-c9e83014e3fc","created_at":"2026-06-10T18:05:00Z","source":"user","type":"bug","text":"Ensure all utility scripts have executable permissions on POSIX systems.","tags":["scripts","permissions"],"related_files":["scripts/verify.sh"],"hash":"3d94d35ef6cf89f9212ad12a76a59dccff1352f23cd32812f4850b878ae4944d"}

package/.ai/intelligence/feedback.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MultiModel Dev OS Feedback and Learnings Schema",
+  "description": "Schema for capturing developer corrections and instructions overrides to refine subsequent agent proposal generations.",
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Schema representation version (e.g. 1.0.0)."
+    },
+    "learnings": {
+      "type": "array",
+      "description": "List of compiled learning records.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique UUID or tag for the learning item."
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "context": {
+            "type": "string",
+            "description": "Topic or architectural tier (e.g. styling, db-migrations, testing)."
+          },
+          "pattern": {
+            "type": "string",
+            "description": "File path pattern or glob rules matching this learning directive."
+          },
+          "rule": {
+            "type": "string",
+            "description": "The exact instructional rule to append to the agent context."
+          },
+          "rejection_reason": {
+            "type": "string",
+            "description": "Developer comment or description of the rejected behavior."
+          }
+        },
+        "required": ["id", "timestamp", "context", "rule"]
+      }
+    }
+  },
+  "required": ["version", "learnings"]
+}

package/.ai/intelligence/improvement-proposal.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Improvement Proposal Schema",
+  "description": "Validation schema for YAML frontmatter inside codebase improvement proposals.",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^proposal-\\d{8}-\\d{6}$",
+      "description": "Unique proposal identifier with format YYYYMMDD-HHMMSS."
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Timestamp when the proposal was generated."
+    },
+    "title": {
+      "type": "string",
+      "description": "Short description of the proposed improvement."
+    },
+    "problem": {
+      "type": "string",
+      "description": "Detailed description of the issue or policy violation found."
+    },
+    "evidence": {
+      "type": "string",
+      "description": "Specific code lines, directory structure, or logs that prove the issue exists."
+    },
+    "risk_level": {
+      "type": "string",
+      "enum": ["low", "medium", "high"],
+      "description": "Classification of proposal impact risk."
+    },
+    "affected_files": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Explicit paths of files targeted for modifications."
+    },
+    "suggested_change": {
+      "type": "string",
+      "description": "Summary or code snippet of the proposed modifications."
+    },
+    "verify_command": {
+      "type": "string",
+      "description": "Command to run to verify changes (e.g. npm run verify)."
+    },
+    "rollback_plan": {
+      "type": "string",
+      "description": "Command to run to revert changes if verification fails."
+    },
+    "approval_status": {
+      "type": "string",
+      "enum": ["pending", "approved", "rejected"],
+      "description": "Human-in-the-loop approval gate status."
+    }
+  },
+  "required": [
+    "id",
+    "created_at",
+    "title",
+    "problem",
+    "evidence",
+    "risk_level",
+    "affected_files",
+    "suggested_change",
+    "verify_command",
+    "rollback_plan",
+    "approval_status"
+  ]
+}

package/.ai/intelligence/learning-rules.example.md

@@ -0,0 +1,18 @@
+# Compiled Learning Rules (Example)
+
+*Generated automatically by MultiModel Dev OS. Do not modify manually.*
+
+Last compiled: 2026-06-10T18:10:00Z
+Total source feedback items: 2
+
+## Active Instructions
+
+### Category: styling
+*   **Pattern:** `src/components/legacy/**/*`
+    *   **Rule:** Prefer vanilla CSS or CSS Modules over Tailwind CSS in legacy components.
+    *   **Source IDs:** [`f10e42b2-6523-4c91-9e73-d8c36034e3fb`]
+
+### Category: scripts
+*   **Pattern:** `scripts/**/*`
+    *   **Rule:** Ensure all utility scripts have executable permissions on POSIX systems.
+    *   **Source IDs:** [`a23c56d1-8192-4d02-a19c-c9e83014e3fc`]

package/.ai/intelligence/memory.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MultiModel Dev OS Repository Memory Schema",
+  "description": "Schema for token-efficient repository state representation, including fingerprints, dependencies, summaries, and architectural decisions.",
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Schema representation version (e.g. 1.0.0)."
+    },
+    "fingerprints": {
+      "type": "object",
+      "description": "File path content fingerprints.",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "hash": {
+            "type": "string",
+            "description": "Cryptographic or content-hash fingerprint (e.g. sha256)."
+          },
+          "size": {
+            "type": "integer",
+            "description": "File size in bytes."
+          },
+          "last_modified": {
+            "type": "string",
+            "format": "date-time",
+            "description": "ISO timestamp of the last modification."
+          }
+        },
+        "required": ["hash", "size", "last_modified"]
+      }
+    },
+    "summaries": {
+      "type": "object",
+      "description": "Semantic high-density summaries of directories and files.",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "dependency_map": {
+      "type": "object",
+      "description": "Imports, exports, and linkage mapping among codebase elements.",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      }
+    },
+    "decisions": {
+      "type": "array",
+      "description": "Historical log of resolved architectural refactor decisions.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "date": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "issue": {
+            "type": "string"
+          },
+          "resolution": {
+            "type": "string"
+          },
+          "context": {
+            "type": "string"
+          }
+        },
+        "required": ["date", "issue", "resolution"]
+      }
+    },
+    "risks": {
+      "type": "array",
+      "description": "Code patterns flagged as sensitive requiring higher security compliance constraints.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "file_pattern": {
+            "type": "string",
+            "description": "Glob pattern of the target files."
+          },
+          "risk_description": {
+            "type": "string"
+          },
+          "severity": {
+            "type": "string",
+            "enum": ["low", "medium", "high"]
+          }
+        },
+        "required": ["file_pattern", "risk_description", "severity"]
+      }
+    }
+  },
+  "required": ["version", "fingerprints", "summaries", "dependency_map", "decisions", "risks"]
+}

package/.ai/policies/approval-gates.md

@@ -0,0 +1,35 @@
+# MultiModel Dev OS Approval Gates Policy
+
+This document defines the Human-in-the-Loop (HITL) gates, risk levels, and validation protocols required before any changes proposed by MultiModel Dev OS can be applied.
+
+---
+
+## 1. HITL Gate Framework
+
+Automated developer agents must classify code modifications into one of three risk categories, each requiring a specific approval gate:
+
+| Risk Category | Example Changes | Required Approval Gate |
+|:---|:---|:---|
+| **Low Risk** | Documentation updates, CSS style tweaks, comment insertions, minor typos. | **Gate 1**: Automated `verify` + passive developer sign-off. |
+| **Medium Risk** | Refactoring internal functions, adding utility files, updating package dependencies, writing unit tests. | **Gate 2**: Pre-apply diff review + automated verification + manual commit approval. |
+| **High Risk** | Database schema changes, security middleware, network config, payment webhooks. | **Gate 3**: Pre-implementation spec review + interactive dry-run + strict maintainer code audit. |
+
+---
+
+## 2. Gate Protocols
+
+### Gate 1 (Low Risk)
+*   The agent drafts modifications and executes the validator.
+*   The developer is notified of the changes via terminal logs. No blocking input is required unless errors occur.
+
+### Gate 2 (Medium Risk)
+*   The agent must compile a diff and present it to the developer.
+*   The developer must explicitly approve the proposal (e.g. typing `y` or confirming via IDE dialog).
+*   The agent applies modifications and runs automated tests.
+*   Developer reviews the post-test state before git staging.
+
+### Gate 3 (High Risk)
+*   Before writing any code, the agent must generate a technical design spec.
+*   The spec must be reviewed and signed off by the maintainer.
+*   The agent executes the changes under dry-run settings first.
+*   Once dry-run confirms zero side-effects, the changes are applied in a separate branch, tests are executed, and a manual pull request audit is completed.

package/.ai/policies/memory-policy.md

@@ -0,0 +1,30 @@
+# MultiModel Dev OS Memory & Privacy Policy
+
+This policy governs the security, storage, token budget constraints, and privacy parameters for local repository memory indices and feedback loops compiled by MultiModel Dev OS.
+
+---
+
+## 1. Token Efficiency Constraints
+
+To avoid saturating the context window of developer agents, the generated memory indices (`memory.json`) and feedback files (`learnings.yaml`) must be kept compact:
+*   **Summary Bounds**: Component/file summaries must not exceed **200 tokens** per file entry.
+*   **Pruning Rules**: Stale summaries of deleted files or historic decision logs exceeding 90 days must be automatically pruned during the `mmdo memory refresh` cycles.
+*   **Token Budget**: The total memory footprint loaded into an active workspace context must remain below **5%** of the target model's active context window.
+
+---
+
+## 2. Privacy & Secret Security
+
+Local memory indexing must **never** store sensitive credentials, secrets, or PII:
+1.  **Strict File Exclusions**:
+    *   Configurations storing credentials (e.g. `.env`, `.npmrc`, `key.pem`, `.git-credentials`, service accounts JSON) must be strictly ignored.
+    *   No content signatures or lines from excluded files may be hashed or compiled.
+2.  **No Code Scraping**: Code block contents may be semantically summarized but the raw code blocks (especially database connection strings, passwords, and API keys) must never be copied into `memory.json`.
+3.  **Local Isolation**: Memory files are restricted to the local workspace and must never be uploaded to external APIs or third-party servers.
+
+---
+
+## 3. Index Refresh & Git Bounds
+
+*   **Diff-Driven Updates**: Re-indexing must use content hash comparison. A file is only re-analyzed if its content hash differs from the stored fingerprint.
+*   **Gitignore Alignment**: Any directory or file path marked as ignored inside the workspace `.gitignore` is automatically excluded from the memory scanning loop.

package/.ai/policies/self-improvement-policy.md

@@ -0,0 +1,39 @@
+# MultiModel Dev OS Self-Improvement Policy
+
+This document defines the policies, guidelines, and guardrails for automated self-improvement cycles inside workspaces governed by MultiModel Dev OS.
+
+---
+
+## 1. Safety Guardrails & Write-Protection
+
+To prevent runaway self-modifying loops, the following directories and files are officially **write-protected** from automated model refactors:
+*   `bin/` — The core CLI executable binaries.
+*   `scripts/` — Automated verification, setup, and prepublish-guard scripts.
+*   `.ai/policies/` — Approval schemas and policy definitions (including this document).
+*   `.github/` — Workflows and issue templates.
+
+Any self-improvement proposal targeting these directories or files must be immediately aborted by the execution client.
+
+---
+
+## 2. Proposal Framework
+
+All code improvement recommendations must be prepared as structured yaml files inside `.ai/proposals/proposal-<id>.yaml`. A proposal must contain:
+1.  **`rationale`**: Clear documentation of the technical reasoning, problem description, and expected outcome.
+2.  **`affected_files`**: An explicit array of absolute or relative file paths to be modified. No other files may be touched.
+3.  **`risk_level`**: Classification (`low`, `medium`, `high`) based on the component's sensitivity (e.g. database, credentials, public APIs).
+4.  **`verify_command`**: The CLI validation command to run after files are modified (e.g., `npm run verify` or custom testing commands).
+5.  **`rollback_plan`**: Automated step-by-step commands to revert changes if verification fails.
+
+---
+
+## 3. Execution & Validation Cycle
+
+Self-improvement cycles must execute in a isolated sandbox following this sequence:
+1.  **Draft**: Compile proposal and write to `.ai/proposals/proposal-<id>.yaml`.
+2.  **User Audit**: Display proposed diffs and require developer verification.
+3.  **Apply (Staging)**: Apply modifications to the target files.
+4.  **Test**: Execute `verify_command` (must return exit code `0`).
+5.  **Rollback / Commit**:
+    *   If tests **pass**: Commit modifications locally with prefix `chore(improve): <summary>`.
+    *   If tests **fail**: Execute `rollback_plan` (e.g. `git checkout -- <files>`) to revert modifications immediately and log the failure.

package/.ai/proposals/README.md

@@ -0,0 +1,44 @@
+# Codebase Improvement Proposals Directory
+
+This directory stores structured codebase optimization and refactoring proposals generated by MultiModel Dev OS.
+
+## Proposal Structure
+
+All proposals must be written as Markdown files named using the pattern `proposal-YYYYMMDD-HHMMSS.md` and must contain a YAML Frontmatter block conforming to `.ai/intelligence/improvement-proposal.schema.json`.
+
+### Example Format
+
+```markdown
+---
+id: proposal-20260610-173000
+created_at: 2026-06-10T17:30:00Z
+title: Refactor component export syntax
+problem: Mix of default and named exports causes import confusion.
+evidence: Found default export in src/utils/format.js and named exports in others.
+risk_level: low
+affected_files:
+  - src/utils/format.js
+suggested_change: Change default export to named export.
+verify_command: npm run verify
+rollback_plan: git checkout -- src/utils/format.js
+approval_status: pending
+---
+
+# Codebase Improvement Proposal: Refactor component export syntax
+
+## 1. Problem Description
+Description of the issue or inconsistency.
+
+## 2. Risk & Validation Plan
+* Risk: Low
+* Verification Command: `npm run verify`
+
+## 3. Rollback Instructions
+`git checkout -- src/utils/format.js`
+```
+
+## Approval Gate Lifecycle
+
+1. **propose**: The engine writes the proposal under `.ai/proposals/proposal-YYYYMMDD-HHMMSS.md` with status `pending`.
+2. **review**: Developers inspect proposals using `npx multimodel-dev-os improve review`.
+3. **manual approval**: The developer reviews the file, executes the change manually, and marks the status as `approved` inside the Frontmatter once resolved.

package/.ai/proposals/apply-operation.example.json

@@ -0,0 +1,22 @@
+{
+  "operations": [
+    {
+      "type": "create_file",
+      "path": "docs/example.md",
+      "content": "# Example\n",
+      "overwrite": true
+    },
+    {
+      "type": "append_line",
+      "path": ".gitignore",
+      "line": "node_modules/"
+    },
+    {
+      "type": "replace_text",
+      "path": "README.md",
+      "find": "old text",
+      "replace": "new text",
+      "allow_multiple": false
+    }
+  ]
+}

package/.ai/registries/capabilities.yaml

@@ -0,0 +1,73 @@
+# MultiModel Dev OS - Capabilities Registry
+# Configures cognitive vectors and performance parameters for AI models
+
+capabilities:
+  claude-sonnet-latest:
+    provider: anthropic
+    alias: claude-3-5-sonnet
+    scores:
+      coding: 0.95
+      reasoning: 0.90
+      repo-scan: 0.85
+      agentic-duration: 0.80
+      mcp-compliance: 1.0
+      local-offline: 0.0
+    cost_per_m_input: 3.00
+    cost_per_m_output: 15.00
+    latency: medium
+
+  gemini-pro-latest:
+    provider: google
+    alias: gemini-1.5-pro
+    scores:
+      coding: 0.90
+      reasoning: 0.95
+      repo-scan: 1.00
+      agentic-duration: 0.85
+      mcp-compliance: 0.90
+      local-offline: 0.0
+    cost_per_m_input: 1.25
+    cost_per_m_output: 5.00
+    latency: medium
+
+  gemini-flash-latest:
+    provider: google
+    alias: gemini-1.5-flash
+    scores:
+      coding: 0.75
+      reasoning: 0.70
+      repo-scan: 0.95
+      agentic-duration: 0.60
+      mcp-compliance: 0.80
+      local-offline: 0.0
+    cost_per_m_input: 0.075
+    cost_per_m_output: 0.30
+    latency: fast
+
+  gpt-coding-latest:
+    provider: openai
+    alias: gpt-4o
+    scores:
+      coding: 0.92
+      reasoning: 0.85
+      repo-scan: 0.70
+      agentic-duration: 0.70
+      mcp-compliance: 0.90
+      local-offline: 0.0
+    cost_per_m_input: 2.50
+    cost_per_m_output: 10.00
+    latency: fast
+
+  deepseek-coder-latest:
+    provider: deepseek
+    alias: deepseek-coder
+    scores:
+      coding: 0.94
+      reasoning: 0.88
+      repo-scan: 0.75
+      agentic-duration: 0.75
+      mcp-compliance: 0.80
+      local-offline: 0.50
+    cost_per_m_input: 0.14
+    cost_per_m_output: 0.28
+    latency: medium

package/.ai/registries/tools.yaml

@@ -0,0 +1,84 @@
+# MultiModel Dev OS - Tools Registry
+# Configures active interfaces, connection protocols, and files mapping for developer tools
+
+tools:
+  cursor:
+    name: "Cursor Editor"
+    interface: editor
+    protocols:
+      - custom-rules
+    registry_keys:
+      - .cursorrules
+    format: markdown
+
+  claude-code:
+    name: "Claude Code CLI"
+    interface: terminal
+    protocols:
+      - stdin-stdout
+    registry_keys:
+      - CLAUDE.md
+    format: markdown
+
+  gemini:
+    name: "Gemini / Antigravity Assistant"
+    interface: assistant
+    protocols:
+      - system-instructions
+    registry_keys:
+      - GEMINI.md
+    format: markdown
+
+  vscode:
+    name: "VS Code Editor"
+    interface: editor
+    protocols:
+      - workspaces-settings
+    registry_keys:
+      - .vscode/settings.json
+    format: json
+
+  antigravity:
+    name: "Antigravity IDE Plugin"
+    interface: assistant
+    protocols:
+      - settings-profiles
+    registry_keys:
+      - .gemini/settings.json
+    format: json
+
+  continue:
+    name: "Continue IDE Extension"
+    interface: editor
+    protocols:
+      - config-schema
+    registry_keys:
+      - .continue/config.json
+    format: json
+
+  cline:
+    name: "Cline / Roo Code Assistant"
+    interface: editor
+    protocols:
+      - workspace-rules
+    registry_keys:
+      - .clinerules
+    format: markdown
+
+  aider:
+    name: "Aider Command Line"
+    interface: terminal
+    protocols:
+      - config-yaml
+    registry_keys:
+      - .aider.conf.yml
+    format: yaml
+
+  windsurf:
+    name: "Windsurf Editor"
+    interface: editor
+    protocols:
+      - windsurf-rules
+    registry_keys:
+      - .windsurfrules
+    format: markdown