@mycodemap/mycodemap 1.9.0 → 2.7.0

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,14 @@
+import type { ActionableError } from './types.js';
+export interface WasmFallbackResult {
+    nativeAvailable: boolean;
+    wasmAvailable: boolean;
+    fallbackActivated: boolean;
+    module: 'tree-sitter' | 'better-sqlite3';
+    implementation?: 'native' | 'wasm' | 'node:sqlite' | 'sql.js';
+    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,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC9D,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/preview/complexity-scanner.d.ts

@@ -0,0 +1,21 @@
+export interface ComplexityHotspot {
+    file: string;
+    score: number;
+    functions: number;
+}
+/**
+ * Scan a single file's cyclomatic complexity via escomplex.
+ * Returns null for non-JS/TS files, missing files, or parse errors.
+ * Never throws — individual file failures are silently skipped.
+ */
+export declare function scanFileComplexity(filePath: string, rootDir: string): ComplexityHotspot | null;
+/**
+ * Scan multiple files and return the top-5 cyclomatic complexity hotspots.
+ * Filters out null results (non-JS/TS files and parse failures),
+ * sorts by score descending, and caps at 5 results (per D-08).
+ *
+ * This function is synchronous because escomplex is synchronous
+ * and readFileSync is synchronous.
+ */
+export declare function scanComplexity(files: string[], rootDir: string): ComplexityHotspot[];
+//# sourceMappingURL=complexity-scanner.d.ts.map

package/dist/cli/preview/complexity-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity-scanner.d.ts","sourceRoot":"","sources":["../../../src/cli/preview/complexity-scanner.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAQD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,iBAAiB,GAAG,IAAI,CAkB1B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,GACd,iBAAiB,EAAE,CAMrB"}

package/dist/cli/preview/complexity-scanner.js

@@ -0,0 +1,52 @@
+// [META] since:2026-05-02 | owner:cli-team | stable:false
+// [WHY] escomplex-based file-level cyclomatic complexity scoring for codemap preview —
+// lightweight alternative to tree-sitter-based ast-complexity-analyzer.ts, no native deps
+// required. Per-file try-catch prevents individual parse failures from aborting the scan.
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import escomplex from 'typhonjs-escomplex';
+/**
+ * Only feed JS/TS files to escomplex — it cannot parse Python, Go, Rust, etc.
+ * Prevents RESEARCH Pitfall 6 (escomplex barfs on non-JS/TS files).
+ */
+const JS_TS_EXTENSIONS = new Set(['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs']);
+/**
+ * Scan a single file's cyclomatic complexity via escomplex.
+ * Returns null for non-JS/TS files, missing files, or parse errors.
+ * Never throws — individual file failures are silently skipped.
+ */
+export function scanFileComplexity(filePath, rootDir) {
+    const ext = path.extname(filePath);
+    if (!JS_TS_EXTENSIONS.has(ext)) {
+        return null;
+    }
+    try {
+        const source = readFileSync(filePath, 'utf8');
+        const report = escomplex.analyzeModule(source);
+        return {
+            file: path.relative(rootDir, filePath),
+            score: report.aggregate?.cyclomatic ?? 0,
+            functions: report.methods.length,
+        };
+    }
+    catch {
+        // Skip individual file failures — do NOT throw
+        return null;
+    }
+}
+/**
+ * Scan multiple files and return the top-5 cyclomatic complexity hotspots.
+ * Filters out null results (non-JS/TS files and parse failures),
+ * sorts by score descending, and caps at 5 results (per D-08).
+ *
+ * This function is synchronous because escomplex is synchronous
+ * and readFileSync is synchronous.
+ */
+export function scanComplexity(files, rootDir) {
+    return files
+        .map((file) => scanFileComplexity(file, rootDir))
+        .filter((h) => h !== null)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 5);
+}
+//# sourceMappingURL=complexity-scanner.js.map

package/dist/cli/preview/complexity-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity-scanner.js","sourceRoot":"","sources":["../../../src/cli/preview/complexity-scanner.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,uFAAuF;AACvF,0FAA0F;AAC1F,0FAA0F;AAE1F,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAQ3C;;;GAGG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,OAAe;IAEf,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;YACtC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,IAAI,CAAC;YACxC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;SACjC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAe,EACf,OAAe;IAEf,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,CAAC,EAA0B,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;SACjD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/dist/cli/preview/dependency-extractor.d.ts

@@ -0,0 +1,38 @@
+export interface DependencyExtractionResult {
+    direct: string[];
+    count: number;
+}
+/**
+ * Extract direct and dev dependencies from a Node.js package.json.
+ * Returns concatenated keys of `dependencies` and `devDependencies`.
+ * Returns [] on any error (missing file, invalid JSON, etc.).
+ */
+export declare function extractNodeDeps(rootDir: string): string[];
+/**
+ * Extract direct dependencies from a Go go.mod file.
+ * Handles both `require (` blocks and single-line `require` statements.
+ * Strips `// indirect` and `// direct` inline comments before parsing.
+ * Returns [] on any error (missing file, read failure, etc.).
+ */
+export declare function extractGoDeps(rootDir: string): string[];
+/**
+ * Extract direct and dev dependencies from a Rust Cargo.toml file.
+ * Uses smol-toml (dynamic import) for TOML parsing.
+ * Returns [] on any error (missing file, parse failure, smol-toml import failure, etc.).
+ */
+export declare function extractRustDeps(rootDir: string): Promise<string[]>;
+/**
+ * Extract direct dependencies from a Python pyproject.toml file.
+ * Supports both PEP 621 `[project.dependencies]` and Poetry
+ * `[tool.poetry.dependencies]` formats.
+ * Uses smol-toml (dynamic import) for TOML parsing.
+ * Returns [] on any error (missing file, parse failure, smol-toml import failure, etc.).
+ */
+export declare function extractPythonDeps(rootDir: string): Promise<string[]>;
+/**
+ * Extract all direct dependencies from all supported marker files.
+ * Calls all four extractors and deduplicates the results.
+ * Returns { direct: string[], count: number }.
+ */
+export declare function extractDependencies(rootDir: string): Promise<DependencyExtractionResult>;
+//# sourceMappingURL=dependency-extractor.d.ts.map

package/dist/cli/preview/dependency-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-extractor.d.ts","sourceRoot":"","sources":["../../../src/cli/preview/dependency-extractor.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAkCvD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBxE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2B1E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAW9F"}

package/dist/cli/preview/dependency-extractor.js

@@ -0,0 +1,140 @@
+// [META] since:2026-05-02 | owner:cli-team | stable:false
+// [WHY] Marker-file dependency extraction for codemap preview — reads package.json,
+// go.mod, Cargo.toml, pyproject.toml to list direct dependencies without source-code
+// parsing. Graceful degradation: each extractor returns [] on missing/unparseable files.
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * Extract direct and dev dependencies from a Node.js package.json.
+ * Returns concatenated keys of `dependencies` and `devDependencies`.
+ * Returns [] on any error (missing file, invalid JSON, etc.).
+ */
+export function extractNodeDeps(rootDir) {
+    try {
+        const content = readFileSync(path.join(rootDir, 'package.json'), 'utf8');
+        const pkg = JSON.parse(content);
+        return [
+            ...Object.keys(pkg.dependencies || {}),
+            ...Object.keys(pkg.devDependencies || {}),
+        ];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Extract direct dependencies from a Go go.mod file.
+ * Handles both `require (` blocks and single-line `require` statements.
+ * Strips `// indirect` and `// direct` inline comments before parsing.
+ * Returns [] on any error (missing file, read failure, etc.).
+ */
+export function extractGoDeps(rootDir) {
+    try {
+        const content = readFileSync(path.join(rootDir, 'go.mod'), 'utf8');
+        const deps = [];
+        let inRequire = false;
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('require (')) {
+                inRequire = true;
+                continue;
+            }
+            if (inRequire && trimmed === ')') {
+                inRequire = false;
+                continue;
+            }
+            if (inRequire) {
+                // Strip inline comments: "github.com/pkg v1.0 // indirect"
+                const depLine = trimmed.replace(/\/\/.*$/, '').trim();
+                const match = depLine.match(/^(\S+)\s+v\S+/);
+                if (match)
+                    deps.push(match[1]);
+            }
+            else if (trimmed.startsWith('require ')) {
+                // Single-line require: "require github.com/pkg v1.0"
+                const depLine = trimmed.replace(/\/\/.*$/, '').trim();
+                const match = depLine.match(/^require\s+(\S+)\s+v\S+/);
+                if (match)
+                    deps.push(match[1]);
+            }
+        }
+        return deps;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Extract direct and dev dependencies from a Rust Cargo.toml file.
+ * Uses smol-toml (dynamic import) for TOML parsing.
+ * Returns [] on any error (missing file, parse failure, smol-toml import failure, etc.).
+ */
+export async function extractRustDeps(rootDir) {
+    try {
+        const content = readFileSync(path.join(rootDir, 'Cargo.toml'), 'utf8');
+        const { parse: parseToml } = await import('smol-toml');
+        const parsed = parseToml(content);
+        const deps = [];
+        if (parsed.dependencies && typeof parsed.dependencies === 'object') {
+            deps.push(...Object.keys(parsed.dependencies));
+        }
+        if (parsed['dev-dependencies'] && typeof parsed['dev-dependencies'] === 'object') {
+            deps.push(...Object.keys(parsed['dev-dependencies']));
+        }
+        return deps;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Extract direct dependencies from a Python pyproject.toml file.
+ * Supports both PEP 621 `[project.dependencies]` and Poetry
+ * `[tool.poetry.dependencies]` formats.
+ * Uses smol-toml (dynamic import) for TOML parsing.
+ * Returns [] on any error (missing file, parse failure, smol-toml import failure, etc.).
+ */
+export async function extractPythonDeps(rootDir) {
+    try {
+        const content = readFileSync(path.join(rootDir, 'pyproject.toml'), 'utf8');
+        const { parse: parseToml } = await import('smol-toml');
+        const parsed = parseToml(content);
+        const deps = [];
+        // PEP 621 format: [project.dependencies]
+        const project = parsed.project;
+        if (project?.dependencies && Array.isArray(project.dependencies)) {
+            for (const dep of project.dependencies) {
+                const name = dep.match(/^([A-Za-z0-9_-]+)/)?.[1];
+                if (name)
+                    deps.push(name);
+            }
+        }
+        // Poetry format: [tool.poetry.dependencies]
+        const tool = parsed.tool;
+        const poetry = tool?.poetry;
+        if (poetry?.dependencies && typeof poetry.dependencies === 'object') {
+            deps.push(...Object.keys(poetry.dependencies));
+        }
+        return deps;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Extract all direct dependencies from all supported marker files.
+ * Calls all four extractors and deduplicates the results.
+ * Returns { direct: string[], count: number }.
+ */
+export async function extractDependencies(rootDir) {
+    const [nodeDeps, goDeps, rustDeps, pythonDeps] = await Promise.all([
+        Promise.resolve(extractNodeDeps(rootDir)),
+        Promise.resolve(extractGoDeps(rootDir)),
+        extractRustDeps(rootDir),
+        extractPythonDeps(rootDir),
+    ]);
+    const all = [...nodeDeps, ...goDeps, ...rustDeps, ...pythonDeps];
+    const direct = Array.from(new Set(all));
+    return { direct, count: direct.length };
+}
+//# sourceMappingURL=dependency-extractor.js.map

package/dist/cli/preview/dependency-extractor.js.map

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

package/dist/cli/preview/preview-renderer.d.ts

@@ -0,0 +1,32 @@
+export interface PreviewData {
+    projectType: string;
+    profile: string;
+    files: {
+        total: number;
+        byExtension: Record<string, number>;
+    };
+    modules: {
+        count: number;
+        top: string[];
+    };
+    dependencies: {
+        direct: string[];
+        count: number;
+    };
+    complexity: {
+        hotspots: Array<{
+            file: string;
+            score: number;
+            functions: number;
+        }>;
+    };
+    hint: string;
+}
+/**
+ * Format preview data as human-readable output with chalk colors.
+ *
+ * Renders four sections (files, modules, dependencies, complexity hotspots)
+ * and always appends the hint text at the end (per D-10).
+ */
+export declare function formatPreviewHuman(data: PreviewData): string;
+//# sourceMappingURL=preview-renderer.d.ts.map

package/dist/cli/preview/preview-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-renderer.d.ts","sourceRoot":"","sources":["../../../src/cli/preview/preview-renderer.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,CAAC;IACF,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,EAAE,CAAC;KACf,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,EAAE;QACV,QAAQ,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAiD5D"}

package/dist/cli/preview/preview-renderer.js

@@ -0,0 +1,54 @@
+// [META] since:2026-05-02 | owner:cli-team | stable:false
+// [WHY] Human-readable output formatting for codemap preview — renders the four-section
+// summary as a table/color console output.
+import chalk from 'chalk';
+/**
+ * Format preview data as human-readable output with chalk colors.
+ *
+ * Renders four sections (files, modules, dependencies, complexity hotspots)
+ * and always appends the hint text at the end (per D-10).
+ */
+export function formatPreviewHuman(data) {
+    const lines = [];
+    // Header
+    lines.push(chalk.cyan.bold('CodeMap Preview'));
+    lines.push('');
+    // Project type & profile
+    lines.push(chalk.white('Project: ') + `${data.projectType} (profile: ${data.profile})`);
+    lines.push('');
+    // Files section
+    const extBreakdown = Object.entries(data.files.byExtension)
+        .sort((a, b) => b[1] - a[1])
+        .map(([ext, count]) => `${ext.toUpperCase().replace('.', '')}: ${count}`)
+        .join(', ');
+    lines.push(chalk.blue('Files: ') + `${data.files.total} total source files` +
+        (extBreakdown ? ` (${extBreakdown})` : ''));
+    lines.push('');
+    // Modules section
+    const topDirs = data.modules.top.length > 0
+        ? data.modules.top.join(', ')
+        : 'none';
+    lines.push(chalk.blue('Modules: ') + `${data.modules.count} modules — ${topDirs}`);
+    lines.push('');
+    // Dependencies section
+    const depDisplay = data.dependencies.count > 0
+        ? `${data.dependencies.count} direct dependencies — ${data.dependencies.direct.slice(0, 10).join(', ')}`
+        : 'none detected';
+    lines.push(chalk.blue('Dependencies: ') + depDisplay);
+    lines.push('');
+    // Complexity hotspots section
+    lines.push(chalk.blue('Complexity hotspots:'));
+    if (data.complexity.hotspots.length === 0) {
+        lines.push(chalk.gray('  (no JS/TS files found for complexity analysis)'));
+    }
+    else {
+        data.complexity.hotspots.forEach((hotspot, i) => {
+            lines.push(`  ${i + 1}. ${chalk.white(hotspot.file)} (score=${hotspot.score}, functions=${hotspot.functions})`);
+        });
+    }
+    lines.push('');
+    // Hint (always appended per D-10)
+    lines.push(chalk.gray(data.hint));
+    return lines.join('\n');
+}
+//# sourceMappingURL=preview-renderer.js.map

package/dist/cli/preview/preview-renderer.js.map

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

package/dist/cli/storage-runtime.d.ts

@@ -1,8 +1,15 @@
 import type { IStorage } from '../interface/types/storage.js';
+import type { CodeMap } from '../types/index.js';
 import { type LoadedCodemapConfig } from './config-loader.js';
 export interface LoadedStorageRuntime {
     loadedConfig: LoadedCodemapConfig;
     storage: IStorage;
 }
+export interface LoadedCodeMapRuntime {
+    rootDir: string;
+    dataPath: string;
+    codeMap: CodeMap;
+}
 export declare function createConfiguredStorage(rootDir?: string): Promise<LoadedStorageRuntime>;
+export declare function loadCodeMapRuntime(rootDir?: string): Promise<LoadedCodeMapRuntime>;
 //# sourceMappingURL=storage-runtime.d.ts.map

package/dist/cli/storage-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-runtime.d.ts","sourceRoot":"","sources":["../../src/cli/storage-runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,wBAAsB,uBAAuB,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAQpG"}
+{"version":3,"file":"storage-runtime.d.ts","sourceRoot":"","sources":["../../src/cli/storage-runtime.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,uBAAuB,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAQpG;AAED,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAsB/F"}

package/dist/cli/storage-runtime.js

@@ -1,7 +1,9 @@
 // [META] since:2026-03-24 | owner:cli-team | stable:false
 // [WHY] Centralize CLI storage configuration loading so runtime commands honor the configured backend
+import { readFile } from 'node:fs/promises';
 import { cwd } from 'node:process';
 import { storageFactory } from '../infrastructure/storage/StorageFactory.js';
+import { resolveDataPath } from './paths.js';
 import { loadCodemapConfig } from './config-loader.js';
 export async function createConfiguredStorage(rootDir = cwd()) {
     const loadedConfig = await loadCodemapConfig(rootDir);
@@ -11,4 +13,24 @@ export async function createConfiguredStorage(rootDir = cwd()) {
         storage,
     };
 }
+export async function loadCodeMapRuntime(rootDir = cwd()) {
+    const dataPath = resolveDataPath(rootDir);
+    try {
+        const raw = await readFile(dataPath, 'utf-8');
+        return {
+            rootDir,
+            dataPath,
+            codeMap: JSON.parse(raw),
+        };
+    }
+    catch (error) {
+        const runtimeError = new Error(error instanceof Error && error.message
+            ? error.message
+            : 'Code map not found, run codemap generate first');
+        runtimeError.code = 'INDEX_NOT_FOUND';
+        runtimeError.remediation = 'Run codemap generate to create the code map';
+        runtimeError.cause = error;
+        throw runtimeError;
+    }
+}
 //# sourceMappingURL=storage-runtime.js.map

package/dist/cli/storage-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage-runtime.js","sourceRoot":"","sources":["../../src/cli/storage-runtime.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,sGAAsG;AAEtG,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAA4B,MAAM,oBAAoB,CAAC;AAOjF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,UAAkB,GAAG,EAAE;IACnE,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE5F,OAAO;QACL,YAAY;QACZ,OAAO;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"storage-runtime.js","sourceRoot":"","sources":["../../src/cli/storage-runtime.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,sGAAsG;AAEtG,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGnC,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAA4B,MAAM,oBAAoB,CAAC;AAajF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,UAAkB,GAAG,EAAE;IACnE,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE5F,OAAO;QACL,YAAY;QACZ,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAkB,GAAG,EAAE;IAC9D,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO;YACL,OAAO;YACP,QAAQ;YACR,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY;SACpC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,IAAI,KAAK,CAC5B,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO;YACrC,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,gDAAgD,CACa,CAAC;QAEpE,YAAY,CAAC,IAAI,GAAG,iBAAiB,CAAC;QACtC,YAAY,CAAC,WAAW,GAAG,6CAA6C,CAAC;QACzE,YAAY,CAAC,KAAK,GAAG,KAAK,CAAC;QAC3B,MAAM,YAAY,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/cli/tree-sitter-check.d.ts

@@ -25,7 +25,12 @@ export declare const COMMANDS_NOT_REQUIRING_TREE_SITTER: Set<string>;
  */
 export declare function commandRequiresTreeSitter(commandName: string): boolean;
 /**
- * 验证 tree-sitter 可用性，不可用时抛出错误
+ * 异步验证 tree-sitter 可用性，使用 loader-aware 检测。
+ * 不可用时抛出 ActionableError，包含 WASM fallback 建议。
+ */
+export declare function validateTreeSitterAsync(): Promise<TreeSitterInfo>;
+/**
+ * 验证 tree-sitter 可用性，不可用时抛出错误（同步版本，保持向后兼容）
  */
 export declare function validateTreeSitter(): TreeSitterInfo;
 /**

package/dist/cli/tree-sitter-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree-sitter-check.d.ts","sourceRoot":"","sources":["../../src/cli/tree-sitter-check.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,cAAc,CAAC,CAoBhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAqBrD;AAqBD;;GAEG;AACH,eAAO,MAAM,8BAA8B,aAOzC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kCAAkC,aAO7C,CAAC;AAEH;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAWtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CAgBnD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQlE"}
+{"version":3,"file":"tree-sitter-check.d.ts","sourceRoot":"","sources":["../../src/cli/tree-sitter-check.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,cAAc,CAAC,CAoBhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAqBrD;AAqBD;;GAEG;AACH,eAAO,MAAM,8BAA8B,aAOzC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kCAAkC,aAO7C,CAAC;AAEH;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAWtE;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,cAAc,CAAC,CAqBvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CAgBnD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQlE"}

package/dist/cli/tree-sitter-check.js

@@ -101,7 +101,29 @@ export function commandRequiresTreeSitter(commandName) {
     return true;
 }
 /**
- * 验证 tree-sitter 可用性，不可用时抛出错误
+ * 异步验证 tree-sitter 可用性，使用 loader-aware 检测。
+ * 不可用时抛出 ActionableError，包含 WASM fallback 建议。
+ */
+export async function validateTreeSitterAsync() {
+    const info = await detectTreeSitter();
+    if (!info.isAvailable) {
+        const error = new Error([
+            `❌ tree-sitter 不可用`,
+            `  错误: ${info.error || '未知错误'}`,
+            '',
+            '某些命令需要 tree-sitter 才能运行。',
+            '请确保已正确安装依赖: npm install',
+            '',
+            '或使用 --wasm-fallback 自动切换到 WASM 版本。',
+        ].join('\n'));
+        error.code = 'DEP_NATIVE_MISSING';
+        error.remediation = 'tree-sitter WASM fallback';
+        throw error;
+    }
+    return info;
+}
+/**
+ * 验证 tree-sitter 可用性，不可用时抛出错误（同步版本，保持向后兼容）
  */
 export function validateTreeSitter() {
     const info = detectTreeSitterSync();