@bragi-gmbh/codebus 1.3.0 → 1.6.0

package/dist/mcp-correlation.js

@@ -0,0 +1,290 @@
+/**
+ * MCP Tool Correlation Handler — shared envelope and query functions for CLI/MCP parity.
+ *
+ * Implements com.bragi.contract.cli-mcp-parity (v0.5.0-proposed): CLI and MCP share
+ * one command core with identical schema, authorization, results, errors, and T-01
+ * correlation chain snapshots.
+ *
+ * Exports wrapper and query functions used by both CLI and MCP transports.
+ */
+import { CodebusError } from "./errors.js";
+/**
+ * Empty correlation chain: all fields null (used when context has no binding).
+ */
+export const EMPTY_CHAIN = {
+    jira_key: null,
+    plan_id: null,
+    stage_id: null,
+    child_id: null,
+    binding_id: null,
+    run_id: null,
+    pr: null,
+    receipt_id: null,
+    actor: null,
+    environment: null,
+};
+// ── Correlation Resolution ─────────────────────────────────────────────────
+/**
+ * Query the database to build a complete T-01 correlation chain.
+ *
+ * Given a binding_id OR run_id (external_run_id), join:
+ * - execution_bindings (external_run_id, dispatched_by_person, executor_agent_id, provenance)
+ * - plan_revisions → plans (plan_id, stage_id)
+ * - people / agents (actor resolution)
+ *
+ * Returns EMPTY_CHAIN if no binding exists (unbound run — T-02 checks separately).
+ * Exported for testing and use by both CLI and MCP handlers.
+ */
+export async function resolveCorrelation(ctx, partial) {
+    // Normalize null → undefined so the optional fields are truly optional
+    const normalized = {};
+    if (partial.binding_id != null)
+        normalized.binding_id = partial.binding_id;
+    if (partial.run_id != null)
+        normalized.run_id = partial.run_id;
+    // Start with provided fields (all undefined here so EMPTY_CHAIN is clean)
+    const chain = {
+        ...EMPTY_CHAIN,
+        binding_id: normalized.binding_id ?? null,
+        run_id: normalized.run_id ?? null,
+    };
+    // If neither binding_id nor run_id was supplied, return EMPTY_CHAIN.
+    if (!normalized.binding_id && !normalized.run_id) {
+        return EMPTY_CHAIN;
+    }
+    try {
+        let binding = null;
+        // Resolve binding by binding_id when available.
+        if (normalized.binding_id) {
+            const { data, error } = await ctx.supabase
+                .from("execution_bindings")
+                .select("id, plan_revision_id, stage_id, external_run_id, dispatched_by_person, executor_agent_id, provenance")
+                .eq("id", normalized.binding_id)
+                .single();
+            if (error || !data) {
+                // Binding not found or error — strip the caller-supplied binding_id
+                // so validateBinding cannot be fooled by an unbound/nonexistent id.
+                return { ...EMPTY_CHAIN, run_id: normalized.run_id ?? null };
+            }
+            binding = data;
+        }
+        else if (normalized.run_id) {
+            // run_id-only lookup: resolve via external_run_id column.
+            // The CLI advertises --run-id as a lookup that may resolve bindings.
+            const { data, error } = await ctx.supabase
+                .from("execution_bindings")
+                .select("id, plan_revision_id, stage_id, external_run_id, dispatched_by_person, executor_agent_id, provenance")
+                .eq("external_run_id", normalized.run_id)
+                .maybeSingle();
+            if (error || !data) {
+                // No binding for this run — return EMPTY_CHAIN with just the run_id
+                // preserved so callers know which run was queried.
+                return { ...EMPTY_CHAIN, run_id: normalized.run_id ?? null };
+            }
+            binding = data;
+        }
+        // binding is guaranteed non-null here — both branches return early on error
+        if (!binding) {
+            return { ...EMPTY_CHAIN, run_id: normalized.run_id ?? null };
+        }
+        // Resolve actor (GitHub login): try dispatched_by_person first, then executor_agent_id
+        let actor = chain.actor;
+        if (!actor) {
+            const dispatched = binding.dispatched_by_person;
+            const executor = binding.executor_agent_id;
+            if (dispatched) {
+                const { data: person } = await ctx.supabase
+                    .from("people")
+                    .select("github_login")
+                    .eq("id", dispatched)
+                    .single();
+                actor = person?.github_login || null;
+            }
+            else if (executor) {
+                const { data: agent } = await ctx.supabase
+                    .from("agents")
+                    .select("slug")
+                    .eq("id", executor)
+                    .single();
+                actor = agent?.slug || null;
+            }
+        }
+        // Fetch plan_revision → plan to resolve plan_id (stage_id lives on the binding)
+        let plan_id = chain.plan_id;
+        const stage_id = chain.stage_id || binding.stage_id || null;
+        const plan_revision_id = binding.plan_revision_id;
+        if (plan_revision_id && !plan_id) {
+            const { data: rev } = await ctx.supabase
+                .from("plan_revisions")
+                .select("plan_id")
+                .eq("id", plan_revision_id)
+                .single();
+            plan_id = rev?.plan_id || null;
+        }
+        // Extract environment and jira_key from provenance (if available)
+        const provenance = binding.provenance;
+        const environment = chain.environment || provenance?.environment || "dev";
+        const jira_key = chain.jira_key || provenance?.jira_key || null;
+        return {
+            jira_key,
+            plan_id: plan_id || chain.plan_id,
+            stage_id,
+            child_id: chain.child_id,
+            binding_id: binding.id,
+            run_id: binding.external_run_id || chain.run_id,
+            pr: chain.pr,
+            receipt_id: chain.receipt_id,
+            actor,
+            environment,
+        };
+    }
+    catch {
+        // On any error, return a clean EMPTY_CHAIN with only the run_id preserved
+        // (never the caller-supplied binding_id, which could be fabricated).
+        return { ...EMPTY_CHAIN, run_id: normalized.run_id ?? null };
+    }
+}
+// ── Handler Wrapper ─────────────────────────────────────────────────────────
+/**
+ * Wrap a command core to produce a parity envelope.
+ *
+ * Usage in CLI: call this wrapper, render result.schema.transport="cli"
+ * Usage in MCP: call this wrapper, return result.schema.transport="mcp"
+ *
+ * The wrapper:
+ * 1. Calls the core function
+ * 2. Catches CodebusError and non-CodebusError exceptions
+ * 3. Resolves correlation from context (if available)
+ * 4. Returns identical shape on both transports
+ *
+ * @param coreFn — async function that takes (ctx, args) and returns result | throws CodebusError
+ */
+export async function withCorrelation(coreFn, ctx, args, opts = {
+    transport: "cli",
+}) {
+    const errors = [];
+    let result = null;
+    let auth = { authenticated: true, authorized: true };
+    try {
+        // Call the core function
+        result = await coreFn(ctx, args);
+    }
+    catch (err) {
+        // Catch errors and normalize to parity shape
+        if (err instanceof CodebusError) {
+            errors.push({
+                code: err.code || "CodebusError",
+                message: err.message,
+                details: err.details,
+            });
+            auth = { authenticated: err.code !== "AUTH_REQUIRED", authorized: err.code !== "FORBIDDEN" };
+        }
+        else {
+            const message = err instanceof Error ? err.message : String(err);
+            errors.push({
+                code: "UnknownError",
+                message,
+            });
+            auth = { authenticated: false, authorized: false };
+        }
+    }
+    // Resolve correlation chain. Thread query params (binding_id, run_id) from
+    // args into resolveCorrelation so the envelope carries the full chain.
+    // Normalize null → undefined because resolveCorrelation's type uses
+    // string | null only on the partial, never on the result.
+    const fromArgs = {};
+    if (args && typeof args === "object") {
+        const b = args.binding_id ?? args.bindingId;
+        const r = args.run_id ?? args.runId;
+        if (typeof b === "string")
+            fromArgs.binding_id = b;
+        if (typeof r === "string")
+            fromArgs.run_id = r;
+    }
+    const correlation = await resolveCorrelation(ctx, {
+        ...fromArgs,
+        ...(opts.correlationPartial
+            ? {
+                binding_id: opts.correlationPartial.binding_id ?? undefined,
+                run_id: opts.correlationPartial.run_id ?? undefined,
+            }
+            : {}),
+    });
+    return {
+        schema: { version: "0.5.0-proposed", transport: opts.transport },
+        auth,
+        result,
+        errors,
+        correlation,
+    };
+}
+// ── Parity Assertions (for testing) ─────────────────────────────────────────
+/**
+ * Deep-compare two parity envelopes for test fixture validation.
+ * Exported for use in test suite (positive fixture: equal_schema_auth_result_errors_and_full_chain).
+ *
+ * Returns { equal: boolean; diffs: string[] } where diffs lists what diverged.
+ * Used to ensure CLI and MCP outputs match byte-for-byte (transport field aside).
+ */
+export function assertParity(cliEnvelope, mcpEnvelope) {
+    const diffs = [];
+    // Schema version must match (transport differs by design)
+    if (cliEnvelope.schema.version !== mcpEnvelope.schema.version) {
+        diffs.push(`schema.version: "${cliEnvelope.schema.version}" vs "${mcpEnvelope.schema.version}"`);
+    }
+    // Auth must match
+    if (cliEnvelope.auth.authenticated !== mcpEnvelope.auth.authenticated) {
+        diffs.push(`auth.authenticated: ${cliEnvelope.auth.authenticated} vs ${mcpEnvelope.auth.authenticated}`);
+    }
+    if (cliEnvelope.auth.authorized !== mcpEnvelope.auth.authorized) {
+        diffs.push(`auth.authorized: ${cliEnvelope.auth.authorized} vs ${mcpEnvelope.auth.authorized}`);
+    }
+    // Result must match (deep JSON compare)
+    const cliResultJson = JSON.stringify(cliEnvelope.result, null, 0);
+    const mcpResultJson = JSON.stringify(mcpEnvelope.result, null, 0);
+    if (cliResultJson !== mcpResultJson) {
+        diffs.push(`result: CLI and MCP diverged\n  CLI: ${cliResultJson.slice(0, 100)}...\n  MCP: ${mcpResultJson.slice(0, 100)}...`);
+    }
+    // Errors must match
+    const cliErrorsJson = JSON.stringify(cliEnvelope.errors);
+    const mcpErrorsJson = JSON.stringify(mcpEnvelope.errors);
+    if (cliErrorsJson !== mcpErrorsJson) {
+        diffs.push(`errors: ${cliErrorsJson} vs ${mcpErrorsJson}`);
+    }
+    // Correlation chain must match exactly (full_chain fixture)
+    const cliChainJson = JSON.stringify(cliEnvelope.correlation);
+    const mcpChainJson = JSON.stringify(mcpEnvelope.correlation);
+    if (cliChainJson !== mcpChainJson) {
+        diffs.push(`correlation: ${cliChainJson} vs ${mcpChainJson}`);
+    }
+    return { equal: diffs.length === 0, diffs };
+}
+/**
+ * Validate that a correlation chain has no null bindings (T-02 check for spend-bearing work).
+ * Exported for use in command handlers that require binding.
+ *
+ * Returns { valid: boolean; reason?: string }
+ */
+export function validateBinding(chain, requireFull = false) {
+    // T-02: spend-bearing work requires binding_id
+    if (!chain.binding_id) {
+        return {
+            valid: false,
+            reason: "T-02: spend-bearing execution requires a binding (CodeBus plan/stage/child/run context). Use 'codebus do' with --binding flag, or dispatch via run-plan.sh --binding.",
+        };
+    }
+    // Optional: full chain validation (all T-01 fields populated)
+    if (requireFull) {
+        const nullFields = Object.entries(chain)
+            .filter(([, v]) => v === null)
+            .map(([k]) => k);
+        if (nullFields.length > 0) {
+            return {
+                valid: false,
+                reason: `full chain required but missing: ${nullFields.join(", ")}`,
+            };
+        }
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=mcp-correlation.js.map

package/dist/mcp-correlation.js.map

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

package/dist/mcp-factory-context-read.js

@@ -0,0 +1,81 @@
+/**
+ * MCP tool registration for factory-context-read.
+ *
+ * Shared core with CLI (A5: one command, two adapters).
+ * Tool schema and handler must be identical to CLI (parity contract).
+ *
+ * Imports from mcp-registry.ts; registration pushed to TOOL_REGISTRY.
+ */
+import { factoryContextReadCore } from "./commands/factory-context-read.js";
+import { makeCtx } from "./client.js";
+import { resolveConfig } from "./config.js";
+import { CodebusError } from "./errors.js";
+/**
+ * MCP handler for factory_context_read tool.
+ * Validates args (identical to CLI), calls shared core, returns JSON result.
+ *
+ * Errors: thrown as CodebusError before I/O (same as CLI path, parity contract).
+ *
+ * @param args MCP tool arguments {contentType?, repoSlug?}
+ * @returns factory context read result (identical to CLI result)
+ */
+export async function factoryContextReadHandler(args) {
+    // Validate and coerce args (same checks as CLI --type)
+    const contentType = args?.contentType || "taxonomy";
+    const repoSlug = args?.repoSlug;
+    // Validate content type (must match CLI allowed values, identical error)
+    const validTypes = [
+        "taxonomy",
+        "contracts",
+        "adrs",
+        "specs",
+        "knowledge",
+        "repositories",
+        "graphs",
+        "configuration",
+    ];
+    if (!validTypes.includes(contentType)) {
+        throw new CodebusError(`Invalid contentType '${contentType}'. Allowed: ${validTypes.join(", ")}`);
+    }
+    // Fix #6: graphs query REQUIRES repoSlug — enforce even when omitted (matches CLI)
+    if (contentType === "graphs" && !repoSlug) {
+        throw new CodebusError("repoSlug is required for 'graphs' query");
+    }
+    // Validate repoSlug: must be non-empty string when provided
+    if (repoSlug !== undefined && (typeof repoSlug !== "string" || repoSlug.trim().length === 0)) {
+        throw new CodebusError("repoSlug must be a non-empty string or undefined");
+    }
+    // Call shared core (identical to CLI handler)
+    const ctx = await makeCtx(resolveConfig({}));
+    return factoryContextReadCore(ctx, contentType, repoSlug);
+}
+/**
+ * Tool definition for MCP registry (TOOL_REGISTRY in mcp-registry.ts).
+ * Schema must be identical to CLI help + command signature (parity contract).
+ */
+export const FACTORY_CONTEXT_READ_TOOL = {
+    name: "factory_context_read",
+    description: "Read versioned Factory context (taxonomy, contracts, ADRs, specs, knowledge, repos, graphs, configuration). " +
+        "All reads are authenticated (RLS-scoped), versioned, and reject direct-database or local-copy sources. " +
+        "Bounded non-authoritative cache is permitted (via factory-read-cache). " +
+        "Optional 'repoSlug' filters repositories/graphs queries. " +
+        "Pretest fixture: identical_version_schema_auth_result_and_errors.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            contentType: {
+                type: "string",
+                enum: ["taxonomy", "contracts", "adrs", "specs", "knowledge", "repositories", "graphs", "configuration"],
+                description: "Content type to read (default: taxonomy). " +
+                    "repositories/graphs accept optional repoSlug.",
+            },
+            repoSlug: {
+                type: "string",
+                description: "Optional repo slug for repositories/graphs queries (required for graphs).",
+            },
+        },
+        required: [], // contentType defaults to "taxonomy", repoSlug is optional
+    },
+    handler: factoryContextReadHandler,
+};
+//# sourceMappingURL=mcp-factory-context-read.js.map

package/dist/mcp-factory-context-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-factory-context-read.js","sourceRoot":"","sources":["../src/mcp-factory-context-read.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,sBAAsB,EAA0D,MAAM,oCAAoC,CAAC;AACpI,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAA6B;IAC3E,uDAAuD;IACvD,MAAM,WAAW,GAAI,IAAI,EAAE,WAAsB,IAAI,UAAU,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,EAAE,QAA8B,CAAC;IAEtD,yEAAyE;IACzE,MAAM,UAAU,GAAyB;QACvC,UAAU;QACV,WAAW;QACX,MAAM;QACN,OAAO;QACP,WAAW;QACX,cAAc;QACd,QAAQ;QACR,eAAe;KAChB,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,WAAiC,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,YAAY,CAAC,wBAAwB,WAAW,eAAe,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpG,CAAC;IAED,mFAAmF;IACnF,IAAI,WAAW,KAAK,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,YAAY,CAAC,yCAAyC,CAAC,CAAC;IACpE,CAAC;IACD,4DAA4D;IAC5D,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC7F,MAAM,IAAI,YAAY,CAAC,kDAAkD,CAAC,CAAC;IAC7E,CAAC;IAED,8CAA8C;IAC9C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO,sBAAsB,CAAC,GAAG,EAAE,WAAiC,EAAE,QAAQ,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,8GAA8G;QAC9G,yGAAyG;QACzG,yEAAyE;QACzE,2DAA2D;QAC3D,mEAAmE;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,CAAC;gBACxG,WAAW,EACT,4CAA4C;oBAC5C,+CAA+C;aAClD;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2EAA2E;aACzF;SACF;QACD,QAAQ,EAAE,EAAc,EAAE,2DAA2D;KACtF;IACD,OAAO,EAAE,yBAAyB;CACnC,CAAC"}

package/dist/mcp-registry.js

@@ -19,11 +19,17 @@ import { createQuestionCore, answerQuestionCore } from "./commands/question.js";
 import { createTaskCore, claimTaskCore, completeTaskCore } from "./commands/task.js";
 import { createDecisionCore, acceptDecisionCore } from "./commands/decision.js";
 import { sendMessageCore } from "./commands/send.js";
-import { planRollupCore, planDeliveryCore } from "./commands/plan.js";
+import { planRollupCore, planDeliveryCore, planObjectListCore, planObjectShowCore, planObjectWhoCore, planObjectStuckCore, planCapsShowCore, planCapsProposeCore } from "./commands/plan.js";
+import { listKnowledgeCore, showKnowledgeCore } from "./commands/knowledge.js";
+import { makeExecutionClient, factoryRunStatusCore, factoryRunEventsCore } from "./commands/factory.js";
 import { endSessionCore } from "./commands/session.js";
 import { compilePackCore } from "./commands/pack.js";
 import { resolveRefsCore } from "./commands/refs.js";
+import { addDocCore, getDocCore } from "./commands/doc.js";
 import { CodebusError } from "./errors.js";
+import { correlationQueryCore } from "./commands/cli-mcp-correlation.js";
+import { withCorrelation } from "./mcp-correlation.js";
+import { FACTORY_CONTEXT_READ_TOOL } from "./mcp-factory-context-read.js";
 // This module builds the tool registry only — it never touches stdio or a
 // transport, so importing it has zero side effects on the process (no server
 // boot). That is what lets install.ts import TOOL_REGISTRY to DERIVE the
@@ -856,4 +862,199 @@ TOOL_REGISTRY.push({
     },
     handler: resolveRefsHandler,
 });
+// ── doc_add / doc_get (shared documents, 0087) ─────────────────────────────
+// One shared core, dumb clients: these wrap doc.ts's addDocCore/getDocCore —
+// the same cores `codebus doc add|get` use — so CLI and MCP cannot diverge on
+// validation or shape. Server-side, artifact_add (0087) is the write
+// boundary: membership gate, producer pinned to the caller, 2 MiB cap, kind
+// vocabulary — the tool surfaces its typed errors verbatim.
+async function docAddHandler(args) {
+    const title = args?.title || "";
+    const body = args?.body || "";
+    if (!title)
+        throw new CodebusError("'title' parameter is required");
+    if (!body)
+        throw new CodebusError("'body' parameter is required");
+    const ctx = await makeCtx(resolveConfig({}));
+    const result = await addDocCore(ctx, { title, body, kind: args?.kind });
+    return { display_id: result.display_id, kind: result.kind, title: result.title };
+}
+async function docGetHandler(args) {
+    const id = args?.id || "";
+    if (!id)
+        throw new CodebusError("'id' parameter is required");
+    const ctx = await makeCtx(resolveConfig({}));
+    const doc = await getDocCore(ctx, id);
+    return {
+        display_id: doc.display_id,
+        kind: doc.kind,
+        title: doc.title,
+        producer: doc.producer,
+        created_at: doc.created_at,
+        body: doc.body,
+    };
+}
+TOOL_REGISTRY.push({
+    name: "doc_add",
+    description: "Store a shared text document on the bus (everyone in the workspace sees the same content). " +
+        "Returns its CB-DOC-… display_id, which any message or task can cite as evidence via refs " +
+        "(send_message ref 'CB-DOC-…'). Text only, ≤ 2 MiB. Kinds: note|doc|spec|plan|review|deck.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            title: {
+                type: "string",
+                description: "Document title (required)",
+            },
+            body: {
+                type: "string",
+                description: "Full document text, UTF-8, ≤ 2 MiB (required)",
+            },
+            kind: {
+                type: "string",
+                description: "Document kind: note|doc|spec|plan|review|deck (default: doc)",
+            },
+        },
+        required: ["title", "body"],
+    },
+    handler: docAddHandler,
+});
+TOOL_REGISTRY.push({
+    name: "doc_get",
+    description: "Fetch a shared document by its CB-DOC-… display_id (or uuid). Returns title, kind, " +
+        "producer (person-resolved), created_at, and the full body. Read-only.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "string",
+                description: "Document display_id (CB-DOC-…) or uuid",
+            },
+        },
+        required: ["id"],
+    },
+    handler: docGetHandler,
+});
+// ── planning, knowledge, digest, and factory read surfaces (F14) ───────────
+function requiredArg(args, name) {
+    const value = typeof args?.[name] === "string" ? args[name].trim() : "";
+    if (!value)
+        throw new CodebusError(`'${name}' parameter is required`);
+    return value;
+}
+async function readSurfaceHandler(surface, args) {
+    if (surface === "factory_run_status" || surface === "factory_run_events") {
+        const runId = requiredArg(args, "run_id");
+        const client = makeExecutionClient();
+        return surface === "factory_run_status"
+            ? factoryRunStatusCore(client, runId)
+            : factoryRunEventsCore(client, runId);
+    }
+    if (surface === "plan_show") {
+        const plan = requiredArg(args, "plan");
+        return planObjectShowCore(await makeCtx(resolveConfig({})), plan);
+    }
+    if (surface === "knowledge_show") {
+        const id = requiredArg(args, "id");
+        return showKnowledgeCore(await makeCtx(resolveConfig({})), id);
+    }
+    const ctx = await makeCtx(resolveConfig({}));
+    if (surface === "plan_list")
+        return planObjectListCore(ctx);
+    if (surface === "plan_who")
+        return planObjectWhoCore(ctx);
+    if (surface === "plan_stuck")
+        return planObjectStuckCore(ctx);
+    if (surface === "knowledge_list")
+        return listKnowledgeCore(ctx, { state: args?.state, kind: args?.kind });
+    return fetchAndCacheDigest(ctx);
+}
+const readTool = (name, description, properties, handler, required = []) => {
+    TOOL_REGISTRY.push({ name, description, inputSchema: { type: "object", properties, required }, handler });
+};
+const handlerFor = (surface) => readSurfaceHandler.bind(null, surface);
+readTool("plan_list", "List plans visible in the current workspace. Read-only.", {}, handlerFor("plan_list"));
+readTool("plan_show", "Show one visible plan by display ID or UUID. Read-only.", { plan: { type: "string", description: "Plan display ID (CB-PLAN-...) or UUID" } }, handlerFor("plan_show"), ["plan"]);
+readTool("plan_who", "List current plan assignments visible in the workspace. Read-only.", {}, handlerFor("plan_who"));
+readTool("plan_stuck", "List plans currently stuck according to the plan projection. Read-only.", {}, handlerFor("plan_stuck"));
+readTool("knowledge_list", "List knowledge items, optionally filtered by state or kind. Read-only.", {
+    state: { type: "string", enum: ["proposed", "reviewed", "ratified", "deprecated"] },
+    kind: { type: "string", enum: ["taxonomy", "contract", "principle", "adr"] },
+}, handlerFor("knowledge_list"));
+readTool("knowledge_show", "Show a knowledge item, its revisions, and transitions. Read-only.", { id: { type: "string" } }, handlerFor("knowledge_show"), ["id"]);
+readTool("digest", "Fetch and cache the current deterministic attention digest. Read-only.", {}, handlerFor("digest"));
+readTool("factory_run_status", "Get deployed factory status for a run. Read-only.", { run_id: { type: "string" } }, handlerFor("factory_run_status"), ["run_id"]);
+readTool("factory_run_events", "Get deployed factory events for a run as JSON objects. Read-only.", { run_id: { type: "string" } }, handlerFor("factory_run_events"), ["run_id"]);
+// ── factory_context_read (Phase 2: CLI/MCP parity read surface) ───────────────
+TOOL_REGISTRY.push(FACTORY_CONTEXT_READ_TOOL);
+// ── plan admission caps (owner decisions, migration 0111) ──────────────────
+readTool("plan_caps_show", "Show effective plan admission caps: the latest approved plan-caps decision, or the defaults (150 USD, 12 stages). Read-only.", { plan: { type: "string", description: "Optional plan display ID (CB-PLAN-…) or UUID; omit for workspace-level caps" } }, async (args) => planCapsShowCore(await makeCtx(resolveConfig({})), typeof args?.plan === "string" && args.plan.trim() ? args.plan.trim() : undefined));
+TOOL_REGISTRY.push({
+    name: "plan_caps_propose",
+    description: "Propose new plan admission caps as a PENDING plan-caps decision. " +
+        "Approval stays an owner action (decision_accept); until accepted, the defaults or the previous decision remain effective.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            max_budget_usd: { type: "number", description: "Maximum plan budget in USD (> 0)" },
+            max_stages: { type: "integer", description: "Maximum number of normal stages (>= 1)" },
+            max_children_per_stage: { type: "integer", description: "Maximum dependent stages per stage (>= 1)" },
+            applies_to: { type: "string", description: "'all' (default) or a plan UUID in the workspace" },
+            expires_at: { type: "string", description: "Optional ISO timestamp after which the caps lapse" },
+        },
+    },
+    handler: async (args) => {
+        const num = (value) => value == null ? undefined : typeof value === "number" && Number.isFinite(value) ? value : (() => { throw new CodebusError("caps fields must be numbers"); })();
+        return planCapsProposeCore(await makeCtx(resolveConfig({})), {
+            maxBudgetUsd: num(args?.max_budget_usd),
+            maxStages: num(args?.max_stages),
+            maxChildrenPerStage: num(args?.max_children_per_stage),
+            appliesTo: typeof args?.applies_to === "string" && args.applies_to.trim() ? args.applies_to.trim() : undefined,
+            expiresAt: typeof args?.expires_at === "string" && args.expires_at.trim() ? args.expires_at.trim() : undefined,
+        });
+    },
+});
+// ── correlation_query (shared command core, ADR 0007) ────────────────────────
+// One command core (correlationQueryCore) feeds both the CLI command
+// (registerCorrelationCommand) and this MCP tool, satisfying the
+// com.bragi.contract.cli-mcp-parity contract: schema, authorization,
+// results, errors, and T-01 correlation snapshots match between transports.
+TOOL_REGISTRY.push({
+    name: "correlation_query",
+    description: "Query the T-01 correlation chain (Jira → Plan → Stage → Child → Binding → Run → PR → Receipt) " +
+        "for a given binding ID or run ID. Returns a parity envelope with schema version, auth, result, " +
+        "errors, and the full correlation chain — identical to `codebus correlation --json` on the CLI. " +
+        "Requires either binding_id or run_id; --require-binding enforces T-02 (spend-bearing work must " +
+        "have a binding). Read-only.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            binding_id: { type: "string", description: "Binding UUID to look up (optional; one of binding_id or run_id required)" },
+            run_id: { type: "string", description: "Run ID to look up via external_run_id (optional; one of binding_id or run_id required)" },
+            require_binding: { type: "boolean", description: "Fail if no binding exists (T-02)" },
+            require_full: { type: "boolean", description: "Fail if any chain field is null" },
+        },
+        required: [],
+    },
+    handler: async (args) => {
+        const ctx = await makeCtx(resolveConfig({}));
+        const bindingId = args?.binding_id;
+        const runId = args?.run_id;
+        const requireBinding = args?.require_binding;
+        const requireFull = args?.require_full;
+        const envelope = await withCorrelation((c) => correlationQueryCore(c, {
+            bindingId,
+            runId,
+            requireBinding,
+            requireFull,
+        }), ctx, { bindingId, runId, requireBinding, requireFull }, {
+            transport: "mcp",
+            correlationPartial: {
+                binding_id: bindingId,
+                run_id: runId,
+            },
+        });
+        return envelope;
+    },
+});
 //# sourceMappingURL=mcp-registry.js.map