@isaacriehm/cairn 0.1.0

package/dist/mcp/tools/ground-get.js

@@ -0,0 +1,80 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { groundDir, manifestPath, qualityGradesPath, } from "../../ground/index.js";
+import { mcpError } from "../errors.js";
+import { groundGetInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const root = groundDir(ctx.repoRoot);
+    switch (input.category) {
+        case "manifest": {
+            const path = manifestPath(ctx.repoRoot);
+            if (!existsSync(path)) {
+                return mcpError("FILE_NOT_FOUND", "manifest.yaml not present (daemon not run yet?)");
+            }
+            return { path: ".harness/ground/manifest.yaml", content: readFileSync(path, "utf8") };
+        }
+        case "quality_grades": {
+            const path = qualityGradesPath(ctx.repoRoot);
+            if (!existsSync(path)) {
+                return mcpError("FILE_NOT_FOUND", "quality-grades.yaml not present (daemon not run yet?)");
+            }
+            return { path: ".harness/ground/quality-grades.yaml", content: readFileSync(path, "utf8") };
+        }
+        case "glossary": {
+            const path = join(root, "glossary.md");
+            if (!existsSync(path)) {
+                return mcpError("FILE_NOT_FOUND", "glossary.md not present");
+            }
+            return { path: ".harness/ground/glossary.md", content: readFileSync(path, "utf8") };
+        }
+        case "schema":
+        case "routes":
+        case "events": {
+            const dir = join(root, input.category);
+            if (!existsSync(dir) || !statSync(dir).isDirectory()) {
+                return mcpError("FILE_NOT_FOUND", `${input.category}/ extracts not present (no profile extractor for this stack?)`);
+            }
+            if (input.key !== undefined) {
+                const candidate = join(dir, `${input.key}.md`);
+                const fallback = join(dir, `${input.key}.yaml`);
+                const target = existsSync(candidate)
+                    ? candidate
+                    : existsSync(fallback)
+                        ? fallback
+                        : null;
+                if (!target) {
+                    return mcpError("FILE_NOT_FOUND", `No ${input.category} entry for key "${input.key}"`);
+                }
+                return {
+                    path: `.harness/ground/${input.category}/${input.key}${target.endsWith(".yaml") ? ".yaml" : ".md"}`,
+                    content: readFileSync(target, "utf8"),
+                };
+            }
+            // No key — return the directory listing.
+            return {
+                path: `.harness/ground/${input.category}/`,
+                listing: readDirShallow(dir),
+            };
+        }
+    }
+}
+function readDirShallow(dir) {
+    try {
+        return [
+            ...new Set(require("node:fs")
+                .readdirSync(dir, { withFileTypes: true, encoding: "utf8" })
+                .filter((d) => d.isFile())
+                .map((d) => d.name)),
+        ];
+    }
+    catch {
+        return [];
+    }
+}
+export const groundGetTool = {
+    name: "harness_ground_get",
+    description: "Read a generated ground extract. Categories: schema | routes | events | quality_grades | glossary | manifest. `key` narrows within a category (e.g., schema → table name).",
+    inputSchema: groundGetInput,
+    handler,
+};
+//# sourceMappingURL=ground-get.js.map

package/dist/mcp/tools/ground-get.js.map

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

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

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const allTools: ToolDef<unknown>[];
+export type { ToolDef };

package/dist/mcp/tools/index.js

@@ -0,0 +1,44 @@
+import { appendTool } from "./append.js";
+import { archiveTool } from "./archive.js";
+import { askOperatorTool } from "./ask-operator.js";
+import { canonicalForTopicTool } from "./canonical-for-topic.js";
+import { decisionGetTool } from "./decision-get.js";
+import { decisionsForSymbolTool } from "./decisions-for-symbol.js";
+import { decisionsInScopeTool } from "./decisions-in-scope.js";
+import { dropTaskTool } from "./drop-task.js";
+import { getFullTool } from "./get-full.js";
+import { groundGetTool } from "./ground-get.js";
+import { invariantGetTool } from "./invariant-get.js";
+import { invariantsInScopeTool } from "./invariants-in-scope.js";
+import { queryHistoryTool } from "./query-history.js";
+import { recordDecisionTool } from "./record-decision.js";
+import { recordRunEventTool } from "./record-run-event.js";
+import { searchTool } from "./search.js";
+import { supersedesChainTool } from "./supersedes-chain.js";
+import { timelineTool } from "./timeline.js";
+export const allTools = [
+    // Read — graph traversal
+    decisionGetTool,
+    decisionsInScopeTool,
+    decisionsForSymbolTool,
+    canonicalForTopicTool,
+    groundGetTool,
+    supersedesChainTool,
+    invariantGetTool,
+    invariantsInScopeTool,
+    // Read — 3-layer progressive
+    searchTool,
+    timelineTool,
+    getFullTool,
+    // Read — historical (gated)
+    queryHistoryTool,
+    // Write
+    appendTool,
+    recordDecisionTool,
+    recordRunEventTool,
+    dropTaskTool,
+    archiveTool,
+    // Operator dialog
+    askOperatorTool,
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,QAAQ,GAAuB;IAC1C,yBAAyB;IACzB,eAAmC;IACnC,oBAAwC;IACxC,sBAA0C;IAC1C,qBAAyC;IACzC,aAAiC;IACjC,mBAAuC;IACvC,gBAAoC;IACpC,qBAAyC;IACzC,6BAA6B;IAC7B,UAA8B;IAC9B,YAAgC;IAChC,WAA+B;IAC/B,4BAA4B;IAC5B,gBAAoC;IACpC,QAAQ;IACR,UAA8B;IAC9B,kBAAsC;IACtC,kBAAsC;IACtC,YAAgC;IAChC,WAA+B;IAC/B,kBAAkB;IAClB,eAAmC;CACpC,CAAC"}

package/dist/mcp/tools/invariant-get.d.ts

@@ -0,0 +1,6 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    id: string;
+}
+export declare const invariantGetTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/invariant-get.js

@@ -0,0 +1,49 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { invariantsDir, parseFrontmatter } from "../../ground/index.js";
+import { InvariantFrontmatter } from "../../ground/index.js";
+import { mcpError } from "../errors.js";
+import { invariantGetInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const dir = invariantsDir(ctx.repoRoot);
+    if (!existsSync(dir)) {
+        return mcpError("INVARIANT_NOT_FOUND", `No invariants directory`);
+    }
+    for (const entry of readdirSync(dir, { withFileTypes: true, encoding: "utf8" })) {
+        if (!entry.isFile() || !entry.name.endsWith(".md"))
+            continue;
+        const parsed = parseFrontmatter(readFileSync(join(dir, entry.name), "utf8"));
+        const fm = InvariantFrontmatter.safeParse(parsed.frontmatter);
+        if (!fm.success)
+            continue;
+        if (fm.data.id !== input.id)
+            continue;
+        return {
+            id: fm.data.id,
+            title: fm.data.title,
+            status: fm.data.status ?? "active",
+            ...(fm.data.source_run !== undefined ? { source_run: fm.data.source_run } : {}),
+            ...(fm.data.source_decision !== undefined
+                ? { source_decision: fm.data.source_decision }
+                : {}),
+            ...(fm.data.introduced_for_bug !== undefined
+                ? { introduced_for_bug: fm.data.introduced_for_bug }
+                : {}),
+            ...(fm.data.sensor !== undefined ? { sensor: fm.data.sensor } : {}),
+            ...(fm.data.e2e !== undefined ? { e2e: fm.data.e2e } : {}),
+            ...(fm.data.naming_convention !== undefined
+                ? { naming_convention: fm.data.naming_convention }
+                : {}),
+            ...(fm.data.superseded_by !== undefined ? { superseded_by: fm.data.superseded_by } : {}),
+            body_markdown: parsed.body,
+        };
+    }
+    return mcpError("INVARIANT_NOT_FOUND", `No invariant with id ${input.id}`);
+}
+export const invariantGetTool = {
+    name: "harness_invariant_get",
+    description: "Returns §V invariant body + linked sensor + linked e2e by id.",
+    inputSchema: invariantGetInput,
+    handler,
+};
+//# sourceMappingURL=invariant-get.js.map

package/dist/mcp/tools/invariant-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant-get.js","sourceRoot":"","sources":["../../../src/mcp/tools/invariant-get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAOlD,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,KAAY;IAClD,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAC,qBAAqB,EAAE,yBAAyB,CAAC,CAAC;IACpE,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChF,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC7D,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7E,MAAM,EAAE,GAAG,oBAAoB,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC9D,IAAI,CAAC,EAAE,CAAC,OAAO;YAAE,SAAS;QAC1B,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE;YAAE,SAAS;QACtC,OAAO;YACL,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;YACd,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK;YACpB,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ;YAClC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE;gBAC9C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,kBAAkB,KAAK,SAAS;gBAC1C,CAAC,CAAC,EAAE,kBAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE;gBACpD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS;gBACzC,CAAC,CAAC,EAAE,iBAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE;gBAClD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,aAAa,EAAE,MAAM,CAAC,IAAI;SAC3B,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,qBAAqB,EAAE,wBAAwB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,+DAA+D;IAC5E,WAAW,EAAE,iBAAiB;IAC9B,OAAO;CACR,CAAC"}

package/dist/mcp/tools/invariants-in-scope.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    path_globs: string[];
+    status?: ("active" | "superseded")[];
+}
+export declare const invariantsInScopeTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/invariants-in-scope.js

@@ -0,0 +1,65 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { decisionsDir, invariantsDir, matchAnyGlob, parseFrontmatter } from "../../ground/index.js";
+import { DecisionFrontmatter, InvariantFrontmatter } from "../../ground/index.js";
+import { invariantsInScopeInput } from "../schemas.js";
+/**
+ * Invariants don't carry their own scope_globs — they inherit scope from the
+ * decision that introduced them (source_decision). To answer "which invariants
+ * apply to globs X?", we look up each invariant's source decision and check
+ * its scope_globs against the requested globs.
+ */
+async function handler(ctx, input) {
+    const wantStatus = new Set(input.status ?? ["active"]);
+    const decisionScopeById = new Map();
+    const dDir = decisionsDir(ctx.repoRoot);
+    if (existsSync(dDir)) {
+        for (const entry of readdirSync(dDir, { withFileTypes: true, encoding: "utf8" })) {
+            if (!entry.isFile() || !entry.name.endsWith(".md"))
+                continue;
+            const parsed = parseFrontmatter(readFileSync(join(dDir, entry.name), "utf8"));
+            const fm = DecisionFrontmatter.safeParse(parsed.frontmatter);
+            if (!fm.success)
+                continue;
+            decisionScopeById.set(fm.data.id, fm.data.scope_globs ?? []);
+        }
+    }
+    const iDir = invariantsDir(ctx.repoRoot);
+    if (!existsSync(iDir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(iDir, { withFileTypes: true, encoding: "utf8" })) {
+        if (!entry.isFile() || !entry.name.endsWith(".md"))
+            continue;
+        const parsed = parseFrontmatter(readFileSync(join(iDir, entry.name), "utf8"));
+        const fm = InvariantFrontmatter.safeParse(parsed.frontmatter);
+        if (!fm.success)
+            continue;
+        const status = fm.data.status ?? "active";
+        if (!wantStatus.has(status))
+            continue;
+        const sourceDecision = fm.data.source_decision ?? null;
+        const scope = sourceDecision ? decisionScopeById.get(sourceDecision) ?? [] : [];
+        const overlap = scope.some((scopeGlob) => input.path_globs.some((req) => matchAnyGlob(scopeGlob, [req]) || matchAnyGlob(req, [scopeGlob])));
+        if (!overlap)
+            continue;
+        out.push({
+            id: fm.data.id,
+            title: fm.data.title,
+            status,
+            source_decision: sourceDecision,
+        });
+    }
+    out.sort((a, b) => a.id.localeCompare(b.id));
+    // Reference yaml so import isn't dropped (used by symbol-tools that import via barrel).
+    void parseYaml;
+    return out;
+}
+export const invariantsInScopeTool = {
+    name: "harness_invariants_in_scope",
+    description: "List active invariants whose source_decision scope overlaps the given path_globs.",
+    inputSchema: invariantsInScopeInput,
+    handler,
+};
+//# sourceMappingURL=invariants-in-scope.js.map

package/dist/mcp/tools/invariants-in-scope.js.map

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

package/dist/mcp/tools/query-history.d.ts

@@ -0,0 +1,9 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    scope: string;
+    path_hint?: string;
+    since?: string;
+    until?: string;
+}
+export declare const queryHistoryTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/query-history.js

@@ -0,0 +1,33 @@
+import { mcpError } from "../errors.js";
+import { queryHistoryInput } from "../schemas.js";
+/**
+ * NOT IMPLEMENTED. Phase 4 baseline placeholder.
+ *
+ * Per MCP_SURFACE.md §"harness_query_history", the real implementation must:
+ *   1. Walk .archive/** matching path_hint and date window.
+ *   2. Run a Tier-1 LLM summarization over the matched files.
+ *   3. Return per-claim records carrying source_path, source_lines, as_of,
+ *      superseded_by, currently_canonical_pointer, and the summary_caveat.
+ *
+ * The LLM call requires the harness's frontend-adapter / model-registry
+ * scaffolding, which lands in Phase 5+. Until then this tool returns a
+ * structured NOT_IMPLEMENTED error envelope so callers don't accidentally
+ * consume a malformed payload.
+ *
+ * Returning an error from this tool is safer than returning raw archive
+ * content — the entire point of the surface is to keep raw stale content
+ * out of agent context windows.
+ */
+async function handler(_ctx, input) {
+    return mcpError("NOT_IMPLEMENTED", "harness_query_history awaits Tier-1 LLM integration (Phase 5+). Until then, all archive reads are denied; callers must wait or use harness_decision_get / harness_canonical_for_topic for current-canonical-only access.", {
+        requested_scope: input.scope,
+        ...(input.path_hint !== undefined ? { requested_path_hint: input.path_hint } : {}),
+    });
+}
+export const queryHistoryTool = {
+    name: "harness_query_history",
+    description: "Summarized historical claims from .archive/ via Tier-1 LLM. Currently NOT_IMPLEMENTED — awaits Phase 5 model integration.",
+    inputSchema: queryHistoryInput,
+    handler,
+};
+//# sourceMappingURL=query-history.js.map

package/dist/mcp/tools/query-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-history.js","sourceRoot":"","sources":["../../../src/mcp/tools/query-history.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUlD;;;;;;;;;;;;;;;;;GAiBG;AACH,KAAK,UAAU,OAAO,CAAC,IAAgB,EAAE,KAAY;IACnD,OAAO,QAAQ,CACb,iBAAiB,EACjB,0NAA0N,EAC1N;QACE,eAAe,EAAE,KAAK,CAAC,KAAK;QAC5B,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnF,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,2HAA2H;IAC7H,WAAW,EAAE,iBAAiB;IAC9B,OAAO;CACR,CAAC"}

package/dist/mcp/tools/record-decision.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    id?: string;
+    title: string;
+    summary: string;
+    scope_globs: string[];
+    supersedes?: string;
+    assertions?: unknown[];
+    human_review_hint?: string;
+    body_markdown?: string;
+    target?: "inbox" | "accepted";
+}
+export declare const recordDecisionTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/record-decision.js

@@ -0,0 +1,101 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { decisionsDir, parseFrontmatter } from "../../ground/index.js";
+import { DecisionAssertion, DecisionFrontmatter } from "../../ground/index.js";
+import { mcpError } from "../errors.js";
+import { recordDecisionInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const dir = decisionsDir(ctx.repoRoot);
+    const inboxDir = join(dir, "_inbox");
+    // Validate assertions, if provided.
+    if (input.assertions !== undefined) {
+        for (const a of input.assertions) {
+            const result = DecisionAssertion.safeParse(a);
+            if (!result.success) {
+                return mcpError("INVALID_ASSERTION_KIND", "assertion failed schema", {
+                    assertion: a,
+                    issues: result.error.issues,
+                });
+            }
+        }
+    }
+    // Existing-id index — for ID allocation and DECISION_ID_TAKEN check.
+    const existingIds = new Set();
+    for (const d of [dir, inboxDir]) {
+        if (!existsSync(d))
+            continue;
+        for (const e of readdirSync(d, { withFileTypes: true, encoding: "utf8" })) {
+            if (!e.isFile() || !e.name.endsWith(".md"))
+                continue;
+            const fm = parseFrontmatter(readFileSync(join(d, e.name), "utf8")).frontmatter;
+            const parsed = DecisionFrontmatter.safeParse(fm);
+            if (parsed.success)
+                existingIds.add(parsed.data.id);
+        }
+    }
+    let id;
+    if (input.id !== undefined) {
+        if (existingIds.has(input.id)) {
+            return mcpError("DECISION_ID_TAKEN", `${input.id} already exists`);
+        }
+        id = input.id;
+    }
+    else {
+        id = allocateNextId(existingIds);
+    }
+    if (input.supersedes !== undefined && !existingIds.has(input.supersedes)) {
+        return mcpError("SUPERSEDES_NOT_FOUND", `supersedes target "${input.supersedes}" not found`);
+    }
+    const target = input.target ?? "inbox";
+    const outDir = target === "accepted" ? dir : inboxDir;
+    mkdirSync(outDir, { recursive: true });
+    const frontmatter = {
+        id,
+        title: input.title,
+        type: "adr",
+        status: target === "accepted" ? "accepted" : "draft",
+        audience: "dual",
+        generated: new Date().toISOString(),
+        "verified-at": new Date().toISOString(),
+        decided_at: new Date().toISOString().slice(0, 10),
+        scope_globs: input.scope_globs,
+        ...(input.supersedes !== undefined ? { supersedes: input.supersedes } : {}),
+        ...(input.assertions !== undefined ? { assertions: input.assertions } : {}),
+        ...(input.human_review_hint !== undefined
+            ? { human_review_hint: input.human_review_hint }
+            : {}),
+    };
+    const body = input.body_markdown ?? `# ${id} — ${input.title}\n\n## Summary\n\n${input.summary}\n`;
+    const filename = target === "accepted" ? `${id}.md` : `${id}.draft.md`;
+    const path = join(outDir, filename);
+    const content = `---\n${stringifyYaml(frontmatter)}---\n\n${body}`;
+    writeFileSync(path, content, "utf8");
+    return {
+        ok: true,
+        id,
+        target,
+        path: target === "accepted"
+            ? `.harness/ground/decisions/${filename}`
+            : `.harness/ground/decisions/_inbox/${filename}`,
+    };
+}
+function allocateNextId(existing) {
+    let n = 0;
+    for (const id of existing) {
+        const m = id.match(/^DEC-(\d+)$/);
+        if (m?.[1]) {
+            const num = Number.parseInt(m[1], 10);
+            if (Number.isFinite(num) && num > n)
+                n = num;
+        }
+    }
+    return `DEC-${String(n + 1).padStart(4, "0")}`;
+}
+export const recordDecisionTool = {
+    name: "harness_record_decision",
+    description: "Drop a decision draft to .harness/ground/decisions/_inbox/ (target=inbox, default) or canonical (target=accepted; operator-only override). Validates assertion schemas. Allocates the next DEC-NNNN if id omitted.",
+    inputSchema: recordDecisionInput,
+    handler,
+};
+//# sourceMappingURL=record-decision.js.map

package/dist/mcp/tools/record-decision.js.map

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

package/dist/mcp/tools/record-run-event.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    run_id: string;
+    event: {
+        kind: string;
+        payload?: unknown;
+    };
+}
+export declare const recordRunEventTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/record-run-event.js

@@ -0,0 +1,28 @@
+import { appendFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { mcpError } from "../errors.js";
+import { recordRunEventInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const runDir = join(ctx.repoRoot, ".harness", "runs", "active", input.run_id);
+    if (!existsSync(runDir)) {
+        return mcpError("RUN_NOT_FOUND", `No active run dir at ${runDir}`);
+    }
+    const path = join(runDir, "events.jsonl");
+    // Server-fills ts. Seq is omitted in this naive implementation; the orchestrator
+    // re-numbers in the post-run pass when it materializes the canonical event log.
+    const row = {
+        ts: new Date().toISOString(),
+        kind: input.event.kind,
+        ...(input.event.payload !== undefined ? { payload: input.event.payload } : {}),
+    };
+    mkdirSync(runDir, { recursive: true });
+    appendFileSync(path, `${JSON.stringify(row)}\n`, "utf8");
+    return { ok: true, run_id: input.run_id, kind: input.event.kind };
+}
+export const recordRunEventTool = {
+    name: "harness_record_run_event",
+    description: "Append a structured event to .harness/runs/active/<run_id>/events.jsonl. Server fills `ts`; sequence is renumbered in post-run materialization.",
+    inputSchema: recordRunEventInput,
+    handler,
+};
+//# sourceMappingURL=record-run-event.js.map

package/dist/mcp/tools/record-run-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-run-event.js","sourceRoot":"","sources":["../../../src/mcp/tools/record-run-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAQpD,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,KAAY;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC,eAAe,EAAE,wBAAwB,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,iFAAiF;IACjF,gFAAgF;IAChF,MAAM,GAAG,GAAG;QACV,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;QACtB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC;IACF,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,iJAAiJ;IACnJ,WAAW,EAAE,mBAAmB;IAChC,OAAO;CACR,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    query: string;
+    scope?: string[];
+    kinds?: ("decision" | "invariant" | "task" | "run" | "doc" | "manifest")[];
+    limit?: number;
+}
+export declare const searchTool: ToolDef<Input>;
+export {};