@n-dx/core 0.1.0

package/packages/hench/dist/agent/test-runner.js

@@ -0,0 +1,245 @@
+import { execFile } from "node:child_process";
+import { stat } from "node:fs/promises";
+import { dirname, join, basename, extname, normalize } from "node:path";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_TIMEOUT = 120_000;
+/** Common test file patterns — matches *.test.ts, *.spec.js, etc. */
+const TEST_FILE_PATTERNS = [
+    /\.test\.[jt]sx?$/,
+    /\.spec\.[jt]sx?$/,
+    /_test\.[jt]sx?$/,
+    /_spec\.[jt]sx?$/,
+];
+/** Test runners that support file-path arguments for scoped runs. */
+const SCOPEABLE_RUNNERS = {
+    vitest: (files) => ["run", ...files],
+    jest: (files) => ["--", ...files],
+    mocha: (files) => files,
+};
+/**
+ * Adjacent directories to search for tests relative to a source file.
+ * Ordered by convention prevalence.
+ */
+const TEST_DIR_CANDIDATES = [
+    "__tests__",
+    "tests",
+    "test",
+];
+// ---------------------------------------------------------------------------
+// Test file discovery
+// ---------------------------------------------------------------------------
+/** Check if a path looks like a test file. */
+export function isTestFile(filePath) {
+    return TEST_FILE_PATTERNS.some((p) => p.test(filePath));
+}
+/**
+ * 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 function candidateTestPaths(filePath) {
+    if (isTestFile(filePath))
+        return [filePath];
+    const dir = dirname(filePath);
+    const ext = extname(filePath);
+    const base = basename(filePath, ext);
+    const candidates = [];
+    // Co-located: same directory with .test/.spec suffix
+    for (const suffix of [".test", ".spec"]) {
+        candidates.push(join(dir, `${base}${suffix}${ext}`));
+    }
+    // Adjacent test directories
+    for (const testDir of TEST_DIR_CANDIDATES) {
+        for (const suffix of [".test", ".spec"]) {
+            candidates.push(join(dir, testDir, `${base}${suffix}${ext}`));
+        }
+    }
+    // Mirror src → tests: src/foo/bar.ts → tests/foo/bar.test.ts
+    const srcDirMatch = dir.match(/^(.*?)src[/\\](.*)/);
+    if (srcDirMatch) {
+        const [, prefix, rest] = srcDirMatch;
+        for (const testDir of TEST_DIR_CANDIDATES) {
+            for (const suffix of [".test", ".spec"]) {
+                candidates.push(join(prefix, testDir, rest, `${base}${suffix}${ext}`));
+            }
+        }
+    }
+    return candidates;
+}
+/**
+ * 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 async function findRelevantTests(projectDir, filesChanged) {
+    const seenCandidates = new Set();
+    const seenResults = new Set();
+    const results = [];
+    for (const file of filesChanged) {
+        const candidates = candidateTestPaths(file);
+        for (const candidate of candidates) {
+            const normalized = normalize(candidate);
+            if (seenCandidates.has(normalized))
+                continue;
+            seenCandidates.add(normalized);
+            try {
+                const fullPath = join(projectDir, normalized);
+                const s = await stat(fullPath);
+                if (s.isFile() && !seenResults.has(normalized)) {
+                    seenResults.add(normalized);
+                    results.push(normalized);
+                }
+            }
+            catch {
+                // File doesn't exist — skip
+            }
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Runner detection and scoping
+// ---------------------------------------------------------------------------
+/**
+ * Extract the test runner name from a test command string.
+ * e.g. "pnpm test" → "pnpm", "npx vitest" → "vitest", "vitest run" → "vitest"
+ */
+export function detectRunner(testCommand) {
+    const parts = testCommand.trim().split(/\s+/);
+    // Skip package manager wrappers to find the actual runner
+    for (const part of parts) {
+        const name = basename(part);
+        if (name in SCOPEABLE_RUNNERS)
+            return name;
+    }
+    return 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 function buildScopedCommand(testCommand, runner, testFiles) {
+    const scopeFn = SCOPEABLE_RUNNERS[runner];
+    if (!scopeFn)
+        return undefined;
+    const scopeArgs = scopeFn(testFiles);
+    const parts = testCommand.trim().split(/\s+/);
+    const runnerIdx = parts.findIndex((p) => basename(p) === runner);
+    if (runnerIdx >= 0) {
+        // Runner is explicitly in the command.
+        // Keep everything before AND after the runner, then append scope args.
+        const before = parts.slice(0, runnerIdx + 1);
+        const after = parts.slice(runnerIdx + 1);
+        // Deduplicate: if scope args start with a subcommand (e.g. "run")
+        // that is already present in the trailing args, strip it.
+        let mergedScope = scopeArgs;
+        if (after.length > 0 && scopeArgs.length > 0 && after[0] === scopeArgs[0]) {
+            mergedScope = scopeArgs.slice(1);
+        }
+        return [...before, ...after, ...mergedScope].join(" ");
+    }
+    // Package manager wrapper (e.g. "pnpm test") — append with --
+    return `${testCommand} -- ${testFiles.join(" ")}`;
+}
+// ---------------------------------------------------------------------------
+// Shell execution
+// ---------------------------------------------------------------------------
+function exec(cmd, args, cwd, timeout) {
+    return new Promise((resolve) => {
+        execFile(cmd, args, { cwd, timeout, maxBuffer: 2 * 1024 * 1024 }, (error, stdout, stderr) => {
+            const exitCode = error
+                ? error.code === "ETIMEDOUT"
+                    ? null
+                    : error.code ?? 1
+                : 0;
+            resolve({
+                stdout: (stdout ?? "").toString(),
+                stderr: (stderr ?? "").toString(),
+                exitCode: typeof exitCode === "number" ? exitCode : null,
+            });
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+/**
+ * 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 async function runPostTaskTests(options) {
+    const { projectDir, filesChanged, testCommand, timeout = DEFAULT_TIMEOUT } = options;
+    if (!testCommand) {
+        return { ran: false, passed: false, targetedFiles: [], error: "No test command configured" };
+    }
+    if (filesChanged.length === 0) {
+        return { ran: false, passed: false, targetedFiles: [], error: "No files changed" };
+    }
+    // Discover relevant test files
+    const testFiles = await findRelevantTests(projectDir, filesChanged);
+    // Determine if we can scope the run
+    const runner = detectRunner(testCommand);
+    let command;
+    let targetedFiles;
+    if (testFiles.length > 0 && runner) {
+        const scoped = buildScopedCommand(testCommand, runner, testFiles);
+        if (scoped) {
+            command = scoped;
+            targetedFiles = testFiles;
+        }
+        else {
+            command = testCommand;
+            targetedFiles = [];
+        }
+    }
+    else {
+        // Can't scope — run the full suite
+        command = testCommand;
+        targetedFiles = [];
+    }
+    const startMs = Date.now();
+    const { stdout, stderr, exitCode } = await exec("sh", ["-c", command], projectDir, timeout);
+    const durationMs = Date.now() - startMs;
+    const passed = exitCode === 0;
+    const output = truncateOutput(stdout, stderr, 2000);
+    return {
+        ran: true,
+        passed,
+        command,
+        output,
+        durationMs,
+        targetedFiles,
+        error: exitCode === null ? "Test command timed out" : undefined,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function truncateOutput(stdout, stderr, maxLen) {
+    // Prefer stdout (test results), fall back to stderr
+    const combined = stdout.trim() || stderr.trim();
+    if (combined.length <= maxLen)
+        return combined;
+    // Keep the last N characters (usually the summary is at the end)
+    return "…" + combined.slice(-(maxLen - 1));
+}
+//# sourceMappingURL=test-runner.js.map

package/packages/hench/dist/agent/test-runner.js.map

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

package/packages/hench/dist/agent/token-budget.d.ts

@@ -0,0 +1,18 @@
+import type { TokenUsage } from "../schema/index.js";
+export interface TokenBudgetResult {
+    /** Whether the token budget has been met or exceeded. */
+    exceeded: boolean;
+    /** Total tokens consumed (input + output). */
+    totalUsed: number;
+    /** The configured budget (undefined if unlimited). */
+    budget: number | undefined;
+    /** Tokens remaining before budget is hit (0 if exceeded or unlimited). */
+    remaining: number;
+}
+/**
+ * Check whether a token budget has been exceeded.
+ *
+ * A budget of 0 or undefined means unlimited — the check always passes.
+ * The budget is measured against total tokens (input + output combined).
+ */
+export declare function checkTokenBudget(usage: TokenUsage, budget: number | undefined): TokenBudgetResult;

package/packages/hench/dist/agent/token-budget.js

@@ -0,0 +1,16 @@
+/**
+ * Check whether a token budget has been exceeded.
+ *
+ * A budget of 0 or undefined means unlimited — the check always passes.
+ * The budget is measured against total tokens (input + output combined).
+ */
+export function checkTokenBudget(usage, budget) {
+    const totalUsed = usage.input + usage.output;
+    if (!budget) {
+        return { exceeded: false, totalUsed, budget: undefined, remaining: 0 };
+    }
+    const exceeded = totalUsed >= budget;
+    const remaining = Math.max(0, budget - totalUsed);
+    return { exceeded, totalUsed, budget, remaining };
+}
+//# sourceMappingURL=token-budget.js.map

package/packages/hench/dist/agent/token-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.js","sourceRoot":"","sources":["../../src/agent/token-budget.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAiB,EACjB,MAA0B;IAE1B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,IAAI,MAAM,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAElD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACpD,CAAC"}

package/packages/hench/dist/agent/token-usage.d.ts

@@ -0,0 +1,27 @@
+import type { TokenUsage } from "../schema/index.js";
+import { parseApiTokenUsage as parseTokenUsage, parseStreamTokenUsage } from "@n-dx/claude-client";
+export { parseTokenUsage, parseStreamTokenUsage };
+/** Aggregated token usage across multiple API calls. */
+export interface AggregateTokenUsage {
+    calls: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationInputTokens?: number;
+    cacheReadInputTokens?: number;
+}
+/** Create an empty AggregateTokenUsage accumulator. */
+export declare function emptyAggregateTokenUsage(): AggregateTokenUsage;
+/**
+ * Accumulate a single call's token usage into the aggregate.
+ *
+ * Always increments the call count, even when `usage` is undefined
+ * (e.g. when the API response omitted usage data).
+ */
+export declare function accumulateTokenUsage(aggregate: AggregateTokenUsage, usage?: TokenUsage): void;
+/**
+ * Format aggregate token usage for display.
+ *
+ * Returns empty string when no tokens were used.
+ * Single-call usage omits the call count; multi-call includes "across N calls".
+ */
+export declare function formatTokenUsage(usage: AggregateTokenUsage): string;

package/packages/hench/dist/agent/token-usage.js

@@ -0,0 +1,52 @@
+import { parseApiTokenUsage as parseTokenUsage, parseStreamTokenUsage, } from "@n-dx/claude-client";
+// Re-export parsing functions from the canonical source (@n-dx/claude-client).
+// `parseTokenUsage` is an alias for `parseApiTokenUsage` — same function,
+// kept here for backward-compatible imports within hench.
+export { parseTokenUsage, parseStreamTokenUsage };
+/** Create an empty AggregateTokenUsage accumulator. */
+export function emptyAggregateTokenUsage() {
+    return { calls: 0, inputTokens: 0, outputTokens: 0 };
+}
+/**
+ * Accumulate a single call's token usage into the aggregate.
+ *
+ * Always increments the call count, even when `usage` is undefined
+ * (e.g. when the API response omitted usage data).
+ */
+export function accumulateTokenUsage(aggregate, usage) {
+    aggregate.calls++;
+    if (!usage)
+        return;
+    aggregate.inputTokens += usage.input;
+    aggregate.outputTokens += usage.output;
+    if (usage.cacheCreationInput) {
+        aggregate.cacheCreationInputTokens =
+            (aggregate.cacheCreationInputTokens ?? 0) + usage.cacheCreationInput;
+    }
+    if (usage.cacheReadInput) {
+        aggregate.cacheReadInputTokens =
+            (aggregate.cacheReadInputTokens ?? 0) + usage.cacheReadInput;
+    }
+}
+/**
+ * Format aggregate token usage for display.
+ *
+ * Returns empty string when no tokens were used.
+ * Single-call usage omits the call count; multi-call includes "across N calls".
+ */
+export function formatTokenUsage(usage) {
+    if (usage.calls === 0 || (usage.inputTokens === 0 && usage.outputTokens === 0)) {
+        return "";
+    }
+    const total = usage.inputTokens + usage.outputTokens;
+    const parts = [
+        `${total.toLocaleString()} tokens`,
+        `(${usage.inputTokens.toLocaleString()} in`,
+        `/ ${usage.outputTokens.toLocaleString()} out)`,
+    ];
+    if (usage.calls > 1) {
+        parts.push(`across ${usage.calls} calls`);
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=token-usage.js.map

package/packages/hench/dist/agent/token-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-usage.js","sourceRoot":"","sources":["../../src/agent/token-usage.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,IAAI,eAAe,EACrC,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,+EAA+E;AAC/E,0EAA0E;AAC1E,0DAA0D;AAC1D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,CAAC;AAalD,uDAAuD;AACvD,MAAM,UAAU,wBAAwB;IACtC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAA8B,EAC9B,KAAkB;IAElB,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,SAAS,CAAC,WAAW,IAAI,KAAK,CAAC,KAAK,CAAC;IACrC,SAAS,CAAC,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC;IACvC,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC7B,SAAS,CAAC,wBAAwB;YAChC,CAAC,SAAS,CAAC,wBAAwB,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,kBAAkB,CAAC;IACzE,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,SAAS,CAAC,oBAAoB;YAC5B,CAAC,SAAS,CAAC,oBAAoB,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA0B;IACzD,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,YAAY,CAAC;IACrD,MAAM,KAAK,GAAG;QACZ,GAAG,KAAK,CAAC,cAAc,EAAE,SAAS;QAClC,IAAI,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE,KAAK;QAC3C,KAAK,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO;KAChD,CAAC;IAEF,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Backward-compatibility re-exports.
+ *
+ * Tool definitions and dispatch have moved to `../tools/dispatch.js`.
+ * This shim keeps existing imports working until all consumers migrate.
+ */
+export { TOOL_DEFINITIONS, dispatchTool } from "../tools/dispatch.js";
+export type { ToolContext } from "../tools/contracts.js";

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

@@ -0,0 +1,8 @@
+/**
+ * Backward-compatibility re-exports.
+ *
+ * Tool definitions and dispatch have moved to `../tools/dispatch.js`.
+ * This shim keeps existing imports working until all consumers migrate.
+ */
+export { TOOL_DEFINITIONS, dispatchTool } from "../tools/dispatch.js";
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/agent/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/packages/hench/dist/cli/commands/config.d.ts

@@ -0,0 +1,40 @@
+/**
+ * hench config — interactive workflow configuration command.
+ *
+ * Supports three modes:
+ *   hench config [dir]              — display current config
+ *   hench config <key> [dir]        — get a single value
+ *   hench config <key> <value> [dir] — set a single value
+ *   hench config --interactive [dir] — interactive menu
+ *
+ * All changes are validated before writing and persist to .hench/config.json.
+ */
+import type { HenchConfig } from "../../schema/v1.js";
+export interface ConfigFieldMeta {
+    path: string;
+    label: string;
+    description: string;
+    type: "string" | "number" | "boolean" | "enum" | "array";
+    enumValues?: string[];
+    category: "execution" | "retry" | "guard" | "task-selection" | "general";
+    /** Human-readable impact description shown when value changes. */
+    impact: (value: unknown) => string;
+}
+export declare const CONFIG_FIELDS: ConfigFieldMeta[];
+/** Get a nested value from config using dot-path notation. */
+export declare function getConfigValue(config: HenchConfig, path: string): unknown;
+/** Set a nested value in config using dot-path notation. Returns a new config object. */
+export declare function setConfigValue(config: HenchConfig, path: string, value: unknown): HenchConfig;
+/** Coerce a string value to the appropriate type based on field metadata. */
+export declare function coerceValue(raw: string, field: ConfigFieldMeta): unknown;
+export interface ConfigChangePreview {
+    field: ConfigFieldMeta;
+    oldValue: unknown;
+    newValue: unknown;
+    impact: string;
+}
+/** Generate a preview of the impact of changing a config value. */
+export declare function previewChange(config: HenchConfig, path: string, newValue: unknown): ConfigChangePreview | null;
+/** Format the full config as a readable display. */
+export declare function formatConfigDisplay(config: HenchConfig): string;
+export declare function cmdConfig(dir: string, positional: string[], flags: Record<string, string>): Promise<void>;