@mycodemap/mycodemap 0.5.2-beta.1 → 2.0.0

package/dist/cli/output/errors.d.ts

@@ -0,0 +1,14 @@
+import type { OutputMode, ActionableError } from './types.js';
+import { type ErrorCode } from './error-codes.js';
+/**
+ * Format an error based on output mode.
+ *
+ * - JSON mode: returns JSON string of {type:"error", code, message, ...actionableFields}
+ * - Human mode: returns chalk-colored readable string
+ */
+export declare function formatError(error: unknown, mode: OutputMode, attempted?: string): string;
+/**
+ * Programmatically create an ActionableError with sensible defaults.
+ */
+export declare function createActionableError(code: ErrorCode | string, message: string, attempted: string, overrides?: Partial<Pick<ActionableError, 'confidence' | 'nextCommand' | 'causes' | 'rootCause' | 'remediationPlan'>>): ActionableError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/cli/output/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/cli/output/errors.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AAE/E,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAUhF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAwCxF;AA6GD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,GAAG,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,iBAAiB,CAAC,CAAC,GACpH,eAAe,CAejB"}

package/dist/cli/output/errors.js

@@ -0,0 +1,170 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Mode-aware error formatting — structured JSON for machines, chalk-colored text for humans
+import chalk from 'chalk';
+import { isActionableError } from './types.js';
+import { ErrorCodes, ErrorRemediation } from './error-codes.js';
+/**
+ * Format an error based on output mode.
+ *
+ * - JSON mode: returns JSON string of {type:"error", code, message, ...actionableFields}
+ * - Human mode: returns chalk-colored readable string
+ */
+export function formatError(error, mode, attempted) {
+    const normalized = normalizeError(error, attempted);
+    if (mode === 'json') {
+        const base = {
+            type: 'error',
+            code: normalized.code,
+            message: normalized.message,
+            ...(normalized.remediation ? { remediation: normalized.remediation } : {}),
+        };
+        if (isActionableError(normalized)) {
+            const json = {
+                ...base,
+                attempted: normalized.attempted,
+                rootCause: normalized.rootCause,
+                remediationPlan: normalized.remediationPlan,
+                confidence: normalized.confidence,
+            };
+            if (normalized.nextCommand)
+                json.nextCommand = normalized.nextCommand;
+            if (normalized.causes && normalized.causes.length > 0)
+                json.causes = normalized.causes;
+            return JSON.stringify(json);
+        }
+        return JSON.stringify(base);
+    }
+    // Human mode
+    let output = chalk.red('Error: ') + normalized.message;
+    if (normalized.code && normalized.code !== 'UNKNOWN') {
+        output = chalk.red('Error: ') + `[${normalized.code}] ${normalized.message}`;
+    }
+    output += '\n  ' + chalk.cyan('Attempted: ') + normalized.attempted;
+    output += '\n  ' + chalk.cyan('Root cause: ') + normalized.rootCause;
+    if (normalized.remediationPlan) {
+        const pct = Math.round(normalized.confidence * 100);
+        output += `\n  ${chalk.yellow('Suggestion: ')}${normalized.remediationPlan} (${pct}% confidence)`;
+    }
+    if (normalized.nextCommand) {
+        output += '\n  ' + chalk.green('Next: ') + normalized.nextCommand;
+    }
+    return output;
+}
+/**
+ * Normalize any thrown value into an ActionableError with auto-detected codes.
+ */
+function normalizeError(error, attempted) {
+    if (error instanceof Error) {
+        const err = error;
+        const detected = detectErrorPattern(err);
+        return {
+            type: 'error',
+            code: detected.code,
+            message: err.message,
+            name: 'ActionableError',
+            attempted: attempted ?? 'unknown operation',
+            rootCause: detectRootCause(err),
+            remediationPlan: detected.remediation.message,
+            confidence: detected.remediation.confidence,
+            nextCommand: detected.remediation.nextCommand,
+            remediation: detected.remediation.nextCommand ?? detected.remediation.message,
+            causes: extractCauses(err),
+        };
+    }
+    return {
+        type: 'error',
+        code: ErrorCodes.RUN_COMMAND_FAILED,
+        message: String(error),
+        name: 'ActionableError',
+        attempted: attempted ?? 'unknown operation',
+        rootCause: String(error),
+        remediationPlan: ErrorRemediation.RUN_COMMAND_FAILED.message,
+        confidence: 0.1,
+    };
+}
+/**
+ * Map Node.js error codes and patterns to our error code registry.
+ */
+function detectErrorPattern(err) {
+    const errCode = err.code ?? '';
+    const msg = err.message.toLowerCase();
+    // Node.js system error codes
+    if (errCode === 'MODULE_NOT_FOUND') {
+        return { code: ErrorCodes.DEP_MODULE_NOT_FOUND, remediation: ErrorRemediation.DEP_MODULE_NOT_FOUND };
+    }
+    if (errCode === 'EACCES' || errCode === 'EPERM') {
+        return { code: ErrorCodes.FS_PERMISSION_DENIED, remediation: ErrorRemediation.FS_PERMISSION_DENIED };
+    }
+    if (errCode === 'ENOENT') {
+        return { code: ErrorCodes.FS_FILE_NOT_FOUND, remediation: ErrorRemediation.FS_FILE_NOT_FOUND };
+    }
+    // Preserve custom error codes from callers (e.g., MISSING_TARGET, INDEX_NOT_FOUND)
+    if (errCode && !Object.values(ErrorCodes).includes(errCode)) {
+        const customRemediation = err.remediation
+            ? { message: err.remediation, confidence: 0.7 }
+            : { message: 'Check the error details and try again', confidence: 0.3 };
+        return { code: errCode, remediation: customRemediation };
+    }
+    // Content-based detection for native dependency failures
+    if (msg.includes('tree-sitter') || msg.includes('better-sqlite3')) {
+        return { code: ErrorCodes.DEP_NATIVE_MISSING, remediation: ErrorRemediation.DEP_NATIVE_MISSING };
+    }
+    if (msg.includes('config.json') || msg.includes('.mycodemap')) {
+        return { code: ErrorCodes.CFG_INVALID_CONFIG, remediation: ErrorRemediation.CFG_INVALID_CONFIG };
+    }
+    if (msg.includes('not initialized') || msg.includes('workspace not found')) {
+        return { code: ErrorCodes.CFG_WORKSPACE_NOT_INITIALIZED, remediation: ErrorRemediation.CFG_WORKSPACE_NOT_INITIALIZED };
+    }
+    return { code: ErrorCodes.RUN_COMMAND_FAILED, remediation: ErrorRemediation.RUN_COMMAND_FAILED };
+}
+/**
+ * Extract the deepest root cause from an error message or cause chain.
+ */
+function detectRootCause(err) {
+    if (err.cause instanceof Error) {
+        return detectRootCause(err.cause);
+    }
+    return err.message;
+}
+/**
+ * Walk the error.cause chain and convert each to ActionableError.
+ */
+function extractCauses(err) {
+    const causes = [];
+    let current = err.cause;
+    while (current instanceof Error) {
+        const causeErr = current;
+        causes.push({
+            type: 'error',
+            code: causeErr.code ?? 'UNKNOWN',
+            message: causeErr.message,
+            name: 'ActionableError',
+            attempted: 'nested error',
+            rootCause: causeErr.message,
+            remediationPlan: '',
+            confidence: 0,
+        });
+        current = causeErr.cause;
+    }
+    return causes;
+}
+/**
+ * Programmatically create an ActionableError with sensible defaults.
+ */
+export function createActionableError(code, message, attempted, overrides) {
+    const remediation = ErrorRemediation[code] ?? { message: 'Check the error details', confidence: 0.3 };
+    return {
+        type: 'error',
+        code,
+        message,
+        name: 'ActionableError',
+        attempted,
+        rootCause: overrides?.rootCause ?? message,
+        remediationPlan: overrides?.remediationPlan ?? remediation.message,
+        confidence: overrides?.confidence ?? remediation.confidence,
+        nextCommand: overrides?.nextCommand ?? remediation.nextCommand,
+        remediation: overrides?.nextCommand ?? remediation.message,
+        ...(overrides?.causes ? { causes: overrides.causes } : {}),
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/output/errors.js.map

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

package/dist/cli/output/index.d.ts

@@ -0,0 +1,13 @@
+export { resolveOutputMode } from './mode.js';
+export { createProgressEmitter } from './progress.js';
+export { formatError, createActionableError } from './errors.js';
+export { renderOutput } from './render.js';
+export type { OutputMode, OutputModeOptions, ProgressEmitter, StructuredError, ActionableError } from './types.js';
+export { isActionableError, APPLY_SUGGESTION_CONFIDENCE_THRESHOLD } from './types.js';
+export { ErrorCodes, ErrorRemediation } from './error-codes.js';
+export type { ErrorCode } from './error-codes.js';
+export { tryApplySuggestion } from './apply-suggestion.js';
+export type { SuggestionResult } from './apply-suggestion.js';
+export { checkAndActivateWasmFallback, createNativeDepError } from './wasm-fallback.js';
+export type { WasmFallbackResult } from './wasm-fallback.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/output/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAE,qCAAqC,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACxF,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/cli/output/index.js

@@ -0,0 +1,11 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Barrel exports for output mode module — single import point for all commands
+export { resolveOutputMode } from './mode.js';
+export { createProgressEmitter } from './progress.js';
+export { formatError, createActionableError } from './errors.js';
+export { renderOutput } from './render.js';
+export { isActionableError, APPLY_SUGGESTION_CONFIDENCE_THRESHOLD } from './types.js';
+export { ErrorCodes, ErrorRemediation } from './error-codes.js';
+export { tryApplySuggestion } from './apply-suggestion.js';
+export { checkAndActivateWasmFallback, createNativeDepError } from './wasm-fallback.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/output/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/output/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,qFAAqF;AAErF,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,qCAAqC,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/cli/output/mode.d.ts

@@ -0,0 +1,12 @@
+import type { OutputMode, OutputModeOptions } from './types.js';
+/**
+ * Resolve output mode from CLI flags and TTY state.
+ *
+ * Priority: --json wins over --human (explicit machine-readable takes priority).
+ * No flags: TTY auto-detect (human in terminal, json when piped).
+ *
+ * @param options - CLI flags { json?, human? }
+ * @param ttyOverride - Override for process.stdout.isTTY (useful in tests). Defaults to process.stdout.isTTY.
+ */
+export declare function resolveOutputMode(options?: OutputModeOptions, ttyOverride?: boolean): OutputMode;
+//# sourceMappingURL=mode.d.ts.map

package/dist/cli/output/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../../src/cli/output/mode.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,iBAAsB,EAC/B,WAAW,CAAC,EAAE,OAAO,GACpB,UAAU,CAYZ"}

package/dist/cli/output/mode.js

@@ -0,0 +1,23 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Unified TTY/flag detection — single source of truth for output mode resolution
+/**
+ * Resolve output mode from CLI flags and TTY state.
+ *
+ * Priority: --json wins over --human (explicit machine-readable takes priority).
+ * No flags: TTY auto-detect (human in terminal, json when piped).
+ *
+ * @param options - CLI flags { json?, human? }
+ * @param ttyOverride - Override for process.stdout.isTTY (useful in tests). Defaults to process.stdout.isTTY.
+ */
+export function resolveOutputMode(options = {}, ttyOverride) {
+    if (options.json) {
+        return 'json';
+    }
+    if (options.human) {
+        return 'human';
+    }
+    // No explicit flag: auto-detect from TTY
+    const isTTY = ttyOverride ?? process.stdout.isTTY;
+    return isTTY ? 'human' : 'json';
+}
+//# sourceMappingURL=mode.js.map

package/dist/cli/output/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../../src/cli/output/mode.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,uFAAuF;AAIvF;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAA6B,EAAE,EAC/B,WAAqB;IAErB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,yCAAyC;IACzC,MAAM,KAAK,GAAG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAClD,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAClC,CAAC"}

package/dist/cli/output/progress.d.ts

@@ -0,0 +1,9 @@
+import type { OutputMode, ProgressEmitter } from './types.js';
+/**
+ * Create a progress emitter appropriate for the output mode.
+ *
+ * - JSON mode: writes NDJSON lines {type:"progress", percent, message} to stderr
+ * - Human mode: uses ora spinner on stderr (no stdout pollution)
+ */
+export declare function createProgressEmitter(mode: OutputMode, prefix?: string): ProgressEmitter;
+//# sourceMappingURL=progress.d.ts.map

package/dist/cli/output/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/cli/output/progress.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CAKjB"}

package/dist/cli/output/progress.js

@@ -0,0 +1,65 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Progress emitter abstraction — NDJSON to stderr in JSON mode, ora spinner in human mode
+import ora from 'ora';
+/**
+ * Create a progress emitter appropriate for the output mode.
+ *
+ * - JSON mode: writes NDJSON lines {type:"progress", percent, message} to stderr
+ * - Human mode: uses ora spinner on stderr (no stdout pollution)
+ */
+export function createProgressEmitter(mode, prefix) {
+    if (mode === 'json') {
+        return createJsonProgressEmitter();
+    }
+    return createHumanProgressEmitter(prefix);
+}
+/**
+ * JSON mode: structured NDJSON progress on stderr
+ */
+function createJsonProgressEmitter() {
+    let lastPercent = -1;
+    return {
+        update(percent, message) {
+            // Rate-limit: only emit when percent changes by >= 5 or message changes
+            if (Math.abs(percent - lastPercent) < 5 && lastPercent >= 0) {
+                return;
+            }
+            lastPercent = percent;
+            const line = JSON.stringify({ type: 'progress', percent, message });
+            process.stderr.write(line + '\n');
+        },
+        complete() {
+            const line = JSON.stringify({ type: 'progress', percent: 100, message: 'complete' });
+            process.stderr.write(line + '\n');
+        },
+        fail(message) {
+            const line = JSON.stringify({ type: 'progress', percent: -1, message: message ?? 'failed' });
+            process.stderr.write(line + '\n');
+        },
+    };
+}
+/**
+ * Human mode: ora spinner on stderr
+ */
+function createHumanProgressEmitter(prefix) {
+    const spinner = ora({ spinner: 'dots', prefixText: prefix });
+    return {
+        update(_percent, message) {
+            if (!spinner.isSpinning) {
+                spinner.start();
+            }
+            spinner.text = message;
+        },
+        complete() {
+            if (spinner.isSpinning) {
+                spinner.succeed();
+            }
+        },
+        fail(message) {
+            if (spinner.isSpinning) {
+                spinner.fail(message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=progress.js.map

package/dist/cli/output/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/cli/output/progress.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,gGAAgG;AAEhG,OAAO,GAAG,MAAM,KAAK,CAAC;AAGtB;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAgB,EAChB,MAAe;IAEf,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,yBAAyB,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB;IAChC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC;IAErB,OAAO;QACL,MAAM,CAAC,OAAe,EAAE,OAAe;YACrC,wEAAwE;YACxE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBAC5D,OAAO;YACT,CAAC;YACD,WAAW,GAAG,OAAO,CAAC;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,QAAQ;YACN,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,OAAgB;YACnB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,CAAC,CAAC;YAC7F,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,MAAe;IACjD,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAE7D,OAAO;QACL,MAAM,CAAC,QAAgB,EAAE,OAAe;YACtC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC;QACzB,CAAC;QAED,QAAQ;YACN,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAgB;YACnB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/output/render.d.ts

@@ -0,0 +1,11 @@
+import type { OutputMode } from './types.js';
+/**
+ * Render data to stdout based on output mode.
+ *
+ * - JSON mode: writes JSON.stringify(data) + newline to stdout
+ * - Human mode: writes humanRenderer(data) + newline to stdout
+ *
+ * Uses process.stdout.write (not console.log) for predictable output formatting.
+ */
+export declare function renderOutput<T>(data: T, humanRenderer: (data: T) => string, mode: OutputMode): void;
+//# sourceMappingURL=render.d.ts.map

package/dist/cli/output/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/cli/output/render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,CAAC,EACP,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAClC,IAAI,EAAE,UAAU,GACf,IAAI,CAON"}

package/dist/cli/output/render.js

@@ -0,0 +1,18 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Mode-aware stdout writer — JSON.stringify in json mode, human renderer in human mode
+/**
+ * Render data to stdout based on output mode.
+ *
+ * - JSON mode: writes JSON.stringify(data) + newline to stdout
+ * - Human mode: writes humanRenderer(data) + newline to stdout
+ *
+ * Uses process.stdout.write (not console.log) for predictable output formatting.
+ */
+export function renderOutput(data, humanRenderer, mode) {
+    if (mode === 'json') {
+        process.stdout.write(JSON.stringify(data) + '\n');
+        return;
+    }
+    process.stdout.write(humanRenderer(data) + '\n');
+}
+//# sourceMappingURL=render.js.map

package/dist/cli/output/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/cli/output/render.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,6FAA6F;AAI7F;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAO,EACP,aAAkC,EAClC,IAAgB;IAEhB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/cli/output/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Output mode: 'json' for non-TTY/CI/piped consumers, 'human' for interactive terminals
+ */
+export type OutputMode = 'json' | 'human';
+/**
+ * Options passed from CLI flags to resolveOutputMode
+ */
+export interface OutputModeOptions {
+    json?: boolean;
+    human?: boolean;
+}
+/**
+ * Structured progress emitter — abstracts away NDJSON-vs-spinner differences
+ */
+export interface ProgressEmitter {
+    update(percent: number, message: string): void;
+    complete(): void;
+    fail(message?: string): void;
+}
+/**
+ * Structured error shape for JSON mode output
+ */
+export interface StructuredError {
+    type: 'error';
+    code: string;
+    message: string;
+    remediation?: string;
+}
+/**
+ * Actionable error with recovery context — extends StructuredError
+ * with fields that enable automated or guided remediation.
+ */
+export interface ActionableError extends StructuredError {
+    type: 'error';
+    code: string;
+    name: string;
+    attempted: string;
+    rootCause: string;
+    remediationPlan: string;
+    confidence: number;
+    nextCommand?: string;
+    causes?: ActionableError[];
+}
+/**
+ * Type guard: checks if an error has actionable recovery fields
+ */
+export declare function isActionableError(error: StructuredError | ActionableError): error is ActionableError;
+/**
+ * Confidence threshold for --apply-suggestion auto-execution.
+ * Suggestions below this threshold are not auto-executed.
+ */
+export declare const APPLY_SUGGESTION_CONFIDENCE_THRESHOLD = 0.8;
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/output/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/output/types.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,GAAG,KAAK,IAAI,eAAe,CAEpG;AAED;;;GAGG;AACH,eAAO,MAAM,qCAAqC,MAAM,CAAC"}

package/dist/cli/output/types.js

@@ -0,0 +1,14 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Shared types for AI-first output mode — single source of truth for mode, progress, error shapes
+/**
+ * Type guard: checks if an error has actionable recovery fields
+ */
+export function isActionableError(error) {
+    return 'attempted' in error && 'rootCause' in error && 'confidence' in error;
+}
+/**
+ * Confidence threshold for --apply-suggestion auto-execution.
+ * Suggestions below this threshold are not auto-executed.
+ */
+export const APPLY_SUGGESTION_CONFIDENCE_THRESHOLD = 0.8;
+//# sourceMappingURL=types.js.map

package/dist/cli/output/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/output/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,wGAAwG;AAkDxG;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAwC;IACxE,OAAO,WAAW,IAAI,KAAK,IAAI,WAAW,IAAI,KAAK,IAAI,YAAY,IAAI,KAAK,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,GAAG,CAAC"}

package/dist/cli/output/wasm-fallback.d.ts

@@ -0,0 +1,13 @@
+import type { ActionableError } from './types.js';
+export interface WasmFallbackResult {
+    nativeAvailable: boolean;
+    wasmAvailable: boolean;
+    fallbackActivated: boolean;
+    module: 'tree-sitter' | 'better-sqlite3';
+    message: string;
+}
+export declare function checkAndActivateWasmFallback(mod: 'tree-sitter' | 'better-sqlite3', options: {
+    wasmFallback?: boolean;
+}): Promise<WasmFallbackResult>;
+export declare function createNativeDepError(mod: 'tree-sitter' | 'better-sqlite3', nativeError: Error, wasmAvailable: boolean): ActionableError;
+//# sourceMappingURL=wasm-fallback.d.ts.map

package/dist/cli/output/wasm-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-fallback.d.ts","sourceRoot":"","sources":["../../../src/cli/output/wasm-fallback.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,aAAa,GAAG,gBAAgB,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,aAAa,GAAG,gBAAgB,EACrC,OAAO,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,OAAO,CAAC,kBAAkB,CAAC,CA2C7B;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,aAAa,GAAG,gBAAgB,EACrC,WAAW,EAAE,KAAK,EAClB,aAAa,EAAE,OAAO,GACrB,eAAe,CAkBjB"}

package/dist/cli/output/wasm-fallback.js

@@ -0,0 +1,92 @@
+// [META] since:2026-05-01 | owner:cli-team | stable:false
+// [WHY] Reactive WASM fallback — intercepts native dep failures and switches to WASM loading paths
+import { createActionableError } from './errors.js';
+import { ErrorCodes } from './error-codes.js';
+export async function checkAndActivateWasmFallback(mod, options) {
+    if (!options.wasmFallback) {
+        return {
+            nativeAvailable: await checkNativeModule(mod),
+            wasmAvailable: false,
+            fallbackActivated: false,
+            module: mod,
+            message: '--wasm-fallback not requested',
+        };
+    }
+    const nativeAvailable = await checkNativeModule(mod);
+    if (nativeAvailable) {
+        return {
+            nativeAvailable: true,
+            wasmAvailable: true,
+            fallbackActivated: false,
+            module: mod,
+            message: 'Native module available, WASM fallback not needed',
+        };
+    }
+    const wasmAvailable = await checkWasmModule(mod);
+    if (wasmAvailable) {
+        const envKey = `CODEMAP_USE_WASM_${mod.replace('-', '_').toUpperCase()}`;
+        process.env[envKey] = '1';
+        return {
+            nativeAvailable: false,
+            wasmAvailable: true,
+            fallbackActivated: true,
+            module: mod,
+            message: `Native ${mod} unavailable — activated WASM fallback`,
+        };
+    }
+    return {
+        nativeAvailable: false,
+        wasmAvailable: false,
+        fallbackActivated: false,
+        module: mod,
+        message: `Both native and WASM ${mod} unavailable — install build tools or check WASM module`,
+    };
+}
+export function createNativeDepError(mod, nativeError, wasmAvailable) {
+    const suggestions = ['--wasm-fallback'];
+    if (wasmAvailable) {
+        suggestions.push('WASM module detected — add --wasm-fallback to activate');
+    }
+    suggestions.push('npm rebuild (rebuild native modules)');
+    return createActionableError(wasmAvailable ? ErrorCodes.DEP_WASM_FALLBACK_AVAILABLE : ErrorCodes.DEP_NATIVE_MISSING, `${mod} cannot be loaded: ${nativeError.message}`, `loading ${mod}`, {
+        rootCause: nativeError.message,
+        remediationPlan: suggestions.join('; '),
+        confidence: wasmAvailable ? 0.95 : 0.9,
+        nextCommand: 'codemap --wasm-fallback',
+    });
+}
+async function checkNativeModule(mod) {
+    try {
+        if (mod === 'tree-sitter') {
+            const ts = await import('tree-sitter');
+            return !!ts.default || !!ts;
+        }
+        const sqlite = await import('better-sqlite3');
+        return !!sqlite.default || !!sqlite;
+    }
+    catch {
+        return false;
+    }
+}
+async function checkWasmModule(mod) {
+    try {
+        if (mod === 'tree-sitter') {
+            const wasmModule = 'web-tree-sitter';
+            await import(wasmModule);
+            return true;
+        }
+        const nodeVersion = process.versions.node.split('.').map(Number);
+        if (nodeVersion[0] >= 22) {
+            const sqliteModule = 'node:sqlite';
+            await import(sqliteModule);
+            return true;
+        }
+        const sqlJsModule = 'sql.js';
+        await import(sqlJsModule);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=wasm-fallback.js.map

package/dist/cli/output/wasm-fallback.js.map

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

package/dist/cli/paths.d.ts

@@ -3,6 +3,7 @@
  */
 export declare const DEFAULT_OUTPUT_DIR_NEW = ".mycodemap";
 export declare const DEFAULT_OUTPUT_DIR_OLD = ".codemap";
+export declare const CONFIG_FILE_CANONICAL = "config.json";
 export declare const CONFIG_FILE_NEW = "mycodemap.config.json";
 export declare const CONFIG_FILE_OLD = "codemap.config.json";
 export declare const DATA_FILE = "codemap.json";
@@ -32,8 +33,9 @@ export interface ResolvePathsResult {
 export declare function resolveOutputDir(customOutput?: string, rootDir?: string): ResolvePathsResult;
 /**
  * 解析配置文件路径（读取时使用）
- * - 优先检查新配置 mycodemap.config.json
- * - 不存在则回退旧配置 codemap.config.json
+ * - 优先检查 canonical `.mycodemap/config.json`
+ * - 不存在则回退根目录 `mycodemap.config.json`
+ * - 再回退旧配置 `codemap.config.json`
  *
  * @param rootDir - 项目根目录（默认为 cwd）
  * @returns 配置文件路径和是否使用旧配置

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

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,sBAAsB,eAAe,CAAC;AACnD,eAAO,MAAM,sBAAsB,aAAa,CAAC;AACjD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,eAAO,MAAM,eAAe,wBAAwB,CAAC;AACrD,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAyBD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,GAAG,kBAAkB,CA8BnG;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,MAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAa9F;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAc,GAAG,MAAM,CAG7D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,MAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAErG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,MAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAQ5C"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,sBAAsB,eAAe,CAAC;AACnD,eAAO,MAAM,sBAAsB,aAAa,CAAC;AACjD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,eAAO,MAAM,eAAe,wBAAwB,CAAC;AACrD,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AA6BD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,GAAG,kBAAkB,CA8BnG;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,MAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAiB9F;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAc,GAAG,MAAM,CAG7D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,MAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAErG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,MAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAQ5C"}