mindforge-cc 11.3.1 → 11.5.0

package/.mindforge/schemas/hooks.schema.json

@@ -0,0 +1,199 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MindForge Hooks Configuration",
+  "description": "Schema for MindForge settings.json hooks. Ported from ECC's Claude Code hooks schema, with the event-name enum EXTENDED to include the Gemini-mirror events (BeforeTool/AfterTool) used by .agent/settings.json, so a single schema lints BOTH .claude/settings.json and the .agent mirror.",
+  "$defs": {
+    "stringArray": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "minItems": 1
+    },
+    "commandHookItem": {
+      "type": "object",
+      "required": [
+        "type",
+        "command"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "command",
+          "description": "Run a local command"
+        },
+        "command": {
+          "oneOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "$ref": "#/$defs/stringArray"
+            }
+          ]
+        },
+        "async": {
+          "type": "boolean",
+          "description": "Run hook asynchronously in background without blocking"
+        },
+        "timeout": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Timeout in milliseconds (Claude Code / MindForge convention)"
+        }
+      },
+      "additionalProperties": true
+    },
+    "httpHookItem": {
+      "type": "object",
+      "required": [
+        "type",
+        "url"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "http"
+        },
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "headers": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "allowedEnvVars": {
+          "$ref": "#/$defs/stringArray"
+        },
+        "timeout": {
+          "type": "number",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": true
+    },
+    "promptHookItem": {
+      "type": "object",
+      "required": [
+        "type",
+        "prompt"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["prompt", "agent"]
+        },
+        "prompt": {
+          "type": "string",
+          "minLength": 1
+        },
+        "model": {
+          "type": "string",
+          "minLength": 1
+        },
+        "timeout": {
+          "type": "number",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": true
+    },
+    "hookItem": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/commandHookItem"
+        },
+        {
+          "$ref": "#/$defs/httpHookItem"
+        },
+        {
+          "$ref": "#/$defs/promptHookItem"
+        }
+      ]
+    },
+    "matcherEntry": {
+      "type": "object",
+      "required": [
+        "hooks"
+      ],
+      "properties": {
+        "matcher": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "object"
+            }
+          ]
+        },
+        "hooks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/hookItem"
+          }
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    }
+  },
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "permissions": {
+      "type": "object",
+      "properties": {
+        "deny": { "$ref": "#/$defs/stringArray" },
+        "allow": { "type": "array", "items": { "type": "string" } },
+        "ask": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": true
+    },
+    "hooks": {
+      "type": "object",
+      "propertyNames": {
+        "enum": [
+          "SessionStart",
+          "UserPromptSubmit",
+          "PreToolUse",
+          "PermissionRequest",
+          "PostToolUse",
+          "PostToolUseFailure",
+          "Notification",
+          "SubagentStart",
+          "Stop",
+          "SubagentStop",
+          "PreCompact",
+          "InstructionsLoaded",
+          "TeammateIdle",
+          "TaskCompleted",
+          "ConfigChange",
+          "WorktreeCreate",
+          "WorktreeRemove",
+          "SessionEnd",
+          "BeforeTool",
+          "AfterTool"
+        ]
+      },
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "$ref": "#/$defs/matcherEntry"
+        }
+      }
+    }
+  },
+  "required": [
+    "hooks"
+  ],
+  "additionalProperties": true
+}

package/.mindforge/schemas/install-modules.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MindForge install modules manifest",
+  "description": "Declarative module/profile/component selection vocabulary for the MindForge installer. Ported from ECC; the adapter-factory wiring that CONSUMES a resolved plan is deferred to a future, separately-reviewed PR — this schema + resolver ship INERT (the installer-core.js path is unchanged). Replaces the two-boolean --minimal/--with-utils selectivity once wired.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "modules"],
+  "properties": {
+    "version": { "type": "integer", "minimum": 1 },
+    "modules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "kind", "description", "paths", "targets", "defaultInstall"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+          "kind": { "type": "string", "minLength": 1, "description": "asset family: rules|agents|commands|hooks|skills|engine|configs|...)" },
+          "description": { "type": "string", "minLength": 1 },
+          "paths": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1 },
+            "description": "repo-relative source paths this module installs"
+          },
+          "targets": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1 },
+            "description": "runtime ids this module supports (subset of SUPPORTED_INSTALL_TARGETS)"
+          },
+          "dependencies": {
+            "type": "array",
+            "items": { "type": "string" },
+            "default": []
+          },
+          "defaultInstall": { "type": "boolean" },
+          "cost": { "type": "string", "enum": ["light", "medium", "heavy"] },
+          "stability": { "type": "string", "enum": ["stable", "beta", "experimental"] }
+        }
+      }
+    }
+  }
+}

package/.mindforge/schemas/install-state.schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MindForge install state",
+  "description": "Provenance record written after a MindForge install/update. Sibling to .agent/file-manifest.json (which stores content hashes); this records WHO installed, from WHICH source commit, for WHICH runtimes/scope, WHEN, and the operation log — enabling precise diff, uninstall, and supply-chain audit.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "installedAt",
+    "target",
+    "request",
+    "source",
+    "operations"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "const": "mindforge.install.v1"
+    },
+    "installedAt": {
+      "type": "string",
+      "minLength": 1
+    },
+    "lastValidatedAt": {
+      "type": "string",
+      "minLength": 1
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["scope", "root"],
+      "properties": {
+        "scope": {
+          "type": "string",
+          "enum": ["global", "local"]
+        },
+        "root": {
+          "type": "string",
+          "minLength": 1
+        },
+        "installStatePath": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "request": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runtimes"],
+      "properties": {
+        "runtimes": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "description": "Runtimes installed for, e.g. claude, antigravity, cursor, opencode, gemini, copilot"
+        },
+        "withUtils": { "type": "boolean" },
+        "minimal": { "type": "boolean" }
+      }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repoVersion", "repoCommit"],
+      "properties": {
+        "repoVersion": { "type": ["string", "null"] },
+        "repoCommit": { "type": ["string", "null"] }
+      }
+    },
+    "operations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["kind", "destinationPath", "ownership"],
+        "properties": {
+          "kind": {
+            "type": "string",
+            "minLength": 1,
+            "description": "copy | merge-json | scaffold | symlink | transform"
+          },
+          "sourceRelativePath": { "type": "string", "minLength": 1 },
+          "destinationPath": { "type": "string", "minLength": 1 },
+          "runtime": { "type": "string", "minLength": 1 },
+          "ownership": {
+            "type": "string",
+            "minLength": 1,
+            "description": "mindforge | user | shared — governs what uninstall may remove"
+          },
+          "sha256": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/.mindforge/schemas/plugin.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MindForge Plugin Configuration",
+  "description": "Schema for MindForge / Claude plugin manifests (.claude-plugin/plugin.json). Ported from ECC unchanged — the Claude plugin manifest format is shared.",
+  "type": "object",
+  "required": ["name"],
+  "properties": {
+    "name": { "type": "string" },
+    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?$" },
+    "description": { "type": "string" },
+    "author": {
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": {
+            "name": { "type": "string" },
+            "url": { "type": "string", "format": "uri" }
+          },
+          "required": ["name"]
+        }
+      ]
+    },
+    "homepage": { "type": "string", "format": "uri" },
+    "repository": { "type": "string" },
+    "license": { "type": "string" },
+    "keywords": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "skills": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "commands": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "agents": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "mcpServers": {
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        {
+          "type": "object"
+        }
+      ]
+    },
+    "features": {
+      "type": "object",
+      "properties": {
+        "agents": { "type": "integer", "minimum": 0 },
+        "commands": { "type": "integer", "minimum": 0 },
+        "skills": { "type": "integer", "minimum": 0 },
+        "configAssets": { "type": "boolean" },
+        "hookEvents": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "customTools": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": true
+}

package/.mindforge/schemas/provenance.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MindForge Skill/Agent Provenance",
+  "description": "Provenance metadata for learned, imported, or published skills and subagents. Used to harden the supply chain — validated by bin/skill-validator.js and the publish-skill/install-skill CLI before an asset is trusted.",
+  "type": "object",
+  "properties": {
+    "source": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Origin (URL, path, or identifier)"
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp"
+    },
+    "confidence": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "description": "Confidence score 0-1"
+    },
+    "author": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Who or what produced the asset"
+    }
+  },
+  "required": ["source", "created_at", "confidence", "author"],
+  "additionalProperties": true
+}