@n-dx/core 0.1.0

package/packages/hench/dist/store/templates.js

@@ -0,0 +1,119 @@
+/**
+ * Workflow template persistence — load, save, list, and delete user-defined
+ * templates stored in `.hench/templates.json`.
+ *
+ * Built-in templates are defined in schema/templates.ts and merged at read time
+ * so they always appear in listings but can never be overwritten or deleted.
+ */
+import { join } from "node:path";
+import { readFile, writeFile, access } from "node:fs/promises";
+import { BUILT_IN_TEMPLATES } from "../schema/templates.js";
+import { toCanonicalJSON } from "./json.js";
+const TEMPLATES_FILE = "templates.json";
+// ── Persistence ──────────────────────────────────────────────────────
+/** Load user-defined templates from .hench/templates.json. */
+async function loadUserTemplates(henchDir) {
+    const filePath = join(henchDir, TEMPLATES_FILE);
+    try {
+        await access(filePath);
+        const raw = await readFile(filePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed;
+    }
+    catch {
+        return [];
+    }
+}
+/** Write user-defined templates to .hench/templates.json. */
+async function saveUserTemplates(henchDir, templates) {
+    const filePath = join(henchDir, TEMPLATES_FILE);
+    await writeFile(filePath, toCanonicalJSON(templates), "utf-8");
+}
+// ── Public API ───────────────────────────────────────────────────────
+/**
+ * List all templates: built-in first, then user-defined.
+ * User templates with IDs that collide with built-in IDs are excluded.
+ */
+export async function listTemplates(henchDir) {
+    const builtInIds = new Set(BUILT_IN_TEMPLATES.map((t) => t.id));
+    const userTemplates = await loadUserTemplates(henchDir);
+    const filtered = userTemplates.filter((t) => !builtInIds.has(t.id));
+    return [...BUILT_IN_TEMPLATES, ...filtered];
+}
+/** Get a single template by ID (checks built-in first, then user). */
+export async function getTemplate(henchDir, id) {
+    const builtIn = BUILT_IN_TEMPLATES.find((t) => t.id === id);
+    if (builtIn)
+        return builtIn;
+    const userTemplates = await loadUserTemplates(henchDir);
+    return userTemplates.find((t) => t.id === id) ?? null;
+}
+/**
+ * Save a user-defined template. Rejects if the ID matches a built-in template.
+ * If a user template with the same ID exists, it is overwritten.
+ */
+export async function saveTemplate(henchDir, template) {
+    if (BUILT_IN_TEMPLATES.some((t) => t.id === template.id)) {
+        throw new Error(`Cannot overwrite built-in template "${template.id}"`);
+    }
+    const templates = await loadUserTemplates(henchDir);
+    const idx = templates.findIndex((t) => t.id === template.id);
+    const saved = {
+        ...template,
+        builtIn: false,
+        createdAt: template.createdAt ?? new Date().toISOString(),
+    };
+    if (idx >= 0) {
+        templates[idx] = saved;
+    }
+    else {
+        templates.push(saved);
+    }
+    await saveUserTemplates(henchDir, templates);
+}
+/**
+ * Delete a user-defined template by ID. Rejects if the ID is a built-in template.
+ * Returns true if a template was deleted, false if not found.
+ */
+export async function deleteTemplate(henchDir, id) {
+    if (BUILT_IN_TEMPLATES.some((t) => t.id === id)) {
+        throw new Error(`Cannot delete built-in template "${id}"`);
+    }
+    const templates = await loadUserTemplates(henchDir);
+    const before = templates.length;
+    const after = templates.filter((t) => t.id !== id);
+    if (after.length === before)
+        return false;
+    await saveUserTemplates(henchDir, after);
+    return true;
+}
+/**
+ * Apply a template's config overlay to an existing HenchConfig.
+ * Returns a new config with the template's fields merged in.
+ * The `schema` field is preserved from the original config.
+ */
+export function applyTemplate(config, overlay) {
+    const result = JSON.parse(JSON.stringify(config));
+    // Merge top-level scalar fields
+    for (const [key, value] of Object.entries(overlay)) {
+        if (key === "guard" || key === "retry")
+            continue;
+        result[key] = value;
+    }
+    // Deep merge guard
+    if (overlay.guard) {
+        result.guard = { ...result.guard, ...overlay.guard };
+    }
+    // Deep merge retry
+    if (overlay.retry) {
+        result.retry = { ...result.retry, ...overlay.retry };
+    }
+    return result;
+}
+/** Validate a template ID format (lowercase, hyphens, 2-50 chars). */
+export function isValidTemplateId(id) {
+    return /^[a-z][a-z0-9-]{1,49}$/.test(id);
+}
+//# sourceMappingURL=templates.js.map

package/packages/hench/dist/store/templates.js.map

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

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

@@ -0,0 +1,60 @@
+import type { PRDStore } from "../prd/rex-gateway.js";
+import type { SystemMemoryMonitor } from "../process/memory-monitor.js";
+/**
+ * Minimal guard contract required by tool handlers.
+ * GuardRails satisfies this interface.
+ */
+export interface ToolGuard {
+    checkPath(filepath: string): string;
+    checkCommand(command: string): void;
+    checkGitSubcommand(subcommand: string): void;
+    recordFileRead(filepath: string): void;
+    recordFileWrite(filepath: string, bytesWritten: number): void;
+    readonly maxFileSize: number;
+    readonly commandTimeout: number;
+}
+/**
+ * Context passed to tool implementations during agent execution.
+ */
+export interface ToolContext {
+    guard: ToolGuard;
+    projectDir: string;
+    store: PRDStore;
+    taskId: string;
+    /** Test command for completion validation (from project config). */
+    testCommand?: string;
+    /** Commit hash captured before the agent started, for diffing against. */
+    startingHead?: string;
+    /** System memory monitor for pre-spawn checks. */
+    memoryMonitor?: SystemMemoryMonitor;
+    /** When true, the agent is in self-heal mode (stricter completion validation). */
+    selfHeal?: boolean;
+}
+export interface RexUpdateStatusParams {
+    status: string;
+    reason?: string;
+    resolutionType?: string;
+}
+export interface RexAppendLogParams {
+    event: string;
+    detail?: string;
+}
+export interface RexAddSubtaskParams {
+    title: string;
+    description?: string;
+    priority?: string;
+}
+/**
+ * Agent-core provided handlers for Rex mutations.
+ * Tool dispatch depends on this interface instead of concrete Rex modules
+ * to avoid a reverse dependency into orchestration code.
+ */
+export interface RexToolHandlers {
+    updateStatus(ctx: ToolContext, params: RexUpdateStatusParams): Promise<string>;
+    appendLog(ctx: ToolContext, params: RexAppendLogParams): Promise<string>;
+    addSubtask(ctx: ToolContext, params: RexAddSubtaskParams): Promise<string>;
+}
+/**
+ * Result returned by tool implementations.
+ */
+export type ToolResult = string;

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

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

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * Tool dispatch — boundary between the agent core and the guard/tools layer.
+ *
+ * This module sits at the interface of two architectural zones within the hench
+ * package:
+ *
+ *   **agent-core (hench zone)** — agent lifecycle, schema, process execution
+ *   **guard+tools (hench-2 zone)** — GuardRails, filesystem/shell/git tool impls
+ *
+ * The coupling between these zones is intentional and managed:
+ *
+ * - **Agent core → guard+tools**: `loop.ts` instantiates GuardRails from the
+ *   guard module and creates a `ToolContext`; `tools/index.ts` re-exports the
+ *   concrete tool functions for use outside this directory.
+ * - **Guard+tools → agent core**: `tools/contracts.ts` exports `ToolGuard` (a
+ *   minimal interface satisfied by GuardRails) and `ToolContext`, so tool
+ *   implementations never import from agent-core directly.  `tools/git.ts` and
+ *   `tools/shell.ts` call `process/exec-shell.ts` for subprocess execution.
+ *
+ * The `ToolGuard` interface in `./contracts.ts` is the explicit shared boundary
+ * that decouples tool implementations from concrete GuardRails internals,
+ * following the same gateway pattern used elsewhere in the monorepo.
+ *
+ * @module
+ */
+import type Anthropic from "@anthropic-ai/sdk";
+import type { ToolContext, RexToolHandlers } from "./contracts.js";
+export declare const TOOL_DEFINITIONS: Anthropic.Tool[];
+export declare function dispatchTool(ctx: ToolContext, name: string, input: Record<string, unknown>, rexHandlers?: RexToolHandlers): Promise<string>;

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

@@ -0,0 +1,213 @@
+/**
+ * Tool dispatch — boundary between the agent core and the guard/tools layer.
+ *
+ * This module sits at the interface of two architectural zones within the hench
+ * package:
+ *
+ *   **agent-core (hench zone)** — agent lifecycle, schema, process execution
+ *   **guard+tools (hench-2 zone)** — GuardRails, filesystem/shell/git tool impls
+ *
+ * The coupling between these zones is intentional and managed:
+ *
+ * - **Agent core → guard+tools**: `loop.ts` instantiates GuardRails from the
+ *   guard module and creates a `ToolContext`; `tools/index.ts` re-exports the
+ *   concrete tool functions for use outside this directory.
+ * - **Guard+tools → agent core**: `tools/contracts.ts` exports `ToolGuard` (a
+ *   minimal interface satisfied by GuardRails) and `ToolContext`, so tool
+ *   implementations never import from agent-core directly.  `tools/git.ts` and
+ *   `tools/shell.ts` call `process/exec-shell.ts` for subprocess execution.
+ *
+ * The `ToolGuard` interface in `./contracts.ts` is the explicit shared boundary
+ * that decouples tool implementations from concrete GuardRails internals,
+ * following the same gateway pattern used elsewhere in the monorepo.
+ *
+ * @module
+ */
+import { toolReadFile, toolWriteFile, toolListDirectory, toolSearchFiles } from "./files.js";
+import { toolRunCommand } from "./shell.js";
+import { toolGit } from "./git.js";
+export const TOOL_DEFINITIONS = [
+    {
+        name: "read_file",
+        description: "Read the contents of a file at the given path.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "File path relative to project root" },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "write_file",
+        description: "Write content to a file. Creates parent directories if needed.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "File path relative to project root" },
+                content: { type: "string", description: "File content to write" },
+            },
+            required: ["path", "content"],
+        },
+    },
+    {
+        name: "list_directory",
+        description: "List files and directories at the given path.",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Directory path relative to project root" },
+                recursive: { type: "boolean", description: "List recursively (default: false)" },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "search_files",
+        description: "Search for a regex pattern across files in a directory.",
+        input_schema: {
+            type: "object",
+            properties: {
+                pattern: { type: "string", description: "Regex pattern to search for" },
+                path: { type: "string", description: "Directory path to search in" },
+                glob: { type: "string", description: "Glob pattern to filter files (e.g. '*.ts')" },
+            },
+            required: ["pattern", "path"],
+        },
+    },
+    {
+        name: "run_command",
+        description: "Run a shell command. Only allowlisted executables are permitted.",
+        input_schema: {
+            type: "object",
+            properties: {
+                command: { type: "string", description: "Shell command to execute" },
+                cwd: { type: "string", description: "Working directory (default: project root)" },
+                timeout: { type: "number", description: "Timeout in milliseconds" },
+            },
+            required: ["command"],
+        },
+    },
+    {
+        name: "git",
+        description: "Run a git subcommand. Allowed: status, add, commit, diff, log, branch, checkout, stash, show, rev-parse.",
+        input_schema: {
+            type: "object",
+            properties: {
+                subcommand: { type: "string", description: "Git subcommand to run" },
+                args: { type: "string", description: "Additional arguments" },
+            },
+            required: ["subcommand"],
+        },
+    },
+    {
+        name: "rex_update_status",
+        description: "Update the current task's status in Rex (pending, in_progress, completed, deferred).",
+        input_schema: {
+            type: "object",
+            properties: {
+                status: {
+                    type: "string",
+                    description: "New status",
+                    enum: ["pending", "in_progress", "completed", "deferred"],
+                },
+                resolutionType: {
+                    type: "string",
+                    description: "How the task was resolved (required when status=completed)",
+                    enum: ["code-change", "config-override", "acknowledgment"],
+                },
+            },
+            required: ["status"],
+        },
+    },
+    {
+        name: "rex_append_log",
+        description: "Append an entry to the Rex execution log for the current task.",
+        input_schema: {
+            type: "object",
+            properties: {
+                event: { type: "string", description: "Event type (e.g. 'implementation_started')" },
+                detail: { type: "string", description: "Optional detail text" },
+            },
+            required: ["event"],
+        },
+    },
+    {
+        name: "rex_add_subtask",
+        description: "Add a subtask under the current task in Rex.",
+        input_schema: {
+            type: "object",
+            properties: {
+                title: { type: "string", description: "Subtask title" },
+                description: { type: "string", description: "Subtask description" },
+                priority: {
+                    type: "string",
+                    description: "Priority level",
+                    enum: ["critical", "high", "medium", "low"],
+                },
+            },
+            required: ["title"],
+        },
+    },
+];
+/** Tools that spawn child processes and should be memory-checked. */
+const PROCESS_SPAWNING_TOOLS = new Set(["run_command", "git"]);
+/**
+ * Check system memory before spawning a child process.
+ * Returns an error message if memory is too high, or undefined if OK.
+ */
+async function checkSpawnMemory(ctx, toolName) {
+    if (!ctx.memoryMonitor || !PROCESS_SPAWNING_TOOLS.has(toolName))
+        return undefined;
+    const check = await ctx.memoryMonitor.checkBeforeSpawn();
+    if (!check.allowed) {
+        return `[MEMORY] ${check.reason}`;
+    }
+    return undefined;
+}
+export async function dispatchTool(ctx, name, input, rexHandlers) {
+    try {
+        // Pre-spawn memory check for process-spawning tools
+        const memoryBlock = await checkSpawnMemory(ctx, name);
+        if (memoryBlock)
+            return memoryBlock;
+        switch (name) {
+            case "read_file":
+                return await toolReadFile(ctx.guard, input);
+            case "write_file":
+                return await toolWriteFile(ctx.guard, input);
+            case "list_directory":
+                return await toolListDirectory(ctx.guard, input);
+            case "search_files":
+                return await toolSearchFiles(ctx.guard, input);
+            case "run_command":
+                return await toolRunCommand(ctx.guard, ctx.projectDir, input);
+            case "git":
+                return await toolGit(ctx.guard, ctx.projectDir, input);
+            case "rex_update_status":
+                if (!rexHandlers) {
+                    return "[ERROR] rex_update_status unavailable: no Rex handlers configured";
+                }
+                return await rexHandlers.updateStatus(ctx, input);
+            case "rex_append_log":
+                if (!rexHandlers) {
+                    return "[ERROR] rex_append_log unavailable: no Rex handlers configured";
+                }
+                return await rexHandlers.appendLog(ctx, input);
+            case "rex_add_subtask":
+                if (!rexHandlers) {
+                    return "[ERROR] rex_add_subtask unavailable: no Rex handlers configured";
+                }
+                return await rexHandlers.addSubtask(ctx, input);
+            default:
+                return `Unknown tool: ${name}`;
+        }
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "GuardError") {
+            return `[GUARD] ${err.message}`;
+        }
+        return `[ERROR] ${err.message}`;
+    }
+}
+//# sourceMappingURL=dispatch.js.map

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

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

package/packages/hench/dist/tools/exec-shell.d.ts

@@ -0,0 +1,23 @@
+export interface ExecShellOptions {
+    /** Shell command string to execute. */
+    command: string;
+    /** Working directory. */
+    cwd: string;
+    /** Timeout in milliseconds. */
+    timeout: number;
+    /** Maximum output buffer in bytes. Defaults to 1 MiB. */
+    maxBuffer?: number;
+    /** Spread into the child process env. Defaults to process.env. */
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Execute a shell command and return a formatted result string.
+ *
+ * Shared by `toolRunCommand` (run_command tool) and `toolGit` (git tool)
+ * to avoid duplicating the exec / output-formatting / timeout-guard
+ * boilerplate.
+ *
+ * Uses the foundation exec abstraction from @n-dx/llm-client under
+ * the hood, adding hench-specific output formatting on top.
+ */
+export declare function execShell(opts: ExecShellOptions): Promise<string>;

package/packages/hench/dist/tools/exec-shell.js

@@ -0,0 +1,29 @@
+import { exec } from "../process/exec.js";
+/**
+ * Execute a shell command and return a formatted result string.
+ *
+ * Shared by `toolRunCommand` (run_command tool) and `toolGit` (git tool)
+ * to avoid duplicating the exec / output-formatting / timeout-guard
+ * boilerplate.
+ *
+ * Uses the foundation exec abstraction from @n-dx/llm-client under
+ * the hood, adding hench-specific output formatting on top.
+ */
+export async function execShell(opts) {
+    const { command, cwd, timeout, maxBuffer = 1024 * 1024, env = { ...process.env }, } = opts;
+    const result = await exec("sh", ["-c", command], { cwd, timeout, maxBuffer, env });
+    // Timeout — exitCode is null when the process was killed
+    if (result.exitCode === null) {
+        return `Command timed out after ${timeout}ms`;
+    }
+    const output = [];
+    if (result.stdout)
+        output.push(result.stdout);
+    if (result.stderr)
+        output.push(`[stderr]\n${result.stderr}`);
+    if (result.error && !result.stdout && !result.stderr) {
+        output.push(`Exit code: ${result.exitCode ?? 1}`);
+    }
+    return output.join("\n").trim() || "(no output)";
+}
+//# sourceMappingURL=exec-shell.js.map

package/packages/hench/dist/tools/exec-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-shell.js","sourceRoot":"","sources":["../../src/tools/exec-shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAe1C;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAsB;IACpD,MAAM,EACJ,OAAO,EACP,GAAG,EACH,OAAO,EACP,SAAS,GAAG,IAAI,GAAG,IAAI,EACvB,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GACzB,GAAG,IAAI,CAAC;IAET,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAEnF,yDAAyD;IACzD,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,2BAA2B,OAAO,IAAI,CAAC;IAChD,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,aAAa,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { ToolGuard } from "./contracts.js";
+export declare function toolReadFile(guard: ToolGuard, params: {
+    path: string;
+}): Promise<string>;
+export declare function toolWriteFile(guard: ToolGuard, params: {
+    path: string;
+    content: string;
+}): Promise<string>;
+export declare function toolListDirectory(guard: ToolGuard, params: {
+    path: string;
+    recursive?: boolean;
+}): Promise<string>;
+export declare function toolSearchFiles(guard: ToolGuard, params: {
+    pattern: string;
+    path: string;
+    glob?: string;
+}): Promise<string>;

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

@@ -0,0 +1,111 @@
+import { readFile, writeFile, readdir, stat, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { simpleGlobMatch } from "../guard/paths.js";
+export async function toolReadFile(guard, params) {
+    const resolved = guard.checkPath(params.path);
+    const s = await stat(resolved);
+    if (s.size > guard.maxFileSize) {
+        throw new Error(`File exceeds max size (${s.size} > ${guard.maxFileSize}): ${params.path}`);
+    }
+    guard.recordFileRead(params.path);
+    return await readFile(resolved, "utf-8");
+}
+export async function toolWriteFile(guard, params) {
+    const resolved = guard.checkPath(params.path);
+    const contentSize = Buffer.byteLength(params.content, "utf-8");
+    if (contentSize > guard.maxFileSize) {
+        throw new Error(`Content exceeds max size (${contentSize} > ${guard.maxFileSize})`);
+    }
+    guard.recordFileWrite(params.path, contentSize);
+    await mkdir(dirname(resolved), { recursive: true });
+    await writeFile(resolved, params.content, "utf-8");
+    return `Wrote ${contentSize} bytes to ${params.path}`;
+}
+export async function toolListDirectory(guard, params) {
+    const resolved = guard.checkPath(params.path);
+    const entries = [];
+    async function listDir(dir, prefix) {
+        const items = await readdir(dir, { withFileTypes: true });
+        for (const item of items) {
+            const name = prefix ? `${prefix}/${item.name}` : item.name;
+            if (item.isDirectory()) {
+                entries.push(name + "/");
+                if (params.recursive) {
+                    await listDir(join(dir, item.name), name);
+                }
+            }
+            else {
+                entries.push(name);
+            }
+        }
+    }
+    await listDir(resolved, "");
+    return entries.join("\n");
+}
+export async function toolSearchFiles(guard, params) {
+    const resolved = guard.checkPath(params.path);
+    let regex;
+    try {
+        regex = new RegExp(params.pattern);
+    }
+    catch {
+        throw new Error(`Invalid regex pattern: ${params.pattern}`);
+    }
+    const results = [];
+    const MAX_RESULTS = 50;
+    async function searchDir(dir, prefix) {
+        if (results.length >= MAX_RESULTS)
+            return;
+        let items;
+        try {
+            items = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const item of items) {
+            if (results.length >= MAX_RESULTS)
+                break;
+            const name = prefix ? `${prefix}/${item.name}` : item.name;
+            if (item.isDirectory()) {
+                if (item.name === "node_modules" || item.name === ".git")
+                    continue;
+                await searchDir(join(dir, item.name), name);
+            }
+            else {
+                // Check glob filter if provided
+                if (params.glob && !simpleGlobMatch(params.glob, name)) {
+                    continue;
+                }
+                try {
+                    const filePath = join(dir, item.name);
+                    const s = await stat(filePath);
+                    if (s.size > guard.maxFileSize)
+                        continue;
+                    const content = await readFile(filePath, "utf-8");
+                    const lines = content.split("\n");
+                    for (let i = 0; i < lines.length; i++) {
+                        if (regex.test(lines[i])) {
+                            results.push(`${name}:${i + 1}: ${lines[i]}`);
+                            if (results.length >= MAX_RESULTS)
+                                break;
+                        }
+                    }
+                }
+                catch {
+                    // Skip files that can't be read (binary, permissions, etc)
+                }
+            }
+        }
+    }
+    await searchDir(resolved, "");
+    if (results.length === 0) {
+        return "No matches found";
+    }
+    const output = results.join("\n");
+    if (results.length >= MAX_RESULTS) {
+        return output + `\n... (truncated at ${MAX_RESULTS} results)`;
+    }
+    return output;
+}
+//# sourceMappingURL=files.js.map

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

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

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

@@ -0,0 +1,5 @@
+import type { ToolGuard } from "./contracts.js";
+export declare function toolGit(guard: ToolGuard, projectDir: string, params: {
+    subcommand: string;
+    args?: string;
+}): Promise<string>;