@n-dx/core 0.1.0

package/packages/hench/dist/agent/planning/prompt.js

@@ -0,0 +1,73 @@
+export function buildSystemPrompt(project, config) {
+    const lines = [];
+    const isCli = config.provider === "cli";
+    lines.push("You are Hench, an autonomous AI agent that implements software tasks.");
+    lines.push("You receive a task brief and use tools to implement it.\n");
+    lines.push("## Rules");
+    lines.push("1. Read existing code before modifying it. Understand context first.");
+    lines.push("2. Make minimal, focused changes. Don't refactor unrelated code.");
+    lines.push("3. Follow existing code patterns and conventions.");
+    lines.push("4. Run tests after making changes if a test command is configured.");
+    lines.push("5. Commit your work with clear commit messages.");
+    if (isCli) {
+        lines.push("6. Never modify .hench/, .rex/, or .git/ directories directly.");
+        lines.push("7. Stay within the project directory. Do not access files outside it.\n");
+    }
+    else {
+        lines.push("6. Update the task status when you're done.");
+        lines.push("7. If blocked by an external dependency, set status to 'blocked' and log the blocker.");
+        lines.push("   If postponing by choice, set status to 'deferred'.");
+        lines.push("8. Never modify .hench/, .rex/, or .git/ files directly.");
+        lines.push("9. Use rex_append_log to record significant actions and decisions.");
+        lines.push("10. If a task is too large, use rex_add_subtask to break it down.\n");
+    }
+    lines.push("## Project Info");
+    lines.push(`Project: ${project.name}`);
+    if (project.validateCommand) {
+        lines.push(`Validate command: \`${project.validateCommand}\``);
+    }
+    if (project.testCommand) {
+        lines.push(`Test command: \`${project.testCommand}\``);
+    }
+    lines.push("");
+    lines.push("## Workflow");
+    if (isCli) {
+        lines.push("1. Explore the codebase to understand context");
+        lines.push("2. Implement the changes described in the task brief");
+        lines.push("3. Run validation/tests if configured");
+        lines.push("4. Commit changes with git");
+        lines.push("5. Provide a summary of what you did\n");
+    }
+    else {
+        lines.push("1. Mark task as in_progress using rex_update_status");
+        lines.push("2. Explore the codebase to understand context");
+        lines.push("3. Implement the changes");
+        lines.push("4. Run validation/tests if configured");
+        lines.push("5. Commit changes with git");
+        lines.push("6. Mark task as completed using rex_update_status");
+        lines.push("7. Log a summary of what you did\n");
+    }
+    if (config.selfHeal) {
+        lines.push("## Self-Heal Mode");
+        lines.push("You are fixing a structural code issue found by static analysis.");
+        lines.push("- Make source code changes that address the root cause. Move files, extract modules, remove cross-zone imports, reduce coupling.");
+        lines.push("- Do NOT write ADR documents, markdown files, or architectural documentation as your primary deliverable.");
+        lines.push("- Configuration-only changes (eslint rules, tsconfig, zone pins) are acceptable only when they directly fix the detected issue.");
+        lines.push("- If the issue requires changes beyond a single task scope, set status to \"deferred\" with a specific reason. Do not fake completion.\n");
+    }
+    lines.push("## Error Handling");
+    lines.push("- If tests fail after your changes, read the failure output carefully, fix the issue, and re-run.");
+    lines.push("- If you encounter a test failure you did NOT cause (pre-existing), note it in the log and continue.");
+    lines.push("- If validation/build fails, fix it before committing — never commit broken code.");
+    lines.push("- If you're stuck after 3 attempts at the same problem, log what you tried and move on.\n");
+    if (!isCli) {
+        lines.push("## Tool Notes");
+        lines.push("- File paths are relative to the project root.");
+        lines.push(`- Allowed shell commands: ${config.guard.allowedCommands.join(", ")}`);
+        lines.push(`- Max file size: ${config.guard.maxFileSize} bytes`);
+        lines.push("- If a tool returns [GUARD], you hit a safety constraint. Adjust your approach.");
+        lines.push("- If a tool returns [ERROR], something failed. Check your inputs and retry or adjust.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=prompt.js.map

package/packages/hench/dist/agent/planning/prompt.js.map

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

package/packages/hench/dist/agent/prompt.d.ts

@@ -0,0 +1,2 @@
+import type { HenchConfig, TaskBriefProject } from "../schema/index.js";
+export declare function buildSystemPrompt(project: TaskBriefProject, config: HenchConfig): string;

package/packages/hench/dist/agent/prompt.js

@@ -0,0 +1,65 @@
+export function buildSystemPrompt(project, config) {
+    const lines = [];
+    const isCli = config.provider === "cli";
+    lines.push("You are Hench, an autonomous AI agent that implements software tasks.");
+    lines.push("You receive a task brief and use tools to implement it.\n");
+    lines.push("## Rules");
+    lines.push("1. Read existing code before modifying it. Understand context first.");
+    lines.push("2. Make minimal, focused changes. Don't refactor unrelated code.");
+    lines.push("3. Follow existing code patterns and conventions.");
+    lines.push("4. Run tests after making changes if a test command is configured.");
+    lines.push("5. Commit your work with clear commit messages.");
+    if (isCli) {
+        lines.push("6. Never modify .hench/, .rex/, or .git/ directories directly.");
+        lines.push("7. Stay within the project directory. Do not access files outside it.\n");
+    }
+    else {
+        lines.push("6. Update the task status when you're done.");
+        lines.push("7. If blocked by an external dependency, set status to 'blocked' and log the blocker.");
+        lines.push("   If postponing by choice, set status to 'deferred'.");
+        lines.push("8. Never modify .hench/, .rex/, or .git/ files directly.");
+        lines.push("9. Use rex_append_log to record significant actions and decisions.");
+        lines.push("10. If a task is too large, use rex_add_subtask to break it down.\n");
+    }
+    lines.push("## Project Info");
+    lines.push(`Project: ${project.name}`);
+    if (project.validateCommand) {
+        lines.push(`Validate command: \`${project.validateCommand}\``);
+    }
+    if (project.testCommand) {
+        lines.push(`Test command: \`${project.testCommand}\``);
+    }
+    lines.push("");
+    lines.push("## Workflow");
+    if (isCli) {
+        lines.push("1. Explore the codebase to understand context");
+        lines.push("2. Implement the changes described in the task brief");
+        lines.push("3. Run validation/tests if configured");
+        lines.push("4. Commit changes with git");
+        lines.push("5. Provide a summary of what you did\n");
+    }
+    else {
+        lines.push("1. Mark task as in_progress using rex_update_status");
+        lines.push("2. Explore the codebase to understand context");
+        lines.push("3. Implement the changes");
+        lines.push("4. Run validation/tests if configured");
+        lines.push("5. Commit changes with git");
+        lines.push("6. Mark task as completed using rex_update_status");
+        lines.push("7. Log a summary of what you did\n");
+    }
+    lines.push("## Error Handling");
+    lines.push("- If tests fail after your changes, read the failure output carefully, fix the issue, and re-run.");
+    lines.push("- If you encounter a test failure you did NOT cause (pre-existing), note it in the log and continue.");
+    lines.push("- If validation/build fails, fix it before committing — never commit broken code.");
+    lines.push("- If you're stuck after 3 attempts at the same problem, log what you tried and move on.\n");
+    if (!isCli) {
+        lines.push("## Tool Notes");
+        lines.push("- File paths are relative to the project root.");
+        lines.push(`- Allowed shell commands: ${config.guard.allowedCommands.join(", ")}`);
+        lines.push(`- Max file size: ${config.guard.maxFileSize} bytes`);
+        lines.push("- If a tool returns [GUARD], you hit a safety constraint. Adjust your approach.");
+        lines.push("- If a tool returns [ERROR], something failed. Check your inputs and retry or adjust.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=prompt.js.map

package/packages/hench/dist/agent/prompt.js.map

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

package/packages/hench/dist/agent/review.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Review mode — shows proposed changes and prompts for approval
+ * before committing task completion.
+ *
+ * The review gate sits between completion validation (changes exist,
+ * tests pass) and status updates (marking the task complete). When
+ * `--review` is active, the user sees a full diff and can approve
+ * or reject the agent's work.
+ */
+export interface ReviewResult {
+    approved: boolean;
+    /** Reason for rejection, if rejected. */
+    reason?: string;
+}
+export interface ReviewDiff {
+    /** Full diff output (git diff HEAD). */
+    diff: string;
+    /** Summary stat line (git diff --stat HEAD). */
+    stat: string;
+}
+/**
+ * Collect the current diff for review.
+ */
+export declare function collectReviewDiff(projectDir: string, timeout?: number): Promise<ReviewDiff>;
+/**
+ * Display the review UI and prompt for approval.
+ *
+ * Shows:
+ * 1. Diff stat summary
+ * 2. Full diff
+ * 3. Approve/reject prompt
+ *
+ * The `promptFn` parameter allows injection for testing.
+ */
+export declare function promptReview(reviewDiff: ReviewDiff, promptFn?: (question: string) => Promise<string>): Promise<ReviewResult>;
+/**
+ * Revert all uncommitted changes in the working tree.
+ * Used when the reviewer rejects the agent's work.
+ */
+export declare function revertChanges(projectDir: string, timeout?: number): Promise<void>;

package/packages/hench/dist/agent/review.js

@@ -0,0 +1,76 @@
+import { execFile } from "node:child_process";
+import { createInterface } from "node:readline";
+import { section, subsection, info } from "../types/output.js";
+const DEFAULT_TIMEOUT = 30_000;
+/**
+ * Run a shell command and return stdout.
+ */
+function exec(cmd, args, cwd, timeout) {
+    return new Promise((resolve) => {
+        execFile(cmd, args, { cwd, timeout, maxBuffer: 1024 * 1024 }, (_error, stdout) => {
+            resolve((stdout ?? "").toString());
+        });
+    });
+}
+/**
+ * Collect the current diff for review.
+ */
+export async function collectReviewDiff(projectDir, timeout = DEFAULT_TIMEOUT) {
+    const [diff, stat] = await Promise.all([
+        exec("git", ["diff", "HEAD"], projectDir, timeout),
+        exec("git", ["diff", "--stat", "HEAD"], projectDir, timeout),
+    ]);
+    return {
+        diff: diff.trim(),
+        stat: stat.trim(),
+    };
+}
+/**
+ * Display the review UI and prompt for approval.
+ *
+ * Shows:
+ * 1. Diff stat summary
+ * 2. Full diff
+ * 3. Approve/reject prompt
+ *
+ * The `promptFn` parameter allows injection for testing.
+ */
+export async function promptReview(reviewDiff, promptFn) {
+    section("Review");
+    subsection("Changes");
+    info(reviewDiff.stat);
+    subsection("Diff");
+    info(reviewDiff.diff);
+    info("");
+    const askUser = promptFn ?? defaultPrompt;
+    const answer = await askUser("Approve these changes? [Y/n] ");
+    const normalized = answer.trim().toLowerCase();
+    // Empty string or "y"/"yes" → approve; anything else → reject
+    if (normalized === "" || normalized === "y" || normalized === "yes") {
+        return { approved: true };
+    }
+    return {
+        approved: false,
+        reason: "Changes rejected by reviewer",
+    };
+}
+function defaultPrompt(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Revert all uncommitted changes in the working tree.
+ * Used when the reviewer rejects the agent's work.
+ */
+export async function revertChanges(projectDir, timeout = DEFAULT_TIMEOUT) {
+    // Unstage everything, then discard working tree changes + untracked files
+    await exec("git", ["reset", "HEAD", "."], projectDir, timeout);
+    await exec("git", ["checkout", "."], projectDir, timeout);
+    await exec("git", ["clean", "-fd"], projectDir, timeout);
+}
+//# sourceMappingURL=review.js.map

package/packages/hench/dist/agent/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/agent/review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAyB/D,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B;;GAEG;AACH,SAAS,IAAI,CACX,GAAW,EACX,IAAc,EACd,GAAW,EACX,OAAe;IAEf,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;YAC/E,OAAO,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,OAAO,GAAG,eAAe;IAEzB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC;QAClD,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC;KAC7D,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAsB,EACtB,QAAgD;IAEhD,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElB,UAAU,CAAC,SAAS,CAAC,CAAC;IACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAEtB,UAAU,CAAC,MAAM,CAAC,CAAC;IACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAEtB,IAAI,CAAC,EAAE,CAAC,CAAC;IAET,MAAM,OAAO,GAAG,QAAQ,IAAI,aAAa,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAE9D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE/C,8DAA8D;IAC9D,IAAI,UAAU,KAAK,EAAE,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACpE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,8BAA8B;KACvC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAC/B,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,OAAO,GAAG,eAAe;IAEzB,0EAA0E;IAC1E,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/D,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC"}

package/packages/hench/dist/agent/stuck.d.ts

@@ -0,0 +1,22 @@
+import type { RunRecord } from "../schema/index.js";
+/**
+ * Count the number of consecutive recent failures for a given task.
+ *
+ * Walks through runs most-recent-first (the array must be sorted by
+ * startedAt descending), filtering to the target taskId. Counts only
+ * hard failures (failed/timeout); stops at the first non-failure run.
+ */
+export declare function countRecentFailures(taskId: string, runs: RunRecord[]): number;
+/**
+ * Return true if a task has accumulated enough consecutive failures
+ * to be considered stuck.
+ */
+export declare function isStuckTask(taskId: string, runs: RunRecord[], threshold: number): boolean;
+/**
+ * Scan all runs and return the set of task IDs that are stuck
+ * (i.e. have ≥ threshold consecutive hard failures, most-recent-first).
+ *
+ * @param runs  Run records sorted by startedAt **descending**
+ * @param threshold  Number of consecutive failures before a task is stuck
+ */
+export declare function getStuckTaskIds(runs: RunRecord[], threshold: number): Set<string>;

package/packages/hench/dist/agent/stuck.js

@@ -0,0 +1,56 @@
+/**
+ * Statuses that count as a hard failure for stuck-task detection.
+ * Transient errors (API rate limits, network blips) do not count because
+ * they are expected to self-resolve on retry.
+ */
+const FAILURE_STATUSES = new Set(["failed", "timeout", "budget_exceeded"]);
+/**
+ * Count the number of consecutive recent failures for a given task.
+ *
+ * Walks through runs most-recent-first (the array must be sorted by
+ * startedAt descending), filtering to the target taskId. Counts only
+ * hard failures (failed/timeout); stops at the first non-failure run.
+ */
+export function countRecentFailures(taskId, runs) {
+    let count = 0;
+    for (const run of runs) {
+        if (run.taskId !== taskId)
+            continue;
+        if (FAILURE_STATUSES.has(run.status)) {
+            count++;
+        }
+        else {
+            break;
+        }
+    }
+    return count;
+}
+/**
+ * Return true if a task has accumulated enough consecutive failures
+ * to be considered stuck.
+ */
+export function isStuckTask(taskId, runs, threshold) {
+    return countRecentFailures(taskId, runs) >= threshold;
+}
+/**
+ * Scan all runs and return the set of task IDs that are stuck
+ * (i.e. have ≥ threshold consecutive hard failures, most-recent-first).
+ *
+ * @param runs  Run records sorted by startedAt **descending**
+ * @param threshold  Number of consecutive failures before a task is stuck
+ */
+export function getStuckTaskIds(runs, threshold) {
+    // Collect unique task IDs that have appeared in runs
+    const taskIds = new Set();
+    for (const run of runs) {
+        taskIds.add(run.taskId);
+    }
+    const stuck = new Set();
+    for (const taskId of taskIds) {
+        if (isStuckTask(taskId, runs, threshold)) {
+            stuck.add(taskId);
+        }
+    }
+    return stuck;
+}
+//# sourceMappingURL=stuck.js.map

package/packages/hench/dist/agent/stuck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck.js","sourceRoot":"","sources":["../../src/agent/stuck.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,gBAAgB,GAAgB,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAExF;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,IAAiB;IAEjB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS;QACpC,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,IAAiB,EACjB,SAAiB;IAEjB,OAAO,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAiB,EACjB,SAAiB;IAEjB,qDAAqD;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/packages/hench/dist/agent/summary.d.ts

@@ -0,0 +1,9 @@
+import type { ToolCallRecord, RunSummaryData } from "../schema/v1.js";
+/**
+ * Build a structured run summary from raw tool call records.
+ *
+ * This is a pure function — no I/O, no side effects. It derives
+ * structured metadata from the tool calls already recorded by the
+ * agent loop.
+ */
+export declare function buildRunSummary(toolCalls: ToolCallRecord[]): RunSummaryData;

package/packages/hench/dist/agent/summary.js

@@ -0,0 +1,106 @@
+/** Patterns that identify a command as a test invocation. */
+const TEST_PATTERNS = [
+    /\btest\b/i,
+    /\bvitest\b/i,
+    /\bjest\b/i,
+    /\bmocha\b/i,
+    /\bava\b/i,
+    /\btap\b/i,
+    /\bplaywright\b/i,
+    /\bcypress\b/i,
+];
+function isTestCommand(command) {
+    return TEST_PATTERNS.some((p) => p.test(command));
+}
+/** Glob-like args we skip when extracting file paths from git add. */
+const GLOB_ARGS = new Set([".", "-A", "--all", "-u", "--update"]);
+function inferExitStatus(output) {
+    if (output.startsWith("[GUARD]"))
+        return "blocked";
+    if (/timed out/i.test(output))
+        return "timeout";
+    if (output.startsWith("[ERROR]") || /exit code/i.test(output))
+        return "error";
+    return "ok";
+}
+/**
+ * Build a structured run summary from raw tool call records.
+ *
+ * This is a pure function — no I/O, no side effects. It derives
+ * structured metadata from the tool calls already recorded by the
+ * agent loop.
+ */
+export function buildRunSummary(toolCalls) {
+    const changedSet = new Set();
+    const readSet = new Set();
+    const commands = [];
+    const tests = [];
+    for (const call of toolCalls) {
+        switch (call.tool) {
+            case "write_file": {
+                const path = call.input.path;
+                if (path)
+                    changedSet.add(path);
+                break;
+            }
+            case "read_file": {
+                const path = call.input.path;
+                if (path)
+                    readSet.add(path);
+                break;
+            }
+            case "run_command": {
+                const cmd = call.input.command;
+                if (!cmd)
+                    break;
+                const exitStatus = inferExitStatus(call.output);
+                commands.push({ command: cmd, exitStatus, durationMs: call.durationMs });
+                if (isTestCommand(cmd)) {
+                    tests.push({
+                        command: cmd,
+                        passed: exitStatus === "ok",
+                        durationMs: call.durationMs,
+                    });
+                }
+                break;
+            }
+            case "git": {
+                const sub = call.input.subcommand;
+                const args = call.input.args;
+                if (!sub)
+                    break;
+                // Record as a command
+                const gitCmd = args ? `git ${sub} ${args}` : `git ${sub}`;
+                const exitStatus = inferExitStatus(call.output);
+                commands.push({ command: gitCmd, exitStatus, durationMs: call.durationMs });
+                // Extract file paths from git add
+                if (sub === "add" && args) {
+                    const parts = args.split(/\s+/).filter((p) => p && !GLOB_ARGS.has(p));
+                    for (const p of parts) {
+                        changedSet.add(p);
+                    }
+                }
+                break;
+            }
+            // list_directory, search_files, rex_* — no file/command tracking needed
+            default:
+                break;
+        }
+    }
+    const filesChanged = [...changedSet].sort();
+    const filesRead = [...readSet].sort();
+    return {
+        filesChanged,
+        filesRead,
+        commandsExecuted: commands,
+        testsRun: tests,
+        counts: {
+            filesRead: filesRead.length,
+            filesChanged: filesChanged.length,
+            commandsExecuted: commands.length,
+            testsRun: tests.length,
+            toolCallsTotal: toolCalls.length,
+        },
+    };
+}
+//# sourceMappingURL=summary.js.map

package/packages/hench/dist/agent/summary.js.map

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

package/packages/hench/dist/agent/test-runner.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Automatic test runner — identifies and runs relevant tests after task completion.
+ *
+ * Strategy:
+ * 1. From the list of changed files, find co-located test files
+ * 2. Run the project test command scoped to those files (if the runner supports it)
+ * 3. Fall back to the full test command if scoping isn't possible
+ * 4. Report results for inclusion in the run summary
+ */
+export interface PostRunTestResult {
+    /** Whether tests were executed at all. */
+    ran: boolean;
+    /** Whether all tests passed. */
+    passed: boolean;
+    /** The command that was executed. */
+    command?: string;
+    /** Human-readable summary of test output. */
+    output?: string;
+    /** How long the test run took in ms. */
+    durationMs?: number;
+    /** Test files that were targeted. Empty if full suite was run. */
+    targetedFiles: string[];
+    /** Error message if tests couldn't be run. */
+    error?: string;
+}
+export interface TestRunnerOptions {
+    /** Project root directory. */
+    projectDir: string;
+    /** Files changed during the task (relative paths). */
+    filesChanged: string[];
+    /** Configured test command (e.g. "pnpm test"). */
+    testCommand?: string;
+    /** Timeout for the test command in ms. Default: 120_000. */
+    timeout?: number;
+}
+/** Check if a path looks like a test file. */
+export declare function isTestFile(filePath: string): boolean;
+/**
+ * Given a source file path, generate candidate test file paths.
+ *
+ * For `src/agent/loop.ts`, generates:
+ * - `src/agent/loop.test.ts`
+ * - `src/agent/loop.spec.ts`
+ * - `src/agent/__tests__/loop.test.ts`
+ * - `tests/agent/loop.test.ts`  (mirrors src → tests)
+ * - etc.
+ */
+export declare function candidateTestPaths(filePath: string): string[];
+/**
+ * Find test files that exist on disk for the given changed files.
+ *
+ * Deduplicates at two levels:
+ * 1. Candidate paths — avoids redundant stat() calls when multiple source
+ *    files generate the same candidate.
+ * 2. Result paths — prevents the same test file appearing twice in the output,
+ *    even if reached through differently-formatted candidate paths.
+ */
+export declare function findRelevantTests(projectDir: string, filesChanged: string[]): Promise<string[]>;
+/**
+ * Extract the test runner name from a test command string.
+ * e.g. "pnpm test" → "pnpm", "npx vitest" → "vitest", "vitest run" → "vitest"
+ */
+export declare function detectRunner(testCommand: string): string | undefined;
+/**
+ * Build a scoped test command targeting specific files.
+ * Returns undefined if the runner doesn't support file scoping.
+ *
+ * Preserves existing flags (e.g. `jest --ci` → `jest --ci -- file.test.ts`).
+ * Deduplicates the vitest `run` subcommand when already present.
+ */
+export declare function buildScopedCommand(testCommand: string, runner: string, testFiles: string[]): string | undefined;
+/**
+ * Run relevant tests after task completion.
+ *
+ * 1. Skip if no test command is configured.
+ * 2. Discover test files related to changed source files.
+ * 3. If relevant tests found and runner supports scoping, run scoped.
+ * 4. Otherwise, run the full test command.
+ * 5. Return structured results.
+ */
+export declare function runPostTaskTests(options: TestRunnerOptions): Promise<PostRunTestResult>;