toolnet-memory 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 (329) hide show
  1. package/.env.example +28 -0
  2. package/README.md +147 -0
  3. package/bin/toolnet-memory +415 -0
  4. package/dist/packages/cli/commands.js +1 -0
  5. package/dist/packages/cli/index.js +1 -0
  6. package/dist/packages/sdk/client.js +78 -0
  7. package/dist/packages/sdk/index.js +1 -0
  8. package/dist/packages/sdk/types.js +1 -0
  9. package/dist/src/api/index.js +1 -0
  10. package/dist/src/api/routes/health.js +1 -0
  11. package/dist/src/api/routes/index.js +1 -0
  12. package/dist/src/api/routes/memory.js +1 -0
  13. package/dist/src/api/routes/projects.js +1 -0
  14. package/dist/src/api/routes/search.js +1 -0
  15. package/dist/src/api/server.js +1 -0
  16. package/dist/src/capture/activity-capture.js +21 -0
  17. package/dist/src/capture/command-capture.js +12 -0
  18. package/dist/src/capture/error-capture.js +14 -0
  19. package/dist/src/capture/event-deduplicator.js +28 -0
  20. package/dist/src/capture/event-queue.js +20 -0
  21. package/dist/src/capture/file-capture.js +23 -0
  22. package/dist/src/capture/index.js +8 -0
  23. package/dist/src/capture/session-capture.js +18 -0
  24. package/dist/src/capture/tool-capture.js +13 -0
  25. package/dist/src/code-intelligence/analysis/analysis-engine.js +26 -0
  26. package/dist/src/code-intelligence/analysis/dead-code-analyzer.js +127 -0
  27. package/dist/src/code-intelligence/analysis/dependency-analyzer.js +66 -0
  28. package/dist/src/code-intelligence/analysis/index.js +4 -0
  29. package/dist/src/code-intelligence/analysis/types.js +1 -0
  30. package/dist/src/code-intelligence/architecture/architecture-engine.js +48 -0
  31. package/dist/src/code-intelligence/architecture/clusters.js +322 -0
  32. package/dist/src/code-intelligence/architecture/entry-points.js +150 -0
  33. package/dist/src/code-intelligence/architecture/hotspots.js +136 -0
  34. package/dist/src/code-intelligence/architecture/index.js +6 -0
  35. package/dist/src/code-intelligence/architecture/layers.js +197 -0
  36. package/dist/src/code-intelligence/architecture/types.js +1 -0
  37. package/dist/src/code-intelligence/chunks/index.js +2 -0
  38. package/dist/src/code-intelligence/chunks/smart-chunker.js +125 -0
  39. package/dist/src/code-intelligence/chunks/types.js +1 -0
  40. package/dist/src/code-intelligence/git/git-diff.js +109 -0
  41. package/dist/src/code-intelligence/git/index.js +1 -0
  42. package/dist/src/code-intelligence/graph/architecture.js +26 -0
  43. package/dist/src/code-intelligence/graph/graph-builder.js +213 -0
  44. package/dist/src/code-intelligence/graph/graph-store.js +57 -0
  45. package/dist/src/code-intelligence/graph/index.js +1 -0
  46. package/dist/src/code-intelligence/graph/relationships.js +1 -0
  47. package/dist/src/code-intelligence/graph/trace.js +65 -0
  48. package/dist/src/code-intelligence/impact/blast-radius.js +160 -0
  49. package/dist/src/code-intelligence/impact/change-mapper.js +69 -0
  50. package/dist/src/code-intelligence/impact/edit-tool-detector.js +92 -0
  51. package/dist/src/code-intelligence/impact/impact-analyzer.js +60 -0
  52. package/dist/src/code-intelligence/impact/impact-guard.js +33 -0
  53. package/dist/src/code-intelligence/impact/index.js +5 -0
  54. package/dist/src/code-intelligence/incremental/file-hash.js +8 -0
  55. package/dist/src/code-intelligence/incremental/incremental-indexer.js +106 -0
  56. package/dist/src/code-intelligence/incremental/manifest-builder.js +19 -0
  57. package/dist/src/code-intelligence/incremental/manifest.js +31 -0
  58. package/dist/src/code-intelligence/index.js +23 -0
  59. package/dist/src/code-intelligence/indexer/file-watcher.js +1 -0
  60. package/dist/src/code-intelligence/indexer/incremental-indexer.js +1 -0
  61. package/dist/src/code-intelligence/indexer/index.js +1 -0
  62. package/dist/src/code-intelligence/indexer/repository-indexer.js +31 -0
  63. package/dist/src/code-intelligence/indexer/repository-scanner.js +50 -0
  64. package/dist/src/code-intelligence/parsers/index.js +1 -0
  65. package/dist/src/code-intelligence/parsers/tree-sitter/index.js +1 -0
  66. package/dist/src/code-intelligence/parsers/tree-sitter/languages.js +1 -0
  67. package/dist/src/code-intelligence/parsers/tree-sitter/parser.js +1 -0
  68. package/dist/src/code-intelligence/parsers/typescript-parser.js +190 -0
  69. package/dist/src/code-intelligence/query/graph-query-engine.js +275 -0
  70. package/dist/src/code-intelligence/query/index.js +2 -0
  71. package/dist/src/code-intelligence/query/types.js +1 -0
  72. package/dist/src/code-intelligence/resolution/index.js +2 -0
  73. package/dist/src/code-intelligence/resolution/types.js +1 -0
  74. package/dist/src/code-intelligence/resolution/typescript-resolver.js +316 -0
  75. package/dist/src/code-intelligence/rich/index.js +1 -0
  76. package/dist/src/code-intelligence/rich/rich-graph-enricher.js +463 -0
  77. package/dist/src/code-intelligence/semantic/index.js +2 -0
  78. package/dist/src/code-intelligence/semantic/semantic-code-engine.js +213 -0
  79. package/dist/src/code-intelligence/semantic/source-priority.js +22 -0
  80. package/dist/src/code-intelligence/symbols/index.js +1 -0
  81. package/dist/src/code-intelligence/symbols/reference-resolver.js +21 -0
  82. package/dist/src/code-intelligence/symbols/symbol-extractor.js +1 -0
  83. package/dist/src/code-intelligence/test-analysis.js +72 -0
  84. package/dist/src/code-intelligence/test-architecture.js +67 -0
  85. package/dist/src/code-intelligence/test-impact.js +47 -0
  86. package/dist/src/code-intelligence/test-incremental.js +24 -0
  87. package/dist/src/code-intelligence/test-index.js +39 -0
  88. package/dist/src/code-intelligence/test-resolution.js +54 -0
  89. package/dist/src/code-intelligence/test-rich-graph.js +48 -0
  90. package/dist/src/code-intelligence/test-semantic.js +57 -0
  91. package/dist/src/code-intelligence/test-visualization.js +36 -0
  92. package/dist/src/code-intelligence/types.js +1 -0
  93. package/dist/src/code-intelligence/visualization/index.js +2 -0
  94. package/dist/src/code-intelligence/visualization/types.js +1 -0
  95. package/dist/src/code-intelligence/visualization/visualization-builder.js +104 -0
  96. package/dist/src/core/config.js +66 -0
  97. package/dist/src/core/global-env.js +70 -0
  98. package/dist/src/core/importance.js +30 -0
  99. package/dist/src/core/index.js +5 -0
  100. package/dist/src/core/memory-engine.js +183 -0
  101. package/dist/src/core/project-manager.js +243 -0
  102. package/dist/src/core/types.js +1 -0
  103. package/dist/src/embeddings/batch-embedder.js +1 -0
  104. package/dist/src/embeddings/cache.js +1 -0
  105. package/dist/src/embeddings/embedder.js +51 -0
  106. package/dist/src/embeddings/index.js +4 -0
  107. package/dist/src/embeddings/local.js +37 -0
  108. package/dist/src/embeddings/provider.js +1 -0
  109. package/dist/src/embeddings/remote.js +76 -0
  110. package/dist/src/embeddings/test-connection.js +16 -0
  111. package/dist/src/hooks/after-edit.js +3 -0
  112. package/dist/src/hooks/after-tool.js +3 -0
  113. package/dist/src/hooks/auto-context.js +68 -0
  114. package/dist/src/hooks/auto-impact-guard.js +94 -0
  115. package/dist/src/hooks/auto-retrieval.js +27 -0
  116. package/dist/src/hooks/before-agent.js +18 -0
  117. package/dist/src/hooks/before-compact.js +3 -0
  118. package/dist/src/hooks/before-edit.js +20 -0
  119. package/dist/src/hooks/index.js +11 -0
  120. package/dist/src/hooks/runtime.js +110 -0
  121. package/dist/src/hooks/session-end.js +3 -0
  122. package/dist/src/hooks/session-start.js +3 -0
  123. package/dist/src/index.js +22 -0
  124. package/dist/src/mcp/bootstrap.js +68 -0
  125. package/dist/src/mcp/context.js +1 -0
  126. package/dist/src/mcp/index.js +3 -0
  127. package/dist/src/mcp/server.js +45 -0
  128. package/dist/src/mcp/tools/analyze-impact.js +41 -0
  129. package/dist/src/mcp/tools/dead-code.js +55 -0
  130. package/dist/src/mcp/tools/find-callers.js +24 -0
  131. package/dist/src/mcp/tools/find-dependencies.js +57 -0
  132. package/dist/src/mcp/tools/find-symbol.js +7 -0
  133. package/dist/src/mcp/tools/get-architecture.js +11 -0
  134. package/dist/src/mcp/tools/graph-dependents.js +24 -0
  135. package/dist/src/mcp/tools/graph-neighborhood.js +58 -0
  136. package/dist/src/mcp/tools/graph-path.js +43 -0
  137. package/dist/src/mcp/tools/graph-query-utils.js +32 -0
  138. package/dist/src/mcp/tools/impact-guard.js +34 -0
  139. package/dist/src/mcp/tools/index-repository.js +1 -0
  140. package/dist/src/mcp/tools/index.js +20 -0
  141. package/dist/src/mcp/tools/memory-decisions.js +1 -0
  142. package/dist/src/mcp/tools/memory-forget.js +14 -0
  143. package/dist/src/mcp/tools/memory-recent.js +1 -0
  144. package/dist/src/mcp/tools/memory-remember.js +33 -0
  145. package/dist/src/mcp/tools/memory-rules.js +1 -0
  146. package/dist/src/mcp/tools/memory-search.js +18 -0
  147. package/dist/src/mcp/tools/memory-todos.js +1 -0
  148. package/dist/src/mcp/tools/project-context.js +25 -0
  149. package/dist/src/mcp/tools/search-code.js +21 -0
  150. package/dist/src/mcp/tools/semantic-code-search.js +33 -0
  151. package/dist/src/mcp/tools/snapshot-create.js +13 -0
  152. package/dist/src/mcp/tools/snapshot-list.js +7 -0
  153. package/dist/src/mcp/tools/snapshot-restore.js +13 -0
  154. package/dist/src/mcp/tools/trace-calls.js +37 -0
  155. package/dist/src/memory/activity.js +5 -0
  156. package/dist/src/memory/conflict-detector.js +105 -0
  157. package/dist/src/memory/consolidator.js +104 -0
  158. package/dist/src/memory/decay.js +59 -0
  159. package/dist/src/memory/decisions.js +3 -0
  160. package/dist/src/memory/deduplicate.js +25 -0
  161. package/dist/src/memory/index.js +11 -0
  162. package/dist/src/memory/maintenance.js +16 -0
  163. package/dist/src/memory/remember.js +3 -0
  164. package/dist/src/memory/rules.js +3 -0
  165. package/dist/src/memory/search.js +3 -0
  166. package/dist/src/memory/summaries.js +1 -0
  167. package/dist/src/memory/todos.js +3 -0
  168. package/dist/src/processor/decision-extractor.js +13 -0
  169. package/dist/src/processor/importance-scorer.js +22 -0
  170. package/dist/src/processor/index.js +7 -0
  171. package/dist/src/processor/memory-extractor.js +59 -0
  172. package/dist/src/processor/memory-processor.js +105 -0
  173. package/dist/src/processor/rule-extractor.js +13 -0
  174. package/dist/src/processor/summarizer.js +71 -0
  175. package/dist/src/processor/todo-extractor.js +12 -0
  176. package/dist/src/production/config-check.js +34 -0
  177. package/dist/src/production/doctor.js +58 -0
  178. package/dist/src/production/full-index.js +114 -0
  179. package/dist/src/production/health.js +58 -0
  180. package/dist/src/production/index-pipeline.js +151 -0
  181. package/dist/src/production/index.js +4 -0
  182. package/dist/src/production/project-lock.js +95 -0
  183. package/dist/src/production/project-status.js +16 -0
  184. package/dist/src/production/recovery.js +15 -0
  185. package/dist/src/production/snapshot-cli.js +58 -0
  186. package/dist/src/project-manual/cli.js +77 -0
  187. package/dist/src/project-manual/index.js +2 -0
  188. package/dist/src/project-manual/manager.js +147 -0
  189. package/dist/src/project-manual/types.js +1 -0
  190. package/dist/src/retrieval/bm25/index.js +1 -0
  191. package/dist/src/retrieval/bm25/search.js +1 -0
  192. package/dist/src/retrieval/bm25.js +30 -0
  193. package/dist/src/retrieval/context-budget.js +1 -0
  194. package/dist/src/retrieval/context-builder.js +22 -0
  195. package/dist/src/retrieval/graph/index.js +1 -0
  196. package/dist/src/retrieval/graph/search.js +1 -0
  197. package/dist/src/retrieval/hybrid/hybrid-search.js +1 -0
  198. package/dist/src/retrieval/hybrid/index.js +1 -0
  199. package/dist/src/retrieval/hybrid-search.js +68 -0
  200. package/dist/src/retrieval/importance.js +16 -0
  201. package/dist/src/retrieval/index.js +12 -0
  202. package/dist/src/retrieval/query-analyzer.js +32 -0
  203. package/dist/src/retrieval/query-classifier.js +1 -0
  204. package/dist/src/retrieval/query-expansion.js +1 -0
  205. package/dist/src/retrieval/recency.js +12 -0
  206. package/dist/src/retrieval/reranker/index.js +1 -0
  207. package/dist/src/retrieval/reranker/reranker.js +1 -0
  208. package/dist/src/retrieval/retrieval-engine.js +17 -0
  209. package/dist/src/retrieval/tokenizer.js +9 -0
  210. package/dist/src/retrieval/type-priority.js +10 -0
  211. package/dist/src/retrieval/types.js +1 -0
  212. package/dist/src/retrieval/vector/index.js +4 -0
  213. package/dist/src/retrieval/vector/metadata-filter.js +1 -0
  214. package/dist/src/retrieval/vector/persistence.js +67 -0
  215. package/dist/src/retrieval/vector/search.js +12 -0
  216. package/dist/src/retrieval/vector/test-persistence.js +36 -0
  217. package/dist/src/retrieval/vector/upsert.js +40 -0
  218. package/dist/src/retrieval/vector/vector-store.js +89 -0
  219. package/dist/src/retrieval/vector-hybrid-engine.js +91 -0
  220. package/dist/src/runtime/bootstrap.js +28 -0
  221. package/dist/src/runtime/graceful.js +17 -0
  222. package/dist/src/runtime/index.js +3 -0
  223. package/dist/src/runtime/toolnet-memory-runtime.js +156 -0
  224. package/dist/src/security/encryption.js +1 -0
  225. package/dist/src/security/file-filter.js +30 -0
  226. package/dist/src/security/index.js +3 -0
  227. package/dist/src/security/sanitizer.js +49 -0
  228. package/dist/src/security/secret-scanner.js +56 -0
  229. package/dist/src/session/agy/adapter.js +159 -0
  230. package/dist/src/session/agy/cli.js +87 -0
  231. package/dist/src/session/agy/hook-installer.js +62 -0
  232. package/dist/src/session/agy/hook.js +167 -0
  233. package/dist/src/session/agy/index.js +5 -0
  234. package/dist/src/session/agy/project-resolver.js +27 -0
  235. package/dist/src/session/agy/recovery.js +112 -0
  236. package/dist/src/session/agy/transcript.js +191 -0
  237. package/dist/src/session/codex/adapter.js +138 -0
  238. package/dist/src/session/codex/cli.js +236 -0
  239. package/dist/src/session/codex/context-hook-installer.js +70 -0
  240. package/dist/src/session/codex/context-hook.js +69 -0
  241. package/dist/src/session/codex/discovery.js +138 -0
  242. package/dist/src/session/codex/index.js +6 -0
  243. package/dist/src/session/codex/notify-installer.js +135 -0
  244. package/dist/src/session/codex/project-resolver.js +25 -0
  245. package/dist/src/session/codex/recovery.js +27 -0
  246. package/dist/src/session/codex/rollout.js +186 -0
  247. package/dist/src/session/core.js +239 -0
  248. package/dist/src/session/identity.js +57 -0
  249. package/dist/src/session/index.js +9 -0
  250. package/dist/src/session/learner/cli.js +62 -0
  251. package/dist/src/session/learner/extractor.js +461 -0
  252. package/dist/src/session/learner/index.js +4 -0
  253. package/dist/src/session/learner/journal.js +159 -0
  254. package/dist/src/session/learner/learner.js +124 -0
  255. package/dist/src/session/learner/types.js +1 -0
  256. package/dist/src/session/opencode/adapter.js +553 -0
  257. package/dist/src/session/opencode/cli.js +121 -0
  258. package/dist/src/session/opencode/index.js +2 -0
  259. package/dist/src/session/opencode/plugin-installer.js +230 -0
  260. package/dist/src/session/store.js +242 -0
  261. package/dist/src/session/types.js +1 -0
  262. package/dist/src/session/utils.js +47 -0
  263. package/dist/src/session/wal.js +303 -0
  264. package/dist/src/snapshot/index.js +2 -0
  265. package/dist/src/snapshot/manager.js +130 -0
  266. package/dist/src/snapshot/test-snapshot.js +28 -0
  267. package/dist/src/snapshot/types.js +1 -0
  268. package/dist/src/storage/architecture-store.js +37 -0
  269. package/dist/src/storage/cleanup-health.js +20 -0
  270. package/dist/src/storage/code-analysis-store.js +35 -0
  271. package/dist/src/storage/code-chunk-store.js +25 -0
  272. package/dist/src/storage/code-graph-store.js +24 -0
  273. package/dist/src/storage/code-manifest-store.js +24 -0
  274. package/dist/src/storage/code-vector-store.js +25 -0
  275. package/dist/src/storage/github/client.js +1 -0
  276. package/dist/src/storage/github/index.js +1 -0
  277. package/dist/src/storage/google-drive/client.js +1 -0
  278. package/dist/src/storage/google-drive/index.js +1 -0
  279. package/dist/src/storage/huggingface/client.js +116 -0
  280. package/dist/src/storage/huggingface/index.js +1 -0
  281. package/dist/src/storage/index.js +16 -0
  282. package/dist/src/storage/list-bucket-raw.js +14 -0
  283. package/dist/src/storage/list-bucket-tree.js +38 -0
  284. package/dist/src/storage/local/client.js +99 -0
  285. package/dist/src/storage/local/index.js +1 -0
  286. package/dist/src/storage/memory-store.js +30 -0
  287. package/dist/src/storage/project/cleanup-layout-v1.js +72 -0
  288. package/dist/src/storage/project/folder.js +15 -0
  289. package/dist/src/storage/project/index.js +3 -0
  290. package/dist/src/storage/project/layout.js +74 -0
  291. package/dist/src/storage/project/migrate-layout-v2.js +101 -0
  292. package/dist/src/storage/project/migrate.js +73 -0
  293. package/dist/src/storage/project/scoped-provider.js +165 -0
  294. package/dist/src/storage/provider.js +26 -0
  295. package/dist/src/storage/retrying-provider.js +23 -0
  296. package/dist/src/storage/test-connection.js +32 -0
  297. package/dist/src/storage/type-resolution-store.js +26 -0
  298. package/dist/src/storage/types.js +1 -0
  299. package/dist/src/storage/vector-store.js +30 -0
  300. package/dist/src/storage/visualization-store.js +25 -0
  301. package/dist/src/sync/compressor.js +1 -0
  302. package/dist/src/sync/conflict-resolver.js +1 -0
  303. package/dist/src/sync/downloader.js +1 -0
  304. package/dist/src/sync/index.js +1 -0
  305. package/dist/src/sync/sync-engine.js +1 -0
  306. package/dist/src/sync/upload-queue.js +1 -0
  307. package/dist/src/utils/retry.js +29 -0
  308. package/dist/src/visualization/server.js +270 -0
  309. package/dist/src/work-continuity/brief-cache.js +107 -0
  310. package/dist/src/work-continuity/brief.js +349 -0
  311. package/dist/src/work-continuity/cli.js +96 -0
  312. package/dist/src/work-continuity/context-cli.js +106 -0
  313. package/dist/src/work-continuity/context-runtime-cli.js +88 -0
  314. package/dist/src/work-continuity/extractor.js +339 -0
  315. package/dist/src/work-continuity/handoff.js +185 -0
  316. package/dist/src/work-continuity/index.js +14 -0
  317. package/dist/src/work-continuity/injection.js +84 -0
  318. package/dist/src/work-continuity/journal.js +49 -0
  319. package/dist/src/work-continuity/learner.js +127 -0
  320. package/dist/src/work-continuity/reducer.js +316 -0
  321. package/dist/src/work-continuity/semantic-extractor.js +360 -0
  322. package/dist/src/work-continuity/semantic-journal.js +55 -0
  323. package/dist/src/work-continuity/semantic-learner.js +125 -0
  324. package/dist/src/work-continuity/semantic-reducer.js +268 -0
  325. package/dist/src/work-continuity/semantic-types.js +1 -0
  326. package/dist/src/work-continuity/types.js +1 -0
  327. package/dist/visualization/public/index.html +2896 -0
  328. package/dist/visualization/public/vendor/3d-force-graph.min.js +5 -0
  329. package/package.json +69 -0
@@ -0,0 +1,21 @@
1
+ import { randomUUID, } from "node:crypto";
2
+ import { Sanitizer } from "../security/sanitizer.js";
3
+ export class ActivityCapture {
4
+ queue;
5
+ sanitizer = new Sanitizer();
6
+ constructor(queue) {
7
+ this.queue = queue;
8
+ }
9
+ capture(projectId, type, data = {}) {
10
+ const event = {
11
+ id: randomUUID(),
12
+ projectId,
13
+ type,
14
+ timestamp: new Date().toISOString(),
15
+ data: this.sanitizer
16
+ .sanitizeValue(data),
17
+ };
18
+ this.queue.push(event);
19
+ return event;
20
+ }
21
+ }
@@ -0,0 +1,12 @@
1
+ export class CommandCapture {
2
+ capture;
3
+ constructor(capture) {
4
+ this.capture = capture;
5
+ }
6
+ record(projectId, command, exitCode) {
7
+ return this.capture.capture(projectId, "command", {
8
+ command,
9
+ exitCode,
10
+ });
11
+ }
12
+ }
@@ -0,0 +1,14 @@
1
+ export class ErrorCapture {
2
+ capture;
3
+ constructor(capture) {
4
+ this.capture = capture;
5
+ }
6
+ record(projectId, error) {
7
+ const message = error instanceof Error
8
+ ? error.message
9
+ : String(error);
10
+ return this.capture.capture(projectId, "error", {
11
+ message,
12
+ });
13
+ }
14
+ }
@@ -0,0 +1,28 @@
1
+ import { createHash } from "node:crypto";
2
+ export class EventDeduplicator {
3
+ seen = new Set();
4
+ fingerprint(event) {
5
+ return createHash("sha256")
6
+ .update(JSON.stringify({
7
+ projectId: event.projectId,
8
+ type: event.type,
9
+ data: event.data,
10
+ }))
11
+ .digest("hex");
12
+ }
13
+ filter(events) {
14
+ const result = [];
15
+ for (const event of events) {
16
+ const hash = this.fingerprint(event);
17
+ if (this.seen.has(hash)) {
18
+ continue;
19
+ }
20
+ this.seen.add(hash);
21
+ result.push(event);
22
+ }
23
+ return result;
24
+ }
25
+ clear() {
26
+ this.seen.clear();
27
+ }
28
+ }
@@ -0,0 +1,20 @@
1
+ export class EventQueue {
2
+ events = [];
3
+ push(event) {
4
+ this.events.push(event);
5
+ }
6
+ drain() {
7
+ const items = [...this.events];
8
+ this.events.length = 0;
9
+ return items;
10
+ }
11
+ list() {
12
+ return [...this.events];
13
+ }
14
+ size() {
15
+ return this.events.length;
16
+ }
17
+ shouldFlush(maxEvents) {
18
+ return this.events.length >= maxEvents;
19
+ }
20
+ }
@@ -0,0 +1,23 @@
1
+ import { isSensitiveFile, } from "../security/file-filter.js";
2
+ export class FileCapture {
3
+ capture;
4
+ constructor(capture) {
5
+ this.capture = capture;
6
+ }
7
+ read(projectId, filePath) {
8
+ if (isSensitiveFile(filePath)) {
9
+ return null;
10
+ }
11
+ return this.capture.capture(projectId, "file_read", {
12
+ filePath,
13
+ });
14
+ }
15
+ write(projectId, filePath) {
16
+ if (isSensitiveFile(filePath)) {
17
+ return null;
18
+ }
19
+ return this.capture.capture(projectId, "file_write", {
20
+ filePath,
21
+ });
22
+ }
23
+ }
@@ -0,0 +1,8 @@
1
+ export * from "./event-queue.js";
2
+ export * from "./event-deduplicator.js";
3
+ export * from "./activity-capture.js";
4
+ export * from "./session-capture.js";
5
+ export * from "./tool-capture.js";
6
+ export * from "./file-capture.js";
7
+ export * from "./command-capture.js";
8
+ export * from "./error-capture.js";
@@ -0,0 +1,18 @@
1
+ import { randomUUID, } from "node:crypto";
2
+ export class SessionCapture {
3
+ capture;
4
+ sessionId = randomUUID();
5
+ constructor(capture) {
6
+ this.capture = capture;
7
+ }
8
+ start(projectId) {
9
+ return this.capture.capture(projectId, "session_start", {
10
+ sessionId: this.sessionId,
11
+ });
12
+ }
13
+ end(projectId) {
14
+ return this.capture.capture(projectId, "session_end", {
15
+ sessionId: this.sessionId,
16
+ });
17
+ }
18
+ }
@@ -0,0 +1,13 @@
1
+ export class ToolCapture {
2
+ capture;
3
+ constructor(capture) {
4
+ this.capture = capture;
5
+ }
6
+ record(projectId, tool, input, output) {
7
+ return this.capture.capture(projectId, "tool_call", {
8
+ tool,
9
+ input,
10
+ output,
11
+ });
12
+ }
13
+ }
@@ -0,0 +1,26 @@
1
+ import { DeadCodeAnalyzer, } from "./dead-code-analyzer.js";
2
+ import { DependencyAnalyzer, } from "./dependency-analyzer.js";
3
+ export class CodeAnalysisEngine {
4
+ graph;
5
+ constructor(graph) {
6
+ this.graph = graph;
7
+ }
8
+ analyze(projectId) {
9
+ const deadCode = new DeadCodeAnalyzer(this.graph).analyze(projectId);
10
+ const dependencies = new DependencyAnalyzer(this.graph).analyze(projectId);
11
+ return {
12
+ version: 1,
13
+ projectId,
14
+ updatedAt: new Date()
15
+ .toISOString(),
16
+ summary: {
17
+ deadCodeCandidates: deadCode.length,
18
+ highConfidenceDeadCode: deadCode.filter((item) => item.confidence ===
19
+ "high").length,
20
+ files: dependencies.length,
21
+ },
22
+ deadCode,
23
+ dependencies,
24
+ };
25
+ }
26
+ }
@@ -0,0 +1,127 @@
1
+ import { EntryPointDetector, } from "../architecture/entry-points.js";
2
+ const USAGE_EDGES = new Set([
3
+ "CALLS",
4
+ "CALL_REFERENCE",
5
+ "IMPORTS",
6
+ "USES_TYPE",
7
+ "WRITES",
8
+ "INHERITS",
9
+ "IMPLEMENTS",
10
+ "ROUTE",
11
+ "TESTS",
12
+ ]);
13
+ function normalize(value) {
14
+ return value
15
+ .replaceAll("\\", "/")
16
+ .toLowerCase();
17
+ }
18
+ function isTestFile(filePath) {
19
+ const path = normalize(filePath);
20
+ return (path.startsWith("tests/") ||
21
+ path.includes("/tests/") ||
22
+ path.includes("__tests__") ||
23
+ /\.(test|spec)\.[^.]+$/
24
+ .test(path));
25
+ }
26
+ function looksPublicApi(symbol) {
27
+ const path = normalize(symbol.filePath);
28
+ return (path.startsWith("bin/") ||
29
+ /(^|\/)index\.[^.]+$/
30
+ .test(path) ||
31
+ /(^|\/)(main|server|cli)\.[^.]+$/
32
+ .test(path));
33
+ }
34
+ export class DeadCodeAnalyzer {
35
+ graph;
36
+ constructor(graph) {
37
+ this.graph = graph;
38
+ }
39
+ analyze(projectId) {
40
+ const symbols = this.graph.allSymbols(projectId);
41
+ const edges = this.graph.allEdges(projectId);
42
+ const entrySymbols = new Set(new EntryPointDetector(this.graph)
43
+ .detect(projectId)
44
+ .map((entry) => entry.symbolId));
45
+ const candidates = [];
46
+ for (const symbol of symbols) {
47
+ if (![
48
+ "function",
49
+ "method",
50
+ "class",
51
+ "interface",
52
+ "property",
53
+ ].includes(symbol.type)) {
54
+ continue;
55
+ }
56
+ if (isTestFile(symbol.filePath) ||
57
+ entrySymbols.has(symbol.id) ||
58
+ looksPublicApi(symbol)) {
59
+ continue;
60
+ }
61
+ const incoming = edges.filter((edge) => edge.to ===
62
+ symbol.id &&
63
+ USAGE_EDGES.has(edge.type));
64
+ if (incoming.length >
65
+ 0) {
66
+ continue;
67
+ }
68
+ const outgoing = edges.filter((edge) => edge.from ===
69
+ symbol.id &&
70
+ USAGE_EDGES.has(edge.type));
71
+ const reasons = [
72
+ "no incoming usage edge",
73
+ ];
74
+ let score = 50;
75
+ if (symbol.type ===
76
+ "function" ||
77
+ symbol.type ===
78
+ "method") {
79
+ score +=
80
+ 20;
81
+ reasons.push("callable symbol");
82
+ }
83
+ if (symbol.type ===
84
+ "property") {
85
+ score -=
86
+ 15;
87
+ }
88
+ if (outgoing.length ===
89
+ 0) {
90
+ score +=
91
+ 10;
92
+ reasons.push("no outgoing dependency");
93
+ }
94
+ const path = normalize(symbol.filePath);
95
+ if (path.includes("/internal/")) {
96
+ score +=
97
+ 10;
98
+ reasons.push("internal implementation");
99
+ }
100
+ if (symbol.name
101
+ .startsWith("_")) {
102
+ score +=
103
+ 5;
104
+ }
105
+ const confidence = score >= 75
106
+ ? "high"
107
+ : score >= 55
108
+ ? "medium"
109
+ : "low";
110
+ candidates.push({
111
+ symbolId: symbol.id,
112
+ name: symbol.name,
113
+ qualifiedName: symbol.qualifiedName,
114
+ type: symbol.type,
115
+ filePath: symbol.filePath,
116
+ startLine: symbol.startLine,
117
+ confidence,
118
+ score,
119
+ reasons,
120
+ });
121
+ }
122
+ return candidates.sort((a, b) => b.score -
123
+ a.score ||
124
+ a.filePath.localeCompare(b.filePath) ||
125
+ a.name.localeCompare(b.name));
126
+ }
127
+ }
@@ -0,0 +1,66 @@
1
+ const EDGE_TYPES = new Set([
2
+ "CALLS",
3
+ "CALL_REFERENCE",
4
+ "IMPORTS",
5
+ "USES_TYPE",
6
+ "WRITES",
7
+ "INHERITS",
8
+ "IMPLEMENTS",
9
+ "ROUTE",
10
+ ]);
11
+ export class DependencyAnalyzer {
12
+ graph;
13
+ constructor(graph) {
14
+ this.graph = graph;
15
+ }
16
+ analyze(projectId) {
17
+ const symbols = this.graph.allSymbols(projectId);
18
+ const edges = this.graph
19
+ .allEdges(projectId)
20
+ .filter((edge) => EDGE_TYPES.has(edge.type));
21
+ const symbolById = new Map(symbols.map((symbol) => [
22
+ symbol.id,
23
+ symbol,
24
+ ]));
25
+ const files = [
26
+ ...new Set(symbols.map((symbol) => symbol.filePath)),
27
+ ].sort();
28
+ return files.map((filePath) => {
29
+ const dependencies = new Set();
30
+ const dependents = new Set();
31
+ let outgoingEdges = 0;
32
+ let incomingEdges = 0;
33
+ for (const edge of edges) {
34
+ const from = symbolById.get(edge.from);
35
+ const to = symbolById.get(edge.to);
36
+ if (!from ||
37
+ !to ||
38
+ from.filePath ===
39
+ to.filePath) {
40
+ continue;
41
+ }
42
+ if (from.filePath ===
43
+ filePath) {
44
+ dependencies.add(to.filePath);
45
+ outgoingEdges++;
46
+ }
47
+ if (to.filePath ===
48
+ filePath) {
49
+ dependents.add(from.filePath);
50
+ incomingEdges++;
51
+ }
52
+ }
53
+ return {
54
+ filePath,
55
+ dependencies: [
56
+ ...dependencies,
57
+ ].sort(),
58
+ dependents: [
59
+ ...dependents,
60
+ ].sort(),
61
+ outgoingEdges,
62
+ incomingEdges,
63
+ };
64
+ });
65
+ }
66
+ }
@@ -0,0 +1,4 @@
1
+ export * from "./types.js";
2
+ export * from "./dead-code-analyzer.js";
3
+ export * from "./dependency-analyzer.js";
4
+ export * from "./analysis-engine.js";
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,48 @@
1
+ import { ClusterDetector, } from "./clusters.js";
2
+ import { EntryPointDetector, } from "./entry-points.js";
3
+ import { HotspotAnalyzer, } from "./hotspots.js";
4
+ import { LayerDetector, } from "./layers.js";
5
+ export class ArchitectureEngine {
6
+ graph;
7
+ entryPoints;
8
+ hotspots;
9
+ layers;
10
+ clusters;
11
+ constructor(graph) {
12
+ this.graph = graph;
13
+ this.entryPoints =
14
+ new EntryPointDetector(graph);
15
+ this.hotspots =
16
+ new HotspotAnalyzer(graph);
17
+ this.layers =
18
+ new LayerDetector(graph);
19
+ this.clusters =
20
+ new ClusterDetector(graph);
21
+ }
22
+ analyze(projectId) {
23
+ const entryPoints = this.entryPoints.detect(projectId);
24
+ const hotspots = this.hotspots.analyze(projectId);
25
+ const layers = this.layers.detect(projectId);
26
+ const clusters = this.clusters.detect(projectId);
27
+ const files = new Set(this.graph
28
+ .allSymbols(projectId)
29
+ .map((symbol) => symbol.filePath));
30
+ return {
31
+ version: 1,
32
+ projectId,
33
+ updatedAt: new Date()
34
+ .toISOString(),
35
+ summary: {
36
+ files: files.size,
37
+ entryPoints: entryPoints.length,
38
+ hotspots: hotspots.length,
39
+ layers: layers.length,
40
+ clusters: clusters.length,
41
+ },
42
+ entryPoints,
43
+ hotspots,
44
+ layers,
45
+ clusters,
46
+ };
47
+ }
48
+ }