@mycodemap/mycodemap 1.9.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (194) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +138 -928
  3. package/README.zh-CN.md +1096 -0
  4. package/dist/cli/commands/analyze-options.d.ts.map +1 -1
  5. package/dist/cli/commands/analyze-options.js +8 -0
  6. package/dist/cli/commands/analyze-options.js.map +1 -1
  7. package/dist/cli/commands/analyze.d.ts.map +1 -1
  8. package/dist/cli/commands/analyze.js +60 -41
  9. package/dist/cli/commands/analyze.js.map +1 -1
  10. package/dist/cli/commands/benchmark.d.ts +8 -0
  11. package/dist/cli/commands/benchmark.d.ts.map +1 -0
  12. package/dist/cli/commands/benchmark.js +150 -0
  13. package/dist/cli/commands/benchmark.js.map +1 -0
  14. package/dist/cli/commands/deps.d.ts +2 -1
  15. package/dist/cli/commands/deps.d.ts.map +1 -1
  16. package/dist/cli/commands/deps.js +107 -78
  17. package/dist/cli/commands/deps.js.map +1 -1
  18. package/dist/cli/commands/doctor.d.ts +3 -0
  19. package/dist/cli/commands/doctor.d.ts.map +1 -0
  20. package/dist/cli/commands/doctor.js +34 -0
  21. package/dist/cli/commands/doctor.js.map +1 -0
  22. package/dist/cli/commands/query.d.ts +1 -0
  23. package/dist/cli/commands/query.d.ts.map +1 -1
  24. package/dist/cli/commands/query.js +123 -140
  25. package/dist/cli/commands/query.js.map +1 -1
  26. package/dist/cli/doctor/check-agent.d.ts +3 -0
  27. package/dist/cli/doctor/check-agent.d.ts.map +1 -0
  28. package/dist/cli/doctor/check-agent.js +60 -0
  29. package/dist/cli/doctor/check-agent.js.map +1 -0
  30. package/dist/cli/doctor/check-ghost-commands.d.ts +3 -0
  31. package/dist/cli/doctor/check-ghost-commands.d.ts.map +1 -0
  32. package/dist/cli/doctor/check-ghost-commands.js +86 -0
  33. package/dist/cli/doctor/check-ghost-commands.js.map +1 -0
  34. package/dist/cli/doctor/check-native-deps.d.ts +3 -0
  35. package/dist/cli/doctor/check-native-deps.d.ts.map +1 -0
  36. package/dist/cli/doctor/check-native-deps.js +54 -0
  37. package/dist/cli/doctor/check-native-deps.js.map +1 -0
  38. package/dist/cli/doctor/check-workspace-drift.d.ts +3 -0
  39. package/dist/cli/doctor/check-workspace-drift.d.ts.map +1 -0
  40. package/dist/cli/doctor/check-workspace-drift.js +83 -0
  41. package/dist/cli/doctor/check-workspace-drift.js.map +1 -0
  42. package/dist/cli/doctor/formatter.d.ts +20 -0
  43. package/dist/cli/doctor/formatter.d.ts.map +1 -0
  44. package/dist/cli/doctor/formatter.js +91 -0
  45. package/dist/cli/doctor/formatter.js.map +1 -0
  46. package/dist/cli/doctor/index.d.ts +8 -0
  47. package/dist/cli/doctor/index.d.ts.map +1 -0
  48. package/dist/cli/doctor/index.js +9 -0
  49. package/dist/cli/doctor/index.js.map +1 -0
  50. package/dist/cli/doctor/orchestrator.d.ts +3 -0
  51. package/dist/cli/doctor/orchestrator.d.ts.map +1 -0
  52. package/dist/cli/doctor/orchestrator.js +37 -0
  53. package/dist/cli/doctor/orchestrator.js.map +1 -0
  54. package/dist/cli/doctor/types.d.ts +19 -0
  55. package/dist/cli/doctor/types.d.ts.map +1 -0
  56. package/dist/cli/doctor/types.js +4 -0
  57. package/dist/cli/doctor/types.js.map +1 -0
  58. package/dist/cli/index.js +72 -20
  59. package/dist/cli/index.js.map +1 -1
  60. package/dist/cli/interface-contract/commands/analyze.d.ts +3 -0
  61. package/dist/cli/interface-contract/commands/analyze.d.ts.map +1 -0
  62. package/dist/cli/interface-contract/commands/analyze.js +138 -0
  63. package/dist/cli/interface-contract/commands/analyze.js.map +1 -0
  64. package/dist/cli/interface-contract/commands/benchmark.d.ts +3 -0
  65. package/dist/cli/interface-contract/commands/benchmark.d.ts.map +1 -0
  66. package/dist/cli/interface-contract/commands/benchmark.js +107 -0
  67. package/dist/cli/interface-contract/commands/benchmark.js.map +1 -0
  68. package/dist/cli/interface-contract/commands/deps.d.ts +3 -0
  69. package/dist/cli/interface-contract/commands/deps.d.ts.map +1 -0
  70. package/dist/cli/interface-contract/commands/deps.js +129 -0
  71. package/dist/cli/interface-contract/commands/deps.js.map +1 -0
  72. package/dist/cli/interface-contract/commands/doctor.d.ts +3 -0
  73. package/dist/cli/interface-contract/commands/doctor.d.ts.map +1 -0
  74. package/dist/cli/interface-contract/commands/doctor.js +59 -0
  75. package/dist/cli/interface-contract/commands/doctor.js.map +1 -0
  76. package/dist/cli/interface-contract/commands/index.d.ts +9 -0
  77. package/dist/cli/interface-contract/commands/index.d.ts.map +1 -0
  78. package/dist/cli/interface-contract/commands/index.js +18 -0
  79. package/dist/cli/interface-contract/commands/index.js.map +1 -0
  80. package/dist/cli/interface-contract/commands/init.d.ts +3 -0
  81. package/dist/cli/interface-contract/commands/init.d.ts.map +1 -0
  82. package/dist/cli/interface-contract/commands/init.js +87 -0
  83. package/dist/cli/interface-contract/commands/init.js.map +1 -0
  84. package/dist/cli/interface-contract/commands/query.d.ts +3 -0
  85. package/dist/cli/interface-contract/commands/query.d.ts.map +1 -0
  86. package/dist/cli/interface-contract/commands/query.js +185 -0
  87. package/dist/cli/interface-contract/commands/query.js.map +1 -0
  88. package/dist/cli/interface-contract/index.d.ts +22 -0
  89. package/dist/cli/interface-contract/index.d.ts.map +1 -0
  90. package/dist/cli/interface-contract/index.js +41 -0
  91. package/dist/cli/interface-contract/index.js.map +1 -0
  92. package/dist/cli/interface-contract/schema.d.ts +30 -0
  93. package/dist/cli/interface-contract/schema.d.ts.map +1 -0
  94. package/dist/cli/interface-contract/schema.js +72 -0
  95. package/dist/cli/interface-contract/schema.js.map +1 -0
  96. package/dist/cli/interface-contract/types.d.ts +76 -0
  97. package/dist/cli/interface-contract/types.d.ts.map +1 -0
  98. package/dist/cli/interface-contract/types.js +4 -0
  99. package/dist/cli/interface-contract/types.js.map +1 -0
  100. package/dist/cli/output/apply-suggestion.d.ts +12 -0
  101. package/dist/cli/output/apply-suggestion.d.ts.map +1 -0
  102. package/dist/cli/output/apply-suggestion.js +29 -0
  103. package/dist/cli/output/apply-suggestion.js.map +1 -0
  104. package/dist/cli/output/error-codes.d.ts +22 -0
  105. package/dist/cli/output/error-codes.d.ts.map +1 -0
  106. package/dist/cli/output/error-codes.js +82 -0
  107. package/dist/cli/output/error-codes.js.map +1 -0
  108. package/dist/cli/output/errors.d.ts +14 -0
  109. package/dist/cli/output/errors.d.ts.map +1 -0
  110. package/dist/cli/output/errors.js +170 -0
  111. package/dist/cli/output/errors.js.map +1 -0
  112. package/dist/cli/output/index.d.ts +13 -0
  113. package/dist/cli/output/index.d.ts.map +1 -0
  114. package/dist/cli/output/index.js +11 -0
  115. package/dist/cli/output/index.js.map +1 -0
  116. package/dist/cli/output/mode.d.ts +12 -0
  117. package/dist/cli/output/mode.d.ts.map +1 -0
  118. package/dist/cli/output/mode.js +23 -0
  119. package/dist/cli/output/mode.js.map +1 -0
  120. package/dist/cli/output/progress.d.ts +9 -0
  121. package/dist/cli/output/progress.d.ts.map +1 -0
  122. package/dist/cli/output/progress.js +65 -0
  123. package/dist/cli/output/progress.js.map +1 -0
  124. package/dist/cli/output/render.d.ts +11 -0
  125. package/dist/cli/output/render.d.ts.map +1 -0
  126. package/dist/cli/output/render.js +18 -0
  127. package/dist/cli/output/render.js.map +1 -0
  128. package/dist/cli/output/types.d.ts +53 -0
  129. package/dist/cli/output/types.d.ts.map +1 -0
  130. package/dist/cli/output/types.js +14 -0
  131. package/dist/cli/output/types.js.map +1 -0
  132. package/dist/cli/output/wasm-fallback.d.ts +13 -0
  133. package/dist/cli/output/wasm-fallback.d.ts.map +1 -0
  134. package/dist/cli/output/wasm-fallback.js +92 -0
  135. package/dist/cli/output/wasm-fallback.js.map +1 -0
  136. package/dist/cli/tree-sitter-check.d.ts +6 -1
  137. package/dist/cli/tree-sitter-check.d.ts.map +1 -1
  138. package/dist/cli/tree-sitter-check.js +23 -1
  139. package/dist/cli/tree-sitter-check.js.map +1 -1
  140. package/dist/infrastructure/storage/adapters/SQLiteStorage.d.ts.map +1 -1
  141. package/dist/infrastructure/storage/adapters/SQLiteStorage.js +2 -2
  142. package/dist/infrastructure/storage/adapters/SQLiteStorage.js.map +1 -1
  143. package/dist/infrastructure/storage/adapters/sqlite-loader.d.ts +23 -0
  144. package/dist/infrastructure/storage/adapters/sqlite-loader.d.ts.map +1 -0
  145. package/dist/infrastructure/storage/adapters/sqlite-loader.js +210 -0
  146. package/dist/infrastructure/storage/adapters/sqlite-loader.js.map +1 -0
  147. package/dist/orchestrator/types.d.ts +2 -0
  148. package/dist/orchestrator/types.d.ts.map +1 -1
  149. package/dist/orchestrator/types.js.map +1 -1
  150. package/dist/parser/implementations/tree-sitter-loader.d.ts +16 -0
  151. package/dist/parser/implementations/tree-sitter-loader.d.ts.map +1 -0
  152. package/dist/parser/implementations/tree-sitter-loader.js +105 -0
  153. package/dist/parser/implementations/tree-sitter-loader.js.map +1 -0
  154. package/dist/parser/implementations/tree-sitter-parser.d.ts +3 -0
  155. package/dist/parser/implementations/tree-sitter-parser.d.ts.map +1 -1
  156. package/dist/parser/implementations/tree-sitter-parser.js +8 -3
  157. package/dist/parser/implementations/tree-sitter-parser.js.map +1 -1
  158. package/dist/server/mcp/schema-adapter.d.ts +45 -0
  159. package/dist/server/mcp/schema-adapter.d.ts.map +1 -0
  160. package/dist/server/mcp/schema-adapter.js +290 -0
  161. package/dist/server/mcp/schema-adapter.js.map +1 -0
  162. package/dist/server/mcp/server.d.ts.map +1 -1
  163. package/dist/server/mcp/server.js +32 -2
  164. package/dist/server/mcp/server.js.map +1 -1
  165. package/docs/AI_ASSISTANT_SETUP.md +169 -12
  166. package/docs/README.md +40 -1
  167. package/docs/SETUP_GUIDE.md +11 -14
  168. package/docs/ai-guide/COMMANDS.md +68 -10
  169. package/docs/ai-guide/INTEGRATION.md +77 -10
  170. package/docs/ai-guide/OUTPUT.md +295 -2
  171. package/docs/ai-guide/PROMPTS.md +2 -2
  172. package/docs/ai-guide/QUICKSTART.md +28 -1
  173. package/docs/ai-guide/README.md +2 -2
  174. package/docs/archive/ideation/2026-04-15-executable-architecture-constitution-ideation-archive.md +70 -0
  175. package/docs/archive/ideation/2026-04-20-mycodemap-init-enhancements-ideation-archive.md +109 -0
  176. package/docs/archive/ideation/2026-04-22-rules-entry-docs-optimization-consolidated-ideation-archive.md +54 -0
  177. package/docs/ideation/2026-04-15-executable-architecture-constitution-ideation.md +10 -22
  178. package/docs/ideation/2026-04-20-mycodemap-init-enhancements-ideation.md +15 -60
  179. package/docs/ideation/2026-04-22-rules-entry-docs-optimization-consolidated-ideation.md +47 -52
  180. package/docs/ideation/2026-04-29-ux-install-agent-experience-ideation.md +256 -0
  181. package/docs/plans/2026-04-30-install-guide-and-repo-analyzer-design.md +394 -0
  182. package/docs/rules/README.md +1 -0
  183. package/docs/rules/architecture-guardrails.md +2 -1
  184. package/docs/rules/engineering-with-codex-openai.md +1 -1
  185. package/docs/rules/harness.md +106 -0
  186. package/docs/rules/pre-release-checklist.md +28 -0
  187. package/docs/rules/testing.md +51 -0
  188. package/examples/claude/skills/mycodemap-repo-analyzer/SKILL.md +294 -0
  189. package/examples/claude/skills/mycodemap-repo-analyzer/references/analysis-guide.md +166 -0
  190. package/examples/claude/skills/mycodemap-repo-analyzer/references/module-analysis-guide.md +150 -0
  191. package/package.json +7 -4
  192. package/scripts/sync-analyze-docs.js +2 -2
  193. package/scripts/validate-docs.js +113 -16
  194. package/docs/references/tmp.md +0 -527
package/CHANGELOG.md CHANGED
@@ -2,6 +2,24 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## [2.0.0] - 2026-05-01 - Agent-Native Foundation
6
+
7
+ ### 🏗️ Architecture
8
+
9
+ - **interface-contract**: 新增 schema-driven CLI 统一接口契约 (`src/cli/interface-contract/`)，同时生成 parser、MCP tool 定义和 shell completion
10
+ - **mcp-gateway**: CLI-as-MCP 自动网关 (`src/server/mcp/schema-adapter.ts`)，动态注册 contract commands 为 MCP tools
11
+ - **repo-analyzer**: 新增 `repo-analyzer` skill，支持仓库级结构化分析
12
+
13
+ ### 🛡️ Validation
14
+
15
+ - **real-world-validation**: 添加真实场景验证规则到测试规范、发布检查清单、AGENTS.md 和 CI 护栏
16
+ - **docs-guardrail**: AI 文档版本一致性检查成为发布前硬性门槛
17
+
18
+ ### 📝 Documentation
19
+
20
+ - **release**: 同步 `llms.txt`、`AI_GUIDE.md`、`AI_DISCOVERY.md`、`ai-document-index.yaml` 到 `v2.0.0`
21
+ - **changelog**: 新增 v2.0.0 发布条目，记录 agent-native foundation milestone
22
+
5
23
  ## [1.9.0] - 2026-04-29 - Release Governance Unification
6
24
 
7
25
  ### 🏛️ Governance