@dommaker/harness 0.13.0 → 0.13.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (420) hide show
  1. package/CHANGELOG.md +169 -0
  2. package/bin/harness-knowledge-capture.js +99 -0
  3. package/bin/harness-knowledge-check.js +149 -0
  4. package/bin/harness-knowledge-track.js +92 -0
  5. package/bin/harness-knowledge-track.sh +47 -0
  6. package/bin/harness-sensitive-check.sh +67 -0
  7. package/dist/cli/commands/init.js +34 -2
  8. package/dist/cli/commands/init.js.map +1 -1
  9. package/package.json +6 -3
  10. package/src/CONTEXT.md +34 -0
  11. package/src/__tests__/acceptance-gate.test.ts +364 -0
  12. package/src/__tests__/annotation-checker.test.ts +183 -0
  13. package/src/__tests__/architecture-engine.test.ts +619 -0
  14. package/src/__tests__/checker-extra.test.ts +1627 -0
  15. package/src/__tests__/checker.test.ts +1268 -0
  16. package/src/__tests__/checkpoint.test.ts +697 -0
  17. package/src/__tests__/clean-state-extra.test.ts +301 -0
  18. package/src/__tests__/clean-state.test.ts +169 -0
  19. package/src/__tests__/constraint-doctor.test.ts +410 -0
  20. package/src/__tests__/constraint-evolver.test.ts +404 -0
  21. package/src/__tests__/constraint-handler.test.ts +136 -0
  22. package/src/__tests__/context/progressive-loader.test.ts +131 -0
  23. package/src/__tests__/contract-gate.test.ts +321 -0
  24. package/src/__tests__/cross-project-checker.test.ts +318 -0
  25. package/src/__tests__/cso-validator.test.ts +205 -0
  26. package/src/__tests__/detect-source-roots.test.ts +98 -0
  27. package/src/__tests__/doctor-evolver.test.ts +381 -0
  28. package/src/__tests__/error-classifier.test.ts +304 -0
  29. package/src/__tests__/exec.test.ts +83 -0
  30. package/src/__tests__/extend-exceptions.test.ts +149 -0
  31. package/src/__tests__/failure-recorder.test.ts +335 -0
  32. package/src/__tests__/hooks-pipeline.test.ts +214 -0
  33. package/src/__tests__/interceptor.test.ts +89 -0
  34. package/src/__tests__/iron-laws.test.ts +246 -0
  35. package/src/__tests__/long-running.test.ts +17 -0
  36. package/src/__tests__/passes-gate-check.test.ts +138 -0
  37. package/src/__tests__/passes-gate-extension.test.ts +151 -0
  38. package/src/__tests__/passes-gate-extra.test.ts +238 -0
  39. package/src/__tests__/passes-gate.test.ts +231 -0
  40. package/src/__tests__/performance-analyzer.test.ts +501 -0
  41. package/src/__tests__/performance-collector.test.ts +276 -0
  42. package/src/__tests__/performance-gate.test.ts +74 -0
  43. package/src/__tests__/presets.test.ts +104 -0
  44. package/src/__tests__/project-config-loader-extra.test.ts +269 -0
  45. package/src/__tests__/project-config-loader.test.ts +127 -0
  46. package/src/__tests__/review-gate.test.ts +92 -0
  47. package/src/__tests__/security-gate.test.ts +100 -0
  48. package/src/__tests__/session-startup.test.ts +334 -0
  49. package/src/__tests__/spec-validator.test.ts +57 -0
  50. package/src/__tests__/token-budget.test.ts +252 -0
  51. package/src/__tests__/trace-analyzer-extra.test.ts +307 -0
  52. package/src/__tests__/trace-analyzer.test.ts +131 -0
  53. package/src/__tests__/trace-collector.test.ts +258 -0
  54. package/src/__tests__/traces.test.ts +347 -0
  55. package/src/agents/CONTEXT.md +21 -0
  56. package/src/agents/__tests__/lifecycle.test.ts +248 -0
  57. package/src/agents/index.ts +2 -0
  58. package/src/agents/lifecycle.ts +201 -0
  59. package/src/agents/types.ts +46 -0
  60. package/src/architecture/CONTEXT.md +22 -0
  61. package/src/architecture/constraint-engine.ts +356 -0
  62. package/src/architecture/cross-project-checker.ts +563 -0
  63. package/src/cli/commands/CONTEXT.md +24 -0
  64. package/src/cli/commands/__tests__/acceptance.test.ts +180 -0
  65. package/src/cli/commands/__tests__/check.test.ts +598 -0
  66. package/src/cli/commands/__tests__/command.test.ts +149 -0
  67. package/src/cli/commands/__tests__/contract.test.ts +151 -0
  68. package/src/cli/commands/__tests__/failure.test.ts +199 -0
  69. package/src/cli/commands/__tests__/flow.test.ts +343 -0
  70. package/src/cli/commands/__tests__/init.test.ts +306 -0
  71. package/src/cli/commands/__tests__/passes-gate.test.ts +256 -0
  72. package/src/cli/commands/__tests__/performance.test.ts +116 -0
  73. package/src/cli/commands/__tests__/posteval-plan.test.ts +201 -0
  74. package/src/cli/commands/__tests__/report-extra.test.ts +98 -0
  75. package/src/cli/commands/__tests__/report.test.ts +109 -0
  76. package/src/cli/commands/__tests__/review.test.ts +153 -0
  77. package/src/cli/commands/__tests__/security.test.ts +147 -0
  78. package/src/cli/commands/__tests__/spec.test.ts +193 -0
  79. package/src/cli/commands/__tests__/status-extra.test.ts +223 -0
  80. package/src/cli/commands/__tests__/status.test.ts +306 -0
  81. package/src/cli/commands/__tests__/sync-docs.test.ts +335 -0
  82. package/src/cli/commands/__tests__/validate.test.ts +139 -0
  83. package/src/cli/commands/acceptance.ts +111 -0
  84. package/src/cli/commands/analyze-sessions.ts +488 -0
  85. package/src/cli/commands/check.ts +441 -0
  86. package/src/cli/commands/command.ts +90 -0
  87. package/src/cli/commands/constraints.ts +86 -0
  88. package/src/cli/commands/contract.ts +168 -0
  89. package/src/cli/commands/failure.ts +117 -0
  90. package/src/cli/commands/flow.ts +275 -0
  91. package/src/cli/commands/index.ts +26 -0
  92. package/src/cli/commands/init.ts +832 -0
  93. package/src/cli/commands/knowledge.ts +391 -0
  94. package/src/cli/commands/passes-gate.ts +158 -0
  95. package/src/cli/commands/performance.ts +108 -0
  96. package/src/cli/commands/posteval-plan.ts +85 -0
  97. package/src/cli/commands/release.ts +159 -0
  98. package/src/cli/commands/report.ts +198 -0
  99. package/src/cli/commands/review.ts +118 -0
  100. package/src/cli/commands/security.ts +122 -0
  101. package/src/cli/commands/spec.ts +158 -0
  102. package/src/cli/commands/status.ts +169 -0
  103. package/src/cli/commands/sync-docs.ts +743 -0
  104. package/src/cli/commands/update-user-model.ts +527 -0
  105. package/src/cli/commands/validate.ts +222 -0
  106. package/src/constraints/__tests__/lifecycle-runner.test.ts +246 -0
  107. package/src/constraints/__tests__/registry.test.ts +196 -0
  108. package/src/constraints/index.ts +3 -0
  109. package/src/constraints/lifecycle-runner.ts +184 -0
  110. package/src/constraints/registry.ts +134 -0
  111. package/src/constraints/types.ts +59 -0
  112. package/src/context/CONTEXT.md +28 -0
  113. package/src/context/__tests__/compaction.test.ts +169 -0
  114. package/src/context/__tests__/file-budget.test.ts +142 -0
  115. package/src/context/__tests__/knowledge-injector.test.ts +148 -0
  116. package/src/context/__tests__/progressive-loader.test.ts +264 -0
  117. package/src/context/__tests__/session-manager.test.ts +300 -0
  118. package/src/context/__tests__/token-budget.test.ts +338 -0
  119. package/src/context/__tests__/token-pipeline.test.ts +178 -0
  120. package/src/context/__tests__/tool-output-budget.test.ts +95 -0
  121. package/src/context/compaction.ts +202 -0
  122. package/src/context/file-budget.ts +142 -0
  123. package/src/context/index.ts +15 -0
  124. package/src/context/knowledge-injector.ts +168 -0
  125. package/src/context/progressive-loader.ts +260 -0
  126. package/src/context/session-manager.ts +343 -0
  127. package/src/context/token-budget.ts +295 -0
  128. package/src/context/token-pipeline.ts +265 -0
  129. package/src/context/tool-output-budget.ts +178 -0
  130. package/src/context/types.ts +160 -0
  131. package/src/core/CONTEXT.md +26 -0
  132. package/src/core/constraints/__tests__/default-executors.test.ts +57 -0
  133. package/src/core/constraints/__tests__/interceptor.test.ts +251 -0
  134. package/src/core/constraints/__tests__/prompt-injection.test.ts +89 -0
  135. package/src/core/constraints/check-cache.ts +96 -0
  136. package/src/core/constraints/checker.ts +1169 -0
  137. package/src/core/constraints/default-executors.ts +92 -0
  138. package/src/core/constraints/definitions.ts +1119 -0
  139. package/src/core/constraints/doc-freshness/__tests__/runner.test.ts +551 -0
  140. package/src/core/constraints/doc-freshness/auto-fix.ts +69 -0
  141. package/src/core/constraints/doc-freshness/runner.ts +486 -0
  142. package/src/core/constraints/index.ts +78 -0
  143. package/src/core/constraints/interceptor.ts +220 -0
  144. package/src/core/constraints/prompt-injection.ts +73 -0
  145. package/src/core/index.ts +23 -0
  146. package/src/core/project-config-loader.ts +252 -0
  147. package/src/core/session/__tests__/startup.test.ts +281 -0
  148. package/src/core/session/clean-state.ts +178 -0
  149. package/src/core/session/index.ts +15 -0
  150. package/src/core/session/startup.ts +253 -0
  151. package/src/core/spec/__tests__/validator.test.ts +379 -0
  152. package/src/core/spec/index.ts +7 -0
  153. package/src/core/spec/validator.ts +383 -0
  154. package/src/core/validators/__tests__/passes-gate.test.ts +131 -0
  155. package/src/core/validators/checkpoint.ts +547 -0
  156. package/src/core/validators/cso.ts +124 -0
  157. package/src/core/validators/index.ts +25 -0
  158. package/src/core/validators/passes-gate.ts +613 -0
  159. package/src/dashboard/CONTEXT.md +21 -0
  160. package/src/dashboard/__tests__/data.test.ts +115 -0
  161. package/src/dashboard/__tests__/stats.test.ts +156 -0
  162. package/src/dashboard/data.ts +113 -0
  163. package/src/dashboard/index.ts +3 -0
  164. package/src/dashboard/stats.ts +127 -0
  165. package/src/dashboard/types.ts +113 -0
  166. package/src/evolution/CONTEXT.md +22 -0
  167. package/src/evolution/__tests__/auto-evolve.test.ts +320 -0
  168. package/src/evolution/auto-evolve.ts +98 -0
  169. package/src/evolution/index.ts +1 -0
  170. package/src/failure/CONTEXT.md +24 -0
  171. package/src/failure/classifier.ts +156 -0
  172. package/src/failure/constraint-handler.ts +173 -0
  173. package/src/failure/index.ts +35 -0
  174. package/src/failure/recorder.ts +201 -0
  175. package/src/failure/types.ts +165 -0
  176. package/src/gates/CONTEXT.md +27 -0
  177. package/src/gates/__tests__/acceptance.test.ts +608 -0
  178. package/src/gates/__tests__/command.test.ts +206 -0
  179. package/src/gates/__tests__/performance.test.ts +381 -0
  180. package/src/gates/__tests__/review.test.ts +302 -0
  181. package/src/gates/__tests__/security.test.ts +332 -0
  182. package/src/gates/acceptance.ts +493 -0
  183. package/src/gates/command.ts +444 -0
  184. package/src/gates/contract.ts +260 -0
  185. package/src/gates/index.ts +67 -0
  186. package/src/gates/performance.ts +359 -0
  187. package/src/gates/review.ts +169 -0
  188. package/src/gates/security.ts +244 -0
  189. package/src/gates/types.ts +159 -0
  190. package/src/governance/CONTEXT.md +22 -0
  191. package/src/governance/__tests__/executor.test.ts +249 -0
  192. package/src/governance/executor.ts +229 -0
  193. package/src/governance/index.ts +13 -0
  194. package/src/governance/types.ts +53 -0
  195. package/src/hooks/CONTEXT.md +23 -0
  196. package/src/hooks/__tests__/bootstrap.test.ts +184 -0
  197. package/src/hooks/bootstrap.ts +144 -0
  198. package/src/hooks/index.ts +15 -0
  199. package/src/hooks/pipeline.ts +157 -0
  200. package/src/hooks/registry.ts +88 -0
  201. package/src/hooks/types.ts +80 -0
  202. package/src/index.ts +198 -0
  203. package/src/knowledge/CONTEXT.md +29 -0
  204. package/src/knowledge/__tests__/doctor.test.ts +272 -0
  205. package/src/knowledge/__tests__/import.test.ts +376 -0
  206. package/src/knowledge/__tests__/ingest.test.ts +125 -0
  207. package/src/knowledge/__tests__/lifecycle-hooks.test.ts +137 -0
  208. package/src/knowledge/__tests__/lifecycle.test.ts +248 -0
  209. package/src/knowledge/__tests__/lint.test.ts +401 -0
  210. package/src/knowledge/__tests__/query.test.ts +185 -0
  211. package/src/knowledge/__tests__/reference-tracker.test.ts +129 -0
  212. package/src/knowledge/__tests__/store.test.ts +238 -0
  213. package/src/knowledge/doctor.ts +104 -0
  214. package/src/knowledge/import.ts +505 -0
  215. package/src/knowledge/index.ts +16 -0
  216. package/src/knowledge/ingest.ts +126 -0
  217. package/src/knowledge/lifecycle-hooks.ts +199 -0
  218. package/src/knowledge/lifecycle.ts +175 -0
  219. package/src/knowledge/lint.ts +360 -0
  220. package/src/knowledge/query.ts +150 -0
  221. package/src/knowledge/reference-tracker.ts +99 -0
  222. package/src/knowledge/store.ts +264 -0
  223. package/src/knowledge/types.ts +139 -0
  224. package/src/llm/CONTEXT.md +21 -0
  225. package/src/llm/__tests__/adapter.test.ts +172 -0
  226. package/src/llm/adapter.ts +149 -0
  227. package/src/llm/index.ts +2 -0
  228. package/src/llm/types.ts +81 -0
  229. package/src/monitoring/CONTEXT.md +29 -0
  230. package/src/monitoring/__tests__/context-tracker.test.ts +172 -0
  231. package/src/monitoring/__tests__/knowledge-doctor.test.ts +276 -0
  232. package/src/monitoring/__tests__/knowledge-evolver.test.ts +365 -0
  233. package/src/monitoring/__tests__/performance-analyzer.test.ts +137 -0
  234. package/src/monitoring/__tests__/performance-collector.test.ts +332 -0
  235. package/src/monitoring/__tests__/traces.test.ts +190 -0
  236. package/src/monitoring/constraint-doctor.ts +499 -0
  237. package/src/monitoring/constraint-evolver.ts +573 -0
  238. package/src/monitoring/context-tracker.ts +148 -0
  239. package/src/monitoring/index.ts +23 -0
  240. package/src/monitoring/knowledge-doctor.ts +323 -0
  241. package/src/monitoring/knowledge-evolver.ts +289 -0
  242. package/src/monitoring/performance-analyzer.ts +450 -0
  243. package/src/monitoring/performance-collector.ts +348 -0
  244. package/src/monitoring/trace-analyzer.ts +470 -0
  245. package/src/monitoring/traces.ts +339 -0
  246. package/src/presets/__tests__/standard.test.ts +104 -0
  247. package/src/presets/index.ts +16 -0
  248. package/src/presets/standard.ts +163 -0
  249. package/src/safety/CONTEXT.md +23 -0
  250. package/src/safety/__tests__/input-guardrail.test.ts +105 -0
  251. package/src/safety/__tests__/output-guardrail.test.ts +108 -0
  252. package/src/safety/__tests__/sandbox.test.ts +158 -0
  253. package/src/safety/__tests__/tool-guardrail.test.ts +127 -0
  254. package/src/safety/index.ts +5 -0
  255. package/src/safety/input-guardrail.ts +133 -0
  256. package/src/safety/output-guardrail.ts +174 -0
  257. package/src/safety/sandbox.ts +148 -0
  258. package/src/safety/tool-guardrail.ts +176 -0
  259. package/src/safety/types.ts +124 -0
  260. package/src/spec/CONTEXT.md +19 -0
  261. package/src/spec/__tests__/annotation-checker.test.ts +289 -0
  262. package/src/spec/annotation-checker.ts +342 -0
  263. package/src/tools/CONTEXT.md +25 -0
  264. package/src/tools/__tests__/loader.test.ts +252 -0
  265. package/src/tools/__tests__/registry.test.ts +157 -0
  266. package/src/tools/core/__tests__/core.test.ts +122 -0
  267. package/src/tools/core/index.ts +201 -0
  268. package/src/tools/core/package.json +7 -0
  269. package/src/tools/core/pnpm-lock.yaml +232 -0
  270. package/src/tools/definitions/core/code/fingerprint.sh +273 -0
  271. package/src/tools/definitions/core/code/fingerprint.yml +72 -0
  272. package/src/tools/definitions/core/code/parse.yml +68 -0
  273. package/src/tools/definitions/core/code/register-language.sh +475 -0
  274. package/src/tools/definitions/core/code/register-language.yml +74 -0
  275. package/src/tools/definitions/core/docker/build.yml +73 -0
  276. package/src/tools/definitions/core/docker/run.yml +81 -0
  277. package/src/tools/definitions/core/file/copy.yml +88 -0
  278. package/src/tools/definitions/core/file/read.yml +69 -0
  279. package/src/tools/definitions/core/file/write.yml +75 -0
  280. package/src/tools/definitions/core/git/branch.yml +61 -0
  281. package/src/tools/definitions/core/git/cleanup-worktree.yml +50 -0
  282. package/src/tools/definitions/core/git/clone.yml +69 -0
  283. package/src/tools/definitions/core/git/commit.yml +65 -0
  284. package/src/tools/definitions/core/git/push.yml +79 -0
  285. package/src/tools/definitions/core/git/worktree.yml +96 -0
  286. package/src/tools/definitions/core/notification/notify.sh +152 -0
  287. package/src/tools/definitions/core/notification/notify.yml +60 -0
  288. package/src/tools/definitions/core/npm/build.yml +75 -0
  289. package/src/tools/definitions/core/npm/install.yml +58 -0
  290. package/src/tools/definitions/core/npm/test.yml +75 -0
  291. package/src/tools/definitions/core/validation/check-reuse.yml +170 -0
  292. package/src/tools/definitions/core/validation/validate-handlers.yml +118 -0
  293. package/src/tools/definitions/core/validation/validate-readme-stats.yml +155 -0
  294. package/src/tools/definitions/core/validation/validate-yaml-syntax.yml +134 -0
  295. package/src/tools/definitions/ext/browser/browser-automate.sh +255 -0
  296. package/src/tools/definitions/ext/browser/browser-automate.yml +166 -0
  297. package/src/tools/definitions/ext/browser/browser-close.sh +104 -0
  298. package/src/tools/definitions/ext/browser/browser-close.yml +55 -0
  299. package/src/tools/definitions/ext/browser/browser-mcp-debug.sh +682 -0
  300. package/src/tools/definitions/ext/browser/browser-mcp-debug.yml +167 -0
  301. package/src/tools/definitions/ext/browser/browser-start.sh +101 -0
  302. package/src/tools/definitions/ext/browser/browser-start.yml +62 -0
  303. package/src/tools/definitions/registry.json +795 -0
  304. package/src/tools/definitions/std/README.md +350 -0
  305. package/src/tools/definitions/std/analysis/analyze-codebase.yml +72 -0
  306. package/src/tools/definitions/std/analysis/analyze-diff.yml +182 -0
  307. package/src/tools/definitions/std/analysis/analyze-git-diff.yml +70 -0
  308. package/src/tools/definitions/std/analysis/analyze-impact.yml +78 -0
  309. package/src/tools/definitions/std/analysis/analyze-requirements.yml +105 -0
  310. package/src/tools/definitions/std/analysis/brainstorm-options.yml +106 -0
  311. package/src/tools/definitions/std/analysis/build-graph.yml +154 -0
  312. package/src/tools/definitions/std/analysis/clarify-requirements.yml +90 -0
  313. package/src/tools/definitions/std/analysis/detect-context.yml +109 -0
  314. package/src/tools/definitions/std/analysis/detect-layers.yml +125 -0
  315. package/src/tools/definitions/std/analysis/generate-tour.yml +102 -0
  316. package/src/tools/definitions/std/analysis/search-enhance.yml +105 -0
  317. package/src/tools/definitions/std/backlog/add.yml +51 -0
  318. package/src/tools/definitions/std/backlog/decide.yml +39 -0
  319. package/src/tools/definitions/std/backlog/github-sync.yml +161 -0
  320. package/src/tools/definitions/std/backlog/list.yml +53 -0
  321. package/src/tools/definitions/std/backlog/load.yml +46 -0
  322. package/src/tools/definitions/std/backlog/resolve.yml +37 -0
  323. package/src/tools/definitions/std/backlog/update.yml +42 -0
  324. package/src/tools/definitions/std/bugfix/diagnose.yml +68 -0
  325. package/src/tools/definitions/std/bugfix/fix.yml +66 -0
  326. package/src/tools/definitions/std/bugfix/verify.yml +69 -0
  327. package/src/tools/definitions/std/constraint/check-decomposition.yml +103 -0
  328. package/src/tools/definitions/std/constraint/check-feature-list.yml +77 -0
  329. package/src/tools/definitions/std/constraint/check-progress.yml +97 -0
  330. package/src/tools/definitions/std/constraint/generate-report.yml +147 -0
  331. package/src/tools/definitions/std/deploy/commit-push.yml +33 -0
  332. package/src/tools/definitions/std/deploy/deploy-backend.yml +37 -0
  333. package/src/tools/definitions/std/deploy/deploy-frontend.yml +37 -0
  334. package/src/tools/definitions/std/deploy/rollback.yml +148 -0
  335. package/src/tools/definitions/std/design/analyze-architecture-impact.yml +113 -0
  336. package/src/tools/definitions/std/design/design-api.yml +55 -0
  337. package/src/tools/definitions/std/design/design-architecture.yml +97 -0
  338. package/src/tools/definitions/std/design/design-db.yml +81 -0
  339. package/src/tools/definitions/std/design/generate-spec.yml +182 -0
  340. package/src/tools/definitions/std/development/develop-api.yml +85 -0
  341. package/src/tools/definitions/std/development/develop-backend.yml +88 -0
  342. package/src/tools/definitions/std/development/develop-frontend.yml +87 -0
  343. package/src/tools/definitions/std/development/develop-shared-types.yml +74 -0
  344. package/src/tools/definitions/std/development/develop-task.yml +122 -0
  345. package/src/tools/definitions/std/development/develop-tests.yml +76 -0
  346. package/src/tools/definitions/std/development/execute-batch.yml +152 -0
  347. package/src/tools/definitions/std/development/fix-issues.yml +100 -0
  348. package/src/tools/definitions/std/development/implement-task.yml +124 -0
  349. package/src/tools/definitions/std/development/review-fix-cycle.yml +232 -0
  350. package/src/tools/definitions/std/evolution/implement.yml +125 -0
  351. package/src/tools/definitions/std/evolution/prioritize.yml +112 -0
  352. package/src/tools/definitions/std/evolution/report-gap.yml +166 -0
  353. package/src/tools/definitions/std/file/read.yml +21 -0
  354. package/src/tools/definitions/std/governance/aggregate-opinions.sh +201 -0
  355. package/src/tools/definitions/std/governance/aggregate-opinions.yml +79 -0
  356. package/src/tools/definitions/std/governance/audit-task.yml +178 -0
  357. package/src/tools/definitions/std/governance/cast-vote.yml +129 -0
  358. package/src/tools/definitions/std/governance/collect-issues.yml +16 -0
  359. package/src/tools/definitions/std/governance/create-signed-document.yml +23 -0
  360. package/src/tools/definitions/std/governance/create-voting-session.yml +101 -0
  361. package/src/tools/definitions/std/governance/define-stance.sh +243 -0
  362. package/src/tools/definitions/std/governance/define-stance.yml +82 -0
  363. package/src/tools/definitions/std/governance/generate-review-report.yml +23 -0
  364. package/src/tools/definitions/std/governance/impeach.yml +179 -0
  365. package/src/tools/definitions/std/governance/multi-stance-review.yml +154 -0
  366. package/src/tools/definitions/std/governance/prepare-artifact.yml +20 -0
  367. package/src/tools/definitions/std/governance/review-spec-approval.yml +262 -0
  368. package/src/tools/definitions/std/governance/rollback.yml +186 -0
  369. package/src/tools/definitions/std/governance/stance-review.yml +149 -0
  370. package/src/tools/definitions/std/governance/track-effect.yml +199 -0
  371. package/src/tools/definitions/std/governance/vote-tally.yml +144 -0
  372. package/src/tools/definitions/std/patch/execute.yml +51 -0
  373. package/src/tools/definitions/std/planning/generate-tasks.yml +36 -0
  374. package/src/tools/definitions/std/planning/load-tasks.yml +44 -0
  375. package/src/tools/definitions/std/planning/split-batch.yml +481 -0
  376. package/src/tools/definitions/std/planning/split-tasks.yml +359 -0
  377. package/src/tools/definitions/std/planning/update-tasks.yml +51 -0
  378. package/src/tools/definitions/std/planning/validate-tasks.yml +46 -0
  379. package/src/tools/definitions/std/project/decide-next-workflow.yml +38 -0
  380. package/src/tools/definitions/std/project/load-state.yml +31 -0
  381. package/src/tools/definitions/std/project/save-state.yml +32 -0
  382. package/src/tools/definitions/std/quality/check-quality.yml +241 -0
  383. package/src/tools/definitions/std/quality/debug-systematic.yml +163 -0
  384. package/src/tools/definitions/std/quality/handle-feedback.yml +108 -0
  385. package/src/tools/definitions/std/quality/review-code.yml +128 -0
  386. package/src/tools/definitions/std/quality/review-spec.yml +140 -0
  387. package/src/tools/definitions/std/quality/review-task.yml +190 -0
  388. package/src/tools/definitions/std/quality/run-tests.yml +80 -0
  389. package/src/tools/definitions/std/quick/analyze.yml +56 -0
  390. package/src/tools/definitions/std/quick/implement.yml +67 -0
  391. package/src/tools/definitions/std/quick/verify.yml +71 -0
  392. package/src/tools/definitions/std/verification/verify_completion.yml +113 -0
  393. package/src/tools/definitions/std/verification/wait-condition.yml +107 -0
  394. package/src/tools/index.ts +5 -0
  395. package/src/tools/loader.ts +216 -0
  396. package/src/tools/paths.ts +15 -0
  397. package/src/tools/registry.ts +128 -0
  398. package/src/tools/types.ts +46 -0
  399. package/src/types/__tests__/types.test.ts +86 -0
  400. package/src/types/checkpoint.ts +174 -0
  401. package/src/types/constraint.ts +335 -0
  402. package/src/types/cso.ts +37 -0
  403. package/src/types/enforcement.ts +48 -0
  404. package/src/types/index.ts +59 -0
  405. package/src/types/iron-law.ts +50 -0
  406. package/src/types/passes-gate.ts +185 -0
  407. package/src/types/performance.ts +295 -0
  408. package/src/types/project-config.ts +251 -0
  409. package/src/types/session.ts +132 -0
  410. package/src/types/spec.ts +91 -0
  411. package/src/types/trace.ts +228 -0
  412. package/src/utils/detect-source-roots.ts +114 -0
  413. package/src/utils/exec.ts +61 -0
  414. package/src/verification/CONTEXT.md +23 -0
  415. package/src/verification/__tests__/loop.test.ts +303 -0
  416. package/src/verification/__tests__/rules-based.test.ts +240 -0
  417. package/src/verification/index.ts +3 -0
  418. package/src/verification/loop.ts +137 -0
  419. package/src/verification/rules-based.ts +153 -0
  420. package/src/verification/types.ts +81 -0
@@ -0,0 +1,527 @@
1
+ /**
2
+ * harness update-user-model — 用户模型持续演化引擎
3
+ *
4
+ * 不依赖固定规则快照。每天从最新数据中提取增量信号,
5
+ * 对比昨天状态,输出变化,更新模型。
6
+ *
7
+ * 数据源:
8
+ * ~/.claude/projects/-root--claude/*.jsonl (对话)
9
+ * /tmp/claude-knowledge-hooks.log (行为信号)
10
+ * studio/.harness/knowledge/ (知识新鲜度)
11
+ * ~/.claude/projects/-root-projects/memory/ (规则库)
12
+ *
13
+ * 模型状态: ~/.claude/user-model-state.json
14
+ * 画像输出: ~/.claude/projects/-root-projects/memory/user_profile.md
15
+ */
16
+
17
+ import chalk from 'chalk';
18
+ import * as fs from 'fs';
19
+ import * as path from 'path';
20
+ import * as os from 'os';
21
+
22
+ export interface UpdateUserModelOptions {
23
+ json?: boolean;
24
+ dryRun?: boolean; // don't update state, just show what would change
25
+ }
26
+
27
+ interface ModelState {
28
+ lastUpdated: string;
29
+ sessionsProcessed: string[]; // session IDs already counted
30
+ patterns: Record<string, { // pattern → running stats
31
+ firstSeen: string;
32
+ occurrences: number;
33
+ sessions: string[];
34
+ trend: 'rising' | 'stable' | 'falling' | 'new' | 'gone';
35
+ lastSeen: string;
36
+ }>;
37
+ lensWeights: Record<string, number>; // lens → activation count → normalized weight
38
+ principleWeights: Record<string, number>;
39
+ evolutionLog: Array<{ date: string; change: string }>;
40
+ }
41
+
42
+ const STATE_FILE = path.join(os.homedir(), '.claude', 'user-model-state.json');
43
+ const PROFILE_FILE = path.join(os.homedir(), '.claude', 'projects', '-root-projects', 'memory', 'user_profile.md');
44
+
45
+ export async function updateUserModel(options: UpdateUserModelOptions): Promise<void> {
46
+ const transcriptDir = process.env.CLAUDE_TRANSCRIPTS_DIR
47
+ || path.join(os.homedir(), '.claude', 'projects', '-root--claude');
48
+
49
+ // 1. Load previous state
50
+ const state = loadState();
51
+
52
+ // 2. Scan new data
53
+ const newSessions = findNewSessions(transcriptDir, state.sessionsProcessed);
54
+ if (newSessions.length === 0) {
55
+ console.log(chalk.gray('No new sessions to process'));
56
+ return;
57
+ }
58
+
59
+ // 3. Extract signals from new data
60
+ const signals = extractSignals(newSessions);
61
+
62
+ // 4. Build concept clusters (semantic dedup)
63
+ const mergedConcepts = buildMergedConcepts(signals);
64
+
65
+ // 5. Diff against previous state → find changes
66
+ const changes = diffState(state, mergedConcepts, signals);
67
+
68
+ // 6. Update state
69
+ if (!options.dryRun) {
70
+ for (const sid of newSessions.map(s => s.id)) {
71
+ if (!state.sessionsProcessed.includes(sid)) {
72
+ state.sessionsProcessed.push(sid);
73
+ }
74
+ }
75
+ applySignals(state, signals, mergedConcepts);
76
+ state.lastUpdated = new Date().toISOString();
77
+
78
+ if (state.sessionsProcessed.length > 200) {
79
+ state.sessionsProcessed = state.sessionsProcessed.slice(-200);
80
+ }
81
+
82
+ saveState(state);
83
+ updateProfile(state);
84
+ }
85
+
86
+ // 6. Output
87
+ if (options.json) {
88
+ console.log(JSON.stringify({ newSessions: newSessions.length, changes }, null, 2));
89
+ return;
90
+ }
91
+
92
+ console.log(chalk.blue(`📊 Processed ${newSessions.length} new sessions\n`));
93
+ printChanges(changes, signals);
94
+ }
95
+
96
+ // ── State I/O ──
97
+
98
+ function loadState(): ModelState {
99
+ try {
100
+ if (fs.existsSync(STATE_FILE)) {
101
+ return JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
102
+ }
103
+ } catch {}
104
+ return {
105
+ lastUpdated: new Date(0).toISOString(),
106
+ sessionsProcessed: [],
107
+ patterns: {},
108
+ lensWeights: {},
109
+ principleWeights: {},
110
+ evolutionLog: [],
111
+ };
112
+ }
113
+
114
+ function saveState(state: ModelState): void {
115
+ try {
116
+ const dir = path.dirname(STATE_FILE);
117
+ if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
118
+ fs.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2), 'utf-8');
119
+ } catch {}
120
+ }
121
+
122
+ // ── Session scanning ──
123
+
124
+ interface SimpleSession {
125
+ id: string;
126
+ date: string;
127
+ userText: string; // all user messages joined
128
+ assistantText: string; // all assistant messages joined
129
+ toolCalls: string[]; // tool names used
130
+ }
131
+
132
+ function findNewSessions(dir: string, processed: string[]): SimpleSession[] {
133
+ const sessions: SimpleSession[] = [];
134
+ try {
135
+ if (!fs.existsSync(dir)) return [];
136
+ for (const file of fs.readdirSync(dir)) {
137
+ if (!file.endsWith('.jsonl')) continue;
138
+ const sessionId = file.replace('.jsonl', '');
139
+ if (processed.includes(sessionId)) continue;
140
+
141
+ const filePath = path.join(dir, file);
142
+ const stat = fs.statSync(filePath);
143
+ const turns: Array<{ role: string; content: string }> = [];
144
+ const toolCalls: string[] = [];
145
+
146
+ const content = fs.readFileSync(filePath, 'utf-8');
147
+ for (const line of content.split('\n')) {
148
+ if (!line.trim()) continue;
149
+ try {
150
+ const entry = JSON.parse(line);
151
+ const msg = entry.message;
152
+ if (msg?.role && msg.content) {
153
+ const text = typeof msg.content === 'string'
154
+ ? msg.content
155
+ : Array.isArray(msg.content)
156
+ ? msg.content.filter((b: any) => b.type === 'text').map((b: any) => b.text).join(' ')
157
+ : '';
158
+ turns.push({ role: msg.role, content: text });
159
+ }
160
+ // Track tool calls from assistant messages
161
+ if (msg?.role === 'assistant' && Array.isArray(msg.content)) {
162
+ for (const block of msg.content) {
163
+ if (block.type === 'tool_use' && block.name) {
164
+ toolCalls.push(block.name);
165
+ }
166
+ }
167
+ }
168
+ } catch {}
169
+ }
170
+
171
+ if (turns.length > 0) {
172
+ sessions.push({
173
+ id: sessionId.slice(0, 40),
174
+ date: stat.mtime.toISOString().slice(0, 10),
175
+ userText: turns.filter(t => t.role === 'user').map(t => t.content).join('\n'),
176
+ assistantText: turns.filter(t => t.role === 'assistant').map(t => t.content).join('\n'),
177
+ toolCalls: [...new Set(toolCalls)],
178
+ });
179
+ }
180
+ }
181
+ } catch {}
182
+ return sessions.sort((a, b) => a.date.localeCompare(b.date));
183
+ }
184
+
185
+ // ── Signal extraction ──
186
+
187
+ interface SessionSignals {
188
+ sessionId: string;
189
+ date: string;
190
+ correctionPhrases: string[]; // "你又..." etc.
191
+ concepts: Record<string, number>; // N-gram → frequency
192
+ toolPatterns: Record<string, number>; // tool → count
193
+ sessionDuration: number; // estimated from turn count
194
+ turnCount: number;
195
+ deepAnalysis: boolean; // EnterPlanMode or Agent(Explore)
196
+ knowledgeCaptured: boolean; // Write to knowledge-docs
197
+ }
198
+
199
+ // ── Correction clustering (from analyze-sessions) ──
200
+
201
+ function extractCorrectionConcepts(userText: string): string[] {
202
+ const correctionPatterns = [
203
+ /你(?:又|还是)(?:在)?(?:犯|忘|没|不).{0,30}?[了]?/g,
204
+ /我不是(?:说|让|让做|讲)[了过]?.{0,50}?[了吗??]?/g,
205
+ /怎么(?:又|还|老)(?:是|在)?.{0,30}?[了]?/g,
206
+ /我(?:一直|反复|总是)(?:在|说|强调)?.{0,30}?[了]?/g,
207
+ /老(?:是|在|犯|忘)(?:了)?.{0,20}?[了]?/g,
208
+ /这(?:个|种)(?:问题|模式|错误).{0,20}?/g,
209
+ /(?:补上|加上|记上|修复).{0,10}?[了吗??]?/g,
210
+ /(?:沉淀|监控|日志|记录).{0,5}?[了吗??]?/g,
211
+ ];
212
+ const concepts: string[] = [];
213
+ for (const pat of correctionPatterns) {
214
+ pat.lastIndex = 0;
215
+ let m;
216
+ while ((m = pat.exec(userText)) !== null) {
217
+ const cleaned = m[0]
218
+ .replace(/你(?:又|还是)(?:在)?(?:犯|忘|没|不)/g, '')
219
+ .replace(/我不是(?:说|让|让做|讲)[了过]?/g, '')
220
+ .replace(/怎么(?:又|还|老)(?:是|在)?/g, '')
221
+ .replace(/我(?:一直|反复|总是)(?:在|说|强调)?/g, '')
222
+ .replace(/[,。!?、;:""''()\s]+/g, '')
223
+ .trim();
224
+ if (cleaned.length >= 4 && cleaned.length <= 60) concepts.push(cleaned);
225
+ }
226
+ }
227
+ return [...new Set(concepts)];
228
+ }
229
+
230
+ // ── Semantic clustering ──
231
+
232
+ function clusterConcepts(
233
+ agg: Record<string, { count: number; sessions: string[] }>
234
+ ): Record<string, { count: number; sessions: string[] }> {
235
+ const entries = Object.entries(agg).filter(([k]) => k.length >= 4);
236
+ if (entries.length <= 1) return agg;
237
+
238
+ const merged: Record<string, { count: number; sessions: string[] }> = {};
239
+ const used = new Set<number>();
240
+
241
+ for (let i = 0; i < entries.length; i++) {
242
+ if (used.has(i)) continue;
243
+ const [concept, data] = entries[i];
244
+ let clusterName = concept;
245
+ let clusterCount = data.count;
246
+ const clusterSessions = new Set(data.sessions);
247
+ used.add(i);
248
+
249
+ for (let j = i + 1; j < entries.length; j++) {
250
+ if (used.has(j)) continue;
251
+ const [other, otherData] = entries[j];
252
+ const sim = jaccardChinese(concept, other);
253
+ if (sim > 0.5) {
254
+ clusterCount += otherData.count;
255
+ for (const s of otherData.sessions) clusterSessions.add(s);
256
+ // Use the shorter name as cluster label
257
+ if (other.length < clusterName.length) clusterName = other;
258
+ used.add(j);
259
+ }
260
+ }
261
+
262
+ merged[clusterName] = { count: clusterCount, sessions: [...clusterSessions] };
263
+ }
264
+
265
+ return merged;
266
+ }
267
+
268
+ function jaccardChinese(a: string, b: string): number {
269
+ const charsA = new Set(a.split('').filter(c => /[\u4e00-\u9fff]/.test(c)));
270
+ const charsB = new Set(b.split('').filter(c => /[\u4e00-\u9fff]/.test(c)));
271
+ if (charsA.size === 0 || charsB.size === 0) return 0;
272
+ const intersection = new Set([...charsA].filter(x => charsB.has(x)));
273
+ const union = new Set([...charsA, ...charsB]);
274
+ return intersection.size / union.size;
275
+ }
276
+
277
+ // ── Old ──
278
+
279
+ function extractSignals(sessions: SimpleSession[]): SessionSignals[] {
280
+ return sessions.map(s => {
281
+ const correctionPhrases = extractCorrectionConcepts(s.userText);
282
+
283
+ // Concept extraction (Chinese char N-grams, etc.)
284
+ const concepts: Record<string, number> = {};
285
+ const cleanText = s.userText
286
+ .replace(/```[\s\S]*?```/g, '')
287
+ .replace(/\{[^{}]*\}/g, '')
288
+ .replace(/[{}[\]"':,\\]+/g, ' ');
289
+ let cnSeq = '';
290
+ for (const char of cleanText) {
291
+ if (/[\u4e00-\u9fff]/.test(char)) {
292
+ cnSeq += char;
293
+ } else {
294
+ if (cnSeq.length >= 4) concepts[cnSeq] = (concepts[cnSeq] || 0) + 1;
295
+ cnSeq = '';
296
+ }
297
+ }
298
+ if (cnSeq.length >= 4) concepts[cnSeq] = (concepts[cnSeq] || 0) + 1;
299
+
300
+ // Tool patterns
301
+ const toolPatterns: Record<string, number> = {};
302
+ for (const t of s.toolCalls) {
303
+ toolPatterns[t] = (toolPatterns[t] || 0) + 1;
304
+ }
305
+
306
+ return {
307
+ sessionId: s.id,
308
+ date: s.date,
309
+ correctionPhrases,
310
+ concepts,
311
+ toolPatterns,
312
+ sessionDuration: s.userText.length + s.assistantText.length, // proxy
313
+ turnCount: (s.userText.match(/\n/g) || []).length,
314
+ deepAnalysis: s.toolCalls.includes('EnterPlanMode') || s.toolCalls.includes('Agent'),
315
+ knowledgeCaptured: s.toolCalls.includes('Write') && (
316
+ s.assistantText.includes('.harness/knowledge-docs/') ||
317
+ s.assistantText.includes('.harness/knowledge/')
318
+ ),
319
+ };
320
+ });
321
+ }
322
+
323
+ // ── Concept aggregation ──
324
+
325
+ type ConceptMap = Record<string, { count: number; sessions: string[] }>;
326
+
327
+ function buildMergedConcepts(signals: SessionSignals[]): ConceptMap {
328
+ const agg: ConceptMap = {};
329
+ for (const sig of signals) {
330
+ for (const [concept, count] of Object.entries(sig.concepts)) {
331
+ if (!agg[concept]) agg[concept] = { count: 0, sessions: [] };
332
+ agg[concept].count += count;
333
+ if (!agg[concept].sessions.includes(sig.sessionId)) {
334
+ agg[concept].sessions.push(sig.sessionId);
335
+ }
336
+ }
337
+ for (const phrase of sig.correctionPhrases) {
338
+ if (phrase.length < 4) continue;
339
+ if (!agg[phrase]) agg[phrase] = { count: 0, sessions: [] };
340
+ agg[phrase].count += 3;
341
+ if (!agg[phrase].sessions.includes(sig.sessionId)) {
342
+ agg[phrase].sessions.push(sig.sessionId);
343
+ }
344
+ }
345
+ }
346
+ return clusterConcepts(agg);
347
+ }
348
+
349
+ // ── Diff & Apply ──
350
+
351
+ interface Change {
352
+ type: 'new_pattern' | 'rising' | 'falling' | 'gone' | 'lens_shift';
353
+ key: string;
354
+ detail: string;
355
+ }
356
+
357
+ function diffState(state: ModelState, mergedConcepts: ConceptMap, signals: SessionSignals[]): Change[] {
358
+ const changes: Change[] = [];
359
+
360
+ // Detect new/rising/falling/gone concepts (from merged clusters)
361
+ for (const [concept, agg] of Object.entries(mergedConcepts)) {
362
+ const existing = state.patterns[concept];
363
+ if (!existing) {
364
+ if (agg.sessions.length >= 2) {
365
+ changes.push({ type: 'new_pattern', key: concept, detail: `Appeared in ${agg.sessions.length} sessions` });
366
+ }
367
+ } else if (existing.trend === 'gone' || existing.trend === 'falling') {
368
+ changes.push({ type: 'rising', key: concept, detail: `Re-emerged after being ${existing.trend}` });
369
+ }
370
+ }
371
+
372
+ // Detect lens weight shifts (from correction patterns)
373
+ const totalCorrections = signals.reduce((sum, s) => sum + s.correctionPhrases.length, 0);
374
+ if (totalCorrections >= 3) {
375
+ changes.push({ type: 'lens_shift', key: 'completeness',
376
+ detail: `${totalCorrections} corrections in these sessions — completeness lens may need weight increase` });
377
+ }
378
+
379
+ return changes;
380
+ }
381
+
382
+ function applySignals(state: ModelState, signals: SessionSignals[], mergedConcepts: ConceptMap): void {
383
+ const now = new Date().toISOString().slice(0, 10);
384
+
385
+ // Update patterns from merged concept clusters
386
+ for (const [concept, agg] of Object.entries(mergedConcepts)) {
387
+ if (!state.patterns[concept]) {
388
+ state.patterns[concept] = {
389
+ firstSeen: now, occurrences: 0, sessions: [], trend: 'new', lastSeen: now,
390
+ };
391
+ }
392
+ const p = state.patterns[concept];
393
+ p.occurrences += agg.count;
394
+ for (const sid of agg.sessions) {
395
+ if (!p.sessions.includes(sid)) p.sessions.push(sid);
396
+ }
397
+ p.lastSeen = now;
398
+ p.trend = p.occurrences >= 5 ? 'stable' : 'rising';
399
+ }
400
+
401
+ // Also track per-session concepts
402
+ for (const sig of signals) {
403
+ for (const [concept, count] of Object.entries(sig.concepts)) {
404
+ if (!state.patterns[concept]) {
405
+ state.patterns[concept] = {
406
+ firstSeen: now,
407
+ occurrences: 0,
408
+ sessions: [],
409
+ trend: 'new',
410
+ lastSeen: now,
411
+ };
412
+ }
413
+ const p = state.patterns[concept];
414
+ p.occurrences += count;
415
+ if (!p.sessions.includes(sig.sessionId)) p.sessions.push(sig.sessionId);
416
+ p.lastSeen = now;
417
+ p.trend = p.occurrences >= 5 ? 'stable' : 'rising';
418
+ }
419
+ }
420
+
421
+ // Update lens weights from correction signals
422
+ for (const sig of signals) {
423
+ if (sig.correctionPhrases.length > 0) {
424
+ state.lensWeights.completeness = (state.lensWeights.completeness || 0) + 1;
425
+ state.lensWeights.automation = (state.lensWeights.automation || 0) + (sig.correctionPhrases.length > 2 ? 1 : 0);
426
+ }
427
+ if (sig.deepAnalysis) {
428
+ state.lensWeights.first_principles = (state.lensWeights.first_principles || 0) + 1;
429
+ }
430
+ }
431
+
432
+ // Detect falling/stable shifts
433
+ for (const [key, p] of Object.entries(state.patterns)) {
434
+ if (p.trend === 'stable' && p.lastSeen < new Date(Date.now() - 7 * 86400000).toISOString().slice(0, 10)) {
435
+ p.trend = 'falling';
436
+ }
437
+ }
438
+ }
439
+
440
+ // ── Profile update ──
441
+
442
+ function updateProfile(state: ModelState): void {
443
+ try {
444
+ let content = fs.readFileSync(PROFILE_FILE, 'utf-8');
445
+
446
+ // Replace Derived Rules section
447
+ const derivedStart = '## Derived Rules';
448
+ const derivedEnd = '\n## Evolution';
449
+ const derivedIdx = content.indexOf(derivedStart);
450
+
451
+ const activePatterns = Object.entries(state.patterns)
452
+ .filter(([, p]) => (p.trend === 'rising' || p.trend === 'stable') && p.sessions.length >= 2)
453
+ .sort(([, a], [, b]) => b.occurrences - a.occurrences)
454
+ .slice(0, 10);
455
+
456
+ const derivedContent = [
457
+ '## Derived Rules (auto-generated by update-user-model)',
458
+ `Last scan: ${state.lastUpdated}. ${state.sessionsProcessed.length} sessions analyzed.`,
459
+ '',
460
+ '| Pattern | Trend | Occurrences | Sessions |',
461
+ '|---------|-------|-------------|----------|',
462
+ ...activePatterns.map(([k, p]) =>
463
+ `| ${k} | ${p.trend} | ${p.occurrences} | ${p.sessions.length} |`),
464
+ '',
465
+ ].join('\n');
466
+
467
+ if (derivedIdx >= 0) {
468
+ content = content.slice(0, derivedIdx) + derivedContent + '\n' + content.slice(content.indexOf(derivedEnd, derivedIdx));
469
+ } else {
470
+ // No derived section yet — append before Evolution
471
+ const evIdx = content.indexOf('## Evolution');
472
+ if (evIdx >= 0) {
473
+ content = content.slice(0, evIdx) + derivedContent + '\n' + content.slice(evIdx);
474
+ } else {
475
+ content += '\n' + derivedContent;
476
+ }
477
+ }
478
+
479
+ fs.writeFileSync(PROFILE_FILE, content, 'utf-8');
480
+ } catch (e) {
481
+ // Profile file might not exist yet — skip
482
+ }
483
+ }
484
+
485
+ // ── Output ──
486
+
487
+ function printChanges(changes: Change[], signals: SessionSignals[]): void {
488
+ if (changes.length === 0) {
489
+ console.log(chalk.green('No significant changes detected'));
490
+ return;
491
+ }
492
+
493
+ const byType = {
494
+ new_pattern: changes.filter(c => c.type === 'new_pattern'),
495
+ rising: changes.filter(c => c.type === 'rising'),
496
+ lens_shift: changes.filter(c => c.type === 'lens_shift'),
497
+ };
498
+
499
+ if (byType.new_pattern.length > 0) {
500
+ console.log(chalk.yellow(`🌱 New patterns: ${byType.new_pattern.length}`));
501
+ for (const c of byType.new_pattern.slice(0, 5)) {
502
+ console.log(chalk.gray(` ${c.key}: ${c.detail}`));
503
+ }
504
+ console.log();
505
+ }
506
+
507
+ if (byType.rising.length > 0) {
508
+ console.log(chalk.green(`📈 Re-emerging: ${byType.rising.length}`));
509
+ for (const c of byType.rising.slice(0, 5)) {
510
+ console.log(chalk.gray(` ${c.key}: ${c.detail}`));
511
+ }
512
+ console.log();
513
+ }
514
+
515
+ if (byType.lens_shift.length > 0) {
516
+ console.log(chalk.cyan(`🎯 Lens shifts:`));
517
+ for (const c of byType.lens_shift) {
518
+ console.log(chalk.gray(` ${c.key}: ${c.detail}`));
519
+ }
520
+ console.log();
521
+ }
522
+
523
+ console.log(chalk.bold(`Total signals processed:`));
524
+ console.log(` Sessions: ${signals.length}`);
525
+ console.log(` Correction phrases: ${signals.reduce((s, sig) => s + sig.correctionPhrases.length, 0)}`);
526
+ console.log(` Concepts extracted: ${signals.reduce((s, sig) => s + Object.keys(sig.concepts).length, 0)}`);
527
+ }