@openplanr/protocol 0.2.0

package/schemas/v1.0.0/graph.schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.0.0/graph.schema.json",
+  "title": "OpenPlanr dashboard project Graph (v1.0.0)",
+  "description": "The typed project graph the dashboard renders. Built from .planr/ artifacts either by delegating to the planr CLI (planr graph --json / planr status --json) or by the native frontmatter reader; both paths must validate against this schema (SPEC-016 / US-002). A Graph is { nodes: Node[], edges: Edge[] }. A Node is one artifact (epic, feature, story, task, spec, backlog item, quick task, sprint, or ADR) with a classified status mirroring /planr-pipeline:status A.2. An Edge is either a `contains` hierarchy link (from a frontmatter parent id) or a `depends_on` link (from a dependsOn entry). Definitions are inlined (no $ref) to match the conformance validator subset.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["nodes", "edges"],
+  "properties": {
+    "nodes": {
+      "type": "array",
+      "description": "Every recognized .planr/ artifact as a typed node.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "type", "title", "status", "frontmatter"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Artifact identifier, taken from frontmatter `id` (e.g. SPEC-016, US-002, T-007, EPIC-001, FEAT-003, ADR-004). Unique within the graph."
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "epic",
+              "feature",
+              "story",
+              "task",
+              "spec",
+              "backlog",
+              "quick",
+              "sprint",
+              "adr"
+            ],
+            "description": "Artifact kind, inferred from the file's path pattern and id prefix. Covers both the agile model (epic/feature/story/task) and the spec model (spec/story/task)."
+          },
+          "title": {
+            "type": "string",
+            "description": "Human-readable title from frontmatter `title`, or the artifact id when no title is present."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "done",
+              "in-progress",
+              "blocked",
+              "outstanding",
+              "addressed"
+            ],
+            "description": "Classified status, mirroring /planr-pipeline:status A.2: done (done|closed|completed|shipped|released), addressed (promoted|superseded), blocked, in-progress, otherwise outstanding. Never an invented status."
+          },
+          "frontmatter": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "The artifact's raw parsed YAML frontmatter, preserved for the inspector. Includes githubIssue / linearIssueIdentifier when present."
+          },
+          "githubIssue": {
+            "type": ["string", "integer"],
+            "description": "GitHub issue/PR reference from frontmatter `githubIssue`, hoisted onto the node for cross-reference. Present only when the frontmatter carries it."
+          },
+          "linearIssueIdentifier": {
+            "type": "string",
+            "description": "Linear identifier from frontmatter `linearIssueIdentifier` (e.g. ENG-99), hoisted onto the node. Present only when the frontmatter carries it."
+          },
+          "body": {
+            "type": "string",
+            "description": "The artifact's markdown body below the frontmatter. Optional; included by getNode for the detail view."
+          }
+        }
+      }
+    },
+    "edges": {
+      "type": "array",
+      "description": "Hierarchy (`contains`) and dependency (`depends_on`) links between nodes.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["from", "to", "kind"],
+        "properties": {
+          "from": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Source node id. For `contains` this is the parent (e.g. the story id from a task's storyId). For `depends_on` this is the dependent node."
+          },
+          "to": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Target node id. For `contains` this is the child. For `depends_on` this is the prerequisite (e.g. an entry from dependsOn)."
+          },
+          "kind": {
+            "type": "string",
+            "enum": ["contains", "depends_on"],
+            "description": "`contains` = hierarchy edge derived from a frontmatter parent id (epicId/featureId/specId/storyId). `depends_on` = dependency edge derived from a dependsOn array entry."
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/v1.0.0/pipeline-shipped.schema.json

@@ -0,0 +1,154 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.0.0/pipeline-shipped.schema.json",
+  "title": "OpenPlanr .pipeline-shipped marker (v1.0.0)",
+  "description": "JSON Schema for the YAML completion marker written by SHIP at the end of every successful (or partially-successful) run. Path: output/feats/feat-{name}/.pipeline-shipped (default mode) or .planr/specs/SPEC-NNN-{slug}/.pipeline-shipped (spec-driven mode). Note: this artifact uses `pipeline_version` (the planr-pipeline plugin semver) rather than a `schemaVersion` field; the schema-version of the marker is encoded in the file path itself (schemas/v1.0.0/...).",
+  "type": "object",
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "if": { "required": ["operating_origin"] },
+      "then": { "required": ["delivery_status", "run_id", "manifest_hash", "manifest_start_line", "manifest_end_line"] }
+    },
+    {
+      "if": { "required": ["closure_receipt_hash"] },
+      "then": { "required": ["candidate_hash", "gate_evidence_hash", "run_id", "manifest_hash", "manifest_start_line", "manifest_end_line"] }
+    }
+  ],
+  "required": [
+    "shipped_at",
+    "pipeline_version",
+    "runtime",
+    "mode",
+    "feature",
+    "tasks_executed",
+    "tasks_failed",
+    "qa_gate_status",
+    "duration_seconds",
+    "agents_invoked",
+    "devops_status",
+    "docs_status",
+    "snapshot_status",
+    "error_reports"
+  ],
+  "properties": {
+    "shipped_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 UTC timestamp at which SHIP completed."
+    },
+    "pipeline_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[A-Za-z0-9.-]+)?(?:\\+[A-Za-z0-9.-]+)?$",
+      "description": "Semver of the planr-pipeline plugin that produced the marker (e.g. 0.24.9)."
+    },
+    "runtime": {
+      "type": "string",
+      "enum": ["claude-code", "cursor", "codex", "unknown"],
+      "description": "Runtime adapter that executed this turn (NEW in v1.0.0). `unknown` is the Step 1.7 fail-safe value when no adapter matched — it still ships per-task and writes a marker, so the enum admits it."
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["default", "spec-driven"],
+      "description": "Pipeline execution mode."
+    },
+    "feature": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Feature name (default mode) or spec slug (spec-driven mode)."
+    },
+    "tasks_executed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of tasks executed during this SHIP run."
+    },
+    "tasks_failed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of tasks that failed (after the 3-iteration correction loop)."
+    },
+    "qa_gate_status": {
+      "type": "string",
+      "enum": ["passed", "failed", "skipped"],
+      "description": "Outcome of the qa-agent gate."
+    },
+    "delivery_status": {
+      "type": "string",
+      "enum": ["succeeded", "blocked", "failed"],
+      "description": "Terminal delivery classification derived by the pipeline from task and QA custody."
+    },
+    "duration_seconds": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Wall-clock duration of the SHIP run in whole seconds."
+    },
+    "agents_invoked": {
+      "type": "array",
+      "description": "List of role names that actually ran during this SHIP turn. Order is informational.",
+      "items": {
+        "type": "string",
+        "enum": [
+          "designer-agent",
+          "specification-agent",
+          "frontend-agent",
+          "backend-agent",
+          "db-agent",
+          "qa-agent",
+          "devops-agent",
+          "doc-gen-agent"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "devops_status": {
+      "type": "string",
+      "enum": ["generated", "skipped"],
+      "description": "Whether devops-agent produced artifacts this turn."
+    },
+    "docs_status": {
+      "type": "string",
+      "enum": ["generated", "skipped"],
+      "description": "Whether doc-gen-agent produced artifacts this turn."
+    },
+    "snapshot_status": {
+      "type": "string",
+      "enum": ["refreshed", "skipped"],
+      "description": "Whether the codebase snapshot was refreshed this turn."
+    },
+    "error_reports": {
+      "type": "array",
+      "description": "Relative or absolute repo paths for any **`T-<NNN>-error-report.md`** handoffs produced after R6 caps. Legacy singleton `tasks/error-report.md` is forbidden.",
+      "items": {
+        "type": "string"
+      }
+    },
+    "dispatch_style": {
+      "type": "string",
+      "enum": ["native", "workflow"],
+      "description": "How the multi-task fan-out was scheduled (NEW, optional): `native` = orchestrator emitted the Agent calls directly; `workflow` = the host Workflow tool scheduled the dependsOn DAG. Omitted on per-task runtimes (cursor/codex), single-task runs, and markers written before this field existed."
+    },
+    "run_id": { "type": "string", "minLength": 1 },
+    "manifest_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "manifest_start_line": { "type": "integer", "minimum": 1 },
+    "manifest_end_line": { "type": "integer", "minimum": 1 },
+    "closure_receipt_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "candidate_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "gate_evidence_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "operating_origin": {
+      "$ref": "#/$defs/operatingOrigin"
+    }
+  },
+  "$defs": {
+    "operatingOrigin": {
+      "type": "object", "additionalProperties": false,
+      "required": ["correlation_id", "proposal_id", "proposal_hash", "transaction_id", "receipt_hash"],
+      "properties": {
+        "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "proposal_id": { "type": "string", "pattern": "^oprop_[a-f0-9]{32}$" },
+        "proposal_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "transaction_id": { "type": "string", "pattern": "^txn_[a-f0-9]{32}$" },
+        "receipt_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    }
+  }
+}

package/schemas/v1.0.0/run-manifest.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.0.0/run-manifest.schema.json",
+  "title": "OpenPlanr .run-manifest.jsonl line object (v1.0.0)",
+  "description": "Single JSON Lines record appended to SPEC_DIR/.run-manifest.jsonl (spec-driven) or output/feats/feat-{slug}/.run-manifest.jsonl (default). Append-only lifecycle — never truncate the manifest file wholesale.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "stage",
+    "agent",
+    "started_at",
+    "ended_at",
+    "files_written",
+    "files_modified",
+    "exit_status",
+    "error_summary"
+  ],
+  "properties": {
+    "stage": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Orchestration boundary label (e.g. ship.bootstrap, ship.inputs-done, ship.task:T-003, qa-gate)."
+    },
+    "agent": {
+      "description": "Subagent slug or null when no agent (orchestration-only milestone).",
+      "type": ["string", "null"]
+    },
+    "started_at": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$"
+    },
+    "ended_at": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$"
+    },
+    "files_written": {
+      "type": "array",
+      "description": "Repo-relative POSIX paths newly created.",
+      "items": { "type": "string", "minLength": 1 },
+      "default": []
+    },
+    "files_modified": {
+      "type": "array",
+      "description": "Repo-relative POSIX paths of files edited in place.",
+      "items": { "type": "string", "minLength": 1 },
+      "default": []
+    },
+    "exit_status": {
+      "type": "string",
+      "enum": ["success", "failure", "skipped"],
+      "description": "Outcome of this stage boundary."
+    },
+    "error_summary": {
+      "description": "null when exit_status !== failure; otherwise one concise line.",
+      "type": ["string", "null"]
+    },
+    "cost_hint": {
+      "description": "Optional non-binding cue surfaced in status when present.",
+      "type": ["string", "null"],
+      "default": null
+    },
+    "operating_origin": {
+      "$ref": "#/$defs/operatingOrigin"
+    }
+  },
+  "$defs": {
+    "operatingOrigin": {
+      "type": "object", "additionalProperties": false,
+      "required": ["correlation_id", "proposal_id", "proposal_hash", "transaction_id", "receipt_hash"],
+      "properties": {
+        "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "proposal_id": { "type": "string", "pattern": "^oprop_[a-f0-9]{32}$" },
+        "proposal_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "transaction_id": { "type": "string", "pattern": "^txn_[a-f0-9]{32}$" },
+        "receipt_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    }
+  }
+}

package/schemas/v1.0.0/spec.schema.json

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.0.0/spec.schema.json",
+  "title": "OpenPlanr SPEC frontmatter (v1.0.0)",
+  "description": "JSON Schema for the YAML frontmatter of a SPEC-NNN-{slug}.md artifact in spec-driven mode. Validates the canonical shape produced by `planr spec shape` / `planr spec decompose` and the planr-pipeline specification-agent.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "title",
+    "slug",
+    "schemaVersion",
+    "status",
+    "priority",
+    "created",
+    "updated",
+    "ui_files",
+    "tech_dependencies"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^(SPEC|FEAT)-\\d{3}$",
+      "description": "Feature/Spec identifier. SPEC-NNN in spec-driven mode (e.g. SPEC-001), FEAT-NNN in default mode (e.g. FEAT-001). Scoped to the parent project."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable spec title."
+    },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "minLength": 1,
+      "description": "URL-safe lowercase slug used in the spec directory path."
+    },
+    "schemaVersion": {
+      "const": "1.0.0",
+      "description": "Pinned to the OpenPlanr Protocol reader version."
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "pending",
+        "shaping",
+        "shaped",
+        "decomposing",
+        "decomposed",
+        "ready-for-pipeline",
+        "in-pipeline",
+        "done"
+      ],
+      "description": "Current lifecycle state of the spec."
+    },
+    "priority": {
+      "type": "string",
+      "enum": ["P0", "P1", "P2", "P3"],
+      "description": "Priority tier."
+    },
+    "milestone": {
+      "type": "string",
+      "description": "Optional milestone label (e.g. v1.0)."
+    },
+    "po": {
+      "type": "string",
+      "description": "Optional spec owner identifier (typically an email)."
+    },
+    "created": {
+      "type": "string",
+      "format": "date",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "ISO date (YYYY-MM-DD) of spec creation."
+    },
+    "updated": {
+      "type": "string",
+      "format": "date",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "description": "ISO date (YYYY-MM-DD) bumped on every edit."
+    },
+    "ui_files": {
+      "type": "array",
+      "description": "Array of PNG paths under design/ for UI-bearing specs. Empty array when the spec has no UI surface.",
+      "items": {
+        "type": "string"
+      }
+    },
+    "tech_dependencies": {
+      "type": "array",
+      "description": "Informational list of upstream technical dependencies. Empty array when none.",
+      "items": {
+        "type": "string"
+      }
+    },
+    "specificationContract": {
+      "const": "professional-specification@1.0.0",
+      "description": "Optional marker for a decision-complete professional specification. Legacy specifications omit it and remain readable."
+    },
+    "review_specialists": {
+      "type": "array",
+      "maxItems": 5,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "enum": ["security-reviewer", "performance-reviewer", "migration-reviewer", "api-contract-reviewer", "data-integrity-reviewer"]
+      },
+      "description": "Optional explicitly declared planning-review specialists in canonical registry order."
+    },
+    "kanbanosId": {
+      "type": "string",
+      "minLength": 8,
+      "pattern": "^[A-Za-z0-9_-]{8,128}$",
+      "description": "Optional opaque entity id on the kanbanos hosted board, written back by the sync tool after a successful push (the linearId precedent from the OpenPlanr CLI Linear integration). Sync-tool-owned: humans and planning agents never author or edit it by hand. Absent until the artifact is first pushed. See ADR-012."
+    },
+    "contentHash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "Optional digest of the artifact content at the last successful board sync, written back by the sync tool alongside kanbanosId so drift between file and board is detectable. Same sha256:<hex> shape as operating-evidence-index-item@1.3.0. Sync-tool-owned: humans and planning agents never author or edit it by hand. See ADR-012."
+    }
+  }
+}

package/schemas/v1.0.0/stack.schema.json

@@ -0,0 +1,184 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.0.0/stack.schema.json",
+  "title": "OpenPlanr stack.md required keys (v1.0.0)",
+  "description": "JSON Schema for the canonical key set extracted from input/tech/stack.md. The stack file is YAML-in-markdown; consumers extract the keys into a single flat object before validation. BuildCommand, TestCommand, Language, Framework, and ORM are required (ORM may be empty string for stacks without a database).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "BuildCommand",
+    "TestCommand",
+    "Language",
+    "Framework",
+    "ORM"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "1.0.0",
+      "description": "Pinned to the OpenPlanr Protocol reader version."
+    },
+    "AppName": {
+      "type": "string",
+      "description": "Project name."
+    },
+    "Version": {
+      "type": "string",
+      "description": "Project version."
+    },
+    "Description": {
+      "type": "string",
+      "description": "Short project description."
+    },
+    "Repository": {
+      "type": "string",
+      "description": "Source repository URL."
+    },
+    "Language": {
+      "type": "string",
+      "description": "Primary backend language (e.g. TypeScript, Python, JavaScript (Node ESM)). May be empty for non-applicable stacks."
+    },
+    "Framework": {
+      "type": "string",
+      "description": "Backend framework or runtime (e.g. NestJS, Next.js, Claude Code plugin). May be empty when not applicable."
+    },
+    "RuntimeVersion": {
+      "type": "string",
+      "description": "Runtime/engine version requirement (e.g. Node 20+)."
+    },
+    "AuthStrategy": {
+      "type": "string",
+      "description": "Authentication strategy (e.g. JWT, OAuth, NextAuth)."
+    },
+    "APIStyle": {
+      "type": "string",
+      "description": "API style (e.g. REST, GraphQL, RPC)."
+    },
+    "TestFramework": {
+      "type": "string",
+      "description": "Backend test framework (e.g. Vitest, Jest, pytest, node:test)."
+    },
+    "DatabaseType": {
+      "type": "string",
+      "description": "Database engine (e.g. postgres, mysql, sqlite). Empty when no DB."
+    },
+    "DatabaseHost": {
+      "type": "string",
+      "description": "Database host."
+    },
+    "DatabasePort": {
+      "type": ["string", "integer"],
+      "description": "Database port (string or integer)."
+    },
+    "DatabaseName": {
+      "type": "string",
+      "description": "Database name."
+    },
+    "DatabaseUser": {
+      "type": "string",
+      "description": "Database user."
+    },
+    "DatabasePassword": {
+      "type": "string",
+      "description": "Database password (typically a secret reference, not a literal)."
+    },
+    "ORM": {
+      "type": "string",
+      "description": "ORM (e.g. Prisma, TypeORM, Drizzle, EF Core, SQLAlchemy). Empty string is valid when the project has no DB."
+    },
+    "MigrationTool": {
+      "type": "string",
+      "description": "Migration tool (e.g. prisma migrate, alembic, knex)."
+    },
+    "UIFramework": {
+      "type": "string",
+      "description": "Frontend UI framework (e.g. React, Vue, SolidJS)."
+    },
+    "CSSStrategy": {
+      "type": "string",
+      "description": "CSS approach (e.g. Tailwind, CSS Modules, styled-components)."
+    },
+    "ComponentLibrary": {
+      "type": "string",
+      "description": "Component library (e.g. shadcn/ui, MUI, Radix)."
+    },
+    "StateManagement": {
+      "type": "string",
+      "description": "State management library (e.g. Zustand, Redux Toolkit, TanStack Query)."
+    },
+    "FormLibrary": {
+      "type": "string",
+      "description": "Form library (e.g. React Hook Form, Formik)."
+    },
+    "HTTPClient": {
+      "type": "string",
+      "description": "HTTP client (e.g. fetch, axios, ky)."
+    },
+    "ContainerRuntime": {
+      "type": "string",
+      "description": "Container runtime (e.g. Docker, Podman)."
+    },
+    "Orchestration": {
+      "type": "string",
+      "description": "Orchestrator (e.g. Kubernetes, Docker Compose, Fly.io)."
+    },
+    "CIProvider": {
+      "type": "string",
+      "description": "CI provider (e.g. GitHub Actions, GitLab CI, CircleCI)."
+    },
+    "CloudProvider": {
+      "type": "string",
+      "description": "Cloud provider (e.g. AWS, GCP, Azure, Vercel, Fly.io)."
+    },
+    "SecretManagement": {
+      "type": "string",
+      "description": "Secret manager (e.g. AWS Secrets Manager, Vault, .env)."
+    },
+    "NamingConvention": {
+      "type": "object",
+      "description": "Code naming conventions across files, components, functions, constants, and database identifiers.",
+      "additionalProperties": true
+    },
+    "FolderStructure": {
+      "type": "string",
+      "description": "Folder structure style (e.g. domain-based, feature-based, type-based)."
+    },
+    "TestCoverage": {
+      "type": "string",
+      "description": "Coverage policy summary."
+    },
+    "BuildCommand": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Shell command DEV agents run during the correction loop. Must exit 0 for a clean build."
+    },
+    "TestCommand": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Shell command DEV agents run during the correction loop. Must exit 0 for a clean test pass."
+    },
+    "LintCommand": {
+      "type": "string",
+      "description": "Optional lint command. When non-empty, must exit 0."
+    },
+    "TypeCheckCommand": {
+      "type": "string",
+      "description": "Optional type-check command. When non-empty, must exit 0."
+    },
+    "ActiveStackFiles": {
+      "type": "array",
+      "description": "Resolved paths to active stack overlay files (e.g. backend/nestjs.md, database/prisma.md). Empty array when none.",
+      "items": { "type": "string" }
+    },
+    "DoNotUse": {
+      "type": "array",
+      "description": "Hard exclusions agents must respect.",
+      "items": { "type": "string" }
+    },
+    "MustPreserve": {
+      "type": "array",
+      "description": "Files or invariants agents must never modify.",
+      "items": { "type": "string" }
+    }
+  }
+}