ndrstnd 0.1.0

package/dist/server/artifact.js

@@ -0,0 +1,43 @@
+import { mkdir, readdir, rm, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createReviewPresentationData } from "./review-presentation.js";
+import { renderArtifact } from "../web/page.js";
+const artifactPrefix = "ndrstnd-";
+const maxArtifactAgeMs = 7 * 24 * 60 * 60 * 1000;
+export async function writeReviewArtifact(session, revision, options = {}) {
+    const directory = options.directory ?? defaultArtifactDirectory();
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    await cleanupArtifacts(directory, options.now);
+    const timestamp = (options.now ?? new Date()).toISOString().replace(/[:.]/g, "-");
+    const filePath = join(directory, `${artifactPrefix}${timestamp}-${revision.id.slice(0, 8)}.html`);
+    await writeFile(filePath, await renderArtifact(createReviewPresentationData(session, revision)), { encoding: "utf8", mode: 0o600 });
+    return filePath;
+}
+export async function cleanupArtifacts(directory = defaultArtifactDirectory(), now = new Date()) {
+    let entries;
+    try {
+        entries = await readdir(directory);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return;
+        throw error;
+    }
+    await Promise.all(entries.filter((entry) => entry.startsWith(artifactPrefix) && entry.endsWith(".html")).map(async (entry) => {
+        const path = join(directory, entry);
+        const metadata = await stat(path);
+        if (now.getTime() - metadata.mtime.getTime() > maxArtifactAgeMs)
+            await rm(path, { force: true });
+    }));
+}
+export function defaultArtifactDirectory() {
+    if (process.env.NDRSTND_ARTIFACT_DIR !== undefined)
+        return process.env.NDRSTND_ARTIFACT_DIR;
+    if (process.platform === "darwin")
+        return join(homedir(), "Library", "Application Support", "ndrstnd", "artifacts");
+    if (process.platform === "win32")
+        return join(process.env.LOCALAPPDATA ?? homedir(), "ndrstnd", "artifacts");
+    return join(process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share"), "ndrstnd", "artifacts");
+}
+//# sourceMappingURL=artifact.js.map

package/dist/server/artifact.js.map

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

package/dist/server/claude.d.ts

@@ -0,0 +1,29 @@
+import type { AgentClient, AgentTextThread, AuthStatus } from "./agent.js";
+/** Turns a stream-json event into reviewer-facing phrasing; undefined means the previous label still applies. */
+export declare function describeClaudeEvent(event: Record<string, unknown>): string | undefined;
+export declare function getClaudeAuthStatus(): Promise<AuthStatus>;
+/**
+ * Runs analysis turns through `claude --print`. Each turn is one short-lived
+ * process; follow-up turns (validation repairs) resume the same Claude Code
+ * session by ID so the inspection context is kept without resending the prompt.
+ */
+export declare class ClaudeCodeClient implements AgentClient {
+    private readonly inactivityTimeoutMs;
+    private closed;
+    private readonly active;
+    constructor(inactivityTimeoutMs?: number);
+    startTextThread(cwd: string): Promise<AgentTextThread>;
+    close(): void;
+    private runPrintTurn;
+    /** Kept as an instance method so tests can substitute a scripted child process. */
+    private spawnClaude;
+}
+/** The command override lets tests exercise the timeout without a real claude binary. */
+export declare function runClaudeCommand(args: string[], options?: {
+    timeoutMs?: number;
+    command?: string;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+}>;

package/dist/server/claude.js

@@ -0,0 +1,243 @@
+import { spawn } from "node:child_process";
+/** Turns a stream-json event into reviewer-facing phrasing; undefined means the previous label still applies. */
+export function describeClaudeEvent(event) {
+    if (event["type"] === "stream_event") {
+        const streamEvent = asObject(event["event"]);
+        return streamEvent["type"] === "content_block_delta" && asObject(streamEvent["delta"])["type"] === "text_delta" ? "drafting the narrative" : undefined;
+    }
+    if (event["type"] !== "assistant")
+        return undefined;
+    const content = asObject(event["message"])["content"];
+    const block = asObject(Array.isArray(content) ? content.at(-1) : undefined);
+    if (block["type"] === "text")
+        return "drafting the narrative";
+    if (block["type"] !== "tool_use")
+        return undefined;
+    const name = typeof block["name"] === "string" ? block["name"] : "";
+    const input = asObject(block["input"]);
+    if (name === "Bash" && typeof input["command"] === "string" && input["command"].trim() !== "")
+        return `running \`${compactText(input["command"])}\``;
+    if (name === "Read" && typeof input["file_path"] === "string")
+        return `reading ${compactText(input["file_path"])}`;
+    if (name === "Grep" || name === "Glob")
+        return "searching the repository";
+    return name === "" ? "inspecting the repository" : `using ${name}`;
+}
+function compactText(value) {
+    const collapsed = value.replace(/\s+/g, " ").trim();
+    return collapsed.length > 90 ? `${collapsed.slice(0, 87)}…` : collapsed;
+}
+export async function getClaudeAuthStatus() {
+    try {
+        const { stdout, stderr, exitCode } = await runClaudeCommand(["auth", "status", "--json"]);
+        const payload = parseJsonObject(stdout);
+        if (payload === undefined) {
+            throw new Error(exitCode === 0 ? "Claude Code returned an unreadable auth status." : `claude auth status exited with status ${exitCode}.${stderrHint(stderr)}`);
+        }
+        if (payload["loggedIn"] !== true)
+            return { state: "signed-out" };
+        const accountType = [payload["subscriptionType"], payload["authMethod"]].find((value) => typeof value === "string" && value !== "");
+        return { state: "signed-in", accountType: typeof accountType === "string" ? accountType : "unknown" };
+    }
+    catch (error) {
+        return { state: "unreachable", reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * Runs analysis turns through `claude --print`. Each turn is one short-lived
+ * process; follow-up turns (validation repairs) resume the same Claude Code
+ * session by ID so the inspection context is kept without resending the prompt.
+ */
+export class ClaudeCodeClient {
+    inactivityTimeoutMs;
+    closed = false;
+    active = new Set();
+    constructor(inactivityTimeoutMs = 300_000) {
+        this.inactivityTimeoutMs = inactivityTimeoutMs;
+    }
+    async startTextThread(cwd) {
+        let sessionId;
+        return {
+            send: async (prompt, onActivity) => {
+                const turn = await this.runPrintTurn(cwd, prompt, sessionId, onActivity);
+                sessionId = turn.sessionId ?? sessionId;
+                return turn.text;
+            },
+            // Print-mode turns end with their process; there is no server-side thread to archive.
+            close: async () => undefined,
+        };
+    }
+    close() {
+        this.closed = true;
+        for (const child of this.active)
+            child.kill();
+        this.active.clear();
+    }
+    runPrintTurn(cwd, prompt, resumeSessionId, onActivity) {
+        if (this.closed)
+            return Promise.reject(new Error("Claude Code client is not running."));
+        const args = [
+            "--print",
+            "--output-format", "stream-json",
+            "--verbose",
+            "--include-partial-messages",
+            // The analysis inspects the repository and must never edit it, run
+            // non-git commands, or reach configured MCP servers.
+            "--permission-mode", "dontAsk",
+            "--tools", "Read,Grep,Glob,Bash",
+            "--allowed-tools", "Read,Grep,Glob,Bash(git *)",
+            "--strict-mcp-config",
+        ];
+        if (resumeSessionId !== undefined)
+            args.push("--resume", resumeSessionId);
+        const child = this.spawnClaude(cwd, args);
+        this.active.add(child);
+        let stdoutBuffer = "";
+        let stderrTail = "";
+        let draft = "";
+        let events = 0;
+        let sessionId;
+        let result;
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            let timeout;
+            const settle = (outcome) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timeout);
+                this.active.delete(child);
+                child.kill();
+                outcome();
+            };
+            const failWith = (error) => settle(() => reject(error));
+            const armTimeout = () => {
+                // Inspecting a large branch takes many quiet-but-active tool turns, so
+                // time out on inactivity across any stream event rather than total duration.
+                clearTimeout(timeout);
+                timeout = setTimeout(() => failWith(new Error(`Claude Code analysis stalled: no CLI activity for ${Math.round(this.inactivityTimeoutMs / 1_000)}s after ${events} stream events and ${draft.length} draft characters.${stderrHint(stderrTail)}`)), this.inactivityTimeoutMs);
+            };
+            let label = "starting the analysis turn";
+            const handleEvent = (event) => {
+                events += 1;
+                armTimeout();
+                if (typeof event["session_id"] === "string" && sessionId === undefined)
+                    sessionId = event["session_id"];
+                if (event["type"] === "stream_event") {
+                    const streamEvent = asObject(event["event"]);
+                    const delta = asObject(streamEvent["delta"]);
+                    if (streamEvent["type"] === "content_block_delta" && delta["type"] === "text_delta" && typeof delta["text"] === "string") {
+                        draft += delta["text"];
+                    }
+                }
+                if (event["type"] === "result") {
+                    const denials = Array.isArray(event["permission_denials"]) ? event["permission_denials"].length : 0;
+                    result = {
+                        text: typeof event["result"] === "string" ? event["result"] : "",
+                        isError: event["is_error"] === true,
+                        detail: `${typeof event["subtype"] === "string" ? event["subtype"] : "an unreported failure"}${denials > 0 ? ` after ${denials} denied tool request${denials === 1 ? "" : "s"}` : ""}`,
+                    };
+                    return;
+                }
+                label = describeClaudeEvent(event) ?? label;
+                onActivity?.({ label, notifications: events, draftCharacters: draft.length });
+            };
+            const parseLine = (line) => {
+                if (line === "")
+                    return;
+                try {
+                    handleEvent(JSON.parse(line));
+                }
+                catch {
+                    // Ignore non-JSON noise on stdout.
+                }
+            };
+            child.stdout.on("data", (chunk) => {
+                stdoutBuffer += chunk.toString("utf8");
+                for (;;) {
+                    const newline = stdoutBuffer.indexOf("\n");
+                    if (newline === -1)
+                        return;
+                    const line = stdoutBuffer.slice(0, newline).trim();
+                    stdoutBuffer = stdoutBuffer.slice(newline + 1);
+                    parseLine(line);
+                }
+            });
+            child.stderr.on("data", (chunk) => {
+                stderrTail = `${stderrTail}${chunk.toString("utf8")}`.slice(-4_000);
+            });
+            child.once("error", (error) => failWith(new Error(`Claude Code could not run: ${error.message}${stderrHint(stderrTail)}`)));
+            child.once("close", (code) => {
+                // A final event is not guaranteed a trailing newline; drain it before judging the outcome.
+                parseLine(stdoutBuffer.trim());
+                stdoutBuffer = "";
+                const outcome = result;
+                if (outcome !== undefined && outcome.isError)
+                    return failWith(new Error(`Claude Code analysis turn failed: ${outcome.text !== "" ? outcome.text : outcome.detail}.${stderrHint(stderrTail)}`));
+                if (outcome === undefined)
+                    return failWith(new Error(`Claude Code exited with status ${code ?? "unknown"} before reporting a result.${stderrHint(stderrTail)}`));
+                settle(() => resolve({ text: outcome.text !== "" ? outcome.text : draft, sessionId }));
+            });
+            armTimeout();
+            // A process dying before it drains the prompt EPIPEs stdin; the close handler already reports that failure, so the stream error must not crash the CLI.
+            child.stdin.on("error", () => undefined);
+            child.stdin.end(prompt);
+        });
+    }
+    /** Kept as an instance method so tests can substitute a scripted child process. */
+    spawnClaude(cwd, args) {
+        return spawn("claude", args, { cwd, stdio: "pipe" });
+    }
+}
+/** The command override lets tests exercise the timeout without a real claude binary. */
+export function runClaudeCommand(args, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 60_000;
+    return new Promise((resolve, reject) => {
+        const child = spawn(options.command ?? "claude", args, { stdio: ["ignore", "pipe", "pipe"] });
+        let settled = false;
+        const timeout = setTimeout(() => {
+            settled = true;
+            child.kill();
+            reject(new Error(`claude ${args.join(" ")} did not answer within ${Math.round(timeoutMs / 1_000)}s.`));
+        }, timeoutMs);
+        timeout.unref();
+        const settle = (outcome) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            outcome();
+        };
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr = `${stderr}${chunk.toString("utf8")}`.slice(-4_000);
+        });
+        child.once("error", (error) => settle(() => reject(new Error(`Claude Code could not run: ${error.message}`))));
+        child.once("close", (exitCode) => settle(() => resolve({ stdout, stderr, exitCode })));
+    });
+}
+function parseJsonObject(text) {
+    const start = text.indexOf("{");
+    const end = text.lastIndexOf("}");
+    if (start === -1 || end <= start)
+        return undefined;
+    try {
+        const value = JSON.parse(text.slice(start, end + 1));
+        return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function stderrHint(tail) {
+    const trimmed = tail.trim().slice(-600);
+    return trimmed === "" ? "" : ` Claude Code reported: ${trimmed}`;
+}
+function asObject(value) {
+    return value !== null && typeof value === "object" ? value : {};
+}
+//# sourceMappingURL=claude.js.map

package/dist/server/claude.js.map

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

package/dist/server/cli-support.d.ts

@@ -0,0 +1,7 @@
+/** Chooses the platform opener; kept pure so the cmd.exe escaping stays testable. */
+export declare function browserOpenCommand(url: string, platform: NodeJS.Platform): {
+    command: string;
+    args: string[];
+};
+/** cmd.exe parses &, |, <, >, ^, ( and ) even inside start arguments; a path containing them would otherwise split the command line. */
+export declare function escapeCmdArgument(argument: string): string;

package/dist/server/cli-support.js

@@ -0,0 +1,13 @@
+/** Chooses the platform opener; kept pure so the cmd.exe escaping stays testable. */
+export function browserOpenCommand(url, platform) {
+    if (platform === "darwin")
+        return { command: "open", args: [url] };
+    if (platform === "win32")
+        return { command: "cmd", args: ["/c", "start", "", escapeCmdArgument(url)] };
+    return { command: "xdg-open", args: [url] };
+}
+/** cmd.exe parses &, |, <, >, ^, ( and ) even inside start arguments; a path containing them would otherwise split the command line. */
+export function escapeCmdArgument(argument) {
+    return argument.replace(/[&|^<>()]/g, "^$&");
+}
+//# sourceMappingURL=cli-support.js.map

package/dist/server/cli-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-support.js","sourceRoot":"","sources":["../../src/server/cli-support.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,QAAyB;IACvE,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IACnE,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACvG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,wIAAwI;AACxI,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC"}

package/dist/server/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server/cli.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { realpath } from "node:fs/promises";
+import process from "node:process";
+import { resolveReviewAgent, reviewAgents } from "./agent.js";
+import { analyzeWithAgent, formatAnalysisHeartbeat } from "./analyze.js";
+import { importConversation } from "./conversation.js";
+import { GitReader, describeReviewScope, ensureArtifactDirectoryIgnored } from "./git.js";
+import { ReviewStore, selectReusableRevision } from "./store.js";
+import { installSkill, installedSkillIsStale } from "./skill.js";
+import { writeReviewArtifact } from "./artifact.js";
+import { browserOpenCommand } from "./cli-support.js";
+import { packageVersion } from "./version.js";
+import { pathToFileURL } from "node:url";
+import { join, resolve } from "node:path";
+const [command, ...args] = process.argv.slice(2);
+if (command === undefined || command === "--help" || command === "-h") {
+    printHelp();
+}
+else if (command === "--version" || command === "-v" || command === "version") {
+    process.stdout.write(`ndrstnd ${await packageVersion()}\n`);
+}
+else if (command === "auth") {
+    await runAuth(args);
+}
+else if (command === "skill") {
+    await runSkill(args);
+}
+else if (command === "review") {
+    await runReview(args);
+}
+else {
+    fail(`Unknown command: ${command}`);
+}
+/** A typo in any flag must fail loudly; silently ignoring it would run the wrong review, agent, or install. */
+function parseCommandArgs(command, args, valueOptions, booleanOptions, maxPositional) {
+    const values = new Map();
+    const flags = new Set();
+    const positional = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (valueOptions.includes(argument)) {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("-"))
+                fail(`${argument} requires a value.`);
+            values.set(argument, value);
+            index += 1;
+            continue;
+        }
+        if (booleanOptions.includes(argument)) {
+            flags.add(argument);
+            continue;
+        }
+        if (argument.startsWith("-"))
+            fail(`Unknown ${command} option: ${argument}. Known options: ${[...valueOptions, ...booleanOptions].join(", ")}.`);
+        if (positional.length >= maxPositional)
+            fail(`Unexpected extra ${command} argument: ${argument}.`);
+        positional.push(argument);
+    }
+    return { positional, values, flags };
+}
+function wantsHelp(args) {
+    return args.includes("--help") || args.includes("-h");
+}
+function agentOptionFrom(values) {
+    const value = values.get("--agent");
+    if (value === undefined)
+        return undefined;
+    if (!reviewAgents.some((agent) => agent.id === value))
+        fail(`Unknown analysis agent: ${value}. Supported agents: ${reviewAgents.map((agent) => agent.id).join(", ")}.`);
+    return value;
+}
+async function runSkill(args) {
+    if (wantsHelp(args))
+        return printHelp();
+    const { positional, values, flags } = parseCommandArgs("skill", args, ["--agent"], ["--force"], 1);
+    if (positional[0] !== "install")
+        fail("Usage: ndrstnd skill install [--force] [--agent <codex|claude>]");
+    const installations = await installSkill(flags.has("--force"), agentOptionFrom(values)).catch((error) => fail(error instanceof Error ? error.message : String(error)));
+    for (const installation of installations) {
+        if (installation.status === "installed")
+            process.stdout.write(`Installed the ndrstnd skill for ${installation.agent.name} at ${installation.destination}.\n`);
+        else
+            process.stdout.write(`Skipped ${installation.agent.name}: ${installation.reason}.\n`);
+    }
+    if (!installations.some((installation) => installation.status === "installed")) {
+        fail("No skill was installed.");
+    }
+}
+async function runAuth(args) {
+    if (wantsHelp(args))
+        return printHelp();
+    const { positional, values } = parseCommandArgs("auth", args, ["--agent"], [], 1);
+    const action = positional[0] ?? "status";
+    const agentId = agentOptionFrom(values);
+    if (action === "status") {
+        const agents = agentId === undefined ? reviewAgents : reviewAgents.filter((agent) => agent.id === agentId);
+        for (const agent of agents) {
+            const status = await agent.getAuthStatus();
+            if (status.state === "signed-in")
+                process.stdout.write(`${agent.name} authentication is ready (${status.accountType}).\n`);
+            else if (status.state === "signed-out")
+                process.stdout.write(`${agent.name} is not signed in. Run \`ndrstnd auth login --agent ${agent.id}\`.\n`);
+            else
+                process.stdout.write(`${agent.name} authentication could not be checked: ${status.reason}\n`);
+        }
+        return;
+    }
+    if (action === "login") {
+        const agent = await resolveReviewAgent(agentId).catch((error) => fail(error instanceof Error ? error.message : String(error)));
+        const beforeLogin = await agent.getAuthStatus();
+        if (beforeLogin.state === "signed-in") {
+            process.stdout.write(`${agent.name} authentication is already ready (${beforeLogin.accountType}).\n`);
+            return;
+        }
+        await runAgentLogin(agent);
+        const afterLogin = await agent.getAuthStatus();
+        if (afterLogin.state === "signed-in")
+            process.stdout.write(`${agent.name} authentication is ready (${afterLogin.accountType}).\n`);
+        else
+            fail(`${agent.name} login completed but ndrstnd could not validate an authenticated connection.`);
+        return;
+    }
+    fail(`Unknown auth action: ${action}`);
+}
+async function runAgentLogin(agent) {
+    const child = spawn(agent.command, agent.loginArgs, { stdio: "inherit" });
+    const exitCode = await new Promise((resolve, reject) => {
+        child.once("error", reject);
+        child.once("exit", resolve);
+    });
+    if (exitCode !== 0) {
+        process.exitCode = exitCode ?? 1;
+    }
+}
+async function runReview(args) {
+    if (wantsHelp(args))
+        return printHelp();
+    const { positional, values, flags } = parseCommandArgs("review", args, ["--base", "--repo", "--conversation", "--agent"], ["--uncommitted", "--no-open", "--fresh"], 1);
+    const targetArg = positional[0];
+    const uncommitted = flags.has("--uncommitted");
+    const explicitBase = values.get("--base");
+    if (uncommitted && explicitBase !== undefined)
+        fail("--uncommitted already reviews against HEAD; do not combine it with --base.");
+    if (uncommitted && targetArg !== undefined)
+        fail("--uncommitted reviews the checked-out branch; do not pass a branch.");
+    const noOpen = flags.has("--no-open");
+    const repoPath = await canonicalRepoPath(values.get("--repo"));
+    const baseRef = uncommitted ? "HEAD" : explicitBase;
+    const agent = await resolveReviewAgent(values.get("--agent")).catch((error) => fail(error instanceof Error ? error.message : String(error)));
+    const conversationPath = values.get("--conversation");
+    const store = openReviewStore();
+    try {
+        const conversation = conversationPath === undefined ? undefined : await importConversation(conversationPath);
+        await ensureArtifactDirectoryIgnored(repoPath);
+        const input = await new GitReader().collectReviewInput(repoPath, targetArg, baseRef);
+        const meaningfulFiles = input.files.filter((file) => file.signal === "meaningful").length;
+        const scope = await describeReviewScope(repoPath, input);
+        process.stdout.write(`Reviewing ${scope.targetLabel} against ${input.baseRef}${input.includesWorkingTree ? ", including uncommitted changes" : ""}: ${input.files.length} changed file${input.files.length === 1 ? "" : "s"} (${meaningfulFiles} meaningful).\n`);
+        if (baseRef === undefined && input.includesWorkingTree && scope.localCommitsIncluded > 0) {
+            process.stdout.write(`Warning: the inferred base ${input.baseRef} is ${scope.localCommitsIncluded} commit${scope.localCommitsIncluded === 1 ? "" : "s"} behind ${scope.targetLabel}, so those commits are included. Pass --base to narrow the review, or --uncommitted for only uncommitted changes.\n`);
+        }
+        if (await installedSkillIsStale()) {
+            process.stdout.write("The installed ndrstnd skill is older than this version; run `ndrstnd skill install --force` to refresh it.\n");
+        }
+        const session = store.getOrCreateSession(input, conversation);
+        let revision = flags.has("--fresh") ? undefined : selectReusableRevision(store.listRevisions(session.id), agent.id);
+        if (revision !== undefined) {
+            process.stdout.write(`Reusing the ${agent.name} analysis cached ${formatRevisionAge(revision.createdAt)}; pass --fresh to re-analyze.\n`);
+        }
+        if (revision === undefined) {
+            const auth = await agent.getAuthStatus();
+            if (auth.state === "signed-out")
+                throw new Error(`${agent.name} is not signed in, so ndrstnd cannot analyze this change. Run \`ndrstnd auth login --agent ${agent.id}\` first.`);
+            if (auth.state === "unreachable")
+                throw new Error(`${agent.name} could not be reached, so ndrstnd cannot analyze this change: ${auth.reason}`);
+            process.stdout.write(`Drafting the review narrative with ${agent.name}… This takes minutes on large branches; a heartbeat line prints every 15 seconds while the analysis is alive.\n`);
+            const heartbeat = startAnalysisHeartbeat(agent);
+            try {
+                const document = await analyzeWithAgent(agent, input, conversation, heartbeat.progress);
+                revision = store.createRevision(session.id, agent.id, "complete", document);
+            }
+            catch (error) {
+                throw new Error(`${agent.name} analysis failed, so no review artifact was written: ${error instanceof Error ? error.message : String(error)} Nothing was persisted; re-run the same ndrstnd review command to retry.`);
+            }
+            finally {
+                heartbeat.stop();
+            }
+        }
+        process.stdout.write(`merge-base=${input.mergeBase.slice(0, 12)} files=${input.files.length} meaningful-files=${meaningfulFiles} hunks=${input.hunks.length}${conversation === undefined ? "" : ` conversation=${conversation.messages.length}`}\n`);
+        const artifactPath = await writeReviewArtifact(session, revision, { directory: join(repoPath, ".ndrstnd") });
+        process.stdout.write(`ndrstnd artifact: ${artifactPath}\n`);
+        process.stdout.write("This self-contained file is in the Git-ignored .ndrstnd directory; delete it when the review is done.\n");
+        if (!noOpen)
+            openBrowser(pathToFileURL(artifactPath).href);
+    }
+    catch (error) {
+        // fail() exits the process immediately, so the store must close first rather than in a finally.
+        store.close();
+        fail(error instanceof Error ? error.message : String(error));
+    }
+    store.close();
+}
+/** Resolving and de-symlinking the repository path keeps session identity independent of how the path was spelled. */
+async function canonicalRepoPath(repoArgument) {
+    const requested = resolve(repoArgument ?? process.cwd());
+    try {
+        return await realpath(requested);
+    }
+    catch {
+        fail(`The repository path ${requested} does not exist.`);
+    }
+}
+function formatRevisionAge(createdAt, now = Date.now()) {
+    const minutes = Math.max(0, Math.round((now - Date.parse(createdAt)) / 60_000));
+    if (minutes < 60)
+        return `${minutes} minute${minutes === 1 ? "" : "s"} ago`;
+    const hours = Math.round(minutes / 60);
+    if (hours < 48)
+        return `${hours} hour${hours === 1 ? "" : "s"} ago`;
+    const days = Math.round(hours / 24);
+    return `${days} day${days === 1 ? "" : "s"} ago`;
+}
+/** Prints liveness lines while the agent analyzes so a caller (human or agent) never mistakes a long turn for a hang. */
+function startAnalysisHeartbeat(agent) {
+    // Defined here because the top-level command dispatch runs before module-level consts initialize.
+    const HEARTBEAT_INTERVAL_MS = 15_000;
+    const startedAt = Date.now();
+    let latest;
+    let lastEventAt = startedAt;
+    const timer = setInterval(() => {
+        process.stdout.write(`${formatAnalysisHeartbeat(agent.name, Date.now() - startedAt, latest, Date.now() - lastEventAt)}\n`);
+    }, HEARTBEAT_INTERVAL_MS);
+    timer.unref();
+    return {
+        progress: {
+            onActivity: (activity) => {
+                latest = activity;
+                lastEventAt = Date.now();
+            },
+            onRepair: (attempt, attempts, problem) => {
+                process.stdout.write(`${agent.name}'s draft failed validation; requesting repair turn ${attempt} of ${attempts}: ${problem}\n`);
+            },
+        },
+        stop: () => clearInterval(timer),
+    };
+}
+function openReviewStore() {
+    try {
+        return new ReviewStore();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const hint = /NODE_MODULE_VERSION|compiled against a different Node\.js version/.test(message)
+            ? ` The review store's native SQLite module was built for a different Node.js than the current ${process.versions.node}; run \`npm rebuild better-sqlite3\` in the ndrstnd installation or reinstall ndrstnd.`
+            : "";
+        fail(`The ndrstnd review store could not open: ${message}${hint}`);
+    }
+}
+function openBrowser(url) {
+    const { command, args } = browserOpenCommand(url, process.platform);
+    const child = spawn(command, args, { detached: true, stdio: "ignore" });
+    // A machine without an opener (headless Linux) must not turn a finished review into a crash.
+    child.once("error", (error) => {
+        process.stdout.write(`Could not open a browser automatically (${error.message}); open the artifact path above manually.\n`);
+    });
+    child.unref();
+}
+function printHelp() {
+    process.stdout.write(`ndrstnd: understand agent-produced branch changes\n\nUsage:\n  ndrstnd auth <status|login> [--agent <codex|claude>]\n  ndrstnd skill install [--force] [--agent <codex|claude>]\n  ndrstnd review [branch] [--base <branch>] [--uncommitted] [--repo <path>] [--conversation <path>] [--agent <codex|claude>] [--fresh] [--no-open]\n  ndrstnd --version\n\nWithout a branch, ndrstnd reviews the checked-out branch including uncommitted changes.\n--uncommitted reviews only the uncommitted working-tree changes (an alias for --base HEAD).\n--agent picks the analysis agent; without it ndrstnd uses NDRSTND_AGENT, then the Codex or Claude Code session it runs inside, then the first installed CLI, preferring Codex.\n--fresh re-analyzes even when a cached analysis exists for the same input.\n`);
+}
+function fail(message) {
+    process.stderr.write(`${message}\n`);
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map