@tyroneross/build-loop 0.30.3

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 (389) hide show
  1. package/.agents/plugins/marketplace.json +10 -0
  2. package/.claude-plugin/marketplace.json +38 -0
  3. package/.claude-plugin/plugin.json +30 -0
  4. package/.codex-plugin/plugin.json +41 -0
  5. package/.cursor/rules/build-loop-surface.mdc +22 -0
  6. package/AGENTS.md +498 -0
  7. package/LICENSE +202 -0
  8. package/README.md +403 -0
  9. package/agents/alignment-checker.md +124 -0
  10. package/agents/api-assessor.md +136 -0
  11. package/agents/architecture-scout.md +185 -0
  12. package/agents/assessment-orchestrator.md +163 -0
  13. package/agents/build-orchestrator.md +198 -0
  14. package/agents/database-assessor.md +133 -0
  15. package/agents/design-contract-specialist.md +239 -0
  16. package/agents/fact-checker.md +69 -0
  17. package/agents/fix-critique.md +161 -0
  18. package/agents/frontend-assessor.md +136 -0
  19. package/agents/implementer.md +185 -0
  20. package/agents/independent-auditor.md +143 -0
  21. package/agents/mock-scanner.md +78 -0
  22. package/agents/optimize-runner.md +112 -0
  23. package/agents/overfitting-reviewer.md +96 -0
  24. package/agents/performance-assessor.md +159 -0
  25. package/agents/plan-critic.md +85 -0
  26. package/agents/promotion-reviewer.md +121 -0
  27. package/agents/recurring-pattern-detector.md +248 -0
  28. package/agents/retrospective-synthesizer.md +109 -0
  29. package/agents/root-cause-investigator.md +285 -0
  30. package/agents/scope-auditor.md +121 -0
  31. package/agents/security-reviewer.md +151 -0
  32. package/agents/self-improvement-architect.md +125 -0
  33. package/agents/synthesis-critic.md +99 -0
  34. package/agents/transcript-pattern-miner.md +165 -0
  35. package/agents/ui-validator.md +193 -0
  36. package/codex-skills/build-loop/SKILL.md +20 -0
  37. package/codex-skills/debug-loop/SKILL.md +18 -0
  38. package/codex-skills/handoff/SKILL.md +22 -0
  39. package/codex-skills/knowledge/SKILL.md +21 -0
  40. package/codex-skills/optimize/SKILL.md +18 -0
  41. package/codex-skills/research/SKILL.md +18 -0
  42. package/commands/agent-rally-point.md +301 -0
  43. package/commands/assess.md +41 -0
  44. package/commands/debug.md +20 -0
  45. package/commands/debugger-detail.md +34 -0
  46. package/commands/debugger-scan.md +15 -0
  47. package/commands/debugger-status.md +20 -0
  48. package/commands/debugger.md +32 -0
  49. package/commands/handoff.md +113 -0
  50. package/commands/knowledge-review.md +16 -0
  51. package/commands/optimize.md +31 -0
  52. package/commands/plan-verify.md +39 -0
  53. package/commands/promote-experiment.md +129 -0
  54. package/commands/research.md +22 -0
  55. package/commands/run.md +12 -0
  56. package/commands/self-review.md +51 -0
  57. package/commands/start-prd.md +57 -0
  58. package/commands/test.md +34 -0
  59. package/dist/src/assessment-orchestrator.d.ts +78 -0
  60. package/dist/src/assessment-orchestrator.d.ts.map +1 -0
  61. package/dist/src/assessment-orchestrator.js +304 -0
  62. package/dist/src/assessment-orchestrator.js.map +1 -0
  63. package/dist/src/audit-miner.d.ts +21 -0
  64. package/dist/src/audit-miner.d.ts.map +1 -0
  65. package/dist/src/audit-miner.js +421 -0
  66. package/dist/src/audit-miner.js.map +1 -0
  67. package/dist/src/batch-operations.d.ts +30 -0
  68. package/dist/src/batch-operations.d.ts.map +1 -0
  69. package/dist/src/batch-operations.js +339 -0
  70. package/dist/src/batch-operations.js.map +1 -0
  71. package/dist/src/config.d.ts +83 -0
  72. package/dist/src/config.d.ts.map +1 -0
  73. package/dist/src/config.js +176 -0
  74. package/dist/src/config.js.map +1 -0
  75. package/dist/src/context-engine.d.ts +45 -0
  76. package/dist/src/context-engine.d.ts.map +1 -0
  77. package/dist/src/context-engine.js +135 -0
  78. package/dist/src/context-engine.js.map +1 -0
  79. package/dist/src/debug-wrapper.d.ts +58 -0
  80. package/dist/src/debug-wrapper.d.ts.map +1 -0
  81. package/dist/src/debug-wrapper.js +285 -0
  82. package/dist/src/debug-wrapper.js.map +1 -0
  83. package/dist/src/index.d.ts +31 -0
  84. package/dist/src/index.d.ts.map +1 -0
  85. package/dist/src/index.js +149 -0
  86. package/dist/src/index.js.map +1 -0
  87. package/dist/src/interactive-verifier.d.ts +26 -0
  88. package/dist/src/interactive-verifier.d.ts.map +1 -0
  89. package/dist/src/interactive-verifier.js +435 -0
  90. package/dist/src/interactive-verifier.js.map +1 -0
  91. package/dist/src/lessons.d.ts +59 -0
  92. package/dist/src/lessons.d.ts.map +1 -0
  93. package/dist/src/lessons.js +172 -0
  94. package/dist/src/lessons.js.map +1 -0
  95. package/dist/src/log-reader.d.ts +39 -0
  96. package/dist/src/log-reader.d.ts.map +1 -0
  97. package/dist/src/log-reader.js +291 -0
  98. package/dist/src/log-reader.js.map +1 -0
  99. package/dist/src/logger.d.ts +59 -0
  100. package/dist/src/logger.d.ts.map +1 -0
  101. package/dist/src/logger.js +328 -0
  102. package/dist/src/logger.js.map +1 -0
  103. package/dist/src/parallel-retrieval.d.ts +52 -0
  104. package/dist/src/parallel-retrieval.d.ts.map +1 -0
  105. package/dist/src/parallel-retrieval.js +309 -0
  106. package/dist/src/parallel-retrieval.js.map +1 -0
  107. package/dist/src/pattern-extractor.d.ts +30 -0
  108. package/dist/src/pattern-extractor.d.ts.map +1 -0
  109. package/dist/src/pattern-extractor.js +386 -0
  110. package/dist/src/pattern-extractor.js.map +1 -0
  111. package/dist/src/result-aggregator.d.ts +44 -0
  112. package/dist/src/result-aggregator.d.ts.map +1 -0
  113. package/dist/src/result-aggregator.js +315 -0
  114. package/dist/src/result-aggregator.js.map +1 -0
  115. package/dist/src/retrieval.d.ts +139 -0
  116. package/dist/src/retrieval.d.ts.map +1 -0
  117. package/dist/src/retrieval.js +724 -0
  118. package/dist/src/retrieval.js.map +1 -0
  119. package/dist/src/setup/auto-setup.d.ts +15 -0
  120. package/dist/src/setup/auto-setup.d.ts.map +1 -0
  121. package/dist/src/setup/auto-setup.js +157 -0
  122. package/dist/src/setup/auto-setup.js.map +1 -0
  123. package/dist/src/setup/configure-hooks.d.ts +8 -0
  124. package/dist/src/setup/configure-hooks.d.ts.map +1 -0
  125. package/dist/src/setup/configure-hooks.js +16 -0
  126. package/dist/src/setup/configure-hooks.js.map +1 -0
  127. package/dist/src/setup/create-slash-commands.d.ts +8 -0
  128. package/dist/src/setup/create-slash-commands.d.ts.map +1 -0
  129. package/dist/src/setup/create-slash-commands.js +101 -0
  130. package/dist/src/setup/create-slash-commands.js.map +1 -0
  131. package/dist/src/setup/index.d.ts +8 -0
  132. package/dist/src/setup/index.d.ts.map +1 -0
  133. package/dist/src/setup/index.js +17 -0
  134. package/dist/src/setup/index.js.map +1 -0
  135. package/dist/src/setup/inject-claude-md.d.ts +10 -0
  136. package/dist/src/setup/inject-claude-md.d.ts.map +1 -0
  137. package/dist/src/setup/inject-claude-md.js +150 -0
  138. package/dist/src/setup/inject-claude-md.js.map +1 -0
  139. package/dist/src/setup/uninstall.d.ts +22 -0
  140. package/dist/src/setup/uninstall.d.ts.map +1 -0
  141. package/dist/src/setup/uninstall.js +235 -0
  142. package/dist/src/setup/uninstall.js.map +1 -0
  143. package/dist/src/storage.d.ts +192 -0
  144. package/dist/src/storage.d.ts.map +1 -0
  145. package/dist/src/storage.js +1037 -0
  146. package/dist/src/storage.js.map +1 -0
  147. package/dist/src/string-similarity.d.ts +8 -0
  148. package/dist/src/string-similarity.d.ts.map +1 -0
  149. package/dist/src/string-similarity.js +57 -0
  150. package/dist/src/string-similarity.js.map +1 -0
  151. package/dist/src/traces/adapters/browser.d.ts +69 -0
  152. package/dist/src/traces/adapters/browser.d.ts.map +1 -0
  153. package/dist/src/traces/adapters/browser.js +280 -0
  154. package/dist/src/traces/adapters/browser.js.map +1 -0
  155. package/dist/src/traces/adapters/index.d.ts +23 -0
  156. package/dist/src/traces/adapters/index.d.ts.map +1 -0
  157. package/dist/src/traces/adapters/index.js +67 -0
  158. package/dist/src/traces/adapters/index.js.map +1 -0
  159. package/dist/src/traces/adapters/langchain.d.ts +42 -0
  160. package/dist/src/traces/adapters/langchain.d.ts.map +1 -0
  161. package/dist/src/traces/adapters/langchain.js +151 -0
  162. package/dist/src/traces/adapters/langchain.js.map +1 -0
  163. package/dist/src/traces/adapters/opentelemetry.d.ts +46 -0
  164. package/dist/src/traces/adapters/opentelemetry.d.ts.map +1 -0
  165. package/dist/src/traces/adapters/opentelemetry.js +164 -0
  166. package/dist/src/traces/adapters/opentelemetry.js.map +1 -0
  167. package/dist/src/traces/adapters/sentry.d.ts +58 -0
  168. package/dist/src/traces/adapters/sentry.d.ts.map +1 -0
  169. package/dist/src/traces/adapters/sentry.js +212 -0
  170. package/dist/src/traces/adapters/sentry.js.map +1 -0
  171. package/dist/src/traces/index.d.ts +10 -0
  172. package/dist/src/traces/index.d.ts.map +1 -0
  173. package/dist/src/traces/index.js +45 -0
  174. package/dist/src/traces/index.js.map +1 -0
  175. package/dist/src/traces/storage.d.ts +78 -0
  176. package/dist/src/traces/storage.d.ts.map +1 -0
  177. package/dist/src/traces/storage.js +399 -0
  178. package/dist/src/traces/storage.js.map +1 -0
  179. package/dist/src/traces/summarizer.d.ts +83 -0
  180. package/dist/src/traces/summarizer.d.ts.map +1 -0
  181. package/dist/src/traces/summarizer.js +247 -0
  182. package/dist/src/traces/summarizer.js.map +1 -0
  183. package/dist/src/traces/types.d.ts +365 -0
  184. package/dist/src/traces/types.d.ts.map +1 -0
  185. package/dist/src/traces/types.js +14 -0
  186. package/dist/src/traces/types.js.map +1 -0
  187. package/dist/src/types.d.ts +495 -0
  188. package/dist/src/types.d.ts.map +1 -0
  189. package/dist/src/types.js +27 -0
  190. package/dist/src/types.js.map +1 -0
  191. package/docs/agent-surface-policy.md +45 -0
  192. package/docs/memory-setup.md +226 -0
  193. package/hooks/_arch_scan_bg.py +88 -0
  194. package/hooks/_plugin_drift_check_bg.py +85 -0
  195. package/hooks/_session_start_lib.sh +42 -0
  196. package/hooks/git/pre-push +141 -0
  197. package/hooks/hooks.json +126 -0
  198. package/hooks/post-commit +30 -0
  199. package/hooks/pre-commit +29 -0
  200. package/hooks/pre-edit-apppulse.sh +6 -0
  201. package/hooks/pre-edit-architecture.sh +106 -0
  202. package/hooks/pre-edit-rally-point.sh +92 -0
  203. package/hooks/session-start-apppulse.sh +6 -0
  204. package/hooks/session-start-architecture.sh +10 -0
  205. package/hooks/session-start-git-hooks.sh +12 -0
  206. package/hooks/session-start-plugin-drift.sh +27 -0
  207. package/hooks/session-start-rally-point.sh +44 -0
  208. package/hooks/session-start-retrieval.sh +24 -0
  209. package/hooks/session-start-worktree-gc.sh +105 -0
  210. package/hooks/test_apppulse_hooks.sh +6 -0
  211. package/hooks/test_rally_point_hooks.sh +388 -0
  212. package/hooks/test_sec008_hooks.sh +66 -0
  213. package/package.json +111 -0
  214. package/scripts/README.md +301 -0
  215. package/scripts/_db_url.py +61 -0
  216. package/scripts/_paths.py +445 -0
  217. package/scripts/blm.py +162 -0
  218. package/scripts/blm_api.py +263 -0
  219. package/scripts/check_cache_sync.py +490 -0
  220. package/scripts/embed_backend.py +475 -0
  221. package/scripts/install_memory.py +556 -0
  222. package/scripts/lessons_index/__init__.py +77 -0
  223. package/scripts/lessons_index/__main__.py +135 -0
  224. package/scripts/lessons_index/ingest.py +288 -0
  225. package/scripts/lessons_index/query.py +285 -0
  226. package/scripts/lessons_index/schema.py +114 -0
  227. package/scripts/memory_context/__init__.py +610 -0
  228. package/scripts/memory_graph/__init__.py +393 -0
  229. package/scripts/project_resolver.py +172 -0
  230. package/scripts/prune_codex_plugin_cache.py +23 -0
  231. package/scripts/prune_plugin_cache.py +359 -0
  232. package/scripts/semantic_index/__init__.py +482 -0
  233. package/scripts/semantic_index/_bench_hybrid.py +175 -0
  234. package/scripts/semantic_index/backfill.py +263 -0
  235. package/scripts/semantic_index/hybrid.py +174 -0
  236. package/scripts/semantic_index/test_backfill.py +292 -0
  237. package/scripts/semantic_index/test_hybrid.py +541 -0
  238. package/scripts/sync_navgator_lessons.py +666 -0
  239. package/scripts/sync_plugin_cache.py +388 -0
  240. package/skills/agent-rally-point/SKILL.md +165 -0
  241. package/skills/agent-rally-watcher/SKILL.md +83 -0
  242. package/skills/api-registry-bridge/SKILL.md +59 -0
  243. package/skills/architecture/dead/SKILL.md +56 -0
  244. package/skills/architecture/impact/SKILL.md +88 -0
  245. package/skills/architecture/review/SKILL.md +227 -0
  246. package/skills/architecture/rules/SKILL.md +72 -0
  247. package/skills/architecture/scan/SKILL.md +79 -0
  248. package/skills/architecture/trace/SKILL.md +65 -0
  249. package/skills/attribution-standard/SKILL.md +122 -0
  250. package/skills/authentication/SKILL.md +81 -0
  251. package/skills/authentication/references/better-auth-magic-link.md +135 -0
  252. package/skills/authentication/references/better-auth-setup.md +224 -0
  253. package/skills/authentication/references/google-calendar-sync.md +278 -0
  254. package/skills/authentication/references/google-cloud-console.md +159 -0
  255. package/skills/authentication/references/google-geocoding-directions.md +126 -0
  256. package/skills/authentication/references/google-lessons-example-web-app.md +177 -0
  257. package/skills/authentication/references/google-maps.md +162 -0
  258. package/skills/authentication/references/google-oauth-setup.md +343 -0
  259. package/skills/authentication/references/google-places.md +173 -0
  260. package/skills/authentication/references/lessons-example-web-app-better-auth.md +126 -0
  261. package/skills/authentication/references/resend-email.md +227 -0
  262. package/skills/authentication/references/resend-otp-magic-link.md +153 -0
  263. package/skills/authentication/references/supabase-auth.md +172 -0
  264. package/skills/auto-decision-capture/SKILL.md +419 -0
  265. package/skills/build-loop/SKILL.md +516 -0
  266. package/skills/build-loop/detect-plugins.mjs +82 -0
  267. package/skills/build-loop/eval-guide.md +65 -0
  268. package/skills/build-loop/fallbacks.md +549 -0
  269. package/skills/build-loop/phases/fact-check.md +42 -0
  270. package/skills/build-loop/phases/ui-validation.md +267 -0
  271. package/skills/build-loop/references/apple-native-planning.md +439 -0
  272. package/skills/build-loop/references/capability-routing.md +181 -0
  273. package/skills/build-loop/references/codex-subagents.md +98 -0
  274. package/skills/build-loop/references/coordination.md +161 -0
  275. package/skills/build-loop/references/correction-aware-capture.md +177 -0
  276. package/skills/build-loop/references/independent-auditor.md +72 -0
  277. package/skills/build-loop/references/intent-capability-pack.md +170 -0
  278. package/skills/build-loop/references/intent-exploration-prompts.md +96 -0
  279. package/skills/build-loop/references/leadership.md +72 -0
  280. package/skills/build-loop/references/memory.md +284 -0
  281. package/skills/build-loop/references/modular-systems-pack.md +96 -0
  282. package/skills/build-loop/references/output-style.md +129 -0
  283. package/skills/build-loop/references/pay-it-forward-arch.md +98 -0
  284. package/skills/build-loop/references/phase-1-assess.md +218 -0
  285. package/skills/build-loop/references/phase-2-plan.md +77 -0
  286. package/skills/build-loop/references/phase-3-execute.md +47 -0
  287. package/skills/build-loop/references/phase-4-review.md +310 -0
  288. package/skills/build-loop/references/phase-5-iterate.md +71 -0
  289. package/skills/build-loop/references/phase-6-learn.md +56 -0
  290. package/skills/build-loop/references/recent-design-structures.md +274 -0
  291. package/skills/build-loop/references/refactor-history/ASSESSMENT.md +85 -0
  292. package/skills/build-loop/references/refactor-history/STANDALONE_TEST_RUN.md +149 -0
  293. package/skills/build-loop/references/refactor-history/scenarios/01-simple-bugfix.md +32 -0
  294. package/skills/build-loop/references/refactor-history/scenarios/02-ui-build-with-iteration.md +48 -0
  295. package/skills/build-loop/references/refactor-history/scenarios/03-multi-failure-escalation.md +60 -0
  296. package/skills/build-loop/references/refactor-history/scenarios/04-ui-build-ibr-absent.md +51 -0
  297. package/skills/build-loop/references/refactor-history/scenarios/05-refactor-navgator-absent.md +71 -0
  298. package/skills/build-loop/references/refactor-history/scenarios/06-recurring-bug-debugger-absent.md +52 -0
  299. package/skills/build-loop/references/refactor-history/trace-comparison.md +202 -0
  300. package/skills/build-loop/references/self-recursive-dev.md +77 -0
  301. package/skills/build-loop/references/self-review.md +232 -0
  302. package/skills/build-loop/references/ui-io-contract.md +116 -0
  303. package/skills/build-loop/scanners/audit-design-rules.mjs +476 -0
  304. package/skills/build-loop/scanners/require-visual-evidence.mjs +239 -0
  305. package/skills/build-loop/templates/backlog-item.md +35 -0
  306. package/skills/build-loop/templates/codex-worker-prompt.md +89 -0
  307. package/skills/build-loop/templates/ui-subagent-prompt.md +179 -0
  308. package/skills/build-loop/templates/ux-fix-plan.md +40 -0
  309. package/skills/building-with-deepagents/SKILL.md +195 -0
  310. package/skills/building-with-deepagents/references/anti-patterns.md +141 -0
  311. package/skills/building-with-deepagents/references/api-quick-reference.md +184 -0
  312. package/skills/capabilities/SKILL.md +91 -0
  313. package/skills/debug-loop/SKILL.md +278 -0
  314. package/skills/debug-loop/references/convergence-rules.md +145 -0
  315. package/skills/debug-loop/references/swiftui-macos-clunky-ui-debugger.html +823 -0
  316. package/skills/debugging/assess/SKILL.md +111 -0
  317. package/skills/debugging/debug-loop/SKILL.md +231 -0
  318. package/skills/debugging/memory/SKILL.md +147 -0
  319. package/skills/debugging/store/SKILL.md +153 -0
  320. package/skills/debugging-memory/SKILL.md +440 -0
  321. package/skills/debugging-memory/examples/incident-example.json +67 -0
  322. package/skills/debugging-memory/references/incident-documentation.md +280 -0
  323. package/skills/debugging-memory/references/ios-notification-alarm-playbook.md +300 -0
  324. package/skills/debugging-memory/references/pattern-extraction.md +163 -0
  325. package/skills/debugging-memory/references/subagent-integration.md +312 -0
  326. package/skills/defenseclaw-bridge/SKILL.md +156 -0
  327. package/skills/defenseclaw-bridge/references/dc-config-mapping.md +162 -0
  328. package/skills/defenseclaw-bridge/references/output-format.md +108 -0
  329. package/skills/handoff/SKILL.md +94 -0
  330. package/skills/ibr-bridge/SKILL.md +68 -0
  331. package/skills/knowledge/SKILL.md +127 -0
  332. package/skills/knowledge/references/recall-integration.md +83 -0
  333. package/skills/knowledge/templates/madr-minimal.md +56 -0
  334. package/skills/knowledge-review/SKILL.md +112 -0
  335. package/skills/logging-tracer/SKILL.md +202 -0
  336. package/skills/logging-tracer/references/log-analysis.md +128 -0
  337. package/skills/logging-tracer/references/stack-templates.md +274 -0
  338. package/skills/logging-tracer-bridge/SKILL.md +70 -0
  339. package/skills/mcp-builder/SKILL.md +278 -0
  340. package/skills/mcp-builder/references/mcp-security.md +106 -0
  341. package/skills/model-tiering/SKILL.md +216 -0
  342. package/skills/native-ax-driver/SKILL.md +220 -0
  343. package/skills/native-ax-driver/scripts/layout_fill.py +222 -0
  344. package/skills/native-ax-driver/scripts/native_driver.py +495 -0
  345. package/skills/native-ax-driver/swift/bl-ax-driver/Package.swift +20 -0
  346. package/skills/native-ax-driver/swift/bl-ax-driver/Sources/main.swift +542 -0
  347. package/skills/optimize/SKILL.md +202 -0
  348. package/skills/optimize/profiles.md +61 -0
  349. package/skills/plan-verify/SKILL.md +115 -0
  350. package/skills/plan-verify/test-fixtures/example-app-v20-findings.json +27 -0
  351. package/skills/plan-verify/test-fixtures/example-app-v20.md +42 -0
  352. package/skills/plan-verify/test-fixtures/example-app-v22-findings.json +15 -0
  353. package/skills/plan-verify/test-fixtures/example-app-v22.md +1608 -0
  354. package/skills/plan-verify/test-fixtures/unrelated-good-plan-findings.json +15 -0
  355. package/skills/plan-verify/test-fixtures/unrelated-good-plan.md +55 -0
  356. package/skills/plugin-builder/SKILL.md +329 -0
  357. package/skills/plugin-builder/references/authoritative-sources.md +104 -0
  358. package/skills/plugin-builder/references/build-loop-phase-guidance.md +94 -0
  359. package/skills/plugin-builder/references/components-guide.md +221 -0
  360. package/skills/plugin-builder/references/distribution.md +317 -0
  361. package/skills/plugin-builder/references/dual-host-claude-codex.md +220 -0
  362. package/skills/plugin-builder/references/hooks-reference.md +210 -0
  363. package/skills/plugin-builder/references/manifest-schema.md +111 -0
  364. package/skills/plugin-builder/references/plugin-hygiene-lessons.md +307 -0
  365. package/skills/plugin-tests/SKILL.md +94 -0
  366. package/skills/prd-bridge/SKILL.md +135 -0
  367. package/skills/research/SKILL.md +80 -0
  368. package/skills/security-methodology/SKILL.md +105 -0
  369. package/skills/security-methodology/references/cross-source-matrix.md +77 -0
  370. package/skills/security-methodology/references/mitre-atlas-starter.md +83 -0
  371. package/skills/security-methodology/references/nist-600-1-mapping.md +119 -0
  372. package/skills/security-methodology/references/owasp-agentic-top-10.md +157 -0
  373. package/skills/security-methodology/references/owasp-llm-top-10.md +144 -0
  374. package/skills/security-methodology/references/owasp-web-top-10.md +65 -0
  375. package/skills/self-improve/SKILL.md +298 -0
  376. package/skills/spec-writing/SKILL.md +548 -0
  377. package/skills/spec-writing/scripts/check_checklist.py +478 -0
  378. package/skills/sync-skills/SKILL.md +132 -0
  379. package/skills/telemetry/SKILL.md +66 -0
  380. package/skills/ui-design/SKILL.md +75 -0
  381. package/skills/ui-design/references/design-patterns-multi.md +165 -0
  382. package/skills/ui-design/references/design-preferences-from-owned-apps.md +150 -0
  383. package/skills/ui-design/references/evidence-capture-policy.md +55 -0
  384. package/skills/ui-design/references/ui-guidance-sources.md +330 -0
  385. package/skills/ui-design/references/universal-design-principles.alt.md +182 -0
  386. package/skills/ui-design/references/universal-design-principles.md +419 -0
  387. package/templates/memory/MEMORY.md.template +55 -0
  388. package/templates/memory/constitution.md.template +64 -0
  389. package/templates/memory/manifest.json +47 -0
@@ -0,0 +1,339 @@
1
+ "use strict";
2
+ // SPDX-FileCopyrightText: 2025-2026 Tyrone Ross, Jr <46267523+tyroneross@users.noreply.github.com>
3
+ // SPDX-License-Identifier: Apache-2.0
4
+ /**
5
+ * Batch Operations
6
+ *
7
+ * Batch commands for maintaining the memory system:
8
+ * - Review incomplete incidents
9
+ * - Extract patterns from existing incidents
10
+ * - Clean up old sessions
11
+ */
12
+ var __importDefault = (this && this.__importDefault) || function (mod) {
13
+ return (mod && mod.__esModule) ? mod : { "default": mod };
14
+ };
15
+ Object.defineProperty(exports, "__esModule", { value: true });
16
+ exports.batchReviewIncomplete = batchReviewIncomplete;
17
+ exports.batchExtractPatterns = batchExtractPatterns;
18
+ exports.batchCleanup = batchCleanup;
19
+ const prompts_1 = __importDefault(require("prompts"));
20
+ const promises_1 = __importDefault(require("fs/promises"));
21
+ const path_1 = __importDefault(require("path"));
22
+ const storage_1 = require("./storage");
23
+ const pattern_extractor_1 = require("./pattern-extractor");
24
+ const config_1 = require("./config");
25
+ const interactive_verifier_1 = require("./interactive-verifier");
26
+ /**
27
+ * Review and complete incomplete incidents interactively
28
+ */
29
+ async function batchReviewIncomplete(config) {
30
+ console.log('\n🔍 Batch Review: Incomplete Incidents');
31
+ console.log('═══════════════════════════════════════════════\n');
32
+ // Load all incidents
33
+ const incidents = await (0, storage_1.loadAllIncidents)(config);
34
+ // Filter for incomplete incidents (low completeness score or marked incomplete)
35
+ const incomplete = incidents.filter(inc => {
36
+ const hasIncompleteTag = (inc.tags ?? []).includes('incomplete');
37
+ const lowCompleteness = (inc.completeness?.quality_score ?? 0) < 0.7;
38
+ const unverified = inc.verification?.status === 'unverified';
39
+ return hasIncompleteTag || lowCompleteness || unverified;
40
+ });
41
+ if (incomplete.length === 0) {
42
+ console.log('✅ No incomplete incidents found!\n');
43
+ return;
44
+ }
45
+ console.log(`Found ${incomplete.length} incomplete incidents:\n`);
46
+ let completed = 0;
47
+ let skipped = 0;
48
+ let deleted = 0;
49
+ for (const [index, incident] of incomplete.entries()) {
50
+ console.log(`\n─────────────────────────────────────────────────`);
51
+ console.log(`Incident ${index + 1}/${incomplete.length}: ${incident.incident_id}`);
52
+ console.log(`Symptom: ${incident.symptom}`);
53
+ console.log(`Quality Score: ${((incident.completeness?.quality_score || 0) * 100).toFixed(0)}%`);
54
+ console.log(`Verification: ${incident.verification?.status || 'unverified'}`);
55
+ console.log(`Tags: [${incident.tags.join(', ')}]`);
56
+ // Show what's missing
57
+ const validation = (0, storage_1.validateIncident)(incident);
58
+ if (validation.warnings.length > 0) {
59
+ console.log(`\n⚠️ Issues:`);
60
+ validation.warnings.forEach(w => console.log(` - ${w}`));
61
+ }
62
+ const response = await (0, prompts_1.default)({
63
+ type: 'select',
64
+ name: 'action',
65
+ message: 'What would you like to do?',
66
+ choices: [
67
+ { title: 'Skip (review later)', value: 'skip' },
68
+ { title: 'Complete now (interactive)', value: 'complete' },
69
+ { title: 'Delete (invalid incident)', value: 'delete' },
70
+ { title: 'Stop (exit batch review)', value: 'stop' }
71
+ ]
72
+ });
73
+ if (!response.action || response.action === 'stop') {
74
+ console.log('\n⏹️ Batch review stopped');
75
+ break;
76
+ }
77
+ if (response.action === 'skip') {
78
+ skipped++;
79
+ continue;
80
+ }
81
+ if (response.action === 'delete') {
82
+ const confirm = await (0, prompts_1.default)({
83
+ type: 'confirm',
84
+ name: 'value',
85
+ message: 'Are you sure you want to delete this incident?',
86
+ initial: false
87
+ });
88
+ if (confirm.value) {
89
+ await deleteIncident(incident.incident_id, config);
90
+ deleted++;
91
+ console.log('✅ Incident deleted');
92
+ }
93
+ else {
94
+ skipped++;
95
+ }
96
+ continue;
97
+ }
98
+ if (response.action === 'complete') {
99
+ // Interactive completion
100
+ const updated = await completeIncidentInteractive(incident);
101
+ if (updated) {
102
+ await (0, storage_1.storeIncident)(updated, { config, validate_schema: true });
103
+ completed++;
104
+ console.log('✅ Incident updated and saved');
105
+ }
106
+ else {
107
+ skipped++;
108
+ }
109
+ }
110
+ }
111
+ console.log('\n═══════════════════════════════════════════════');
112
+ console.log('📊 Batch Review Summary:');
113
+ console.log(` Completed: ${completed}`);
114
+ console.log(` Skipped: ${skipped}`);
115
+ console.log(` Deleted: ${deleted}`);
116
+ console.log('');
117
+ }
118
+ /**
119
+ * Extract patterns from existing incidents in batch
120
+ */
121
+ async function batchExtractPatterns(options) {
122
+ const { category, minIncidents = 3, config } = options || {};
123
+ console.log('\n🔍 Batch Pattern Extraction');
124
+ console.log('═══════════════════════════════════════════════\n');
125
+ if (category) {
126
+ console.log(` Category filter: ${category}`);
127
+ }
128
+ console.log(` Minimum incidents: ${minIncidents}\n`);
129
+ // Extract patterns
130
+ const patterns = await (0, pattern_extractor_1.extractPatterns)({
131
+ min_incidents: minIncidents,
132
+ min_similarity: 0.6,
133
+ auto_store: true,
134
+ config
135
+ });
136
+ if (patterns.length === 0) {
137
+ console.log('ℹ️ No patterns extracted. Need more similar incidents.\n');
138
+ return [];
139
+ }
140
+ // Filter by category if specified
141
+ const filtered = category
142
+ ? patterns.filter(p => p.tags.includes(category.toLowerCase()))
143
+ : patterns;
144
+ console.log('\n═══════════════════════════════════════════════');
145
+ console.log('📊 Pattern Extraction Summary:');
146
+ console.log(` Patterns extracted: ${filtered.length}`);
147
+ console.log(` Stored to disk: ${filtered.length}`);
148
+ console.log('');
149
+ return filtered;
150
+ }
151
+ /**
152
+ * Clean up old sessions and empty incidents
153
+ */
154
+ async function batchCleanup(options) {
155
+ const { olderThanDays = 90, dryRun = false, config } = options || {};
156
+ console.log('\n🧹 Batch Cleanup');
157
+ console.log('═══════════════════════════════════════════════\n');
158
+ if (dryRun) {
159
+ console.log('🔍 DRY RUN MODE - No files will be deleted\n');
160
+ }
161
+ const paths = (0, config_1.getMemoryPaths)(config);
162
+ const cutoffTime = Date.now() - olderThanDays * 24 * 60 * 60 * 1000;
163
+ const cutoffDate = new Date(cutoffTime);
164
+ console.log(`Looking for sessions older than ${cutoffDate.toLocaleDateString()}...\n`);
165
+ // Clean up sessions
166
+ const sessionsDir = paths.sessions;
167
+ let sessionsDeleted = 0;
168
+ try {
169
+ const sessionFiles = await promises_1.default.readdir(sessionsDir);
170
+ for (const file of sessionFiles) {
171
+ if (!file.endsWith('.json'))
172
+ continue;
173
+ const filepath = path_1.default.join(sessionsDir, file);
174
+ const stats = await promises_1.default.stat(filepath);
175
+ if (stats.mtimeMs < cutoffTime) {
176
+ console.log(` Old session: ${file} (${stats.mtime.toLocaleDateString()})`);
177
+ if (!dryRun) {
178
+ await promises_1.default.unlink(filepath);
179
+ sessionsDeleted++;
180
+ }
181
+ }
182
+ }
183
+ }
184
+ catch (error) {
185
+ if (error.code !== 'ENOENT') {
186
+ console.error('Error cleaning sessions:', error);
187
+ }
188
+ }
189
+ // Find incidents with quality issues
190
+ const incidents = await (0, storage_1.loadAllIncidents)(config);
191
+ const problematic = incidents.filter(inc => {
192
+ const tooOld = inc.timestamp < cutoffTime;
193
+ const lowQuality = (inc.completeness?.quality_score ?? 0) < 0.4;
194
+ const noTags = (inc.tags ?? []).length === 0;
195
+ return tooOld && (lowQuality || noTags);
196
+ });
197
+ console.log(`\nFound ${problematic.length} problematic incidents:`);
198
+ problematic.forEach(inc => {
199
+ const date = new Date(inc.timestamp);
200
+ const dateStr = isNaN(date.getTime()) ? 'Unknown' : date.toLocaleDateString();
201
+ const score = inc.completeness?.quality_score ?? 0;
202
+ console.log(` ${inc.incident_id} - ${dateStr} - Score: ${(score * 100).toFixed(0)}%`);
203
+ });
204
+ if (problematic.length > 0 && !dryRun) {
205
+ const confirm = await (0, prompts_1.default)({
206
+ type: 'confirm',
207
+ name: 'value',
208
+ message: `Delete ${problematic.length} low-quality incidents?`,
209
+ initial: false
210
+ });
211
+ if (confirm.value) {
212
+ for (const inc of problematic) {
213
+ await deleteIncident(inc.incident_id, config);
214
+ }
215
+ console.log(`✅ Deleted ${problematic.length} incidents`);
216
+ }
217
+ }
218
+ console.log('\n═══════════════════════════════════════════════');
219
+ console.log('📊 Cleanup Summary:');
220
+ console.log(` Sessions deleted: ${dryRun ? 0 : sessionsDeleted}`);
221
+ console.log(` Incidents deleted: ${dryRun ? 0 : problematic.length}`);
222
+ if (dryRun) {
223
+ console.log('\n💡 Run without --dry-run to actually delete files');
224
+ }
225
+ console.log('');
226
+ }
227
+ /**
228
+ * Complete incident interactively
229
+ */
230
+ async function completeIncidentInteractive(incident) {
231
+ console.log('\n📝 Complete Incident Interactively\n');
232
+ // Check what's missing
233
+ const needsRootCause = !incident.root_cause.description || incident.root_cause.confidence < 0.5;
234
+ const needsFix = !incident.fix.approach || incident.fix.changes.length === 0;
235
+ const needsVerification = incident.verification.status === 'unverified';
236
+ if (needsRootCause) {
237
+ const rootCauseResponse = await (0, prompts_1.default)([
238
+ {
239
+ type: 'text',
240
+ name: 'description',
241
+ message: 'Root cause description:',
242
+ initial: incident.root_cause.description || ''
243
+ },
244
+ {
245
+ type: 'text',
246
+ name: 'category',
247
+ message: 'Category (e.g., react-hooks, api, config):',
248
+ initial: incident.root_cause.category || ''
249
+ },
250
+ {
251
+ type: 'number',
252
+ name: 'confidence',
253
+ message: 'Confidence (0-1):',
254
+ initial: incident.root_cause.confidence || 0.8,
255
+ min: 0,
256
+ max: 1,
257
+ increment: 0.1
258
+ }
259
+ ]);
260
+ if (rootCauseResponse.description) {
261
+ incident.root_cause = {
262
+ ...incident.root_cause,
263
+ description: rootCauseResponse.description,
264
+ category: rootCauseResponse.category,
265
+ confidence: rootCauseResponse.confidence
266
+ };
267
+ }
268
+ }
269
+ if (needsFix) {
270
+ const fixResponse = await (0, prompts_1.default)([
271
+ {
272
+ type: 'text',
273
+ name: 'approach',
274
+ message: 'Fix approach:',
275
+ initial: incident.fix.approach || ''
276
+ },
277
+ {
278
+ type: 'list',
279
+ name: 'files',
280
+ message: 'Files changed (comma-separated):',
281
+ initial: incident.files_changed.join(', ')
282
+ }
283
+ ]);
284
+ if (fixResponse.approach) {
285
+ incident.fix.approach = fixResponse.approach;
286
+ if (fixResponse.files) {
287
+ const files = fixResponse.files.split(',').map((f) => f.trim()).filter(Boolean);
288
+ incident.files_changed = files;
289
+ incident.fix.changes = files.map((file) => ({
290
+ file,
291
+ lines_changed: 10,
292
+ change_type: 'modify',
293
+ summary: 'Updated'
294
+ }));
295
+ }
296
+ }
297
+ }
298
+ if (needsVerification) {
299
+ const verifyResponse = await (0, prompts_1.default)({
300
+ type: 'select',
301
+ name: 'status',
302
+ message: 'Verification status:',
303
+ choices: [
304
+ { title: 'Verified', value: 'verified' },
305
+ { title: 'Partially verified', value: 'partial' },
306
+ { title: 'Unverified', value: 'unverified' }
307
+ ]
308
+ });
309
+ if (verifyResponse.status) {
310
+ incident.verification.status = verifyResponse.status;
311
+ incident.verification.success_criteria_met = verifyResponse.status === 'verified';
312
+ }
313
+ }
314
+ // Remove incomplete tag
315
+ incident.tags = incident.tags.filter(t => t !== 'incomplete');
316
+ // Recalculate completeness
317
+ incident.completeness = {
318
+ symptom: !!incident.symptom,
319
+ root_cause: !!incident.root_cause.description && incident.root_cause.confidence >= 0.5,
320
+ fix: !!incident.fix.approach && incident.fix.changes.length > 0,
321
+ verification: incident.verification.status !== 'unverified',
322
+ quality_score: (0, interactive_verifier_1.calculateQualityScore)(incident)
323
+ };
324
+ return incident;
325
+ }
326
+ /**
327
+ * Delete an incident file
328
+ */
329
+ async function deleteIncident(incident_id, config) {
330
+ const paths = (0, config_1.getMemoryPaths)(config);
331
+ const filepath = path_1.default.join(paths.incidents, `${incident_id}.json`);
332
+ try {
333
+ await promises_1.default.unlink(filepath);
334
+ }
335
+ catch (error) {
336
+ console.error(`Failed to delete ${incident_id}:`, error);
337
+ }
338
+ }
339
+ //# sourceMappingURL=batch-operations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"batch-operations.js","sourceRoot":"","sources":["../../src/batch-operations.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Configuration System
3
+ *
4
+ * Supports two modes:
5
+ * - local: Each project has its own .claude/memory/ directory
6
+ * - shared: All projects share ~/.claude-memory/ directory
7
+ */
8
+ export interface MemoryConfig {
9
+ /** Storage mode: local (per-project) or shared (global) */
10
+ storageMode: 'local' | 'shared';
11
+ /** Path to memory directory */
12
+ memoryPath: string;
13
+ /** Whether to automatically mine audit trail on startup */
14
+ autoMine: boolean;
15
+ /** Similarity threshold for retrieval (0-1) */
16
+ defaultSimilarityThreshold: number;
17
+ /** Maximum results to return */
18
+ defaultMaxResults: number;
19
+ }
20
+ /**
21
+ * Get configuration from environment variables and defaults
22
+ */
23
+ export declare function getConfig(overrides?: Partial<MemoryConfig>): MemoryConfig;
24
+ /**
25
+ * Get paths for different memory components
26
+ */
27
+ export declare function getMemoryPaths(config?: MemoryConfig): {
28
+ incidents: string;
29
+ patterns: string;
30
+ sessions: string;
31
+ root: string;
32
+ };
33
+ /**
34
+ * Display current configuration
35
+ */
36
+ export declare function displayConfig(config?: MemoryConfig): void;
37
+ import type { TokenBudget } from './types';
38
+ /**
39
+ * Token configuration for context injection
40
+ */
41
+ export interface TokenConfig {
42
+ /** Total token budget for memory context */
43
+ budget: TokenBudget;
44
+ /** Default retrieval tier */
45
+ defaultTier: 'summary' | 'compact' | 'full';
46
+ /** Auto-adjust tier if budget exceeded */
47
+ autoAdjust: boolean;
48
+ }
49
+ /**
50
+ * Get token configuration from environment variables
51
+ *
52
+ * Environment variables:
53
+ * - CLAUDE_MEMORY_TOKEN_BUDGET: Total token budget (default: 2500)
54
+ * - CLAUDE_MEMORY_TIER: Default retrieval tier (summary|compact|full, default: compact)
55
+ * - CLAUDE_MEMORY_AUTO_ADJUST: Auto-adjust tier if over budget (true|false, default: true)
56
+ */
57
+ export declare function getTokenConfig(overrides?: Partial<TokenConfig>): TokenConfig;
58
+ /**
59
+ * Display token configuration
60
+ */
61
+ export declare function displayTokenConfig(config?: TokenConfig): void;
62
+ /**
63
+ * Get paths for internal logger storage
64
+ *
65
+ * Logs are stored under .build-loop/logs/debugging/ in the project root.
66
+ * Separate from memory paths — these are operational logs, not debugging incidents.
67
+ */
68
+ export declare function getLogPaths(): {
69
+ root: string;
70
+ operations: string;
71
+ errors: string;
72
+ };
73
+ /**
74
+ * Get paths for trace storage
75
+ */
76
+ export declare function getTracePaths(config?: MemoryConfig): {
77
+ traces: string;
78
+ index: string;
79
+ collections: string;
80
+ raw: string;
81
+ correlations: string;
82
+ };
83
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAKH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC;IAEhC,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IAEnB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAElB,+CAA+C;IAC/C,0BAA0B,EAAE,MAAM,CAAC;IAEnC,gCAAgC;IAChC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CA2BzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,YAAY;;;;;EASnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CASzD;AAMD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,MAAM,EAAE,WAAW,CAAC;IACpB,6BAA6B;IAC7B,WAAW,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC5C,0CAA0C;IAC1C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAyB5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAS7D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW;;;;EAM1B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,YAAY;;;;;;EAUlD"}
@@ -0,0 +1,176 @@
1
+ "use strict";
2
+ // SPDX-FileCopyrightText: 2025-2026 Tyrone Ross, Jr <46267523+tyroneross@users.noreply.github.com>
3
+ // SPDX-License-Identifier: Apache-2.0
4
+ /**
5
+ * Configuration System
6
+ *
7
+ * Supports two modes:
8
+ * - local: Each project has its own .claude/memory/ directory
9
+ * - shared: All projects share ~/.claude-memory/ directory
10
+ */
11
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
12
+ if (k2 === undefined) k2 = k;
13
+ var desc = Object.getOwnPropertyDescriptor(m, k);
14
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
15
+ desc = { enumerable: true, get: function() { return m[k]; } };
16
+ }
17
+ Object.defineProperty(o, k2, desc);
18
+ }) : (function(o, m, k, k2) {
19
+ if (k2 === undefined) k2 = k;
20
+ o[k2] = m[k];
21
+ }));
22
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
23
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
24
+ }) : function(o, v) {
25
+ o["default"] = v;
26
+ });
27
+ var __importStar = (this && this.__importStar) || (function () {
28
+ var ownKeys = function(o) {
29
+ ownKeys = Object.getOwnPropertyNames || function (o) {
30
+ var ar = [];
31
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
32
+ return ar;
33
+ };
34
+ return ownKeys(o);
35
+ };
36
+ return function (mod) {
37
+ if (mod && mod.__esModule) return mod;
38
+ var result = {};
39
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
40
+ __setModuleDefault(result, mod);
41
+ return result;
42
+ };
43
+ })();
44
+ Object.defineProperty(exports, "__esModule", { value: true });
45
+ exports.getConfig = getConfig;
46
+ exports.getMemoryPaths = getMemoryPaths;
47
+ exports.displayConfig = displayConfig;
48
+ exports.getTokenConfig = getTokenConfig;
49
+ exports.displayTokenConfig = displayTokenConfig;
50
+ exports.getLogPaths = getLogPaths;
51
+ exports.getTracePaths = getTracePaths;
52
+ const path = __importStar(require("path"));
53
+ const os = __importStar(require("os"));
54
+ /**
55
+ * Get configuration from environment variables and defaults
56
+ */
57
+ function getConfig(overrides) {
58
+ // Check environment variable for mode
59
+ const mode = process.env.CLAUDE_MEMORY_MODE || 'local';
60
+ // Determine memory path based on mode
61
+ let memoryPath;
62
+ if (mode === 'shared') {
63
+ // Shared mode: Use home directory
64
+ const customPath = process.env.CLAUDE_MEMORY_PATH;
65
+ memoryPath = customPath || path.join(os.homedir(), '.claude-memory');
66
+ }
67
+ else {
68
+ // Local mode: Use current working directory
69
+ const customPath = process.env.CLAUDE_MEMORY_PATH;
70
+ memoryPath = customPath || path.join(process.cwd(), '.claude/memory');
71
+ }
72
+ const config = {
73
+ storageMode: mode,
74
+ memoryPath,
75
+ autoMine: process.env.CLAUDE_MEMORY_AUTO_MINE === 'true',
76
+ defaultSimilarityThreshold: parseFloat(process.env.CLAUDE_MEMORY_THRESHOLD || '0.5'),
77
+ defaultMaxResults: parseInt(process.env.CLAUDE_MEMORY_MAX_RESULTS || '5', 10),
78
+ ...overrides
79
+ };
80
+ return config;
81
+ }
82
+ /**
83
+ * Get paths for different memory components
84
+ */
85
+ function getMemoryPaths(config) {
86
+ const cfg = config || getConfig();
87
+ return {
88
+ incidents: path.join(cfg.memoryPath, 'incidents'),
89
+ patterns: path.join(cfg.memoryPath, 'patterns'),
90
+ sessions: path.join(cfg.memoryPath, 'sessions'),
91
+ root: cfg.memoryPath
92
+ };
93
+ }
94
+ /**
95
+ * Display current configuration
96
+ */
97
+ function displayConfig(config) {
98
+ const cfg = config || getConfig();
99
+ console.log('📊 Memory Configuration:\n');
100
+ console.log(` Mode: ${cfg.storageMode}`);
101
+ console.log(` Path: ${cfg.memoryPath}`);
102
+ console.log(` Auto-mine: ${cfg.autoMine ? 'enabled' : 'disabled'}`);
103
+ console.log(` Similarity threshold: ${(cfg.defaultSimilarityThreshold * 100).toFixed(0)}%`);
104
+ console.log(` Max results: ${cfg.defaultMaxResults}\n`);
105
+ }
106
+ /**
107
+ * Get token configuration from environment variables
108
+ *
109
+ * Environment variables:
110
+ * - CLAUDE_MEMORY_TOKEN_BUDGET: Total token budget (default: 2500)
111
+ * - CLAUDE_MEMORY_TIER: Default retrieval tier (summary|compact|full, default: compact)
112
+ * - CLAUDE_MEMORY_AUTO_ADJUST: Auto-adjust tier if over budget (true|false, default: true)
113
+ */
114
+ function getTokenConfig(overrides) {
115
+ const totalBudget = parseInt(process.env.CLAUDE_MEMORY_TOKEN_BUDGET || '2500', 10);
116
+ const tier = process.env.CLAUDE_MEMORY_TIER || 'compact';
117
+ const autoAdjust = process.env.CLAUDE_MEMORY_AUTO_ADJUST !== 'false';
118
+ const config = {
119
+ budget: {
120
+ total: totalBudget,
121
+ allocated: {
122
+ patterns: Math.floor(totalBudget * 0.3),
123
+ incidents: Math.floor(totalBudget * 0.6),
124
+ metadata: Math.floor(totalBudget * 0.1),
125
+ },
126
+ perItem: {
127
+ pattern: 120,
128
+ incident: 200,
129
+ summary: 100,
130
+ },
131
+ },
132
+ defaultTier: tier,
133
+ autoAdjust,
134
+ ...overrides,
135
+ };
136
+ return config;
137
+ }
138
+ /**
139
+ * Display token configuration
140
+ */
141
+ function displayTokenConfig(config) {
142
+ const cfg = config || getTokenConfig();
143
+ console.log('🎯 Token Configuration:\n');
144
+ console.log(` Total budget: ${cfg.budget.total} tokens`);
145
+ console.log(` Patterns allocation: ${cfg.budget.allocated.patterns} tokens`);
146
+ console.log(` Incidents allocation: ${cfg.budget.allocated.incidents} tokens`);
147
+ console.log(` Default tier: ${cfg.defaultTier}`);
148
+ console.log(` Auto-adjust: ${cfg.autoAdjust ? 'enabled' : 'disabled'}\n`);
149
+ }
150
+ /**
151
+ * Get paths for internal logger storage
152
+ *
153
+ * Logs are stored under .build-loop/logs/debugging/ in the project root.
154
+ * Separate from memory paths — these are operational logs, not debugging incidents.
155
+ */
156
+ function getLogPaths() {
157
+ return {
158
+ root: path.join(process.cwd(), '.build-loop', 'logs', 'debugging'),
159
+ operations: path.join(process.cwd(), '.build-loop', 'logs', 'debugging', 'operations.jsonl'),
160
+ errors: path.join(process.cwd(), '.build-loop', 'logs', 'debugging', 'errors.jsonl'),
161
+ };
162
+ }
163
+ /**
164
+ * Get paths for trace storage
165
+ */
166
+ function getTracePaths(config) {
167
+ const cfg = config || getConfig();
168
+ return {
169
+ traces: path.join(cfg.memoryPath, 'traces'),
170
+ index: path.join(cfg.memoryPath, 'traces', 'index.json'),
171
+ collections: path.join(cfg.memoryPath, 'traces', 'collections'),
172
+ raw: path.join(cfg.memoryPath, 'traces', 'raw'),
173
+ correlations: path.join(cfg.memoryPath, 'correlations'),
174
+ };
175
+ }
176
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}