@mycodemap/mycodemap 0.5.2-beta.1 → 2.0.0

package/dist/cli/init/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/cli/init/rules.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,oEAAoE;AAEpE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAYxG,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,cAAc,CACrB,GAAW,EACX,KAAa,EACb,MAA2B,EAC3B,SAAiC,EACjC,MAAc,EACd,OAAiB,EACjB,UAMI,EAAE;IAEN,OAAO;QACL,GAAG;QACH,KAAK;QACL,MAAM;QACN,SAAS;QACT,MAAM;QACN,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO;QACP,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,WAAmB,EAAE,YAAoB;IAC5D,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChF,OAAO,OAAO,cAAc,UAAU,eAAe,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,QAAgB,EAAE,QAAgB;IACvE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CAAC,OAAe,EAAE,MAAyB;IAC5D,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,uBAAuB,EAAE,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC/E,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QAE7C,IAAI,WAAW,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,cAAc,CACxB,SAAS,QAAQ,CAAC,QAAQ,EAAE,EAC5B,UAAU,QAAQ,CAAC,QAAQ,EAAE,EAC7B,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,CAAC,gBAAgB,CAAC,EAClB;gBACE,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAChC,WAAW,EAAE,qBAAqB,EAAE;aACrC,CACF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,cAAc,CACxB,SAAS,QAAQ,CAAC,QAAQ,EAAE,EAC5B,UAAU,QAAQ,CAAC,QAAQ,EAAE,EAC7B,UAAU,EACV,YAAY,EACZ,uBAAuB,EACvB;gBACE,0CAA0C;gBAC1C,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC;aAC3C,EACD;gBACE,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAChC,WAAW,EAAE,qBAAqB,EAAE;gBACpC,YAAY,EAAE,2BAA2B,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,8BAA8B;aAC9G,CACF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,UAAU;YACV,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,cAAc,CACxB,SAAS,QAAQ,CAAC,QAAQ,EAAE,EAC5B,UAAU,QAAQ,CAAC,QAAQ,EAAE,EAC7B,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,CAAC,yCAAyC,CAAC,EAC3C;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAChC,WAAW,EAAE,qBAAqB,EAAE;YACpC,YAAY,EAAE,+BAA+B,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,IAAI;SACxF,CACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,IAAI,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IAE5G,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,cAAc,CACnB,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,EAChB,YAAY,EACZ,4BAA4B,EAC5B,CAAC,8DAA8D,CAAC,EAChE;YACE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;SAC1E,CACF,CAAC;IACJ,CAAC;IAED,OAAO,cAAc,CACnB,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,EACpB;QACE,oDAAoD;QACpD,sBAAsB;QACtB,OAAO;KACR,EACD;QACE,YAAY,EAAE,qEAAqE;KACpF,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,OAAO;QACL,MAAM,EAAE;YACN,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;YAC9B,cAAc,CAAC,OAAO,CAAC;SACxB;QACD,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAe;IAClD,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,MAAM,SAAS,CAAC,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}

package/dist/cli/interface-contract/commands/analyze.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContract } from '../types.js';
+export declare const analyzeContract: CommandContract;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/cli/interface-contract/commands/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/analyze.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,eAAe,EAAE,eAsI7B,CAAC"}

package/dist/cli/interface-contract/commands/analyze.js

@@ -0,0 +1,138 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Interface contract for the `analyze` command family
+export const analyzeContract = {
+    name: 'analyze',
+    description: '统一分析入口 - 支持多种分析意图',
+    args: [],
+    flags: [
+        {
+            name: 'intent',
+            short: 'i',
+            long: 'intent',
+            description: '分析类型 (find|read|link|show)',
+            type: 'string',
+        },
+        {
+            name: 'targets',
+            short: 't',
+            long: 'targets',
+            description: '目标文件/模块路径（多个）',
+            type: 'string',
+            multiple: true,
+        },
+        {
+            name: 'keywords',
+            short: 'k',
+            long: 'keywords',
+            description: '搜索关键词（多个）',
+            type: 'string',
+            multiple: true,
+        },
+        {
+            name: 'scope',
+            short: 's',
+            long: 'scope',
+            description: '范围 (direct|transitive)',
+            type: 'string',
+        },
+        {
+            name: 'topK',
+            short: 'n',
+            long: 'topK',
+            description: '返回结果数量（默认 8，最大 100）',
+            type: 'number',
+            defaultValue: 8,
+        },
+        {
+            name: 'include-tests',
+            long: 'include-tests',
+            description: '包含测试文件',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'include-git-history',
+            long: 'include-git-history',
+            description: '包含 Git 历史',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'json',
+            long: 'json',
+            description: 'JSON 格式输出',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'human',
+            long: 'human',
+            description: '强制人类可读输出（即使是非 TTY 环境）',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'structured',
+            long: 'structured',
+            description: '输出完全结构化的 JSON（不包含自然语言字符串，需要配合 --json 使用）',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'output-mode',
+            long: 'output-mode',
+            description: '输出模式 (machine|human)',
+            type: 'string',
+            defaultValue: 'human',
+        },
+    ],
+    outputShape: {
+        description: '分析结果',
+        type: 'object',
+        properties: [
+            {
+                name: 'intent',
+                type: 'string',
+                description: '执行的分析意图',
+            },
+            {
+                name: 'results',
+                type: 'array',
+                description: '分析结果列表',
+                items: {
+                    name: 'resultItem',
+                    type: 'object',
+                    properties: [
+                        { name: 'type', type: 'string' },
+                        { name: 'name', type: 'string' },
+                        { name: 'path', type: 'string', nullable: true },
+                        { name: 'details', type: 'string', nullable: true },
+                    ],
+                },
+            },
+            {
+                name: 'metrics',
+                type: 'object',
+                description: '性能指标',
+                nullable: true,
+                properties: [
+                    { name: 'durationMs', type: 'number' },
+                    { name: 'filesAnalyzed', type: 'number' },
+                ],
+            },
+        ],
+    },
+    errorCodes: [
+        { code: 'INVALID_INTENT', description: '未知的分析意图类型' },
+        { code: 'MISSING_TARGET', description: 'read/link/show 意图缺少目标路径' },
+        { code: 'INDEX_NOT_FOUND', description: '代码地图索引不存在，需先运行 generate' },
+        { code: 'TREE_SITTER_MISSING', description: 'AST 分析需要 tree-sitter 但未安装' },
+    ],
+    examples: [
+        'codemap analyze -i find -k "SourceLocation" --json --structured',
+        'codemap analyze -i read -t src/index.ts --scope transitive --json',
+        'codemap analyze -i link -t src/utils --json',
+        'codemap analyze -i show -t src/ --output-mode human',
+    ],
+};
+//# sourceMappingURL=analyze.js.map

package/dist/cli/interface-contract/commands/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/analyze.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,4DAA4D;AAI5D,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,mBAAmB;IAChC,IAAI,EAAE,EAAE;IACR,KAAK,EAAE;QACL;YACE,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4BAA4B;YACzC,IAAI,EAAE,QAAQ;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,eAAe;YAC5B,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,WAAW;YACxB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,wBAAwB;YACrC,IAAI,EAAE,QAAQ;SACf;QACD;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,qBAAqB;YAClC,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,QAAQ;YACrB,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,WAAW;YACxB,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,WAAW;YACxB,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,uBAAuB;YACpC,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,0CAA0C;YACvD,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,sBAAsB;YACnC,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,OAAO;SACtB;KACF;IACD,WAAW,EAAE;QACX,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,SAAS;aACvB;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,QAAQ;gBACrB,KAAK,EAAE;oBACL,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAChC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAChC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;wBAChD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;qBACpD;iBACF;aACF;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACtC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1C;aACF;SACF;KACF;IACD,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE;QACpD,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,yBAAyB,EAAE;QAClE,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACnE,EAAE,IAAI,EAAE,qBAAqB,EAAE,WAAW,EAAE,2BAA2B,EAAE;KAC1E;IACD,QAAQ,EAAE;QACR,iEAAiE;QACjE,mEAAmE;QACnE,6CAA6C;QAC7C,qDAAqD;KACtD;CACF,CAAC"}

package/dist/cli/interface-contract/commands/benchmark.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContract } from '../types.js';
+export declare const benchmarkContract: CommandContract;
+//# sourceMappingURL=benchmark.d.ts.map

package/dist/cli/interface-contract/commands/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/benchmark.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,iBAAiB,EAAE,eAuG/B,CAAC"}

package/dist/cli/interface-contract/commands/benchmark.js

@@ -0,0 +1,107 @@
+// [META] since:2026-05-01 | owner:cli-team | stable:false
+// [WHY] Interface contract for the `benchmark` command family
+export const benchmarkContract = {
+    name: 'benchmark',
+    description: '比较 WASM 与 Native 性能',
+    args: [],
+    flags: [
+        {
+            name: 'target',
+            short: 't',
+            long: 'target',
+            description: '目标代码库路径',
+            type: 'string',
+            defaultValue: '.',
+        },
+        {
+            name: 'mode',
+            short: 'm',
+            long: 'mode',
+            description: '基准测试模式: native | wasm | both',
+            type: 'string',
+            defaultValue: 'both',
+        },
+        {
+            name: 'iterations',
+            short: 'i',
+            long: 'iterations',
+            description: '迭代次数',
+            type: 'number',
+            defaultValue: 3,
+        },
+        {
+            name: 'json',
+            short: 'j',
+            long: 'json',
+            description: 'JSON 格式输出',
+            type: 'boolean',
+            defaultValue: false,
+        },
+    ],
+    outputShape: {
+        description: '基准测试结果',
+        type: 'object',
+        properties: [
+            {
+                name: 'target',
+                type: 'string',
+                description: '目标代码库路径',
+            },
+            {
+                name: 'fileCount',
+                type: 'number',
+            },
+            {
+                name: 'native',
+                type: 'object',
+                nullable: true,
+                properties: [
+                    { name: 'coldStartupMs', type: 'number' },
+                    { name: 'parseInitMs', type: 'number' },
+                    { name: 'storageInitMs', type: 'number' },
+                    { name: 'firstFileParseMs', type: 'number' },
+                    { name: 'totalFiles', type: 'number' },
+                    { name: 'filesPerSecond', type: 'number' },
+                ],
+            },
+            {
+                name: 'wasm',
+                type: 'object',
+                nullable: true,
+                properties: [
+                    { name: 'coldStartupMs', type: 'number' },
+                    { name: 'parseInitMs', type: 'number' },
+                    { name: 'storageInitMs', type: 'number' },
+                    { name: 'firstFileParseMs', type: 'number' },
+                    { name: 'totalFiles', type: 'number' },
+                    { name: 'filesPerSecond', type: 'number' },
+                ],
+            },
+            {
+                name: 'penaltyMs',
+                type: 'number',
+                description: 'WASM 启动惩罚（毫秒）',
+            },
+            {
+                name: 'thresholdMs',
+                type: 'number',
+                description: '阈值（毫秒）',
+            },
+            {
+                name: 'passesThreshold',
+                type: 'boolean',
+                description: '是否通过阈值',
+            },
+        ],
+    },
+    errorCodes: [
+        { code: 'BENCHMARK_TARGET_INVALID', description: '目标路径不存在或不可读' },
+        { code: 'BENCHMARK_NO_FILES', description: '目标目录中未找到可分析的文件' },
+    ],
+    examples: [
+        'codemap benchmark',
+        'codemap benchmark -t ./src -m both -i 5',
+        'codemap benchmark --json',
+    ],
+};
+//# sourceMappingURL=benchmark.js.map

package/dist/cli/interface-contract/commands/benchmark.js.map

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

package/dist/cli/interface-contract/commands/deps.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContract } from '../types.js';
+export declare const depsContract: CommandContract;
+//# sourceMappingURL=deps.d.ts.map

package/dist/cli/interface-contract/commands/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/deps.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,YAAY,EAAE,eA6H1B,CAAC"}

package/dist/cli/interface-contract/commands/deps.js

@@ -0,0 +1,129 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Interface contract for the `deps` command family
+export const depsContract = {
+    name: 'deps',
+    description: '分析项目模块依赖关系',
+    args: [],
+    flags: [
+        {
+            name: 'module',
+            short: 'm',
+            long: 'module',
+            description: '查看指定模块的依赖',
+            type: 'string',
+        },
+        {
+            name: 'json',
+            short: 'j',
+            long: 'json',
+            description: 'JSON 格式输出',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'structured',
+            long: 'structured',
+            description: '输出完全结构化的 JSON（不包含自然语言字符串，需要配合 --json 使用）',
+            type: 'boolean',
+            defaultValue: false,
+        },
+    ],
+    outputShape: {
+        description: '依赖分析结果',
+        type: 'object',
+        properties: [
+            // Mode A: specific module detail (when -m is used)
+            {
+                name: 'module',
+                type: 'object',
+                nullable: true,
+                description: '指定模块的依赖详情（当使用 -m 参数时）',
+                properties: [
+                    { name: 'path', type: 'string' },
+                    { name: 'relativePath', type: 'string' },
+                    {
+                        name: 'location',
+                        type: 'object',
+                        properties: [
+                            { name: 'file', type: 'string' },
+                            { name: 'line', type: 'number' },
+                            { name: 'column', type: 'number' },
+                        ],
+                    },
+                    {
+                        name: 'dependencies',
+                        type: 'array',
+                        items: {
+                            name: 'dependencyPath',
+                            type: 'string',
+                        },
+                    },
+                    {
+                        name: 'dependents',
+                        type: 'array',
+                        items: {
+                            name: 'dependentPath',
+                            type: 'string',
+                        },
+                    },
+                    {
+                        name: 'dependentsMap',
+                        type: 'array',
+                        nullable: true,
+                        items: {
+                            name: 'dependentEntry',
+                            type: 'object',
+                            properties: [
+                                { name: 'id', type: 'string' },
+                                { name: 'path', type: 'string' },
+                            ],
+                        },
+                    },
+                ],
+            },
+            // Mode B: all-modules summary (when -m is omitted)
+            {
+                name: 'allDependencies',
+                type: 'object',
+                nullable: true,
+                description: '全局依赖汇总（当未使用 -m 参数时）',
+            },
+            {
+                name: 'modules',
+                type: 'array',
+                nullable: true,
+                description: '模块列表（当未使用 -m 参数时）',
+                items: {
+                    name: 'moduleSummary',
+                    type: 'object',
+                    properties: [
+                        { name: 'path', type: 'string' },
+                        { name: 'relativePath', type: 'string' },
+                        {
+                            name: 'location',
+                            type: 'object',
+                            properties: [
+                                { name: 'file', type: 'string' },
+                                { name: 'line', type: 'number' },
+                                { name: 'column', type: 'number' },
+                            ],
+                        },
+                        { name: 'type', type: 'string' },
+                        { name: 'count', type: 'number' },
+                    ],
+                },
+            },
+        ],
+    },
+    errorCodes: [
+        { code: 'INDEX_NOT_FOUND', description: '代码地图索引不存在，需先运行 generate' },
+        { code: 'MODULE_NOT_FOUND', description: '指定的模块路径未找到' },
+        { code: 'PARSE_ERROR', description: '代码地图 JSON 解析失败' },
+    ],
+    examples: [
+        'codemap deps -m src/index.ts --json',
+        'codemap deps --json --structured',
+        'codemap deps -m src/utils/helpers.ts',
+    ],
+};
+//# sourceMappingURL=deps.js.map

package/dist/cli/interface-contract/commands/deps.js.map

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

package/dist/cli/interface-contract/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContract } from '../types.js';
+export declare const doctorContract: CommandContract;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/interface-contract/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,cAAc,EAAE,eAuD5B,CAAC"}

package/dist/cli/interface-contract/commands/doctor.js

@@ -0,0 +1,59 @@
+// [META] since:2026-05-01 | owner:cli-team | stable:false
+// [WHY] Interface contract for the `doctor` command family
+export const doctorContract = {
+    name: 'doctor',
+    description: '诊断 CodeMap 生态系统健康状况',
+    args: [],
+    flags: [
+        {
+            name: 'json',
+            short: 'j',
+            long: 'json',
+            description: 'JSON 格式输出诊断结果',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'human',
+            long: 'human',
+            description: '强制人类可读输出',
+            type: 'boolean',
+            defaultValue: false,
+        },
+    ],
+    outputShape: {
+        description: '诊断报告',
+        type: 'object',
+        properties: [
+            {
+                name: 'exitCode',
+                type: 'number',
+                description: '退出码（0 = 健康，1 = 有问题）',
+            },
+            {
+                name: 'results',
+                type: 'array',
+                description: '诊断结果列表',
+                items: {
+                    name: 'diagnostic',
+                    type: 'object',
+                    properties: [
+                        { name: 'category', type: 'string', description: '诊断类别: install | config | runtime | agent' },
+                        { name: 'severity', type: 'string', description: '严重级别: info | warning | error' },
+                        { name: 'message', type: 'string' },
+                        { name: 'check', type: 'string', description: '检查项名称' },
+                    ],
+                },
+            },
+        ],
+    },
+    errorCodes: [
+        { code: 'DOCTOR_RUNTIME_ERROR', description: '诊断运行时出错' },
+    ],
+    examples: [
+        'codemap doctor',
+        'codemap doctor --json',
+        'codemap doctor --human',
+    ],
+};
+//# sourceMappingURL=doctor.js.map

package/dist/cli/interface-contract/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/doctor.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,2DAA2D;AAI3D,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,qBAAqB;IAClC,IAAI,EAAE,EAAE;IACR,KAAK,EAAE;QACL;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,eAAe;YAC5B,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;KACF;IACD,WAAW,EAAE;QACX,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV;gBACE,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,QAAQ;gBACrB,KAAK,EAAE;oBACL,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;wBAC7F,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;wBACjF,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACnC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE;qBACxD;iBACF;aACF;SACF;KACF;IACD,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,sBAAsB,EAAE,WAAW,EAAE,SAAS,EAAE;KACzD;IACD,QAAQ,EAAE;QACR,gBAAgB;QAChB,uBAAuB;QACvB,wBAAwB;KACzB;CACF,CAAC"}

package/dist/cli/interface-contract/commands/index.d.ts

@@ -0,0 +1,9 @@
+import { analyzeContract } from './analyze.js';
+import { queryContract } from './query.js';
+import { depsContract } from './deps.js';
+import { doctorContract } from './doctor.js';
+import { benchmarkContract } from './benchmark.js';
+import { initContract } from './init.js';
+export declare const commandContracts: readonly [import("../types.js").CommandContract, import("../types.js").CommandContract, import("../types.js").CommandContract, import("../types.js").CommandContract, import("../types.js").CommandContract, import("../types.js").CommandContract];
+export { analyzeContract, queryContract, depsContract, doctorContract, benchmarkContract, initContract };
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/interface-contract/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,eAAO,MAAM,gBAAgB,qPAOnB,CAAC;AAEX,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC"}

package/dist/cli/interface-contract/commands/index.js

@@ -0,0 +1,18 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Registry of all command contracts — central catalog for schema generation and validation
+import { analyzeContract } from './analyze.js';
+import { queryContract } from './query.js';
+import { depsContract } from './deps.js';
+import { doctorContract } from './doctor.js';
+import { benchmarkContract } from './benchmark.js';
+import { initContract } from './init.js';
+export const commandContracts = [
+    analyzeContract,
+    queryContract,
+    depsContract,
+    doctorContract,
+    benchmarkContract,
+    initContract,
+];
+export { analyzeContract, queryContract, depsContract, doctorContract, benchmarkContract, initContract };
+//# sourceMappingURL=index.js.map

package/dist/cli/interface-contract/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,iGAAiG;AAEjG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe;IACf,aAAa;IACb,YAAY;IACZ,cAAc;IACd,iBAAiB;IACjB,YAAY;CACJ,CAAC;AAEX,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC"}

package/dist/cli/interface-contract/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContract } from '../types.js';
+export declare const initContract: CommandContract;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/interface-contract/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/init.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,YAAY,EAAE,eAmF1B,CAAC"}

package/dist/cli/interface-contract/commands/init.js

@@ -0,0 +1,87 @@
+// [META] since:2026-05-01 | owner:cli-team | stable:false
+// [WHY] Interface contract for the `init` command family
+export const initContract = {
+    name: 'init',
+    description: '初始化并收敛 CodeMap 项目状态',
+    args: [],
+    flags: [
+        {
+            name: 'yes',
+            short: 'y',
+            long: 'yes',
+            description: '使用默认配置，不询问',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'interactive',
+            long: 'interactive',
+            description: '仅显示 reconciliation preview，不写入文件',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'json',
+            short: 'j',
+            long: 'json',
+            description: 'JSON 格式输出收据',
+            type: 'boolean',
+            defaultValue: false,
+        },
+    ],
+    outputShape: {
+        description: '初始化结果收据',
+        type: 'object',
+        properties: [
+            {
+                name: 'converged',
+                type: 'boolean',
+                description: '是否已收敛',
+            },
+            {
+                name: 'configPath',
+                type: 'string',
+                nullable: true,
+                description: '配置文件路径',
+            },
+            {
+                name: 'created',
+                type: 'array',
+                description: '创建的文件列表',
+                items: {
+                    name: 'file',
+                    type: 'object',
+                    properties: [
+                        { name: 'path', type: 'string' },
+                        { name: 'type', type: 'string', description: 'config | hook | rule | receipt' },
+                    ],
+                },
+            },
+            {
+                name: 'warnings',
+                type: 'array',
+                nullable: true,
+                description: '警告信息',
+                items: {
+                    name: 'warning',
+                    type: 'object',
+                    properties: [
+                        { name: 'message', type: 'string' },
+                        { name: 'severity', type: 'string' },
+                    ],
+                },
+            },
+        ],
+    },
+    errorCodes: [
+        { code: 'INIT_ALREADY_INITIALIZED', description: '项目已初始化，使用 --yes 强制覆盖' },
+        { code: 'INIT_CWD_NOT_FOUND', description: '当前目录不存在' },
+    ],
+    examples: [
+        'codemap init',
+        'codemap init -y',
+        'codemap init --interactive',
+        'codemap init --json',
+    ],
+};
+//# sourceMappingURL=init.js.map

package/dist/cli/interface-contract/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/init.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,yDAAyD;AAIzD,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,qBAAqB;IAClC,IAAI,EAAE,EAAE;IACR,KAAK,EAAE;QACL;YACE,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,YAAY;YACzB,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,kCAAkC;YAC/C,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,aAAa;YAC1B,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;KACF;IACD,WAAW,EAAE;QACX,WAAW,EAAE,SAAS;QACtB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,OAAO;aACrB;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,QAAQ;aACtB;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,SAAS;gBACtB,KAAK,EAAE;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAChC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;qBAChF;iBACF;aACF;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,MAAM;gBACnB,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACnC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;qBACrC;iBACF;aACF;SACF;KACF;IACD,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,0BAA0B,EAAE,WAAW,EAAE,sBAAsB,EAAE;QACzE,EAAE,IAAI,EAAE,oBAAoB,EAAE,WAAW,EAAE,SAAS,EAAE;KACvD;IACD,QAAQ,EAAE;QACR,cAAc;QACd,iBAAiB;QACjB,4BAA4B;QAC5B,qBAAqB;KACtB;CACF,CAAC"}

package/dist/cli/interface-contract/commands/query.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContract } from '../types.js';
+export declare const queryContract: CommandContract;
+//# sourceMappingURL=query.d.ts.map