@mycodemap/mycodemap 1.9.0 → 2.7.0

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

@@ -0,0 +1,130 @@
+// [META] since:2026-04-30 | owner:cli-team | stable:false
+// [WHY] Interface contract for the `deps` command family
+export const depsContract = {
+    name: 'deps',
+    description: '分析项目模块依赖关系',
+    stable: true,
+    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,eAwD5B,CAAC"}

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

@@ -0,0 +1,60 @@
+// [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 生态系统健康状况',
+    stable: true,
+    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,MAAM,EAAE,IAAI;IACZ,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/env-contract.d.ts

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

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

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

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

@@ -0,0 +1,168 @@
+// [META] since:2026-05-02 | owner:cli-team | stable:false
+// [WHY] Interface contract for the `env-contract` command — subagent rule retrieval surface.
+export const envContractContract = {
+    name: 'env-contract',
+    aliases: ['env_contract'],
+    description: 'Query the Project Environment Contract for subagent rule retrieval',
+    stable: true,
+    args: [],
+    flags: [
+        {
+            name: 'json',
+            short: 'j',
+            long: 'json',
+            description: 'Output contract as JSON',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'human',
+            long: 'human',
+            description: 'Force human-readable output',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'for',
+            long: 'for',
+            description: 'Agent type filter: explore|plan|edit|worker|review|verify|default',
+            type: 'string',
+            defaultValue: undefined,
+        },
+        {
+            name: 'category',
+            long: 'category',
+            description: 'Contract category filter: execution|commit|retrieval|validation|style',
+            type: 'string',
+            defaultValue: undefined,
+        },
+        {
+            name: 'check',
+            long: 'check',
+            description: 'Check contract freshness and critical coverage',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'update',
+            long: 'update',
+            description: 'Regenerate .mycodemap/env-contract.json',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'asHookConfig',
+            long: 'as-hook-config',
+            description: 'Print Claude Code SubagentStart hook example',
+            type: 'boolean',
+            defaultValue: false,
+        },
+        {
+            name: 'asCodexAgent',
+            long: 'as-codex-agent',
+            description: 'Print Codex agent developer_instructions example',
+            type: 'boolean',
+            defaultValue: false,
+        },
+    ],
+    outputShape: {
+        description: 'Project Environment Contract query result',
+        type: 'object',
+        properties: [
+            { name: 'schemaVersion', type: 'string', description: 'Contract schema version (env-contract.v1)' },
+            { name: 'generatedAt', type: 'string', description: 'ISO timestamp of contract generation' },
+            { name: 'agentType', type: 'string', description: 'Agent type used for filtering' },
+            {
+                name: 'items',
+                type: 'array',
+                description: 'Filtered contract items',
+                items: {
+                    name: 'item',
+                    type: 'object',
+                    properties: [
+                        { name: 'id', type: 'string', description: 'Unique contract item identifier' },
+                        { name: 'category', type: 'string', description: 'Contract category: execution|commit|retrieval|validation|style' },
+                        { name: 'severity', type: 'string', description: 'Severity level: critical|high|medium|low' },
+                        { name: 'content', type: 'string', description: 'Human-readable contract rule' },
+                        {
+                            name: 'sources',
+                            type: 'array',
+                            description: 'Source file references',
+                            items: {
+                                name: 'source',
+                                type: 'object',
+                                properties: [
+                                    { name: 'file', type: 'string', description: 'Source file path' },
+                                    { name: 'line', type: 'number', description: 'Source line number', nullable: true },
+                                    { name: 'hash', type: 'string', description: 'Content hash' },
+                                    { name: 'authority', type: 'string', description: 'Source authority: executable|governance|generated|example' },
+                                ],
+                            },
+                        },
+                    ],
+                },
+            },
+            {
+                name: 'conflicts',
+                type: 'array',
+                description: 'Detected conflicts between sources',
+                items: {
+                    name: 'conflict',
+                    type: 'object',
+                    properties: [
+                        { name: 'id', type: 'string' },
+                        { name: 'severity', type: 'string' },
+                        { name: 'description', type: 'string' },
+                        { name: 'recommendation', type: 'string' },
+                    ],
+                },
+            },
+            {
+                name: 'sourceSnapshots',
+                type: 'array',
+                description: 'Hash snapshots of source files',
+                items: {
+                    name: 'snapshot',
+                    type: 'object',
+                    properties: [
+                        { name: 'file', type: 'string' },
+                        { name: 'hash', type: 'string' },
+                        { name: 'lastModified', type: 'string' },
+                    ],
+                },
+            },
+            {
+                name: 'diagnostics',
+                type: 'array',
+                description: 'Check diagnostics (only present with --check)',
+                nullable: true,
+                items: {
+                    name: 'diagnostic',
+                    type: 'object',
+                    properties: [
+                        { name: 'id', type: 'string' },
+                        { name: 'severity', type: 'string' },
+                        { name: 'message', type: 'string' },
+                        { name: 'remediation', type: 'string' },
+                    ],
+                },
+            },
+        ],
+    },
+    errorCodes: [
+        { code: 'ENV_CONTRACT_NOT_FOUND', description: 'No contract file and discovery failed' },
+        { code: 'ENV_CONTRACT_SCHEMA_INVALID', description: 'Contract file fails schema validation' },
+        { code: 'ENV_CONTRACT_CHECK_FAILED', description: 'Contract check detected errors (exit code 1)' },
+        { code: 'ENV_CONTRACT_CHECK_WARN', description: 'Contract check detected warnings (exit code 2)' },
+    ],
+    examples: [
+        'codemap env-contract',
+        'codemap env-contract --for worker --json',
+        'codemap env-contract --check',
+        'codemap env-contract --update',
+        'codemap env-contract --as-hook-config',
+        'codemap env-contract --as-codex-agent',
+        'codemap env-contract --category commit --json',
+    ],
+};
+//# sourceMappingURL=env-contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env-contract.js","sourceRoot":"","sources":["../../../../src/cli/interface-contract/commands/env-contract.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,6FAA6F;AAI7F,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,CAAC,cAAc,CAAC;IACzB,WAAW,EAAE,oEAAoE;IACjF,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,EAAE;IACR,KAAK,EAAE;QACL;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,yBAAyB;YACtC,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,6BAA6B;YAC1C,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,mEAAmE;YAChF,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,SAAS;SACxB;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,uEAAuE;YACpF,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,SAAS;SACxB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,gDAAgD;YAC7D,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;YACtD,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,8CAA8C;YAC3D,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,kDAAkD;YAC/D,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,KAAK;SACpB;KACF;IACD,WAAW,EAAE;QACX,WAAW,EAAE,2CAA2C;QACxD,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;YACnG,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;YAC5F,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YACnF;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,yBAAyB;gBACtC,KAAK,EAAE;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;wBAC9E,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gEAAgE,EAAE;wBACnH,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;wBAC7F,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;wBAChF;4BACE,IAAI,EAAE,SAAS;4BACf,IAAI,EAAE,OAAO;4BACb,WAAW,EAAE,wBAAwB;4BACrC,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,QAAQ;gCACd,UAAU,EAAE;oCACV,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;oCACjE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE;oCACnF,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;oCAC7D,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;iCAChH;6BACF;yBACF;qBACF;iBACF;aACF;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,oCAAoC;gBACjD,KAAK,EAAE;oBACL,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAC9B,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACpC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACvC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;qBAC3C;iBACF;aACF;YACD;gBACE,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,gCAAgC;gBAC7C,KAAK,EAAE;oBACL,IAAI,EAAE,UAAU;oBAChB,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,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE;qBACzC;iBACF;aACF;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,+CAA+C;gBAC5D,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAC9B,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACpC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACnC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;qBACxC;iBACF;aACF;SACF;KACF;IACD,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,wBAAwB,EAAE,WAAW,EAAE,uCAAuC,EAAE;QACxF,EAAE,IAAI,EAAE,6BAA6B,EAAE,WAAW,EAAE,uCAAuC,EAAE;QAC7F,EAAE,IAAI,EAAE,2BAA2B,EAAE,WAAW,EAAE,8CAA8C,EAAE;QAClG,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,gDAAgD,EAAE;KACnG;IACD,QAAQ,EAAE;QACR,sBAAsB;QACtB,0CAA0C;QAC1C,8BAA8B;QAC9B,+BAA+B;QAC/B,uCAAuC;QACvC,uCAAuC;QACvC,+CAA+C;KAChD;CACF,CAAC"}

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

@@ -0,0 +1,12 @@
+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';
+import { previewContract } from './preview.js';
+import { envContractContract } from './env-contract.js';
+import { agentMetricsContract } from './agent-metrics.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, import("../types.js").CommandContract, import("../types.js").CommandContract, import("../types.js").CommandContract];
+export { analyzeContract, queryContract, depsContract, doctorContract, benchmarkContract, initContract, previewContract, envContractContract, agentMetricsContract };
+//# 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;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,eAAO,MAAM,gBAAgB,0WAUnB,CAAC;AAEX,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,CAAC"}

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

@@ -0,0 +1,24 @@
+// [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';
+import { previewContract } from './preview.js';
+import { envContractContract } from './env-contract.js';
+import { agentMetricsContract } from './agent-metrics.js';
+export const commandContracts = [
+    analyzeContract,
+    queryContract,
+    depsContract,
+    doctorContract,
+    benchmarkContract,
+    initContract,
+    previewContract,
+    envContractContract,
+    agentMetricsContract,
+];
+export { analyzeContract, queryContract, depsContract, doctorContract, benchmarkContract, initContract, previewContract, envContractContract, agentMetricsContract };
+//# 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;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe;IACf,aAAa;IACb,YAAY;IACZ,cAAc;IACd,iBAAiB;IACjB,YAAY;IACZ,eAAe;IACf,mBAAmB;IACnB,oBAAoB;CACZ,CAAC;AAEX,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,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,eA4F1B,CAAC"}

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

@@ -0,0 +1,96 @@
+// [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 项目状态',
+    stable: true,
+    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,
+        },
+        {
+            name: 'profile',
+            long: 'profile',
+            description: '跳过检测，直接应用指定内置 profile',
+            type: 'string',
+            defaultValue: undefined,
+        },
+    ],
+    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',
+        'codemap init --profile nodejs',
+    ],
+};
+//# 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,MAAM,EAAE,IAAI;IACZ,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;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uBAAuB;YACpC,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,SAAS;SACxB;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;QACrB,+BAA+B;KAChC;CACF,CAAC"}

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

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

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

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