@isaacriehm/cairn 0.1.0

package/dist/cli/run.js

@@ -0,0 +1,174 @@
+import { config as loadDotenv } from "dotenv";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { harnessEnvPath, logger, normalizeProjectName, readMirrorRecord, } from "@devplusllc/harness-core";
+import { Orchestrator } from "@devplusllc/harness-runtime";
+import { DiscordFrontendAdapter } from "@devplusllc/harness-frontend-discord";
+import { StubFrontendAdapter } from "@devplusllc/harness-frontend-stub";
+const log = logger("cli.run");
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags[key] = next;
+                i += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function usage() {
+    console.error("Usage: harness run --project <slug> [--frontend <name[,name...]>] [--repo-root <path>] [--no-orchestrator] [--bypass-tightener] [--default-tier <haiku|sonnet|opus>]\n" +
+        "  --project            project slug (matches `harness mirror init --project ...`)\n" +
+        "  --frontend           adapter name(s): discord | stub (default: discord)\n" +
+        "  --repo-root          override repo root (default: mirror path from state, then cwd)\n" +
+        "  --no-orchestrator    bring up adapters only; skip the FIFO + agent runner\n" +
+        "  --bypass-tightener   skip the spec tightener (Phase 7) — smoke convenience\n" +
+        "  --default-tier       implementer model tier (default: haiku)\n" +
+        "\n" +
+        "Brings up registered frontend adapters and (unless --no-orchestrator)\n" +
+        "the Phase 8 orchestrator, which tails .harness/inbox/<...>.json and\n" +
+        "dispatches one task at a time against the mirror checkout.");
+    process.exit(1);
+}
+function buildAdapter(args) {
+    const { name, repoRoot } = args;
+    switch (name) {
+        case "discord": {
+            const token = process.env["DISCORD_BOT_TOKEN"];
+            const guildId = process.env["DISCORD_GUILD_ID"];
+            if (!token || !guildId) {
+                throw new Error("discord adapter requires DISCORD_BOT_TOKEN and DISCORD_GUILD_ID in env (harness/.env)");
+            }
+            return new DiscordFrontendAdapter({
+                repoRoot,
+                token,
+                guildId,
+                ownerUserIdsEnv: process.env["DISCORD_OWNER_USER_IDS"],
+            });
+        }
+        case "stub":
+            return new StubFrontendAdapter({ repoRoot });
+        default:
+            throw new Error(`unknown frontend adapter: ${name}`);
+    }
+}
+function resolveRepoRoot(args) {
+    if (args.flag)
+        return resolve(args.flag);
+    const record = readMirrorRecord(args.project);
+    if (record)
+        return record.mirrorPath;
+    return process.cwd();
+}
+function loadEnvFiles() {
+    // Try, in order: ~/.local/harness/.env (operator-scoped, written by
+    // `harness init`), explicit .env at cwd, packages/harness/.env (when
+    // invoked from the monorepo root above the package), then the pkg's own
+    // .env (npm-link dev).
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgRoot = resolve(here, "..", "..");
+    const candidates = Array.from(new Set([
+        harnessEnvPath(),
+        resolve(process.cwd(), ".env"),
+        resolve(process.cwd(), "packages", "harness", ".env"),
+        resolve(pkgRoot, ".env"),
+    ]));
+    const loaded = [];
+    for (const path of candidates) {
+        if (existsSync(path)) {
+            const result = loadDotenv({ path });
+            if (!result.error)
+                loaded.push(path);
+        }
+    }
+    return loaded;
+}
+export async function runCli(argv) {
+    const { flags } = parseArgs(argv);
+    const envFiles = loadEnvFiles();
+    if (envFiles.length === 0) {
+        log.warn("no .env loaded — adapters needing secrets will fail");
+    }
+    else {
+        log.info({ envFiles }, "loaded env files");
+    }
+    const project = typeof flags["project"] === "string" ? flags["project"] : undefined;
+    if (!project)
+        usage();
+    const projectName = normalizeProjectName(project);
+    const repoRoot = resolveRepoRoot({
+        project: projectName,
+        ...(typeof flags["repo-root"] === "string" ? { flag: flags["repo-root"] } : {}),
+    });
+    const frontendArg = typeof flags["frontend"] === "string" ? flags["frontend"] : "discord";
+    const adapterNames = frontendArg
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    const adapters = adapterNames.map((name) => buildAdapter({ name, repoRoot }));
+    for (const adapter of adapters) {
+        await adapter.start();
+        log.info({ name: adapter.name }, "frontend adapter started");
+    }
+    const orchestratorEnabled = flags["no-orchestrator"] !== true;
+    const tierFlag = typeof flags["default-tier"] === "string" ? flags["default-tier"] : undefined;
+    const defaultTier = tierFlag === "haiku" || tierFlag === "sonnet" || tierFlag === "opus" ? tierFlag : "haiku";
+    let orchestrator;
+    if (orchestratorEnabled) {
+        orchestrator = new Orchestrator({
+            projectName,
+            repoRoot,
+            adapters,
+            defaultTier,
+            ...(flags["bypass-tightener"] === true ? { bypassTightener: true } : {}),
+        });
+        await orchestrator.start();
+        log.info({ defaultTier }, "orchestrator started");
+    }
+    console.log(`harness run: project=${projectName} repoRoot=${repoRoot} adapters=${adapterNames.join(",")} orchestrator=${orchestratorEnabled ? defaultTier : "off"} (Ctrl-C to stop)`);
+    let shuttingDown = false;
+    const shutdown = async (signal) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        log.info({ signal }, "shutdown signal received");
+        if (orchestrator) {
+            try {
+                await orchestrator.stop();
+            }
+            catch (err) {
+                log.error({ err: String(err) }, "orchestrator stop threw");
+            }
+        }
+        for (const adapter of adapters) {
+            try {
+                await adapter.stop();
+            }
+            catch (err) {
+                log.error({ err: String(err), adapter: adapter.name }, "adapter stop threw");
+            }
+        }
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+    await new Promise(() => {
+        /* idle until signal */
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/cli/scope.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `cairn scope <subcommand>` — scope-index commands.
+ *
+ *   cairn scope rebuild [--repo <path>]   — re-run mapper, rewrite scope-index.yaml
+ *
+ * Spec: BUILD_REPORT.md Gap 1 / DOCS_SPEC.md §3.8.
+ */
+export declare function scopeCli(argv: string[]): Promise<void>;

package/dist/cli/scope.js

@@ -0,0 +1,65 @@
+/**
+ * `cairn scope <subcommand>` — scope-index commands.
+ *
+ *   cairn scope rebuild [--repo <path>]   — re-run mapper, rewrite scope-index.yaml
+ *
+ * Spec: BUILD_REPORT.md Gap 1 / DOCS_SPEC.md §3.8.
+ */
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { rebuildScopeIndex } from "@isaacriehm/cairn-core";
+function usage() {
+    console.error("Usage: cairn scope <subcommand>\n" +
+        "  rebuild       re-run mapper LLM and rewrite scope-index.yaml\n" +
+        "                (--repo <path>?   defaults to cwd)\n");
+    process.exit(1);
+}
+function parseRepoFlag(argv) {
+    const idx = argv.indexOf("--repo");
+    if (idx === -1)
+        return process.cwd();
+    const candidate = argv[idx + 1];
+    if (candidate === undefined || candidate.startsWith("--")) {
+        console.error("--repo requires a path argument");
+        process.exit(2);
+    }
+    return resolve(candidate);
+}
+async function rebuildHandler(argv) {
+    const repoRoot = parseRepoFlag(argv);
+    if (!existsSync(repoRoot)) {
+        console.error(`cairn scope rebuild: repo root does not exist: ${repoRoot}`);
+        process.exit(2);
+    }
+    if (!existsSync(`${repoRoot}/.cairn`)) {
+        console.error(`cairn scope rebuild: ${repoRoot} is not cairn-adopted (no .cairn/). Run \`cairn init\` first.`);
+        process.exit(2);
+    }
+    process.stdout.write("⬡ cairn scope rebuild — running mapper LLM…\n");
+    try {
+        const result = await rebuildScopeIndex({ repoRoot });
+        const relPath = result.path.startsWith(repoRoot)
+            ? result.path.slice(repoRoot.length + 1)
+            : result.path;
+        process.stdout.write(`  ✓ wrote ${relPath} — ${result.filesClassified} file${result.filesClassified === 1 ? "" : "s"} classified  (${result.mapperDurationMs}ms, ${result.model})\n`);
+        process.exit(0);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`cairn scope rebuild: mapper failed — ${msg}`);
+        process.exit(1);
+    }
+}
+export async function scopeCli(argv) {
+    const sub = argv[0];
+    switch (sub) {
+        case "rebuild":
+            await rebuildHandler(argv.slice(1));
+            return;
+        case undefined:
+        default:
+            console.error(`cairn scope: unknown subcommand "${String(sub)}"`);
+            usage();
+    }
+}
+//# sourceMappingURL=scope.js.map

package/dist/cli/scope.js.map

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

package/dist/cli/task.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `harness task` — terminal-native task submit.
+ *
+ * Drops a `task` inbox row to the running daemon's mirror checkout. The
+ * orchestrator picks it up via chokidar (or the periodic poll). No
+ * Discord interaction required.
+ *
+ * Project resolution order:
+ *   1. --project <slug> flag
+ *   2. `.harness/config.yaml` in the current working directory
+ *   3. error out
+ *
+ * Operator workflow:
+ *   cd ~/myapp
+ *   harness task "build feature X" --acceptance "must do Y" --acceptance "must not Z"
+ *   # daemon picks up; status visible via /status in Discord
+ */
+export declare function taskCli(argv: string[]): Promise<void>;

package/dist/cli/task.js

@@ -0,0 +1,137 @@
+/**
+ * `harness task` — terminal-native task submit.
+ *
+ * Drops a `task` inbox row to the running daemon's mirror checkout. The
+ * orchestrator picks it up via chokidar (or the periodic poll). No
+ * Discord interaction required.
+ *
+ * Project resolution order:
+ *   1. --project <slug> flag
+ *   2. `.harness/config.yaml` in the current working directory
+ *   3. error out
+ *
+ * Operator workflow:
+ *   cd ~/myapp
+ *   harness task "build feature X" --acceptance "must do Y" --acceptance "must not Z"
+ *   # daemon picks up; status visible via /status in Discord
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { normalizeProjectName, readMirrorRecord, writeInboxRow, } from "@devplusllc/harness-core";
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                const existing = flags[key];
+                if (Array.isArray(existing)) {
+                    existing.push(next);
+                }
+                else if (typeof existing === "string") {
+                    flags[key] = [existing, next];
+                }
+                else {
+                    flags[key] = next;
+                }
+                i += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function usage() {
+    console.error("Usage: harness task <body> [options]\n" +
+        "  <body>                  task description (free text)\n" +
+        "  --project <slug>        project slug (default: read .harness/config.yaml in cwd)\n" +
+        "  --title <s>             override title (default: first 80 chars of body)\n" +
+        "  --acceptance <s>        acceptance criterion (repeat for multiple)\n" +
+        "  --ship-anyway           bypass spec-tightener gate (logged)\n" +
+        "  --target <glob>         target path glob (repeat for multiple)\n" +
+        "\n" +
+        "Drops a task inbox row to the daemon's mirror. Orchestrator picks it\n" +
+        "up automatically (no Discord required). Watch progress via Discord\n" +
+        "/status or `tail -F .harness/runs/active/<run-id>/log.jsonl`.");
+    process.exit(1);
+}
+function readProjectFromCwd() {
+    const configPath = resolve(process.cwd(), ".harness", "config.yaml");
+    if (!existsSync(configPath))
+        return undefined;
+    try {
+        const text = readFileSync(configPath, "utf8");
+        const parsed = parseYaml(text);
+        const slug = parsed["slug"];
+        return typeof slug === "string" ? slug : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function asStringArray(v) {
+    if (Array.isArray(v))
+        return v;
+    if (typeof v === "string")
+        return [v];
+    return [];
+}
+export async function taskCli(argv) {
+    const { positional, flags } = parseArgs(argv);
+    if (flags["help"] === true || flags["h"] === true)
+        usage();
+    const body = positional.join(" ").trim();
+    if (body.length === 0) {
+        console.error("harness task: <body> is required\n");
+        usage();
+    }
+    const slugRaw = typeof flags["project"] === "string"
+        ? flags["project"]
+        : readProjectFromCwd();
+    if (slugRaw === undefined || slugRaw.length === 0) {
+        console.error("harness task: --project required (no .harness/config.yaml in cwd)");
+        process.exit(2);
+    }
+    const project = normalizeProjectName(slugRaw);
+    const record = readMirrorRecord(project);
+    if (record === null) {
+        console.error(`harness task: no mirror record for project "${project}". Run "harness init" + "harness mirror init --project ${project}" first.`);
+        process.exit(2);
+    }
+    const titleRaw = typeof flags["title"] === "string" ? flags["title"] : undefined;
+    const title = titleRaw ?? body.slice(0, 80);
+    const acceptance = asStringArray(flags["acceptance"]);
+    const targetGlobs = asStringArray(flags["target"]);
+    const shipAnyway = flags["ship-anyway"] === true;
+    const taskPayload = {
+        task: {
+            rawText: body,
+            intent: "code_task",
+            authorId: "cli",
+            receivedAt: new Date().toISOString(),
+        },
+        title,
+        ...(acceptance.length > 0 ? { acceptance_criteria: acceptance } : {}),
+        ...(targetGlobs.length > 0 ? { target_path_globs: targetGlobs } : {}),
+        ...(shipAnyway ? { ship_anyway: true } : {}),
+    };
+    const file = await writeInboxRow({
+        repoRoot: record.mirrorPath,
+        source: "cli",
+        kind: "task",
+        payload: taskPayload,
+    });
+    process.stdout.write(`task queued for project "${project}"\n  inbox: ${file}\n  title: ${title}\n  body:  ${body.slice(0, 200)}${body.length > 200 ? "…" : ""}\n  acceptance: ${acceptance.length}\n  ship-anyway: ${shipAnyway}\n`);
+}
+//# sourceMappingURL=task.js.map

package/dist/cli/task.js.map

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

package/dist/cli/watch.d.ts

@@ -0,0 +1 @@
+export declare function watchCli(argv: string[]): Promise<void>;

package/dist/cli/watch.js

@@ -0,0 +1,73 @@
+import { resolve } from "node:path";
+import { logger, normalizeProjectName, readMirrorRecord } from "@devplusllc/harness-core";
+import { startDaemon } from "@devplusllc/harness-runtime";
+const log = logger("cli.watch");
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags[key] = next;
+                i += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function usage() {
+    console.error("Usage: harness watch --project <name> [--repo-root <path>] [--debounce-ms <n>]\n" +
+        "  --project      project slug (matches `harness mirror init --project ...`)\n" +
+        "  --repo-root    target dir to watch (default: mirror path from state)\n" +
+        "  --debounce-ms  debounce window before regen fires (default: 500)");
+    process.exit(1);
+}
+export async function watchCli(argv) {
+    const { flags } = parseArgs(argv);
+    const project = typeof flags["project"] === "string" ? flags["project"] : undefined;
+    if (project === undefined)
+        usage();
+    const projectName = normalizeProjectName(project);
+    const debounceMs = typeof flags["debounce-ms"] === "string" ? Number.parseInt(flags["debounce-ms"], 10) : 500;
+    let repoRoot;
+    if (typeof flags["repo-root"] === "string") {
+        repoRoot = resolve(flags["repo-root"]);
+    }
+    else {
+        const record = readMirrorRecord(projectName);
+        if (!record) {
+            console.error(`No mirror record for "${projectName}". Run \`harness mirror init\` first or pass --repo-root explicitly.`);
+            process.exit(1);
+        }
+        repoRoot = record.mirrorPath;
+    }
+    const handle = await startDaemon({
+        projectName,
+        repoRoot,
+        debounceMs: Number.isFinite(debounceMs) ? debounceMs : 500,
+    });
+    const shutdown = async (signal) => {
+        log.info({ signal }, "shutdown signal received");
+        await handle.stop();
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+    console.log(`harness watch: project=${projectName} root=${repoRoot} (Ctrl-C to stop)`);
+    // Keep the event loop alive until a signal arrives.
+    await new Promise(() => {
+        /* never resolves */
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/cli/watch.js.map

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

package/dist/decision-capture/capture.d.ts

@@ -0,0 +1,57 @@
+/**
+ * runDecisionCapture — orchestrates the full flow:
+ *
+ *   raw_text → extract → write draft → adapter dialog 🟢/🟡/🔴
+ *                                  ├── 🟢 commit  → acceptDraft → ledger
+ *                                  ├── 🟡 edit    → leave draft + return correction text
+ *                                  └── 🔴 reject  → rejectDraft → no record
+ *
+ * The dialog is supplied by the caller (typically a FrontendAdapter's
+ * requestDialog) so this entry point works equally well in tests with the
+ * stub adapter, in CLI with a TTY prompt, and in Discord with the real
+ * adapter.
+ */
+import type { FrontendAdapter } from "../frontend/index.js";
+import type { ClaudeTier } from "../claude/index.js";
+import { runDecisionExtractor } from "./extractor.js";
+import { proposeStrictAssertions } from "./refinement.js";
+import type { DecisionCaptureResult } from "./types.js";
+export interface RunDecisionCaptureArgs {
+    /** Repo root for the mirror checkout. */
+    repoRoot: string;
+    /** Raw operator text. */
+    rawText: string;
+    /** Operator id. */
+    authorId: string;
+    /** Source — `discord:slash:/direction` or `discord:free_text` etc. */
+    source: string;
+    /** ISO timestamp the message was received. Default = now. */
+    receivedAt?: string;
+    /** Tier for the extractor. Default = haiku. */
+    tier?: ClaudeTier;
+    /** Channel id to thread the confirm dialog through. */
+    channelId?: string;
+    /** Adapter that owns the confirm dialog. */
+    adapter: FrontendAdapter;
+    /** Confirm-dialog timeout. Default 60_000 ms. */
+    confirmTimeoutMs?: number;
+    /**
+     * Optional: override the extractor entry point. Smokes inject a stub so
+     * the smoke runs without burning claude quota when only the
+     * draft/confirm/ledger flow needs verifying.
+     */
+    extractorOverride?: typeof runDecisionExtractor;
+    /**
+     * Skip the post-commit refinement step. Defaults to false. The
+     * orchestrator's `bypassRefinement` mirrors this for production runs;
+     * smokes that don't care about refinement can flip it on.
+     */
+    bypassRefinement?: boolean;
+    /** Tier for the refinement proposer. Default = haiku. */
+    refinementTier?: ClaudeTier;
+    /** Refinement dialog timeout. Default 60_000 ms. */
+    refinementDialogTimeoutMs?: number;
+    /** Smokes inject a stub proposer to avoid burning claude quota. */
+    refinementProposerOverride?: typeof proposeStrictAssertions;
+}
+export declare function runDecisionCapture(args: RunDecisionCaptureArgs): Promise<DecisionCaptureResult>;