rapidkit 0.36.0 → 0.37.1

package/README.md

@@ -1,24 +1,120 @@
-# RapidKit NPM CLI
+# RapidKit
 
-> Workspace-first open-source platform that gives teams, tools, and AI agents a shared understanding of software systems.
+### Open-Source Workspace Intelligence for Software Systems
 
-RapidKit turns scattered projects into a governed workspace that CI, Workspai, and AI agents can understand.
+> AI agents understand files.
+> RapidKit helps developers, CI, IDEs, and AI agents share the same understanding of the workspace.
+
+**One workspace. One truth. Humans and AI aligned.**
+
+RapidKit is the open-source workspace intelligence engine that turns scattered projects into a governed, agent-ready software system.
+
+Build, adopt, and operate polyglot software systems with a shared, evidence-backed understanding for developers, CI pipelines, IDEs, and AI agents.
+
+Instead of every tool rebuilding its own view of your system from files alone, RapidKit provides a shared source of truth: a workspace model, agent context, impact analysis, verification evidence, and release gates that all surfaces can consume.
+
+## Quick start in 5 minutes
+
+### Install the CLI
+
+```bash
+npm install -g rapidkit
+```
+
+### Create a new workspace and project
+
+```bash
+npx rapidkit create workspace platform --yes --profile polyglot
+
+cd platform
+
+npx rapidkit bootstrap --profile polyglot
+
+npx rapidkit create project
+npx rapidkit create frontend nextjs my-web --yes
+
+npx rapidkit workspace model
+npx rapidkit workspace context --for-agent --write
+npx rapidkit pipeline --strict
+```
+
+### Adopt an existing project
+
+```bash
+npx rapidkit adopt /path/to/project --workspace /path/to/workspace
+
+npx rapidkit workspace model
+npx rapidkit workspace context --for-agent --write
+npx rapidkit pipeline --strict
+```
+
+### What RapidKit gives you
+
+* Adopt existing projects without migration
+* Create and manage polyglot workspaces
+* Generate canonical workspace models and agent-ready context
+* Analyze impact before changes ship
+* Verify release readiness with evidence-backed gates
+* Keep developers, CI, IDEs, and AI agents aligned on the same workspace truth
+
+### Workspace Intelligence
+
+Most AI tools understand:
+
+* Files
+* Functions
+* Repositories
+
+Production systems require understanding:
+
+* Ownership
+* Architecture
+* Dependencies
+* Operational context
+* Verification requirements
+* Change impact
+
+RapidKit adds the missing layer:
+
+**Workspace Intelligence.**
+
+**One workspace. One truth. Humans and AI aligned.**
+
+A shared, evidence-backed understanding of software systems for developers, CI pipelines, IDEs, and AI agents.
+
+In RapidKit, Workspace Intelligence is not a chat feature. It is the deterministic workspace layer behind the CLI:
+
+* **Model** — what projects, runtimes, frameworks, commands, policies, contracts, and evidence exist
+* **Context** — what AI agents and IDEs should know before giving advice
+* **Impact** — what changed and which projects, commands, and release gates are affected
+* **Verify** — which evidence proves the workspace is ready, blocked, or needs attention
+* **Sync** — how developers, CI, Workspai, and AI agents stay grounded in the same truth
+
+### From Code to Shared Understanding
+How RapidKit transforms projects and repositories into workspace intelligence for developers, CI, and AI agents.
+
+![From Code to Shared Understanding](https://raw.githubusercontent.com/rapidkitlabs/rapidkit-npm/main/docs/From%20Code%20to%20Shared%20Understanding.png)
+
+Mermaid source for GitHub docs: [from-code-to-shared-understanding.md](docs/from-code-to-shared-understanding.md).
+
+RapidKit provides the workspace intelligence engine: model, context, impact, verification, evidence, contracts, and governance.
+
+Workspai provides the VS Code experience on top of that foundation.
+
+For the visual experience, install the [Workspai VS Code extension](https://marketplace.visualstudio.com/items?itemName=rapidkit.rapidkit-vscode). 
 
 [![npm version](https://img.shields.io/npm/v/rapidkit.svg?style=flat-square)](https://www.npmjs.com/package/rapidkit)
 [![Downloads](https://img.shields.io/npm/dm/rapidkit.svg?style=flat-square)](https://www.npmjs.com/package/rapidkit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
-[![GitHub Stars](https://img.shields.io/github/stars/rapidkitlabs/rapidkit-npm.svg?style=flat-square)](https://github.com/rapidkitlabs/rapidkit-npm/stargazers)
 [![Built by RapidKit](https://img.shields.io/badge/Built%20by-RapidKit-0f172a?logo=github)](https://www.getrapidkit.com)
 
-For the visual experience, install the [Workspai VS Code extension](https://marketplace.visualstudio.com/items?itemName=rapidkit.rapidkit-vscode). The extension calls this CLI for discovery, commands, evidence, and AI context — install `rapidkit@latest` globally or link locally for scaffold/adopt flows.
-
 ## Table of contents
 
-- [Start here](#start-here)
+- [Typical workflows](#typical-workflows)
 - [Mental model](#mental-model)
-- [Workspace intelligence](#workspace-intelligence)
+- [Workspace Intelligence Commands](#workspace-intelligence-commands)
 - [Requirements & install](#requirements)
-- [Quickstarts](#quickstarts)
+- [Project workflows](#project-workflows)
 - [CI & evidence](#ci--evidence)
 - [Workspai ecosystem](#workspai-ecosystem)
 - [VS Code extension](#vs-code-extension)
@@ -27,15 +123,39 @@ For the visual experience, install the [Workspai VS Code extension](https://mark
 - [Troubleshooting](#troubleshooting)
 - [License](#license)
 
-## Start here
+## Typical workflows
+
+| Question                                      | Command                                        |
+| --------------------------------------------- | ---------------------------------------------- |
+| What projects exist in this workspace?        | `workspace model --json`                       |
+| What context should AI agents receive?        | `workspace context --for-agent --json --write` |
+| What breaks if I change this?                 | `workspace impact --from <snapshot>`           |
+| Can I safely release?                         | `pipeline --json --strict`                     |
+| How do I align AI tools and CI?               | `workspace agent-sync --write`                 |
+| How do I onboard an existing project?         | `adopt`                                        |
+| How do I bring repositories into a workspace? | `import`                                       |
+
+
+### Existing project
+
+```bash
+npx rapidkit adopt /path/to/project --workspace /path/to/workspace
+npx rapidkit workspace model --json
+```
+
+### Agent-ready workspace
+
+```bash
+npx rapidkit workspace context --for-agent --json --write
+npx rapidkit workspace agent-sync --write --refresh-context
+```
+
+### Release verification
+
+```bash
+npx rapidkit pipeline --json --strict
+```
 
-| If you have... | Use | What you get |
-| --- | --- | --- |
-| An existing project to keep in place | [`adopt`](docs/workspace-operations.md#import-and-adoption) | Links project, detects stack, writes metadata |
-| A folder or repo to copy into a workspace | [`import`](docs/workspace-operations.md#import-and-adoption) | Copy/clone with rollback-safe sync |
-| A new project from a kit | `create workspace` + `create project` / `create frontend` | Scaffold + governance evidence |
-| CI or release gates | `pipeline --json --strict` | Full governance loop in one command |
-| Agent-ready context | `workspace model` + `workspace context` | Canonical facts and context packs |
 
 ### Adopt in place
 
@@ -55,6 +175,9 @@ npx rapidkit adopt --json   # from inside the project folder
 
 New workspaces go under `~/rapidkit/workspaces/<name>`. Legacy `~/Workspai/rapidkits/*` paths remain registered. Use `--output <parent-dir>` for a custom parent.
 
+
+## Mental model
+
 ### Two-layer model
 
 ```text
@@ -62,8 +185,6 @@ First-class engine kits  →  FastAPI and NestJS (modules + deep generation)
 Workspace intelligence   →  frontend apps, Go, Spring, .NET, adopted/imported repos
 ```
 
-## Mental model
-
 RapidKit treats the **workspace** as the operating boundary: policy, registry, evidence, contracts, and release readiness. Projects can live inside the workspace or be **adopted** from outside.
 
 ```text
@@ -79,12 +200,14 @@ external-project/
 
 Every tool gets the same answers: what projects exist, what stack they use, which commands are safe, what evidence exists, and what context agents should receive.
 
-## Workspace intelligence
+## Workspace Intelligence Commands
+Workspace Intelligence provides a shared understanding of projects, dependencies, operational context, and release readiness for developers, CI pipelines, and AI agents.
 
 | Command | Purpose |
 | --- | --- |
 | `workspace model --json` | Canonical workspace model |
-| `workspace context --for-agent --json` | Agent-ready context pack |
+| `workspace context --for-agent --json --write` | Agent-ready context pack + auto agent grounding sync |
+| `workspace agent-sync --write` | Cross-tool grounding (AGENTS.md, Copilot, Cursor, Claude, INDEX) |
 | `workspace snapshot --json` | Persist model snapshot |
 | `workspace diff --from <file\|git[:ref]> --json` | Diff against snapshot or git |
 | `workspace impact --from <file> --json` | Blast-radius evidence |
@@ -92,6 +215,43 @@ Every tool gets the same answers: what projects exist, what stack they use, whic
 
 JSON schemas: `contracts/workspace-intelligence/`. Details: [commands-reference.md](docs/commands-reference.md).
 
+### Agent grounding (CLI-only, no extension required)
+
+RapidKit can sync **cross-tool instruction files** so Copilot, Cursor, Claude Code, Codex, Grok, and other agents read the same evidence before guessing:
+
+```bash
+# Full sync: refresh context pack + INDEX + AGENTS.md + Copilot/Cursor/Claude hooks
+npx rapidkit workspace agent-sync --write --refresh-context
+
+# Context pack write also syncs grounding by default
+npx rapidkit workspace context --for-agent --json --write
+
+# CI strict gate (fail if required reports missing/stale)
+npx rapidkit workspace agent-sync --write --strict --json
+```
+
+| Artifact / file | Purpose |
+| --- | --- |
+| `.rapidkit/reports/INDEX.json` | Read order, blockers, report timestamps |
+| `.rapidkit/reports/workspace-context-agent.json` | Canonical agent context pack |
+| `.rapidkit/AGENT-GROUNDING.md` | Tool-agnostic grounding doc |
+| `AGENTS.md` | Open standard for all agents (managed RapidKit section) |
+| `.github/copilot-instructions.md` | GitHub Copilot / VS Code Chat always-on rules |
+| `.github/instructions/rapidkit-evidence.instructions.md` | Copilot scoped rules for `.rapidkit/**` |
+| `.github/prompts/rapidkit-diagnose.prompt.md` | Copilot reusable diagnose prompt |
+| `.github/skills/rapidkit-grounding/SKILL.md` | Copilot agent skill workflow |
+| `.cursor/rules/rapidkit-grounding.mdc` | Cursor always-on project rule |
+| `CLAUDE.md` | Claude Code entry (`@AGENTS.md` + managed notes) |
+| `.claude/rules/rapidkit-evidence.md` | Claude Code scoped evidence rules |
+
+Agents cannot be **forced** probabilistically — but this stack maximizes the chance they read reports first, even when the user talks to Copilot directly without Workspai.
+
+Skip auto-sync after context write: `--no-agent-sync`. Target specific ecosystems: `--target copilot,cursor,claude`.
+
+After `pipeline`, grounding syncs automatically (refresh context + INDEX + hooks). Disable with `--no-agent-sync` or `RAPIDKIT_NO_AGENT_SYNC=1`.
+
+CI template: [docs/examples/ci-agent-grounding.yml](docs/examples/ci-agent-grounding.yml).
+
 ## Requirements
 
 - Node.js `>= 20.19.6`
@@ -106,7 +266,7 @@ npm install -g rapidkit
 npx rapidkit --help
 ```
 
-## Quickstarts
+## Project workflows
 
 ### I already have a project
 
@@ -155,6 +315,7 @@ Common workspace commands:
 
 ```bash
 npx rapidkit doctor workspace
+npx rapidkit workspace agent-sync --write --refresh-context
 npx rapidkit setup <python|node|go|java|dotnet> [--warm-deps]
 npx rapidkit workspace list
 npx rapidkit cache <status|clear|prune|repair>
@@ -165,6 +326,12 @@ Full syntax: [docs/commands-reference.md](docs/commands-reference.md). CI workfl
 
 ## Workspai ecosystem
 
+RapidKit and Workspai form a single workspace intelligence platform.
+
+RapidKit provides the workspace intelligence engine: model, context, impact, verification, evidence, contracts, and governance.
+
+Workspai — Workspace + Intelligence — provides the VS Code surface: dashboard, sidebar, Incident Studio, AI workflows, and developer-facing workspace operations.
+
 | Component | Repository | Role |
 | --- | --- | --- |
 | CLI | [rapidkit-npm](https://github.com/rapidkitlabs/rapidkit-npm) | Commands, governance, adoption, CI evidence |
@@ -173,13 +340,16 @@ Full syntax: [docs/commands-reference.md](docs/commands-reference.md). CI workfl
 | Examples | [rapidkit-examples](https://github.com/rapidkitlabs/rapidkit-examples) | Starter workspaces |
 
 ## VS Code extension
+Workspai is the VS Code experience for RapidKit workspace intelligence.
 
-Search **Workspai** in the marketplace or `ext install rapidkit.rapidkit-vscode`.
+Search **Workspai** in the marketplace or install via:
+`ext install rapidkit.rapidkit-vscode`.
 
 | Feature | CLI | Extension |
 | --- | --- | --- |
 | Create / adopt / import | Yes | Guided wizards |
 | Workspace model / context | Yes | Dashboard + AI scope |
+| Cross-tool agent grounding | Yes (`workspace agent-sync`) | Send-to-Copilot / Ask Studio UX |
 | Enterprise evidence loop | Partial | Full dashboard |
 | Module catalog (FastAPI/NestJS) | Limited | Browser UI |
 
@@ -198,7 +368,6 @@ The extension invokes this npm CLI. For the latest `adopt` and `create frontend`
 | [docs/SETUP.md](docs/SETUP.md) | Maintainer setup |
 | [docs/SECURITY.md](docs/SECURITY.md) | Security policy |
 | [docs/config-file-guide.md](docs/config-file-guide.md) | User configuration |
-| [docs/README.md](docs/README.md) | Full documentation index |
 | [CHANGELOG.md](CHANGELOG.md) | Version history |
 
 ## Development
@@ -222,6 +391,8 @@ Contributors: [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md), [docs/ci-workflows.md]
 | `npm audit fix --force` downgrades tsup | `package.json` | Do not use `--force`; keep `tsup@^8.5.1` |
 | Security audit fails on esbuild | `npm audit --audit-level=moderate` | Keep `esbuild` override in `package.json` |
 | Doctor output stale | Report timestamps | Re-run `doctor workspace` or `doctor project` |
+| Copilot ignores workspace evidence | Missing grounding files | `workspace agent-sync --write --refresh-context` |
+| Agent grounding strict CI failed | Stale/missing reports | Run governance chain then re-sync |
 | Affected run scope wrong | Git ref | Use `--since <ref>` explicitly |
 
 ## License

package/contracts/analyze-last-run.v1.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/analyze-last-run.v1.json",
+  "title": "RapidKit Analyze Last Run Evidence",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "workspacePath",
+    "workspaceDetected",
+    "summary",
+    "projects",
+    "findings",
+    "enterpriseControls"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "rapidkit-analyze-v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "workspacePath": { "type": "string", "minLength": 1 },
+    "workspaceDetected": { "type": "boolean" },
+    "profile": { "type": ["string", "null"] },
+    "summary": {
+      "type": "object",
+      "required": ["score", "verdict", "projectCount", "runtimeCount", "findings"],
+      "properties": {
+        "score": { "type": "number" },
+        "verdict": {
+          "enum": ["ready", "needs-attention", "blocked"]
+        },
+        "projectCount": { "type": "integer", "minimum": 0 },
+        "runtimeCount": { "type": "integer", "minimum": 0 },
+        "findings": {
+          "type": "object",
+          "required": ["fail", "warn", "info"],
+          "properties": {
+            "fail": { "type": "integer", "minimum": 0 },
+            "warn": { "type": "integer", "minimum": 0 },
+            "info": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": true
+    },
+    "runtimes": {
+      "type": "object",
+      "additionalProperties": { "type": "integer", "minimum": 0 }
+    },
+    "projects": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "dependencyGraph": {
+      "type": "object",
+      "properties": {
+        "status": { "enum": ["generated", "empty"] },
+        "edges": {
+          "type": "array",
+          "items": { "type": "object", "additionalProperties": true }
+        },
+        "topImpactedProjects": {
+          "type": "array",
+          "items": { "type": "object", "additionalProperties": true }
+        }
+      },
+      "additionalProperties": true
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "severity", "title", "detail", "target", "remediation"],
+        "properties": {
+          "id": { "type": "string" },
+          "severity": { "enum": ["info", "warn", "fail"] },
+          "title": { "type": "string" },
+          "detail": { "type": "string" },
+          "target": { "type": "string" },
+          "remediation": { "type": "string" }
+        },
+        "additionalProperties": true
+      }
+    },
+    "nextActions": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "enterpriseControls": {
+      "type": "object",
+      "required": ["jsonReady", "ciGateCommand", "releaseGateCommand", "evidencePath"],
+      "properties": {
+        "jsonReady": { "type": "boolean" },
+        "ciGateCommand": { "type": "string" },
+        "releaseGateCommand": { "type": "string" },
+        "evidencePath": { "type": "string" }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/contracts/cli-log-event.v1.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/cli-log-event.v1.json",
+  "title": "RapidKit CLI Log Event",
+  "description": "NDJSON stream events emitted on stderr when RAPIDKIT_LOG_FORMAT=json or --log-format json",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "runId",
+    "timestamp",
+    "level",
+    "event",
+    "component",
+    "message"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "cli-log-event-v1"
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 8
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "level": {
+      "enum": ["debug", "info", "warn", "error"]
+    },
+    "event": {
+      "enum": ["log", "progress", "run.started", "run.completed", "run.failed"]
+    },
+    "component": {
+      "type": "string",
+      "minLength": 1
+    },
+    "message": {
+      "type": "string"
+    },
+    "command": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}

package/contracts/doctor-project-evidence.v1.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/doctor-project-evidence.v1.json",
+  "title": "RapidKit Doctor Project Evidence",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "evidenceType",
+    "generatedAt",
+    "projectPath",
+    "projectName",
+    "summary"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "doctor-project-evidence-v1"
+    },
+    "evidenceType": {
+      "const": "project"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "workspacePath": { "type": ["string", "null"] },
+    "projectPath": { "type": "string", "minLength": 1 },
+    "projectName": { "type": "string", "minLength": 1 },
+    "healthScore": { "type": "object", "additionalProperties": true },
+    "system": { "type": "object", "additionalProperties": true },
+    "project": { "type": "object", "additionalProperties": true },
+    "summary": {
+      "type": "object",
+      "properties": {
+        "scopeProvenance": { "type": "object", "additionalProperties": true }
+      },
+      "additionalProperties": true
+    },
+    "driftDelta": { "type": "object", "additionalProperties": true },
+    "scoreBreakdown": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "contract": { "type": "object", "additionalProperties": true }
+  },
+  "additionalProperties": true
+}

package/contracts/doctor-workspace-evidence.v1.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/doctor-workspace-evidence.v1.json",
+  "title": "RapidKit Doctor Workspace Evidence",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "evidenceType",
+    "generatedAt",
+    "workspacePath",
+    "summary",
+    "projects"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "doctor-workspace-evidence-v1"
+    },
+    "evidenceType": {
+      "const": "workspace"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "workspacePath": { "type": "string", "minLength": 1 },
+    "workspaceName": { "type": "string" },
+    "projectScanCached": { "type": "boolean" },
+    "projectScanSignature": { "type": "string" },
+    "cachePath": { "type": ["string", "null"] },
+    "healthScore": { "type": "object", "additionalProperties": true },
+    "system": { "type": "object", "additionalProperties": true },
+    "projects": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "summary": {
+      "type": "object",
+      "required": ["totalProjects", "totalIssues", "hasSystemErrors"],
+      "properties": {
+        "totalProjects": { "type": "integer", "minimum": 0 },
+        "totalIssues": { "type": "integer", "minimum": 0 },
+        "projectAdvisoryWarningProjects": { "type": "integer", "minimum": 0 },
+        "projectAdvisoryWarnings": { "type": "integer", "minimum": 0 },
+        "hasSystemErrors": { "type": "boolean" },
+        "scopeProvenance": { "type": "object", "additionalProperties": true }
+      },
+      "additionalProperties": true
+    },
+    "driftDelta": { "type": "object", "additionalProperties": true },
+    "scoreBreakdown": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "contract": { "type": "object", "additionalProperties": true }
+  },
+  "additionalProperties": true
+}

package/contracts/release-readiness.v1.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/release-readiness.v1.json",
+  "title": "RapidKit Release Readiness Evidence",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "workspacePath",
+    "projectPath",
+    "overallStatus",
+    "blocking",
+    "blockingReasons",
+    "gates"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "enum": ["release-readiness-v1", "v1"]
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "workspacePath": { "type": "string", "minLength": 1 },
+    "projectPath": { "type": "string", "minLength": 1 },
+    "action": {
+      "enum": ["dev", "test", "build", "start", "lint", "format"]
+    },
+    "overallStatus": {
+      "enum": ["pass", "warn", "fail"]
+    },
+    "blocking": { "type": "boolean" },
+    "blockingReasons": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "gates": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["gate", "status", "summary", "details"],
+        "properties": {
+          "gate": {
+            "enum": ["env", "doctor", "analyze", "verify", "dependency"]
+          },
+          "status": { "enum": ["pass", "warn", "fail"] },
+          "summary": { "type": "string" },
+          "details": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "evidencePath": { "type": "string" }
+        },
+        "additionalProperties": true
+      }
+    },
+    "evidencePath": { "type": "string" }
+  },
+  "additionalProperties": true
+}