@isaacriehm/cairn 0.1.0

package/dist/mcp/tools/search.js

@@ -0,0 +1,165 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { decisionsDir, invariantsDir, manifestPath, matchAnyGlob, parseFrontmatter, } from "../../ground/index.js";
+import { searchInput } from "../schemas.js";
+/**
+ * Naive substring index over decisions, invariants, tasks/active, and the
+ * canonical-zone manifest entries. Phase 4 baseline; can be uplifted to FTS
+ * (e.g., MiniSearch / Lunr) without changing the tool surface.
+ *
+ * Score: 0.5 base + 0.25 if title hit + 0.25 if body hit. Caps at 1.0.
+ */
+async function handler(ctx, input) {
+    const limit = Math.min(input.limit ?? 20, 50);
+    const wantKinds = new Set(input.kinds ?? ["decision", "invariant", "task", "doc"]);
+    const q = input.query.toLowerCase();
+    const out = [];
+    if (wantKinds.has("decision")) {
+        const dir = decisionsDir(ctx.repoRoot);
+        if (existsSync(dir)) {
+            for (const e of readdirSync(dir, { withFileTypes: true, encoding: "utf8" })) {
+                if (!e.isFile() || !e.name.endsWith(".md"))
+                    continue;
+                const path = join(dir, e.name);
+                const raw = readFileSync(path, "utf8");
+                const parsed = parseFrontmatter(raw);
+                const fm = parsed.frontmatter;
+                if (!fm?.id || !fm.title)
+                    continue;
+                const titleHit = fm.title.toLowerCase().includes(q);
+                const bodyHit = parsed.body.toLowerCase().includes(q);
+                if (!titleHit && !bodyHit)
+                    continue;
+                out.push({
+                    id: fm.id,
+                    kind: "decision",
+                    title: fm.title,
+                    path: relative(ctx.repoRoot, path).replace(/\\/g, "/"),
+                    score: Math.min(1, 0.5 + (titleHit ? 0.25 : 0) + (bodyHit ? 0.25 : 0)),
+                });
+            }
+        }
+    }
+    if (wantKinds.has("invariant")) {
+        const dir = invariantsDir(ctx.repoRoot);
+        if (existsSync(dir)) {
+            for (const e of readdirSync(dir, { withFileTypes: true, encoding: "utf8" })) {
+                if (!e.isFile() || !e.name.endsWith(".md"))
+                    continue;
+                const path = join(dir, e.name);
+                const raw = readFileSync(path, "utf8");
+                const parsed = parseFrontmatter(raw);
+                const fm = parsed.frontmatter;
+                if (!fm?.id || !fm.title)
+                    continue;
+                const titleHit = fm.title.toLowerCase().includes(q);
+                const bodyHit = parsed.body.toLowerCase().includes(q);
+                if (!titleHit && !bodyHit)
+                    continue;
+                out.push({
+                    id: fm.id,
+                    kind: "invariant",
+                    title: fm.title,
+                    path: relative(ctx.repoRoot, path).replace(/\\/g, "/"),
+                    score: Math.min(1, 0.5 + (titleHit ? 0.25 : 0) + (bodyHit ? 0.25 : 0)),
+                });
+            }
+        }
+    }
+    if (wantKinds.has("task")) {
+        const tasksDir = join(ctx.repoRoot, ".harness", "tasks", "active");
+        if (existsSync(tasksDir)) {
+            for (const e of readdirSync(tasksDir, { withFileTypes: true, encoding: "utf8" })) {
+                if (!e.isDirectory())
+                    continue;
+                const spec = join(tasksDir, e.name, "spec.tightened.md");
+                const fallback = join(tasksDir, e.name, "spec.md");
+                const target = existsSync(spec) ? spec : existsSync(fallback) ? fallback : null;
+                if (!target)
+                    continue;
+                const raw = readFileSync(target, "utf8");
+                const parsed = parseFrontmatter(raw);
+                const fm = parsed.frontmatter;
+                if (!fm?.id)
+                    continue;
+                const titleLine = parsed.body.match(/^#\s+(.+)$/m)?.[1] ?? fm.id;
+                const titleHit = titleLine.toLowerCase().includes(q);
+                const bodyHit = parsed.body.toLowerCase().includes(q);
+                if (!titleHit && !bodyHit)
+                    continue;
+                out.push({
+                    id: fm.id,
+                    kind: "task",
+                    title: titleLine,
+                    path: relative(ctx.repoRoot, target).replace(/\\/g, "/"),
+                    score: Math.min(1, 0.5 + (titleHit ? 0.25 : 0) + (bodyHit ? 0.25 : 0)),
+                });
+            }
+        }
+    }
+    if (wantKinds.has("doc")) {
+        const docsRoot = join(ctx.repoRoot, "docs");
+        if (existsSync(docsRoot))
+            walkDocs(docsRoot, ctx.repoRoot, q, out);
+    }
+    if (wantKinds.has("manifest")) {
+        const path = manifestPath(ctx.repoRoot);
+        if (existsSync(path)) {
+            const text = readFileSync(path, "utf8");
+            if (text.toLowerCase().includes(q)) {
+                out.push({
+                    id: "manifest",
+                    kind: "manifest",
+                    title: "ground/manifest.yaml",
+                    path: relative(ctx.repoRoot, path).replace(/\\/g, "/"),
+                    score: 0.5,
+                });
+            }
+        }
+    }
+    let filtered = out;
+    if (input.scope && input.scope.length > 0) {
+        filtered = out.filter((r) => r.path !== undefined ? matchAnyGlob(r.path, input.scope ?? []) : false);
+    }
+    filtered.sort((a, b) => b.score - a.score);
+    return filtered.slice(0, limit);
+}
+function walkDocs(dir, repoRoot, q, out) {
+    for (const e of readdirSync(dir, { withFileTypes: true, encoding: "utf8" })) {
+        const abs = join(dir, e.name);
+        if (e.isDirectory()) {
+            if (e.name === "_research")
+                continue;
+            walkDocs(abs, repoRoot, q, out);
+        }
+        else if (e.isFile() && e.name.endsWith(".md")) {
+            try {
+                const raw = readFileSync(abs, "utf8");
+                const parsed = parseFrontmatter(raw);
+                const titleLine = parsed.body.match(/^#\s+(.+)$/m)?.[1] ?? e.name;
+                const titleHit = titleLine.toLowerCase().includes(q);
+                const bodyHit = parsed.body.toLowerCase().includes(q);
+                if (!titleHit && !bodyHit)
+                    continue;
+                out.push({
+                    id: relative(repoRoot, abs).replace(/\\/g, "/"),
+                    kind: "doc",
+                    title: titleLine,
+                    path: relative(repoRoot, abs).replace(/\\/g, "/"),
+                    score: Math.min(1, 0.5 + (titleHit ? 0.25 : 0) + (bodyHit ? 0.25 : 0)),
+                });
+            }
+            catch {
+                // unreadable; skip
+            }
+        }
+    }
+    void statSync;
+}
+export const searchTool = {
+    name: "harness_search",
+    description: "Naive substring search over decisions, invariants, tasks, docs, and manifest. Returns compact records (~50 tokens each) sorted by score. Phase 4 baseline; FTS uplift later.",
+    inputSchema: searchInput,
+    handler,
+};
+//# sourceMappingURL=search.js.map

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

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

package/dist/mcp/tools/supersedes-chain.d.ts

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

package/dist/mcp/tools/supersedes-chain.js

@@ -0,0 +1,66 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { decisionsDir, parseFrontmatter } from "../../ground/index.js";
+import { DecisionFrontmatter } from "../../ground/index.js";
+import { mcpError } from "../errors.js";
+import { supersedesChainInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const dir = decisionsDir(ctx.repoRoot);
+    if (!existsSync(dir))
+        return mcpError("DECISION_NOT_FOUND", `No decisions directory`);
+    const all = new Map();
+    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 = DecisionFrontmatter.safeParse(parsed.frontmatter);
+        if (!fm.success)
+            continue;
+        all.set(fm.data.id, {
+            id: fm.data.id,
+            status: fm.data.status,
+            supersedes: fm.data.supersedes ?? null,
+        });
+    }
+    if (!all.has(input.decision_id)) {
+        return mcpError("DECISION_NOT_FOUND", `Unknown decision id ${input.decision_id}`);
+    }
+    // Walk back to root, then forward via reverse-supersedes index.
+    const reverse = new Map(); // supersedes-id → newer-id
+    for (const e of all.values()) {
+        if (e.supersedes)
+            reverse.set(e.supersedes, e.id);
+    }
+    // Find root (oldest) by walking supersedes chain backward.
+    let root = input.decision_id;
+    const seen = new Set();
+    while (true) {
+        if (seen.has(root))
+            break;
+        seen.add(root);
+        const cur = all.get(root);
+        if (!cur || cur.supersedes === null)
+            break;
+        root = cur.supersedes;
+    }
+    // Forward chain.
+    const chain = [];
+    const fwdSeen = new Set();
+    let cursor = root;
+    while (cursor && !fwdSeen.has(cursor)) {
+        fwdSeen.add(cursor);
+        const e = all.get(cursor);
+        if (!e)
+            break;
+        chain.push(e);
+        cursor = reverse.get(cursor);
+    }
+    return chain;
+}
+export const supersedesChainTool = {
+    name: "harness_supersedes_chain",
+    description: "Forward chain from earliest superseded decision to current binding decision (status=accepted at the head).",
+    inputSchema: supersedesChainInput,
+    handler,
+};
+//# sourceMappingURL=supersedes-chain.js.map

package/dist/mcp/tools/supersedes-chain.js.map

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

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

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

package/dist/mcp/tools/timeline.js

@@ -0,0 +1,65 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { runsTerminalDir } from "../../ground/index.js";
+import { timelineInput } from "../schemas.js";
+/**
+ * Returns chronologically ordered run/event records intersecting the scope
+ * window. Naive — reads runs/terminal/<id>/meta.json files. Phase 4 baseline;
+ * heavier indexing later.
+ */
+async function handler(ctx, input) {
+    const out = [];
+    const since = input.since ? Date.parse(input.since) : 0;
+    const until = input.until ? Date.parse(input.until) : Number.POSITIVE_INFINITY;
+    const wantKinds = input.kinds ? new Set(input.kinds) : null;
+    const dir = runsTerminalDir(ctx.repoRoot);
+    if (existsSync(dir)) {
+        for (const e of readdirSync(dir, { withFileTypes: true, encoding: "utf8" })) {
+            if (!e.isDirectory())
+                continue;
+            const meta = readJson(join(dir, e.name, "meta.json"));
+            if (!meta)
+                continue;
+            const ts = meta.finished_at ?? meta.started_at;
+            if (!ts)
+                continue;
+            const tsMs = Date.parse(ts);
+            if (Number.isNaN(tsMs) || tsMs < since || tsMs > until)
+                continue;
+            if (wantKinds && !wantKinds.has("run"))
+                continue;
+            // scope filter — naive: the run's scoped_module substring match.
+            if (input.scope && input.scope.length > 0 && meta.scoped_module) {
+                const hit = input.scope.some((g) => meta.scoped_module?.includes(g) ?? false);
+                if (!hit)
+                    continue;
+            }
+            out.push({
+                ts,
+                kind: "run",
+                run_id: meta.run_id,
+                ...(meta.task_id !== undefined ? { task_id: meta.task_id } : {}),
+                ...(meta.phase !== undefined ? { detail: meta.phase } : {}),
+            });
+        }
+    }
+    out.sort((a, b) => b.ts.localeCompare(a.ts));
+    return out;
+}
+function readJson(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export const timelineTool = {
+    name: "harness_timeline",
+    description: "Chronological run-event stream intersecting the scope window. Reads runs/terminal/. Useful for `what happened to <module> this week` without reading file bodies.",
+    inputSchema: timelineInput,
+    handler,
+};
+//# sourceMappingURL=timeline.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { ZodTypeAny } from "zod";
+import type { McpContext } from "../context.js";
+export type ToolInputShape = Record<string, ZodTypeAny>;
+export interface ToolDef<Input> {
+    name: string;
+    description: string;
+    inputSchema: ToolInputShape;
+    handler: (ctx: McpContext, input: Input) => Promise<unknown>;
+}

package/dist/mcp/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp/tools/types.ts"],"names":[],"mappings":""}

package/dist/mirror/clone.d.ts

@@ -0,0 +1,6 @@
+import type { CloneOptions, MirrorRecord } from "./types.js";
+/**
+ * Idempotent: ensures the mirror exists for the given project. Records the
+ * record if missing. Returns the (possibly-updated) record.
+ */
+export declare function ensureMirror(opts: CloneOptions): Promise<MirrorRecord>;

package/dist/mirror/clone.js

@@ -0,0 +1,48 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { simpleGit } from "simple-git";
+import { logger } from "../logger.js";
+import { mirrorPath, reposRoot } from "./paths.js";
+import { readMirrorRecord, writeMirrorRecord } from "./state.js";
+const log = logger("mirror.clone");
+/**
+ * Idempotent: ensures the mirror exists for the given project. Records the
+ * record if missing. Returns the (possibly-updated) record.
+ */
+export async function ensureMirror(opts) {
+    const { projectName, userTreePath, originUrl } = opts;
+    const path = mirrorPath(projectName);
+    const existing = readMirrorRecord(projectName);
+    if (existing && existsSync(path)) {
+        log.debug({ projectName, path }, "mirror already present");
+        if (existing.originUrl !== originUrl || existing.userTreePath !== userTreePath) {
+            throw new Error(`Mirror record for "${projectName}" exists with different origin/userTreePath.\n` +
+                `  recorded:  ${existing.originUrl} (tree ${existing.userTreePath})\n` +
+                `  requested: ${originUrl} (tree ${userTreePath})\n` +
+                "Refusing to overwrite. Resolve manually before re-running.");
+        }
+        return existing;
+    }
+    log.info({ projectName, originUrl, path }, "cloning mirror");
+    mkdirSync(dirname(path), { recursive: true });
+    mkdirSync(reposRoot(), { recursive: true });
+    const git = simpleGit();
+    await git.clone(originUrl, path);
+    const repo = simpleGit(path);
+    const branchSummary = await repo.branch();
+    const defaultBranch = opts.defaultBranch ?? branchSummary.current;
+    const record = {
+        projectName,
+        userTreePath,
+        originUrl,
+        defaultBranch,
+        mirrorPath: path,
+        lastSyncedAt: null,
+        lastSha: null,
+        createdAt: new Date().toISOString(),
+    };
+    writeMirrorRecord(record);
+    log.info({ projectName, defaultBranch }, "mirror clone complete");
+    return record;
+}
+//# sourceMappingURL=clone.js.map

package/dist/mirror/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../../src/mirror/clone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGjE,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAkB;IACnD,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACtD,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAErC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,wBAAwB,CAAC,CAAC;QAC3D,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,YAAY,KAAK,YAAY,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CACb,sBAAsB,WAAW,gDAAgD;gBAC/E,gBAAgB,QAAQ,CAAC,SAAS,UAAU,QAAQ,CAAC,YAAY,KAAK;gBACtE,gBAAgB,SAAS,UAAU,YAAY,KAAK;gBACpD,4DAA4D,CAC/D,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAC7D,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,SAAS,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;IAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,OAAO,CAAC;IAElE,MAAM,MAAM,GAAiB;QAC3B,WAAW;QACX,YAAY;QACZ,SAAS;QACT,aAAa;QACb,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IACF,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,uBAAuB,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mirror/dirty-overlap.d.ts

@@ -0,0 +1,13 @@
+import type { DirtyOverlapOptions, DirtyOverlapResult } from "./types.js";
+/**
+ * Codex audit Q3 / L45 — `local_dirty_overlap` gate.
+ *
+ * Reads the user's working tree (NEVER writes) and reports any un-committed
+ * files that overlap the dispatched run's target globs. If overlap is
+ * non-empty, the orchestrator pauses the run and offers the operator
+ * stash / cancel / wait via the active frontend adapter.
+ *
+ * Globs use a minimal native matcher — no external dep — that supports `**`
+ * (deep), `*` (single-segment), `?` (single char), and literal segments.
+ */
+export declare function checkLocalDirtyOverlap(opts: DirtyOverlapOptions): Promise<DirtyOverlapResult>;

package/dist/mirror/dirty-overlap.js

@@ -0,0 +1,77 @@
+import { simpleGit } from "simple-git";
+import { logger } from "../logger.js";
+import { requireMirrorRecord } from "./state.js";
+const log = logger("mirror.dirty-overlap");
+/**
+ * Codex audit Q3 / L45 — `local_dirty_overlap` gate.
+ *
+ * Reads the user's working tree (NEVER writes) and reports any un-committed
+ * files that overlap the dispatched run's target globs. If overlap is
+ * non-empty, the orchestrator pauses the run and offers the operator
+ * stash / cancel / wait via the active frontend adapter.
+ *
+ * Globs use a minimal native matcher — no external dep — that supports `**`
+ * (deep), `*` (single-segment), `?` (single char), and literal segments.
+ */
+export async function checkLocalDirtyOverlap(opts) {
+    const record = requireMirrorRecord(opts.projectName);
+    const repo = simpleGit(record.userTreePath);
+    const status = await repo.status();
+    const dirtyFiles = [
+        ...status.not_added,
+        ...status.modified,
+        ...status.created,
+        ...status.deleted,
+        ...status.renamed.map((r) => r.to),
+        ...status.staged,
+    ];
+    const dedup = Array.from(new Set(dirtyFiles));
+    const overlapping = dedup.filter((path) => opts.targetGlobs.some((g) => matchGlob(path, g)));
+    log.debug({
+        projectName: opts.projectName,
+        dirtyCount: dedup.length,
+        overlapCount: overlapping.length,
+    }, "dirty-overlap check");
+    return {
+        dirtyFiles: dedup,
+        overlappingFiles: overlapping,
+        overlap: overlapping.length > 0,
+    };
+}
+function matchGlob(path, glob) {
+    const re = compileGlob(glob);
+    return re.test(path);
+}
+function compileGlob(glob) {
+    let re = "^";
+    for (let i = 0; i < glob.length; i++) {
+        const c = glob[i];
+        if (c === "*") {
+            if (glob[i + 1] === "*") {
+                i += 1;
+                if (glob[i + 1] === "/") {
+                    i += 1;
+                    re += "(?:.*/)?";
+                }
+                else {
+                    re += ".*";
+                }
+            }
+            else {
+                re += "[^/]*";
+            }
+        }
+        else if (c === "?") {
+            re += "[^/]";
+        }
+        else if (c !== undefined && /[.+^${}()|[\]\\]/.test(c)) {
+            re += `\\${c}`;
+        }
+        else {
+            re += c ?? "";
+        }
+    }
+    re += "$";
+    return new RegExp(re);
+}
+//# sourceMappingURL=dirty-overlap.js.map

package/dist/mirror/dirty-overlap.js.map

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

package/dist/mirror/index.d.ts

@@ -0,0 +1,7 @@
+export { ensureMirror } from "./clone.js";
+export { syncMirror } from "./sync.js";
+export { pushMirror } from "./push.js";
+export { checkLocalDirtyOverlap } from "./dirty-overlap.js";
+export { harnessHome, reposRoot, stateRoot, modelsRoot, mirrorPath, projectStatePath, mirrorRecordPath, normalizeProjectName, } from "./paths.js";
+export { readMirrorRecord, writeMirrorRecord, requireMirrorRecord, } from "./state.js";
+export type { ProjectName, MirrorRecord, SyncResult, PushResult, DirtyOverlapResult, CloneOptions, SyncOptions, PushOptions, DirtyOverlapOptions, } from "./types.js";

package/dist/mirror/index.js

@@ -0,0 +1,7 @@
+export { ensureMirror } from "./clone.js";
+export { syncMirror } from "./sync.js";
+export { pushMirror } from "./push.js";
+export { checkLocalDirtyOverlap } from "./dirty-overlap.js";
+export { harnessHome, reposRoot, stateRoot, modelsRoot, mirrorPath, projectStatePath, mirrorRecordPath, normalizeProjectName, } from "./paths.js";
+export { readMirrorRecord, writeMirrorRecord, requireMirrorRecord, } from "./state.js";
+//# sourceMappingURL=index.js.map

package/dist/mirror/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mirror/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/mirror/paths.d.ts

@@ -0,0 +1,18 @@
+import type { ProjectName } from "./types.js";
+export declare function harnessHome(): string;
+export declare function reposRoot(): string;
+export declare function stateRoot(): string;
+export declare function modelsRoot(): string;
+export declare function mirrorPath(projectName: ProjectName): string;
+export declare function projectStatePath(projectName: ProjectName): string;
+export declare function mirrorRecordPath(projectName: ProjectName): string;
+/**
+ * Normalize a free-form name (package.json `name`, directory name) into the
+ * filesystem slug used as a directory key.
+ *
+ * - Lowercased
+ * - Scoped names (`@org/pkg`) use the path-after-slash
+ * - Non-alphanumerics collapse to a single underscore
+ * - Leading/trailing underscores stripped
+ */
+export declare function normalizeProjectName(raw: string): ProjectName;

package/dist/mirror/paths.js

@@ -0,0 +1,45 @@
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+const HARNESS_HOME_ROOT = ".local/harness";
+export function harnessHome() {
+    return resolve(homedir(), HARNESS_HOME_ROOT);
+}
+export function reposRoot() {
+    return join(harnessHome(), "repos");
+}
+export function stateRoot() {
+    return join(harnessHome(), "state");
+}
+export function modelsRoot() {
+    return join(harnessHome(), "models");
+}
+export function mirrorPath(projectName) {
+    return join(reposRoot(), projectName);
+}
+export function projectStatePath(projectName) {
+    return join(stateRoot(), projectName);
+}
+export function mirrorRecordPath(projectName) {
+    return join(projectStatePath(projectName), "mirror.json");
+}
+/**
+ * Normalize a free-form name (package.json `name`, directory name) into the
+ * filesystem slug used as a directory key.
+ *
+ * - Lowercased
+ * - Scoped names (`@org/pkg`) use the path-after-slash
+ * - Non-alphanumerics collapse to a single underscore
+ * - Leading/trailing underscores stripped
+ */
+export function normalizeProjectName(raw) {
+    const afterScope = raw.includes("/") ? (raw.split("/").pop() ?? raw) : raw;
+    const slug = afterScope
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "");
+    if (slug.length === 0) {
+        throw new Error(`Cannot normalize project name from "${raw}" — result is empty`);
+    }
+    return slug;
+}
+//# sourceMappingURL=paths.js.map

package/dist/mirror/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/mirror/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAE3C,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAwB;IACjD,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,WAAW,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAwB;IACvD,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,WAAW,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAwB;IACvD,OAAO,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3E,MAAM,IAAI,GAAG,UAAU;SACpB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,qBAAqB,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/mirror/push.d.ts

@@ -0,0 +1,9 @@
+import type { PushOptions, PushResult } from "./types.js";
+/**
+ * Pushes the mirror's current HEAD to origin. Caller commits first.
+ *
+ * Force pushes are refused unless `force: true` is explicitly set; the only
+ * time the harness sets that is during recovery flows that have explicit
+ * operator authorization. Routine pushes never force.
+ */
+export declare function pushMirror(opts: PushOptions): Promise<PushResult>;