@mycodemap/mycodemap 0.4.1 → 0.4.2

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 (222) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/README.md +214 -221
  3. package/dist/cli/commands/analyze-options.d.ts +36 -0
  4. package/dist/cli/commands/analyze-options.d.ts.map +1 -0
  5. package/dist/cli/commands/analyze-options.js +147 -0
  6. package/dist/cli/commands/analyze-options.js.map +1 -0
  7. package/dist/cli/commands/analyze.d.ts +93 -4
  8. package/dist/cli/commands/analyze.d.ts.map +1 -1
  9. package/dist/cli/commands/analyze.js +592 -176
  10. package/dist/cli/commands/analyze.js.map +1 -1
  11. package/dist/cli/commands/ci.d.ts +47 -1
  12. package/dist/cli/commands/ci.d.ts.map +1 -1
  13. package/dist/cli/commands/ci.js +208 -1
  14. package/dist/cli/commands/ci.js.map +1 -1
  15. package/dist/cli/commands/export.d.ts.map +1 -1
  16. package/dist/cli/commands/export.js +2 -2
  17. package/dist/cli/commands/export.js.map +1 -1
  18. package/dist/cli/commands/generate.d.ts +8 -2
  19. package/dist/cli/commands/generate.d.ts.map +1 -1
  20. package/dist/cli/commands/generate.js +151 -22
  21. package/dist/cli/commands/generate.js.map +1 -1
  22. package/dist/cli/commands/init.d.ts.map +1 -1
  23. package/dist/cli/commands/init.js +2 -13
  24. package/dist/cli/commands/init.js.map +1 -1
  25. package/dist/cli/commands/ship/checker.d.ts.map +1 -1
  26. package/dist/cli/commands/ship/checker.js +0 -3
  27. package/dist/cli/commands/ship/checker.js.map +1 -1
  28. package/dist/cli/commands/ship/rules/quality-rules.d.ts +0 -1
  29. package/dist/cli/commands/ship/rules/quality-rules.d.ts.map +1 -1
  30. package/dist/cli/commands/ship/rules/quality-rules.js +4 -76
  31. package/dist/cli/commands/ship/rules/quality-rules.js.map +1 -1
  32. package/dist/cli/commands/workflow.js +4 -4
  33. package/dist/cli/commands/workflow.js.map +1 -1
  34. package/dist/cli/config-loader.d.ts +31 -0
  35. package/dist/cli/config-loader.d.ts.map +1 -0
  36. package/dist/cli/config-loader.js +235 -0
  37. package/dist/cli/config-loader.js.map +1 -0
  38. package/dist/cli/index.js +18 -63
  39. package/dist/cli/index.js.map +1 -1
  40. package/dist/cli/removed-commands.d.ts +9 -0
  41. package/dist/cli/removed-commands.d.ts.map +1 -0
  42. package/dist/cli/removed-commands.js +48 -0
  43. package/dist/cli/removed-commands.js.map +1 -0
  44. package/dist/cli/storage-runtime.d.ts +8 -0
  45. package/dist/cli/storage-runtime.d.ts.map +1 -0
  46. package/dist/cli/storage-runtime.js +14 -0
  47. package/dist/cli/storage-runtime.js.map +1 -0
  48. package/dist/cli/tree-sitter-check.d.ts.map +1 -1
  49. package/dist/cli/tree-sitter-check.js +0 -1
  50. package/dist/cli/tree-sitter-check.js.map +1 -1
  51. package/dist/cli-new/commands/export.d.ts.map +1 -1
  52. package/dist/cli-new/commands/export.js +2 -2
  53. package/dist/cli-new/commands/export.js.map +1 -1
  54. package/dist/cli-new/commands/query.d.ts.map +1 -1
  55. package/dist/cli-new/commands/query.js +5 -4
  56. package/dist/cli-new/commands/query.js.map +1 -1
  57. package/dist/cli-new/index.d.ts.map +1 -1
  58. package/dist/cli-new/index.js +0 -2
  59. package/dist/cli-new/index.js.map +1 -1
  60. package/dist/core/analyzer.d.ts.map +1 -1
  61. package/dist/core/analyzer.js +7 -39
  62. package/dist/core/analyzer.js.map +1 -1
  63. package/dist/core/file-discovery.d.ts +17 -0
  64. package/dist/core/file-discovery.d.ts.map +1 -0
  65. package/dist/core/file-discovery.js +75 -0
  66. package/dist/core/file-discovery.js.map +1 -0
  67. package/dist/core/global-index.d.ts +5 -0
  68. package/dist/core/global-index.d.ts.map +1 -1
  69. package/dist/core/global-index.js +71 -21
  70. package/dist/core/global-index.js.map +1 -1
  71. package/dist/generator/index.d.ts.map +1 -1
  72. package/dist/generator/index.js +8 -0
  73. package/dist/generator/index.js.map +1 -1
  74. package/dist/infrastructure/parser/implementations/GoParser.d.ts +2 -5
  75. package/dist/infrastructure/parser/implementations/GoParser.d.ts.map +1 -1
  76. package/dist/infrastructure/parser/implementations/GoParser.js +2 -5
  77. package/dist/infrastructure/parser/implementations/GoParser.js.map +1 -1
  78. package/dist/infrastructure/parser/implementations/PythonParser.d.ts +1 -5
  79. package/dist/infrastructure/parser/implementations/PythonParser.d.ts.map +1 -1
  80. package/dist/infrastructure/parser/implementations/PythonParser.js +1 -5
  81. package/dist/infrastructure/parser/implementations/PythonParser.js.map +1 -1
  82. package/dist/infrastructure/parser/implementations/TypeScriptParser.d.ts +1 -5
  83. package/dist/infrastructure/parser/implementations/TypeScriptParser.d.ts.map +1 -1
  84. package/dist/infrastructure/parser/implementations/TypeScriptParser.js +1 -5
  85. package/dist/infrastructure/parser/implementations/TypeScriptParser.js.map +1 -1
  86. package/dist/infrastructure/storage/StorageFactory.d.ts +0 -1
  87. package/dist/infrastructure/storage/StorageFactory.d.ts.map +1 -1
  88. package/dist/infrastructure/storage/StorageFactory.js +4 -29
  89. package/dist/infrastructure/storage/StorageFactory.js.map +1 -1
  90. package/dist/infrastructure/storage/adapters/FileSystemStorage.d.ts.map +1 -1
  91. package/dist/infrastructure/storage/adapters/FileSystemStorage.js +24 -137
  92. package/dist/infrastructure/storage/adapters/FileSystemStorage.js.map +1 -1
  93. package/dist/infrastructure/storage/adapters/KuzuDBStorage.d.ts +10 -18
  94. package/dist/infrastructure/storage/adapters/KuzuDBStorage.d.ts.map +1 -1
  95. package/dist/infrastructure/storage/adapters/KuzuDBStorage.js +103 -146
  96. package/dist/infrastructure/storage/adapters/KuzuDBStorage.js.map +1 -1
  97. package/dist/infrastructure/storage/adapters/MemoryStorage.d.ts +0 -1
  98. package/dist/infrastructure/storage/adapters/MemoryStorage.d.ts.map +1 -1
  99. package/dist/infrastructure/storage/adapters/MemoryStorage.js +16 -136
  100. package/dist/infrastructure/storage/adapters/MemoryStorage.js.map +1 -1
  101. package/dist/infrastructure/storage/graph-helpers.d.ts +16 -0
  102. package/dist/infrastructure/storage/graph-helpers.d.ts.map +1 -0
  103. package/dist/infrastructure/storage/graph-helpers.js +161 -0
  104. package/dist/infrastructure/storage/graph-helpers.js.map +1 -0
  105. package/dist/infrastructure/storage/index.d.ts.map +1 -1
  106. package/dist/interface/config/index.d.ts +10 -1
  107. package/dist/interface/config/index.d.ts.map +1 -1
  108. package/dist/interface/types/index.d.ts +13 -0
  109. package/dist/interface/types/index.d.ts.map +1 -1
  110. package/dist/interface/types/storage.d.ts +1 -4
  111. package/dist/interface/types/storage.d.ts.map +1 -1
  112. package/dist/orchestrator/confidence.d.ts +9 -9
  113. package/dist/orchestrator/confidence.d.ts.map +1 -1
  114. package/dist/orchestrator/confidence.js +44 -67
  115. package/dist/orchestrator/confidence.js.map +1 -1
  116. package/dist/orchestrator/file-header-scanner.d.ts.map +1 -1
  117. package/dist/orchestrator/file-header-scanner.js +22 -31
  118. package/dist/orchestrator/file-header-scanner.js.map +1 -1
  119. package/dist/orchestrator/intent-router.d.ts +2 -11
  120. package/dist/orchestrator/intent-router.d.ts.map +1 -1
  121. package/dist/orchestrator/intent-router.js +58 -49
  122. package/dist/orchestrator/intent-router.js.map +1 -1
  123. package/dist/orchestrator/tool-orchestrator.d.ts.map +1 -1
  124. package/dist/orchestrator/tool-orchestrator.js +6 -4
  125. package/dist/orchestrator/tool-orchestrator.js.map +1 -1
  126. package/dist/orchestrator/types.d.ts +113 -2
  127. package/dist/orchestrator/types.d.ts.map +1 -1
  128. package/dist/orchestrator/types.js +29 -0
  129. package/dist/orchestrator/types.js.map +1 -1
  130. package/dist/orchestrator/workflow/config.d.ts +4 -12
  131. package/dist/orchestrator/workflow/config.d.ts.map +1 -1
  132. package/dist/orchestrator/workflow/config.js +4 -6
  133. package/dist/orchestrator/workflow/config.js.map +1 -1
  134. package/dist/orchestrator/workflow/git-analyzer.d.ts.map +1 -1
  135. package/dist/orchestrator/workflow/git-analyzer.js +9 -19
  136. package/dist/orchestrator/workflow/git-analyzer.js.map +1 -1
  137. package/dist/orchestrator/workflow/phase-inheritance.d.ts.map +1 -1
  138. package/dist/orchestrator/workflow/phase-inheritance.js +14 -23
  139. package/dist/orchestrator/workflow/phase-inheritance.js.map +1 -1
  140. package/dist/orchestrator/workflow/result-fusion.d.ts.map +1 -1
  141. package/dist/orchestrator/workflow/result-fusion.js +9 -11
  142. package/dist/orchestrator/workflow/result-fusion.js.map +1 -1
  143. package/dist/orchestrator/workflow/templates.d.ts +4 -1
  144. package/dist/orchestrator/workflow/templates.d.ts.map +1 -1
  145. package/dist/orchestrator/workflow/templates.js +49 -207
  146. package/dist/orchestrator/workflow/templates.js.map +1 -1
  147. package/dist/orchestrator/workflow/test-linker.d.ts.map +1 -1
  148. package/dist/orchestrator/workflow/test-linker.js +12 -24
  149. package/dist/orchestrator/workflow/test-linker.js.map +1 -1
  150. package/dist/orchestrator/workflow/types.d.ts +11 -8
  151. package/dist/orchestrator/workflow/types.d.ts.map +1 -1
  152. package/dist/orchestrator/workflow/types.js +8 -1
  153. package/dist/orchestrator/workflow/types.js.map +1 -1
  154. package/dist/orchestrator/workflow/visualizer.d.ts.map +1 -1
  155. package/dist/orchestrator/workflow/visualizer.js +7 -9
  156. package/dist/orchestrator/workflow/visualizer.js.map +1 -1
  157. package/dist/orchestrator/workflow/workflow-context.d.ts.map +1 -1
  158. package/dist/orchestrator/workflow/workflow-context.js +3 -5
  159. package/dist/orchestrator/workflow/workflow-context.js.map +1 -1
  160. package/dist/orchestrator/workflow/workflow-orchestrator.d.ts +0 -4
  161. package/dist/orchestrator/workflow/workflow-orchestrator.d.ts.map +1 -1
  162. package/dist/orchestrator/workflow/workflow-orchestrator.js +7 -99
  163. package/dist/orchestrator/workflow/workflow-orchestrator.js.map +1 -1
  164. package/dist/parser/index.d.ts.map +1 -1
  165. package/dist/parser/index.js +2 -2
  166. package/dist/parser/index.js.map +1 -1
  167. package/dist/plugins/index.d.ts +5 -3
  168. package/dist/plugins/index.d.ts.map +1 -1
  169. package/dist/plugins/index.js +19 -8
  170. package/dist/plugins/index.js.map +1 -1
  171. package/dist/plugins/plugin-loader.d.ts +21 -6
  172. package/dist/plugins/plugin-loader.d.ts.map +1 -1
  173. package/dist/plugins/plugin-loader.js +170 -54
  174. package/dist/plugins/plugin-loader.js.map +1 -1
  175. package/dist/plugins/plugin-registry.d.ts +7 -4
  176. package/dist/plugins/plugin-registry.d.ts.map +1 -1
  177. package/dist/plugins/plugin-registry.js +62 -14
  178. package/dist/plugins/plugin-registry.js.map +1 -1
  179. package/dist/plugins/types.d.ts +16 -6
  180. package/dist/plugins/types.d.ts.map +1 -1
  181. package/dist/plugins/types.js +2 -0
  182. package/dist/plugins/types.js.map +1 -1
  183. package/dist/server/handlers/AnalysisHandler.d.ts +16 -2
  184. package/dist/server/handlers/AnalysisHandler.d.ts.map +1 -1
  185. package/dist/server/handlers/AnalysisHandler.js +31 -47
  186. package/dist/server/handlers/AnalysisHandler.js.map +1 -1
  187. package/dist/server/routes/api.d.ts.map +1 -1
  188. package/dist/server/routes/api.js +31 -12
  189. package/dist/server/routes/api.js.map +1 -1
  190. package/docs/AI_ASSISTANT_SETUP.md +3 -1
  191. package/docs/SETUP_GUIDE.md +41 -17
  192. package/docs/ai-guide/COMMANDS.md +106 -102
  193. package/docs/ai-guide/INTEGRATION.md +23 -21
  194. package/docs/ai-guide/OUTPUT.md +206 -10
  195. package/docs/ai-guide/PATTERNS.md +64 -15
  196. package/docs/ai-guide/PROMPTS.md +12 -12
  197. package/docs/ai-guide/QUICKSTART.md +35 -19
  198. package/docs/ai-guide/README.md +22 -4
  199. package/docs/product-specs/MVP3-ARCHITECTURE-COMPARISON.md +159 -434
  200. package/docs/product-specs/MVP3-ARCHITECTURE-REDESIGN-PRD.md +169 -261
  201. package/docs/product-specs/MVP3-ARCHITECTURE-REDESIGN-TECH-PRD.md +201 -1259
  202. package/docs/product-specs/README.md +8 -1
  203. package/docs/rules/architecture-guardrails.md +1 -2
  204. package/docs/rules/engineering-with-codex-openai.md +15 -9
  205. package/docs/rules/validation.md +26 -4
  206. package/mycodemap.config.schema.json +76 -5
  207. package/package.json +1 -1
  208. package/scripts/sync-analyze-docs.js +500 -0
  209. package/scripts/validate-ai-docs.js +54 -1
  210. package/scripts/validate-docs.js +746 -26
  211. package/dist/cli/commands/server.d.ts +0 -9
  212. package/dist/cli/commands/server.d.ts.map +0 -1
  213. package/dist/cli/commands/server.js +0 -68
  214. package/dist/cli/commands/server.js.map +0 -1
  215. package/dist/cli-new/commands/server.d.ts +0 -13
  216. package/dist/cli-new/commands/server.d.ts.map +0 -1
  217. package/dist/cli-new/commands/server.js +0 -94
  218. package/dist/cli-new/commands/server.js.map +0 -1
  219. package/dist/infrastructure/storage/adapters/Neo4jStorage.d.ts +0 -49
  220. package/dist/infrastructure/storage/adapters/Neo4jStorage.d.ts.map +0 -1
  221. package/dist/infrastructure/storage/adapters/Neo4jStorage.js +0 -222
  222. package/dist/infrastructure/storage/adapters/Neo4jStorage.js.map +0 -1
package/docs/ai-guide/README.md CHANGED
@@ -1,6 +1,10 @@
1
1
  # AI Guide 文档目录
2
2
 
3
- > 专为 AI 大模型和 Agent 设计的 CodeMap 使用指南
3
+ > 专为 AI/Agent 设计的 CodeMap 使用指南。
4
+ >
5
+ > CodeMap 是一个 AI-first 代码地图工具；AI/Agent 是主要消费者。
6
+ > 入口层优先聚焦 `generate`、`query`、`deps`、`impact`、`complexity`、`export`、`ci` 等核心分析能力。
7
+ > `workflow` 是当前公开的 analysis-only 工作流能力，`ship` 仍是公开的过渡能力；`server`、`watch`、`report`、`logs` 已从 public CLI 移除，并在调用时给出迁移提示。
4
8
 
5
9
  ---
6
10
 
@@ -17,6 +21,17 @@
17
21
 
18
22
  ---
19
23
 
24
+ ## 使用原则
25
+
26
+ | 原则 | 说明 |
27
+ |------|------|
28
+ | AI-first 入口 | 优先从 `AI_GUIDE.md`、`QUICKSTART.md`、`OUTPUT.md` 建立对产品和契约的理解 |
29
+ | 机器可读优先 | 当前 CLI 过渡现实下，大多数命令仍用 `--json` 暴露机器可读结果 |
30
+ | 人类可读显式入口 | `analyze` 当前支持 `--output-mode human`；其余命令按现有文本输出使用 |
31
+ | 边界优先 | `Server Layer` 是内部架构层，不等于公共 `mycodemap server` 命令 |
32
+
33
+ ---
34
+
20
35
  ## 快速开始
21
36
 
22
37
  ### 如果你是 AI/Agent
@@ -25,6 +40,8 @@
25
40
  2. **然后参考**: `PROMPTS.md` - 使用提示词模板开始任务
26
41
  3. **遇到问题时**: `INTEGRATION.md` - 查看错误处理方法
27
42
 
43
+ **建议顺序**：先理解产品定位，再进入命令细节；不要把 `workflow`、`ship` 当成首次接触项目时的主入口，也不要把已移除的 `server`、`watch`、`report`、`logs` 当成现行命令。
44
+
28
45
  ### 如果你是开发者
29
46
 
30
47
  1. **查看**: `PROMPTS.md` - 选择适合场景的提示词模板
@@ -39,9 +56,9 @@
39
56
  | 文档 | 行数 | 核心内容 |
40
57
  |------|------|---------|
41
58
  | QUICKSTART.md | ~120 | 决策树、场景映射 |
42
- | COMMANDS.md | ~350 | 16个命令完整参数 |
43
- | OUTPUT.md | ~320 | JSON 结构、解析工具 |
44
- | PATTERNS.md | ~290 | 6种工作流模式 |
59
+ | COMMANDS.md | ~350 | 核心分析命令 + 移除命令迁移说明 |
60
+ | OUTPUT.md | ~320 | 目标契约、当前 CLI 现实与 JSON 结构 |
61
+ | PATTERNS.md | ~290 | 核心分析模式 + 过渡 workflow 说明 |
45
62
  | PROMPTS.md | ~300 | 8个提示词模板 |
46
63
  | INTEGRATION.md | ~420 | MCP、Skill、错误处理 |
47
64
  | **总计** | **~1800** | **完整 AI 使用指南** |
@@ -51,6 +68,7 @@
51
68
  ## 主索引
52
69
 
53
70
  项目根目录的 `AI_GUIDE.md` 是主索引文档，包含：
71
+ - 产品定位与目标用户
54
72
  - 项目速览
55
73
  - 命令选择速查表
56
74
  - 文档导航