@adammcarter/use-cases 0.1.0

package/packages/mcp/dist/toolSchemas.js

@@ -0,0 +1,223 @@
+// Closed value-domains mirrored from @adammcarter/use-cases-core so the advertised MCP
+// schemas document exactly what each parameter accepts. These are advisory: the
+// server does not validate inbound args against the schema (handlers self-validate
+// and still forward every undeclared field to the CLI), so declaring them only
+// improves self-documentation — it never narrows the CLI-parity passthrough.
+const HOST_SURFACES = [
+    "claude.cli",
+    "claude.desktop",
+    "codex.cli",
+    "copilot.cli",
+    "copilot.github",
+    "opencode.cli",
+    "unknown"
+];
+const HOST_NAMES = ["claude", "codex", "copilot", "opencode"];
+const ACTOR_TYPES = ["agent", "script", "system"];
+const VERDICTS = ["pass", "partial", "fail", "waived", "blocked"];
+const FAILURE_DECISIONS = ["continue", "pause_to_fix", "waive_with_reason", "abort"];
+const EVIDENCE_KINDS = [
+    "manual_observation",
+    "agent_observation",
+    "command_result",
+    "test_result",
+    "live_demo",
+    "artifact_review",
+    "host_conformance",
+    "url"
+];
+const EVIDENCE_RESULTS = ["pass", "fail", "inconclusive", "observed"];
+const VALUE_TIERS = ["critical", "core", "supporting", "long_tail"];
+const JOURNEY_ROLES = ["golden", "alternate", "edge", "negative", "failure"];
+const LIFECYCLES = ["planned", "active", "deprecated", "removed"];
+const USAGE_FREQUENCIES = ["common", "occasional", "rare"];
+// Shared property fragments reused across tool schemas.
+const repoProp = { type: "string", description: "Repository/workspace root. Required for workspace-scoped tools." };
+const dataRootProp = { type: "string", description: "Optional data root, resolved relative to repo (must stay inside repo)." };
+const componentProp = { type: "string", description: "Optional component id used to scope resolution within the workspace." };
+const timeoutProp = {
+    type: "integer",
+    minimum: 0,
+    description: "Advisory call budget in milliseconds; 0 aborts the call before any execution."
+};
+const allowWriteProp = {
+    type: "boolean",
+    description: "Must be true for any ledger mutation. Write tools also require the server to run in write mode (UCM_MCP_WRITE=1)."
+};
+const actorTypeProp = {
+    type: "string",
+    enum: ACTOR_TYPES,
+    description: "Non-user actor recording the event (defaults to agent). 'user' is rejected over MCP; trusted-user approval is CLI-mediated."
+};
+const hostSurfaceProp = {
+    type: "string",
+    enum: HOST_SURFACES,
+    description: "Originating host surface recorded on the event (defaults to codex.cli)."
+};
+const idempotencyKeyProp = {
+    type: "string",
+    description: "Caller-supplied idempotency key; a deterministic key is derived when omitted."
+};
+const recordedAtProp = { type: "string", description: "ISO-8601 timestamp override for the appended event." };
+const runProp = { type: "string", description: "Showcase run id." };
+const planItemProp = { type: "string", description: "Plan item id within the showcase run." };
+const expectedHashProp = { type: "string", description: "Expected semantic hash for optimistic-concurrency guarding of the matrix file." };
+const useCaseObjectProp = {
+    type: "object",
+    description: "Full use-case entry (UseCaseV1 shape) to add or replace at its id.",
+    properties: {
+        id: { type: "string", description: "Canonical use-case id (e.g. 'auth.login')." },
+        title: { type: "string", description: "Human-readable title." },
+        lifecycle: { type: "string", enum: LIFECYCLES, description: "Lifecycle state." },
+        value_tier: { type: "string", enum: VALUE_TIERS, description: "Business value tier." },
+        journey_role: { type: "string", enum: JOURNEY_ROLES, description: "Role of this case within the user journey." },
+        usage_frequency: { type: "string", enum: USAGE_FREQUENCIES, description: "How often the case is exercised." },
+        tags: { type: "array", items: { type: "string" }, description: "Free-form tags." }
+    },
+    required: ["id"],
+    additionalProperties: true
+};
+// Build a workspace-scoped input schema: always carries repo/data_root/component/
+// timeout_ms, keeps repo required, and leaves additionalProperties open for
+// CLI-parity passthrough.
+export function workspaceSchema(properties = {}, required = []) {
+    return {
+        type: "object",
+        properties: {
+            repo: repoProp,
+            data_root: dataRootProp,
+            component: componentProp,
+            timeout_ms: timeoutProp,
+            ...properties
+        },
+        required: ["repo", ...required],
+        additionalProperties: true
+    };
+}
+export const toolInputBase = workspaceSchema();
+export const matrixListInputSchema = workspaceSchema({
+    value: { type: "array", items: { type: "string", enum: VALUE_TIERS }, description: "Filter to these value tiers." },
+    journey_role: { type: "array", items: { type: "string", enum: JOURNEY_ROLES }, description: "Filter to these journey roles." },
+    lifecycle: { type: "array", items: { type: "string", enum: LIFECYCLES }, description: "Filter to these lifecycle states." },
+    host: { type: "array", items: { type: "string", enum: HOST_SURFACES }, description: "Filter to use cases applicable to these host surfaces." },
+    tag: { type: "array", items: { type: "string" }, description: "Filter to use cases carrying any of these tags." },
+    changed_path: { type: "array", items: { type: "string" }, description: "Filter to use cases impacted by these changed paths." },
+    strict: { type: "boolean", description: "Report ok=false when the matrix is incomplete." }
+});
+//: @use-case: mcp.surface.declared_tool_schemas
+export const useCaseUpsertInputSchema = workspaceSchema({
+    file: { type: "string", description: "Workspace-relative matrix file the entry is written into." },
+    use_case: useCaseObjectProp,
+    expected_hash: expectedHashProp,
+    actor_type: actorTypeProp,
+    allow_write: allowWriteProp
+}, ["file", "use_case"]);
+//: @use-case: end mcp.surface.declared_tool_schemas
+export const useCaseRemoveInputSchema = workspaceSchema({
+    use_case: { type: "string", description: "Canonical use-case id to mark removed." },
+    reason: { type: "string", description: "Why the use case is being removed." },
+    expected_hash: expectedHashProp,
+    actor_type: actorTypeProp,
+    allow_write: allowWriteProp
+}, ["use_case", "reason"]);
+export const evidenceRecordInputSchema = workspaceSchema({
+    use_case: { type: "string", description: "Canonical use-case id the evidence attaches to." },
+    kind: { type: "string", enum: EVIDENCE_KINDS, description: "Evidence kind (defaults to manual_observation)." },
+    result: { type: "string", enum: EVIDENCE_RESULTS, description: "Observed result (defaults to observed)." },
+    summary: { type: "string", description: "Human-readable summary of what was observed." },
+    actor_type: actorTypeProp,
+    host_surface: hostSurfaceProp,
+    idempotency_key: idempotencyKeyProp,
+    allow_write: allowWriteProp
+}, ["use_case"]);
+export const evidenceVoidInputSchema = workspaceSchema({
+    evidence: { type: "string", description: "Canonical evidence id to void." },
+    expected_head: { type: "string", description: "Expected head event id (optimistic-concurrency guard)." },
+    reason: { type: "string", description: "Why the evidence is being voided." },
+    actor_type: actorTypeProp,
+    host_surface: hostSurfaceProp,
+    idempotency_key: idempotencyKeyProp,
+    allow_write: allowWriteProp
+}, ["evidence", "expected_head", "reason"]);
+export const planInputSchema = workspaceSchema({
+    audience: { type: "string", description: "Intended audience label for the plan (default 'reviewer')." },
+    timebox_seconds: { type: "integer", minimum: 0, description: "Total presentation budget in seconds (default 600 showcase / 1800 walkthrough)." },
+    max_items: { type: "integer", minimum: 1, description: "Cap on the number of selected items." },
+    host: { type: "string", enum: HOST_SURFACES, description: "Host surface to plan for (default 'unknown')." },
+    changed_path: { type: "array", items: { type: "string" }, description: "Changed paths to bias selection toward impacted use cases." },
+    generated_at: { type: "string", description: "ISO-8601 generation timestamp override." },
+    strict: { type: "boolean", description: "Block the plan when the matrix or evidence is incomplete." }
+});
+export const capsuleRunInputSchema = workspaceSchema({
+    capsule: { type: "string", description: "Demo capsule id to run." },
+    execute_commands: { type: "boolean", description: "Execute capsule commands (requires UCM_MCP_COMMAND_EXECUTION=1)." },
+    command_timeout_ms: { type: "integer", minimum: 0, description: "Per-command execution timeout in milliseconds." },
+    actor_type: actorTypeProp,
+    host_surface: hostSurfaceProp,
+    idempotency_key: idempotencyKeyProp,
+    recorded_at: recordedAtProp,
+    allow_write: allowWriteProp
+}, ["capsule"]);
+export const showcaseStartInputSchema = workspaceSchema({
+    select: { type: "string", description: "Use-case id to build an ad hoc single-item plan for (alternative to plan_file)." },
+    plan_file: { type: "string", description: "Workspace-relative presentation-plan JSON file to start from (alternative to select)." },
+    audience: { type: "string", description: "Audience label for an ad hoc plan (default 'reviewer')." },
+    timebox_seconds: { type: "integer", minimum: 0, description: "Timebox in seconds for an ad hoc plan (default 600)." },
+    generated_at: { type: "string", description: "ISO-8601 plan generation timestamp override." },
+    actor_type: actorTypeProp,
+    host_surface: hostSurfaceProp,
+    idempotency_key: idempotencyKeyProp,
+    recorded_at: recordedAtProp,
+    allow_write: allowWriteProp
+});
+export const showcaseStatusInputSchema = workspaceSchema({ run: runProp }, ["run"]);
+export const showcaseObservationInputSchema = workspaceSchema({
+    run: runProp,
+    item: planItemProp,
+    text: { type: "string", description: "Observation text for the plan item." },
+    actor_type: actorTypeProp,
+    host_surface: hostSurfaceProp,
+    idempotency_key: idempotencyKeyProp,
+    recorded_at: recordedAtProp,
+    allow_write: allowWriteProp
+}, ["run", "item", "text"]);
+export const showcaseVerdictInputSchema = workspaceSchema({
+    run: runProp,
+    item: planItemProp,
+    verdict: { type: "string", enum: VERDICTS, description: "Verdict for the plan item; requires a prior observation." },
+    actor_type: actorTypeProp,
+    host_surface: hostSurfaceProp,
+    idempotency_key: idempotencyKeyProp,
+    recorded_at: recordedAtProp,
+    allow_write: allowWriteProp
+}, ["run", "item", "verdict"]);
+export const showcaseDecideInputSchema = workspaceSchema({
+    run: runProp,
+    verdict_event: { type: "string", description: "Verdict event id the failure decision applies to." },
+    decision: { type: "string", enum: FAILURE_DECISIONS, description: "Disposition for a failing/partial item." },
+    reason: { type: "string", description: "Why this decision was taken." },
+    actor_type: actorTypeProp,
+    host_surface: hostSurfaceProp,
+    idempotency_key: idempotencyKeyProp,
+    recorded_at: recordedAtProp,
+    allow_write: allowWriteProp
+}, ["run", "verdict_event", "decision", "reason"]);
+export const showcaseFinishInputSchema = workspaceSchema({
+    run: runProp,
+    host_surface: hostSurfaceProp,
+    idempotency_key: idempotencyKeyProp,
+    recorded_at: recordedAtProp,
+    allow_write: allowWriteProp
+}, ["run"]);
+export const showcaseRequestApprovalInputSchema = workspaceSchema({
+    run: runProp,
+    statement: { type: "string", description: "Draft approval statement echoed into the suggested CLI command." }
+}, ["run"]);
+export const hostDoctorInputSchema = workspaceSchema({
+    host: { type: "string", enum: HOST_NAMES, description: "Host whose profile/projection is checked." }
+}, ["host"]);
+export const cliEnvelopeSchema = {
+    type: "object",
+    required: ["schema_version", "protocol_version", "command", "ok", "complete", "data", "diagnostics", "context"]
+};
+//# sourceMappingURL=toolSchemas.js.map

package/packages/mcp/dist/toolSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSchemas.js","sourceRoot":"","sources":["../src/toolSchemas.ts"],"names":[],"mappings":"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"}

package/packages/mcp/dist/tools.d.ts

@@ -0,0 +1,22 @@
+import type { CliResult } from "@adammcarter/use-cases-core";
+import { type JsonObject } from "./toolSchemas.js";
+type ToolMode = "read" | "write" | "approval_request";
+export type McpToolDescriptor = {
+    name: string;
+    description: string;
+    inputSchema: JsonObject;
+    outputSchema: JsonObject;
+    mutability: ToolMode;
+    command: string;
+};
+export declare const mcpTools: {
+    name: string;
+    description: string;
+    inputSchema: JsonObject;
+    outputSchema: JsonObject;
+    mutability: ToolMode;
+    command: string;
+}[];
+export declare function callMcpTool(name: string, args: JsonObject): CliResult<unknown>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/packages/mcp/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACL,KAAK,UAAU,EAkBhB,MAAM,kBAAkB,CAAC;AA6B1B,KAAK,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,kBAAkB,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,UAAU,CAAC;IACzB,UAAU,EAAE,QAAQ,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAoCF,eAAO,MAAM,QAAQ;UA1Cb,MAAM;iBACC,MAAM;iBACN,UAAU;kBACT,UAAU;gBACZ,QAAQ;aACX,MAAM;GAqCgF,CAAC;AAElG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CA8B9E"}

package/packages/mcp/dist/tools.js

@@ -0,0 +1,65 @@
+import { cliEnvelopeSchema, toolInputBase, matrixListInputSchema, useCaseUpsertInputSchema, useCaseRemoveInputSchema, evidenceRecordInputSchema, evidenceVoidInputSchema, planInputSchema, capsuleRunInputSchema, showcaseStartInputSchema, showcaseStatusInputSchema, showcaseObservationInputSchema, showcaseVerdictInputSchema, showcaseDecideInputSchema, showcaseFinishInputSchema, showcaseRequestApprovalInputSchema, hostDoctorInputSchema } from "./toolSchemas.js";
+import { boolArg, capsuleRun, doctorRoots, errorEnvelope, evidenceRecord, evidenceStatus, evidenceVoid, hostDoctor, isTrustedUserClaim, matrixList, matrixStatus, matrixValidate, mcpServerCommandExecutionEnabled, mcpServerWriteModeEnabled, numberArg, planPresentation, showcaseDecide, showcaseFinish, showcaseObservation, showcaseRequestApproval, showcaseStart, showcaseStatus, showcaseVerdict, useCaseRemove, useCaseUpsert } from "./toolHandlers.js";
+const toolDefinitions = [
+    tool("doctor_roots", "doctor.roots", "Inspect resolved use-cases roots.", "read", toolInputBase, doctorRoots),
+    tool("matrix_validate", "matrix.validate", "Validate use-case matrix files.", "read", toolInputBase, matrixValidate),
+    tool("matrix_list", "matrix.list", "List and filter use cases.", "read", matrixListInputSchema, matrixList),
+    tool("matrix_status", "matrix.status", "Summarize matrix and evidence status.", "read", toolInputBase, matrixStatus),
+    tool("use_case_upsert", "matrix.upsert", "Add or update one use-case entry. Requires allow_write=true.", "write", useCaseUpsertInputSchema, useCaseUpsert),
+    tool("use_case_remove", "matrix.remove", "Mark one use case removed. Requires allow_write=true.", "write", useCaseRemoveInputSchema, useCaseRemove),
+    tool("evidence_status", "evidence.status", "Replay evidence status.", "read", toolInputBase, evidenceStatus),
+    tool("evidence_record", "evidence.record", "Append an evidence record. Requires allow_write=true.", "write", evidenceRecordInputSchema, evidenceRecord),
+    tool("evidence_void", "evidence.void", "Void an active evidence record. Requires allow_write=true.", "write", evidenceVoidInputSchema, evidenceVoid),
+    tool("plan_showcase", "plan.showcase", "Generate a showcase plan.", "read", planInputSchema, (args) => planPresentation(args, "showcase")),
+    tool("plan_walkthrough", "plan.walkthrough", "Generate a walkthrough plan.", "read", planInputSchema, (args) => planPresentation(args, "walkthrough")),
+    tool("capsule_run", "capsule.run", "Run a persisted demo capsule. Requires allow_write=true.", "write", capsuleRunInputSchema, capsuleRun),
+    tool("showcase_start", "showcase.start", "Start an ad hoc showcase run. Requires allow_write=true.", "write", showcaseStartInputSchema, showcaseStart),
+    tool("showcase_status", "showcase.status", "Replay showcase run status.", "read", showcaseStatusInputSchema, showcaseStatus),
+    tool("showcase_record_observation", "showcase.record-observation", "Append a showcase observation. Requires allow_write=true.", "write", showcaseObservationInputSchema, showcaseObservation),
+    tool("showcase_record_verdict", "showcase.record-verdict", "Append a showcase verdict. Requires allow_write=true.", "write", showcaseVerdictInputSchema, showcaseVerdict),
+    tool("showcase_decide", "showcase.decide", "Append a failure decision. Requires allow_write=true.", "write", showcaseDecideInputSchema, showcaseDecide),
+    tool("showcase_finish", "showcase.finish", "Finish a showcase run. Requires allow_write=true.", "write", showcaseFinishInputSchema, showcaseFinish),
+    tool("showcase_request_approval", "showcase.request-approval", "Prepare CLI-mediated user approval instructions without appending approval.", "approval_request", showcaseRequestApprovalInputSchema, showcaseRequestApproval),
+    tool("host_doctor", "host.doctor", "Run read-only host profile/projection doctor checks.", "read", hostDoctorInputSchema, hostDoctor)
+];
+export const mcpTools = toolDefinitions.map(({ handler: _handler, ...descriptor }) => descriptor);
+export function callMcpTool(name, args) {
+    const definition = toolDefinitions.find((candidate) => candidate.name === name);
+    if (!definition) {
+        return errorEnvelope("mcp.unknown", "mcp.tool_unknown", `Unknown MCP tool '${name}'.`);
+    }
+    if (numberArg(args, "timeout_ms") === 0) {
+        return errorEnvelope(definition.command, "mcp.timeout", "MCP tool call timed out before execution.");
+    }
+    if (definition.mutability === "write" && args.allow_write !== true) {
+        return errorEnvelope(definition.command, "mcp.write_mode_required", "Write tools require allow_write=true.");
+    }
+    if (definition.mutability === "write" && !mcpServerWriteModeEnabled()) {
+        return errorEnvelope(definition.command, "mcp.server_write_mode_required", "MCP server was not started with write mode enabled.");
+    }
+    if (definition.name === "capsule_run" && boolArg(args, "execute_commands") && !mcpServerCommandExecutionEnabled()) {
+        return errorEnvelope(definition.command, "mcp.server_command_execution_mode_required", "MCP server was not started with command execution enabled.");
+    }
+    if (isTrustedUserClaim(args)) {
+        return errorEnvelope(definition.command, "mcp.trusted_confirmation_required", "MCP cannot claim a trusted user actor without host confirmation.");
+    }
+    try {
+        return definition.handler(args);
+    }
+    catch (error) {
+        const code = error instanceof Error && "code" in error ? String(error.code) : "internal_error";
+        return errorEnvelope(definition.command, code, error instanceof Error ? error.message : String(error));
+    }
+}
+function tool(name, command, description, mutability, inputSchema, handler) {
+    return {
+        name,
+        command,
+        description,
+        inputSchema,
+        outputSchema: cliEnvelopeSchema,
+        mutability,
+        handler
+    };
+}
+//# sourceMappingURL=tools.js.map

package/packages/mcp/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/packages/mcp/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@adammcarter/use-cases-mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "MCP server for @adammcarter/use-cases.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adammcarter/use-cases.git",
+    "directory": "packages/mcp"
+  },
+  "bin": {
+    "uc-mcp": "./dist/index.js",
+    "use-cases-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "private": true,
+  "dependencies": {
+    "@adammcarter/use-cases-core": "workspace:*"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --pretty false",
+    "prepublishOnly": "tsc -b"
+  }
+}

package/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "use-cases",
+  "version": "0.1.0",
+  "description": "Use-case, evidence, and live showcase infrastructure for agent work.",
+  "mcpServers": "./.mcp.json"
+}

package/schemas/v1/authority.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/authority.schema.json",
+  "title": "ucase-authority-v1",
+  "description": "CI-neutral provenance authority for a proof event. The trust model is CI-NEUTRAL: GitHub Actions is only the reference provider. This record captures WHO/WHERE produced a proof in a provider-agnostic shape (type + provider + best-effort repository/ref/commit/run_id/actor/event), auto-detected from CI env vars (see markers/ciAuthority.ts detectCiAuthority) or supplied explicitly via `prove --authority-file`. It is OPTIONAL on a proof event and ADDITIVE: it does not affect freshness (FRESH matches row/binding/context hashes, not provenance). When present it is built INTO the event before signing, so the signature covers it. `protected_ref` is a tri-state: true/false when the provider exposes an explicit protected-branch signal, and null when unknown.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "type": {
+      "enum": ["ci", "local"],
+      "description": "\"ci\" when produced inside a recognised CI provider; \"local\" otherwise."
+    },
+    "provider": {
+      "enum": ["github-actions", "gitlab-ci", "circleci", "generic"],
+      "description": "The CI provider. \"generic\" is the fallback for local runs or an unrecognised provider."
+    },
+    "repository": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Provider-shaped repository identifier (e.g. owner/repo)."
+    },
+    "ref": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The git ref / branch the run executed against."
+    },
+    "commit": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The commit SHA the run executed against."
+    },
+    "run_id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The provider's run / pipeline / build identifier."
+    },
+    "actor": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The user/login that triggered the run, when the provider exposes it."
+    },
+    "protected_ref": {
+      "type": ["boolean", "null"],
+      "description": "Whether the ref is a protected branch. true/false when the provider exposes an explicit signal; null when unknown."
+    },
+    "event": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The provider's triggering event name (e.g. push, pull_request, merge_request)."
+    }
+  },
+  "required": ["type", "provider"],
+  "examples": [
+    {
+      "type": "ci",
+      "provider": "github-actions",
+      "repository": "use-cases/use-cases",
+      "ref": "refs/heads/main",
+      "commit": "0123456789abcdef0123456789abcdef01234567",
+      "run_id": "1234567890",
+      "actor": "octocat",
+      "protected_ref": null,
+      "event": "push"
+    },
+    {
+      "type": "local",
+      "provider": "generic"
+    }
+  ]
+}

package/schemas/v1/cli-result.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://use-cases.dev/schemas/v1/cli-result.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": { "const": 1 },
+    "protocol_version": { "const": 1 },
+    "command": { "type": "string", "minLength": 1 },
+    "ok": { "type": "boolean" },
+    "complete": { "type": "boolean" },
+    "data": true,
+    "diagnostics": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/diagnostic" }
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "workspace_root": { "type": "string", "minLength": 1 },
+        "data_root": { "type": "string", "minLength": 1 },
+        "component_id": { "$ref": "common.schema.json#/$defs/id" },
+        "workspace_snapshot": { "$ref": "common.schema.json#/$defs/workspace_snapshot" }
+      },
+      "required": ["workspace_root", "data_root", "component_id", "workspace_snapshot"]
+    }
+  },
+  "required": ["schema_version", "protocol_version", "command", "ok", "complete", "data", "diagnostics", "context"]
+}