@mycodemap/mycodemap 0.1.1 → 0.2.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 (243) hide show
  1. package/CHANGELOG.md +78 -0
  2. package/README.md +241 -67
  3. package/dist/cli/commands/ci.d.ts +7 -1
  4. package/dist/cli/commands/ci.d.ts.map +1 -1
  5. package/dist/cli/commands/ci.js +38 -0
  6. package/dist/cli/commands/ci.js.map +1 -1
  7. package/dist/cli/commands/export.d.ts +6 -0
  8. package/dist/cli/commands/export.d.ts.map +1 -0
  9. package/dist/cli/commands/export.js +108 -0
  10. package/dist/cli/commands/export.js.map +1 -0
  11. package/dist/cli/commands/generate.d.ts.map +1 -1
  12. package/dist/cli/commands/generate.js +96 -0
  13. package/dist/cli/commands/generate.js.map +1 -1
  14. package/dist/cli/commands/server.d.ts +9 -0
  15. package/dist/cli/commands/server.d.ts.map +1 -0
  16. package/dist/cli/commands/server.js +68 -0
  17. package/dist/cli/commands/server.js.map +1 -0
  18. package/dist/cli/index.js +22 -1
  19. package/dist/cli/index.js.map +1 -1
  20. package/dist/cli-new/commands/export.d.ts +15 -0
  21. package/dist/cli-new/commands/export.d.ts.map +1 -0
  22. package/dist/cli-new/commands/export.js +107 -0
  23. package/dist/cli-new/commands/export.js.map +1 -0
  24. package/dist/cli-new/commands/query.d.ts +14 -0
  25. package/dist/cli-new/commands/query.d.ts.map +1 -0
  26. package/dist/cli-new/commands/query.js +120 -0
  27. package/dist/cli-new/commands/query.js.map +1 -0
  28. package/dist/cli-new/commands/server.d.ts +13 -0
  29. package/dist/cli-new/commands/server.d.ts.map +1 -0
  30. package/dist/cli-new/commands/server.js +94 -0
  31. package/dist/cli-new/commands/server.js.map +1 -0
  32. package/dist/cli-new/index.d.ts +11 -0
  33. package/dist/cli-new/index.d.ts.map +1 -0
  34. package/dist/cli-new/index.js +63 -0
  35. package/dist/cli-new/index.js.map +1 -0
  36. package/dist/cli-new/types/index.d.ts +88 -0
  37. package/dist/cli-new/types/index.d.ts.map +1 -0
  38. package/dist/cli-new/types/index.js +7 -0
  39. package/dist/cli-new/types/index.js.map +1 -0
  40. package/dist/domain/entities/CodeGraph.d.ts +134 -0
  41. package/dist/domain/entities/CodeGraph.d.ts.map +1 -0
  42. package/dist/domain/entities/CodeGraph.js +316 -0
  43. package/dist/domain/entities/CodeGraph.js.map +1 -0
  44. package/dist/domain/entities/Dependency.d.ts +78 -0
  45. package/dist/domain/entities/Dependency.d.ts.map +1 -0
  46. package/dist/domain/entities/Dependency.js +132 -0
  47. package/dist/domain/entities/Dependency.js.map +1 -0
  48. package/dist/domain/entities/Module.d.ts +75 -0
  49. package/dist/domain/entities/Module.d.ts.map +1 -0
  50. package/dist/domain/entities/Module.js +151 -0
  51. package/dist/domain/entities/Module.js.map +1 -0
  52. package/dist/domain/entities/Project.d.ts +50 -0
  53. package/dist/domain/entities/Project.d.ts.map +1 -0
  54. package/dist/domain/entities/Project.js +99 -0
  55. package/dist/domain/entities/Project.js.map +1 -0
  56. package/dist/domain/entities/Symbol.d.ts +75 -0
  57. package/dist/domain/entities/Symbol.d.ts.map +1 -0
  58. package/dist/domain/entities/Symbol.js +130 -0
  59. package/dist/domain/entities/Symbol.js.map +1 -0
  60. package/dist/domain/events/DomainEvent.d.ts +76 -0
  61. package/dist/domain/events/DomainEvent.d.ts.map +1 -0
  62. package/dist/domain/events/DomainEvent.js +153 -0
  63. package/dist/domain/events/DomainEvent.js.map +1 -0
  64. package/dist/domain/index.d.ts +10 -0
  65. package/dist/domain/index.d.ts.map +1 -0
  66. package/dist/domain/index.js +18 -0
  67. package/dist/domain/index.js.map +1 -0
  68. package/dist/domain/repositories/CodeGraphRepository.d.ts +58 -0
  69. package/dist/domain/repositories/CodeGraphRepository.d.ts.map +1 -0
  70. package/dist/domain/repositories/CodeGraphRepository.js +37 -0
  71. package/dist/domain/repositories/CodeGraphRepository.js.map +1 -0
  72. package/dist/domain/services/CodeGraphBuilder.d.ts +50 -0
  73. package/dist/domain/services/CodeGraphBuilder.d.ts.map +1 -0
  74. package/dist/domain/services/CodeGraphBuilder.js +121 -0
  75. package/dist/domain/services/CodeGraphBuilder.js.map +1 -0
  76. package/dist/infrastructure/parser/implementations/GoParser.d.ts +25 -0
  77. package/dist/infrastructure/parser/implementations/GoParser.d.ts.map +1 -0
  78. package/dist/infrastructure/parser/implementations/GoParser.js +158 -0
  79. package/dist/infrastructure/parser/implementations/GoParser.js.map +1 -0
  80. package/dist/infrastructure/parser/implementations/PythonParser.d.ts +30 -0
  81. package/dist/infrastructure/parser/implementations/PythonParser.d.ts.map +1 -0
  82. package/dist/infrastructure/parser/implementations/PythonParser.js +201 -0
  83. package/dist/infrastructure/parser/implementations/PythonParser.js.map +1 -0
  84. package/dist/infrastructure/parser/implementations/TypeScriptParser.d.ts +63 -0
  85. package/dist/infrastructure/parser/implementations/TypeScriptParser.d.ts.map +1 -0
  86. package/dist/infrastructure/parser/implementations/TypeScriptParser.js +420 -0
  87. package/dist/infrastructure/parser/implementations/TypeScriptParser.js.map +1 -0
  88. package/dist/infrastructure/parser/index.d.ts +13 -0
  89. package/dist/infrastructure/parser/index.d.ts.map +1 -0
  90. package/dist/infrastructure/parser/index.js +32 -0
  91. package/dist/infrastructure/parser/index.js.map +1 -0
  92. package/dist/infrastructure/parser/interfaces/ParserBase.d.ts +124 -0
  93. package/dist/infrastructure/parser/interfaces/ParserBase.d.ts.map +1 -0
  94. package/dist/infrastructure/parser/interfaces/ParserBase.js +200 -0
  95. package/dist/infrastructure/parser/interfaces/ParserBase.js.map +1 -0
  96. package/dist/infrastructure/parser/registry/ParserRegistry.d.ts +68 -0
  97. package/dist/infrastructure/parser/registry/ParserRegistry.d.ts.map +1 -0
  98. package/dist/infrastructure/parser/registry/ParserRegistry.js +116 -0
  99. package/dist/infrastructure/parser/registry/ParserRegistry.js.map +1 -0
  100. package/dist/infrastructure/repositories/CodeGraphRepositoryImpl.d.ts +44 -0
  101. package/dist/infrastructure/repositories/CodeGraphRepositoryImpl.d.ts.map +1 -0
  102. package/dist/infrastructure/repositories/CodeGraphRepositoryImpl.js +129 -0
  103. package/dist/infrastructure/repositories/CodeGraphRepositoryImpl.js.map +1 -0
  104. package/dist/infrastructure/repositories/index.d.ts +3 -0
  105. package/dist/infrastructure/repositories/index.d.ts.map +1 -0
  106. package/dist/infrastructure/repositories/index.js +7 -0
  107. package/dist/infrastructure/repositories/index.js.map +1 -0
  108. package/dist/infrastructure/storage/StorageFactory.d.ts +53 -0
  109. package/dist/infrastructure/storage/StorageFactory.d.ts.map +1 -0
  110. package/dist/infrastructure/storage/StorageFactory.js +150 -0
  111. package/dist/infrastructure/storage/StorageFactory.js.map +1 -0
  112. package/dist/infrastructure/storage/adapters/FileSystemStorage.d.ts +52 -0
  113. package/dist/infrastructure/storage/adapters/FileSystemStorage.d.ts.map +1 -0
  114. package/dist/infrastructure/storage/adapters/FileSystemStorage.js +315 -0
  115. package/dist/infrastructure/storage/adapters/FileSystemStorage.js.map +1 -0
  116. package/dist/infrastructure/storage/adapters/KuzuDBStorage.d.ts +52 -0
  117. package/dist/infrastructure/storage/adapters/KuzuDBStorage.d.ts.map +1 -0
  118. package/dist/infrastructure/storage/adapters/KuzuDBStorage.js +235 -0
  119. package/dist/infrastructure/storage/adapters/KuzuDBStorage.js.map +1 -0
  120. package/dist/infrastructure/storage/adapters/MemoryStorage.d.ts +37 -0
  121. package/dist/infrastructure/storage/adapters/MemoryStorage.d.ts.map +1 -0
  122. package/dist/infrastructure/storage/adapters/MemoryStorage.js +229 -0
  123. package/dist/infrastructure/storage/adapters/MemoryStorage.js.map +1 -0
  124. package/dist/infrastructure/storage/adapters/Neo4jStorage.d.ts +49 -0
  125. package/dist/infrastructure/storage/adapters/Neo4jStorage.d.ts.map +1 -0
  126. package/dist/infrastructure/storage/adapters/Neo4jStorage.js +222 -0
  127. package/dist/infrastructure/storage/adapters/Neo4jStorage.js.map +1 -0
  128. package/dist/infrastructure/storage/index.d.ts +6 -0
  129. package/dist/infrastructure/storage/index.d.ts.map +1 -0
  130. package/dist/infrastructure/storage/index.js +13 -0
  131. package/dist/infrastructure/storage/index.js.map +1 -0
  132. package/dist/infrastructure/storage/interfaces/StorageBase.d.ts +76 -0
  133. package/dist/infrastructure/storage/interfaces/StorageBase.d.ts.map +1 -0
  134. package/dist/infrastructure/storage/interfaces/StorageBase.js +116 -0
  135. package/dist/infrastructure/storage/interfaces/StorageBase.js.map +1 -0
  136. package/dist/interface/config/index.d.ts +102 -0
  137. package/dist/interface/config/index.d.ts.map +1 -0
  138. package/dist/interface/config/index.js +7 -0
  139. package/dist/interface/config/index.js.map +1 -0
  140. package/dist/interface/types/index.d.ts +425 -0
  141. package/dist/interface/types/index.d.ts.map +1 -0
  142. package/dist/interface/types/index.js +8 -0
  143. package/dist/interface/types/index.js.map +1 -0
  144. package/dist/interface/types/parser.d.ts +103 -0
  145. package/dist/interface/types/parser.d.ts.map +1 -0
  146. package/dist/interface/types/parser.js +7 -0
  147. package/dist/interface/types/parser.js.map +1 -0
  148. package/dist/interface/types/storage.d.ts +98 -0
  149. package/dist/interface/types/storage.d.ts.map +1 -0
  150. package/dist/interface/types/storage.js +7 -0
  151. package/dist/interface/types/storage.js.map +1 -0
  152. package/dist/orchestrator/test-linker.js +1 -1
  153. package/dist/orchestrator/test-linker.js.map +1 -1
  154. package/dist/server/CodeMapServer.d.ts +51 -0
  155. package/dist/server/CodeMapServer.d.ts.map +1 -0
  156. package/dist/server/CodeMapServer.js +146 -0
  157. package/dist/server/CodeMapServer.js.map +1 -0
  158. package/dist/server/handlers/AnalysisHandler.d.ts +82 -0
  159. package/dist/server/handlers/AnalysisHandler.d.ts.map +1 -0
  160. package/dist/server/handlers/AnalysisHandler.js +196 -0
  161. package/dist/server/handlers/AnalysisHandler.js.map +1 -0
  162. package/dist/server/handlers/QueryHandler.d.ts +57 -0
  163. package/dist/server/handlers/QueryHandler.d.ts.map +1 -0
  164. package/dist/server/handlers/QueryHandler.js +260 -0
  165. package/dist/server/handlers/QueryHandler.js.map +1 -0
  166. package/dist/server/index.d.ts +7 -0
  167. package/dist/server/index.d.ts.map +1 -0
  168. package/dist/server/index.js +13 -0
  169. package/dist/server/index.js.map +1 -0
  170. package/dist/server/routes/api.d.ts +8 -0
  171. package/dist/server/routes/api.d.ts.map +1 -0
  172. package/dist/server/routes/api.js +372 -0
  173. package/dist/server/routes/api.js.map +1 -0
  174. package/dist/server/types/index.d.ts +171 -0
  175. package/dist/server/types/index.d.ts.map +1 -0
  176. package/dist/server/types/index.js +7 -0
  177. package/dist/server/types/index.js.map +1 -0
  178. package/dist/types/index.d.ts +6 -372
  179. package/dist/types/index.d.ts.map +1 -1
  180. package/dist/types/index.js +9 -3
  181. package/dist/types/index.js.map +1 -1
  182. package/docs/AI_ASSISTANT_SETUP.md +68 -0
  183. package/docs/PUBLISHING.md +162 -0
  184. package/docs/README.md +37 -0
  185. package/docs/SETUP_GUIDE.md +91 -5
  186. package/docs/ai-guide/COMMANDS.md +369 -0
  187. package/docs/ai-guide/INTEGRATION.md +513 -0
  188. package/docs/ai-guide/OUTPUT.md +465 -0
  189. package/docs/ai-guide/PATTERNS.md +409 -0
  190. package/docs/ai-guide/PROMPTS.md +414 -0
  191. package/docs/ai-guide/QUICKSTART.md +114 -0
  192. package/docs/ai-guide/README.md +66 -0
  193. package/docs/archive/AI_INTEGRATION_GUIDE_ARCHIVED.md +7 -1
  194. package/docs/archive/ARCHIVE.md +39 -0
  195. package/docs/archive/MYCLAUDE_GUIDE.md +305 -0
  196. package/docs/archive/PUBLISH_NPM_DESIGN_V1.md +6 -0
  197. package/docs/archive/PUBLISH_NPM_DESIGN_V2.md +6 -0
  198. package/docs/archive/README.md +29 -0
  199. package/docs/archive/TASK_DESIGN_COVERAGE_REPORT.md +6 -0
  200. package/docs/archive/TEST_SUMMARY.md +140 -0
  201. package/docs/archive/comprehensive_test_report.md +337 -0
  202. package/docs/{CI_GATEWAY_DESIGN.md → archive/design-docs/CI_GATEWAY_DESIGN.md} +6 -0
  203. package/docs/{PUBLISH_NPM_DESIGN_FINAL.md → archive/design-docs/PUBLISH_NPM_DESIGN_FINAL.md} +7 -1
  204. package/docs/{REFACTOR_ARCHITECTURE_OVERVIEW.md → archive/design-docs/REFACTOR_ARCHITECTURE_OVERVIEW.md} +8 -2
  205. package/docs/{REFACTOR_CONFIDENCE_DESIGN.md → archive/design-docs/REFACTOR_CONFIDENCE_DESIGN.md} +6 -0
  206. package/docs/{REFACTOR_GIT_ANALYZER_DESIGN.md → archive/design-docs/REFACTOR_GIT_ANALYZER_DESIGN.md} +8 -2
  207. package/docs/{REFACTOR_ORCHESTRATOR_DESIGN.md → archive/design-docs/REFACTOR_ORCHESTRATOR_DESIGN.md} +6 -0
  208. package/docs/{REFACTOR_RESULT_FUSION_DESIGN.md → archive/design-docs/REFACTOR_RESULT_FUSION_DESIGN.md} +6 -0
  209. package/docs/{REFACTOR_TEST_LINKER_DESIGN.md → archive/design-docs/REFACTOR_TEST_LINKER_DESIGN.md} +6 -0
  210. package/docs/archive/myclaude.md +1084 -0
  211. package/docs/archive/plans/2026-03-14-go-language-support-design.md +92 -0
  212. package/docs/{REFACTOR_REQUIREMENTS.md → archive/product-specs/REFACTOR_REQUIREMENTS.md} +11 -5
  213. package/docs/archive/scenario-2-deps-analysis.md +353 -0
  214. package/docs/archive/test-report-symbol-search.md +384 -0
  215. package/docs/archive/test-scenario-4-complexity-analysis.md +460 -0
  216. package/docs/archive/test_report_scenario5.md +615 -0
  217. package/docs/archive/test_scenario_3_impact_analysis_report.md +520 -0
  218. package/docs/design-docs/README.md +26 -0
  219. package/docs/exec-plans/MVP3-IMPLEMENTATION-ROADMAP.md +524 -0
  220. package/docs/exec-plans/README.md +29 -0
  221. package/docs/exec-plans/active/.gitkeep +0 -0
  222. package/docs/exec-plans/completed/.gitkeep +0 -0
  223. package/docs/{plans/POST_TASK_PLAN.md → exec-plans/completed/2026-03-03-post-task-plan.md} +9 -3
  224. package/docs/exec-plans/completed/harness-engineering-rollout.md +184 -0
  225. package/docs/exec-plans/tech-debt/.gitkeep +0 -0
  226. package/docs/exec-plans/tech-debt/2026-03-15-lint-guardrail-gap.md +30 -0
  227. package/docs/generated/README.md +19 -0
  228. package/docs/product-specs/MVP3-ARCHITECTURE-COMPARISON.md +504 -0
  229. package/docs/product-specs/MVP3-ARCHITECTURE-REDESIGN-PRD.md +322 -0
  230. package/docs/product-specs/MVP3-ARCHITECTURE-REDESIGN-TECH-PRD.md +1374 -0
  231. package/docs/product-specs/README.md +22 -0
  232. package/docs/references/README.md +15 -0
  233. package/docs/references/tmp.md +527 -0
  234. package/docs/rules/README.md +16 -0
  235. package/docs/rules/architecture-guardrails.md +349 -0
  236. package/docs/rules/code-quality-redlines.md +321 -0
  237. package/docs/rules/deployment.md +23 -0
  238. package/docs/rules/engineering-with-codex-openai.md +202 -0
  239. package/docs/rules/testing.md +73 -0
  240. package/docs/rules/validation.md +39 -0
  241. package/package.json +19 -6
  242. package/docs/OMC_TEAM_DEBUG_REPORT.md +0 -285
  243. /package/docs/{plans/archive → exec-plans/completed}/2026-03-03-deps-path-extension-fix.md +0 -0
@@ -0,0 +1,222 @@
1
+ // [META] since:2026-03 | owner:architecture-team | stable:false
2
+ // [WHY] Neo4j storage adapter - enterprise graph database backend
3
+ // ============================================
4
+ // Neo4j 存储适配器 - 企业级图数据库后端
5
+ // ============================================
6
+ import { StorageBase, StorageError } from '../interfaces/StorageBase.js';
7
+ /**
8
+ * Neo4j 存储适配器(可选依赖)
9
+ *
10
+ * 安装:npm install neo4j-driver
11
+ *
12
+ * 特点:
13
+ * - 企业级图数据库
14
+ * - Cypher 查询语言
15
+ * - 分布式部署支持
16
+ * - 适合团队协作场景
17
+ *
18
+ * TODO-DEBT [L1] [日期:2026-03-17] [作者:AI] [原因:MVP阶段暂不实现完整功能]
19
+ * 问题:目前使用内存 fallback 实现
20
+ * 风险:无法连接真实 Neo4j 实例
21
+ * 偿还计划:V1.0 实现完整 Neo4j 集成
22
+ */
23
+ export class Neo4jStorage extends StorageBase {
24
+ type = 'neo4j';
25
+ /** Neo4j 驱动 */
26
+ driver = null;
27
+ /** 内存 fallback */
28
+ memoryGraph = this.createEmptyGraph();
29
+ /** 存储配置 */
30
+ dbConfig;
31
+ constructor(config) {
32
+ super();
33
+ this.dbConfig = config;
34
+ }
35
+ // ============================================
36
+ // 生命周期管理
37
+ // ============================================
38
+ async doInitialize() {
39
+ try {
40
+ // 动态导入 neo4j-driver
41
+ // @ts-expect-error neo4j-driver is optional dependency
42
+ const neo4j = await import('neo4j-driver');
43
+ const uri = this.dbConfig.uri ?? 'bolt://localhost:7687';
44
+ const username = this.dbConfig.username ?? 'neo4j';
45
+ const password = this.dbConfig.password ?? 'password';
46
+ this.driver = neo4j.driver(uri, neo4j.auth.basic(username, password));
47
+ // 验证连接
48
+ const session = this.driver.session();
49
+ await session.run('RETURN 1');
50
+ await session.close();
51
+ }
52
+ catch {
53
+ // eslint-disable-next-line no-console
54
+ console.warn('Neo4j not available, falling back to memory mode');
55
+ this.memoryGraph = this.createEmptyGraph();
56
+ }
57
+ }
58
+ async doClose() {
59
+ if (this.driver && typeof this.driver.close === 'function') {
60
+ await this.driver.close();
61
+ }
62
+ this.driver = null;
63
+ }
64
+ // ============================================
65
+ // 项目级别操作
66
+ // ============================================
67
+ async saveCodeGraph(graph) {
68
+ this.ensureInitialized();
69
+ if (!this.driver) {
70
+ this.memoryGraph = {
71
+ project: { ...graph.project },
72
+ modules: [...graph.modules],
73
+ symbols: [...graph.symbols],
74
+ dependencies: [...graph.dependencies],
75
+ };
76
+ return;
77
+ }
78
+ // TODO: 实现 Neo4j 持久化
79
+ throw new StorageError('Neo4j persistence not yet implemented', 'NOT_IMPLEMENTED');
80
+ }
81
+ async loadCodeGraph() {
82
+ this.ensureInitialized();
83
+ if (!this.driver) {
84
+ return {
85
+ project: { ...this.memoryGraph.project },
86
+ modules: [...this.memoryGraph.modules],
87
+ symbols: [...this.memoryGraph.symbols],
88
+ dependencies: [...this.memoryGraph.dependencies],
89
+ };
90
+ }
91
+ // TODO: 实现从 Neo4j 加载
92
+ throw new StorageError('Neo4j loading not yet implemented', 'NOT_IMPLEMENTED');
93
+ }
94
+ async deleteProject() {
95
+ this.ensureInitialized();
96
+ this.memoryGraph = this.createEmptyGraph();
97
+ // TODO: 删除 Neo4j 数据
98
+ }
99
+ // ============================================
100
+ // 增量更新
101
+ // ============================================
102
+ async updateModule(module) {
103
+ this.ensureInitialized();
104
+ if (!this.driver) {
105
+ const index = this.memoryGraph.modules.findIndex(m => m.id === module.id);
106
+ if (index >= 0) {
107
+ this.memoryGraph.modules[index] = { ...module };
108
+ }
109
+ else {
110
+ this.memoryGraph.modules.push({ ...module });
111
+ }
112
+ return;
113
+ }
114
+ // TODO: 实现 Neo4j 更新
115
+ }
116
+ async deleteModule(moduleId) {
117
+ this.ensureInitialized();
118
+ if (!this.driver) {
119
+ this.memoryGraph.modules = this.memoryGraph.modules.filter(m => m.id !== moduleId);
120
+ this.memoryGraph.symbols = this.memoryGraph.symbols.filter(s => s.moduleId !== moduleId);
121
+ this.memoryGraph.dependencies = this.memoryGraph.dependencies.filter(d => d.sourceId !== moduleId && d.targetId !== moduleId);
122
+ return;
123
+ }
124
+ // TODO: 实现 Neo4j 删除
125
+ }
126
+ // ============================================
127
+ // 查询操作
128
+ // ============================================
129
+ async findModuleById(id) {
130
+ this.ensureInitialized();
131
+ if (!this.driver) {
132
+ return this.memoryGraph.modules.find(m => m.id === id) ?? null;
133
+ }
134
+ return null;
135
+ }
136
+ async findModulesByPath(path) {
137
+ this.ensureInitialized();
138
+ if (!this.driver) {
139
+ return this.memoryGraph.modules.filter(m => m.path.includes(path));
140
+ }
141
+ return [];
142
+ }
143
+ async findSymbolByName(name) {
144
+ this.ensureInitialized();
145
+ if (!this.driver) {
146
+ return this.memoryGraph.symbols.filter(s => s.name.includes(name));
147
+ }
148
+ return [];
149
+ }
150
+ async findSymbolById(id) {
151
+ this.ensureInitialized();
152
+ if (!this.driver) {
153
+ return this.memoryGraph.symbols.find(s => s.id === id) ?? null;
154
+ }
155
+ return null;
156
+ }
157
+ async findDependencies(moduleId) {
158
+ this.ensureInitialized();
159
+ if (!this.driver) {
160
+ return this.memoryGraph.dependencies.filter(d => d.sourceId === moduleId);
161
+ }
162
+ return [];
163
+ }
164
+ async findDependents(moduleId) {
165
+ this.ensureInitialized();
166
+ if (!this.driver) {
167
+ return this.memoryGraph.dependencies.filter(d => d.targetId === moduleId);
168
+ }
169
+ return [];
170
+ }
171
+ async findCallers(_functionId) {
172
+ this.ensureInitialized();
173
+ return []; // TODO
174
+ }
175
+ async findCallees(_functionId) {
176
+ this.ensureInitialized();
177
+ return []; // TODO
178
+ }
179
+ // ============================================
180
+ // 分析操作
181
+ // ============================================
182
+ async detectCycles() {
183
+ this.ensureInitialized();
184
+ return []; // TODO
185
+ }
186
+ async calculateImpact(moduleId, depth) {
187
+ this.ensureInitialized();
188
+ return {
189
+ rootModule: moduleId,
190
+ affectedModules: [],
191
+ depth,
192
+ };
193
+ }
194
+ async getStatistics() {
195
+ this.ensureInitialized();
196
+ return {
197
+ totalModules: this.memoryGraph.modules.length,
198
+ totalSymbols: this.memoryGraph.symbols.length,
199
+ totalDependencies: this.memoryGraph.dependencies.length,
200
+ totalLines: this.memoryGraph.modules.reduce((sum, m) => sum + m.stats.lines, 0),
201
+ averageComplexity: 0,
202
+ };
203
+ }
204
+ // ============================================
205
+ // 私有方法
206
+ // ============================================
207
+ createEmptyGraph() {
208
+ return {
209
+ project: {
210
+ id: '',
211
+ name: '',
212
+ rootPath: this.projectPath ?? '',
213
+ createdAt: new Date(),
214
+ updatedAt: new Date(),
215
+ },
216
+ modules: [],
217
+ symbols: [],
218
+ dependencies: [],
219
+ };
220
+ }
221
+ }
222
+ //# sourceMappingURL=Neo4jStorage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Neo4jStorage.js","sourceRoot":"","sources":["../../../../src/infrastructure/storage/adapters/Neo4jStorage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ export { StorageBase, StorageError } from './interfaces/StorageBase.js';
2
+ export { StorageFactory, storageFactory } from './StorageFactory.js';
3
+ export { FileSystemStorage } from './adapters/FileSystemStorage.js';
4
+ export { MemoryStorage } from './adapters/MemoryStorage.js';
5
+ export type { IStorage, IStorageFactory, StorageType, StorageConfig, SearchOptions, SearchResult, Cycle, ImpactResult, ProjectStatistics, } from '../../interface/types/storage.js';
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGxE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAQ5D,YAAY,EACV,QAAQ,EACR,eAAe,EACf,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,iBAAiB,GAClB,MAAM,kCAAkC,CAAC"}
@@ -0,0 +1,13 @@
1
+ // [META] since:2026-03 | owner:architecture-team | stable:true
2
+ // [WHY] Storage module exports - central entry point for storage layer
3
+ // ============================================
4
+ // 存储模块导出 - 存储层的中央入口点
5
+ // ============================================
6
+ // 接口和基类
7
+ export { StorageBase, StorageError } from './interfaces/StorageBase.js';
8
+ // 工厂
9
+ export { StorageFactory, storageFactory } from './StorageFactory.js';
10
+ // 适配器
11
+ export { FileSystemStorage } from './adapters/FileSystemStorage.js';
12
+ export { MemoryStorage } from './adapters/MemoryStorage.js';
13
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,uEAAuE;AACvE,+CAA+C;AAC/C,qBAAqB;AACrB,+CAA+C;AAE/C,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAExE,KAAK;AACL,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErE,MAAM;AACN,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}
@@ -0,0 +1,76 @@
1
+ import type { IStorage, StorageType, StorageConfig, SearchOptions, SearchResult, Cycle, ImpactResult, ProjectStatistics } from '../../../interface/types/storage.js';
2
+ import type { CodeGraph, Module, Symbol, Dependency } from '../../../interface/types/index.js';
3
+ /**
4
+ * 存储操作错误
5
+ */
6
+ export declare class StorageError extends Error {
7
+ readonly code: string;
8
+ readonly cause?: unknown | undefined;
9
+ constructor(message: string, code: string, cause?: unknown | undefined);
10
+ }
11
+ /**
12
+ * 存储抽象基类
13
+ *
14
+ * 为所有存储后端提供:
15
+ * - 通用的错误处理
16
+ * - 连接状态管理
17
+ * - 生命周期管理
18
+ * - 默认实现的可选方法
19
+ */
20
+ export declare abstract class StorageBase implements IStorage {
21
+ /** 存储类型标识 */
22
+ abstract readonly type: StorageType;
23
+ /** 项目路径 */
24
+ protected projectPath: string | null;
25
+ /** 初始化状态 */
26
+ protected isInitialized: boolean;
27
+ /** 存储配置 */
28
+ protected config: StorageConfig | null;
29
+ /**
30
+ * 初始化存储
31
+ * @param projectPath - 项目路径
32
+ */
33
+ initialize(projectPath: string): Promise<void>;
34
+ /**
35
+ * 子类实现的具体初始化逻辑
36
+ */
37
+ protected abstract doInitialize(): Promise<void>;
38
+ /**
39
+ * 关闭存储连接
40
+ */
41
+ close(): Promise<void>;
42
+ /**
43
+ * 子类实现的具体关闭逻辑
44
+ */
45
+ protected abstract doClose(): Promise<void>;
46
+ /**
47
+ * 确保已初始化
48
+ */
49
+ protected ensureInitialized(): void;
50
+ abstract saveCodeGraph(graph: CodeGraph): Promise<void>;
51
+ abstract loadCodeGraph(): Promise<CodeGraph>;
52
+ abstract deleteProject(): Promise<void>;
53
+ abstract updateModule(module: Module): Promise<void>;
54
+ abstract deleteModule(moduleId: string): Promise<void>;
55
+ abstract findModuleById(id: string): Promise<Module | null>;
56
+ abstract findModulesByPath(path: string): Promise<Module[]>;
57
+ abstract findSymbolByName(name: string): Promise<Symbol[]>;
58
+ abstract findSymbolById(id: string): Promise<Symbol | null>;
59
+ abstract findDependencies(moduleId: string): Promise<Dependency[]>;
60
+ abstract findDependents(moduleId: string): Promise<Dependency[]>;
61
+ abstract findCallers(functionId: string): Promise<Symbol[]>;
62
+ abstract findCallees(functionId: string): Promise<Symbol[]>;
63
+ /**
64
+ * 模糊搜索 - 默认实现基于符号名称
65
+ * 子类可以覆盖以提供更高效的实现
66
+ */
67
+ search(query: string, options: SearchOptions): Promise<SearchResult[]>;
68
+ /**
69
+ * 计算相关性分数
70
+ */
71
+ protected calculateRelevanceScore(name: string, query: string): number;
72
+ abstract detectCycles(): Promise<Cycle[]>;
73
+ abstract calculateImpact(moduleId: string, depth: number): Promise<ImpactResult>;
74
+ abstract getStatistics(): Promise<ProjectStatistics>;
75
+ }
76
+ //# sourceMappingURL=StorageBase.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StorageBase.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/storage/interfaces/StorageBase.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,116 @@
1
+ // [META] since:2026-03 | owner:architecture-team | stable:true
2
+ // [WHY] Storage abstraction base class - provides common functionality for all storage backends
3
+ // ============================================
4
+ // 存储抽象基类 - 为所有存储后端提供通用功能
5
+ // ============================================
6
+ /**
7
+ * 存储操作错误
8
+ */
9
+ export class StorageError extends Error {
10
+ code;
11
+ cause;
12
+ constructor(message, code, cause) {
13
+ super(message);
14
+ this.code = code;
15
+ this.cause = cause;
16
+ this.name = 'StorageError';
17
+ }
18
+ }
19
+ /**
20
+ * 存储抽象基类
21
+ *
22
+ * 为所有存储后端提供:
23
+ * - 通用的错误处理
24
+ * - 连接状态管理
25
+ * - 生命周期管理
26
+ * - 默认实现的可选方法
27
+ */
28
+ export class StorageBase {
29
+ /** 项目路径 */
30
+ projectPath = null;
31
+ /** 初始化状态 */
32
+ isInitialized = false;
33
+ /** 存储配置 */
34
+ config = null;
35
+ // ============================================
36
+ // 生命周期管理
37
+ // ============================================
38
+ /**
39
+ * 初始化存储
40
+ * @param projectPath - 项目路径
41
+ */
42
+ async initialize(projectPath) {
43
+ this.projectPath = projectPath;
44
+ await this.doInitialize();
45
+ this.isInitialized = true;
46
+ }
47
+ /**
48
+ * 关闭存储连接
49
+ */
50
+ async close() {
51
+ if (!this.isInitialized) {
52
+ return;
53
+ }
54
+ await this.doClose();
55
+ this.isInitialized = false;
56
+ this.projectPath = null;
57
+ }
58
+ /**
59
+ * 确保已初始化
60
+ */
61
+ ensureInitialized() {
62
+ if (!this.isInitialized) {
63
+ throw new StorageError('Storage not initialized. Call initialize() first.', 'STORAGE_NOT_INITIALIZED');
64
+ }
65
+ }
66
+ // ============================================
67
+ // 搜索操作 (默认实现)
68
+ // ============================================
69
+ /**
70
+ * 模糊搜索 - 默认实现基于符号名称
71
+ * 子类可以覆盖以提供更高效的实现
72
+ */
73
+ async search(query, options) {
74
+ this.ensureInitialized();
75
+ const symbols = await this.findSymbolByName(query);
76
+ const limit = options.limit ?? 50;
77
+ const offset = options.offset ?? 0;
78
+ let results = symbols.map(symbol => ({
79
+ id: symbol.id,
80
+ name: symbol.name,
81
+ type: 'symbol',
82
+ path: symbol.location?.file,
83
+ score: this.calculateRelevanceScore(symbol.name, query),
84
+ }));
85
+ // 过滤
86
+ if (options.type && options.type !== 'symbol') {
87
+ results = results.filter(r => r.type === options.type);
88
+ }
89
+ // 排序和分页
90
+ results = results
91
+ .sort((a, b) => b.score - a.score)
92
+ .slice(offset, offset + limit);
93
+ return results;
94
+ }
95
+ /**
96
+ * 计算相关性分数
97
+ */
98
+ calculateRelevanceScore(name, query) {
99
+ const lowerName = name.toLowerCase();
100
+ const lowerQuery = query.toLowerCase();
101
+ if (name === query)
102
+ return 1.0;
103
+ if (lowerName === lowerQuery)
104
+ return 0.95;
105
+ if (name.startsWith(query))
106
+ return 0.9;
107
+ if (lowerName.startsWith(lowerQuery))
108
+ return 0.85;
109
+ if (name.includes(query))
110
+ return 0.7;
111
+ if (lowerName.includes(lowerQuery))
112
+ return 0.6;
113
+ return 0.5;
114
+ }
115
+ }
116
+ //# sourceMappingURL=StorageBase.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StorageBase.js","sourceRoot":"","sources":["../../../../src/infrastructure/storage/interfaces/StorageBase.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,102 @@
1
+ import type { StorageConfig } from '../types/storage.js';
2
+ /** CLI 配置 */
3
+ export interface CodemapConfig {
4
+ mode: 'fast' | 'smart';
5
+ include: string[];
6
+ exclude: string[];
7
+ output: string;
8
+ watch: boolean;
9
+ }
10
+ /** 进度信息 */
11
+ export interface ProgressInfo {
12
+ current: number;
13
+ total: number;
14
+ percentage: number;
15
+ currentFile?: string;
16
+ }
17
+ /** 生成请求 */
18
+ export interface GenerateRequest {
19
+ /** 项目根目录 */
20
+ projectPath: string;
21
+ /** 包含模式 */
22
+ include?: string[];
23
+ /** 排除模式 */
24
+ exclude?: string[];
25
+ /** 分析模式 */
26
+ mode: 'fast' | 'smart' | 'hybrid';
27
+ /** 存储配置 */
28
+ storage?: StorageConfig;
29
+ /** 输出配置 */
30
+ output?: {
31
+ formats: ('aimap' | 'context' | 'json' | 'deps-graph')[];
32
+ directory: string;
33
+ };
34
+ /** 是否启用进度回调 */
35
+ enableProgress?: boolean;
36
+ /** 进度回调 */
37
+ onProgress?: (progress: ProgressInfo) => void;
38
+ }
39
+ /** 生成响应 */
40
+ export interface GenerateResponse {
41
+ /** 成功状态 */
42
+ success: boolean;
43
+ /** 代码图 */
44
+ codeGraph: unknown;
45
+ /** 生成的文件路径 */
46
+ generatedFiles: string[];
47
+ /** 统计信息 */
48
+ statistics: {
49
+ totalFiles: number;
50
+ parsedFiles: number;
51
+ failedFiles: number;
52
+ totalSymbols: number;
53
+ totalDependencies: number;
54
+ duration: number;
55
+ };
56
+ /** 警告信息 */
57
+ warnings?: string[];
58
+ /** 错误信息 */
59
+ error?: string;
60
+ }
61
+ /** 查询符号请求 */
62
+ export interface QuerySymbolRequest {
63
+ name: string;
64
+ projectPath: string;
65
+ options?: {
66
+ fuzzy?: boolean;
67
+ limit?: number;
68
+ };
69
+ }
70
+ /** 查询符号响应 */
71
+ export interface QuerySymbolResponse {
72
+ success: boolean;
73
+ symbols: unknown[];
74
+ error?: string;
75
+ }
76
+ /** 影响分析请求 */
77
+ export interface AnalyzeImpactRequest {
78
+ moduleId: string;
79
+ depth: number;
80
+ projectPath: string;
81
+ }
82
+ /** 影响分析响应 */
83
+ export interface AnalyzeImpactResponse {
84
+ success: boolean;
85
+ result?: {
86
+ rootModule: string;
87
+ affectedModules: unknown[];
88
+ depth: number;
89
+ };
90
+ error?: string;
91
+ }
92
+ /** 循环依赖检测请求 */
93
+ export interface DetectCyclesRequest {
94
+ projectPath: string;
95
+ }
96
+ /** 循环依赖检测响应 */
97
+ export interface DetectCyclesResponse {
98
+ success: boolean;
99
+ cycles?: unknown[];
100
+ error?: string;
101
+ }
102
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interface/config/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ // [META] since:2026-03 | owner:architecture-team | stable:true
2
+ // [WHY] Configuration type definitions for CodeMap
3
+ // ============================================
4
+ // 配置类型定义
5
+ // ============================================
6
+ export {};
7
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/config/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,mDAAmD;AACnD,+CAA+C;AAC/C,SAAS;AACT,+CAA+C"}