@geraldmaron/construct 1.4.1 → 1.5.0

package/registry/capabilities.json

@@ -0,0 +1,1987 @@
+{
+  "version": 1,
+  "catalog": {
+    "generatedAt": "2026-07-06T22:40:56.862Z",
+    "npmScripts": [
+      "adapters",
+      "audit:published",
+      "build:binary",
+      "build:binary:fallback",
+      "build:sea",
+      "catalog:regen",
+      "catalog:validate",
+      "certify:demos",
+      "clean:artifacts",
+      "coverage",
+      "deps:check",
+      "docs:build",
+      "docs:dev",
+      "docs:init",
+      "docs:site",
+      "docs:sync",
+      "docs:update",
+      "docs:verify",
+      "doctor",
+      "eval:routing",
+      "evals",
+      "examples:deck",
+      "examples:distribution",
+      "gates:audit",
+      "graph:gate",
+      "learning:status",
+      "lint:agents",
+      "lint:comments",
+      "lint:contracts",
+      "lint:js",
+      "lint:scopes",
+      "lint:templates",
+      "mcp",
+      "npm:publish",
+      "postinstall",
+      "release:check",
+      "release:gate",
+      "release:preflight",
+      "release:preflight:no-auth",
+      "test",
+      "test:functional",
+      "test:unit",
+      "test:visual",
+      "version",
+      "workflow-defs:check"
+    ],
+    "cliCommands": [
+      {
+        "name": "acp",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "activation:status",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "approvals",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "artifact",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "ask",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "audit",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "auth:status",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "backup",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "beads",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "beads:stats",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "bootstrap",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "capability",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "certify",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "ci",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "claude:allow",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "cleanup",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "completions",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "config",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "creds",
+        "category": "Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "customer",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "db",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "decisions",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "demo",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "deployment",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "dev",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "diagram",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "diff",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "distill",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "doc",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "docs",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "docs:check",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "docs:reconcile",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "docs:site",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "docs:update",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "docs:verify",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "doctor",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "drop",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "efficiency",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "embed",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "eval-datasets",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "evals",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "evaluator:rubrics",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "execution",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "export",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "feedback:history",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "feedback:record",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "flow",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "gates:audit",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "graph",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "handoffs",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "headhunt",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "hook",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "hooks:health",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "hosts",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "impact",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "improvement",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "infer",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "ingest",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "init",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "init:update",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "install",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "intake",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "integrations",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "knowledge",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "lint:agents",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "lint:comments",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "lint:contracts",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "lint:prompts",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "lint:research",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "lint:templates",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "list",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "llm-judge",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "matrix",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "mcp",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "memory",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "migrate",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "models",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "ollama",
+        "category": "Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "optimize",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "oracle",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "orchestrate",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "overrides",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "pack",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "plugin",
+        "category": "Models & Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "policy",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "provider",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "providers",
+        "category": "Integrations",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "prune",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "publish",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "recommendations",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "reflect",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "registry:diff",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "registry:generate-docs",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "registry:prune",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "registry:status",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "registry:validate",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "resources",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "review",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "role",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "roles:list",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "roles:set",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "rules",
+        "category": "Diagnostics",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "sandbox",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "scheduler",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "scope",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "search",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "seed-traces",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "skills",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "sources",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "specialist",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "specialist:add",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "specialist:remove",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "status",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "stop",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "storage",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "sync",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "tags",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "team",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "team:add",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "team:remove",
+        "category": "Internal",
+        "core": false,
+        "internal": true
+      },
+      {
+        "name": "telemetry",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "telemetry-backfill",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "telemetry-setup",
+        "category": "Observability",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "tools",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "uninstall",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "update",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "upgrade",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "validate",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "version",
+        "category": "Advanced",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "wireframe",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "workers",
+        "category": "Core",
+        "core": true,
+        "internal": false
+      },
+      {
+        "name": "workflow",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      },
+      {
+        "name": "workspace",
+        "category": "Work",
+        "core": false,
+        "internal": false
+      }
+    ],
+    "workflows": [
+      {
+        "type": "architecture-review",
+        "description": "Review an architecture or design for trade-offs, failure modes, and security exposure.",
+        "tier": "reasoning"
+      },
+      {
+        "type": "data-structure",
+        "description": "Parse, validate, and profile a raw dataset into a structured, described shape.",
+        "tier": "standard"
+      },
+      {
+        "type": "evidence-ingest",
+        "description": "Ingest and structure raw evidence (notes, documents, signals) into a normalized summary.",
+        "tier": "fast"
+      },
+      {
+        "type": "memo-draft",
+        "description": "Draft a decision or status memo from a problem statement and context.",
+        "tier": "fast"
+      },
+      {
+        "type": "prd-draft",
+        "description": "Draft a product requirements document from a problem statement and supporting evidence.",
+        "tier": "standard"
+      },
+      {
+        "type": "proposal-review",
+        "description": "Review a proposal for correctness, risk, and hidden assumptions before acceptance.",
+        "tier": "standard"
+      },
+      {
+        "type": "research-synthesis",
+        "description": "Synthesize multiple sources into a cited, evidence-graded research summary.",
+        "tier": "reasoning"
+      },
+      {
+        "type": "risk-review",
+        "description": "Stress-test a plan for risk: failure modes, security, and compliance exposure.",
+        "tier": "reasoning"
+      },
+      {
+        "type": "structure-notes",
+        "description": "Structure an unclassified brain-dump or rough notes into a normalized summary with extracted intents.",
+        "tier": "fast"
+      },
+      {
+        "type": "transcript-process",
+        "description": "Process a meeting/call transcript into a summary, decisions, and action items.",
+        "tier": "fast"
+      },
+      {
+        "type": "triage",
+        "description": "Classify and route unstructured input to the appropriate workflow.",
+        "tier": "fast"
+      }
+    ],
+    "workflowTypes": [
+      "architecture-review",
+      "data-structure",
+      "evidence-ingest",
+      "memo-draft",
+      "prd-draft",
+      "proposal-review",
+      "research-synthesis",
+      "risk-review",
+      "structure-notes",
+      "transcript-process",
+      "triage"
+    ]
+  },
+  "capabilities": [
+    {
+      "id": "orchestration.routing",
+      "kind": "capability",
+      "name": "Orchestration Intent Routing",
+      "description": "Classifies user intent and dispatches to the correct specialist chain.",
+      "criticality": "P0",
+      "ownerSpecialists": [
+        "orchestrator"
+      ],
+      "skill": "ai/orchestration-workflow",
+      "contracts": [
+        "user-to-construct",
+        "construct-to-orchestrator"
+      ],
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "orchestration_policy"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct orchestrate run",
+          "jsonTwin": true
+        },
+        "opencode": {
+          "supported": true
+        },
+        "claude": {
+          "supported": true
+        },
+        "cursor": {
+          "supported": true
+        }
+      },
+      "dependencies": {
+        "skills": [
+          "ai/orchestration-workflow",
+          "operating/orchestration-reference"
+        ],
+        "rules": [
+          "rules/common/no-fabrication.md"
+        ]
+      },
+      "verification": {
+        "functional": "tests/functional/orchestration-mcp.functional.test.mjs",
+        "hostEmulation": "tests/functional/host-mcp-emulation.functional.test.mjs"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:14.659Z",
+      "edges": {
+        "cliCommands": [
+          "orchestrate",
+          "orchestrate run"
+        ],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Classifies user intent and dispatches to the correct specialist chain.\",\"criticality\":\"P0\",\"verification\":{\"functional\":\"tests/functional/orchestration-mcp.functional.test.mjs\",\"hostEmulation\":\"tests/functional/host-mcp-emulation.functional.test.mjs\"}}"
+    },
+    {
+      "id": "oracle.meta-review",
+      "kind": "capability",
+      "name": "Oracle Meta-Review",
+      "description": "Deterministic read-model synthesis and bounded-auto maintenance for fleet health gaps.",
+      "criticality": "P1",
+      "ownerSpecialists": [
+        "oracle"
+      ],
+      "skill": "ai/orchestration-workflow",
+      "surfaces": {
+        "cli": {
+          "supported": true,
+          "command": "construct oracle review",
+          "jsonTwin": true
+        },
+        "mcp": {
+          "supported": false
+        }
+      },
+      "dependencies": {
+        "skills": [
+          "ai/orchestration-workflow",
+          "exploration/dependency-graph-reading",
+          "roles/trace-reviewer"
+        ],
+        "rules": [
+          "rules/common/no-fabrication.md"
+        ]
+      },
+      "verification": {
+        "functional": "tests/functional/oracle-bounded-auto.functional.test.mjs"
+      },
+      "humanGate": "approve-only",
+      "lastValidated": "2026-06-26T20:01:22.031Z",
+      "edges": {
+        "cliCommands": [
+          "oracle",
+          "oracle review"
+        ],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Deterministic read-model synthesis and bounded-auto maintenance for fleet health gaps.\",\"criticality\":\"P1\",\"verification\":{\"functional\":\"tests/functional/oracle-bounded-auto.functional.test.mjs\"}}"
+    },
+    {
+      "id": "mcp.broker.connection",
+      "kind": "capability",
+      "name": "MCP Broker Connectivity",
+      "description": "Reliable MCP tool discovery and dispatch across hosts.",
+      "criticality": "P0",
+      "ownerSpecialists": [
+        "orchestrator"
+      ],
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true
+        },
+        "opencode": {
+          "supported": true
+        },
+        "cursor": {
+          "supported": true
+        },
+        "vscode": {
+          "supported": true
+        },
+        "claude": {
+          "supported": true
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/mcp-parity.functional.test.mjs",
+        "hostEmulation": "tests/functional/host-mcp-emulation.functional.test.mjs"
+      },
+      "humanGate": "autonomous",
+      "lastValidated": "2026-06-26T20:01:32.913Z",
+      "edges": {
+        "cliCommands": [],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Reliable MCP tool discovery and dispatch across hosts.\",\"criticality\":\"P0\",\"verification\":{\"functional\":\"tests/functional/mcp-parity.functional.test.mjs\",\"hostEmulation\":\"tests/functional/host-mcp-emulation.functional.test.mjs\"}}"
+    },
+    {
+      "id": "workflow.evidence-ingest",
+      "kind": "workflow",
+      "name": "Evidence Ingest Workflow",
+      "description": "Ingest and structure raw evidence into a normalized summary.",
+      "criticality": "P1",
+      "ownerSpecialists": [
+        "researcher",
+        "data-analyst"
+      ],
+      "skill": "docs/evidence-ingest-workflow",
+      "embeddedWorkflow": "evidence-ingest",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct workflow invoke",
+          "jsonTwin": true
+        }
+      },
+      "dependencies": {
+        "skills": [
+          "docs/evidence-ingest-workflow"
+        ],
+        "templates": [
+          "evidence-brief",
+          "signal-brief"
+        ],
+        "rules": [
+          "rules/common/research.md",
+          "rules/common/no-fabrication.md"
+        ]
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs",
+        "verificationBar": "Source metadata preserved; no invented quotes; confidence labeled"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:33.468Z",
+      "edges": {
+        "cliCommands": [
+          "workflow",
+          "workflow invoke"
+        ],
+        "npmScripts": [
+          "release:check",
+          "workflow-defs:check"
+        ],
+        "workflows": [
+          "evidence-ingest"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Ingest and structure raw evidence into a normalized summary.\",\"criticality\":\"P1\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\",\"verificationBar\":\"Source metadata preserved; no invented quotes; confidence labeled\"}}"
+    },
+    {
+      "id": "workflow.research-synthesis",
+      "kind": "workflow",
+      "name": "Research Synthesis Workflow",
+      "description": "Synthesize multiple sources into a cited, evidence-graded research summary.",
+      "criticality": "P1",
+      "ownerSpecialists": [
+        "researcher",
+        "data-analyst",
+        "evaluator"
+      ],
+      "skill": "docs/research-workflow",
+      "embeddedWorkflow": "research-synthesis",
+      "contracts": [
+        "researcher-to-architect"
+      ],
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct ask",
+          "jsonTwin": false
+        },
+        "claude": {
+          "supported": true,
+          "slashCommand": "understand:research"
+        }
+      },
+      "dependencies": {
+        "skills": [
+          "docs/research-workflow"
+        ],
+        "templates": [
+          "research-brief"
+        ],
+        "rules": [
+          "rules/common/research.md"
+        ]
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs",
+        "structureRequirements": "research-brief",
+        "verificationBar": "≥2 primary sources; URLs fetched; confidence labeled"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:34.007Z",
+      "edges": {
+        "cliCommands": [
+          "ask"
+        ],
+        "npmScripts": [],
+        "workflows": [
+          "research-synthesis"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Synthesize multiple sources into a cited, evidence-graded research summary.\",\"criticality\":\"P1\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\",\"structureRequirements\":\"research-brief\",\"verificationBar\":\"≥2 primary sources; URLs fetched; confidence labeled\"}}"
+    },
+    {
+      "id": "workflow.prd-draft",
+      "kind": "workflow",
+      "name": "PRD Draft Workflow",
+      "description": "Draft a product requirements document from a problem statement and evidence.",
+      "criticality": "P1",
+      "ownerSpecialists": [
+        "product-manager",
+        "architect"
+      ],
+      "skill": "docs/prd-workflow",
+      "embeddedWorkflow": "prd-draft",
+      "contracts": [
+        "product-manager-to-architect"
+      ],
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct workflow invoke",
+          "jsonTwin": true
+        }
+      },
+      "dependencies": {
+        "skills": [
+          "docs/prd-workflow"
+        ],
+        "templates": [
+          "prd",
+          "meta-prd",
+          "rfc"
+        ],
+        "rules": [
+          "rules/common/no-fabrication.md"
+        ]
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs",
+        "structureRequirements": "prd",
+        "verificationBar": "Template chosen before draft; rejected alternatives recorded for ADR/RFC paths"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:34.544Z",
+      "edges": {
+        "cliCommands": [
+          "workflow",
+          "workflow invoke"
+        ],
+        "npmScripts": [
+          "release:check",
+          "workflow-defs:check"
+        ],
+        "workflows": [
+          "prd-draft"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Draft a product requirements document from a problem statement and evidence.\",\"criticality\":\"P1\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\",\"structureRequirements\":\"prd\",\"verificationBar\":\"Template chosen before draft; rejected alternatives recorded for ADR/RFC paths\"}}"
+    },
+    {
+      "id": "workflow.architecture-review",
+      "kind": "workflow",
+      "name": "Architecture Review Workflow",
+      "description": "Review an architecture for trade-offs, failure modes, and security exposure.",
+      "criticality": "P1",
+      "ownerSpecialists": [
+        "architect",
+        "security",
+        "devil-advocate"
+      ],
+      "embeddedWorkflow": "architecture-review",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct workflow invoke",
+          "jsonTwin": true
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs"
+      },
+      "humanGate": "requires-human-approval",
+      "lastValidated": "2026-06-26T20:01:35.084Z",
+      "edges": {
+        "cliCommands": [
+          "workflow",
+          "workflow invoke"
+        ],
+        "npmScripts": [
+          "release:check",
+          "workflow-defs:check"
+        ],
+        "workflows": [
+          "architecture-review"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Review an architecture for trade-offs, failure modes, and security exposure.\",\"criticality\":\"P1\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\"}}"
+    },
+    {
+      "id": "workflow.proposal-review",
+      "kind": "workflow",
+      "name": "Proposal Review Workflow",
+      "description": "Review a proposal for correctness, risk, and hidden assumptions before acceptance.",
+      "criticality": "P1",
+      "ownerSpecialists": [
+        "reviewer",
+        "devil-advocate"
+      ],
+      "embeddedWorkflow": "proposal-review",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct workflow invoke",
+          "jsonTwin": true
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs"
+      },
+      "humanGate": "requires-human-approval",
+      "lastValidated": "2026-06-26T20:01:35.624Z",
+      "edges": {
+        "cliCommands": [
+          "workflow",
+          "workflow invoke"
+        ],
+        "npmScripts": [
+          "release:check",
+          "workflow-defs:check"
+        ],
+        "workflows": [
+          "proposal-review"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Review a proposal for correctness, risk, and hidden assumptions before acceptance.\",\"criticality\":\"P1\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\"}}"
+    },
+    {
+      "id": "workflow.risk-review",
+      "kind": "workflow",
+      "name": "Risk Review Workflow",
+      "description": "Stress-test a plan for failure modes, security, and compliance exposure.",
+      "criticality": "P1",
+      "ownerSpecialists": [
+        "devil-advocate",
+        "security",
+        "legal-compliance"
+      ],
+      "embeddedWorkflow": "risk-review",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct workflow invoke",
+          "jsonTwin": true
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs"
+      },
+      "humanGate": "requires-human-approval",
+      "lastValidated": "2026-06-26T20:01:36.161Z",
+      "edges": {
+        "cliCommands": [
+          "workflow",
+          "workflow invoke"
+        ],
+        "npmScripts": [
+          "release:check",
+          "workflow-defs:check"
+        ],
+        "workflows": [
+          "risk-review"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Stress-test a plan for failure modes, security, and compliance exposure.\",\"criticality\":\"P1\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\"}}"
+    },
+    {
+      "id": "workflow.structure-notes",
+      "kind": "workflow",
+      "name": "Structure Notes Workflow",
+      "description": "Structure unclassified notes into a normalized summary with extracted intents.",
+      "criticality": "P2",
+      "ownerSpecialists": [
+        "orchestrator",
+        "researcher"
+      ],
+      "skill": "operating/unstructured-triage",
+      "embeddedWorkflow": "structure-notes",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct intake classify",
+          "jsonTwin": true
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:36.696Z",
+      "edges": {
+        "cliCommands": [
+          "intake",
+          "intake classify"
+        ],
+        "npmScripts": [],
+        "workflows": [
+          "structure-notes"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Structure unclassified notes into a normalized summary with extracted intents.\",\"criticality\":\"P2\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\"}}"
+    },
+    {
+      "id": "workflow.transcript-process",
+      "kind": "workflow",
+      "name": "Transcript Process Workflow",
+      "description": "Process a meeting or call transcript into summary, decisions, and action items.",
+      "criticality": "P2",
+      "ownerSpecialists": [
+        "researcher",
+        "data-analyst"
+      ],
+      "embeddedWorkflow": "transcript-process",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct workflow invoke",
+          "jsonTwin": true
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:37.237Z",
+      "edges": {
+        "cliCommands": [
+          "workflow",
+          "workflow invoke"
+        ],
+        "npmScripts": [
+          "release:check",
+          "workflow-defs:check"
+        ],
+        "workflows": [
+          "transcript-process"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Process a meeting or call transcript into summary, decisions, and action items.\",\"criticality\":\"P2\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\"}}"
+    },
+    {
+      "id": "workflow.data-structure",
+      "kind": "workflow",
+      "name": "Data Structure Workflow",
+      "description": "Parse, validate, and profile a raw dataset into a structured, described shape.",
+      "criticality": "P2",
+      "ownerSpecialists": [
+        "data-analyst",
+        "data-engineer"
+      ],
+      "embeddedWorkflow": "data-structure",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct workflow invoke",
+          "jsonTwin": true
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:37.775Z",
+      "edges": {
+        "cliCommands": [
+          "workflow",
+          "workflow invoke"
+        ],
+        "npmScripts": [
+          "release:check",
+          "workflow-defs:check"
+        ],
+        "workflows": [
+          "data-structure"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Parse, validate, and profile a raw dataset into a structured, described shape.\",\"criticality\":\"P2\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\"}}"
+    },
+    {
+      "id": "workflow.memo-draft",
+      "kind": "workflow",
+      "name": "Memo Draft Workflow",
+      "description": "Draft a decision or status memo from a problem statement and context.",
+      "criticality": "P2",
+      "ownerSpecialists": [
+        "docs-keeper",
+        "reviewer"
+      ],
+      "embeddedWorkflow": "memo-draft",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct workflow invoke",
+          "jsonTwin": true
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:38.314Z",
+      "edges": {
+        "cliCommands": [
+          "workflow",
+          "workflow invoke"
+        ],
+        "npmScripts": [
+          "release:check",
+          "workflow-defs:check"
+        ],
+        "workflows": [
+          "memo-draft"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Draft a decision or status memo from a problem statement and context.\",\"criticality\":\"P2\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\"}}"
+    },
+    {
+      "id": "workflow.triage",
+      "kind": "workflow",
+      "name": "Triage Workflow",
+      "description": "Classify and route unstructured input to the appropriate workflow.",
+      "criticality": "P2",
+      "ownerSpecialists": [
+        "orchestrator",
+        "researcher"
+      ],
+      "embeddedWorkflow": "triage",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "workflow_invoke"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct workflow invoke",
+          "jsonTwin": true
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/embedded-contract-triage.functional.test.mjs"
+      },
+      "humanGate": "proposal-only",
+      "edges": {
+        "cliCommands": [
+          "workflow",
+          "workflow invoke"
+        ],
+        "npmScripts": [
+          "release:check",
+          "workflow-defs:check"
+        ],
+        "workflows": [
+          "triage"
+        ]
+      },
+      "_semanticDigest": "{\"description\":\"Classify and route unstructured input to the appropriate workflow.\",\"criticality\":\"P2\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-triage.functional.test.mjs\"}}"
+    },
+    {
+      "id": "document-type.research-brief",
+      "kind": "document-type",
+      "name": "Research Brief",
+      "description": "Cited research findings with confidence summary and recommendation.",
+      "ownerSpecialists": [
+        "researcher"
+      ],
+      "skill": "docs/research-workflow",
+      "template": "research-brief",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "tool": "get_template"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct knowledge add"
+        }
+      },
+      "verification": {
+        "functional": "tests/certification/artifact-gates.test.mjs",
+        "structureRequirements": "research-brief",
+        "verificationBar": "Sources section with dates; confidence summary; recommendation"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:38.464Z",
+      "edges": {
+        "cliCommands": [
+          "knowledge",
+          "knowledge add"
+        ],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Cited research findings with confidence summary and recommendation.\",\"criticality\":\"\",\"verification\":{\"functional\":\"tests/certification/artifact-gates.test.mjs\",\"structureRequirements\":\"research-brief\",\"verificationBar\":\"Sources section with dates; confidence summary; recommendation\"}}"
+    },
+    {
+      "id": "document-type.evidence-brief",
+      "kind": "document-type",
+      "name": "Evidence Brief",
+      "description": "Product evidence synthesis before decisions.",
+      "ownerSpecialists": [
+        "product-manager",
+        "researcher"
+      ],
+      "skill": "docs/evidence-ingest-workflow",
+      "template": "evidence-brief",
+      "verification": {
+        "functional": "tests/functional/embedded-contract-workflow-invoke.functional.test.mjs",
+        "verificationBar": "Signal, evidence, counter-signal; no invented customer quotes"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:39.007Z",
+      "edges": {
+        "cliCommands": [],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Product evidence synthesis before decisions.\",\"criticality\":\"\",\"verification\":{\"functional\":\"tests/functional/embedded-contract-workflow-invoke.functional.test.mjs\",\"verificationBar\":\"Signal, evidence, counter-signal; no invented customer quotes\"}}"
+    },
+    {
+      "id": "document-type.prd",
+      "kind": "document-type",
+      "name": "Product Requirements Document",
+      "description": "Customer-facing product capabilities and requirements.",
+      "ownerSpecialists": [
+        "product-manager"
+      ],
+      "skill": "docs/prd-workflow",
+      "template": "prd",
+      "verification": {
+        "functional": "tests/certification/artifact-gates.test.mjs",
+        "structureRequirements": "prd",
+        "verificationBar": "Problem, goals, success metrics, risks and mitigations"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:39.154Z",
+      "edges": {
+        "cliCommands": [],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Customer-facing product capabilities and requirements.\",\"criticality\":\"\",\"verification\":{\"functional\":\"tests/certification/artifact-gates.test.mjs\",\"structureRequirements\":\"prd\",\"verificationBar\":\"Problem, goals, success metrics, risks and mitigations\"}}"
+    },
+    {
+      "id": "document-type.adr",
+      "kind": "document-type",
+      "name": "Architecture Decision Record",
+      "description": "Record of an architecture decision with rejected alternatives.",
+      "ownerSpecialists": [
+        "architect",
+        "rd-lead"
+      ],
+      "skill": "docs/adr-workflow",
+      "template": "adr",
+      "verification": {
+        "functional": "tests/certification/artifact-gates.test.mjs",
+        "structureRequirements": "adr",
+        "verificationBar": "Problem, decision, rejected alternatives, consequences, reversibility"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:39.305Z",
+      "edges": {
+        "cliCommands": [],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Record of an architecture decision with rejected alternatives.\",\"criticality\":\"\",\"verification\":{\"functional\":\"tests/certification/artifact-gates.test.mjs\",\"structureRequirements\":\"adr\",\"verificationBar\":\"Problem, decision, rejected alternatives, consequences, reversibility\"}}"
+    },
+    {
+      "id": "document-type.ingested-markdown",
+      "kind": "document-type",
+      "name": "Ingested Markdown",
+      "description": "Normalized markdown from external documents with extraction metadata.",
+      "ownerSpecialists": [
+        "data-engineer",
+        "researcher"
+      ],
+      "skill": "docs/document-ingest-workflow",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "ingest_document"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct ingest"
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/node-native-extraction.functional.test.mjs",
+        "verificationBar": "Source metadata preserved; droppedInfo surfaced; no invented structure"
+      },
+      "humanGate": "autonomous",
+      "lastValidated": "2026-06-26T20:01:39.495Z",
+      "edges": {
+        "cliCommands": [
+          "ingest"
+        ],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Normalized markdown from external documents with extraction metadata.\",\"criticality\":\"\",\"verification\":{\"functional\":\"tests/functional/node-native-extraction.functional.test.mjs\",\"verificationBar\":\"Source metadata preserved; droppedInfo surfaced; no invented structure\"}}"
+    },
+    {
+      "id": "ingest.adapter",
+      "kind": "ingest-strategy",
+      "name": "Adapter Ingest (default)",
+      "description": "Local extraction via unpdf/mammoth with docling/whisper for fidelity paths.",
+      "criticality": "P0",
+      "ownerSpecialists": [
+        "data-engineer"
+      ],
+      "ingestStrategy": "adapter",
+      "surfaces": {
+        "cli": {
+          "supported": true,
+          "primary": true,
+          "command": "construct ingest"
+        },
+        "mcp": {
+          "supported": true,
+          "tool": "ingest_document"
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/node-native-extraction.functional.test.mjs"
+      },
+      "humanGate": "autonomous",
+      "lastValidated": "2026-06-26T20:01:39.686Z",
+      "edges": {
+        "cliCommands": [
+          "ingest"
+        ],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Local extraction via unpdf/mammoth with docling/whisper for fidelity paths.\",\"criticality\":\"P0\",\"verification\":{\"functional\":\"tests/functional/node-native-extraction.functional.test.mjs\"}}"
+    },
+    {
+      "id": "ingest.docling",
+      "kind": "ingest-strategy",
+      "name": "Docling Sidecar Ingest",
+      "description": "Offline docling Python sidecar for layout-aware PDF/Office and OCR.",
+      "criticality": "P1",
+      "ingestStrategy": "adapter",
+      "surfaces": {
+        "cli": {
+          "supported": true,
+          "command": "construct ingest --legacy-extractor=false"
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/mcp-ingest-resilience.functional.test.mjs"
+      },
+      "humanGate": "autonomous",
+      "lastValidated": "2026-06-26T20:01:40.642Z",
+      "edges": {
+        "cliCommands": [
+          "ingest",
+          "ingest --legacy-extractor=false"
+        ],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Offline docling Python sidecar for layout-aware PDF/Office and OCR.\",\"criticality\":\"P1\",\"verification\":{\"functional\":\"tests/functional/mcp-ingest-resilience.functional.test.mjs\"}}"
+    },
+    {
+      "id": "ingest.docling-remote",
+      "kind": "ingest-strategy",
+      "name": "Docling Remote Ingest",
+      "description": "Opt-in remote conversion via DOCLING_SERVE_URL (explicit user choice).",
+      "criticality": "P2",
+      "ingestStrategy": "docling-remote",
+      "surfaces": {
+        "cli": {
+          "supported": true,
+          "command": "construct ingest"
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/docling-remote-ingest.functional.test.mjs"
+      },
+      "humanGate": "requires-human-approval",
+      "lastValidated": "2026-06-26T20:01:40.816Z",
+      "edges": {
+        "cliCommands": [
+          "ingest"
+        ],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Opt-in remote conversion via DOCLING_SERVE_URL (explicit user choice).\",\"criticality\":\"P2\",\"verification\":{\"functional\":\"tests/functional/docling-remote-ingest.functional.test.mjs\"}}"
+    },
+    {
+      "id": "skill.roles-engineer",
+      "kind": "skill",
+      "name": "Role Skill: Engineer",
+      "description": "Engineer role playbook — hot path per skill telemetry.",
+      "ownerSpecialists": [
+        "engineer"
+      ],
+      "skill": "roles/engineer",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "get_skill"
+        }
+      },
+      "verification": {
+        "hostEmulation": "tests/functional/host-mcp-emulation.functional.test.mjs"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:41.286Z",
+      "edges": {
+        "cliCommands": [],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Engineer role playbook — hot path per skill telemetry.\",\"criticality\":\"\",\"verification\":{\"hostEmulation\":\"tests/functional/host-mcp-emulation.functional.test.mjs\"}}"
+    },
+    {
+      "id": "skill.roles-architect-ai-systems",
+      "kind": "skill",
+      "name": "Role Skill: Architect AI Systems",
+      "description": "Architect AI systems flavor — hot path per skill telemetry.",
+      "ownerSpecialists": [
+        "architect"
+      ],
+      "skill": "roles/architect.ai-systems",
+      "surfaces": {
+        "mcp": {
+          "supported": true,
+          "primary": true,
+          "tool": "get_skill"
+        }
+      },
+      "verification": {
+        "hostEmulation": "tests/functional/host-mcp-emulation.functional.test.mjs"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:41.754Z",
+      "edges": {
+        "cliCommands": [],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Architect AI systems flavor — hot path per skill telemetry.\",\"criticality\":\"\",\"verification\":{\"hostEmulation\":\"tests/functional/host-mcp-emulation.functional.test.mjs\"}}"
+    },
+    {
+      "id": "local.model.tier",
+      "kind": "capability",
+      "name": "Local Model Tier Detection",
+      "description": "resolveCapabilityTier and isLocalModel include local/ OpenAI-compatible models.",
+      "criticality": "P1",
+      "ownerSpecialists": [
+        "orchestrator"
+      ],
+      "surfaces": {
+        "cli": {
+          "supported": true,
+          "command": "construct models resolve"
+        }
+      },
+      "verification": {
+        "unit": "tests/capability-tier.test.mjs",
+        "integration": "tests/model-router-local.test.mjs",
+        "untestableRationale": "Tier detection is covered by unit (capability-tier.test.mjs) and integration (model-router-local.test.mjs) tests; no functional binary spawn is needed since the logic has no cross-component side effects."
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": "2026-06-26T20:01:41.876Z",
+      "edges": {
+        "cliCommands": [
+          "models",
+          "models resolve"
+        ],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"resolveCapabilityTier and isLocalModel include local/ OpenAI-compatible models.\",\"criticality\":\"P1\",\"verification\":{\"unit\":\"tests/capability-tier.test.mjs\",\"integration\":\"tests/model-router-local.test.mjs\",\"untestableRationale\":\"Tier detection is covered by unit (capability-tier.test.mjs) and integration (model-router-local.test.mjs) tests; no functional binary spawn is needed since the logic has no cross-component side effects.\"}}"
+    },
+    {
+      "id": "surfaces.opencode-primary",
+      "kind": "capability",
+      "name": "OpenCode Primary Surface",
+      "description": "OpenCode is the first-class conversational surface; the construct CLI remains setup/admin/headless infrastructure.",
+      "criticality": "P1",
+      "ownerSpecialists": [
+        "orchestrator"
+      ],
+      "surfaces": {
+        "opencode": {
+          "supported": true,
+          "primary": true
+        },
+        "mcp": {
+          "supported": true,
+          "tool": "orchestration_policy"
+        },
+        "cli": {
+          "supported": true,
+          "command": "construct sync"
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/opencode-primary-surface.functional.test.mjs",
+        "hostEmulation": "tests/functional/host-config-parity.functional.test.mjs"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": null,
+      "edges": {
+        "cliCommands": [
+          "sync"
+        ],
+        "npmScripts": [
+          "adapters",
+          "docs:sync",
+          "release:check",
+          "version"
+        ],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"OpenCode is the first-class conversational surface; the construct CLI remains setup/admin/headless infrastructure.\",\"criticality\":\"P1\",\"verification\":{\"functional\":\"tests/functional/opencode-primary-surface.functional.test.mjs\",\"hostEmulation\":\"tests/functional/host-config-parity.functional.test.mjs\"}}"
+    },
+    {
+      "id": "mcp.tool-budget.trim",
+      "kind": "capability",
+      "name": "MCP Tool Surface Trim",
+      "description": "Heavy external MCP servers disabled when default model is local.",
+      "criticality": "P2",
+      "ownerSpecialists": [
+        "orchestrator"
+      ],
+      "surfaces": {
+        "opencode": {
+          "supported": true
+        }
+      },
+      "verification": {
+        "functional": "tests/functional/host-config-parity.functional.test.mjs"
+      },
+      "humanGate": "proposal-only",
+      "lastValidated": null,
+      "edges": {
+        "cliCommands": [],
+        "npmScripts": [],
+        "workflows": []
+      },
+      "_semanticDigest": "{\"description\":\"Heavy external MCP servers disabled when default model is local.\",\"criticality\":\"P2\",\"verification\":{\"functional\":\"tests/functional/host-config-parity.functional.test.mjs\"}}"
+    }
+  ]
+}