@n-dx/core 0.1.0

package/packages/hench/dist/cli/errors.d.ts

@@ -0,0 +1,55 @@
+/**
+ * CLI error handling — user-friendly errors with optional suggestions.
+ *
+ * Hench's CLIError extends the foundation CLIError from @n-dx/llm-client,
+ * providing a consistent error hierarchy across all n-dx packages.
+ */
+import { CLIError as BaseCLIError } from "../prd/llm-gateway.js";
+/**
+ * Hench CLI error — extends the foundation CLIError.
+ *
+ * Inherits from {@link BaseCLIError} (which extends ClaudeClientError),
+ * so `instanceof ClaudeClientError` checks work across the entire error hierarchy.
+ */
+export declare class CLIError extends BaseCLIError {
+    constructor(message: string, suggestion?: string);
+}
+/** Thrown when an epic specified by --epic flag is not found. */
+export declare class EpicNotFoundError extends CLIError {
+    readonly searchTerm: string;
+    readonly availableEpics: Array<{
+        id: string;
+        title: string;
+    }>;
+    constructor(searchTerm: string, availableEpics: Array<{
+        id: string;
+        title: string;
+    }>);
+}
+/**
+ * Format an error for CLI output. Returns lines to print to stderr.
+ * Never includes stack traces in the output.
+ */
+export declare function formatCLIError(err: unknown): string;
+/**
+ * Handle a CLI error: print it and exit.
+ * Drop-in replacement for catch blocks in CLI entry points.
+ */
+export declare function handleCLIError(err: unknown): never;
+/**
+ * Check that the claude CLI binary is available.
+ * If a custom path is provided (from unified config), checks that specific path.
+ * Otherwise checks for "claude" on PATH.
+ * Throws a CLIError with install instructions and API-provider fallback if missing.
+ */
+export declare function requireClaudeCLI(customPath?: string): void;
+/**
+ * Check that the selected vendor CLI binary is available.
+ * If a custom path is provided, checks that path; otherwise checks PATH.
+ */
+export declare function requireLLMCLI(vendor: "claude" | "codex", customPath?: string): void;
+/**
+ * Check that .hench/ exists in the given directory.
+ * Throws a CLIError with an init suggestion if missing.
+ */
+export declare function requireHenchDir(dir: string): void;

package/packages/hench/dist/cli/errors.js

@@ -0,0 +1,185 @@
+/**
+ * CLI error handling — user-friendly errors with optional suggestions.
+ *
+ * Hench's CLIError extends the foundation CLIError from @n-dx/llm-client,
+ * providing a consistent error hierarchy across all n-dx packages.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { CLIError as BaseCLIError, PROJECT_DIRS, isExecutableOnPath } from "../prd/llm-gateway.js";
+const HENCH_DIR = PROJECT_DIRS.HENCH;
+/**
+ * Hench CLI error — extends the foundation CLIError.
+ *
+ * Inherits from {@link BaseCLIError} (which extends ClaudeClientError),
+ * so `instanceof ClaudeClientError` checks work across the entire error hierarchy.
+ */
+export class CLIError extends BaseCLIError {
+    constructor(message, suggestion) {
+        super(message, suggestion);
+        this.name = "CLIError";
+    }
+}
+/** Thrown when an epic specified by --epic flag is not found. */
+export class EpicNotFoundError extends CLIError {
+    searchTerm;
+    availableEpics;
+    constructor(searchTerm, availableEpics) {
+        const epicList = availableEpics.length > 0
+            ? `\n\nAvailable epics:\n${availableEpics.map((e) => `  - ${e.title} (${e.id})`).join("\n")}`
+            : "\n\nNo epics found in PRD.";
+        super(`Epic not found: "${searchTerm}"`, `Use an epic ID or title from the PRD.${epicList}`);
+        this.name = "EpicNotFoundError";
+        this.searchTerm = searchTerm;
+        this.availableEpics = availableEpics;
+    }
+}
+/**
+ * Known error patterns mapped to user-friendly messages and suggestions.
+ * Each entry: [regex to match, user-friendly message, suggestion].
+ */
+const ERROR_HINTS = [
+    [
+        /System memory usage.*exceeds rejection threshold/,
+        "", // Use original message (already user-friendly)
+        "Close other applications to free memory.\n" +
+            "       To adjust thresholds: hench config guard.memoryThrottle.rejectThreshold <number>\n" +
+            "       To disable throttling: hench config guard.memoryThrottle.enabled false",
+    ],
+    [
+        /Concurrent process limit reached/,
+        "", // Use original message (already user-friendly)
+        "Active hench processes will release their locks when they finish.\n" +
+            "       To change the limit: hench config guard.maxConcurrentProcesses <number>",
+    ],
+    [
+        /ENOENT.*\.hench/,
+        "Hench directory not found.",
+        "Run 'n-dx init' to set up the project.",
+    ],
+    [
+        /ENOENT.*\.rex/,
+        "Rex directory not found.",
+        "Run 'n-dx init' to set up the project.",
+    ],
+    [
+        /ENOENT.*config\.json/,
+        "Configuration file not found.",
+        "Run 'n-dx init' to create default configuration.",
+    ],
+    [
+        /Invalid hench config|Invalid config\.json/,
+        "Configuration file is corrupted or has an invalid format.",
+        "Check .hench/config.json for syntax errors, or re-initialize with 'n-dx init'.",
+    ],
+    [
+        /Invalid run record/,
+        "Run record is corrupted or has an invalid format.",
+        "The run data in .hench/runs/ may be damaged. Check the file for syntax errors.",
+    ],
+    [
+        /EACCES/,
+        "Permission denied.",
+        "Check file permissions for the .hench/ directory.",
+    ],
+    [
+        /Unexpected token/,
+        "Failed to parse JSON file.",
+        "Check for syntax errors in the file, or re-initialize with 'n-dx init'.",
+    ],
+    [
+        /claude.*not found|ENOENT.*claude/i,
+        "Claude CLI not found.",
+        "Install it with: npm install -g @anthropic-ai/claude-code\n       Or switch to the API provider: n-dx config hench.provider api",
+    ],
+    [
+        /ANTHROPIC_API_KEY/,
+        "Anthropic API key not configured.",
+        "Set it via 'n-dx config claude.api_key <key>', the ANTHROPIC_API_KEY environment variable, or use 'n-dx config hench.provider cli' for Claude CLI mode.",
+    ],
+    [
+        /not found/i,
+        "", // Use original message
+        "Check the ID or path and try again.",
+    ],
+];
+/**
+ * Format an error for CLI output. Returns lines to print to stderr.
+ * Never includes stack traces in the output.
+ */
+export function formatCLIError(err) {
+    // CLIError hierarchy — catches both hench CLIError and TaskNotActionableError
+    // (which extends foundation CLIError from @n-dx/llm-client)
+    if (err instanceof BaseCLIError) {
+        let msg = `Error: ${err.message}`;
+        if (err.suggestion) {
+            msg += `\nHint: ${err.suggestion}`;
+        }
+        return msg;
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    // Check for known patterns
+    for (const [pattern, friendly, suggestion] of ERROR_HINTS) {
+        if (pattern.test(message)) {
+            const displayMsg = friendly || message;
+            return `Error: ${displayMsg}\nHint: ${suggestion}`;
+        }
+    }
+    // Generic fallback — show the message, never the stack
+    return `Error: ${message}`;
+}
+/**
+ * Handle a CLI error: print it and exit.
+ * Drop-in replacement for catch blocks in CLI entry points.
+ */
+export function handleCLIError(err) {
+    console.error(formatCLIError(err));
+    process.exit(1);
+}
+/**
+ * Check that the claude CLI binary is available.
+ * If a custom path is provided (from unified config), checks that specific path.
+ * Otherwise checks for "claude" on PATH.
+ * Throws a CLIError with install instructions and API-provider fallback if missing.
+ */
+export function requireClaudeCLI(customPath) {
+    requireLLMCLI("claude", customPath);
+}
+/**
+ * Check that the selected vendor CLI binary is available.
+ * If a custom path is provided, checks that path; otherwise checks PATH.
+ */
+export function requireLLMCLI(vendor, customPath) {
+    const binary = vendor === "codex" ? "codex" : "claude";
+    const installHint = vendor === "codex"
+        ? "Install Codex CLI and/or set a custom path: n-dx config llm.codex.cli_path /path/to/codex"
+        : "Install it with: npm install -g @anthropic-ai/claude-code\n" +
+            "  Set a custom path: n-dx config claude.cli_path /path/to/claude\n" +
+            "  Or switch to the API provider: n-dx config hench.provider api";
+    if (customPath) {
+        // If config value looks like a command name ("codex", "claude"), resolve on PATH.
+        // If it looks like a filesystem path (absolute/relative with slash), require that path.
+        const looksLikePath = customPath.includes("/") ||
+            customPath.includes("\\") ||
+            customPath.startsWith(".") ||
+            customPath.startsWith("~");
+        const exists = looksLikePath ? existsSync(customPath) : isExecutableOnPath(customPath);
+        if (!exists) {
+            throw new CLIError(`${vendor === "codex" ? "Codex" : "Claude"} CLI not found at configured path: ${customPath}`, installHint);
+        }
+        return;
+    }
+    if (!isExecutableOnPath(binary)) {
+        throw new CLIError(`${vendor === "codex" ? "Codex" : "Claude"} CLI not found.`, installHint);
+    }
+}
+/**
+ * Check that .hench/ exists in the given directory.
+ * Throws a CLIError with an init suggestion if missing.
+ */
+export function requireHenchDir(dir) {
+    if (!existsSync(join(dir, HENCH_DIR))) {
+        throw new CLIError(`Hench directory not found in ${dir}`, "Run 'n-dx init' to set up the project, or 'hench init' if using hench standalone.");
+    }
+}
+//# sourceMappingURL=errors.js.map

package/packages/hench/dist/cli/errors.js.map

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

package/packages/hench/dist/cli/help.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Command-specific help content for the hench CLI.
+ *
+ * Each command has a dedicated help definition that includes:
+ *   - Synopsis / usage pattern
+ *   - Relevant flags only
+ *   - 2–3 practical examples
+ *
+ * Uses the shared formatHelp() from @n-dx/llm-client for consistent
+ * presentation with semantic color coding across all n-dx packages.
+ *
+ * @module hench/cli/help
+ */
+/**
+ * Get the help text for a command without printing it.
+ * Returns null if the command has no dedicated help.
+ */
+export declare function getCommandHelp(command: string): string | null;
+/**
+ * Show command-specific help. Returns true if help was shown, false if
+ * the command has no dedicated help.
+ */
+export declare function showCommandHelp(command: string): boolean;

package/packages/hench/dist/cli/help.js

@@ -0,0 +1,186 @@
+/**
+ * Command-specific help content for the hench CLI.
+ *
+ * Each command has a dedicated help definition that includes:
+ *   - Synopsis / usage pattern
+ *   - Relevant flags only
+ *   - 2–3 practical examples
+ *
+ * Uses the shared formatHelp() from @n-dx/llm-client for consistent
+ * presentation with semantic color coding across all n-dx packages.
+ *
+ * @module hench/cli/help
+ */
+import { formatHelp } from "../prd/llm-gateway.js";
+/** Map of command name → help definition. */
+const COMMAND_DEFS = {
+    init: {
+        tool: "hench",
+        command: "init",
+        summary: "create .hench/ with default configuration",
+        usage: "hench init [dir]",
+        description: "Sets up .hench/ with config.json and a runs/ directory. If .hench/\n" +
+            "already exists, reports it and skips.",
+        examples: [
+            { command: "hench init", description: "Initialize in current directory" },
+            { command: "hench init ./my-project", description: "Initialize in a specific directory" },
+        ],
+        related: ["run", "config"],
+    },
+    run: {
+        tool: "hench",
+        command: "run",
+        summary: "execute a task from the Rex PRD",
+        usage: "hench run [options] [dir]",
+        description: "Picks the next actionable task from the PRD (or a specific one via --task),\n" +
+            "builds a brief, and runs an autonomous agent loop using Claude. The agent\n" +
+            "can read/write files, run commands, and update task status.",
+        options: [
+            { flag: "--task=<id>", description: "Target a specific Rex task ID" },
+            { flag: "--epic=<id|title>", description: "Only consider tasks within the specified epic" },
+            { flag: "--epic-by-epic", description: "Process epics sequentially, advancing when done" },
+            { flag: "--auto", description: "Skip interactive selection, autoselect by priority" },
+            { flag: "--iterations=<n>", description: "Run multiple tasks sequentially (e.g. --iterations=5)" },
+            { flag: "--loop", description: "Run continuously until all tasks complete or Ctrl+C" },
+            { flag: "--loop-pause=<ms>", description: "Pause between loop iterations (default: config value)" },
+            { flag: "--priority=<level>", description: "Override task scheduling priority (critical|high|medium|low)" },
+            { flag: "--dry-run", description: "Print the task brief without calling Claude" },
+            { flag: "--review", description: "Show proposed changes and prompt for approval" },
+            { flag: "--max-turns=<n>", description: "Override max agent turns per task" },
+            { flag: "--token-budget=<n>", description: "Cap total tokens per run (0 = unlimited)" },
+            { flag: "--model=<model>", description: "Override the Claude model" },
+        ],
+        examples: [
+            { command: "hench run", description: "Run next task (interactive selection)" },
+            { command: "hench run --task=abc123", description: "Run a specific task" },
+            { command: "hench run --epic=\"Auth\" --auto", description: "Auto-run tasks in the Auth epic" },
+            { command: "hench run --loop --epic-by-epic", description: "Continuously process epics in order" },
+            { command: "hench run --dry-run .", description: "Preview the brief without execution" },
+        ],
+        related: ["status", "show"],
+    },
+    status: {
+        tool: "hench",
+        command: "status",
+        summary: "show recent run history",
+        usage: "hench status [options] [dir]",
+        description: "Lists recent agent runs with their task, status, duration, and token usage.",
+        options: [
+            { flag: "--last=<n>", description: "Number of recent runs to show (default: 10)" },
+            { flag: "--format=json", description: "Output as JSON" },
+        ],
+        examples: [
+            { command: "hench status", description: "Show last 10 runs" },
+            { command: "hench status --last=20", description: "Show last 20 runs" },
+            { command: "hench status --format=json .", description: "Machine-readable output" },
+        ],
+        related: ["show", "run"],
+    },
+    show: {
+        tool: "hench",
+        command: "show",
+        summary: "show full details of a specific run",
+        usage: "hench show <run-id> [options] [dir]",
+        description: "Displays comprehensive details about a single agent run including task\n" +
+            "info, model, timing, turns, token usage, and the outcome.",
+        options: [
+            { flag: "--format=json", description: "Output as JSON" },
+        ],
+        examples: [
+            { command: "hench show abc123", description: "Show run details" },
+            { command: "hench show abc123 --format=json", description: "JSON output for scripting" },
+        ],
+        related: ["status"],
+    },
+    config: {
+        tool: "hench",
+        command: "config",
+        summary: "view or edit workflow configuration",
+        usage: [
+            "hench config [dir]",
+            "hench config <key> [dir]",
+            "hench config <key> <value> [dir]",
+            "hench config --interactive [dir]",
+        ],
+        description: "Manages .hench/config.json settings including provider, model, max turns,\n" +
+            "guard rules, retry behavior, and task selection preferences.",
+        options: [
+            { flag: "--interactive", description: "Launch interactive configuration menu" },
+            { flag: "--format=json", description: "Output current config as JSON" },
+        ],
+        examples: [
+            { command: "hench config", description: "Display all current settings" },
+            { command: "hench config model", description: "Show current model" },
+            { command: "hench config model claude-sonnet-4-6", description: "Set the model" },
+            { command: "hench config --interactive", description: "Interactive menu for all settings" },
+        ],
+        related: ["template"],
+    },
+    template: {
+        tool: "hench",
+        command: "template",
+        summary: "manage workflow templates",
+        usage: "hench template <subcommand> [id] [options] [dir]",
+        description: "Workflow templates are pre-configured sets of hench settings that can\n" +
+            "be applied to quickly switch between different execution strategies.",
+        sections: [
+            {
+                title: "Subcommands",
+                content: "list                  List all available templates (built-in and user)\n" +
+                    "show <id>             Show template details and settings\n" +
+                    "apply <id>            Apply a template to current config\n" +
+                    "save <id>             Save current config as a user template\n" +
+                    "delete <id>           Delete a user-defined template",
+            },
+        ],
+        options: [
+            { flag: "--name=\"...\"", description: "Template name (for save)" },
+            { flag: "--description=\"...\"", description: "Template description (for save)" },
+            { flag: "--format=json", description: "Output as JSON (for list, show)" },
+        ],
+        examples: [
+            { command: "hench template list", description: "List all templates" },
+            { command: "hench template apply cautious", description: "Apply the cautious template" },
+            { command: "hench template save my-setup --name=\"My Setup\" --description=\"Custom config\"", description: "Save current config as template" },
+        ],
+        related: ["config"],
+    },
+};
+/** Related commands for each hench command (shown as "See also"). */
+const RELATED_COMMANDS = {
+    init: ["run", "config"],
+    run: ["status", "show"],
+    status: ["show", "run"],
+    show: ["status"],
+    config: ["template"],
+    template: ["config"],
+};
+/**
+ * Get the help text for a command without printing it.
+ * Returns null if the command has no dedicated help.
+ */
+export function getCommandHelp(command) {
+    const def = COMMAND_DEFS[command];
+    if (!def)
+        return null;
+    const related = def.related && def.related.length > 0
+        ? def.related
+        : RELATED_COMMANDS[command];
+    const fullDef = {
+        ...def,
+        related: related && related.length > 0 ? related : undefined,
+    };
+    return formatHelp(fullDef);
+}
+/**
+ * Show command-specific help. Returns true if help was shown, false if
+ * the command has no dedicated help.
+ */
+export function showCommandHelp(command) {
+    const text = getCommandHelp(command);
+    if (!text)
+        return false;
+    console.log(text);
+    return true;
+}
+//# sourceMappingURL=help.js.map

package/packages/hench/dist/cli/help.js.map

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

package/packages/hench/dist/cli/index.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Hench CLI entry point.
+ *
+ * Package architecture — functional subzones:
+ *
+ *   cli/         CLI interface: arg parsing, command dispatch, output formatting
+ *   agent/       Core agent logic: run loops, brief assembly, review & analysis
+ *     lifecycle/ Agent execution loops and token tracking
+ *     planning/  Task brief assembly and system prompt generation
+ *     analysis/  Post-run review, summary, and stuck detection
+ *   tools/       Tool integrations: shell exec, file ops, git, Rex, test runner
+ *   guard/       Security: command allowlisting, path validation, shell blocking
+ *   store/       Persistence: run records, config I/O
+ *   schema/      Config schema and validation
+ *   types/       Shared type definitions
+ *   validation/  Completion validation rules
+ *
+ * @module hench/cli
+ */
+export {};

package/packages/hench/dist/cli/index.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+/**
+ * Hench CLI entry point.
+ *
+ * Package architecture — functional subzones:
+ *
+ *   cli/         CLI interface: arg parsing, command dispatch, output formatting
+ *   agent/       Core agent logic: run loops, brief assembly, review & analysis
+ *     lifecycle/ Agent execution loops and token tracking
+ *     planning/  Task brief assembly and system prompt generation
+ *     analysis/  Post-run review, summary, and stuck detection
+ *   tools/       Tool integrations: shell exec, file ops, git, Rex, test runner
+ *   guard/       Security: command allowlisting, path validation, shell blocking
+ *   store/       Persistence: run records, config I/O
+ *   schema/      Config schema and validation
+ *   types/       Shared type definitions
+ *   validation/  Completion validation rules
+ *
+ * @module hench/cli
+ */
+import { resolve } from "node:path";
+import { usage } from "./commands/constants.js";
+import { showCommandHelp } from "./help.js";
+import { CLIError, handleCLIError, requireHenchDir } from "./errors.js";
+import { setQuiet } from "./output.js";
+import { formatTypoSuggestion } from "../prd/llm-gateway.js";
+function parseArgs(argv) {
+    const flags = {};
+    const positional = [];
+    let command;
+    for (const arg of argv) {
+        if (arg.startsWith("--")) {
+            const eq = arg.indexOf("=");
+            if (eq !== -1) {
+                flags[arg.slice(2, eq)] = arg.slice(eq + 1);
+            }
+            else {
+                flags[arg.slice(2)] = "true";
+            }
+        }
+        else if (arg === "-h") {
+            flags.help = "true";
+        }
+        else if (arg === "-q") {
+            flags.quiet = "true";
+        }
+        else if (!command) {
+            command = arg;
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { command, positional, flags };
+}
+async function main() {
+    const { command, positional, flags } = parseArgs(process.argv.slice(2));
+    // Show help: per-command help when a command is given, else top-level usage.
+    if (!command) {
+        usage();
+        process.exit(0);
+    }
+    if (flags.help) {
+        if (!showCommandHelp(command)) {
+            usage();
+        }
+        process.exit(0);
+    }
+    setQuiet(flags.quiet === "true");
+    // Resolve dir: last positional arg or cwd
+    const resolveDir = () => {
+        const last = positional[positional.length - 1];
+        if (last && !last.startsWith("-")) {
+            return resolve(last);
+        }
+        return process.cwd();
+    };
+    try {
+        // Ensure .hench/ exists for all commands except init
+        if (command !== "init") {
+            requireHenchDir(resolveDir());
+        }
+        switch (command) {
+            case "init": {
+                const { cmdInit } = await import("./commands/init.js");
+                await cmdInit(resolveDir(), flags);
+                break;
+            }
+            case "run": {
+                const { cmdRun } = await import("./commands/run.js");
+                await cmdRun(resolveDir(), flags);
+                break;
+            }
+            case "status": {
+                const { cmdStatus } = await import("./commands/status.js");
+                await cmdStatus(resolveDir(), flags);
+                break;
+            }
+            case "show": {
+                const runId = positional[0];
+                if (!runId) {
+                    throw new CLIError("Missing run ID.", "Usage: hench show <run-id> [dir]");
+                }
+                const dir = positional.length > 1 ? resolve(positional[positional.length - 1]) : process.cwd();
+                const { cmdShow } = await import("./commands/show.js");
+                await cmdShow(dir, runId, flags);
+                break;
+            }
+            case "config": {
+                const { cmdConfig } = await import("./commands/config.js");
+                await cmdConfig(resolveDir(), positional, flags);
+                break;
+            }
+            case "template": {
+                const { cmdTemplate } = await import("./commands/template.js");
+                await cmdTemplate(resolveDir(), positional, flags);
+                break;
+            }
+            default: {
+                const HENCH_COMMANDS = ["init", "run", "status", "show", "config", "template"];
+                const typoHint = formatTypoSuggestion(command, HENCH_COMMANDS, "hench ");
+                throw new CLIError(`Unknown command: ${command}`, typoHint ?? "Run 'hench --help' to see available commands.");
+            }
+        }
+    }
+    catch (err) {
+        handleCLIError(err);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/packages/hench/dist/cli/index.js.map

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

package/packages/hench/dist/cli/output.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI output control — supports --quiet mode for scripting
+ * and structured section headers for streaming agent output.
+ *
+ * Re-exports from types/output.ts for backwards compatibility.
+ * The output utilities are now in a shared location to avoid
+ * circular dependencies between CLI and agent modules.
+ */
+export { setQuiet, isQuiet, info, result, section, subsection, stream, detail, } from "../types/output.js";

package/packages/hench/dist/cli/output.js

@@ -0,0 +1,10 @@
+/**
+ * CLI output control — supports --quiet mode for scripting
+ * and structured section headers for streaming agent output.
+ *
+ * Re-exports from types/output.ts for backwards compatibility.
+ * The output utilities are now in a shared location to avoid
+ * circular dependencies between CLI and agent modules.
+ */
+export { setQuiet, isQuiet, info, result, section, subsection, stream, detail, } from "../types/output.js";
+//# sourceMappingURL=output.js.map

package/packages/hench/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,MAAM,EACN,OAAO,EACP,UAAU,EACV,MAAM,EACN,MAAM,GACP,MAAM,oBAAoB,CAAC"}