codeprobe 0.1.0

package/dist/utils/__tests__/output.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=output.test.d.ts.map

package/dist/utils/__tests__/output.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/output.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/output.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect } from 'vitest';
+import { formatBytes, formatTokens, formatDuration, formatPercentage, formatBar, } from '../../utils/output.js';
+describe('formatBytes', () => {
+    it('formats 0 as "0 B"', () => {
+        expect(formatBytes(0)).toBe('0 B');
+    });
+    it('formats 1024 as "1.0 KB"', () => {
+        expect(formatBytes(1024)).toBe('1.0 KB');
+    });
+    it('formats 1048576 as "1.0 MB"', () => {
+        expect(formatBytes(1048576)).toBe('1.0 MB');
+    });
+});
+describe('formatTokens', () => {
+    it('formats 0 as "0"', () => {
+        expect(formatTokens(0)).toBe('0');
+    });
+    it('formats 1500 as "1.5k"', () => {
+        expect(formatTokens(1500)).toBe('1.5k');
+    });
+    it('formats 1000000 as "1.00M"', () => {
+        expect(formatTokens(1000000)).toBe('1.00M');
+    });
+});
+describe('formatDuration', () => {
+    it('formats 0 as "0ms"', () => {
+        expect(formatDuration(0)).toBe('0ms');
+    });
+    it('formats 1500 as "1.5s"', () => {
+        expect(formatDuration(1500)).toBe('1.5s');
+    });
+    it('formats 65000 as "1m 5s"', () => {
+        expect(formatDuration(65000)).toBe('1m 5s');
+    });
+});
+describe('formatPercentage', () => {
+    it('formats 0.5 as "50.0%"', () => {
+        expect(formatPercentage(0.5)).toBe('50.0%');
+    });
+    it('formats 1 as "100.0%"', () => {
+        expect(formatPercentage(1)).toBe('100.0%');
+    });
+    it('formats 0.123 as "12.3%"', () => {
+        expect(formatPercentage(0.123)).toBe('12.3%');
+    });
+});
+describe('formatBar', () => {
+    it('produces a string of the right width with "#" and "." chars', () => {
+        const bar = formatBar(50, 100, 20);
+        // bar should be "[" + 20 chars of # and . + "]" = 22 total
+        expect(bar).toHaveLength(22);
+        expect(bar.startsWith('[')).toBe(true);
+        expect(bar.endsWith(']')).toBe(true);
+        // Inner content should only be '#' and '.'
+        const inner = bar.slice(1, -1);
+        expect(inner).toMatch(/^[#.]+$/);
+        // 50/100 = 50%, so 10 of 20 should be '#'
+        const hashes = inner.split('').filter((c) => c === '#').length;
+        expect(hashes).toBe(10);
+    });
+});
+//# sourceMappingURL=output.test.js.map

package/dist/utils/__tests__/output.test.js.map

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

package/dist/utils/cache.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Simple file-based caching backed by JSON files in the cache directory.
+ */
+/**
+ * Derive a cache key by hashing one or more string parts.
+ * Concatenates all parts with a null separator before hashing.
+ */
+export declare function getCacheKey(...parts: string[]): string;
+/**
+ * Read a cached value. Returns `null` if the key does not exist or the
+ * cached data cannot be deserialized.
+ */
+export declare function readCache<T>(key: string): Promise<T | null>;
+/**
+ * Write a value to the cache. The value is wrapped in an envelope that
+ * records the timestamp for potential TTL support in the future.
+ */
+export declare function writeCache<T>(key: string, data: T): Promise<void>;
+/** @deprecated Use getCacheKey instead. */
+export declare const cacheKey: typeof getCacheKey;
+/** @deprecated Use readCache<string> instead. */
+export declare function getCached(key: string): Promise<string | null>;
+/** @deprecated Use writeCache<string> instead. */
+export declare function setCached(key: string, value: string): Promise<void>;
+/**
+ * Clear the entire cache directory.
+ */
+export declare function clearCache(): Promise<void>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtD;AAkBD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAajE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUvE;AAMD,2CAA2C;AAC3C,eAAO,MAAM,QAAQ,oBAAc,CAAC;AAEpC,iDAAiD;AACjD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEnE;AAED,kDAAkD;AAClD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhD"}

package/dist/utils/cache.js

@@ -0,0 +1,87 @@
+/**
+ * Simple file-based caching backed by JSON files in the cache directory.
+ */
+import { readFile, writeFile, mkdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getCacheDir } from './paths.js';
+import { sha256 } from './hashing.js';
+import { fileExists } from './fs.js';
+/**
+ * Derive a cache key by hashing one or more string parts.
+ * Concatenates all parts with a null separator before hashing.
+ */
+export function getCacheKey(...parts) {
+    return sha256(parts.join('\0'));
+}
+/**
+ * Ensure the cache directory exists.
+ */
+async function ensureCacheDir() {
+    const dir = getCacheDir();
+    await mkdir(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Resolve the full filesystem path for a given cache key.
+ */
+function cachePath(key) {
+    return join(getCacheDir(), `${key}.json`);
+}
+/**
+ * Read a cached value. Returns `null` if the key does not exist or the
+ * cached data cannot be deserialized.
+ */
+export async function readCache(key) {
+    const path = cachePath(key);
+    try {
+        if (!(await fileExists(path)))
+            return null;
+        const raw = await readFile(path, 'utf-8');
+        const envelope = JSON.parse(raw);
+        return envelope.data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write a value to the cache. The value is wrapped in an envelope that
+ * records the timestamp for potential TTL support in the future.
+ */
+export async function writeCache(key, data) {
+    await ensureCacheDir();
+    const path = cachePath(key);
+    const envelope = {
+        data,
+        timestamp: Date.now(),
+    };
+    await writeFile(path, JSON.stringify(envelope, null, 2), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// Backward-compatible aliases used by older modules (e.g. promptRunner)
+// ---------------------------------------------------------------------------
+/** @deprecated Use getCacheKey instead. */
+export const cacheKey = getCacheKey;
+/** @deprecated Use readCache<string> instead. */
+export async function getCached(key) {
+    return readCache(key);
+}
+/** @deprecated Use writeCache<string> instead. */
+export async function setCached(key, value) {
+    return writeCache(key, value);
+}
+/**
+ * Clear the entire cache directory.
+ */
+export async function clearCache() {
+    const dir = getCacheDir();
+    try {
+        if (await fileExists(dir)) {
+            await rm(dir, { recursive: true, force: true });
+        }
+    }
+    catch {
+        // Best effort -- ignore errors during cleanup
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAG,KAAe;IAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc;IAC3B,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;IAC1B,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,GAAW;IAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAE5B,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmC,CAAC;QAEnE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAI,GAAW,EAAE,IAAO;IACtD,MAAM,cAAc,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAE5B,MAAM,QAAQ,GAAG;QACf,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAE9E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEpC,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,OAAO,SAAS,CAAS,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,KAAa;IACxD,OAAO,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;IAE1B,IAAI,CAAC;QACH,IAAI,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;AACH,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Configuration loader for codeprobe.
+ * Looks for .codeprobe.json or .codeprobe.yaml in the project root.
+ */
+import type { CodeprobeConfig } from '../types/config.js';
+/**
+ * Load configuration from the project root.
+ * Returns a default config if no config file is found.
+ */
+export declare function loadConfig(rootPath: string): Promise<CodeprobeConfig>;
+/**
+ * Return the default configuration.
+ */
+export declare function getDefaultConfig(): CodeprobeConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAiB1D;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAiB3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAalD"}

package/dist/utils/config.js

@@ -0,0 +1,61 @@
+/**
+ * Configuration loader for codeprobe.
+ * Looks for .codeprobe.json or .codeprobe.yaml in the project root.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import yaml from 'js-yaml';
+import { fileExists } from './fs.js';
+const CONFIG_FILE_NAMES = [
+    '.codeprobe.json',
+    '.codeprobe.yaml',
+    '.codeprobe.yml',
+    'codeprobe.config.json',
+    'codeprobe.config.yaml',
+    // Backward compat: also check legacy config file names
+    '.claude-test.json',
+    '.claude-test.yaml',
+    '.claude-test.yml',
+    'claude-test.config.json',
+    'claude-test.config.yaml',
+];
+/**
+ * Load configuration from the project root.
+ * Returns a default config if no config file is found.
+ */
+export async function loadConfig(rootPath) {
+    for (const name of CONFIG_FILE_NAMES) {
+        const configPath = join(rootPath, name);
+        if (await fileExists(configPath)) {
+            try {
+                const content = await readFile(configPath, 'utf-8');
+                if (name.endsWith('.json')) {
+                    return JSON.parse(content);
+                }
+                return yaml.load(content);
+            }
+            catch {
+                // Fall through to default
+            }
+        }
+    }
+    return getDefaultConfig();
+}
+/**
+ * Return the default configuration.
+ */
+export function getDefaultConfig() {
+    return {
+        defaultModel: 'claude-sonnet-4-20250514',
+        defaultContextTarget: '200k',
+        ignorePaths: [],
+        caching: true,
+        contextBudgets: {
+            systemPrompt: 0.1,
+            coreFiles: 0.5,
+            docs: 0.2,
+            toolMeta: 0.1,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,iBAAiB,GAAG;IACxB,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,uBAAuB;IACvB,uBAAuB;IACvB,uDAAuD;IACvD,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,yBAAyB;IACzB,yBAAyB;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACpD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;gBAChD,CAAC;gBACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAoB,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,YAAY,EAAE,0BAA0B;QACxC,oBAAoB,EAAE,MAAM;QAC5B,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,IAAI;QACb,cAAc,EAAE;YACd,YAAY,EAAE,GAAG;YACjB,SAAS,EAAE,GAAG;YACd,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,GAAG;SACd;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Custom error classes and a top-level error handler.
+ */
+/**
+ * Base error for all codeprobe errors. Carries a machine-readable
+ * `code` and optional structured `details`.
+ */
+export declare class CodeprobeError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code: string, details?: Record<string, unknown>);
+}
+/**
+ * Raised when a configuration file is missing, malformed, or contains
+ * invalid values.
+ */
+export declare class ConfigError extends CodeprobeError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Raised when a prompt spec file cannot be parsed or is invalid.
+ */
+export declare class PromptParseError extends CodeprobeError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Raised when input data fails schema or constraint validation.
+ */
+export declare class ValidationError extends CodeprobeError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Top-level error handler that prints a user-friendly message and
+ * exits the process.
+ *
+ * - Known CodeprobeError instances are printed cleanly.
+ * - Unknown errors include a hint to report the bug.
+ * - Stack traces are only printed when DEBUG is set.
+ */
+export declare function handleError(error: unknown): never;
+/** @deprecated Use CodeprobeError instead. */
+export { CodeprobeError as ClaudeTestError };
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUpC;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,cAAc;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAkCjD;AAED,8CAA8C;AAC9C,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,CAAC"}

package/dist/utils/errors.js

@@ -0,0 +1,83 @@
+/**
+ * Custom error classes and a top-level error handler.
+ */
+/**
+ * Base error for all codeprobe errors. Carries a machine-readable
+ * `code` and optional structured `details`.
+ */
+export class CodeprobeError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.name = 'CodeprobeError';
+        this.code = code;
+        this.details = details;
+        // Maintain proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Raised when a configuration file is missing, malformed, or contains
+ * invalid values.
+ */
+export class ConfigError extends CodeprobeError {
+    constructor(message, details) {
+        super(message, 'CONFIG_ERROR', details);
+        this.name = 'ConfigError';
+    }
+}
+/**
+ * Raised when a prompt spec file cannot be parsed or is invalid.
+ */
+export class PromptParseError extends CodeprobeError {
+    constructor(message, details) {
+        super(message, 'PROMPT_PARSE_ERROR', details);
+        this.name = 'PromptParseError';
+    }
+}
+/**
+ * Raised when input data fails schema or constraint validation.
+ */
+export class ValidationError extends CodeprobeError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', details);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Top-level error handler that prints a user-friendly message and
+ * exits the process.
+ *
+ * - Known CodeprobeError instances are printed cleanly.
+ * - Unknown errors include a hint to report the bug.
+ * - Stack traces are only printed when DEBUG is set.
+ */
+export function handleError(error) {
+    if (error instanceof CodeprobeError) {
+        process.stderr.write(`\nError [${error.code}]: ${error.message}\n`);
+        if (error.details && Object.keys(error.details).length > 0) {
+            process.stderr.write(`Details: ${JSON.stringify(error.details, null, 2)}\n`);
+        }
+        if (process.env['DEBUG'] && error.stack) {
+            process.stderr.write(`\n${error.stack}\n`);
+        }
+        process.exit(1);
+    }
+    if (error instanceof Error) {
+        process.stderr.write(`\nUnexpected error: ${error.message}\n`);
+        if (process.env['DEBUG'] && error.stack) {
+            process.stderr.write(`\n${error.stack}\n`);
+        }
+        else {
+            process.stderr.write('Set DEBUG=1 for a full stack trace.\n');
+        }
+        process.exit(1);
+    }
+    // Truly unknown throw value
+    process.stderr.write(`\nUnexpected error: ${String(error)}\n`);
+    process.exit(1);
+}
+/** @deprecated Use CodeprobeError instead. */
+export { CodeprobeError as ClaudeTestError };
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/fs.d.ts

@@ -0,0 +1,44 @@
+/**
+ * File system utilities for codeprobe.
+ */
+/**
+ * Safely read a text file, returning null on failure.
+ */
+export declare function readTextFile(filePath: string): Promise<string | null>;
+/**
+ * Check if a file exists and is a file (not a directory).
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Check if a path is a directory.
+ */
+export declare function isDirectory(dirPath: string): Promise<boolean>;
+/**
+ * Get file size in bytes, or 0 on error.
+ */
+export declare function getFileSize(filePath: string): Promise<number>;
+/**
+ * Get the extension of a file, lowercase, including the dot.
+ */
+export declare function getExtension(filePath: string): string;
+/**
+ * Get relative path from a root.
+ */
+export declare function getRelativePath(rootPath: string, filePath: string): string;
+export interface WalkOptions {
+    ignoreDirs?: Set<string>;
+    ignoreExtensions?: Set<string>;
+}
+export interface WalkEntry {
+    path: string;
+    relativePath: string;
+    isFile: boolean;
+    isDirectory: boolean;
+    size: number;
+    extension: string;
+}
+/**
+ * Recursively walk a directory, yielding file entries.
+ */
+export declare function walkDirectory(rootPath: string, options?: WalkOptions): Promise<WalkEntry[]>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM3E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,EAAE,CAAC,CAmDtB"}

package/dist/utils/fs.js

@@ -0,0 +1,119 @@
+/**
+ * File system utilities for codeprobe.
+ */
+import { readFile, stat, readdir } from 'node:fs/promises';
+import { join, extname, relative } from 'node:path';
+/**
+ * Safely read a text file, returning null on failure.
+ */
+export async function readTextFile(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a file exists and is a file (not a directory).
+ */
+export async function fileExists(filePath) {
+    try {
+        const s = await stat(filePath);
+        return s.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a path is a directory.
+ */
+export async function isDirectory(dirPath) {
+    try {
+        const s = await stat(dirPath);
+        return s.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get file size in bytes, or 0 on error.
+ */
+export async function getFileSize(filePath) {
+    try {
+        const s = await stat(filePath);
+        return s.size;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Get the extension of a file, lowercase, including the dot.
+ */
+export function getExtension(filePath) {
+    return extname(filePath).toLowerCase();
+}
+/**
+ * Get relative path from a root.
+ */
+export function getRelativePath(rootPath, filePath) {
+    return relative(rootPath, filePath);
+}
+/**
+ * Recursively walk a directory, yielding file entries.
+ */
+export async function walkDirectory(rootPath, options) {
+    const entries = [];
+    const ignoreDirs = options?.ignoreDirs ?? new Set();
+    async function walk(currentPath) {
+        let dirEntries;
+        try {
+            dirEntries = await readdir(currentPath, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of dirEntries) {
+            const fullPath = join(currentPath, entry.name);
+            const relPath = relative(rootPath, fullPath);
+            if (entry.isDirectory()) {
+                if (ignoreDirs.has(entry.name)) {
+                    continue;
+                }
+                entries.push({
+                    path: fullPath,
+                    relativePath: relPath,
+                    isFile: false,
+                    isDirectory: true,
+                    size: 0,
+                    extension: '',
+                });
+                await walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                let size = 0;
+                try {
+                    const s = await stat(fullPath);
+                    size = s.size;
+                }
+                catch {
+                    // skip files we can't stat
+                }
+                entries.push({
+                    path: fullPath,
+                    relativePath: relPath,
+                    isFile: true,
+                    isDirectory: false,
+                    size,
+                    extension: extname(entry.name).toLowerCase(),
+                });
+            }
+        }
+    }
+    await walk(rootPath);
+    return entries;
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

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

package/dist/utils/hashing.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cryptographic hashing utilities.
+ */
+/**
+ * Compute a full SHA-256 hex digest of the input string.
+ */
+export declare function sha256(input: string): string;
+/**
+ * Compute a short (12-character) SHA-256 prefix for use as a
+ * compact, collision-resistant identifier.
+ */
+export declare function shortHash(input: string): string;
+//# sourceMappingURL=hashing.d.ts.map

package/dist/utils/hashing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.d.ts","sourceRoot":"","sources":["../../src/utils/hashing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/utils/hashing.js

@@ -0,0 +1,18 @@
+/**
+ * Cryptographic hashing utilities.
+ */
+import { createHash } from 'node:crypto';
+/**
+ * Compute a full SHA-256 hex digest of the input string.
+ */
+export function sha256(input) {
+    return createHash('sha256').update(input).digest('hex');
+}
+/**
+ * Compute a short (12-character) SHA-256 prefix for use as a
+ * compact, collision-resistant identifier.
+ */
+export function shortHash(input) {
+    return sha256(input).slice(0, 12);
+}
+//# sourceMappingURL=hashing.js.map

package/dist/utils/hashing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.js","sourceRoot":"","sources":["../../src/utils/hashing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC"}