@adammcarter/use-cases 0.1.0

package/packages/mcp/dist/resources.js

@@ -0,0 +1,342 @@
+// MCP resources: READ-ONLY views of Use Cases workspace state (MCP 2025-11-25).
+//
+// Each resource reuses the same read-only cores the CLI/tools wrap and returns
+// the SAME structured JSON. Resources NEVER mutate, run verifiers, or mint
+// proofs. A repo-scoped resource resolves its workspace from a `?repo=` query
+// segment on the URI, or the server's configured default
+// (UCM_MCP_REPO). The repo is bound, symlink-safe, to an allowed
+// root (the configured default, else the server cwd); a traversal path is
+// rejected before any disk read. Schema resources need no repo.
+import { join, resolve } from "node:path";
+const { UseCasesPluginError, createCliResult, getPublicSchemas, loadUseCaseMatrix, prepareScan, queryUseCases, replayEvidence, resolveContainedPath, resolveWorkspaceContext, runScanCommand, runValidateLedgerCommand, toEvidenceStatusResult, toMatrixListResult, toMatrixValidationResult } = await loadUcmCore();
+async function loadUcmCore() {
+    try {
+        return await import("@adammcarter/use-cases-core");
+    }
+    catch (error) {
+        if (!isMissingCorePackage(error)) {
+            throw error;
+        }
+        const bundledCoreSpecifier = "../../core/dist/index.js";
+        return await import(bundledCoreSpecifier);
+    }
+}
+function isMissingCorePackage(error) {
+    return error instanceof Error && "code" in error && error.code === "ERR_MODULE_NOT_FOUND" && error.message.includes("@adammcarter/use-cases-core");
+}
+const JSON_MIME = "application/json";
+// JSON-RPC error codes (MCP 2025-11-25): -32602 invalid params, -32002 resource
+// not found. Used so the index handler can map a failed read to a JSON-RPC error.
+const INVALID_PARAMS = -32602;
+const RESOURCE_NOT_FOUND = -32002;
+export const mcpResources = [
+    {
+        uri: "uc://matrix",
+        name: "Use cases",
+        description: "Matrix validation result plus the full list of use cases (read-only). Add ?repo=<path> or configure UCM_MCP_REPO.",
+        mimeType: JSON_MIME
+    },
+    {
+        uri: "uc://matrix/status",
+        name: "Matrix + evidence status",
+        description: "Combined matrix validation and evidence assurance status (read-only).",
+        mimeType: JSON_MIME
+    },
+    {
+        uri: "uc://freshness",
+        name: "Marker freshness status",
+        description: "Read-only freshness scan (marker bindings vs proofs) — the same status `uc scan` emits. Never runs verifiers.",
+        mimeType: JSON_MIME
+    },
+    {
+        uri: "uc://bindings",
+        name: "Marker binding registry",
+        description: "The materialized append-only binding registry (row id -> binding slugs), read-only.",
+        mimeType: JSON_MIME
+    },
+    {
+        uri: "uc://ledger",
+        name: "Proof ledger validation",
+        description: "Read-only validate-ledger summary: evidence/registry integrity, append-only discipline, and hash-chain status.",
+        mimeType: JSON_MIME
+    },
+    {
+        uri: "uc://evidence",
+        name: "Evidence assurance status",
+        description: "Replayed evidence assurance status for the matrix (read-only).",
+        mimeType: JSON_MIME
+    },
+    {
+        uri: "uc://schemas",
+        name: "Public schema index",
+        description: "Index of public Use Cases JSON schemas. Read an individual schema at uc://schemas/{name} (e.g. uc://schemas/common.schema.json). No repo required.",
+        mimeType: JSON_MIME
+    },
+    {
+        uri: "uc://config",
+        name: "Resolved workspace config",
+        description: "Resolved workspace roots and config provenance for a repo (read-only).",
+        mimeType: JSON_MIME
+    }
+];
+export function listMcpResources() {
+    return mcpResources;
+}
+export function readMcpResource(uri) {
+    const parsed = parseUcmUri(uri);
+    if (!parsed) {
+        return { ok: false, code: RESOURCE_NOT_FOUND, message: `Unknown resource: ${uri}` };
+    }
+    // Schema resources need no repo.
+    if (parsed.key === "schemas") {
+        return contents(uri, schemasIndex());
+    }
+    if (parsed.key.startsWith("schemas/")) {
+        const name = parsed.key.slice("schemas/".length);
+        const found = findSchema(name);
+        if (!found) {
+            return { ok: false, code: RESOURCE_NOT_FOUND, message: `Unknown schema: ${name}` };
+        }
+        return contents(uri, { id: found.id, schema: found.schema });
+    }
+    // Every other resource is repo-scoped.
+    const resolved = resolveResourceContext(parsed.repo);
+    if ("error" in resolved) {
+        return resolved.error;
+    }
+    const context = resolved.context;
+    switch (parsed.key) {
+        case "matrix":
+            return contents(uri, matrixView(context));
+        case "matrix/status":
+            return contents(uri, matrixStatusView(context));
+        case "freshness":
+            return contents(uri, freshnessView(context));
+        case "bindings":
+            return contents(uri, bindingsView(context));
+        case "ledger":
+            return contents(uri, ledgerView(context));
+        case "evidence":
+            return contents(uri, evidenceView(context));
+        case "config":
+            return contents(uri, configView(context));
+        default:
+            return { ok: false, code: RESOURCE_NOT_FOUND, message: `Unknown resource: ${uri}` };
+    }
+}
+function parseUcmUri(uri) {
+    let url;
+    try {
+        url = new URL(uri);
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== "uc:") {
+        return null;
+    }
+    const host = url.hostname;
+    const path = url.pathname.replace(/^\/+/, "").replace(/\/+$/, "");
+    const key = path ? `${host}/${path}` : host;
+    return { key, repo: url.searchParams.get("repo") };
+}
+function resolveResourceContext(repoFromUri) {
+    const repoValue = repoFromUri ?? defaultRepo();
+    if (!repoValue) {
+        return {
+            error: {
+                ok: false,
+                code: INVALID_PARAMS,
+                message: "This resource requires a repo: add ?repo=<path> to the URI or set UCM_MCP_REPO."
+            }
+        };
+    }
+    let workspaceRoot;
+    try {
+        workspaceRoot = resolveContainedPath(allowedRepoRoot(), repoValue, "repo escapes the allowed workspace root boundary.");
+    }
+    catch (error) {
+        if (error instanceof UseCasesPluginError && error.code === "path.escape") {
+            return { error: { ok: false, code: INVALID_PARAMS, message: `UCM_PATH_ESCAPE: ${error.message}` } };
+        }
+        throw error;
+    }
+    return { context: resolveWorkspaceContext({ workspaceRoot }) };
+}
+function allowedRepoRoot() {
+    const configured = process.env.UCM_MCP_REPO;
+    return configured && configured.length > 0 ? resolve(configured) : process.cwd();
+}
+function defaultRepo() {
+    const configured = process.env.UCM_MCP_REPO;
+    return configured && configured.length > 0 ? configured : null;
+}
+function markerPaths(context) {
+    return {
+        productRoot: context.workspace_root,
+        bindingsPath: join(context.data_root, ".use-cases", "bindings.jsonl"),
+        evidencePath: join(context.data_root, ".use-cases", "proofs.jsonl")
+    };
+}
+// No proof-signing key is configured for read-only views, mirroring the CLI
+// default (`uc scan` / `uc validate-ledger` without --public-key).
+function noKeyResolver() {
+    return undefined;
+}
+function matrixView(context) {
+    const snapshot = loadUseCaseMatrix({ context });
+    const all = queryUseCases(snapshot, {});
+    return createCliResult("matrix.validate", {
+        schema_version: 1,
+        validation: toMatrixValidationResult(snapshot),
+        list: toMatrixListResult(snapshot, all)
+    }, {
+        ok: true,
+        complete: snapshot.complete,
+        diagnostics: snapshot.diagnostics,
+        workspaceRoot: context.workspace_root,
+        dataRoot: context.data_root,
+        componentId: context.component_id
+    });
+}
+function matrixStatusView(context) {
+    const matrix = loadUseCaseMatrix({ context });
+    const evidence = replayEvidence({ context });
+    const complete = matrix.complete && evidence.complete;
+    return createCliResult("matrix.status", {
+        schema_version: 1,
+        complete,
+        matrix: toMatrixValidationResult(matrix),
+        evidence: toEvidenceStatusResult(evidence)
+    }, {
+        ok: complete,
+        complete,
+        diagnostics: [...matrix.diagnostics, ...evidence.diagnostics],
+        workspaceRoot: context.workspace_root,
+        dataRoot: context.data_root,
+        componentId: context.component_id
+    });
+}
+function freshnessView(context) {
+    const paths = markerPaths(context);
+    const result = runScanCommand({
+        context,
+        productRoot: paths.productRoot,
+        bindingsPath: paths.bindingsPath,
+        evidencePath: paths.evidencePath,
+        policyMode: "feature",
+        publicKeyResolver: noKeyResolver,
+        generatedAt: new Date().toISOString(),
+        repoCwd: context.workspace_root
+    });
+    return createCliResult("markers.scan", result, {
+        ok: result.exit_code === 0,
+        complete: result.exit_code === 0,
+        workspaceRoot: context.workspace_root,
+        dataRoot: context.data_root,
+        componentId: context.component_id
+    });
+}
+function bindingsView(context) {
+    const paths = markerPaths(context);
+    const prepared = prepareScan({
+        context,
+        productRoot: paths.productRoot,
+        bindingsPath: paths.bindingsPath,
+        evidencePath: paths.evidencePath,
+        policyMode: "feature",
+        publicKeyResolver: noKeyResolver,
+        generatedAt: new Date().toISOString(),
+        repoCwd: context.workspace_root
+    });
+    const rows = [...prepared.registry.rowToSlugs.entries()]
+        .map(([row_id, slugs]) => ({ row_id, binding_slugs: [...slugs].sort() }))
+        .sort((a, b) => a.row_id.localeCompare(b.row_id));
+    const slugs = [...prepared.registry.slugToRow.entries()]
+        .map(([slug, row_id]) => ({ slug, row_id }))
+        .sort((a, b) => a.slug.localeCompare(b.slug));
+    const registryValid = prepared.registryErrors.length === 0;
+    return createCliResult("markers.bindings", {
+        schema_version: 1,
+        registry_valid: registryValid,
+        rows,
+        slugs,
+        registry_errors: prepared.registryErrors
+    }, {
+        ok: registryValid,
+        complete: registryValid,
+        workspaceRoot: context.workspace_root,
+        dataRoot: context.data_root,
+        componentId: context.component_id
+    });
+}
+function ledgerView(context) {
+    const paths = markerPaths(context);
+    const result = runValidateLedgerCommand({
+        context,
+        evidencePath: paths.evidencePath,
+        bindingsPath: paths.bindingsPath,
+        publicKeyResolver: noKeyResolver,
+        repoCwd: context.workspace_root
+    });
+    return createCliResult("markers.validate-ledger", result, {
+        ok: result.ok,
+        complete: result.ok,
+        workspaceRoot: context.workspace_root,
+        dataRoot: context.data_root,
+        componentId: context.component_id
+    });
+}
+function evidenceView(context) {
+    const snapshot = replayEvidence({ context });
+    return createCliResult("evidence.status", toEvidenceStatusResult(snapshot), {
+        ok: snapshot.complete,
+        complete: snapshot.complete,
+        diagnostics: snapshot.diagnostics,
+        workspaceRoot: context.workspace_root,
+        dataRoot: context.data_root,
+        componentId: context.component_id
+    });
+}
+function configView(context) {
+    return createCliResult("doctor.roots", {
+        schema_version: 1,
+        workspace_root: context.workspace_root,
+        data_root: context.data_root,
+        use_cases_root: context.use_cases_root,
+        component_id: context.component_id,
+        config_path: context.config_path,
+        provenance: context.provenance
+    }, {
+        ok: true,
+        complete: true,
+        diagnostics: context.diagnostics,
+        workspaceRoot: context.workspace_root,
+        dataRoot: context.data_root,
+        componentId: context.component_id
+    });
+}
+function schemasIndex() {
+    return {
+        schema_version: 1,
+        schemas: getPublicSchemas().map(({ id }) => ({
+            id,
+            name: id.split("/").pop() ?? id,
+            uri: `uc://schemas/${id.split("/").pop() ?? id}`
+        }))
+    };
+}
+function findSchema(name) {
+    return getPublicSchemas().find(({ id }) => {
+        const base = id.split("/").pop() ?? id;
+        const short = base.replace(/\.schema\.json$/, "");
+        return id === name || base === name || short === name;
+    });
+}
+function contents(uri, payload) {
+    return {
+        ok: true,
+        contents: [{ uri, mimeType: JSON_MIME, text: JSON.stringify(payload) }]
+    };
+}
+//# sourceMappingURL=resources.js.map

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

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

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

@@ -0,0 +1,28 @@
+import type { CliResult } from "@adammcarter/use-cases-core";
+import type { JsonObject } from "./toolSchemas.js";
+export declare function doctorRoots(args: JsonObject): CliResult<unknown>;
+export declare function matrixValidate(args: JsonObject): CliResult<unknown>;
+export declare function matrixList(args: JsonObject): CliResult<unknown>;
+export declare function matrixStatus(args: JsonObject): CliResult<unknown>;
+export declare function useCaseUpsert(args: JsonObject): CliResult<unknown>;
+export declare function useCaseRemove(args: JsonObject): CliResult<unknown>;
+export declare function evidenceStatus(args: JsonObject): CliResult<unknown>;
+export declare function evidenceRecord(args: JsonObject): CliResult<unknown>;
+export declare function evidenceVoid(args: JsonObject): CliResult<unknown>;
+export declare function planPresentation(args: JsonObject, mode: "showcase" | "walkthrough"): CliResult<unknown>;
+export declare function capsuleRun(args: JsonObject): CliResult<unknown>;
+export declare function showcaseStart(args: JsonObject): CliResult<unknown>;
+export declare function showcaseStatus(args: JsonObject): CliResult<unknown>;
+export declare function showcaseObservation(args: JsonObject): CliResult<unknown>;
+export declare function showcaseVerdict(args: JsonObject): CliResult<unknown>;
+export declare function showcaseDecide(args: JsonObject): CliResult<unknown>;
+export declare function showcaseFinish(args: JsonObject): CliResult<unknown>;
+export declare function showcaseRequestApproval(args: JsonObject): CliResult<unknown>;
+export declare function hostDoctor(args: JsonObject): CliResult<unknown>;
+export declare function errorEnvelope(command: string, code: string, message: string): CliResult<unknown>;
+export declare function isTrustedUserClaim(args: JsonObject): boolean;
+export declare function mcpServerWriteModeEnabled(): boolean;
+export declare function mcpServerCommandExecutionEnabled(): boolean;
+export declare function numberArg(args: JsonObject, name: string): number | null;
+export declare function boolArg(args: JsonObject, name: string): boolean;
+//# sourceMappingURL=toolHandlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolHandlers.d.ts","sourceRoot":"","sources":["../src/toolHandlers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EASV,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAqDnD,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAahE;AAcD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CASnE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAkB/D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAgBjE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAiBlE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAiBlE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CASnE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CA0BnE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAqBjE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,CAuBvG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAsB/D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAgDlE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CASnE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAuBxE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CA6BpE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAuBnE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAenE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAgC5E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAU/D;AAiED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAchG;AAiCD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAI5D;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,gCAAgC,IAAI,OAAO,CAE1D;AAqBD,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/D"}