rapidkit 0.41.1 → 0.41.3

package/README.md

@@ -1,12 +1,16 @@
 # RapidKit
 
-### Open-Source Workspace Intelligence for Software Systems
+## Open-Source Workspace Intelligence for Software Systems
 
 [![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)
 [![Built by RapidKit](https://img.shields.io/badge/Built%20by-RapidKit-0f172a?logo=github)](https://www.getrapidkit.com)
 
+Not another AI coding assistant.
+Not another agent framework.
+Not another context engine.
+
 > One workspace. One truth. Humans and AI aligned.
 
 RapidKit turns scattered projects into a governed, agent-ready workspace.
@@ -119,6 +123,7 @@ In RapidKit, Workspace Intelligence is not a chat feature. It is the determinist
 - **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
+- **Freshness** — which facts are durable, derived, evidence-backed, live, or must be verified before use
 
 ## From Code to Shared Understanding
 
@@ -142,6 +147,7 @@ For the visual experience, install the [Workspai VS Code extension](https://mark
 - [From Code to Shared Understanding](#from-code-to-shared-understanding)
 - [Typical workflows](#typical-workflows)
 - [Mental model](#mental-model)
+- [Why this architecture helps](#why-this-architecture-helps)
 - [Workspace Intelligence Commands](#workspace-intelligence-commands)
 - [Agent Customization Pack](#agent-customization-pack)
 - [Requirements](#requirements)
@@ -157,18 +163,18 @@ For the visual experience, install the [Workspai VS Code extension](https://mark
 
 ## 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>`           |
-| Why is release blocked?                       | `workspace explain release-blocked --json --write` |
+| 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>`                                                         |
+| Why is release blocked?                       | `workspace explain release-blocked --json --write`                                           |
 | Trace a diff through blast radius and gates?  | `workspace trace --from .rapidkit/reports/workspace-model-diff-last-run.json --json --write` |
-| Can I safely release?                         | `pipeline --json --strict`                     |
-| How do I align AI tools and CI?               | `workspace agent-sync --write`                 |
-| Expose workspace evidence to MCP clients?     | `workspace mcp serve`                          |
-| How do I onboard an existing project?         | `adopt`                                        |
-| How do I bring repositories into a workspace? | `import`                                       |
+| Can I safely release?                         | `pipeline --json --strict`                                                                   |
+| How do I align AI tools and CI?               | `workspace agent-sync --write`                                                               |
+| Expose workspace evidence to MCP clients?     | `workspace mcp serve`                                                                        |
+| How do I onboard an existing project?         | `adopt`                                                                                      |
+| How do I bring repositories into a workspace? | `import`                                                                                     |
 
 ### Existing project
 
@@ -211,49 +217,114 @@ New workspaces go under `~/rapidkit/workspaces/<name>`. Legacy `~/Workspai/rapid
 
 ## Mental model
 
-### Two-layer model
+### Two capabilities, one workspace intelligence layer
 
 ```text
-First-class engine kits  →  FastAPI and NestJS (modules + deep generation)
-Workspace intelligence   →  frontend apps, Go, Spring, .NET, adopted/imported repos
+Workspace Intelligence  →  every project in the workspace
+Native generation       →  first-class scaffolds and stack-specific project creation
+Deep module generation  →  selected backend engine kits such as FastAPI and NestJS
 ```
 
-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.
+Workspace Intelligence is not limited to a framework lane. It works across
+RapidKit-created projects, frontend apps, Go, Spring Boot, .NET, FastAPI, NestJS,
+and adopted/imported repositories. The difference is generation depth:
+some stacks have first-class scaffolds, some use official ecosystem generators,
+and existing projects can be adopted in place.
+
+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
 workspace/
+  .rapidkit-workspace
   .rapidkit/workspace.json
   .rapidkit/reports/
+    workspace-model.json
+    workspace-context-agent.json
+    INDEX.json
+    agent-customization-pack.json
+    workspace-skills-index.json
+    rapidkit-mcp-design.json
+  .rapidkit/skills/
+  .rapidkit/AGENT-GROUNDING.md
   services/api/
+    .rapidkit/project.json
+  AGENTS.md
+  .github/copilot-instructions.md
+  .github/instructions/
+  .github/prompts/
+  .github/skills/
+  .github/agents/
+  .cursor/rules/rapidkit-grounding.mdc
+  CLAUDE.md
+  .vscode/rapidkit-agent-hooks.json
 
 external-project/
   .rapidkit/project.json
   .rapidkit/adopt.json
 ```
 
-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.
+`.rapidkit/workspace.json` is the workspace manifest, not the project list.
+Projects are discovered from workspace project metadata, imported/adopted
+records, and workspace intelligence reports.
+
+Agent-facing outputs are generated from the same evidence layer:
+`workspace context --for-agent --write` writes the agent context report, and
+`workspace agent-sync --write --refresh-context --preset enterprise` writes the
+portable `AGENTS.md`, report index, skills, Copilot/Cursor/Claude surfaces, and
+agent handoff files. The exact generated output inventory is recorded in
+`.rapidkit/reports/agent-customization-pack.json` and summarized in the
+[Agent Customization Pack](#agent-customization-pack) section below.
+
+Every tool gets the same answers for every registered project: what projects
+exist, what stack they use, which commands are safe, what evidence exists, what
+changed, what release gates apply, and what context agents should receive.
+
+## Why this architecture helps
+
+You do not have to change frameworks to benefit from RapidKit.
+
+Use the frontend or backend stack that already fits your product: Next.js,
+Vite, FastAPI, NestJS, Go, Spring Boot, .NET, or an existing repository you
+adopt in place. RapidKit adds the workspace layer around it: project registry,
+safe commands, evidence, impact analysis, agent context, verification, and
+release gates.
+
+That means you can move faster without turning the product into a fragile
+prototype:
+
+- Start new products with governed scaffolds when RapidKit owns the create path
+- Adopt existing products without moving source code or rewriting the stack
+- Give humans, CI, IDEs, and AI agents the same workspace truth
+- Know what changed, what is affected, and what must be verified before release
+- Keep framework stability while adding professional product-development
+  workflows around the codebase
+
+The result is faster product development with clearer boundaries, safer AI
+assistance, and release decisions backed by evidence instead of guesswork.
 
 ## 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 [--cache\|--incremental] --json` | Canonical workspace model (graph-aware, incremental rebuilds)                        |
-| `workspace context --for-agent --json --write`    | Agent-ready context pack + auto agent grounding sync                                 |
-| `workspace agent-sync --write`                    | Agent Customization Pack (AGENTS.md, Copilot, Cursor, Claude, INDEX, skills, agents) |
-| `workspace snapshot --json`                       | Persist model snapshot                                                               |
-| `workspace diff --from <file\|git[:ref]> --json`  | Diff against snapshot or git                                                         |
-| `workspace impact --from <file> --json`           | Graph-aware transitive blast-radius evidence                                         |
-| `workspace verify [--strict] --json`              | Definitive verification gate (subgraph + freshness + policy + fleet evidence)        |
-| `workspace explain <target> [--write] --json`     | Human narrative for release blockers, projects, or trace slices                      |
-| `workspace why <target>`                          | Alias of `workspace explain`                                                         |
-| `workspace trace --from <diff> [--write] --json`  | Diff → impact → gates narrative for agents and IDE handoff                           |
-| `workspace feedback record --json`                | Append structured agent action outcomes to intelligence history                      |
-| `workspace mcp serve`                             | Read-mostly stdio MCP bridge over workspace evidence                                 |
-| `workspace graph <emit\|explain\|dot\|mermaid>`   | Inspect and visualize the dependency graph                                           |
-| `workspace watch [--json] [--once]`               | Daemon mode: keep model + graph in memory, stream change events                      |
-| `workspace run <stage> [--scope project:X] [--reuse-passed]` | Fleet init/test/build/start or custom stages from `.rapidkit/context.json` |
+| Command                                                      | Purpose                                                                              |
+| ------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
+| `workspace model [--cache\|--incremental] --json`            | Canonical workspace model (graph-aware, incremental rebuilds)                        |
+| `workspace context --for-agent --json --write`               | Agent-ready context pack + auto agent grounding sync                                 |
+| `workspace agent-sync --write`                               | Agent Customization Pack (AGENTS.md, Copilot, Cursor, Claude, INDEX, skills, agents) |
+| `workspace snapshot --json`                                  | Persist model snapshot                                                               |
+| `workspace diff --from <file\|git[:ref]> --json`             | Diff against snapshot or git                                                         |
+| `workspace impact --from <file> --json`                      | Graph-aware transitive blast-radius evidence                                         |
+| `workspace verify [--strict] --json`                         | Definitive verification gate (subgraph + freshness + policy + fleet evidence)        |
+| `workspace explain <target> [--write] --json`                | Human narrative for release blockers, projects, or trace slices                      |
+| `workspace why <target>`                                     | Alias of `workspace explain`                                                         |
+| `workspace trace --from <diff> [--write] --json`             | Diff → impact → gates narrative for agents and IDE handoff                           |
+| `workspace feedback record --json`                           | Append structured agent action outcomes to intelligence history                      |
+| `workspace mcp serve`                                        | Read-mostly stdio MCP bridge over workspace evidence                                 |
+| `workspace graph <emit\|explain\|dot\|mermaid>`              | Inspect and visualize the dependency graph                                           |
+| `workspace watch [--json] [--once]`                          | Daemon mode: keep model + graph in memory, stream change events                      |
+| `workspace run <stage> [--scope project:X] [--reuse-passed]` | Fleet init/test/build/start or custom stages from `.rapidkit/context.json`           |
 
 JSON schemas: `contracts/workspace-intelligence/`. Command coexistence and naming:
 [docs/contracts/NAMING_AND_COEXISTENCE.md](docs/contracts/NAMING_AND_COEXISTENCE.md).
@@ -294,6 +365,9 @@ radius, gating, and visualization:
 - **Transitive freshness** — a deterministic `fresh | stale | unknown` verdict chained
   through the graph: a dependency change makes every dependent stale, not just by
   timestamp.
+- **Fact freshness contracts** — `workspace model` and agent context packs mark each
+  workspace fact as durable, derived, evidence-backed, live, or verify-before-use so
+  agents do not reuse stale state as if it were structure.
 - **Policy violations** — model/contract violations are surfaced as structured
   `policyViolations[]` (not just an exit code) so IDEs and CI can render blockers.
 - **Health history** — every verify run appends to a bounded
@@ -331,31 +405,31 @@ npx rapidkit workspace agent-sync --write --strict --json
 npm run check:agent-customization-drift -- --workspace <workspace-root>
 ```
 
-| Artifact / file                                                         | Purpose                                                  |
-| ----------------------------------------------------------------------- | -------------------------------------------------------- |
-| `.rapidkit/reports/agent-customization-pack.json`                       | Versioned output inventory, target matrix, drift state   |
+| Artifact / file                                                         | Purpose                                                     |
+| ----------------------------------------------------------------------- | ----------------------------------------------------------- |
+| `.rapidkit/reports/agent-customization-pack.json`                       | Versioned output inventory, target matrix, drift state      |
 | `.rapidkit/reports/workspace-explain-last-run.json`                     | Unified explain / trace narrative for blockers and projects |
-| `.rapidkit/reports/workspace-skills-index.json`                        | Index of operational playbooks (`.rapidkit/skills/*.md`)      |
-| `.rapidkit/skills/rapidkit-*.md`                                       | Operational playbooks (generated by agent-sync)               |
-| `.rapidkit/reports/rapidkit-mcp-design.json`                            | Read-mostly MCP-ready tool design manifest               |
-| `.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-workspace.instructions.md`               | Copilot workspace scope and command discipline           |
-| `.github/instructions/rapidkit-evidence.instructions.md`                | Copilot scoped rules for `.rapidkit/**`                  |
-| `.github/prompts/rapidkit-diagnose.prompt.md`                           | Copilot reusable diagnose prompt                         |
-| `.github/skills/rapidkit-workspace-intelligence/SKILL.md`               | Workspace Intelligence skill workflow                    |
-| `.github/skills/rapidkit-workspace-intelligence/resources/mcp-tools.md` | Future MCP tool design reference                         |
-| `.github/agents/workspai-advisor.agent.md`                              | Read-only workspace advisor agent                        |
-| `.github/agents/workspai-repair.agent.md`                               | Blocker repair agent                                     |
-| `.github/agents/workspai-release.agent.md`                              | Release safety agent                                     |
-| `.github/agents/workspai-project-onboarder.agent.md`                    | Project onboarding agent                                 |
-| `.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                        |
-| `.vscode/rapidkit-agent-hooks.json`                                     | Optional advisory VS Code hooks (`--experimental-hooks`) |
+| `.rapidkit/reports/workspace-skills-index.json`                         | Index of operational playbooks (`.rapidkit/skills/*.md`)    |
+| `.rapidkit/skills/rapidkit-*.md`                                        | Operational playbooks (generated by agent-sync)             |
+| `.rapidkit/reports/rapidkit-mcp-design.json`                            | Read-mostly MCP-ready tool design manifest                  |
+| `.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-workspace.instructions.md`               | Copilot workspace scope and command discipline              |
+| `.github/instructions/rapidkit-evidence.instructions.md`                | Copilot scoped rules for `.rapidkit/**`                     |
+| `.github/prompts/rapidkit-diagnose.prompt.md`                           | Copilot reusable diagnose prompt                            |
+| `.github/skills/rapidkit-workspace-intelligence/SKILL.md`               | Workspace Intelligence skill workflow                       |
+| `.github/skills/rapidkit-workspace-intelligence/resources/mcp-tools.md` | Future MCP tool design reference                            |
+| `.github/agents/workspai-advisor.agent.md`                              | Read-only workspace advisor agent                           |
+| `.github/agents/workspai-repair.agent.md`                               | Blocker repair agent                                        |
+| `.github/agents/workspai-release.agent.md`                              | Release safety agent                                        |
+| `.github/agents/workspai-project-onboarder.agent.md`                    | Project onboarding agent                                    |
+| `.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                           |
+| `.vscode/rapidkit-agent-hooks.json`                                     | Optional advisory VS Code hooks (`--experimental-hooks`)    |
 
 The pack also publishes a standard answer contract for agent-facing output:
 

package/contracts/agent-customization-pack.v1.json

@@ -115,6 +115,21 @@
       "label": "Workspace doctor",
       "required": false
     },
+    {
+      "path": ".rapidkit/reports/doctor-project-last-run.json",
+      "label": "Project doctor",
+      "required": false
+    },
+    {
+      "path": ".rapidkit/reports/doctor-remediation-plan-last-run.json",
+      "label": "Doctor remediation plan",
+      "required": false
+    },
+    {
+      "path": ".rapidkit/reports/doctor-fix-result-last-run.json",
+      "label": "Doctor fix result",
+      "required": false
+    },
     {
       "path": ".rapidkit/reports/analyze-last-run.json",
       "label": "Workspace analyze",

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

@@ -26,8 +26,22 @@
     "projectPath": { "type": "string", "minLength": 1 },
     "projectName": { "type": "string", "minLength": 1 },
     "healthScore": { "type": "object", "additionalProperties": true },
+    "evidenceFreshness": { "$ref": "#/$defs/evidenceFreshness" },
     "system": { "type": "object", "additionalProperties": true },
-    "project": { "type": "object", "additionalProperties": true },
+    "project": {
+      "type": "object",
+      "properties": {
+        "probes": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/probe" }
+        },
+        "repairCapabilities": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/repairCapability" }
+        }
+      },
+      "additionalProperties": true
+    },
     "summary": {
       "type": "object",
       "properties": {
@@ -40,7 +54,251 @@
       "type": "array",
       "items": { "type": "object", "additionalProperties": true }
     },
-    "contract": { "type": "object", "additionalProperties": true }
+    "contract": { "type": "object", "additionalProperties": true },
+    "policyProfile": { "$ref": "#/$defs/policyProfile" }
+  },
+  "$defs": {
+    "freshness": {
+      "type": "object",
+      "required": [
+        "category",
+        "generatedAt",
+        "ttlSeconds",
+        "status",
+        "verifyBeforeUse",
+        "reason"
+      ],
+      "properties": {
+        "category": { "enum": ["structure", "verification", "state"] },
+        "generatedAt": { "type": "string", "format": "date-time" },
+        "ttlSeconds": { "type": ["integer", "null"], "minimum": 0 },
+        "expiresAt": { "type": "string", "format": "date-time" },
+        "status": { "enum": ["fresh", "stale", "unknown"] },
+        "verifyBeforeUse": { "type": "boolean" },
+        "reason": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "evidenceFreshness": {
+      "type": "object",
+      "required": [
+        "generatedAt",
+        "status",
+        "staleProbeCount",
+        "unknownProbeCount",
+        "liveStateProbeCount",
+        "verifyBeforeUseProbeCount"
+      ],
+      "properties": {
+        "generatedAt": { "type": "string", "format": "date-time" },
+        "status": { "enum": ["fresh", "stale", "unknown"] },
+        "staleProbeCount": { "type": "integer", "minimum": 0 },
+        "unknownProbeCount": { "type": "integer", "minimum": 0 },
+        "liveStateProbeCount": { "type": "integer", "minimum": 0 },
+        "verifyBeforeUseProbeCount": { "type": "integer", "minimum": 0 },
+        "oldestProbeGeneratedAt": { "type": "string", "format": "date-time" }
+      },
+      "additionalProperties": false
+    },
+    "repairIntent": {
+      "type": "object",
+      "required": [
+        "mode",
+        "confidence",
+        "primaryActionLabel",
+        "requiresApproval",
+        "requiresFreshEvidence",
+        "reason",
+        "relatedCommands"
+      ],
+      "properties": {
+        "mode": {
+          "enum": [
+            "none",
+            "run-command",
+            "edit-file",
+            "review-required",
+            "verify-before-fix",
+            "refresh-evidence",
+            "manual-guidance"
+          ]
+        },
+        "confidence": { "enum": ["high", "medium", "low"] },
+        "primaryActionLabel": { "type": "string" },
+        "requiresApproval": { "type": "boolean" },
+        "requiresFreshEvidence": { "type": "boolean" },
+        "reason": { "type": "string" },
+        "relatedCommands": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "policyProfile": {
+      "type": "object",
+      "required": [
+        "name",
+        "exitOnErrors",
+        "exitOnWarnings",
+        "warningExitCode",
+        "advisoryWarningsBlockRelease",
+        "description"
+      ],
+      "properties": {
+        "name": { "enum": ["local", "ci", "release", "enterprise-strict"] },
+        "exitOnErrors": { "const": true },
+        "exitOnWarnings": { "type": "boolean" },
+        "warningExitCode": { "enum": [0, 1, 2] },
+        "advisoryWarningsBlockRelease": { "type": "boolean" },
+        "description": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "probe": {
+      "type": "object",
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["pass", "warn", "fail"] },
+        "severity": { "enum": ["info", "warn", "error"] },
+        "scope": { "type": "string" },
+        "reason": { "type": "string" },
+        "recommendation": { "type": "string" },
+        "freshness": { "$ref": "#/$defs/freshness" },
+        "issueClass": {
+          "enum": [
+            "dependency",
+            "environment",
+            "security",
+            "test",
+            "quality",
+            "container",
+            "deployment",
+            "runtime",
+            "workspace-contract",
+            "source-tree",
+            "framework",
+            "configuration",
+            "custom",
+            "unknown"
+          ]
+        },
+        "operationalImpact": {
+          "enum": [
+            "none",
+            "developer-friction",
+            "ci-risk",
+            "release-risk",
+            "security-risk",
+            "runtime-risk",
+            "customer-risk"
+          ]
+        },
+        "repairIntent": { "$ref": "#/$defs/repairIntent" },
+        "repairCapability": { "$ref": "#/$defs/repairCapability" }
+      },
+      "additionalProperties": true
+    },
+    "repairCapability": {
+      "type": "object",
+      "required": [
+        "id",
+        "issueId",
+        "title",
+        "status",
+        "fixKind",
+        "risk",
+        "canAutoFix",
+        "canEditFiles",
+        "requiresApproval",
+        "requiresReview",
+        "files",
+        "refreshCommands",
+        "reason"
+      ],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "issueId": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["available", "manual", "blocked"] },
+        "fixKind": {
+          "enum": [
+            "package-json-script",
+            "file-create",
+            "file-append",
+            "file-copy",
+            "dependency-sync",
+            "command",
+            "manual"
+          ]
+        },
+        "risk": { "enum": ["safe", "guarded", "invasive"] },
+        "canAutoFix": { "type": "boolean" },
+        "canEditFiles": { "type": "boolean" },
+        "requiresApproval": { "type": "boolean" },
+        "requiresReview": { "type": "boolean" },
+        "files": { "type": "array", "items": { "type": "string" } },
+        "command": { "type": "string" },
+        "operation": { "$ref": "#/$defs/repairOperation" },
+        "verifyCommand": { "type": "string" },
+        "refreshCommands": { "type": "array", "items": { "type": "string" } },
+        "reason": { "type": "string" },
+        "limitations": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": true
+    },
+    "repairOperation": {
+      "type": "object",
+      "required": ["type", "path"],
+      "properties": {
+        "type": {
+          "enum": [
+            "file-create",
+            "file-append",
+            "file-copy",
+            "package-json-script",
+            "json-edit",
+            "env-key-add",
+            "makefile-target"
+          ]
+        },
+        "sourcePath": { "type": "string", "minLength": 1 },
+        "path": { "type": "string", "minLength": 1 },
+        "content": { "type": "string" },
+        "overwrite": { "type": "boolean" },
+        "lines": { "type": "array", "items": { "type": "string" } },
+        "ensureNewline": { "type": "boolean" },
+        "scriptName": { "type": "string" },
+        "scriptValue": { "type": "string" },
+        "edits": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["pointer", "value"],
+            "properties": {
+              "pointer": { "type": "string" },
+              "value": { "type": ["string", "number", "boolean", "null"] }
+            },
+            "additionalProperties": false
+          }
+        },
+        "keys": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["name", "value"],
+            "properties": {
+              "name": { "type": "string" },
+              "value": { "type": "string" },
+              "comment": { "type": "string" }
+            },
+            "additionalProperties": false
+          }
+        },
+        "target": { "type": "string" },
+        "command": { "type": "string" },
+        "phony": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    }
   },
   "additionalProperties": true
 }