@n-dx/core 0.1.0

package/packages/hench/dist/schema/validate.js

@@ -0,0 +1,166 @@
+import { z } from "zod";
+const PolicyLimitsConfigSchema = z.object({
+    maxCommandsPerMinute: z.number().int().nonnegative().optional(),
+    maxWritesPerMinute: z.number().int().nonnegative().optional(),
+    maxTotalBytesWritten: z.number().int().nonnegative().optional(),
+    maxTotalCommands: z.number().int().nonnegative().optional(),
+}).optional();
+const MemoryThrottleConfigSchema = z.object({
+    enabled: z.boolean().optional(),
+    delayThreshold: z.number().min(0).max(100).optional(),
+    rejectThreshold: z.number().min(0).max(100).optional(),
+    baseDelayMs: z.number().positive().optional(),
+    maxDelayMs: z.number().positive().optional(),
+    maxRetries: z.number().int().nonnegative().optional(),
+}).optional();
+const MemoryMonitorConfigSchema = z.object({
+    enabled: z.boolean().optional(),
+    spawnThreshold: z.number().min(0).max(100).optional(),
+}).optional();
+const GuardConfigSchema = z.object({
+    blockedPaths: z.array(z.string()),
+    allowedCommands: z.array(z.string()),
+    commandTimeout: z.number().positive(),
+    maxFileSize: z.number().positive(),
+    spawnTimeout: z.number().nonnegative().optional().default(300000),
+    maxConcurrentProcesses: z.number().int().positive().optional().default(3),
+    allowedGitSubcommands: z.array(z.string()).optional().default([
+        "status", "add", "commit", "diff", "log",
+        "branch", "checkout", "stash", "show", "rev-parse",
+    ]),
+    policy: PolicyLimitsConfigSchema,
+    memoryThrottle: MemoryThrottleConfigSchema,
+    memoryMonitor: MemoryMonitorConfigSchema,
+});
+const RetryConfigSchema = z.object({
+    maxRetries: z.number().int().nonnegative(),
+    baseDelayMs: z.number().positive(),
+    maxDelayMs: z.number().positive(),
+});
+export const HenchConfigSchema = z.object({
+    schema: z.string(),
+    provider: z.enum(["cli", "api"]).default("cli"),
+    model: z.string(),
+    maxTurns: z.number().positive(),
+    maxTokens: z.number().positive(),
+    tokenBudget: z.number().int().nonnegative().optional().default(0),
+    rexDir: z.string(),
+    apiKeyEnv: z.string(),
+    guard: GuardConfigSchema,
+    retry: RetryConfigSchema.optional().default({
+        maxRetries: 3,
+        baseDelayMs: 2000,
+        maxDelayMs: 30000,
+    }),
+    loopPauseMs: z.number().int().nonnegative().optional().default(2000),
+    maxFailedAttempts: z.number().int().positive().optional().default(3),
+});
+const RunStatusSchema = z.enum(["running", "completed", "failed", "timeout", "budget_exceeded", "error_transient"]);
+const ToolCallRecordSchema = z.object({
+    turn: z.number(),
+    tool: z.string(),
+    input: z.record(z.unknown()),
+    output: z.string(),
+    durationMs: z.number(),
+});
+const TokenUsageSchema = z.object({
+    input: z.number(),
+    output: z.number(),
+    cacheCreationInput: z.number().optional(),
+    cacheReadInput: z.number().optional(),
+});
+const TurnTokenUsageSchema = z.object({
+    turn: z.number(),
+    input: z.number(),
+    output: z.number(),
+    cacheCreationInput: z.number().optional(),
+    cacheReadInput: z.number().optional(),
+    vendor: z.string().optional(),
+    model: z.string().optional(),
+});
+const CommandRecordSchema = z.object({
+    command: z.string(),
+    exitStatus: z.enum(["ok", "error", "timeout", "blocked"]),
+    durationMs: z.number(),
+});
+const TestRecordSchema = z.object({
+    command: z.string(),
+    passed: z.boolean(),
+    durationMs: z.number(),
+});
+const SummaryCountsSchema = z.object({
+    filesRead: z.number(),
+    filesChanged: z.number(),
+    commandsExecuted: z.number(),
+    testsRun: z.number(),
+    toolCallsTotal: z.number(),
+});
+const PostRunTestRecordSchema = z.object({
+    ran: z.boolean(),
+    passed: z.boolean(),
+    command: z.string().optional(),
+    output: z.string().optional(),
+    durationMs: z.number().optional(),
+    targetedFiles: z.array(z.string()),
+    error: z.string().optional(),
+});
+const RunSummaryDataSchema = z.object({
+    filesChanged: z.array(z.string()),
+    filesRead: z.array(z.string()),
+    commandsExecuted: z.array(CommandRecordSchema),
+    testsRun: z.array(TestRecordSchema),
+    postRunTests: PostRunTestRecordSchema.optional(),
+    counts: SummaryCountsSchema,
+});
+const RunMemoryStatsSchema = z.object({
+    peakRssBytes: z.number(),
+    systemAvailableAtStartBytes: z.number(),
+    systemAvailableAtEndBytes: z.number(),
+    systemTotalBytes: z.number(),
+});
+export const RunRecordSchema = z.object({
+    id: z.string(),
+    taskId: z.string(),
+    taskTitle: z.string(),
+    startedAt: z.string(),
+    finishedAt: z.string().optional(),
+    lastActivityAt: z.string().optional(),
+    status: RunStatusSchema,
+    turns: z.number(),
+    summary: z.string().optional(),
+    error: z.string().optional(),
+    tokenUsage: TokenUsageSchema,
+    turnTokenUsage: z.array(TurnTokenUsageSchema).optional(),
+    toolCalls: z.array(ToolCallRecordSchema),
+    model: z.string(),
+    retryAttempts: z.number().int().nonnegative().optional(),
+    structuredSummary: RunSummaryDataSchema.optional(),
+    memoryStats: RunMemoryStatsSchema.optional(),
+});
+export function validateConfig(data) {
+    const result = HenchConfigSchema.safeParse(data);
+    if (result.success) {
+        return { ok: true, data: result.data };
+    }
+    return { ok: false, errors: result.error };
+}
+export function validateRunRecord(data) {
+    const result = RunRecordSchema.safeParse(data);
+    if (result.success) {
+        return { ok: true, data: result.data };
+    }
+    return { ok: false, errors: result.error };
+}
+/**
+ * Format Zod validation errors into clear, actionable messages.
+ *
+ * Each error includes the field path and what was expected, making it
+ * easy to pinpoint and fix the issue.
+ */
+export function formatValidationErrors(errors) {
+    return errors.issues.map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+        return `${path}: ${issue.message}`;
+    });
+}
+//# sourceMappingURL=validate.js.map

package/packages/hench/dist/schema/validate.js.map

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

package/packages/hench/dist/shared/glob.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Simple glob matching — supports *, **, and ? patterns.
+ * No external dependency needed.
+ *
+ * - `*`  matches anything except `/` (single path segment)
+ * - `**` matches any number of path segments (including zero)
+ * - `?`  matches exactly one character except `/`
+ *
+ * A trailing `/**` also matches the directory itself (e.g. `.git/**` matches `.git`).
+ */
+export declare function simpleGlobMatch(pattern: string, filepath: string): boolean;

package/packages/hench/dist/shared/glob.js

@@ -0,0 +1,57 @@
+/**
+ * Simple glob matching — supports *, **, and ? patterns.
+ * No external dependency needed.
+ *
+ * - `*`  matches anything except `/` (single path segment)
+ * - `**` matches any number of path segments (including zero)
+ * - `?`  matches exactly one character except `/`
+ *
+ * A trailing `/**` also matches the directory itself (e.g. `.git/**` matches `.git`).
+ */
+export function simpleGlobMatch(pattern, filepath) {
+    // Normalize separators
+    const p = pattern.replace(/\\/g, "/");
+    const f = filepath.replace(/\\/g, "/");
+    const regexParts = [];
+    let i = 0;
+    while (i < p.length) {
+        if (p[i] === "*" && p[i + 1] === "*") {
+            // ** matches any number of path segments
+            if (p[i + 2] === "/") {
+                regexParts.push("(?:.+/)?");
+                i += 3;
+            }
+            else {
+                // Terminal ** — also match the parent directory itself.
+                // "dir/**" should match "dir", "dir/foo", "dir/foo/bar"
+                // Look back: if preceded by "/", make the "/" and everything after optional
+                if (i >= 1 && p[i - 1] === "/") {
+                    // Replace the trailing "/" already emitted with an optional group
+                    const lastPart = regexParts.pop();
+                    regexParts.push("(?:" + lastPart + ".*)?");
+                }
+                else {
+                    regexParts.push(".*");
+                }
+                i += 2;
+            }
+        }
+        else if (p[i] === "*") {
+            // * matches anything except /
+            regexParts.push("[^/]*");
+            i++;
+        }
+        else if (p[i] === "?") {
+            regexParts.push("[^/]");
+            i++;
+        }
+        else {
+            // Escape regex special chars
+            regexParts.push(p[i].replace(/[.+^${}()|[\]\\]/g, "\\$&"));
+            i++;
+        }
+    }
+    const regex = new RegExp("^" + regexParts.join("") + "$");
+    return regex.test(f);
+}
+//# sourceMappingURL=glob.js.map

package/packages/hench/dist/shared/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/shared/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,QAAgB;IAC/D,uBAAuB;IACvB,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEvC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACrC,yCAAyC;YACzC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACrB,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC5B,CAAC,IAAI,CAAC,CAAC;YACT,CAAC;iBAAM,CAAC;gBACN,wDAAwD;gBACxD,wDAAwD;gBACxD,4EAA4E;gBAC5E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC/B,kEAAkE;oBAClE,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAG,CAAC;oBACnC,UAAU,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;gBAC7C,CAAC;qBAAM,CAAC;oBACN,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,CAAC;gBACD,CAAC,IAAI,CAAC,CAAC;YACT,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACxB,8BAA8B;YAC9B,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACxB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,CAAC;YACN,6BAA6B;YAC7B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;YAC3D,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/packages/hench/dist/store/adjustments.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Adaptive adjustment persistence — stores adjustment history, settings,
+ * and override state for the adaptive workflow system.
+ *
+ * State is stored in `.hench/adaptive.json`.
+ *
+ * @internal This module is infrastructure for a planned adaptive workflow
+ * feature. It is not yet integrated into the agent loop. All exports are
+ * internal — do not depend on them from outside this package.
+ */
+import type { AdaptiveSettings } from "../agent/analysis/adaptive.js";
+/** @internal */
+export type AdjustmentDecision = "applied" | "dismissed" | "overridden";
+/** @internal */
+export interface AdjustmentRecord {
+    /** The adjustment ID (matches WorkflowAdjustment.id). */
+    adjustmentId: string;
+    /** Short title for human reference. */
+    title: string;
+    /** Category of the adjustment. */
+    category: string;
+    /** The config key that was adjusted. */
+    configKey: string;
+    /** What happened. */
+    decision: AdjustmentDecision;
+    /** Value before adjustment (if applied). */
+    previousValue?: unknown;
+    /** Value after adjustment (if applied). */
+    newValue?: unknown;
+    /** Whether this was automatic or user-initiated. */
+    automatic: boolean;
+    /** ISO timestamp. */
+    timestamp: string;
+}
+/** @internal */
+export interface AdaptiveState {
+    settings: AdaptiveSettings;
+    history: AdjustmentRecord[];
+    /** Manual overrides: config key → value locked by user. */
+    overrides: Record<string, unknown>;
+}
+/** Load adaptive state from disk (sync). Returns defaults if missing. @internal */
+export declare function loadAdaptiveState(henchDir: string): AdaptiveState;
+/** Load adaptive state from disk (async). Returns defaults if missing. @internal */
+export declare function loadAdaptiveStateAsync(henchDir: string): Promise<AdaptiveState>;
+/** Save adaptive state to disk (sync). @internal */
+export declare function saveAdaptiveState(henchDir: string, state: AdaptiveState): void;
+/** Save adaptive state to disk (async). @internal */
+export declare function saveAdaptiveStateAsync(henchDir: string, state: AdaptiveState): Promise<void>;
+/** Record an adjustment decision. @internal */
+export declare function recordAdjustment(henchDir: string, record: AdjustmentRecord): void;
+/** Update adaptive settings. @internal */
+export declare function updateSettings(henchDir: string, updates: Partial<AdaptiveSettings>): AdaptiveSettings;
+/** Lock a config key from automatic adjustment. @internal */
+export declare function lockKey(henchDir: string, key: string): void;
+/** Unlock a config key for automatic adjustment. @internal */
+export declare function unlockKey(henchDir: string, key: string): void;
+/** Set a manual override for a config key. @internal */
+export declare function setOverride(henchDir: string, key: string, value: unknown): void;
+/** Remove a manual override. @internal */
+export declare function removeOverride(henchDir: string, key: string): void;
+/** Get summary statistics from adjustment history. @internal */
+export declare function getAdjustmentStats(state: AdaptiveState): {
+    total: number;
+    applied: number;
+    dismissed: number;
+    overridden: number;
+    automatic: number;
+    manual: number;
+    byCategory: Record<string, {
+        applied: number;
+        dismissed: number;
+        overridden: number;
+    }>;
+};

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

@@ -0,0 +1,139 @@
+/**
+ * Adaptive adjustment persistence — stores adjustment history, settings,
+ * and override state for the adaptive workflow system.
+ *
+ * State is stored in `.hench/adaptive.json`.
+ *
+ * @internal This module is infrastructure for a planned adaptive workflow
+ * feature. It is not yet integrated into the agent loop. All exports are
+ * internal — do not depend on them from outside this package.
+ */
+import { join } from "node:path";
+import { readFile, writeFile } from "node:fs/promises";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { DEFAULT_ADAPTIVE_SETTINGS } from "../agent/analysis/adaptive.js";
+const ADAPTIVE_FILE = "adaptive.json";
+function filePath(henchDir) {
+    return join(henchDir, ADAPTIVE_FILE);
+}
+function defaultState() {
+    return {
+        settings: DEFAULT_ADAPTIVE_SETTINGS(),
+        history: [],
+        overrides: {},
+    };
+}
+// ── Load / Save ──────────────────────────────────────────────────────
+/** Load adaptive state from disk (sync). Returns defaults if missing. @internal */
+export function loadAdaptiveState(henchDir) {
+    const path = filePath(henchDir);
+    try {
+        if (!existsSync(path))
+            return defaultState();
+        const raw = readFileSync(path, "utf-8");
+        const parsed = JSON.parse(raw);
+        return mergeWithDefaults(parsed);
+    }
+    catch {
+        return defaultState();
+    }
+}
+/** Load adaptive state from disk (async). Returns defaults if missing. @internal */
+export async function loadAdaptiveStateAsync(henchDir) {
+    const path = filePath(henchDir);
+    try {
+        if (!existsSync(path))
+            return defaultState();
+        const raw = await readFile(path, "utf-8");
+        const parsed = JSON.parse(raw);
+        return mergeWithDefaults(parsed);
+    }
+    catch {
+        return defaultState();
+    }
+}
+/** Save adaptive state to disk (sync). @internal */
+export function saveAdaptiveState(henchDir, state) {
+    writeFileSync(filePath(henchDir), JSON.stringify(state, null, 2) + "\n", "utf-8");
+}
+/** Save adaptive state to disk (async). @internal */
+export async function saveAdaptiveStateAsync(henchDir, state) {
+    await writeFile(filePath(henchDir), JSON.stringify(state, null, 2) + "\n", "utf-8");
+}
+// ── Operations ───────────────────────────────────────────────────────
+/** Record an adjustment decision. @internal */
+export function recordAdjustment(henchDir, record) {
+    const state = loadAdaptiveState(henchDir);
+    state.history.push(record);
+    saveAdaptiveState(henchDir, state);
+}
+/** Update adaptive settings. @internal */
+export function updateSettings(henchDir, updates) {
+    const state = loadAdaptiveState(henchDir);
+    state.settings = { ...state.settings, ...updates };
+    saveAdaptiveState(henchDir, state);
+    return state.settings;
+}
+/** Lock a config key from automatic adjustment. @internal */
+export function lockKey(henchDir, key) {
+    const state = loadAdaptiveState(henchDir);
+    if (!state.settings.lockedKeys.includes(key)) {
+        state.settings.lockedKeys.push(key);
+    }
+    saveAdaptiveState(henchDir, state);
+}
+/** Unlock a config key for automatic adjustment. @internal */
+export function unlockKey(henchDir, key) {
+    const state = loadAdaptiveState(henchDir);
+    state.settings.lockedKeys = state.settings.lockedKeys.filter((k) => k !== key);
+    saveAdaptiveState(henchDir, state);
+}
+/** Set a manual override for a config key. @internal */
+export function setOverride(henchDir, key, value) {
+    const state = loadAdaptiveState(henchDir);
+    state.overrides[key] = value;
+    if (!state.settings.lockedKeys.includes(key)) {
+        state.settings.lockedKeys.push(key);
+    }
+    saveAdaptiveState(henchDir, state);
+}
+/** Remove a manual override. @internal */
+export function removeOverride(henchDir, key) {
+    const state = loadAdaptiveState(henchDir);
+    delete state.overrides[key];
+    state.settings.lockedKeys = state.settings.lockedKeys.filter((k) => k !== key);
+    saveAdaptiveState(henchDir, state);
+}
+/** Get summary statistics from adjustment history. @internal */
+export function getAdjustmentStats(state) {
+    const { history } = state;
+    const total = history.length;
+    const applied = history.filter((r) => r.decision === "applied").length;
+    const dismissed = history.filter((r) => r.decision === "dismissed").length;
+    const overridden = history.filter((r) => r.decision === "overridden").length;
+    const automatic = history.filter((r) => r.automatic).length;
+    const manual = total - automatic;
+    const byCategory = {};
+    for (const record of history) {
+        const cat = byCategory[record.category] ?? { applied: 0, dismissed: 0, overridden: 0 };
+        cat[record.decision]++;
+        byCategory[record.category] = cat;
+    }
+    return { total, applied, dismissed, overridden, automatic, manual, byCategory };
+}
+// ── Helpers ──────────────────────────────────────────────────────────
+function mergeWithDefaults(parsed) {
+    if (!parsed || typeof parsed !== "object")
+        return defaultState();
+    const obj = parsed;
+    const defaults = defaultState();
+    return {
+        settings: {
+            ...defaults.settings,
+            ...(obj.settings && typeof obj.settings === "object" ? obj.settings : {}),
+        },
+        history: Array.isArray(obj.history) ? obj.history : [],
+        overrides: (obj.overrides && typeof obj.overrides === "object" ? obj.overrides : {}),
+    };
+}
+//# sourceMappingURL=adjustments.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adjustments.js","sourceRoot":"","sources":["../../src/store/adjustments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAElE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAqC1E,MAAM,aAAa,GAAG,eAAe,CAAC;AAEtC,SAAS,QAAQ,CAAC,QAAgB;IAChC,OAAO,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,YAAY;IACnB,OAAO;QACL,QAAQ,EAAE,yBAAyB,EAAE;QACrC,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED,wEAAwE;AAExE,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,YAAY,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,YAAY,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAoB;IACtE,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACpF,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,KAAoB;IAEpB,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACtF,CAAC;AAED,wEAAwE;AAExE,+CAA+C;AAC/C,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,MAAwB;IAExB,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,OAAkC;IAElC,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,KAAK,CAAC,QAAQ,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;IACnD,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,QAAQ,CAAC;AACxB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,OAAO,CAAC,QAAgB,EAAE,GAAW;IACnD,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,GAAW;IACrD,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,KAAK,CAAC,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;IAC/E,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,GAAW,EAAE,KAAc;IACvE,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,GAAW;IAC1D,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,KAAK,CAAC,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;IAC/E,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IASrD,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,MAAM,CAAC;IAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;IAC5D,MAAM,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAEjC,MAAM,UAAU,GAA+E,EAAE,CAAC;IAClG,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAClF,CAAC;AAED,wEAAwE;AAExE,SAAS,iBAAiB,CAAC,MAAe;IACxC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,YAAY,EAAE,CAAC;IACjE,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAEhC,OAAO;QACL,QAAQ,EAAE;YACR,GAAG,QAAQ,CAAC,QAAQ;YACpB,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAqC,CAAC,CAAC,CAAC,EAAE,CAAC;SACvG;QACD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAA6B,CAAC,CAAC,CAAC,EAAE;QAC5E,SAAS,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAA4B;KAChH,CAAC;AACJ,CAAC"}

package/packages/hench/dist/store/config.d.ts

@@ -0,0 +1,6 @@
+import type { HenchConfig } from "../schema/index.js";
+export declare function ensureHenchDir(henchDir: string): Promise<void>;
+export declare function loadConfig(henchDir: string): Promise<HenchConfig>;
+export declare function saveConfig(henchDir: string, config: HenchConfig): Promise<void>;
+export declare function configExists(henchDir: string): Promise<boolean>;
+export declare function initConfig(henchDir: string): Promise<HenchConfig>;

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

@@ -0,0 +1,41 @@
+import { join } from "node:path";
+import { readFile, writeFile, mkdir, access } from "node:fs/promises";
+import { validateConfig, DEFAULT_HENCH_CONFIG } from "../schema/index.js";
+import { toCanonicalJSON } from "./json.js";
+import { loadProjectOverrides, mergeWithOverrides } from "./project-config.js";
+export async function ensureHenchDir(henchDir) {
+    await mkdir(henchDir, { recursive: true });
+    await mkdir(join(henchDir, "runs"), { recursive: true });
+}
+export async function loadConfig(henchDir) {
+    const configPath = join(henchDir, "config.json");
+    const raw = await readFile(configPath, "utf-8");
+    const data = JSON.parse(raw);
+    const result = validateConfig(data);
+    if (!result.ok) {
+        throw new Error(`Invalid hench config: ${result.errors.message}`);
+    }
+    // Merge project-level .n-dx.json overrides (project config takes precedence)
+    const overrides = await loadProjectOverrides(henchDir, "hench");
+    return mergeWithOverrides(result.data, overrides);
+}
+export async function saveConfig(henchDir, config) {
+    const configPath = join(henchDir, "config.json");
+    await writeFile(configPath, toCanonicalJSON(config), "utf-8");
+}
+export async function configExists(henchDir) {
+    try {
+        await access(join(henchDir, "config.json"));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function initConfig(henchDir) {
+    await ensureHenchDir(henchDir);
+    const config = DEFAULT_HENCH_CONFIG();
+    await saveConfig(henchDir, config);
+    return config;
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/store/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG/E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,6EAA6E;IAC7E,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChE,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAmB,EAAE,SAAS,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,MAAmB;IAEnB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACjD,MAAM,SAAS,CAAC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,MAAM,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,7 @@
+export { ensureHenchDir, loadConfig, saveConfig, configExists, initConfig, } from "./config.js";
+export { saveRun, loadRun, listRuns } from "./runs.js";
+export { RunChangeDetector } from "./run-change-detector.js";
+export { enforceRetentionPolicy, identifyRetainableRuns, identifyWarningRuns, extractUsageStats, loadRetentionConfig, DEFAULT_RETENTION_CONFIG, } from "./run-retention.js";
+export type { RetentionConfig, RetentionResult, PreservedUsageStats, RetentionLogEntry, } from "./run-retention.js";
+export { startRetentionScheduler, runRetentionCycle, loadRetentionIntervalMs, DEFAULT_RETENTION_INTERVAL_MS, } from "./run-retention-scheduler.js";
+export type { WarningCallback, RetentionSchedulerOptions, } from "./run-retention-scheduler.js";

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

@@ -0,0 +1,6 @@
+export { ensureHenchDir, loadConfig, saveConfig, configExists, initConfig, } from "./config.js";
+export { saveRun, loadRun, listRuns } from "./runs.js";
+export { RunChangeDetector } from "./run-change-detector.js";
+export { enforceRetentionPolicy, identifyRetainableRuns, identifyWarningRuns, extractUsageStats, loadRetentionConfig, DEFAULT_RETENTION_CONFIG, } from "./run-retention.js";
+export { startRetentionScheduler, runRetentionCycle, loadRetentionIntervalMs, DEFAULT_RETENTION_INTERVAL_MS, } from "./run-retention-scheduler.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,UAAU,EACV,UAAU,EACV,YAAY,EACZ,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC"}

package/packages/hench/dist/store/json.d.ts

@@ -0,0 +1 @@
+export { toCanonicalJSON } from "../prd/llm-gateway.js";

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

@@ -0,0 +1,3 @@
+// Re-export from the shared foundation to eliminate duplication.
+export { toCanonicalJSON } from "../prd/llm-gateway.js";
+//# sourceMappingURL=json.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/store/json.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/packages/hench/dist/store/project-config.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Project-level configuration loading for hench.
+ *
+ * Core utilities (deepMerge, loadProjectOverrides, mergeWithOverrides) are
+ * shared from @n-dx/llm-client. This module re-exports them and adds
+ * the thin configDir→projectDir adapter for Claude config that hench consumers
+ * expect.
+ */
+import type { ClaudeConfig, LLMConfig, LLMVendor } from "../prd/llm-gateway.js";
+export type { ClaudeConfig, LLMConfig, LLMVendor } from "../prd/llm-gateway.js";
+export { loadProjectOverrides, mergeWithOverrides } from "../prd/llm-gateway.js";
+/**
+ * Load the "claude" section from .n-dx.json.
+ * Returns an empty object if the file doesn't exist, is invalid, or has no claude section.
+ *
+ * Delegates to @n-dx/llm-client's loadClaudeConfig, adapting the hench
+ * convention of passing a configDir (e.g., /project/.hench) instead of the
+ * project root directory.
+ *
+ * @param configDir The package config directory (e.g., /project/.hench)
+ */
+export declare function loadClaudeConfig(configDir: string): Promise<ClaudeConfig>;
+/**
+ * Load the vendor-neutral llm section from .n-dx.json.
+ *
+ * @param configDir The package config directory (e.g., /project/.hench)
+ */
+export declare function loadLLMConfig(configDir: string): Promise<LLMConfig>;
+export declare function resolveLLMVendor(llmConfig: LLMConfig): LLMVendor;
+/**
+ * Resolve active vendor CLI binary.
+ * - codex: llm.codex.cli_path or "codex"
+ * - claude: llm.claude.cli_path / legacy claude.cli_path or "claude"
+ */
+export declare function resolveVendorCliPath(llmConfig: LLMConfig): string;
+/**
+ * Build the environment object to pass to the vendor CLI subprocess.
+ *
+ * Injects the vendor-specific API key from project config so that binaries
+ * receive it even when it is not set in the system environment:
+ * - codex: llm.codex.api_key → OPENAI_API_KEY
+ * - claude: llm.claude.api_key → ANTHROPIC_API_KEY
+ *
+ * Falls back to process.env unchanged when no config-supplied key is present.
+ */
+export declare function resolveVendorCliEnv(llmConfig: LLMConfig): NodeJS.ProcessEnv;
+/**
+ * Resolve the API key with the following priority:
+ * 1. claude.api_key from unified config (.n-dx.json)
+ * 2. Environment variable specified by config.apiKeyEnv (default: ANTHROPIC_API_KEY)
+ *
+ * @returns The resolved API key, or undefined if not found.
+ */
+export declare function resolveApiKey(claudeConfig: ClaudeConfig, apiKeyEnv: string): string | undefined;
+/**
+ * Resolve the Claude CLI binary path with the following priority:
+ * 1. claude.cli_path from unified config (.n-dx.json)
+ * 2. "claude" (found on PATH)
+ *
+ * @returns The resolved binary path.
+ */
+export declare function resolveCliPath(claudeConfig: ClaudeConfig): string;