codeprobe 0.1.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Logging utilities for codeprobe CLI.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Enable or disable JSON output mode.
+ * When enabled, spinners and decorative output are suppressed.
+ */
+export declare function setJsonMode(enabled: boolean): void;
+/**
+ * Check whether JSON output mode is active.
+ */
+export declare function isJsonMode(): boolean;
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogLevel(): LogLevel;
+export declare function debug(message: string, ...args: unknown[]): void;
+export declare function info(message: string, ...args: unknown[]): void;
+export declare function warn(message: string, ...args: unknown[]): void;
+export declare function error(message: string, ...args: unknown[]): void;
+export declare function success(message: string, ...args: unknown[]): void;
+export declare function dim(message: string, ...args: unknown[]): void;
+export declare const logger: {
+    debug: typeof debug;
+    info: typeof info;
+    warn: typeof warn;
+    error: typeof error;
+    success: typeof success;
+    dim: typeof dim;
+    setLogLevel: typeof setLogLevel;
+    getLogLevel: typeof getLogLevel;
+};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAKtE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAUD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAMD,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAI/D;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAI9D;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAI9D;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAI/D;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAIjE;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAI7D;AAED,eAAO,MAAM,MAAM;;;;;;;;;CASlB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,76 @@
+/**
+ * Logging utilities for codeprobe CLI.
+ */
+import chalk from 'chalk';
+let currentLevel = 'info';
+let jsonMode = false;
+/**
+ * Enable or disable JSON output mode.
+ * When enabled, spinners and decorative output are suppressed.
+ */
+export function setJsonMode(enabled) {
+    jsonMode = enabled;
+}
+/**
+ * Check whether JSON output mode is active.
+ */
+export function isJsonMode() {
+    return jsonMode;
+}
+const LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+export function getLogLevel() {
+    return currentLevel;
+}
+function shouldLog(level) {
+    return LEVEL_ORDER[level] >= LEVEL_ORDER[currentLevel];
+}
+export function debug(message, ...args) {
+    if (shouldLog('debug')) {
+        console.log(chalk.gray(`[debug] ${message}`), ...args);
+    }
+}
+export function info(message, ...args) {
+    if (shouldLog('info')) {
+        console.log(message, ...args);
+    }
+}
+export function warn(message, ...args) {
+    if (shouldLog('warn')) {
+        console.warn(chalk.yellow(`[warn] ${message}`), ...args);
+    }
+}
+export function error(message, ...args) {
+    if (shouldLog('error')) {
+        console.error(chalk.red(`[error] ${message}`), ...args);
+    }
+}
+export function success(message, ...args) {
+    if (shouldLog('info')) {
+        console.log(chalk.green(message), ...args);
+    }
+}
+export function dim(message, ...args) {
+    if (shouldLog('info')) {
+        console.log(chalk.dim(message), ...args);
+    }
+}
+export const logger = {
+    debug,
+    info,
+    warn,
+    error,
+    success,
+    dim,
+    setLogLevel,
+    getLogLevel,
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,IAAI,YAAY,GAAa,MAAM,CAAC;AACpC,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;IACvD,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;IACtD,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;IACtD,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;IACvD,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe;IACzD,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,GAAG,IAAe;IACrD,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,OAAO;IACP,GAAG;IACH,WAAW;IACX,WAAW;CACZ,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Output formatting utilities for tables, sizes, durations, and
+ * ASCII bar charts.
+ */
+/**
+ * Format an array of rows into an aligned plain-text table.
+ */
+export declare function formatTable(headers: string[], rows: string[][]): string;
+/**
+ * Format a byte count into a human-readable string.
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format a token count into a human-readable string (e.g. "12.3k").
+ */
+export declare function formatTokens(tokens: number): string;
+/**
+ * Format a duration in milliseconds into a human-readable string.
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Format a value between 0 and 1 as a percentage string.
+ */
+export declare function formatPercentage(value: number): string;
+/**
+ * Render an ASCII progress/proportion bar.
+ *
+ * @param value  Current value
+ * @param max    Maximum value (determines bar fill)
+ * @param width  Character width of the bar (default 30)
+ * @returns      A string like `[########............]`
+ */
+export declare function formatBar(value: number, max: number, width?: number): string;
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CA2BvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,MAAW,GACjB,MAAM,CAQR"}

package/dist/utils/output.js

@@ -0,0 +1,99 @@
+/**
+ * Output formatting utilities for tables, sizes, durations, and
+ * ASCII bar charts.
+ */
+/**
+ * Format an array of rows into an aligned plain-text table.
+ */
+export function formatTable(headers, rows) {
+    const colWidths = headers.map((h, i) => {
+        const maxData = rows.reduce((max, row) => Math.max(max, (row[i] ?? '').length), 0);
+        return Math.max(h.length, maxData);
+    });
+    const lines = [];
+    const headerLine = headers
+        .map((h, i) => h.padEnd(colWidths[i]))
+        .join('  ');
+    lines.push(headerLine);
+    const separator = colWidths.map((w) => '-'.repeat(w)).join('  ');
+    lines.push(separator);
+    for (const row of rows) {
+        const line = row
+            .map((cell, i) => (cell ?? '').padEnd(colWidths[i]))
+            .join('  ');
+        lines.push(line);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a byte count into a human-readable string.
+ */
+export function formatBytes(bytes) {
+    if (bytes < 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let unitIndex = 0;
+    let value = bytes;
+    while (value >= 1024 && unitIndex < units.length - 1) {
+        value /= 1024;
+        unitIndex++;
+    }
+    if (unitIndex === 0)
+        return `${value} B`;
+    return `${value.toFixed(1)} ${units[unitIndex]}`;
+}
+/**
+ * Format a token count into a human-readable string (e.g. "12.3k").
+ */
+export function formatTokens(tokens) {
+    if (tokens < 0)
+        return '0';
+    if (tokens < 1000)
+        return tokens.toString();
+    if (tokens < 1_000_000)
+        return `${(tokens / 1000).toFixed(1)}k`;
+    return `${(tokens / 1_000_000).toFixed(2)}M`;
+}
+/**
+ * Format a duration in milliseconds into a human-readable string.
+ */
+export function formatDuration(ms) {
+    if (ms < 0)
+        return '0ms';
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    if (ms < 3_600_000) {
+        const minutes = Math.floor(ms / 60_000);
+        const seconds = Math.round((ms % 60_000) / 1000);
+        return `${minutes}m ${seconds}s`;
+    }
+    const hours = Math.floor(ms / 3_600_000);
+    const minutes = Math.round((ms % 3_600_000) / 60_000);
+    return `${hours}h ${minutes}m`;
+}
+/**
+ * Format a value between 0 and 1 as a percentage string.
+ */
+export function formatPercentage(value) {
+    const clamped = Math.max(0, Math.min(1, value));
+    return `${(clamped * 100).toFixed(1)}%`;
+}
+/**
+ * Render an ASCII progress/proportion bar.
+ *
+ * @param value  Current value
+ * @param max    Maximum value (determines bar fill)
+ * @param width  Character width of the bar (default 30)
+ * @returns      A string like `[########............]`
+ */
+export function formatBar(value, max, width = 30) {
+    if (max <= 0)
+        return '[' + '.'.repeat(width) + ']';
+    const ratio = Math.max(0, Math.min(1, value / max));
+    const filled = Math.round(ratio * width);
+    const empty = width - filled;
+    return '[' + '#'.repeat(filled) + '.'.repeat(empty) + ']';
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

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

package/dist/utils/paths.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Path utilities for resolving project root, cache directories,
+ * and normalizing paths.
+ */
+/**
+ * Resolve the project root directory.
+ *
+ * Uses the current working directory as the project root. This aligns
+ * with how CLI tools typically operate: they act on the directory from
+ * which they are invoked.
+ */
+export declare function resolveProjectRoot(): string;
+/**
+ * Resolve a path relative to the current working directory.
+ * Absolute paths are returned as-is.
+ */
+export declare function resolvePath(p: string): string;
+/**
+ * Get a relative path from `from` to `to`.
+ */
+export declare function getRelativePath(from: string, to: string): string;
+/**
+ * Get the cache directory for codeprobe.
+ *
+ * Follows XDG conventions on Linux/macOS:
+ *   $XDG_CACHE_HOME/codeprobe  (if set)
+ *   ~/.cache/codeprobe          (default)
+ *
+ * Falls back to the OS temp directory if the home directory is not
+ * available.
+ */
+export declare function getCacheDir(): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAYpC"}

package/dist/utils/paths.js

@@ -0,0 +1,51 @@
+/**
+ * Path utilities for resolving project root, cache directories,
+ * and normalizing paths.
+ */
+import { resolve, relative, join } from 'node:path';
+import { homedir, tmpdir } from 'node:os';
+/**
+ * Resolve the project root directory.
+ *
+ * Uses the current working directory as the project root. This aligns
+ * with how CLI tools typically operate: they act on the directory from
+ * which they are invoked.
+ */
+export function resolveProjectRoot() {
+    return process.cwd();
+}
+/**
+ * Resolve a path relative to the current working directory.
+ * Absolute paths are returned as-is.
+ */
+export function resolvePath(p) {
+    return resolve(process.cwd(), p);
+}
+/**
+ * Get a relative path from `from` to `to`.
+ */
+export function getRelativePath(from, to) {
+    return relative(from, to);
+}
+/**
+ * Get the cache directory for codeprobe.
+ *
+ * Follows XDG conventions on Linux/macOS:
+ *   $XDG_CACHE_HOME/codeprobe  (if set)
+ *   ~/.cache/codeprobe          (default)
+ *
+ * Falls back to the OS temp directory if the home directory is not
+ * available.
+ */
+export function getCacheDir() {
+    const xdgCache = process.env['XDG_CACHE_HOME'];
+    if (xdgCache) {
+        return join(xdgCache, 'codeprobe');
+    }
+    const home = homedir();
+    if (home) {
+        return join(home, '.cache', 'codeprobe');
+    }
+    return join(tmpdir(), 'codeprobe');
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,EAAU;IACtD,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC;AACrC,CAAC"}

package/dist/utils/spinner.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Spinner wrapper around ora (ESM dynamic import).
+ *
+ * Provides a simplified interface for showing progress indicators.
+ * Falls back to plain text output when ora cannot be loaded or when
+ * stdout is not a TTY.
+ */
+export interface Spinner {
+    start(): void;
+    stop(): void;
+    succeed(text?: string): void;
+    fail(text?: string): void;
+    update(text: string): void;
+}
+/**
+ * Create a spinner with the given initial text.
+ *
+ * If the log level is set to 'silent' or the terminal does not support
+ * TTY output, the returned spinner is a silent no-op that avoids
+ * polluting stdout.
+ */
+export declare function createSpinner(text: string): Promise<Spinner>;
+//# sourceMappingURL=spinner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,OAAO;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BlE"}

package/dist/utils/spinner.js

@@ -0,0 +1,79 @@
+/**
+ * Spinner wrapper around ora (ESM dynamic import).
+ *
+ * Provides a simplified interface for showing progress indicators.
+ * Falls back to plain text output when ora cannot be loaded or when
+ * stdout is not a TTY.
+ */
+import { getLogLevel } from './logger.js';
+/**
+ * Create a spinner with the given initial text.
+ *
+ * If the log level is set to 'silent' or the terminal does not support
+ * TTY output, the returned spinner is a silent no-op that avoids
+ * polluting stdout.
+ */
+export async function createSpinner(text) {
+    if (getLogLevel() === 'silent') {
+        return createNoopSpinner();
+    }
+    try {
+        const ora = await import('ora');
+        const instance = ora.default(text);
+        return {
+            start() {
+                instance.start();
+            },
+            stop() {
+                instance.stop();
+            },
+            succeed(msg) {
+                instance.succeed(msg);
+            },
+            fail(msg) {
+                instance.fail(msg);
+            },
+            update(msg) {
+                instance.text = msg;
+            },
+        };
+    }
+    catch {
+        return createFallbackSpinner(text);
+    }
+}
+/**
+ * No-op spinner for JSON mode.
+ */
+function createNoopSpinner() {
+    return {
+        start() { },
+        stop() { },
+        succeed() { },
+        fail() { },
+        update() { },
+    };
+}
+/**
+ * Plain text fallback when ora is unavailable.
+ */
+function createFallbackSpinner(text) {
+    return {
+        start() {
+            process.stderr.write(`... ${text}\n`);
+        },
+        stop() {
+            // nothing to clear
+        },
+        succeed(msg) {
+            process.stderr.write(`  OK: ${msg ?? text}\n`);
+        },
+        fail(msg) {
+            process.stderr.write(`  FAIL: ${msg ?? text}\n`);
+        },
+        update(msg) {
+            process.stderr.write(`... ${msg}\n`);
+        },
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/utils/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU1C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,IAAI,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEnC,OAAO;YACL,KAAK;gBACH,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;YACD,IAAI;gBACF,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,GAAY;gBAClB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;YACD,IAAI,CAAC,GAAY;gBACf,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YACD,MAAM,CAAC,GAAW;gBAChB,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC;YACtB,CAAC;SACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB;IACxB,OAAO;QACL,KAAK,KAAgB,CAAC;QACtB,IAAI,KAAgB,CAAC;QACrB,OAAO,KAAgB,CAAC;QACxB,IAAI,KAAgB,CAAC;QACrB,MAAM,KAAgB,CAAC;KACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,IAAY;IACzC,OAAO;QACL,KAAK;YACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;QACxC,CAAC;QACD,IAAI;YACF,mBAAmB;QACrB,CAAC;QACD,OAAO,CAAC,GAAY;YAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,GAAY;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,CAAC,GAAW;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "codeprobe",
+  "version": "0.1.0",
+  "description": "DevTools for Claude — context engineering toolkit for Claude Code",
+  "type": "module",
+  "main": "dist/cli.js",
+  "bin": {
+    "codeprobe": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "claude",
+    "anthropic",
+    "context-engineering",
+    "prompt-testing",
+    "claude-code",
+    "devtools",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "chalk": "^5.4.1",
+    "chokidar": "^4.0.3",
+    "commander": "^13.1.0",
+    "glob": "^11.0.1",
+    "js-yaml": "^4.1.0",
+    "ora": "^8.2.0",
+    "tiktoken": "^1.0.21",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2",
+    "vitest": "^4.1.0"
+  }
+}