@isaacriehm/cairn 0.1.0

package/dist/mcp/context.js

@@ -0,0 +1,8 @@
+import { resolve } from "node:path";
+export function createContext(opts) {
+    return {
+        repoRoot: resolve(opts.repoRoot),
+        ...(opts.runId !== undefined ? { runId: opts.runId } : {}),
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/mcp/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/mcp/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,MAAM,UAAU,aAAa,CAAC,IAA0C;IACtE,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/mcp/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Error envelope per MCP_SURFACE §"Failure modes".
+ *
+ * Tools NEVER throw. They return either a success payload or an error envelope
+ * shaped as { error: { code, message, details? } }. The envelope is wrapped in
+ * the MCP `CallToolResult` content text.
+ */
+export type McpErrorCode = "VALIDATION_FAILED" | "TOOL_NOT_FOUND" | "PATH_OUTSIDE_REPO" | "PATH_HISTORICAL_USE_QUERY_HISTORY" | "PATH_NOT_ALLOWED" | "FILE_NOT_FOUND" | "DAEMON_UNAVAILABLE" | "OPERATION_TIMEOUT" | "DECISION_NOT_FOUND" | "DECISION_ID_TAKEN" | "INVALID_ASSERTION_KIND" | "SUPERSEDES_NOT_FOUND" | "INVARIANT_NOT_FOUND" | "TOPIC_NOT_REGISTERED" | "RUN_NOT_FOUND" | "TASK_NOT_FOUND" | "NOT_ALLOWED" | "NOT_IMPLEMENTED";
+export interface McpErrorPayload {
+    error: {
+        code: McpErrorCode;
+        message: string;
+        details?: unknown;
+    };
+}
+export declare function mcpError(code: McpErrorCode, message: string, details?: unknown): McpErrorPayload;
+export declare function isMcpError(payload: unknown): payload is McpErrorPayload;

package/dist/mcp/errors.js

@@ -0,0 +1,23 @@
+/**
+ * Error envelope per MCP_SURFACE §"Failure modes".
+ *
+ * Tools NEVER throw. They return either a success payload or an error envelope
+ * shaped as { error: { code, message, details? } }. The envelope is wrapped in
+ * the MCP `CallToolResult` content text.
+ */
+export function mcpError(code, message, details) {
+    return {
+        error: {
+            code,
+            message,
+            ...(details !== undefined ? { details } : {}),
+        },
+    };
+}
+export function isMcpError(payload) {
+    return (typeof payload === "object" &&
+        payload !== null &&
+        "error" in payload &&
+        typeof payload.error === "object");
+}
+//# sourceMappingURL=errors.js.map

package/dist/mcp/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/mcp/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8BH,MAAM,UAAU,QAAQ,CACtB,IAAkB,EAClB,OAAe,EACf,OAAiB;IAEjB,OAAO;QACL,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,OAAO,CACL,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,OAAO,IAAI,OAAO;QAClB,OAAQ,OAA8B,CAAC,KAAK,KAAK,QAAQ,CAC1D,CAAC;AACJ,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,10 @@
+export { startMcpServer } from "./server.js";
+export type { StartServerOptions } from "./server.js";
+export { createContext } from "./context.js";
+export type { McpContext } from "./context.js";
+export { allTools } from "./tools/index.js";
+export type { ToolDef } from "./tools/types.js";
+export { mcpError, isMcpError } from "./errors.js";
+export type { McpErrorCode, McpErrorPayload } from "./errors.js";
+export { asMcpResult } from "./result.js";
+export { APPEND_ALLOWLIST, ARCHIVE_DENY, HISTORICAL_ZONE, isAppendAllowed, isArchiveDenied, isHistorical, safeJoin, } from "./path-allowlist.js";

package/dist/mcp/index.js

@@ -0,0 +1,7 @@
+export { startMcpServer } from "./server.js";
+export { createContext } from "./context.js";
+export { allTools } from "./tools/index.js";
+export { mcpError, isMcpError } from "./errors.js";
+export { asMcpResult } from "./result.js";
+export { APPEND_ALLOWLIST, ARCHIVE_DENY, HISTORICAL_ZONE, isAppendAllowed, isArchiveDenied, isHistorical, safeJoin, } from "./path-allowlist.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,GACT,MAAM,qBAAqB,CAAC"}

package/dist/mcp/path-allowlist.d.ts

@@ -0,0 +1,25 @@
+import { type McpErrorPayload } from "./errors.js";
+/**
+ * Append-write allowlist. Server-side, NOT agent-controllable.
+ *
+ * Per MCP_SURFACE.md §"Write tools — append-only":
+ *   - .harness/runs/active/<run-id>/events.jsonl
+ *   - .harness/runs/active/<run-id>/commands.jsonl
+ *   - .harness/staleness/log.jsonl
+ *   - .harness/inbox/**         (system-only; rarely used by agents)
+ */
+export declare const APPEND_ALLOWLIST: readonly string[];
+/**
+ * Paths agents may NOT archive. AGENTS.md, CLAUDE.md, brand guidelines, and
+ * decisions/ are all sacred ground.
+ */
+export declare const ARCHIVE_DENY: readonly string[];
+/** Historical-zone globs — read tools refuse these; query_history is the ONE escape. */
+export declare const HISTORICAL_ZONE: readonly string[];
+/** Resolves a relative path against repoRoot and rejects escapes. */
+export declare function safeJoin(repoRoot: string, rel: string): string | McpErrorPayload;
+/** Returns repo-relative POSIX-style path for a path already inside repoRoot. */
+export declare function relPosix(repoRoot: string, abs: string): string;
+export declare function isAppendAllowed(repoRelPath: string): boolean;
+export declare function isArchiveDenied(repoRelPath: string): boolean;
+export declare function isHistorical(repoRelPath: string): boolean;

package/dist/mcp/path-allowlist.js

@@ -0,0 +1,66 @@
+import { isAbsolute, normalize, relative, resolve } from "node:path";
+import { matchAnyGlob } from "../ground/glob.js";
+import { mcpError } from "./errors.js";
+/**
+ * Append-write allowlist. Server-side, NOT agent-controllable.
+ *
+ * Per MCP_SURFACE.md §"Write tools — append-only":
+ *   - .harness/runs/active/<run-id>/events.jsonl
+ *   - .harness/runs/active/<run-id>/commands.jsonl
+ *   - .harness/staleness/log.jsonl
+ *   - .harness/inbox/**         (system-only; rarely used by agents)
+ */
+export const APPEND_ALLOWLIST = [
+    ".harness/runs/active/*/events.jsonl",
+    ".harness/runs/active/*/commands.jsonl",
+    ".harness/staleness/log.jsonl",
+    ".harness/inbox/**",
+];
+/**
+ * Paths agents may NOT archive. AGENTS.md, CLAUDE.md, brand guidelines, and
+ * decisions/ are all sacred ground.
+ */
+export const ARCHIVE_DENY = [
+    "AGENTS.md",
+    "CLAUDE.md",
+    ".claude/**",
+    "docs/decisions/**",
+    ".harness/ground/decisions/**",
+    ".harness/ground/invariants/**",
+    ".harness/config/**",
+    "docs/design/brand/**",
+];
+/** Historical-zone globs — read tools refuse these; query_history is the ONE escape. */
+export const HISTORICAL_ZONE = [
+    ".archive/**",
+    ".harness/runs/terminal/**",
+    ".harness/tasks/done/**",
+    ".harness/tasks/archived/**",
+    ".harness/ground/decisions/_inbox/**",
+];
+/** Resolves a relative path against repoRoot and rejects escapes. */
+export function safeJoin(repoRoot, rel) {
+    if (isAbsolute(rel)) {
+        return mcpError("PATH_OUTSIDE_REPO", `Absolute paths not accepted: ${rel}`);
+    }
+    const abs = resolve(repoRoot, rel);
+    const back = relative(repoRoot, abs);
+    if (back.startsWith("..") || isAbsolute(back)) {
+        return mcpError("PATH_OUTSIDE_REPO", `Path resolves outside repo: ${rel}`);
+    }
+    return abs;
+}
+/** Returns repo-relative POSIX-style path for a path already inside repoRoot. */
+export function relPosix(repoRoot, abs) {
+    return normalize(relative(repoRoot, abs)).replace(/\\/g, "/");
+}
+export function isAppendAllowed(repoRelPath) {
+    return matchAnyGlob(repoRelPath, APPEND_ALLOWLIST);
+}
+export function isArchiveDenied(repoRelPath) {
+    return matchAnyGlob(repoRelPath, ARCHIVE_DENY);
+}
+export function isHistorical(repoRelPath) {
+    return matchAnyGlob(repoRelPath, HISTORICAL_ZONE);
+}
+//# sourceMappingURL=path-allowlist.js.map

package/dist/mcp/path-allowlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-allowlist.js","sourceRoot":"","sources":["../../src/mcp/path-allowlist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAwB,MAAM,aAAa,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,qCAAqC;IACrC,uCAAuC;IACvC,8BAA8B;IAC9B,mBAAmB;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,WAAW;IACX,WAAW;IACX,YAAY;IACZ,mBAAmB;IACnB,8BAA8B;IAC9B,+BAA+B;IAC/B,oBAAoB;IACpB,sBAAsB;CACvB,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,aAAa;IACb,2BAA2B;IAC3B,wBAAwB;IACxB,4BAA4B;IAC5B,qCAAqC;CACtC,CAAC;AAEF,qEAAqE;AACrE,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,GAAW;IACpD,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,mBAAmB,EAAE,gCAAgC,GAAG,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC,mBAAmB,EAAE,+BAA+B,GAAG,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,GAAW;IACpD,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,YAAY,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,YAAY,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;AACpD,CAAC"}

package/dist/mcp/result.d.ts

@@ -0,0 +1,8 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { McpErrorPayload } from "./errors.js";
+/**
+ * Wraps a tool's payload (success object OR error envelope) as the MCP
+ * CallToolResult shape: { content: [{ type: "text", text: <json> }], isError? }.
+ */
+export declare function asMcpResult(payload: unknown): CallToolResult;
+export type { McpErrorPayload };

package/dist/mcp/result.js

@@ -0,0 +1,18 @@
+import { isMcpError } from "./errors.js";
+/**
+ * Wraps a tool's payload (success object OR error envelope) as the MCP
+ * CallToolResult shape: { content: [{ type: "text", text: <json> }], isError? }.
+ */
+export function asMcpResult(payload) {
+    const isError = isMcpError(payload);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+        isError,
+    };
+}
+//# sourceMappingURL=result.js.map

package/dist/mcp/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/mcp/result.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACvC;SACF;QACD,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/mcp/schemas.d.ts

@@ -0,0 +1,153 @@
+import { z } from "zod";
+export declare const decisionGetInput: {
+    id: z.ZodString;
+};
+export declare const decisionsInScopeInput: {
+    path_globs: z.ZodArray<z.ZodString>;
+    status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        draft: "draft";
+        accepted: "accepted";
+        superseded: "superseded";
+        archived: "archived";
+    }>>>;
+};
+export declare const decisionsForSymbolInput: {
+    file: z.ZodString;
+    symbol: z.ZodString;
+};
+export declare const canonicalForTopicInput: {
+    topic: z.ZodString;
+};
+export declare const groundGetInput: {
+    category: z.ZodEnum<{
+        schema: "schema";
+        routes: "routes";
+        events: "events";
+        quality_grades: "quality_grades";
+        glossary: "glossary";
+        manifest: "manifest";
+    }>;
+    key: z.ZodOptional<z.ZodString>;
+};
+export declare const supersedesChainInput: {
+    decision_id: z.ZodString;
+};
+export declare const invariantGetInput: {
+    id: z.ZodString;
+};
+export declare const invariantsInScopeInput: {
+    path_globs: z.ZodArray<z.ZodString>;
+    status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        superseded: "superseded";
+        active: "active";
+    }>>>;
+};
+export declare const searchInput: {
+    query: z.ZodString;
+    scope: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        manifest: "manifest";
+        decision: "decision";
+        invariant: "invariant";
+        task: "task";
+        run: "run";
+        doc: "doc";
+    }>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare const timelineInput: {
+    scope: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+};
+export declare const getFullInput: {
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        decision: "decision";
+        invariant: "invariant";
+        task: "task";
+        run: "run";
+    }>;
+};
+export declare const queryHistoryInput: {
+    scope: z.ZodString;
+    path_hint: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+};
+export declare const appendInput: {
+    path: z.ZodString;
+    content: z.ZodString;
+    newline_separator: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const recordDecisionInput: {
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    summary: z.ZodString;
+    scope_globs: z.ZodArray<z.ZodString>;
+    supersedes: z.ZodOptional<z.ZodString>;
+    assertions: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    human_review_hint: z.ZodOptional<z.ZodString>;
+    body_markdown: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodEnum<{
+        accepted: "accepted";
+        inbox: "inbox";
+    }>>;
+};
+export declare const recordRunEventInput: {
+    run_id: z.ZodString;
+    event: z.ZodObject<{
+        kind: z.ZodString;
+        payload: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>;
+};
+export declare const dropTaskInput: {
+    title: z.ZodString;
+    body: z.ZodString;
+    intent: z.ZodEnum<{
+        unknown: "unknown";
+        run_pilot: "run_pilot";
+        review_module: "review_module";
+        fix_issue: "fix_issue";
+        eval: "eval";
+        staleness_scan: "staleness_scan";
+    }>;
+    target_path_globs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    parent_task_id: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+};
+export declare const archiveInput: {
+    path: z.ZodString;
+    reason: z.ZodString;
+    archive_dir: z.ZodOptional<z.ZodString>;
+};
+export declare const askOperatorInput: {
+    /** The agent's run id — files land under runs/active/<run_id>/questions/. */
+    run_id: z.ZodString;
+    /** The question text shown to the operator. */
+    question: z.ZodString;
+    /**
+     * Optional A/B/C/D candidate resolutions. When present the operator
+     * dialog uses buttons; when empty the operator must reply free-form
+     * (the orchestrator falls back to a follow-up message handler).
+     */
+    options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    /**
+     * Why the agent needs the operator's input. One of:
+     *   "ambiguity"   — spec is genuinely vague / multiple valid paths
+     *   "permission"  — about to take a non-recoverable action (delete,
+     *                   force-push, etc.)
+     *   "stuck"       — couldn't make progress without external info
+     *   "verify"      — operator should confirm the agent's interpretation
+     */
+    category: z.ZodOptional<z.ZodEnum<{
+        ambiguity: "ambiguity";
+        permission: "permission";
+        stuck: "stuck";
+        verify: "verify";
+    }>>;
+    /** Per-call timeout. Default 10 minutes. */
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+};

package/dist/mcp/schemas.js

@@ -0,0 +1,135 @@
+import { z } from "zod";
+// Each constant below is the input zod RAW SHAPE the MCP SDK accepts directly
+// in `registerTool({ inputSchema: ... })`. Keeping them as raw shapes (not
+// pre-built objects) lets the SDK convert to JSON Schema for tool listings.
+// ── Read tools — graph traversal ───────────────────────────────────────────
+export const decisionGetInput = {
+    id: z.string().regex(/^DEC-\d{4,}$/, "decision id must match DEC-NNNN"),
+};
+export const decisionsInScopeInput = {
+    path_globs: z.array(z.string()).min(1),
+    status: z.array(z.enum(["draft", "accepted", "superseded", "archived"])).optional(),
+};
+export const decisionsForSymbolInput = {
+    file: z.string().min(1),
+    symbol: z.string().min(1),
+};
+export const canonicalForTopicInput = {
+    topic: z.string().min(1),
+};
+export const groundGetInput = {
+    category: z.enum([
+        "schema",
+        "routes",
+        "events",
+        "quality_grades",
+        "glossary",
+        "manifest",
+    ]),
+    key: z.string().optional(),
+};
+export const supersedesChainInput = {
+    decision_id: z.string().min(1),
+};
+export const invariantGetInput = {
+    id: z.string().regex(/^V\d{4,}$/, "invariant id must match V<NNNN>"),
+};
+export const invariantsInScopeInput = {
+    path_globs: z.array(z.string()).min(1),
+    status: z.array(z.enum(["active", "superseded"])).optional(),
+};
+// ── Read tools — 3-layer progressive retrieval ─────────────────────────────
+export const searchInput = {
+    query: z.string().min(1),
+    scope: z.array(z.string()).optional(),
+    kinds: z.array(z.enum(["decision", "invariant", "task", "run", "doc", "manifest"])).optional(),
+    limit: z.number().int().positive().max(50).optional(),
+};
+export const timelineInput = {
+    scope: z.array(z.string()).optional(),
+    since: z.string().optional(),
+    until: z.string().optional(),
+    kinds: z.array(z.string()).optional(),
+};
+export const getFullInput = {
+    id: z.string().min(1),
+    kind: z.enum(["decision", "invariant", "task", "run"]),
+};
+// ── Read tools — historical zone (gated) ───────────────────────────────────
+export const queryHistoryInput = {
+    scope: z.string().min(1),
+    path_hint: z.string().optional(),
+    since: z.string().optional(),
+    until: z.string().optional(),
+};
+// ── Write tools ────────────────────────────────────────────────────────────
+export const appendInput = {
+    path: z.string().min(1),
+    content: z.string(),
+    newline_separator: z.boolean().optional(),
+};
+export const recordDecisionInput = {
+    id: z.string().regex(/^DEC-\d{4,}$/).optional(),
+    title: z.string().min(1),
+    summary: z.string().min(1),
+    scope_globs: z.array(z.string()).min(1),
+    supersedes: z.string().optional(),
+    assertions: z.array(z.unknown()).optional(),
+    human_review_hint: z.string().optional(),
+    body_markdown: z.string().optional(),
+    target: z.enum(["inbox", "accepted"]).optional(),
+};
+export const recordRunEventInput = {
+    run_id: z.string().min(1),
+    event: z.object({
+        kind: z.string().min(1),
+        payload: z.unknown().optional(),
+    }),
+};
+export const dropTaskInput = {
+    title: z.string().min(1),
+    body: z.string().min(1),
+    intent: z.enum([
+        "run_pilot",
+        "review_module",
+        "fix_issue",
+        "eval",
+        "staleness_scan",
+        "unknown",
+    ]),
+    target_path_globs: z.array(z.string()).optional(),
+    priority: z.number().int().min(1).max(10).optional(),
+    parent_task_id: z.string().optional(),
+    source: z.string().optional(),
+};
+export const archiveInput = {
+    path: z.string().min(1),
+    reason: z.string().min(1),
+    archive_dir: z.string().optional(),
+};
+export const askOperatorInput = {
+    /** The agent's run id — files land under runs/active/<run_id>/questions/. */
+    run_id: z.string().min(1),
+    /** The question text shown to the operator. */
+    question: z.string().min(1),
+    /**
+     * Optional A/B/C/D candidate resolutions. When present the operator
+     * dialog uses buttons; when empty the operator must reply free-form
+     * (the orchestrator falls back to a follow-up message handler).
+     */
+    options: z.array(z.string().min(1)).max(4).optional(),
+    /**
+     * Why the agent needs the operator's input. One of:
+     *   "ambiguity"   — spec is genuinely vague / multiple valid paths
+     *   "permission"  — about to take a non-recoverable action (delete,
+     *                   force-push, etc.)
+     *   "stuck"       — couldn't make progress without external info
+     *   "verify"      — operator should confirm the agent's interpretation
+     */
+    category: z
+        .enum(["ambiguity", "permission", "stuck", "verify"])
+        .optional(),
+    /** Per-call timeout. Default 10 minutes. */
+    timeout_ms: z.number().int().min(1000).max(86_400_000).optional(),
+};
+//# sourceMappingURL=schemas.js.map

package/dist/mcp/schemas.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,11 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpContext } from "./context.js";
+export interface StartServerOptions {
+    ctx: McpContext;
+    /** When true, do not connect to stdio — caller wires its own transport. */
+    noConnect?: boolean;
+}
+export declare function startMcpServer(opts: StartServerOptions): Promise<{
+    server: McpServer;
+    close: () => Promise<void>;
+}>;

package/dist/mcp/server.js

@@ -0,0 +1,58 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { logger } from "../logger.js";
+import { VERSION } from "../index.js";
+import { isMcpError, mcpError } from "./errors.js";
+import { asMcpResult } from "./result.js";
+import { recordCall } from "./telemetry.js";
+import { allTools } from "./tools/index.js";
+const log = logger("mcp.server");
+export async function startMcpServer(opts) {
+    const { ctx } = opts;
+    const server = new McpServer({ name: "harness-mcp", version: VERSION });
+    for (const tool of allTools) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        }, async (rawInput) => {
+            const start = process.hrtime.bigint();
+            let payload;
+            try {
+                payload = await tool.handler(ctx, rawInput);
+            }
+            catch (err) {
+                payload = mcpError("OPERATION_TIMEOUT", err instanceof Error ? err.message : "tool handler threw");
+                log.error({ tool: tool.name, err: String(err) }, "tool handler threw");
+            }
+            const durationMs = Number(process.hrtime.bigint() - start) / 1_000_000;
+            const result = asMcpResult(payload);
+            const resultSize = result.content?.[0]?.type === "text" ? result.content[0].text.length : 0;
+            try {
+                recordCall(ctx, {
+                    ts: new Date().toISOString(),
+                    tool: tool.name,
+                    args: rawInput ?? {},
+                    result_kind: isMcpError(payload) ? "error" : "ok",
+                    result_size: resultSize,
+                    duration_ms: Math.round(durationMs * 100) / 100,
+                });
+            }
+            catch {
+                // telemetry must not break tool calls
+            }
+            return result;
+        });
+    }
+    if (opts.noConnect !== true) {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        log.info({ tools: allTools.length, repoRoot: ctx.repoRoot }, "MCP server listening on stdio");
+    }
+    return {
+        server,
+        close: async () => {
+            await server.close();
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/telemetry.d.ts

@@ -0,0 +1,15 @@
+import type { McpContext } from "./context.js";
+/**
+ * Writes one row per tool call to:
+ *   - .harness/runs/active/<runId>/mcp-calls.jsonl     when ctx.runId set
+ *   - .harness/staleness/mcp-calls.jsonl               otherwise
+ */
+export interface TelemetryRow {
+    ts: string;
+    tool: string;
+    args: unknown;
+    result_kind: "ok" | "error";
+    result_size: number;
+    duration_ms: number;
+}
+export declare function recordCall(ctx: McpContext, row: TelemetryRow): void;

package/dist/mcp/telemetry.js

@@ -0,0 +1,13 @@
+import { appendFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+export function recordCall(ctx, row) {
+    const path = ctx.runId !== undefined
+        ? join(ctx.repoRoot, ".harness", "runs", "active", ctx.runId, "mcp-calls.jsonl")
+        : join(ctx.repoRoot, ".harness", "staleness", "mcp-calls.jsonl");
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    appendFileSync(path, `${JSON.stringify(row)}\n`, "utf8");
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/mcp/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/mcp/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiB1C,MAAM,UAAU,UAAU,CAAC,GAAe,EAAE,GAAiB;IAC3D,MAAM,IAAI,GACR,GAAG,CAAC,KAAK,KAAK,SAAS;QACrB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC;QAChF,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    path: string;
+    content: string;
+    newline_separator?: boolean;
+}
+export declare const appendTool: ToolDef<Input>;
+export {};