@su-record/vibe 2.7.18 → 2.7.20

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 (345) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +153 -153
  3. package/LICENSE +21 -21
  4. package/README.md +451 -449
  5. package/agents/architect-low.md +41 -41
  6. package/agents/architect-medium.md +59 -59
  7. package/agents/architect.md +80 -80
  8. package/agents/build-error-resolver.md +115 -115
  9. package/agents/compounder.md +261 -261
  10. package/agents/diagrammer.md +178 -178
  11. package/agents/docs/api-documenter.md +99 -99
  12. package/agents/docs/changelog-writer.md +93 -93
  13. package/agents/e2e-tester.md +294 -294
  14. package/agents/event/event-comms.md +78 -0
  15. package/agents/event/event-content.md +68 -0
  16. package/agents/event/event-image.md +95 -0
  17. package/agents/event/event-ops.md +84 -0
  18. package/agents/event/event-scheduler.md +69 -0
  19. package/agents/event/event-speaker.md +86 -0
  20. package/agents/explorer-low.md +42 -42
  21. package/agents/explorer-medium.md +59 -59
  22. package/agents/explorer.md +48 -48
  23. package/agents/implementer-low.md +43 -43
  24. package/agents/implementer-medium.md +52 -52
  25. package/agents/implementer.md +54 -54
  26. package/agents/junior-mentor.md +141 -141
  27. package/agents/planning/requirements-analyst.md +84 -84
  28. package/agents/planning/ux-advisor.md +83 -83
  29. package/agents/qa/acceptance-tester.md +86 -86
  30. package/agents/qa/edge-case-finder.md +93 -93
  31. package/agents/refactor-cleaner.md +143 -143
  32. package/agents/research/best-practices-agent.md +199 -199
  33. package/agents/research/codebase-patterns-agent.md +157 -157
  34. package/agents/research/framework-docs-agent.md +188 -188
  35. package/agents/research/security-advisory-agent.md +213 -213
  36. package/agents/review/architecture-reviewer.md +107 -107
  37. package/agents/review/complexity-reviewer.md +116 -116
  38. package/agents/review/data-integrity-reviewer.md +88 -88
  39. package/agents/review/git-history-reviewer.md +103 -103
  40. package/agents/review/performance-reviewer.md +86 -86
  41. package/agents/review/python-reviewer.md +150 -150
  42. package/agents/review/rails-reviewer.md +139 -139
  43. package/agents/review/react-reviewer.md +144 -144
  44. package/agents/review/security-reviewer.md +80 -80
  45. package/agents/review/simplicity-reviewer.md +140 -140
  46. package/agents/review/test-coverage-reviewer.md +116 -116
  47. package/agents/review/typescript-reviewer.md +127 -127
  48. package/agents/searcher.md +54 -54
  49. package/agents/simplifier.md +120 -120
  50. package/agents/tester.md +49 -49
  51. package/agents/ui/ui-a11y-auditor.md +93 -93
  52. package/agents/ui/ui-antipattern-detector.md +94 -94
  53. package/agents/ui/ui-dataviz-advisor.md +69 -69
  54. package/agents/ui/ui-design-system-gen.md +57 -57
  55. package/agents/ui/ui-industry-analyzer.md +49 -49
  56. package/agents/ui/ui-layout-architect.md +65 -65
  57. package/agents/ui/ui-stack-implementer.md +68 -68
  58. package/agents/ui/ux-compliance-reviewer.md +81 -81
  59. package/agents/ui-previewer.md +258 -258
  60. package/commands/vibe.analyze.md +379 -379
  61. package/commands/vibe.event.md +163 -0
  62. package/commands/vibe.review.md +607 -607
  63. package/commands/vibe.run.md +2217 -2124
  64. package/commands/vibe.spec.md +1195 -1195
  65. package/commands/vibe.spec.review.md +569 -569
  66. package/commands/vibe.trace.md +50 -0
  67. package/commands/vibe.utils.md +413 -413
  68. package/commands/vibe.verify.md +484 -484
  69. package/dist/__tests__/architecture.test.d.ts +2 -0
  70. package/dist/__tests__/architecture.test.d.ts.map +1 -0
  71. package/dist/__tests__/architecture.test.js +207 -0
  72. package/dist/__tests__/architecture.test.js.map +1 -0
  73. package/dist/cli/auth.js +3 -3
  74. package/dist/cli/auth.js.map +1 -1
  75. package/dist/cli/collaborator.js +52 -52
  76. package/dist/cli/commands/evolution.js +12 -12
  77. package/dist/cli/commands/info.d.ts.map +1 -1
  78. package/dist/cli/commands/info.js +45 -81
  79. package/dist/cli/commands/info.js.map +1 -1
  80. package/dist/cli/commands/init.js +5 -5
  81. package/dist/cli/commands/remove.js +14 -14
  82. package/dist/cli/commands/sentinel.js +27 -27
  83. package/dist/cli/commands/skills.js +5 -5
  84. package/dist/cli/commands/slack.js +10 -10
  85. package/dist/cli/commands/telegram.js +12 -12
  86. package/dist/cli/detect.d.ts.map +1 -1
  87. package/dist/cli/detect.js +55 -32
  88. package/dist/cli/detect.js.map +1 -1
  89. package/dist/cli/index.d.ts +1 -1
  90. package/dist/cli/index.d.ts.map +1 -1
  91. package/dist/cli/index.js +52 -52
  92. package/dist/cli/index.js.map +1 -1
  93. package/dist/cli/llm/claude-commands.js +16 -16
  94. package/dist/cli/llm/config.js +18 -18
  95. package/dist/cli/llm/gemini-commands.js +16 -16
  96. package/dist/cli/llm/gpt-commands.js +19 -19
  97. package/dist/cli/llm/help.js +21 -21
  98. package/dist/cli/postinstall/constants.d.ts.map +1 -1
  99. package/dist/cli/postinstall/constants.js +24 -0
  100. package/dist/cli/postinstall/constants.js.map +1 -1
  101. package/dist/cli/postinstall/cursor-agents.js +32 -32
  102. package/dist/cli/postinstall/cursor-rules.js +83 -83
  103. package/dist/cli/postinstall/cursor-skills.js +743 -743
  104. package/dist/cli/setup/Provisioner.js +42 -42
  105. package/dist/infra/lib/AutomationLevel.d.ts +48 -0
  106. package/dist/infra/lib/AutomationLevel.d.ts.map +1 -0
  107. package/dist/infra/lib/AutomationLevel.js +157 -0
  108. package/dist/infra/lib/AutomationLevel.js.map +1 -0
  109. package/dist/infra/lib/DecisionTracer.d.ts +81 -0
  110. package/dist/infra/lib/DecisionTracer.d.ts.map +1 -0
  111. package/dist/infra/lib/DecisionTracer.js +135 -0
  112. package/dist/infra/lib/DecisionTracer.js.map +1 -0
  113. package/dist/infra/lib/DeepInit.js +24 -24
  114. package/dist/infra/lib/InteractiveCheckpoint.d.ts +75 -0
  115. package/dist/infra/lib/InteractiveCheckpoint.d.ts.map +1 -0
  116. package/dist/infra/lib/InteractiveCheckpoint.js +179 -0
  117. package/dist/infra/lib/InteractiveCheckpoint.js.map +1 -0
  118. package/dist/infra/lib/IterationTracker.d.ts +44 -0
  119. package/dist/infra/lib/IterationTracker.d.ts.map +1 -1
  120. package/dist/infra/lib/IterationTracker.js +267 -12
  121. package/dist/infra/lib/IterationTracker.js.map +1 -1
  122. package/dist/infra/lib/LoopBreaker.d.ts +56 -0
  123. package/dist/infra/lib/LoopBreaker.d.ts.map +1 -0
  124. package/dist/infra/lib/LoopBreaker.js +109 -0
  125. package/dist/infra/lib/LoopBreaker.js.map +1 -0
  126. package/dist/infra/lib/PythonParser.js +108 -108
  127. package/dist/infra/lib/ReviewRace.js +96 -96
  128. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  129. package/dist/infra/lib/SkillQualityGate.js +9 -9
  130. package/dist/infra/lib/SkillRepository.js +159 -159
  131. package/dist/infra/lib/UltraQA.js +99 -99
  132. package/dist/infra/lib/VerificationLoop.d.ts +105 -0
  133. package/dist/infra/lib/VerificationLoop.d.ts.map +1 -0
  134. package/dist/infra/lib/VerificationLoop.js +189 -0
  135. package/dist/infra/lib/VerificationLoop.js.map +1 -0
  136. package/dist/infra/lib/__tests__/AutomationLevel.test.d.ts +2 -0
  137. package/dist/infra/lib/__tests__/AutomationLevel.test.d.ts.map +1 -0
  138. package/dist/infra/lib/__tests__/AutomationLevel.test.js +297 -0
  139. package/dist/infra/lib/__tests__/AutomationLevel.test.js.map +1 -0
  140. package/dist/infra/lib/__tests__/DecisionTracer.test.d.ts +2 -0
  141. package/dist/infra/lib/__tests__/DecisionTracer.test.d.ts.map +1 -0
  142. package/dist/infra/lib/__tests__/DecisionTracer.test.js +274 -0
  143. package/dist/infra/lib/__tests__/DecisionTracer.test.js.map +1 -0
  144. package/dist/infra/lib/__tests__/InteractiveCheckpoint.test.d.ts +2 -0
  145. package/dist/infra/lib/__tests__/InteractiveCheckpoint.test.d.ts.map +1 -0
  146. package/dist/infra/lib/__tests__/InteractiveCheckpoint.test.js +350 -0
  147. package/dist/infra/lib/__tests__/InteractiveCheckpoint.test.js.map +1 -0
  148. package/dist/infra/lib/__tests__/LoopBreaker.test.d.ts +2 -0
  149. package/dist/infra/lib/__tests__/LoopBreaker.test.d.ts.map +1 -0
  150. package/dist/infra/lib/__tests__/LoopBreaker.test.js +340 -0
  151. package/dist/infra/lib/__tests__/LoopBreaker.test.js.map +1 -0
  152. package/dist/infra/lib/__tests__/VerificationLoop.test.d.ts +2 -0
  153. package/dist/infra/lib/__tests__/VerificationLoop.test.d.ts.map +1 -0
  154. package/dist/infra/lib/__tests__/VerificationLoop.test.js +486 -0
  155. package/dist/infra/lib/__tests__/VerificationLoop.test.js.map +1 -0
  156. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  157. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  158. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  159. package/dist/infra/lib/autonomy/PolicyEngine.d.ts +3 -3
  160. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  161. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  162. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  163. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  164. package/dist/infra/lib/embedding/__tests__/EmbeddingProvider.test.js +4 -0
  165. package/dist/infra/lib/embedding/__tests__/EmbeddingProvider.test.js.map +1 -1
  166. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  167. package/dist/infra/lib/evolution/DeprecationDetector.d.ts +68 -0
  168. package/dist/infra/lib/evolution/DeprecationDetector.d.ts.map +1 -0
  169. package/dist/infra/lib/evolution/DeprecationDetector.js +207 -0
  170. package/dist/infra/lib/evolution/DeprecationDetector.js.map +1 -0
  171. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  172. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  173. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  174. package/dist/infra/lib/evolution/ParityTester.d.ts +74 -0
  175. package/dist/infra/lib/evolution/ParityTester.d.ts.map +1 -0
  176. package/dist/infra/lib/evolution/ParityTester.js +238 -0
  177. package/dist/infra/lib/evolution/ParityTester.js.map +1 -0
  178. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  179. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  180. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  181. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  182. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  183. package/dist/infra/lib/evolution/__tests__/deprecation.test.d.ts +2 -0
  184. package/dist/infra/lib/evolution/__tests__/deprecation.test.d.ts.map +1 -0
  185. package/dist/infra/lib/evolution/__tests__/deprecation.test.js +251 -0
  186. package/dist/infra/lib/evolution/__tests__/deprecation.test.js.map +1 -0
  187. package/dist/infra/lib/evolution/__tests__/parity.test.d.ts +2 -0
  188. package/dist/infra/lib/evolution/__tests__/parity.test.d.ts.map +1 -0
  189. package/dist/infra/lib/evolution/__tests__/parity.test.js +319 -0
  190. package/dist/infra/lib/evolution/__tests__/parity.test.js.map +1 -0
  191. package/dist/infra/lib/evolution/index.d.ts +4 -0
  192. package/dist/infra/lib/evolution/index.d.ts.map +1 -1
  193. package/dist/infra/lib/evolution/index.js +3 -0
  194. package/dist/infra/lib/evolution/index.js.map +1 -1
  195. package/dist/infra/lib/gemini/orchestration.js +5 -5
  196. package/dist/infra/lib/gpt/orchestration.js +4 -4
  197. package/dist/infra/lib/gpt/specializations.d.ts +1 -1
  198. package/dist/infra/lib/gpt/specializations.js +1 -1
  199. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  200. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  201. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  202. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  203. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  204. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  205. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  206. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  207. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts +6 -0
  208. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts.map +1 -1
  209. package/dist/infra/lib/telemetry/SkillTelemetry.js +11 -0
  210. package/dist/infra/lib/telemetry/SkillTelemetry.js.map +1 -1
  211. package/dist/infra/orchestrator/AgentManager.js +12 -12
  212. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  213. package/dist/infra/orchestrator/BackgroundManager.d.ts.map +1 -1
  214. package/dist/infra/orchestrator/BackgroundManager.js +2 -0
  215. package/dist/infra/orchestrator/BackgroundManager.js.map +1 -1
  216. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  217. package/dist/infra/orchestrator/PhasePipeline.js +1 -1
  218. package/dist/infra/orchestrator/PhasePipeline.js.map +1 -1
  219. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  220. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  221. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  222. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  223. package/dist/tools/index.d.ts +16 -19
  224. package/dist/tools/index.d.ts.map +1 -1
  225. package/dist/tools/index.js +15 -27
  226. package/dist/tools/index.js.map +1 -1
  227. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  228. package/dist/tools/memory/getMemoryGraph.js +12 -12
  229. package/dist/tools/memory/getSessionContext.js +9 -9
  230. package/dist/tools/memory/linkMemories.js +14 -14
  231. package/dist/tools/memory/listMemories.js +4 -4
  232. package/dist/tools/memory/recallMemory.js +4 -4
  233. package/dist/tools/memory/saveMemory.js +4 -4
  234. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  235. package/dist/tools/memory/startSession.js +1 -1
  236. package/dist/tools/memory/startSession.js.map +1 -1
  237. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  238. package/dist/tools/semantic/astGrep.test.js +6 -6
  239. package/dist/tools/spec/index.d.ts +0 -4
  240. package/dist/tools/spec/index.d.ts.map +1 -1
  241. package/dist/tools/spec/index.js +0 -4
  242. package/dist/tools/spec/index.js.map +1 -1
  243. package/dist/tools/spec/prdParser.test.js +171 -171
  244. package/dist/tools/spec/specGenerator.js +169 -169
  245. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  246. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  247. package/hooks/gemini-hooks.json +73 -73
  248. package/hooks/hooks.json +137 -137
  249. package/hooks/scripts/code-check.js +77 -77
  250. package/hooks/scripts/context-save.js +212 -212
  251. package/hooks/scripts/evolution-engine.js +69 -0
  252. package/hooks/scripts/hud-status.js +291 -291
  253. package/hooks/scripts/keyword-detector.js +214 -214
  254. package/hooks/scripts/llm-orchestrate.js +475 -475
  255. package/hooks/scripts/post-edit.js +32 -32
  256. package/hooks/scripts/pre-tool-guard.js +125 -125
  257. package/hooks/scripts/prompt-dispatcher.js +185 -185
  258. package/hooks/scripts/sentinel-guard.js +104 -104
  259. package/hooks/scripts/session-start.js +106 -106
  260. package/hooks/scripts/skill-injector.js +83 -0
  261. package/hooks/scripts/stop-notify.js +209 -209
  262. package/hooks/scripts/utils.js +100 -100
  263. package/languages/csharp-unity.md +515 -515
  264. package/languages/gdscript-godot.md +470 -470
  265. package/languages/ruby-rails.md +489 -489
  266. package/languages/typescript-angular.md +433 -433
  267. package/languages/typescript-astro.md +416 -416
  268. package/languages/typescript-electron.md +406 -406
  269. package/languages/typescript-nestjs.md +524 -524
  270. package/languages/typescript-svelte.md +407 -407
  271. package/languages/typescript-tauri.md +365 -365
  272. package/package.json +101 -123
  273. package/skills/agents-md/SKILL.md +120 -120
  274. package/skills/arch-guard/SKILL.md +180 -180
  275. package/skills/brand-assets/SKILL.md +146 -146
  276. package/skills/capability-loop/SKILL.md +167 -167
  277. package/skills/characterization-test/SKILL.md +206 -206
  278. package/skills/commerce-patterns/SKILL.md +63 -63
  279. package/skills/commit-push-pr/SKILL.md +75 -75
  280. package/skills/context7-usage/SKILL.md +105 -105
  281. package/skills/core-capabilities/SKILL.md +13 -13
  282. package/skills/e2e-commerce/SKILL.md +61 -61
  283. package/skills/event-comms/SKILL.md +161 -0
  284. package/skills/event-ops/SKILL.md +197 -0
  285. package/skills/event-planning/SKILL.md +131 -0
  286. package/skills/exec-plan/SKILL.md +147 -147
  287. package/skills/frontend-design/SKILL.md +12 -12
  288. package/skills/git-worktree/SKILL.md +72 -72
  289. package/skills/handoff/SKILL.md +109 -109
  290. package/skills/parallel-research/SKILL.md +87 -87
  291. package/skills/priority-todos/SKILL.md +63 -63
  292. package/skills/seo-checklist/SKILL.md +57 -57
  293. package/skills/techdebt/SKILL.md +122 -122
  294. package/skills/tool-fallback/SKILL.md +103 -103
  295. package/skills/typescript-advanced-types/SKILL.md +66 -66
  296. package/skills/ui-ux-pro-max/SKILL.md +221 -221
  297. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  298. package/skills/video-production/SKILL.md +51 -51
  299. package/vibe/config.json +29 -29
  300. package/vibe/constitution.md +227 -227
  301. package/vibe/rules/principles/communication-guide.md +98 -98
  302. package/vibe/rules/principles/development-philosophy.md +52 -52
  303. package/vibe/rules/principles/quick-start.md +102 -102
  304. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  305. package/vibe/rules/quality/checklist.md +276 -276
  306. package/vibe/rules/quality/performance.md +236 -236
  307. package/vibe/rules/quality/testing-strategy.md +440 -440
  308. package/vibe/rules/standards/anti-patterns.md +541 -541
  309. package/vibe/rules/standards/code-structure.md +291 -291
  310. package/vibe/rules/standards/complexity-metrics.md +313 -313
  311. package/vibe/rules/standards/git-workflow.md +237 -237
  312. package/vibe/rules/standards/naming-conventions.md +198 -198
  313. package/vibe/rules/standards/security.md +305 -305
  314. package/vibe/rules/writing/document-style.md +74 -74
  315. package/vibe/setup.sh +31 -31
  316. package/vibe/templates/constitution-template.md +252 -252
  317. package/vibe/templates/contract-backend-template.md +526 -526
  318. package/vibe/templates/contract-frontend-template.md +599 -599
  319. package/vibe/templates/feature-template.md +96 -96
  320. package/vibe/templates/spec-template.md +221 -221
  321. package/vibe/ui-ux-data/charts.csv +26 -26
  322. package/vibe/ui-ux-data/colors.csv +97 -97
  323. package/vibe/ui-ux-data/icons.csv +101 -101
  324. package/vibe/ui-ux-data/landing.csv +31 -31
  325. package/vibe/ui-ux-data/products.csv +96 -96
  326. package/vibe/ui-ux-data/react-performance.csv +45 -45
  327. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  328. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  329. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  330. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  331. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  332. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  333. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  334. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  335. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  336. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  337. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  338. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  339. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  340. package/vibe/ui-ux-data/styles.csv +68 -68
  341. package/vibe/ui-ux-data/typography.csv +57 -57
  342. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  343. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  344. package/vibe/ui-ux-data/version.json +31 -31
  345. package/vibe/ui-ux-data/web-interface.csv +31 -31
@@ -0,0 +1,207 @@
1
+ // DeprecationDetector - Phase 5: Model evolution-driven skill deprecation detection
2
+ //
3
+ // Scans all skills with eval data and produces a deprecation report by:
4
+ // 1. Classifying each skill (capability_uplift vs encoded_preference)
5
+ // 2. Checking baseline trend from benchmark history
6
+ // 3. Determining deprecation severity
7
+ // 4. Producing a structured report with actionable recommendations
8
+ import { randomUUID } from 'crypto';
9
+ import { SkillClassifier } from './SkillClassifier.js';
10
+ import { SkillBenchmark } from './SkillBenchmark.js';
11
+ import { SkillEvalRunner } from './SkillEvalRunner.js';
12
+ const IMMEDIATE_BASELINE_THRESHOLD = 0.85;
13
+ const SOON_BASELINE_THRESHOLD = 0.70;
14
+ export class DeprecationDetector {
15
+ classifier;
16
+ benchmark;
17
+ evalRunner;
18
+ db;
19
+ constructor(storage) {
20
+ this.classifier = new SkillClassifier(storage);
21
+ this.benchmark = new SkillBenchmark(storage);
22
+ this.evalRunner = new SkillEvalRunner(storage);
23
+ this.db = storage.getDatabase();
24
+ }
25
+ /**
26
+ * Scan all skills that have eval cases and produce deprecation report.
27
+ */
28
+ scan() {
29
+ const evaluatedSkillNames = this.getEvaluatedSkills();
30
+ const candidates = [];
31
+ const safeSkills = [];
32
+ const unevaluatedSkills = [];
33
+ for (const skillName of evaluatedSkillNames) {
34
+ const candidate = this.checkSkill(skillName);
35
+ if (candidate !== null) {
36
+ candidates.push(candidate);
37
+ }
38
+ else {
39
+ const classification = this.classifier.classify(skillName);
40
+ if (classification.category === 'encoded_preference') {
41
+ safeSkills.push(skillName);
42
+ }
43
+ else if (classification.category === 'unknown') {
44
+ unevaluatedSkills.push(skillName);
45
+ }
46
+ else {
47
+ safeSkills.push(skillName);
48
+ }
49
+ }
50
+ }
51
+ return {
52
+ id: `depr-${Date.now().toString(36)}-${randomUUID().replace(/-/g, '').slice(0, 8)}`,
53
+ timestamp: new Date().toISOString(),
54
+ totalSkills: evaluatedSkillNames.length,
55
+ evaluatedSkills: evaluatedSkillNames.length,
56
+ candidates,
57
+ safeSkills,
58
+ unevaluatedSkills,
59
+ summary: {
60
+ immediate: candidates.filter(c => c.severity === 'immediate').length,
61
+ soon: candidates.filter(c => c.severity === 'soon').length,
62
+ monitor: candidates.filter(c => c.severity === 'monitor').length,
63
+ safe: safeSkills.length,
64
+ unknown: unevaluatedSkills.length,
65
+ },
66
+ };
67
+ }
68
+ /**
69
+ * Check a single skill for deprecation candidacy.
70
+ * Returns null if the skill is not a deprecation candidate.
71
+ */
72
+ checkSkill(skillName) {
73
+ const classification = this.classifier.classify(skillName);
74
+ if (classification.category === 'encoded_preference') {
75
+ return null;
76
+ }
77
+ const latestBenchmark = this.benchmark.getLatest(skillName);
78
+ const { severity, reason, action } = this.determineSeverity(classification, latestBenchmark);
79
+ if (classification.category === 'unknown' && severity === 'monitor') {
80
+ return null;
81
+ }
82
+ return {
83
+ skillName,
84
+ classification,
85
+ latestBenchmark,
86
+ reason,
87
+ severity,
88
+ action,
89
+ };
90
+ }
91
+ /**
92
+ * Get all skill names that have eval cases in the DB.
93
+ */
94
+ getEvaluatedSkills() {
95
+ const rows = this.db.prepare('SELECT DISTINCT skillName FROM skill_eval_cases ORDER BY skillName ASC').all();
96
+ return rows.map(r => r.skillName);
97
+ }
98
+ /**
99
+ * Format deprecation report as markdown.
100
+ */
101
+ formatReport(report) {
102
+ const lines = [
103
+ '# Skill Deprecation Report',
104
+ '',
105
+ `**Report ID**: ${report.id}`,
106
+ `**Generated**: ${report.timestamp}`,
107
+ `**Total Skills Analyzed**: ${report.totalSkills}`,
108
+ '',
109
+ '## Summary',
110
+ '',
111
+ '| Status | Count |',
112
+ '|--------|-------|',
113
+ `| 🔴 Immediate | ${report.summary.immediate} |`,
114
+ `| 🟠 Soon | ${report.summary.soon} |`,
115
+ `| 🟡 Monitor | ${report.summary.monitor} |`,
116
+ `| 🟢 Safe | ${report.summary.safe} |`,
117
+ `| ⚪ Unknown | ${report.summary.unknown} |`,
118
+ '',
119
+ ];
120
+ if (report.candidates.length > 0) {
121
+ lines.push('## Deprecation Candidates', '');
122
+ for (const candidate of report.candidates) {
123
+ const icon = candidate.severity === 'immediate' ? '🔴' :
124
+ candidate.severity === 'soon' ? '🟠' : '🟡';
125
+ lines.push(`### ${icon} ${candidate.skillName} (${candidate.severity})`);
126
+ lines.push('');
127
+ lines.push(`**Category**: ${candidate.classification.category}`);
128
+ lines.push(`**Baseline Pass Rate**: ${pct(candidate.classification.baselinePassRate)}`);
129
+ lines.push(`**With-Skill Pass Rate**: ${pct(candidate.classification.withSkillPassRate)}`);
130
+ lines.push(`**Trend**: ${candidate.classification.trend}`);
131
+ lines.push(`**Reason**: ${candidate.reason}`);
132
+ lines.push(`**Action**: ${candidate.action}`);
133
+ lines.push('');
134
+ }
135
+ }
136
+ if (report.safeSkills.length > 0) {
137
+ lines.push('## Safe Skills (Encoded Preferences)', '');
138
+ for (const name of report.safeSkills) {
139
+ lines.push(`- 🟢 ${name}`);
140
+ }
141
+ lines.push('');
142
+ }
143
+ if (report.unevaluatedSkills.length > 0) {
144
+ lines.push('## Unknown Skills (Insufficient Data)', '');
145
+ for (const name of report.unevaluatedSkills) {
146
+ lines.push(`- ⚪ ${name}`);
147
+ }
148
+ lines.push('');
149
+ }
150
+ return lines.join('\n');
151
+ }
152
+ /**
153
+ * Determine severity based on classification and benchmark data.
154
+ */
155
+ determineSeverity(classification, benchmark) {
156
+ const blRate = classification.baselinePassRate;
157
+ const trend = classification.trend;
158
+ if (blRate >= IMMEDIATE_BASELINE_THRESHOLD && trend === 'converging') {
159
+ return {
160
+ severity: 'immediate',
161
+ reason: `Baseline pass rate is ${pct(blRate)} and converging — the model now handles this natively.`,
162
+ action: 'Retire this skill. It is no longer providing meaningful uplift.',
163
+ };
164
+ }
165
+ if (blRate >= IMMEDIATE_BASELINE_THRESHOLD) {
166
+ return {
167
+ severity: 'immediate',
168
+ reason: `Baseline pass rate is ${pct(blRate)} — model handles this well without the skill.`,
169
+ action: 'Schedule retirement. Verify with one more benchmark iteration.',
170
+ };
171
+ }
172
+ if (blRate >= SOON_BASELINE_THRESHOLD || (classification.category === 'capability_uplift' && trend === 'converging')) {
173
+ return {
174
+ severity: 'soon',
175
+ reason: buildSoonReason(blRate, classification.category, trend),
176
+ action: 'Plan deprecation in next model update cycle. Continue monitoring.',
177
+ };
178
+ }
179
+ if (classification.category === 'capability_uplift') {
180
+ return {
181
+ severity: 'monitor',
182
+ reason: `Capability uplift skill with baseline at ${pct(blRate)} — not yet converging but worth watching.`,
183
+ action: 'Re-evaluate after the next model upgrade.',
184
+ };
185
+ }
186
+ const benchmarkNote = benchmark ? ` (iteration ${benchmark.iteration})` : '';
187
+ return {
188
+ severity: 'monitor',
189
+ reason: `Insufficient signal to recommend deprecation${benchmarkNote}. Run more benchmarks.`,
190
+ action: 'Gather more benchmark data before deciding.',
191
+ };
192
+ }
193
+ }
194
+ // --- Helpers ---
195
+ function pct(value) {
196
+ return `${(value * 100).toFixed(1)}%`;
197
+ }
198
+ function buildSoonReason(blRate, category, trend) {
199
+ if (blRate >= SOON_BASELINE_THRESHOLD) {
200
+ return `Baseline pass rate is ${pct(blRate)} — approaching obsolescence threshold.`;
201
+ }
202
+ if (category === 'capability_uplift' && trend === 'converging') {
203
+ return 'Capability uplift skill showing converging trend — model is closing the gap.';
204
+ }
205
+ return `Capability uplift skill with ${pct(blRate)} baseline pass rate.`;
206
+ }
207
+ //# sourceMappingURL=DeprecationDetector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"DeprecationDetector.js","sourceRoot":"","sources":["../../../../src/infra/lib/evolution/DeprecationDetector.ts"],"names":[],"mappings":"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"}
@@ -17,20 +17,20 @@ export class DescriptionOptimizer {
17
17
  this.initializeTables();
18
18
  }
19
19
  initializeTables() {
20
- this.db.exec(`
21
- CREATE TABLE IF NOT EXISTS description_optimizations (
22
- id TEXT PRIMARY KEY,
23
- skillName TEXT NOT NULL,
24
- originalDescription TEXT NOT NULL,
25
- bestDescription TEXT NOT NULL,
26
- candidates TEXT NOT NULL,
27
- trainQueries TEXT NOT NULL,
28
- testQueries TEXT NOT NULL,
29
- improvement REAL DEFAULT 0,
30
- createdAt TEXT NOT NULL
31
- );
32
-
33
- CREATE INDEX IF NOT EXISTS idx_do_skill ON description_optimizations(skillName);
20
+ this.db.exec(`
21
+ CREATE TABLE IF NOT EXISTS description_optimizations (
22
+ id TEXT PRIMARY KEY,
23
+ skillName TEXT NOT NULL,
24
+ originalDescription TEXT NOT NULL,
25
+ bestDescription TEXT NOT NULL,
26
+ candidates TEXT NOT NULL,
27
+ trainQueries TEXT NOT NULL,
28
+ testQueries TEXT NOT NULL,
29
+ improvement REAL DEFAULT 0,
30
+ createdAt TEXT NOT NULL
31
+ );
32
+
33
+ CREATE INDEX IF NOT EXISTS idx_do_skill ON description_optimizations(skillName);
34
34
  `);
35
35
  }
36
36
  /**
@@ -183,9 +183,9 @@ export class DescriptionOptimizer {
183
183
  createdAt: now,
184
184
  };
185
185
  // Persist
186
- this.db.prepare(`
187
- INSERT INTO description_optimizations (id, skillName, originalDescription, bestDescription, candidates, trainQueries, testQueries, improvement, createdAt)
188
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
186
+ this.db.prepare(`
187
+ INSERT INTO description_optimizations (id, skillName, originalDescription, bestDescription, candidates, trainQueries, testQueries, improvement, createdAt)
188
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
189
189
  `).run(id, skillName, description, run.bestDescription, JSON.stringify(candidates), JSON.stringify(train), JSON.stringify(test), improvement, now);
190
190
  return run;
191
191
  }
@@ -193,8 +193,8 @@ export class DescriptionOptimizer {
193
193
  * Get optimization history for a skill
194
194
  */
195
195
  getHistory(skillName) {
196
- const rows = this.db.prepare(`
197
- SELECT * FROM description_optimizations WHERE skillName = ? ORDER BY createdAt ASC
196
+ const rows = this.db.prepare(`
197
+ SELECT * FROM description_optimizations WHERE skillName = ? ORDER BY createdAt ASC
198
198
  `).all(skillName);
199
199
  return rows.map(this.rowToRun);
200
200
  }
@@ -202,8 +202,8 @@ export class DescriptionOptimizer {
202
202
  * Get latest optimization for a skill
203
203
  */
204
204
  getLatest(skillName) {
205
- const row = this.db.prepare(`
206
- SELECT * FROM description_optimizations WHERE skillName = ? ORDER BY createdAt DESC LIMIT 1
205
+ const row = this.db.prepare(`
206
+ SELECT * FROM description_optimizations WHERE skillName = ? ORDER BY createdAt DESC LIMIT 1
207
207
  `).get(skillName);
208
208
  return row ? this.rowToRun(row) : null;
209
209
  }
@@ -8,38 +8,38 @@ export class GenerationRegistry {
8
8
  this.initializeTables();
9
9
  }
10
10
  initializeTables() {
11
- this.db.exec(`
12
- CREATE TABLE IF NOT EXISTS generations (
13
- id TEXT PRIMARY KEY,
14
- insightId TEXT,
15
- type TEXT NOT NULL CHECK(type IN ('skill','agent','rule')),
16
- name TEXT NOT NULL,
17
- content TEXT NOT NULL,
18
- filePath TEXT,
19
- status TEXT NOT NULL DEFAULT 'draft' CHECK(status IN ('draft','testing','active','disabled','deleted')),
20
- qualityScore INTEGER DEFAULT 0,
21
- triggerPatterns TEXT,
22
- usageCount INTEGER DEFAULT 0,
23
- lastUsedAt TEXT,
24
- ttlDays INTEGER DEFAULT 7,
25
- version INTEGER DEFAULT 1,
26
- parentId TEXT,
27
- createdAt TEXT NOT NULL,
28
- updatedAt TEXT NOT NULL
29
- );
30
-
31
- CREATE INDEX IF NOT EXISTS idx_gen_type ON generations(type);
32
- CREATE INDEX IF NOT EXISTS idx_gen_status ON generations(status);
33
- CREATE INDEX IF NOT EXISTS idx_gen_insight ON generations(insightId);
34
- CREATE INDEX IF NOT EXISTS idx_gen_name ON generations(name);
11
+ this.db.exec(`
12
+ CREATE TABLE IF NOT EXISTS generations (
13
+ id TEXT PRIMARY KEY,
14
+ insightId TEXT,
15
+ type TEXT NOT NULL CHECK(type IN ('skill','agent','rule')),
16
+ name TEXT NOT NULL,
17
+ content TEXT NOT NULL,
18
+ filePath TEXT,
19
+ status TEXT NOT NULL DEFAULT 'draft' CHECK(status IN ('draft','testing','active','disabled','deleted')),
20
+ qualityScore INTEGER DEFAULT 0,
21
+ triggerPatterns TEXT,
22
+ usageCount INTEGER DEFAULT 0,
23
+ lastUsedAt TEXT,
24
+ ttlDays INTEGER DEFAULT 7,
25
+ version INTEGER DEFAULT 1,
26
+ parentId TEXT,
27
+ createdAt TEXT NOT NULL,
28
+ updatedAt TEXT NOT NULL
29
+ );
30
+
31
+ CREATE INDEX IF NOT EXISTS idx_gen_type ON generations(type);
32
+ CREATE INDEX IF NOT EXISTS idx_gen_status ON generations(status);
33
+ CREATE INDEX IF NOT EXISTS idx_gen_insight ON generations(insightId);
34
+ CREATE INDEX IF NOT EXISTS idx_gen_name ON generations(name);
35
35
  `);
36
36
  }
37
37
  save(input) {
38
38
  const id = `gen-${Date.now().toString(36)}-${randomUUID().replace(/-/g, '').slice(0, 8)}`;
39
39
  const now = new Date().toISOString();
40
- this.db.prepare(`
41
- INSERT INTO generations (id, insightId, type, name, content, filePath, status, qualityScore, triggerPatterns, ttlDays, version, parentId, createdAt, updatedAt)
42
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
40
+ this.db.prepare(`
41
+ INSERT INTO generations (id, insightId, type, name, content, filePath, status, qualityScore, triggerPatterns, ttlDays, version, parentId, createdAt, updatedAt)
42
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
43
43
  `).run(id, input.insightId, input.type, input.name, input.content, input.filePath || null, input.status || 'draft', input.qualityScore || 0, JSON.stringify(input.triggerPatterns || []), input.ttlDays || 7, input.parentId ? 2 : 1, // version 2 if has parent
44
44
  input.parentId || null, now, now);
45
45
  return id;
@@ -64,20 +64,20 @@ export class GenerationRegistry {
64
64
  return rows.map(this.rowToGeneration);
65
65
  }
66
66
  getByStatus(status, limit = 50) {
67
- const rows = this.db.prepare(`
68
- SELECT * FROM generations WHERE status = ? ORDER BY updatedAt DESC LIMIT ?
67
+ const rows = this.db.prepare(`
68
+ SELECT * FROM generations WHERE status = ? ORDER BY updatedAt DESC LIMIT ?
69
69
  `).all(status, limit);
70
70
  return rows.map(this.rowToGeneration);
71
71
  }
72
72
  updateStatus(id, status) {
73
- const result = this.db.prepare(`
74
- UPDATE generations SET status = ?, updatedAt = ? WHERE id = ?
73
+ const result = this.db.prepare(`
74
+ UPDATE generations SET status = ?, updatedAt = ? WHERE id = ?
75
75
  `).run(status, new Date().toISOString(), id);
76
76
  return result.changes > 0;
77
77
  }
78
78
  incrementUsage(id) {
79
- this.db.prepare(`
80
- UPDATE generations SET usageCount = usageCount + 1, lastUsedAt = ?, updatedAt = ? WHERE id = ?
79
+ this.db.prepare(`
80
+ UPDATE generations SET usageCount = usageCount + 1, lastUsedAt = ?, updatedAt = ? WHERE id = ?
81
81
  `).run(new Date().toISOString(), new Date().toISOString(), id);
82
82
  }
83
83
  getStats() {
@@ -91,9 +91,9 @@ export class GenerationRegistry {
91
91
  return { total, byType, byStatus };
92
92
  }
93
93
  getRecentFailures(limit = 10) {
94
- const result = this.db.prepare(`
95
- SELECT COUNT(*) as cnt FROM generations
96
- WHERE status = 'deleted' AND createdAt > datetime('now', '-1 hour')
94
+ const result = this.db.prepare(`
95
+ SELECT COUNT(*) as cnt FROM generations
96
+ WHERE status = 'deleted' AND createdAt > datetime('now', '-1 hour')
97
97
  `).get();
98
98
  return result.cnt;
99
99
  }
@@ -15,62 +15,62 @@ export class InsightStore {
15
15
  this.initializeTables();
16
16
  }
17
17
  initializeTables() {
18
- this.db.exec(`
19
- CREATE TABLE IF NOT EXISTS insights (
20
- id TEXT PRIMARY KEY,
21
- type TEXT NOT NULL CHECK(type IN ('pattern','anti_pattern','preference','skill_gap','optimization')),
22
- title TEXT NOT NULL,
23
- description TEXT NOT NULL,
24
- evidence TEXT,
25
- confidence REAL DEFAULT 0.5 CHECK(confidence >= 0 AND confidence <= 1),
26
- occurrences INTEGER DEFAULT 1,
27
- tags TEXT,
28
- status TEXT NOT NULL DEFAULT 'draft' CHECK(status IN ('draft','confirmed','applied','deprecated')),
29
- generatedFrom TEXT NOT NULL CHECK(generatedFrom IN ('reflection','observation','agent_stats','manual')),
30
- appliedAs TEXT,
31
- createdAt TEXT NOT NULL,
32
- updatedAt TEXT NOT NULL
33
- );
34
-
35
- CREATE INDEX IF NOT EXISTS idx_ins_type ON insights(type);
36
- CREATE INDEX IF NOT EXISTS idx_ins_status ON insights(status);
37
- CREATE INDEX IF NOT EXISTS idx_ins_confidence ON insights(confidence);
38
- CREATE INDEX IF NOT EXISTS idx_ins_created ON insights(createdAt);
39
- CREATE INDEX IF NOT EXISTS idx_ins_source ON insights(generatedFrom);
18
+ this.db.exec(`
19
+ CREATE TABLE IF NOT EXISTS insights (
20
+ id TEXT PRIMARY KEY,
21
+ type TEXT NOT NULL CHECK(type IN ('pattern','anti_pattern','preference','skill_gap','optimization')),
22
+ title TEXT NOT NULL,
23
+ description TEXT NOT NULL,
24
+ evidence TEXT,
25
+ confidence REAL DEFAULT 0.5 CHECK(confidence >= 0 AND confidence <= 1),
26
+ occurrences INTEGER DEFAULT 1,
27
+ tags TEXT,
28
+ status TEXT NOT NULL DEFAULT 'draft' CHECK(status IN ('draft','confirmed','applied','deprecated')),
29
+ generatedFrom TEXT NOT NULL CHECK(generatedFrom IN ('reflection','observation','agent_stats','manual')),
30
+ appliedAs TEXT,
31
+ createdAt TEXT NOT NULL,
32
+ updatedAt TEXT NOT NULL
33
+ );
34
+
35
+ CREATE INDEX IF NOT EXISTS idx_ins_type ON insights(type);
36
+ CREATE INDEX IF NOT EXISTS idx_ins_status ON insights(status);
37
+ CREATE INDEX IF NOT EXISTS idx_ins_confidence ON insights(confidence);
38
+ CREATE INDEX IF NOT EXISTS idx_ins_created ON insights(createdAt);
39
+ CREATE INDEX IF NOT EXISTS idx_ins_source ON insights(generatedFrom);
40
40
  `);
41
41
  // Skill gaps table for prompt-dispatcher miss logging
42
- this.db.exec(`
43
- CREATE TABLE IF NOT EXISTS skill_gaps (
44
- id TEXT PRIMARY KEY,
45
- prompt TEXT NOT NULL,
46
- normalizedPrompt TEXT,
47
- sessionId TEXT,
48
- createdAt TEXT NOT NULL
49
- );
50
-
51
- CREATE INDEX IF NOT EXISTS idx_sg_normalized ON skill_gaps(normalizedPrompt);
52
- CREATE INDEX IF NOT EXISTS idx_sg_created ON skill_gaps(createdAt);
42
+ this.db.exec(`
43
+ CREATE TABLE IF NOT EXISTS skill_gaps (
44
+ id TEXT PRIMARY KEY,
45
+ prompt TEXT NOT NULL,
46
+ normalizedPrompt TEXT,
47
+ sessionId TEXT,
48
+ createdAt TEXT NOT NULL
49
+ );
50
+
51
+ CREATE INDEX IF NOT EXISTS idx_sg_normalized ON skill_gaps(normalizedPrompt);
52
+ CREATE INDEX IF NOT EXISTS idx_sg_created ON skill_gaps(createdAt);
53
53
  `);
54
54
  if (this.fts5Available) {
55
55
  try {
56
- this.db.exec(`
57
- CREATE VIRTUAL TABLE IF NOT EXISTS insights_fts
58
- USING fts5(title, description, tags, content=insights, content_rowid=rowid);
59
-
60
- CREATE TRIGGER IF NOT EXISTS insights_ai AFTER INSERT ON insights BEGIN
61
- INSERT INTO insights_fts(rowid, title, description, tags)
62
- VALUES (new.rowid, new.title, new.description, new.tags);
63
- END;
64
- CREATE TRIGGER IF NOT EXISTS insights_ad AFTER DELETE ON insights BEGIN
65
- INSERT INTO insights_fts(insights_fts, rowid, title, description, tags)
66
- VALUES('delete', old.rowid, old.title, old.description, old.tags);
67
- END;
68
- CREATE TRIGGER IF NOT EXISTS insights_au AFTER UPDATE ON insights BEGIN
69
- INSERT INTO insights_fts(insights_fts, rowid, title, description, tags)
70
- VALUES('delete', old.rowid, old.title, old.description, old.tags);
71
- INSERT INTO insights_fts(rowid, title, description, tags)
72
- VALUES (new.rowid, new.title, new.description, new.tags);
73
- END;
56
+ this.db.exec(`
57
+ CREATE VIRTUAL TABLE IF NOT EXISTS insights_fts
58
+ USING fts5(title, description, tags, content=insights, content_rowid=rowid);
59
+
60
+ CREATE TRIGGER IF NOT EXISTS insights_ai AFTER INSERT ON insights BEGIN
61
+ INSERT INTO insights_fts(rowid, title, description, tags)
62
+ VALUES (new.rowid, new.title, new.description, new.tags);
63
+ END;
64
+ CREATE TRIGGER IF NOT EXISTS insights_ad AFTER DELETE ON insights BEGIN
65
+ INSERT INTO insights_fts(insights_fts, rowid, title, description, tags)
66
+ VALUES('delete', old.rowid, old.title, old.description, old.tags);
67
+ END;
68
+ CREATE TRIGGER IF NOT EXISTS insights_au AFTER UPDATE ON insights BEGIN
69
+ INSERT INTO insights_fts(insights_fts, rowid, title, description, tags)
70
+ VALUES('delete', old.rowid, old.title, old.description, old.tags);
71
+ INSERT INTO insights_fts(rowid, title, description, tags)
72
+ VALUES (new.rowid, new.title, new.description, new.tags);
73
+ END;
74
74
  `);
75
75
  }
76
76
  catch {
@@ -82,9 +82,9 @@ export class InsightStore {
82
82
  const id = generateId();
83
83
  const now = new Date().toISOString();
84
84
  const confidence = Math.max(0, Math.min(1, input.confidence ?? 0.5));
85
- this.db.prepare(`
86
- INSERT INTO insights (id, type, title, description, evidence, confidence, occurrences, tags, status, generatedFrom, createdAt, updatedAt)
87
- VALUES (?, ?, ?, ?, ?, ?, 1, ?, 'draft', ?, ?, ?)
85
+ this.db.prepare(`
86
+ INSERT INTO insights (id, type, title, description, evidence, confidence, occurrences, tags, status, generatedFrom, createdAt, updatedAt)
87
+ VALUES (?, ?, ?, ?, ?, ?, 1, ?, 'draft', ?, ?, ?)
88
88
  `).run(id, input.type, input.title, input.description, JSON.stringify(input.evidence ?? []), confidence, JSON.stringify(input.tags ?? []), input.generatedFrom, now, now);
89
89
  return id;
90
90
  }
@@ -95,19 +95,19 @@ export class InsightStore {
95
95
  findAndMergeDuplicate(title, description) {
96
96
  if (this.fts5Available) {
97
97
  try {
98
- const row = this.db.prepare(`
99
- SELECT i.id, i.occurrences, i.confidence
100
- FROM insights_fts fts
101
- JOIN insights i ON i.rowid = fts.rowid
102
- WHERE insights_fts MATCH ?
103
- ORDER BY bm25(insights_fts)
104
- LIMIT 1
98
+ const row = this.db.prepare(`
99
+ SELECT i.id, i.occurrences, i.confidence
100
+ FROM insights_fts fts
101
+ JOIN insights i ON i.rowid = fts.rowid
102
+ WHERE insights_fts MATCH ?
103
+ ORDER BY bm25(insights_fts)
104
+ LIMIT 1
105
105
  `).get(title);
106
106
  if (row) {
107
107
  const newOccurrences = row.occurrences + 1;
108
108
  const newConfidence = Math.min(1.0, newOccurrences * 0.2 + 0.1);
109
- this.db.prepare(`
110
- UPDATE insights SET occurrences = ?, confidence = ?, updatedAt = ? WHERE id = ?
109
+ this.db.prepare(`
110
+ UPDATE insights SET occurrences = ?, confidence = ?, updatedAt = ? WHERE id = ?
111
111
  `).run(newOccurrences, newConfidence, new Date().toISOString(), row.id);
112
112
  return row.id;
113
113
  }
@@ -121,13 +121,13 @@ export class InsightStore {
121
121
  search(query, limit = 20) {
122
122
  if (this.fts5Available) {
123
123
  try {
124
- const rows = this.db.prepare(`
125
- SELECT i.*, bm25(insights_fts) as rank
126
- FROM insights_fts fts
127
- JOIN insights i ON i.rowid = fts.rowid
128
- WHERE insights_fts MATCH ?
129
- ORDER BY i.confidence DESC, rank
130
- LIMIT ?
124
+ const rows = this.db.prepare(`
125
+ SELECT i.*, bm25(insights_fts) as rank
126
+ FROM insights_fts fts
127
+ JOIN insights i ON i.rowid = fts.rowid
128
+ WHERE insights_fts MATCH ?
129
+ ORDER BY i.confidence DESC, rank
130
+ LIMIT ?
131
131
  `).all(query, limit);
132
132
  return rows.map(this.rowToInsight);
133
133
  }
@@ -136,11 +136,11 @@ export class InsightStore {
136
136
  }
137
137
  }
138
138
  const pattern = `%${query}%`;
139
- const rows = this.db.prepare(`
140
- SELECT * FROM insights
141
- WHERE title LIKE ? OR description LIKE ? OR tags LIKE ?
142
- ORDER BY confidence DESC, createdAt DESC
143
- LIMIT ?
139
+ const rows = this.db.prepare(`
140
+ SELECT * FROM insights
141
+ WHERE title LIKE ? OR description LIKE ? OR tags LIKE ?
142
+ ORDER BY confidence DESC, createdAt DESC
143
+ LIMIT ?
144
144
  `).all(pattern, pattern, pattern, limit);
145
145
  return rows.map(this.rowToInsight);
146
146
  }
@@ -149,42 +149,42 @@ export class InsightStore {
149
149
  return row ? this.rowToInsight(row) : null;
150
150
  }
151
151
  getActionable() {
152
- const rows = this.db.prepare(`
153
- SELECT * FROM insights
154
- WHERE status = 'confirmed' AND type IN ('skill_gap', 'pattern', 'anti_pattern')
155
- ORDER BY confidence DESC, occurrences DESC
156
- LIMIT 20
152
+ const rows = this.db.prepare(`
153
+ SELECT * FROM insights
154
+ WHERE status = 'confirmed' AND type IN ('skill_gap', 'pattern', 'anti_pattern')
155
+ ORDER BY confidence DESC, occurrences DESC
156
+ LIMIT 20
157
157
  `).all();
158
158
  return rows.map(this.rowToInsight);
159
159
  }
160
160
  getByStatus(status, limit = 50) {
161
- const rows = this.db.prepare(`
162
- SELECT * FROM insights WHERE status = ? ORDER BY updatedAt DESC LIMIT ?
161
+ const rows = this.db.prepare(`
162
+ SELECT * FROM insights WHERE status = ? ORDER BY updatedAt DESC LIMIT ?
163
163
  `).all(status, limit);
164
164
  return rows.map(this.rowToInsight);
165
165
  }
166
166
  getByType(type, limit = 50) {
167
- const rows = this.db.prepare(`
168
- SELECT * FROM insights WHERE type = ? ORDER BY confidence DESC LIMIT ?
167
+ const rows = this.db.prepare(`
168
+ SELECT * FROM insights WHERE type = ? ORDER BY confidence DESC LIMIT ?
169
169
  `).all(type, limit);
170
170
  return rows.map(this.rowToInsight);
171
171
  }
172
172
  updateStatus(id, status) {
173
- const result = this.db.prepare(`
174
- UPDATE insights SET status = ?, updatedAt = ? WHERE id = ?
173
+ const result = this.db.prepare(`
174
+ UPDATE insights SET status = ?, updatedAt = ? WHERE id = ?
175
175
  `).run(status, new Date().toISOString(), id);
176
176
  return result.changes > 0;
177
177
  }
178
178
  setAppliedAs(id, generationId) {
179
- const result = this.db.prepare(`
180
- UPDATE insights SET appliedAs = ?, status = 'applied', updatedAt = ? WHERE id = ?
179
+ const result = this.db.prepare(`
180
+ UPDATE insights SET appliedAs = ?, status = 'applied', updatedAt = ? WHERE id = ?
181
181
  `).run(generationId, new Date().toISOString(), id);
182
182
  return result.changes > 0;
183
183
  }
184
184
  cleanupLowConfidence(maxAge = 7 * 24 * 60 * 60 * 1000) {
185
185
  const cutoff = new Date(Date.now() - maxAge).toISOString();
186
- const result = this.db.prepare(`
187
- DELETE FROM insights WHERE confidence < 0.3 AND createdAt < ?
186
+ const result = this.db.prepare(`
187
+ DELETE FROM insights WHERE confidence < 0.3 AND createdAt < ?
188
188
  `).run(cutoff);
189
189
  return result.changes;
190
190
  }