@mycodemap/mycodemap 0.5.2-beta.1 → 2.0.0

package/dist/cli/doctor/check-workspace-drift.js

@@ -0,0 +1,83 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Workspace drift detection — compares init-last.json receipt asset paths against actual filesystem state
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+const RECEIPT_RELATIVE_PATH = '.mycodemap/status/init-last.json';
+export function checkWorkspaceDrift(rootDir) {
+    const receiptPath = path.join(rootDir, RECEIPT_RELATIVE_PATH);
+    if (!existsSync(receiptPath)) {
+        return [
+            {
+                category: 'config',
+                severity: 'warn',
+                id: 'workspace-not-initialized',
+                message: 'No init receipt found — workspace has not been initialized',
+                remediation: "Run 'codemap init' to create the workspace",
+                nextCommand: 'mycodemap init',
+            },
+        ];
+    }
+    let receipt;
+    try {
+        const raw = readFileSync(receiptPath, 'utf8');
+        receipt = JSON.parse(raw);
+    }
+    catch {
+        return [
+            {
+                category: 'config',
+                severity: 'error',
+                id: 'receipt-invalid',
+                message: 'init-last.json exists but cannot be parsed',
+                remediation: "Run 'codemap init' to regenerate the receipt",
+                nextCommand: 'mycodemap init',
+            },
+        ];
+    }
+    if (!Array.isArray(receipt.assets)) {
+        return [
+            {
+                category: 'config',
+                severity: 'error',
+                id: 'receipt-invalid',
+                message: 'init-last.json has no assets array',
+                remediation: "Run 'codemap init' to regenerate the receipt",
+                nextCommand: 'mycodemap init',
+            },
+        ];
+    }
+    const driftResults = [];
+    for (const asset of receipt.assets) {
+        if (!asset.path) {
+            continue;
+        }
+        const absolutePath = path.resolve(rootDir, asset.path);
+        if (!existsSync(absolutePath)) {
+            const relativePath = path.relative(rootDir, absolutePath);
+            const isToolOwned = asset.ownership === 'tool-owned';
+            driftResults.push({
+                category: 'config',
+                severity: isToolOwned ? 'error' : 'warn',
+                id: 'workspace-drift-detected',
+                message: `Receipt asset "${asset.key}" (${asset.label}) not found at ${relativePath}`,
+                remediation: isToolOwned
+                    ? "Run 'codemap init' to recreate missing tool-owned files"
+                    : 'Verify if the file was intentionally removed, or run codemap init to recreate it',
+                nextCommand: isToolOwned ? 'mycodemap init' : undefined,
+            });
+        }
+    }
+    if (driftResults.length === 0) {
+        return [
+            {
+                category: 'config',
+                severity: 'ok',
+                id: 'workspace-drift-ok',
+                message: 'All receipt assets match the filesystem',
+                remediation: 'No action needed',
+            },
+        ];
+    }
+    return driftResults;
+}
+//# sourceMappingURL=check-workspace-drift.js.map

package/dist/cli/doctor/check-workspace-drift.js.map

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

package/dist/cli/doctor/formatter.d.ts

@@ -0,0 +1,20 @@
+import type { DiagnosticResult } from './types.js';
+/**
+ * Build serializable data array from diagnostics — same filtering logic as
+ * formatDoctorJson but returns the array of objects instead of a JSON string.
+ * Used by renderOutput for JSON mode output.
+ */
+export declare function formatDoctorJsonData(results: DiagnosticResult[]): Record<string, string>[];
+/**
+ * Format diagnostics as a JSON flat array — simple, grepable, jq-friendly.
+ * Each element: {category, severity, id, message, remediation}
+ * nextCommand is included only when defined.
+ */
+export declare function formatDoctorJson(results: DiagnosticResult[]): string;
+/**
+ * Format diagnostics as a colorized table — human-friendly for TTY output.
+ * Columns: CATEGORY, SEVERITY, ID, MESSAGE
+ * Grouped by category order with a summary line.
+ */
+export declare function formatDoctorReport(results: DiagnosticResult[]): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/cli/doctor/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/cli/doctor/formatter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,YAAY,CAAC;AAkCvE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAc1F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAiCtE"}

package/dist/cli/doctor/formatter.js

@@ -0,0 +1,91 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] TTY-aware output formatting — JSON flat array for non-TTY/CI, colorized table for interactive terminals
+import chalk from 'chalk';
+const CATEGORY_ORDER = {
+    install: 0,
+    config: 1,
+    runtime: 2,
+    agent: 3,
+};
+const CATEGORY_WIDTH = 10;
+const SEVERITY_WIDTH = 8;
+const ID_WIDTH = 28;
+function severityLabel(severity) {
+    switch (severity) {
+        case 'error':
+            return chalk.red('error');
+        case 'warn':
+            return chalk.yellow('warn');
+        case 'ok':
+            return chalk.green('ok');
+        case 'info':
+            return chalk.cyan('info');
+    }
+}
+function sortByCategory(results) {
+    return [...results].sort((a, b) => {
+        const orderA = CATEGORY_ORDER[a.category] ?? 99;
+        const orderB = CATEGORY_ORDER[b.category] ?? 99;
+        return orderA - orderB;
+    });
+}
+/**
+ * Build serializable data array from diagnostics — same filtering logic as
+ * formatDoctorJson but returns the array of objects instead of a JSON string.
+ * Used by renderOutput for JSON mode output.
+ */
+export function formatDoctorJsonData(results) {
+    return results.map((r) => {
+        const entry = {
+            category: r.category,
+            severity: r.severity,
+            id: r.id,
+            message: r.message,
+            remediation: r.remediation,
+        };
+        if (r.nextCommand) {
+            entry.nextCommand = r.nextCommand;
+        }
+        return entry;
+    });
+}
+/**
+ * Format diagnostics as a JSON flat array — simple, grepable, jq-friendly.
+ * Each element: {category, severity, id, message, remediation}
+ * nextCommand is included only when defined.
+ */
+export function formatDoctorJson(results) {
+    return JSON.stringify(formatDoctorJsonData(results), null, 2);
+}
+/**
+ * Format diagnostics as a colorized table — human-friendly for TTY output.
+ * Columns: CATEGORY, SEVERITY, ID, MESSAGE
+ * Grouped by category order with a summary line.
+ */
+export function formatDoctorReport(results) {
+    const sorted = sortByCategory(results);
+    const lines = [];
+    // Header
+    const header = 'CATEGORY'.padEnd(CATEGORY_WIDTH) +
+        'SEVERITY'.padEnd(SEVERITY_WIDTH) +
+        'ID'.padEnd(ID_WIDTH) +
+        'MESSAGE';
+    lines.push(header);
+    lines.push('-'.repeat(header.length));
+    // Data rows
+    for (const r of sorted) {
+        const category = r.category.padEnd(CATEGORY_WIDTH);
+        const severity = severityLabel(r.severity).padEnd(SEVERITY_WIDTH + 9); // +9 for ANSI escape codes from chalk
+        const id = r.id.padEnd(ID_WIDTH);
+        lines.push(`${category}${severity}${id}${r.message}`);
+    }
+    // Summary line
+    const errorCount = results.filter((r) => r.severity === 'error').length;
+    const warnCount = results.filter((r) => r.severity === 'warn').length;
+    const infoCount = results.filter((r) => r.severity === 'info').length;
+    const okCount = results.filter((r) => r.severity === 'ok').length;
+    lines.push('');
+    lines.push(`Total: ${results.length} diagnostics (${errorCount} errors, ${warnCount} warnings, ${infoCount} info, ${okCount} passed)`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=formatter.js.map

package/dist/cli/doctor/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../../src/cli/doctor/formatter.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,gHAAgH;AAEhH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,cAAc,GAA2B;IAC7C,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB,SAAS,aAAa,CAAC,QAA4B;IACjD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,OAA2B;IACjD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA2B;IAC9D,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACvB,MAAM,KAAK,GAA2B;YACpC,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC;QACF,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAClB,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;QACpC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA2B;IAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA2B;IAC5D,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,SAAS;IACT,MAAM,MAAM,GACV,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC;QACjC,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrB,SAAS,CAAC;IACZ,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAEtC,YAAY;IACZ,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,sCAAsC;QAC7G,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,eAAe;IACf,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IACxE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IACtE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IACtE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;IAElE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,UAAU,OAAO,CAAC,MAAM,iBAAiB,UAAU,YAAY,SAAS,cAAc,SAAS,UAAU,OAAO,UAAU,CAC3H,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,8 @@
+export type { DiagnosticCategory, DiagnosticResult, DiagnosticSeverity, DoctorOptions, DoctorReport, } from './types.js';
+export { runDoctor } from './orchestrator.js';
+export { formatDoctorJson, formatDoctorReport } from './formatter.js';
+export { checkGhostCommands } from './check-ghost-commands.js';
+export { checkNativeDeps } from './check-native-deps.js';
+export { checkWorkspaceDrift } from './check-workspace-drift.js';
+export { checkAgent } from './check-agent.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/doctor/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cli/doctor/index.js

@@ -0,0 +1,9 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Public API for the doctor module — orchestrator, formatters, types, individual checkers
+export { runDoctor } from './orchestrator.js';
+export { formatDoctorJson, formatDoctorReport } from './formatter.js';
+export { checkGhostCommands } from './check-ghost-commands.js';
+export { checkNativeDeps } from './check-native-deps.js';
+export { checkWorkspaceDrift } from './check-workspace-drift.js';
+export { checkAgent } from './check-agent.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/doctor/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,gGAAgG;AAUhG,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cli/doctor/orchestrator.d.ts

@@ -0,0 +1,3 @@
+import type { DoctorOptions, DoctorReport } from './types.js';
+export declare function runDoctor(options: DoctorOptions): Promise<DoctorReport>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/cli/doctor/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/cli/doctor/orchestrator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAoB,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhF,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAgC7E"}

package/dist/cli/doctor/orchestrator.js

@@ -0,0 +1,37 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Orchestrate all doctor checkers and compute aggregate exit code per CONTEXT.md exit behavior decision
+import { checkGhostCommands } from './check-ghost-commands.js';
+import { checkNativeDeps } from './check-native-deps.js';
+import { checkWorkspaceDrift } from './check-workspace-drift.js';
+import { checkAgent } from './check-agent.js';
+export async function runDoctor(options) {
+    const rootDir = options.cwd ?? process.cwd();
+    // Run all checkers in parallel — ghost/native/workspace are sync, agent is async
+    const [ghostResults, nativeResults, workspaceResults, agentResults] = await Promise.all([
+        Promise.resolve(checkGhostCommands(rootDir)),
+        Promise.resolve(checkNativeDeps()),
+        Promise.resolve(checkWorkspaceDrift(rootDir)),
+        checkAgent(),
+    ]);
+    const results = [
+        ...ghostResults,
+        ...nativeResults,
+        ...workspaceResults,
+        ...agentResults,
+    ];
+    // Compute exit code: 0=all pass, 1=has errors, 2=warnings only
+    const hasErrors = results.some((r) => r.severity === 'error');
+    const hasWarnings = results.some((r) => r.severity === 'warn');
+    let exitCode;
+    if (hasErrors) {
+        exitCode = 1;
+    }
+    else if (hasWarnings) {
+        exitCode = 2;
+    }
+    else {
+        exitCode = 0;
+    }
+    return { results, exitCode };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/cli/doctor/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../../src/cli/doctor/orchestrator.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,8GAA8G;AAE9G,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAE7C,iFAAiF;IACjF,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtF,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QAClC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC7C,UAAU,EAAE;KACb,CAAC,CAAC;IAEH,MAAM,OAAO,GAAuB;QAClC,GAAG,YAAY;QACf,GAAG,aAAa;QAChB,GAAG,gBAAgB;QACnB,GAAG,YAAY;KAChB,CAAC;IAEF,+DAA+D;IAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IAE/D,IAAI,QAAgB,CAAC;IACrB,IAAI,SAAS,EAAE,CAAC;QACd,QAAQ,GAAG,CAAC,CAAC;IACf,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,QAAQ,GAAG,CAAC,CAAC;IACf,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,CAAC,CAAC;IACf,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,19 @@
+export type DiagnosticCategory = 'install' | 'config' | 'runtime' | 'agent';
+export type DiagnosticSeverity = 'ok' | 'warn' | 'error' | 'info';
+export interface DiagnosticResult {
+    category: DiagnosticCategory;
+    severity: DiagnosticSeverity;
+    id: string;
+    message: string;
+    remediation: string;
+    nextCommand?: string;
+}
+export interface DoctorOptions {
+    json?: boolean;
+    cwd?: string;
+}
+export interface DoctorReport {
+    results: DiagnosticResult[];
+    exitCode: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/doctor/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/cli/doctor/types.js

@@ -0,0 +1,4 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Shared diagnostic types for codemap doctor — single source of truth for checker output shape
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/doctor/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,qGAAqG"}

package/dist/cli/first-run-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"first-run-guide.d.ts","sourceRoot":"","sources":["../../src/cli/first-run-guide.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAY/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,IAAI,CAYlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CA2BxC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CASrE"}
+{"version":3,"file":"first-run-guide.d.ts","sourceRoot":"","sources":["../../src/cli/first-run-guide.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAa/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,IAAI,CAYlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAwBxC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CASrE"}

package/dist/cli/first-run-guide.js

@@ -14,11 +14,12 @@ const FIRST_RUN_MARKER = '.mycodemap/.first-run-done';
  * - 不存在旧输出目录（用于迁移检测）
  */
 export function isFirstRun(cwd = process.cwd()) {
-    const configNew = path.join(cwd, 'mycodemap.config.json');
-    const configOld = path.join(cwd, 'codemap.config.json');
+    const canonicalConfig = path.join(cwd, '.mycodemap', 'config.json');
+    const rootConfig = path.join(cwd, 'mycodemap.config.json');
+    const legacyConfig = path.join(cwd, 'codemap.config.json');
     const markerPath = path.join(cwd, FIRST_RUN_MARKER);
     const oldOutputDir = path.join(cwd, '.codemap');
-    const hasConfig = fs.existsSync(configNew) || fs.existsSync(configOld);
+    const hasConfig = fs.existsSync(canonicalConfig) || fs.existsSync(rootConfig) || fs.existsSync(legacyConfig);
     const hasMarker = fs.existsSync(markerPath);
     const hasOldOutput = fs.existsSync(oldOutputDir);
     // 如果有旧配置或旧输出目录，不是首次运行（需要迁移）
@@ -45,15 +46,14 @@ export function markFirstRunDone(cwd = process.cwd()) {
  */
 export function showFirstRunGuide() {
     console.log('');
-    console.log(chalk.cyan('━'.repeat(60)));
-    console.log(chalk.white.bold('  欢迎使用 CodeMap - TypeScript 代码地图工具'));
-    console.log(chalk.cyan('━'.repeat(60)));
+    console.log(chalk.cyan('━'.repeat(48)));
+    console.log(chalk.white.bold('  欢迎使用 CodeMap'));
+    console.log(chalk.cyan('━'.repeat(48)));
     console.log('');
-    console.log(chalk.white('  快速开始：'));
+    console.log(chalk.white('  首次使用建议顺序：'));
     console.log('');
-    console.log(chalk.gray('  1. ') + chalk.white('初始化配置'));
+    console.log(chalk.gray('  1. ') + chalk.white('初始化项目'));
     console.log(chalk.gray('     ') + chalk.cyan('mycodemap init'));
-    console.log(chalk.gray('        或 ') + chalk.cyan('codemap init'));
     console.log('');
     console.log(chalk.gray('  2. ') + chalk.white('生成代码地图'));
     console.log(chalk.gray('     ') + chalk.cyan('mycodemap generate'));
@@ -61,9 +61,7 @@ export function showFirstRunGuide() {
     console.log(chalk.gray('  3. ') + chalk.white('查看帮助'));
     console.log(chalk.gray('     ') + chalk.cyan('mycodemap --help'));
     console.log('');
-    console.log(chalk.cyan('━'.repeat(60)));
-    console.log(chalk.gray('  更多功能：query | deps | cycles | complexity | impact'));
-    console.log(chalk.cyan('━'.repeat(60)));
+    console.log(chalk.cyan('━'.repeat(48)));
     console.log('');
 }
 /**

package/dist/cli/first-run-guide.js.map

@@ -1 +1 @@
-{"version":3,"file":"first-run-guide.js","sourceRoot":"","sources":["../../src/cli/first-run-guide.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"first-run-guide.js","sourceRoot":"","sources":["../../src/cli/first-run-guide.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,iCAAiC;AAEjC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AACH,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACpD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAEhD,MAAM,SAAS,GAAG,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC7G,MAAM,SAAS,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAEjD,4BAA4B;IAC5B,OAAO,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,YAAY,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAEpD,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,aAAa;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC1D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEtB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/index.js

@@ -15,7 +15,11 @@ import { workflowCommand } from './commands/workflow.js';
 import { exportCommand } from './commands/export.js';
 import { checkCommand } from './commands/check.js';
 import { historyCommand } from './commands/history.js';
+import { publishStatusCommand } from './commands/publish-status.js';
+import { readinessGateCommand } from './commands/readiness-gate.js';
 import { mcpCommand, isMcpStartInvocation } from './commands/mcp.js';
+import { doctorCommand } from './commands/doctor.js';
+import { benchmarkCommand } from './commands/benchmark.js';
 import { shipCommand } from './commands/ship/index.js';
 import { ANALYZE_COMMAND_DESCRIPTION, configureAnalyzeCommand } from './commands/analyze-options.js';
 import { setupRuntimeLogging } from './runtime-logger.js';
@@ -23,9 +27,21 @@ import { runFirstRunGuide } from './first-run-guide.js';
 import { printMigrationWarning } from './paths.js';
 import { validatePlatform } from './platform-check.js';
 import { formatRemovedCommandMessage, getRemovedTopLevelCommand } from './removed-commands.js';
-import { commandRequiresTreeSitter, validateTreeSitter } from './tree-sitter-check.js';
+import { commandRequiresTreeSitter, validateTreeSitterAsync } from './tree-sitter-check.js';
+import { getFullContract } from './interface-contract/index.js';
+import { tryApplySuggestion } from './output/apply-suggestion.js';
+import { resolveOutputMode, formatError } from './output/index.js';
 const program = new Command();
 const cliArgs = process.argv.slice(2);
+// --schema must bypass all startup side effects to keep stdout machine-parseable
+// Only intercept at root level (no subcommand present) so valid subcommand args
+// that happen to be exactly --schema are not hijacked.
+const firstArg = cliArgs[0];
+const isRootLevel = !firstArg || firstArg.startsWith('-');
+if (isRootLevel && cliArgs.includes('--schema')) {
+    console.log(JSON.stringify(getFullContract(), null, 2));
+    process.exit(0);
+}
 const shouldBypassHumanStartupSideEffects = isMcpStartInvocation(cliArgs);
 const removedCommand = getRemovedTopLevelCommand(cliArgs);
 if (removedCommand) {
@@ -50,31 +66,46 @@ catch (error) {
     process.exit(1);
 }
 /**
- * 包装命令 action，按需检测 tree-sitter
+ * 统一命令 action 包装器：tree-sitter 检查 + 集中式错误处理 + suggestion 自动修复
  */
-function wrapWithTreeSitterCheck(commandName, action) {
-    return async (options) => {
-        if (commandRequiresTreeSitter(commandName)) {
-            try {
-                validateTreeSitter();
+async function createActionHandler(commandName, action) {
+    return async (...args) => {
+        try {
+            if (commandRequiresTreeSitter(commandName)) {
+                await validateTreeSitterAsync();
             }
-            catch (error) {
-                console.error(error instanceof Error ? error.message : String(error));
-                process.exit(1);
+            await action(...args);
+        }
+        catch (error) {
+            const mode = resolveOutputMode({});
+            const formatted = formatError(error, mode, commandName);
+            process.stdout.write(formatted + '\n');
+            // 尝试自动修复（如果 --apply-suggestion 已设置且错误是 ActionableError）
+            const cliOpts = program.opts();
+            if (cliOpts.applySuggestion && error && typeof error === 'object' && 'nextCommand' in error) {
+                const suggestionResult = await tryApplySuggestion(error, { applySuggestion: cliOpts.applySuggestion, wasmFallback: cliOpts.wasmFallback }, mode);
+                if (suggestionResult.success) {
+                    process.exitCode = 0;
+                    return;
+                }
             }
+            process.exitCode = 1;
         }
-        return action(options);
     };
 }
 program
     .name('mycodemap')
     .alias('codemap') // 兼容旧命令名
     .description('TypeScript 代码地图工具 - 为 AI 辅助开发提供结构化上下文')
-    .version('0.1.0');
+    .version('0.1.0')
+    .option('--apply-suggestion', 'Allow automatic execution of high-confidence remediation suggestions (confidence >= 0.8)')
+    .option('--wasm-fallback', 'Automatically use WASM fallback when native dependencies fail to compile')
+    .option('--native', 'Force native binary usage for tree-sitter and better-sqlite3 (disables WASM fallback)');
 program
     .command('init')
-    .description('初始化 CodeMap 配置')
+    .description('初始化并收敛 CodeMap 项目状态')
     .option('-y, --yes', '使用默认配置')
+    .option('--interactive', '仅显示 reconciliation preview，不写入文件')
     .action(initCommand);
 program
     .command('generate')
@@ -83,7 +114,7 @@ program
     .option('-o, --output <dir>', '输出目录', '.mycodemap')
     .option('--symbol-level', '额外 materialize symbol-level 调用依赖到代码图存储', false)
     .option('--ai-context', '为每个文件生成 AI 描述（需要 AI Provider）', false)
-    .action(async (options, command) => {
+    .action(await createActionHandler('generate', async (options, command) => {
     await generateCommand({
         ...options,
         __optionSources: {
@@ -91,7 +122,7 @@ program
             output: command.getOptionValueSource('output'),
         },
     });
-});
+}));
 program.addCommand(designCommand);
 program
     .command('query')
@@ -102,6 +133,7 @@ program
     .option('-S, --search <word>', '模糊搜索')
     .option('-l, --limit <number>', '限制结果数量', '50')
     .option('-j, --json', 'JSON 格式输出')
+    .option('--human', '强制人类可读输出')
     .option('--structured', '输出完全结构化的 JSON（不包含自然语言字符串，需要配合 --json 使用）')
     .option('-v, --verbose', '显示性能指标')
     .option('-r, --regex', '使用正则表达式搜索（仅适用于 -S/--search）')
@@ -116,15 +148,16 @@ program
     .description('分析项目模块依赖关系')
     .option('-m, --module <path>', '查看指定模块的依赖')
     .option('-j, --json', 'JSON 格式输出')
+    .option('--human', '强制人类可读输出')
     .option('--structured', '输出完全结构化的 JSON（不包含自然语言字符串，需要配合 --json 使用）')
-    .action(depsCommand);
+    .action(await createActionHandler('deps', depsCommand));
 program
     .command('cycles')
     .description('检测项目中的循环依赖')
     .option('-d, --depth <number>', '检测深度', '5')
     .option('-j, --json', 'JSON 格式输出')
     .option('--structured', '输出完全结构化的 JSON（不包含自然语言字符串，需要配合 --json 使用）')
-    .action(cyclesCommand);
+    .action(await createActionHandler('cycles', cyclesCommand));
 program
     .command('complexity')
     .description('分析代码复杂度（圈复杂度、认知复杂度、可维护性）')
@@ -132,7 +165,7 @@ program
     .option('-d, --detail', '显示函数级复杂度详情（使用 AST 精确分析）')
     .option('-j, --json', 'JSON 格式输出')
     .option('--structured', '输出完全结构化的 JSON（不包含自然语言字符串，需要配合 --json 使用）')
-    .action(complexityCommand);
+    .action(await createActionHandler('complexity', complexityCommand));
 program
     .command('impact')
     .description('分析文件变更的影响范围')
@@ -140,22 +173,37 @@ program
     .option('-t, --transitive', '包含传递依赖')
     .option('-j, --json', 'JSON 格式输出')
     .option('--structured', '输出完全结构化的 JSON（不包含自然语言字符串，需要配合 --json 使用）')
-    .action(impactCommand);
+    .action(await createActionHandler('impact', impactCommand));
 configureAnalyzeCommand(program
     .command('analyze')
-    .description(ANALYZE_COMMAND_DESCRIPTION)).action(async () => {
+    .description(ANALYZE_COMMAND_DESCRIPTION)).action(await createActionHandler('analyze', async () => {
     const { analyzeCommand } = await import('./commands/analyze.js');
     // 跳过 program name 和 command name
     await analyzeCommand(process.argv.slice(2));
-});
+}));
 // CI Gateway 命令
 program.addCommand(ciCommand);
 // Contract gate 命令
 program.addCommand(checkCommand);
 // History risk 命令
 program.addCommand(historyCommand);
+// Publish workflow follow-up 命令
+program.addCommand(publishStatusCommand);
+// Readiness gate 命令
+program.addCommand(readinessGateCommand);
 // Experimental MCP 命令
 program.addCommand(mcpCommand);
+// Doctor command
+program.addCommand(doctorCommand);
+// Benchmark command
+program
+    .command('benchmark')
+    .description('Compare WASM vs Native performance')
+    .option('-t, --target <path>', 'Target repository', '.')
+    .option('-m, --mode <mode>', 'Benchmark mode: native, wasm, both', 'both')
+    .option('-i, --iterations <n>', 'Number of iterations', '3')
+    .option('-j, --json', 'JSON output')
+    .action(benchmarkCommand);
 // Workflow 命令
 program.addCommand(workflowCommand);
 // Export 命令
@@ -173,5 +221,16 @@ program
     .option('--verbose', '显示详细输出')
     .option('--yes, -y', '置信度 60-75 时自动确认（不询问）')
     .action(shipCommand);
+// Handle --native flag: disable WASM fallback before any command runs
+const cliOpts = program.opts();
+if (cliOpts.native) {
+    process.env.CODEMAP_USE_WASM_TREE_SITTER = '0';
+    process.env.CODEMAP_USE_WASM_BETTER_SQLITE3 = '0';
+}
+// Handle --wasm-fallback flag: activate WASM fallback before any command runs
+if (cliOpts.wasmFallback) {
+    process.env.CODEMAP_USE_WASM_TREE_SITTER = '1';
+    process.env.CODEMAP_USE_WASM_BETTER_SQLITE3 = '1';
+}
 program.parse();
 //# sourceMappingURL=index.js.map