akm-cli 0.9.0-rc.1 → 0.9.0-rc.13

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 (587) hide show
  1. package/CHANGELOG.md +1190 -52
  2. package/README.md +62 -37
  3. package/SECURITY.md +46 -31
  4. package/dist/akm +162 -38
  5. package/dist/akm-migrate +44 -0
  6. package/dist/assets/backends/schtasks-template.xml +2 -1
  7. package/dist/assets/hints/cli-hints-full.md +268 -118
  8. package/dist/assets/hints/cli-hints-short.md +87 -24
  9. package/dist/assets/{profiles → improve-strategies}/catchup.json +3 -1
  10. package/dist/assets/{profiles → improve-strategies}/consolidate.json +3 -1
  11. package/dist/assets/{profiles → improve-strategies}/default.json +6 -7
  12. package/dist/assets/improve-strategies/frequent.json +15 -0
  13. package/dist/assets/{profiles → improve-strategies}/graph-refresh.json +4 -2
  14. package/dist/assets/{profiles → improve-strategies}/memory-focus.json +4 -1
  15. package/dist/assets/{profiles → improve-strategies}/proactive-maintenance.json +5 -5
  16. package/dist/assets/{profiles → improve-strategies}/quick.json +4 -2
  17. package/dist/assets/improve-strategies/reflect-distill.json +30 -0
  18. package/dist/assets/{profiles → improve-strategies}/thorough.json +1 -1
  19. package/dist/assets/prompts/consolidate-system.md +5 -5
  20. package/dist/assets/prompts/extract-session.md +2 -6
  21. package/dist/assets/prompts/memory-infer-user.md +2 -3
  22. package/dist/assets/prompts/reflect-llm-framed-contract.md +11 -0
  23. package/dist/assets/prompts/reflect-llm-schema-contract.md +3 -0
  24. package/dist/assets/prompts/reflect-output-repair.md +3 -0
  25. package/dist/assets/stash-skeleton/README.md +38 -10
  26. package/dist/assets/stash-skeleton/facts/conventions/assets/agent.md +8 -0
  27. package/dist/assets/stash-skeleton/facts/conventions/assets/command.md +8 -0
  28. package/dist/assets/stash-skeleton/facts/conventions/assets/fact.md +14 -1
  29. package/dist/assets/stash-skeleton/facts/conventions/assets/knowledge.md +13 -1
  30. package/dist/assets/stash-skeleton/facts/conventions/assets/lesson.md +9 -1
  31. package/dist/assets/stash-skeleton/facts/conventions/assets/memory.md +11 -0
  32. package/dist/assets/stash-skeleton/facts/conventions/assets/script.md +9 -0
  33. package/dist/assets/stash-skeleton/facts/conventions/assets/skill.md +9 -0
  34. package/dist/assets/stash-skeleton/facts/conventions/assets/workflow.md +8 -0
  35. package/dist/assets/stash-skeleton/facts/conventions/backlinks.md +100 -0
  36. package/dist/assets/stash-skeleton/facts/conventions/domains.md +64 -0
  37. package/dist/assets/stash-skeleton/facts/conventions/organization.md +136 -0
  38. package/dist/assets/tasks/core/extract.yml +3 -2
  39. package/dist/assets/tasks/core/improve.yml +2 -1
  40. package/dist/assets/tasks/core/index-refresh.yml +1 -0
  41. package/dist/assets/tasks/core/sync.yml +1 -0
  42. package/dist/assets/tasks/core/version-check.yml +2 -1
  43. package/dist/assets/tasks/improve/akm-graph-refresh-weekly.yml +5 -0
  44. package/dist/assets/tasks/improve/akm-improve-catchup.yml +8 -0
  45. package/dist/assets/tasks/improve/akm-improve-consolidate.yml +5 -0
  46. package/dist/assets/tasks/improve/akm-improve-frequent.yml +5 -0
  47. package/dist/assets/tasks/improve/akm-improve-nightly.yml +5 -0
  48. package/dist/assets/templates/html/health.html +5 -4
  49. package/dist/assets/workflows/workflow-template.md +31 -15
  50. package/dist/cli/invocation.js +279 -0
  51. package/dist/cli/parse-args.js +5 -90
  52. package/dist/cli/retired-commands.js +78 -0
  53. package/dist/cli/shared.js +158 -48
  54. package/dist/cli-node.mjs +2 -1
  55. package/dist/cli.js +747 -293
  56. package/dist/commands/agent/agent-dispatch.js +19 -18
  57. package/dist/commands/agent/agent-support.js +0 -24
  58. package/dist/commands/agent/contribute-cli.js +43 -97
  59. package/dist/commands/completions.js +80 -23
  60. package/dist/commands/config-cli.js +44 -281
  61. package/dist/commands/env/env-binding.js +13 -9
  62. package/dist/commands/env/env-cli.js +76 -159
  63. package/dist/commands/env/env.js +12 -163
  64. package/dist/commands/env/marker-path.js +6 -0
  65. package/dist/commands/env/secret-cli.js +45 -61
  66. package/dist/commands/env/secret.js +32 -62
  67. package/dist/commands/feedback-cli.js +179 -85
  68. package/dist/commands/health/accept-rate.js +58 -0
  69. package/dist/commands/health/advisories.js +7 -8
  70. package/dist/commands/health/checks.js +279 -94
  71. package/dist/commands/health/html-report.js +197 -578
  72. package/dist/commands/health/improve-metrics.js +277 -246
  73. package/dist/commands/health/llm-usage.js +19 -19
  74. package/dist/commands/health/md-report.js +16 -7
  75. package/dist/commands/health/metrics.js +67 -32
  76. package/dist/commands/health/renderers.js +47 -0
  77. package/dist/commands/health/report-view-model.js +508 -0
  78. package/dist/commands/health/stash-exposure.js +1 -1
  79. package/dist/commands/health/surfaces.js +16 -56
  80. package/dist/commands/health/task-runs.js +3 -67
  81. package/dist/{migrate-storage-node.mjs → commands/health/types-checks.js} +1 -5
  82. package/dist/commands/health/types-improve.js +29 -0
  83. package/dist/{output/text/save.js → commands/health/types-metrics.js} +1 -2
  84. package/dist/commands/health/types-result.js +7 -0
  85. package/dist/commands/health/types-runs.js +4 -0
  86. package/dist/commands/health/types-session-log.js +4 -0
  87. package/dist/commands/health/types-windows.js +4 -0
  88. package/dist/commands/health/types.js +26 -21
  89. package/dist/commands/health/windows.js +2 -3
  90. package/dist/commands/health.js +296 -167
  91. package/dist/commands/improve/anti-collapse.js +5 -5
  92. package/dist/commands/improve/autonomy-gate.js +68 -0
  93. package/dist/commands/improve/collapse-detector.js +65 -52
  94. package/dist/commands/improve/consolidate/chunking.js +9 -7
  95. package/dist/commands/improve/consolidate/eligibility.js +1 -23
  96. package/dist/commands/improve/consolidate/merge.js +4 -0
  97. package/dist/commands/improve/consolidate.js +454 -1354
  98. package/dist/commands/improve/content-hash.js +39 -0
  99. package/dist/commands/improve/distill/content-repair.js +4 -10
  100. package/dist/commands/improve/distill/promote-memory.js +89 -64
  101. package/dist/commands/improve/distill/quality-gate.js +118 -42
  102. package/dist/commands/improve/distill-guards.js +1 -1
  103. package/dist/commands/improve/distill-promotion-policy.js +33 -888
  104. package/dist/commands/improve/distill.js +607 -363
  105. package/dist/commands/improve/eligibility.js +165 -79
  106. package/dist/commands/improve/extract-cli.js +35 -126
  107. package/dist/commands/improve/extract-prompt.js +6 -35
  108. package/dist/commands/improve/extract.js +640 -391
  109. package/dist/commands/improve/feedback-valence.js +2 -12
  110. package/dist/commands/improve/improve-cli.js +134 -135
  111. package/dist/commands/improve/improve-result-file.js +30 -50
  112. package/dist/commands/improve/improve-run-types.js +4 -0
  113. package/dist/commands/improve/improve-strategies.js +135 -0
  114. package/dist/commands/improve/improve.js +904 -701
  115. package/dist/commands/improve/locks.js +64 -111
  116. package/dist/commands/improve/loop-stages.js +1110 -923
  117. package/dist/commands/improve/memory/derived-ref.js +124 -0
  118. package/dist/commands/improve/memory/memory-belief.js +79 -7
  119. package/dist/commands/improve/memory/memory-contradiction-detect.js +49 -52
  120. package/dist/commands/improve/memory/memory-improve.js +25 -37
  121. package/dist/commands/improve/outcome-loop.js +25 -88
  122. package/dist/commands/improve/preparation.js +1034 -813
  123. package/dist/commands/improve/proactive-maintenance.js +34 -9
  124. package/dist/commands/improve/proposal-envelope.js +31 -0
  125. package/dist/commands/improve/reflect.js +983 -794
  126. package/dist/commands/improve/run-context.js +119 -0
  127. package/dist/commands/improve/salience.js +24 -127
  128. package/dist/commands/improve/session-asset.js +7 -3
  129. package/dist/commands/improve/shared.js +14 -34
  130. package/dist/commands/improve/source-identity.js +28 -0
  131. package/dist/commands/improve/triage.js +20 -17
  132. package/dist/commands/lint/base-linter.js +340 -313
  133. package/dist/commands/lint/env-key-rules.js +31 -47
  134. package/dist/commands/lint/index.js +185 -30
  135. package/dist/commands/{events.js → log.js} +28 -38
  136. package/dist/commands/migrate-cli.js +54 -0
  137. package/dist/commands/migration-tool.js +55 -0
  138. package/dist/commands/observability-cli.js +70 -208
  139. package/dist/commands/proposal/diff-format.js +50 -0
  140. package/dist/commands/proposal/drain-policies.js +0 -6
  141. package/dist/commands/proposal/drain.js +91 -40
  142. package/dist/commands/proposal/proposal-cli.js +134 -132
  143. package/dist/commands/proposal/proposal-types.js +56 -0
  144. package/dist/commands/proposal/proposal.js +83 -65
  145. package/dist/commands/proposal/propose-cli.js +88 -0
  146. package/dist/commands/proposal/propose.js +105 -88
  147. package/dist/commands/proposal/repository.js +1303 -278
  148. package/dist/commands/proposal/validators/proposal-quality-validators.js +16 -6
  149. package/dist/commands/proposal/validators/proposal-validators.js +61 -12
  150. package/dist/commands/proposal/validators/proposals.js +6 -8
  151. package/dist/commands/read/curate.js +78 -73
  152. package/dist/commands/read/knowledge.js +510 -13
  153. package/dist/commands/read/registry-search.js +2 -2
  154. package/dist/commands/read/remember-cli.js +84 -15
  155. package/dist/commands/read/search-cli.js +203 -96
  156. package/dist/commands/read/search.js +126 -94
  157. package/dist/commands/read/show.js +226 -250
  158. package/dist/commands/registry-cli.js +34 -60
  159. package/dist/commands/remember.js +18 -57
  160. package/dist/commands/sources/add-cli.js +104 -49
  161. package/dist/commands/sources/bundle-cli.js +166 -0
  162. package/dist/commands/sources/bundle-config-ops.js +63 -0
  163. package/dist/commands/sources/info.js +27 -15
  164. package/dist/commands/sources/init.js +30 -40
  165. package/dist/commands/sources/installed-stashes.js +469 -172
  166. package/dist/commands/sources/schema-repair.js +10 -9
  167. package/dist/commands/sources/self-update.js +182 -121
  168. package/dist/commands/sources/source-add.js +169 -178
  169. package/dist/commands/sources/source-clone.js +144 -41
  170. package/dist/commands/sources/source-manage.js +94 -59
  171. package/dist/commands/sources/sources-cli.js +64 -205
  172. package/dist/commands/sources/stash-cli.js +91 -54
  173. package/dist/commands/sources/stash-skeleton.js +1 -1
  174. package/dist/commands/tasks/tasks-cli.js +106 -104
  175. package/dist/commands/tasks/tasks.js +445 -262
  176. package/dist/commands/workflow-cli.js +75 -228
  177. package/dist/core/action-contributors.js +1 -1
  178. package/dist/core/activation-policy.js +49 -0
  179. package/dist/core/adapter/adapters/agent-skills-adapter.js +181 -0
  180. package/dist/core/adapter/adapters/akm-adapter.js +528 -0
  181. package/dist/core/adapter/adapters/akm-lint.js +392 -0
  182. package/dist/core/adapter/adapters/akm-metadata.js +387 -0
  183. package/dist/core/adapter/adapters/akm-task-adapter.js +149 -0
  184. package/dist/core/adapter/adapters/akm-workflow-adapter.js +180 -0
  185. package/dist/core/adapter/adapters/claude-adapter.js +61 -0
  186. package/dist/core/adapter/adapters/dotenv-adapter.js +187 -0
  187. package/dist/core/adapter/adapters/generic-files-adapter.js +119 -0
  188. package/dist/core/adapter/adapters/index.js +80 -0
  189. package/dist/core/adapter/adapters/llm-wiki-adapter.js +419 -0
  190. package/dist/core/adapter/adapters/okf-adapter.js +391 -0
  191. package/dist/core/adapter/adapters/opencode-adapter.js +68 -0
  192. package/dist/core/adapter/adapters/shared.js +286 -0
  193. package/dist/core/adapter/adapters/tool-dir-shared.js +217 -0
  194. package/dist/core/adapter/adapters/website-snapshot-adapter.js +155 -0
  195. package/dist/core/adapter/bundle-adapter.js +4 -0
  196. package/dist/core/adapter/detect-adapter.js +17 -0
  197. package/dist/core/adapter/recognize-match.js +44 -0
  198. package/dist/core/adapter/registry.js +56 -0
  199. package/dist/core/adapter/types.js +4 -0
  200. package/dist/core/asset/akm-markdown.js +30 -0
  201. package/dist/core/asset/asset-placement.js +243 -0
  202. package/dist/core/asset/asset-ref.js +110 -79
  203. package/dist/core/asset/asset-serialize.js +20 -0
  204. package/dist/core/asset/frontmatter.js +28 -12
  205. package/dist/core/asset/markdown.js +40 -51
  206. package/dist/core/asset/resolve-ref.js +274 -0
  207. package/dist/core/asset/stash-meta.js +2 -2
  208. package/dist/core/bundle-id.js +51 -0
  209. package/dist/core/common.js +281 -86
  210. package/dist/core/config/config-io.js +42 -128
  211. package/dist/core/config/config-schema.js +233 -855
  212. package/dist/core/config/config-sources.js +162 -39
  213. package/dist/core/config/config-types.js +16 -11
  214. package/dist/core/config/config-version.js +29 -0
  215. package/dist/core/config/config-walker.js +126 -37
  216. package/dist/core/config/config.js +154 -331
  217. package/dist/core/config/deep-merge.js +41 -0
  218. package/dist/core/config/engine-semantics.js +28 -0
  219. package/dist/core/config/experimental.js +21 -0
  220. package/dist/core/config/schema/embedding.js +38 -0
  221. package/dist/core/config/schema/engines.js +116 -0
  222. package/dist/core/config/schema/experimental.js +47 -0
  223. package/dist/core/config/schema/feedback.js +31 -0
  224. package/dist/core/config/schema/improve-processes.js +389 -0
  225. package/dist/core/config/schema/improve.js +94 -0
  226. package/dist/core/config/schema/index-config.js +176 -0
  227. package/dist/core/config/schema/output.js +18 -0
  228. package/dist/core/config/schema/primitives.js +94 -0
  229. package/dist/core/config/schema/search.js +30 -0
  230. package/dist/core/config/schema/setup.js +18 -0
  231. package/dist/core/config/schema/sources-bundles.js +169 -0
  232. package/dist/core/config/schema/workflow.js +29 -0
  233. package/dist/core/env-secret-ref.js +155 -20
  234. package/dist/core/errors.js +17 -15
  235. package/dist/core/events-types.js +4 -0
  236. package/dist/core/events.js +46 -128
  237. package/dist/core/extra-params.js +62 -0
  238. package/dist/core/file-change.js +17 -0
  239. package/dist/core/file-lock.js +202 -57
  240. package/dist/core/fs-txn.js +392 -0
  241. package/dist/core/git-message.js +59 -0
  242. package/dist/core/improve-result.js +167 -0
  243. package/dist/core/lesson-lint.js +1 -17
  244. package/dist/core/logs-db.js +1 -1
  245. package/dist/core/maintenance-barrier.js +135 -0
  246. package/dist/core/migration-operation.js +44 -0
  247. package/dist/core/mutation-target.js +78 -0
  248. package/dist/core/paths.js +22 -25
  249. package/dist/core/platform.js +10 -0
  250. package/dist/core/recognition-util.js +128 -0
  251. package/dist/core/redaction.js +392 -0
  252. package/dist/core/standards/resolve-standards-context.js +36 -65
  253. package/dist/core/standards/resolve-stash-standards.js +2 -2
  254. package/dist/core/standards/resolve-type-conventions.js +5 -5
  255. package/dist/core/state/migrations.js +242 -11
  256. package/dist/core/state-db.js +98 -10
  257. package/dist/core/structured.js +1 -1
  258. package/dist/core/subprocess.js +303 -0
  259. package/dist/core/text-truncation.js +9 -5
  260. package/dist/core/time.js +20 -0
  261. package/dist/core/type-presentation.js +130 -0
  262. package/dist/core/warn.js +0 -3
  263. package/dist/core/write-source.js +834 -118
  264. package/dist/indexer/bundle-identity-guard.js +92 -0
  265. package/dist/indexer/db/graph-db.js +1 -25
  266. package/dist/indexer/db/llm-cache.js +1 -1
  267. package/dist/indexer/ensure-index.js +30 -9
  268. package/dist/indexer/graph/graph-boost.js +9 -30
  269. package/dist/indexer/graph/graph-extraction.js +41 -27
  270. package/dist/indexer/graph/graph-types.js +4 -0
  271. package/dist/indexer/index-writer-lock.js +93 -49
  272. package/dist/indexer/index-written-assets.js +100 -53
  273. package/dist/indexer/indexer.js +746 -329
  274. package/dist/indexer/init.js +18 -25
  275. package/dist/indexer/installations.js +142 -0
  276. package/dist/indexer/passes/dir-staleness.js +18 -10
  277. package/dist/indexer/passes/memory-inference.js +25 -15
  278. package/dist/indexer/passes/metadata.js +412 -243
  279. package/dist/indexer/scan/doc-to-entry.js +160 -0
  280. package/dist/indexer/scan/drain-dir.js +134 -0
  281. package/dist/indexer/search/db-search.js +292 -108
  282. package/dist/indexer/search/fts-query.js +64 -0
  283. package/dist/indexer/search/ranking-contributors.js +145 -25
  284. package/dist/indexer/search/ranking-types.js +4 -0
  285. package/dist/indexer/search/ranking.js +28 -71
  286. package/dist/indexer/search/search-attribution.js +67 -0
  287. package/dist/indexer/search/search-fields.js +18 -3
  288. package/dist/indexer/search/search-hit-enrichers.js +30 -40
  289. package/dist/indexer/search/search-source.js +157 -111
  290. package/dist/indexer/search/semantic-status.js +4 -1
  291. package/dist/indexer/usage/usage-events.js +10 -30
  292. package/dist/indexer/walk/file-context.js +3 -45
  293. package/dist/indexer/walk/matchers.js +42 -73
  294. package/dist/indexer/walk/path-resolver.js +11 -5
  295. package/dist/indexer/walk/walker.js +42 -14
  296. package/dist/integrations/agent/builder-shared.js +7 -0
  297. package/dist/integrations/agent/builders.js +5 -58
  298. package/dist/integrations/agent/config.js +3 -143
  299. package/dist/integrations/agent/detect.js +17 -2
  300. package/dist/integrations/agent/engine-resolution.js +231 -0
  301. package/dist/integrations/agent/index.js +1 -2
  302. package/dist/integrations/agent/model-aliases.js +8 -3
  303. package/dist/integrations/agent/profiles.js +6 -99
  304. package/dist/integrations/agent/prompts.js +46 -18
  305. package/dist/integrations/agent/runner-dispatch.js +78 -13
  306. package/dist/integrations/agent/runner.js +76 -208
  307. package/dist/integrations/agent/spawn.js +48 -279
  308. package/dist/integrations/harnesses/aider/agent-builder.js +9 -8
  309. package/dist/integrations/harnesses/aider/index.js +2 -12
  310. package/dist/integrations/harnesses/amazonq/agent-builder.js +10 -16
  311. package/dist/integrations/harnesses/amazonq/index.js +3 -17
  312. package/dist/integrations/harnesses/claude/agent-builder.js +2 -3
  313. package/dist/integrations/harnesses/claude/config-import.js +1 -3
  314. package/dist/integrations/harnesses/claude/index.js +1 -14
  315. package/dist/integrations/harnesses/claude/session-log.js +27 -75
  316. package/dist/integrations/harnesses/codex/agent-builder.js +8 -7
  317. package/dist/integrations/harnesses/codex/index.js +2 -13
  318. package/dist/integrations/harnesses/copilot/agent-builder.js +9 -9
  319. package/dist/integrations/harnesses/copilot/index.js +1 -13
  320. package/dist/integrations/harnesses/gemini/agent-builder.js +8 -9
  321. package/dist/integrations/harnesses/gemini/index.js +1 -13
  322. package/dist/integrations/harnesses/ids.js +24 -0
  323. package/dist/integrations/harnesses/index.js +31 -33
  324. package/dist/integrations/harnesses/opencode/agent-builder.js +23 -5
  325. package/dist/integrations/harnesses/opencode/config-import.js +1 -3
  326. package/dist/integrations/harnesses/opencode/index.js +1 -18
  327. package/dist/integrations/harnesses/opencode/session-log.js +67 -125
  328. package/dist/integrations/harnesses/opencode-sdk/harness.js +3 -17
  329. package/dist/integrations/harnesses/opencode-sdk/sdk-runner.js +274 -191
  330. package/dist/integrations/harnesses/openhands/agent-builder.js +12 -10
  331. package/dist/integrations/harnesses/openhands/index.js +2 -12
  332. package/dist/integrations/harnesses/pi/agent-builder.js +11 -18
  333. package/dist/integrations/harnesses/pi/index.js +3 -16
  334. package/dist/integrations/harnesses/shared.js +17 -0
  335. package/dist/integrations/harnesses/types.js +38 -34
  336. package/dist/integrations/lockfile.js +211 -24
  337. package/dist/integrations/session-logs/index.js +24 -40
  338. package/dist/integrations/session-logs/provider-base.js +113 -0
  339. package/dist/llm/client.js +182 -110
  340. package/dist/llm/embedders/deterministic.js +2 -2
  341. package/dist/llm/embedders/remote.js +21 -9
  342. package/dist/llm/feature-gate.js +17 -57
  343. package/dist/llm/graph-extract.js +12 -13
  344. package/dist/llm/index-passes.js +8 -42
  345. package/dist/llm/memory-infer.js +144 -1
  346. package/dist/llm/metadata-enhance.js +45 -30
  347. package/dist/llm/structured-call.js +16 -8
  348. package/dist/llm/usage-persist.js +30 -5
  349. package/dist/llm/usage-telemetry.js +59 -6
  350. package/dist/output/cli-hints.js +1 -2
  351. package/dist/output/command-registry.js +27 -0
  352. package/dist/output/context.js +22 -7
  353. package/dist/output/format-exempt.js +80 -0
  354. package/dist/output/generic-render.js +251 -0
  355. package/dist/output/html-render.js +11 -16
  356. package/dist/output/render-registry.js +57 -0
  357. package/dist/output/renderers.js +15 -281
  358. package/dist/output/shapes/curate.js +10 -1
  359. package/dist/output/shapes/events.js +12 -7
  360. package/dist/output/shapes/helpers.js +58 -84
  361. package/dist/output/shapes/passthrough.js +8 -40
  362. package/dist/output/shapes/proposal/producer.js +15 -7
  363. package/dist/output/shapes/registry.js +12 -6
  364. package/dist/output/shapes.js +0 -9
  365. package/dist/output/text/{init.js → bundle-create.js} +3 -1
  366. package/dist/output/text/bundle-show.js +7 -0
  367. package/dist/output/text/command-format.js +562 -0
  368. package/dist/output/text/env.js +1 -3
  369. package/dist/output/text/events.js +8 -7
  370. package/dist/output/text/helpers.js +15 -1375
  371. package/dist/output/text/proposal/producer.js +4 -2
  372. package/dist/output/text/proposal-format.js +202 -0
  373. package/dist/output/text/registry-commands.js +1 -2
  374. package/dist/output/text/registry.js +12 -6
  375. package/dist/output/text/show-directives.js +117 -0
  376. package/dist/output/text/show-format.js +103 -0
  377. package/dist/output/text/sync.js +5 -0
  378. package/dist/output/text/workflow-format.js +332 -0
  379. package/dist/output/text/workflow.js +1 -2
  380. package/dist/output/text.js +10 -19
  381. package/dist/registry/factory.js +4 -6
  382. package/dist/registry/origin-resolve.js +16 -27
  383. package/dist/registry/providers/skills-sh.js +3 -3
  384. package/dist/registry/providers/static-index.js +15 -25
  385. package/dist/registry/resolve.js +43 -94
  386. package/dist/registry/semver.js +43 -0
  387. package/dist/runtime.js +81 -12
  388. package/dist/scripts/akm-migrate.js +35529 -0
  389. package/dist/setup/detect.js +5 -7
  390. package/dist/setup/detected-engines.js +136 -0
  391. package/dist/setup/engine-config.js +100 -0
  392. package/dist/setup/registry-stash-loader.js +3 -3
  393. package/dist/setup/semantic-assets.js +12 -9
  394. package/dist/setup/setup.js +444 -208
  395. package/dist/setup/steps/connection-shared.js +120 -0
  396. package/dist/setup/steps/connection.js +108 -305
  397. package/dist/setup/steps/platforms.js +13 -12
  398. package/dist/setup/steps/semantic.js +15 -3
  399. package/dist/setup/steps/sources.js +21 -15
  400. package/dist/setup/steps/stashdir.js +6 -4
  401. package/dist/setup/steps/tasks.js +236 -119
  402. package/dist/setup/steps.js +3 -2
  403. package/dist/sources/freshness.js +39 -0
  404. package/dist/sources/provider-factory.js +11 -17
  405. package/dist/sources/providers/filesystem.js +2 -3
  406. package/dist/sources/providers/git-install.js +278 -34
  407. package/dist/sources/providers/git-provider.js +54 -56
  408. package/dist/sources/providers/git-stash.js +420 -91
  409. package/dist/sources/providers/git.js +2 -2
  410. package/dist/sources/providers/npm.js +16 -19
  411. package/dist/sources/providers/provider-utils.js +47 -22
  412. package/dist/sources/providers/sync-from-ref.js +3 -9
  413. package/dist/sources/providers/website.js +2 -2
  414. package/dist/sources/resolve.js +11 -10
  415. package/dist/sources/snapshot-fetchers/types.js +4 -0
  416. package/dist/sources/{website-ingest.js → snapshot-fetchers/website-ingest.js} +110 -41
  417. package/dist/storage/database.js +60 -4
  418. package/dist/storage/engines/sqlite-migrations.js +156 -5
  419. package/dist/storage/locations.js +1 -2
  420. package/dist/storage/repositories/canaries-repository.js +1 -1
  421. package/dist/storage/repositories/events-repository.js +51 -11
  422. package/dist/storage/repositories/improve-runs-repository.js +6 -32
  423. package/dist/storage/repositories/index-connection.js +79 -0
  424. package/dist/storage/repositories/index-db.js +4 -3
  425. package/dist/storage/repositories/index-entries-repository.js +863 -0
  426. package/dist/{indexer/db/entry-mapper.js → storage/repositories/index-entry-mapper.js} +19 -2
  427. package/dist/storage/repositories/index-entry-types.js +4 -0
  428. package/dist/storage/repositories/index-fts-repository.js +167 -0
  429. package/dist/storage/repositories/index-llm-cache-repository.js +108 -0
  430. package/dist/storage/repositories/index-meta-repository.js +49 -0
  431. package/dist/{indexer/db/schema.js → storage/repositories/index-schema.js} +226 -100
  432. package/dist/storage/repositories/index-sql.js +12 -0
  433. package/dist/storage/repositories/index-utility-repository.js +356 -0
  434. package/dist/storage/repositories/index-vec-repository.js +250 -0
  435. package/dist/storage/repositories/outcome-repository.js +119 -0
  436. package/dist/storage/repositories/proposals-repository.js +317 -75
  437. package/dist/storage/repositories/registry-cache.js +1 -1
  438. package/dist/storage/repositories/salience-repository.js +172 -0
  439. package/dist/storage/repositories/task-history-repository.js +110 -3
  440. package/dist/storage/repositories/workflow-runs-repository.js +68 -35
  441. package/dist/tasks/backends/cron.js +169 -46
  442. package/dist/tasks/backends/exec-utils.js +76 -3
  443. package/dist/tasks/backends/index.js +6 -9
  444. package/dist/tasks/backends/launchd.js +292 -55
  445. package/dist/tasks/backends/schtasks.js +557 -70
  446. package/dist/tasks/backends/types.js +4 -0
  447. package/dist/tasks/command-executable.js +93 -0
  448. package/dist/tasks/embedded.js +56 -38
  449. package/dist/tasks/parser.js +156 -64
  450. package/dist/tasks/resolve-akm-bin.js +144 -51
  451. package/dist/tasks/runner.js +377 -209
  452. package/dist/tasks/schedule.js +108 -19
  453. package/dist/tasks/scheduler-invocation.js +296 -0
  454. package/dist/tasks/schema.js +1 -1
  455. package/dist/tasks/task-id.js +35 -0
  456. package/dist/tasks/validator.js +30 -16
  457. package/dist/workflows/authoring/authoring.js +96 -148
  458. package/dist/workflows/authoring/scope-key.js +1 -1
  459. package/dist/workflows/cli.js +0 -20
  460. package/dist/workflows/concurrency-policy.js +15 -0
  461. package/dist/workflows/exec/brief.js +25 -59
  462. package/dist/workflows/exec/frozen-judge.js +47 -0
  463. package/dist/workflows/exec/native-executor.js +157 -94
  464. package/dist/workflows/exec/report.js +365 -200
  465. package/dist/workflows/exec/run-workflow.js +46 -40
  466. package/dist/workflows/exec/scheduler.js +12 -41
  467. package/dist/workflows/exec/step-work.js +239 -205
  468. package/dist/workflows/exec/workflow-engine-gate.js +67 -0
  469. package/dist/workflows/ir/compile.js +141 -283
  470. package/dist/workflows/ir/freeze.js +233 -0
  471. package/dist/workflows/ir/plan-hash.js +40 -5
  472. package/dist/workflows/ir/schema.js +537 -1
  473. package/dist/workflows/parser.js +878 -306
  474. package/dist/workflows/program/expressions.js +20 -208
  475. package/dist/workflows/program/schema.js +7 -10
  476. package/dist/workflows/renderer.js +99 -121
  477. package/dist/workflows/resource-limits.js +22 -0
  478. package/dist/workflows/runtime/checkin.js +1 -1
  479. package/dist/workflows/runtime/plan-classifier.js +131 -0
  480. package/dist/workflows/runtime/runs.js +200 -113
  481. package/dist/workflows/runtime/unit-checkin.js +1 -1
  482. package/dist/workflows/runtime/unit-phases.js +20 -0
  483. package/dist/workflows/runtime/workflow-asset-loader.js +235 -97
  484. package/dist/workflows/schema.js +1 -11
  485. package/dist/workflows/validate-summary.js +4 -26
  486. package/dist/workflows/validator.js +52 -30
  487. package/docs/README.md +42 -78
  488. package/docs/migration/README.md +8 -0
  489. package/docs/migration/release-notes/0.6.0.md +1 -1
  490. package/docs/migration/release-notes/0.7.0.md +9 -8
  491. package/docs/migration/release-notes/0.9.0.md +158 -14
  492. package/docs/migration/v0.7-to-v0.8.md +46 -47
  493. package/docs/migration/v0.8-to-v0.9.md +844 -0
  494. package/docs/reference/README.md +12 -0
  495. package/docs/reference/data-and-telemetry.md +333 -0
  496. package/package.json +21 -17
  497. package/schemas/akm-asset-envelope.json +93 -0
  498. package/schemas/akm-config.json +4636 -0
  499. package/schemas/akm-task.json +87 -0
  500. package/{dist/schemas → schemas}/akm-workflow.json +127 -82
  501. package/dist/akm-migrate-storage +0 -38
  502. package/dist/assets/help/help-accept.md +0 -12
  503. package/dist/assets/help/help-improve.md +0 -84
  504. package/dist/assets/help/help-proposals.md +0 -17
  505. package/dist/assets/help/help-propose.md +0 -17
  506. package/dist/assets/help/help-reject.md +0 -11
  507. package/dist/assets/profiles/frequent.json +0 -13
  508. package/dist/assets/profiles/recombine-only.json +0 -21
  509. package/dist/assets/profiles/reflect-distill.json +0 -30
  510. package/dist/assets/profiles/synthesize.json +0 -15
  511. package/dist/assets/prompts/procedural-system.md +0 -44
  512. package/dist/assets/prompts/recombine-system.md +0 -40
  513. package/dist/assets/prompts/staleness-detect-system.md +0 -6
  514. package/dist/assets/tasks/core/backup.yml +0 -4
  515. package/dist/assets/tasks/graph-refresh-weekly.yml +0 -10
  516. package/dist/assets/templates/html/default.html +0 -78
  517. package/dist/assets/templates/html/vendor/echarts.min.js +0 -45
  518. package/dist/assets/wiki/index-template.md +0 -12
  519. package/dist/assets/wiki/ingest-workflow-template.md +0 -83
  520. package/dist/assets/wiki/log-template.md +0 -8
  521. package/dist/assets/wiki/schema-template.md +0 -61
  522. package/dist/cli/config-migrate.js +0 -150
  523. package/dist/cli/config-validate.js +0 -39
  524. package/dist/commands/graph/graph-cli.js +0 -124
  525. package/dist/commands/graph/graph.js +0 -487
  526. package/dist/commands/improve/calibration.js +0 -161
  527. package/dist/commands/improve/dedup.js +0 -482
  528. package/dist/commands/improve/extract-watch.js +0 -140
  529. package/dist/commands/improve/hot-probation.js +0 -45
  530. package/dist/commands/improve/improve-auto-accept.js +0 -276
  531. package/dist/commands/improve/improve-profiles.js +0 -168
  532. package/dist/commands/improve/procedural.js +0 -398
  533. package/dist/commands/improve/recombine.js +0 -818
  534. package/dist/commands/improve/schema-similarity-gate.js +0 -168
  535. package/dist/commands/lint/agent-linter.js +0 -44
  536. package/dist/commands/lint/command-linter.js +0 -44
  537. package/dist/commands/lint/default-linter.js +0 -16
  538. package/dist/commands/lint/fact-linter.js +0 -39
  539. package/dist/commands/lint/knowledge-linter.js +0 -16
  540. package/dist/commands/lint/memory-linter.js +0 -61
  541. package/dist/commands/lint/registry.js +0 -41
  542. package/dist/commands/lint/skill-linter.js +0 -45
  543. package/dist/commands/lint/task-linter.js +0 -50
  544. package/dist/commands/lint/workflow-linter.js +0 -81
  545. package/dist/commands/proposal/legacy-import.js +0 -115
  546. package/dist/commands/sources/history.js +0 -196
  547. package/dist/commands/tasks/default-tasks.js +0 -186
  548. package/dist/commands/wiki-cli.js +0 -292
  549. package/dist/core/asset/asset-registry.js +0 -76
  550. package/dist/core/asset/asset-spec.js +0 -316
  551. package/dist/core/config/config-migration.js +0 -602
  552. package/dist/core/deep-merge.js +0 -38
  553. package/dist/core/eval/rank-metrics.js +0 -113
  554. package/dist/core/ripgrep/install.js +0 -163
  555. package/dist/core/ripgrep/resolve.js +0 -81
  556. package/dist/indexer/db/db.js +0 -1414
  557. package/dist/indexer/manifest.js +0 -170
  558. package/dist/indexer/passes/metadata-contributors.js +0 -31
  559. package/dist/indexer/usage/unmigrated-vaults-guard.js +0 -94
  560. package/dist/integrations/harnesses/opencode-sdk/index.js +0 -25
  561. package/dist/llm/call-ai.js +0 -62
  562. package/dist/llm/memory-infer-impl.js +0 -138
  563. package/dist/output/shapes/distill.js +0 -14
  564. package/dist/output/shapes/history.js +0 -11
  565. package/dist/output/text/distill.js +0 -6
  566. package/dist/output/text/enable-disable.js +0 -8
  567. package/dist/output/text/history.js +0 -6
  568. package/dist/output/text/wiki.js +0 -16
  569. package/dist/registry/build-index.js +0 -386
  570. package/dist/schemas/akm-config.json +0 -14225
  571. package/dist/scripts/migrate-storage.js +0 -13169
  572. package/dist/scripts/migrations/import-fs-improve-runs-to-db.js +0 -10169
  573. package/dist/scripts/migrations/v16-to-v17.js +0 -141
  574. package/dist/setup/legacy-config.js +0 -106
  575. package/dist/storage/repositories/consolidation-repository.js +0 -38
  576. package/dist/storage/repositories/recombine-repository.js +0 -213
  577. package/dist/wiki/wiki-templates.js +0 -15
  578. package/dist/wiki/wiki.js +0 -1012
  579. package/dist/workflows/authoring/workflow-program-template.yaml +0 -31
  580. package/dist/workflows/db.js +0 -350
  581. package/dist/workflows/exec/watch.js +0 -116
  582. package/dist/workflows/program/parser.js +0 -760
  583. package/dist/workflows/program/project.js +0 -105
  584. package/docs/data-and-telemetry.md +0 -227
  585. package/docs/migration/release-notes/0.9.0-beta.60.md +0 -19
  586. /package/dist/sources/{wiki-fetchers → snapshot-fetchers}/registry.js +0 -0
  587. /package/dist/sources/{wiki-fetchers → snapshot-fetchers}/youtube.js +0 -0
@@ -0,0 +1,57 @@
1
+ // This Source Code Form is subject to the terms of the Mozilla Public
2
+ // License, v. 2.0. If a copy of the MPL was not distributed with this
3
+ // file, You can obtain one at https://mozilla.org/MPL/2.0/.
4
+ /**
5
+ * Per-command `md` / `html` renderer registries (D7).
6
+ *
7
+ * Mirrors `src/output/text/registry.ts`: a command may register a bespoke
8
+ * renderer for a document format, and anything unregistered falls back to the
9
+ * generic rendering of its shaped envelope (`./generic-render`). The fallback
10
+ * is what makes all six `--format` values universal; the registry is what lets
11
+ * a command that has something better to say — `akm health` and its report
12
+ * templates — say it without the output pipeline knowing that command exists.
13
+ *
14
+ * Kept separate from the module that dispatches through it so per-command
15
+ * renderer modules can import `registerMdRenderer` / `registerHtmlRenderer`
16
+ * without a cycle back into the pipeline, exactly as the text registry does.
17
+ *
18
+ * Returning `null` from a handler means "I have nothing special for this
19
+ * payload" and falls through to the generic renderer — `akm health` uses that
20
+ * to keep its bespoke tables for the shapes that have them while still
21
+ * rendering everything else.
22
+ */
23
+ import { createCommandRegistry } from "./command-registry.js";
24
+ const MD_RENDERER_REGISTRY = createCommandRegistry();
25
+ const HTML_RENDERER_REGISTRY = createCommandRegistry();
26
+ /** Register a Markdown renderer for a command name. */
27
+ export function registerMdRenderer(command, handler) {
28
+ MD_RENDERER_REGISTRY.register(command, handler);
29
+ }
30
+ /** Register a batch of Markdown renderers in iteration order. */
31
+ export function registerMdRenderers(entries) {
32
+ MD_RENDERER_REGISTRY.registerAll(entries);
33
+ }
34
+ /** Look up a registered Markdown renderer, or `undefined` when unregistered. */
35
+ export function getMdRendererHandler(command) {
36
+ return MD_RENDERER_REGISTRY.get(command);
37
+ }
38
+ /** Remove a previously-registered Markdown renderer. Test-only utility. */
39
+ export function deregisterMdRenderer(command) {
40
+ MD_RENDERER_REGISTRY.deregister(command);
41
+ }
42
+ /** Register an HTML renderer for a command name. */
43
+ export function registerHtmlRenderer(command, handler) {
44
+ HTML_RENDERER_REGISTRY.register(command, handler);
45
+ }
46
+ /** Register a batch of HTML renderers in iteration order. */
47
+ export function registerHtmlRenderers(entries) {
48
+ HTML_RENDERER_REGISTRY.registerAll(entries);
49
+ }
50
+ /** Look up a registered HTML renderer, or `undefined` when unregistered. */
51
+ export function getHtmlRendererHandler(command) {
52
+ return HTML_RENDERER_REGISTRY.get(command);
53
+ }
54
+ /** Remove a previously-registered HTML renderer. Test-only utility. */
55
+ export function deregisterHtmlRenderer(command) {
56
+ HTML_RENDERER_REGISTRY.deregister(command);
57
+ }
@@ -13,12 +13,10 @@ import fs from "node:fs";
13
13
  import path from "node:path";
14
14
  import { listKeys as listVaultKeys } from "../commands/env/env.js";
15
15
  import { parseFrontmatter } from "../core/asset/frontmatter.js";
16
- import { extractFrontmatterOnly, extractLineRange, extractSection, formatToc, parseMarkdownToc, } from "../core/asset/markdown.js";
17
16
  import { asNonEmptyString, hasErrnoCode } from "../core/common.js";
18
- import { extractCommentMetadata, extractDescriptionFromComments } from "../indexer/passes/metadata.js";
19
- import { registerMetadataContributor } from "../indexer/passes/metadata-contributors.js";
17
+ import { extractCommentMetadata } from "../indexer/passes/metadata.js";
20
18
  import { registerRenderer } from "../indexer/walk/file-context.js";
21
- import { buildWorkflowAction, workflowMdRenderer, workflowProgramRenderer } from "../workflows/renderer.js";
19
+ import { buildWorkflowAction, workflowMdRenderer } from "../workflows/renderer.js";
22
20
  // ── Interpreter auto-detection map ───────────────────────────────────────────
23
21
  const INTERPRETER_MAP = {
24
22
  ".sh": "bash",
@@ -219,60 +217,20 @@ const agentMdRenderer = {
219
217
  };
220
218
  },
221
219
  };
222
- // ── 4. knowledge-md / wiki-md shared helper ───────────────────────────────────
223
- const KNOWLEDGE_ACTION = "Reference material - read the content below. Use 'toc' view for large documents.";
224
- const WIKI_PAGE_ACTION = "Wiki page — read below. Use 'toc' to scan, 'section <heading>' for depth.";
225
- /**
226
- * Shared implementation for knowledge-md and wiki-md `buildShowResponse`.
227
- *
228
- * Both renderers handle the same set of view modes (toc, frontmatter, section,
229
- * lines, full). The only differences are the `type` discriminant and the
230
- * section-not-found message. Extracting this helper eliminates ~90 lines of
231
- * byte-for-byte duplication.
232
- */
233
- function buildMarkdownViewResponse(ctx, type, action) {
234
- const name = deriveName(ctx);
235
- const v = ctx.matchResult.meta?.view ?? { mode: "full" };
236
- const content = ctx.content();
237
- switch (v.mode) {
238
- case "toc": {
239
- const toc = parseMarkdownToc(content);
240
- return { type, name, path: ctx.absPath, action, content: formatToc(toc) };
241
- }
242
- case "frontmatter": {
243
- const fm = extractFrontmatterOnly(content);
244
- return { type, name, path: ctx.absPath, action, content: fm ?? "(no frontmatter)" };
245
- }
246
- case "section": {
247
- const section = extractSection(content, v.heading);
248
- if (!section) {
249
- const notFoundMsg = type === "wiki"
250
- ? `Section "${v.heading}" not found in ${name}. Try \`akm show wiki:${name} toc\` to discover available headings.`
251
- : `Section "${v.heading}" not found in ${name}. Try \`akm show <ref> toc\` to discover available headings.`;
252
- return { type, name, path: ctx.absPath, action, content: notFoundMsg };
253
- }
254
- return { type, name, path: ctx.absPath, action, content: section.content };
255
- }
256
- case "lines": {
257
- return { type, name, path: ctx.absPath, action, content: extractLineRange(content, v.start, v.end) };
258
- }
259
- default: {
260
- return { type, name, path: ctx.absPath, action, content };
261
- }
262
- }
263
- }
264
220
  // ── 4. knowledge-md ──────────────────────────────────────────────────────────
221
+ const KNOWLEDGE_ACTION = "Reference material - read the content below. For a large document, read one section with `akm show <ref>#fragment` " +
222
+ "(an unmatched #fragment lists the available slugs).";
265
223
  const knowledgeMdRenderer = {
266
224
  name: "knowledge-md",
267
225
  buildShowResponse(ctx) {
268
- return buildMarkdownViewResponse(ctx, "knowledge", KNOWLEDGE_ACTION);
269
- },
270
- };
271
- // ── 4b. wiki-md ──────────────────────────────────────────────────────────────
272
- const wikiMdRenderer = {
273
- name: "wiki-md",
274
- buildShowResponse(ctx) {
275
- return buildMarkdownViewResponse(ctx, "wiki", WIKI_PAGE_ACTION);
226
+ const instruction = ctx.matchResult.type === "instruction";
227
+ return {
228
+ type: instruction ? "instruction" : "knowledge",
229
+ name: deriveName(ctx),
230
+ path: ctx.absPath,
231
+ action: instruction ? "Project instructions — read and follow the content below." : KNOWLEDGE_ACTION,
232
+ content: ctx.content(),
233
+ };
276
234
  },
277
235
  };
278
236
  // ── 4c. lesson-md ────────────────────────────────────────────────────────────
@@ -405,12 +363,12 @@ const secretFileRenderer = {
405
363
  type: "secret",
406
364
  name,
407
365
  path: ctx.absPath,
408
- action: "Secret — name only; the file contents are the value and are never written to akm's stdout. Use `akm secret path <ref>` for the file path, or `akm secret run <ref> <VAR> -- <command>` to run with the value injected into $VAR.",
366
+ action: "Secret — name only; the file contents are the value and are never written to akm's stdout. Use `akm secret run <ref> <VAR> -- <command>` to run with the value injected into $VAR.",
409
367
  };
410
368
  },
411
369
  };
412
370
  // ── 7. task-md ───────────────────────────────────────────────────────────────
413
- const TASK_PAGE_ACTION = "Scheduled task — `akm tasks show <id>` for parsed details, `akm tasks run <id>` to invoke now.";
371
+ const TASK_PAGE_ACTION = "Scheduled task — `akm show tasks/<id>` for parsed details, `akm task run <id>` to invoke now.";
414
372
  const taskMdRenderer = {
415
373
  name: "task-yaml",
416
374
  buildShowResponse(ctx) {
@@ -508,228 +466,6 @@ const factMdRenderer = {
508
466
  };
509
467
  },
510
468
  };
511
- function applySessionMetadata(entry, ctx) {
512
- try {
513
- const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
514
- entry.tags = Array.from(new Set([...(entry.tags ?? []), "session"]));
515
- const hints = new Set(entry.searchHints ?? []);
516
- const harness = asNonEmptyString(fm.harness);
517
- if (harness)
518
- hints.add(`harness:${harness}`);
519
- const project = asNonEmptyString(fm.project);
520
- if (project)
521
- hints.add(`project:${project}`);
522
- // log_path is the durable correlation key — keep it discoverable as a hint
523
- // so it survives in the index even when the body is re-derived.
524
- const logPath = asNonEmptyString(fm.log_path);
525
- if (logPath)
526
- hints.add(`log_path:${logPath}`);
527
- if (hints.size > 0)
528
- entry.searchHints = Array.from(hints).filter(Boolean);
529
- }
530
- catch {
531
- // Non-fatal: skip metadata extraction on parse error
532
- }
533
- }
534
- function applyTocMetadata(entry, ctx) {
535
- try {
536
- const toc = parseMarkdownToc(ctx.content());
537
- if (toc.headings.length > 0)
538
- entry.toc = toc.headings;
539
- }
540
- catch {
541
- // Non-fatal: skip TOC if file can't be read
542
- }
543
- }
544
- /**
545
- * Fact metadata: surface `category` and the `pinned` core marker as tags +
546
- * search hints (no dedicated DB columns — same encoding pattern as session /
547
- * task). `pinned` is mirrored to both a `pinned` tag and a `pinned` search
548
- * hint so the ranking contributor can detect it and queries can target it.
549
- */
550
- function applyFactMetadata(entry, ctx) {
551
- try {
552
- const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
553
- const tags = new Set([...(entry.tags ?? []), "fact"]);
554
- const hints = new Set(entry.searchHints ?? []);
555
- const category = asNonEmptyString(fm.category);
556
- if (category) {
557
- tags.add(category);
558
- hints.add(`category:${category}`);
559
- }
560
- if (fm.pinned === true) {
561
- tags.add("pinned");
562
- hints.add("pinned");
563
- }
564
- entry.tags = Array.from(tags).filter(Boolean);
565
- if (hints.size > 0)
566
- entry.searchHints = Array.from(hints).filter(Boolean);
567
- }
568
- catch {
569
- // Non-fatal: skip metadata extraction on parse error
570
- }
571
- }
572
- /**
573
- * Parse frontmatter, apply description (if not already set) and merge tags
574
- * into `entry`. Returns the raw frontmatter data object so callers can access
575
- * type-specific fields without re-parsing.
576
- */
577
- function applyFrontmatterDescriptionAndTags(entry, ctx) {
578
- const parsed = parseFrontmatter(ctx.content());
579
- const fm = parsed.data;
580
- const desc = asNonEmptyString(fm.description);
581
- if (desc && !entry.description) {
582
- entry.description = desc;
583
- entry.source = "frontmatter";
584
- entry.confidence = 0.9;
585
- }
586
- if (Array.isArray(fm.tags) && fm.tags.length > 0) {
587
- const fmTags = fm.tags.filter((t) => typeof t === "string" && t.trim().length > 0);
588
- if (fmTags.length > 0) {
589
- entry.tags = Array.from(new Set([...(entry.tags ?? []), ...fmTags]));
590
- }
591
- }
592
- return fm;
593
- }
594
- function applyLessonMetadata(entry, ctx) {
595
- try {
596
- const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
597
- const whenToUse = asNonEmptyString(fm.when_to_use);
598
- if (whenToUse) {
599
- const hints = new Set(entry.searchHints ?? []);
600
- hints.add(`when_to_use:${whenToUse}`);
601
- entry.searchHints = Array.from(hints).filter(Boolean);
602
- }
603
- }
604
- catch {
605
- // Non-fatal: skip metadata extraction on parse error
606
- }
607
- }
608
- function applyMemoryMetadata(entry, ctx) {
609
- try {
610
- const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
611
- const hints = new Set(entry.searchHints ?? []);
612
- const source = asNonEmptyString(fm.source);
613
- if (source)
614
- hints.add(source);
615
- const fmObservedAt = asNonEmptyString(fm.observed_at);
616
- if (fmObservedAt) {
617
- hints.add(`observed_at:${fmObservedAt}`);
618
- }
619
- else {
620
- try {
621
- const isoDate = ctx.stat().mtime.toISOString().slice(0, 10);
622
- hints.add(`observed_at:${isoDate}`);
623
- }
624
- catch {
625
- // Non-fatal: skip mtime fallback on stat error
626
- }
627
- }
628
- const expires = asNonEmptyString(fm.expires);
629
- if (expires)
630
- hints.add(`expires:${expires}`);
631
- if (fm.subjective === true)
632
- hints.add("subjective");
633
- if (hints.size > 0) {
634
- entry.searchHints = Array.from(hints).filter(Boolean);
635
- }
636
- }
637
- catch {
638
- // Non-fatal: skip metadata extraction on error
639
- }
640
- }
641
- function applyScriptMetadata(entry, ctx) {
642
- if (ctx.ext === ".md")
643
- return;
644
- const commentDesc = extractDescriptionFromComments(ctx.absPath);
645
- if (commentDesc && !entry.description) {
646
- entry.description = commentDesc;
647
- entry.source = "comments";
648
- entry.confidence = 0.7;
649
- }
650
- }
651
- function applyEnvMetadata(entry, ctx) {
652
- // Key names only — comment text must never reach description/search_text
653
- // (comments routinely contain commented-out credentials).
654
- const { keys } = listVaultKeys(ctx.absPath);
655
- if (keys.length > 0) {
656
- entry.searchHints = keys;
657
- }
658
- entry.tags = Array.from(new Set([...(entry.tags ?? []), "env", "secrets"]));
659
- }
660
- /**
661
- * Secret metadata: tags only. Must NEVER read the file body — the whole file
662
- * is the value, so the entry is built from the filename alone (name-only).
663
- */
664
- function applySecretMetadata(entry, _ctx) {
665
- entry.tags = Array.from(new Set([...(entry.tags ?? []), "secret", "sensitive"]));
666
- }
667
- function applyTaskMetadata(entry, ctx) {
668
- try {
669
- const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
670
- entry.tags = Array.from(new Set([...(entry.tags ?? []), "task", "scheduled"]));
671
- const hints = new Set(entry.searchHints ?? []);
672
- const schedule = asNonEmptyString(fm.schedule);
673
- if (schedule)
674
- hints.add(`schedule:${schedule}`);
675
- const workflow = asNonEmptyString(fm.workflow);
676
- if (workflow)
677
- hints.add(`workflow:${workflow}`);
678
- const prompt = asNonEmptyString(fm.prompt);
679
- if (prompt)
680
- hints.add(`prompt:${prompt}`);
681
- if (hints.size > 0)
682
- entry.searchHints = Array.from(hints).filter(Boolean);
683
- }
684
- catch {
685
- // Non-fatal: skip metadata extraction on error
686
- }
687
- }
688
- registerMetadataContributor({
689
- name: "toc-metadata",
690
- appliesTo: ({ rendererName }) => rendererName === "knowledge-md" || rendererName === "wiki-md",
691
- contribute: (entry, ctx) => applyTocMetadata(entry, ctx.renderContext),
692
- });
693
- registerMetadataContributor({
694
- name: "lesson-frontmatter-metadata",
695
- appliesTo: ({ rendererName }) => rendererName === "lesson-md",
696
- contribute: (entry, ctx) => applyLessonMetadata(entry, ctx.renderContext),
697
- });
698
- registerMetadataContributor({
699
- name: "memory-frontmatter-metadata",
700
- appliesTo: ({ rendererName }) => rendererName === "memory-md",
701
- contribute: (entry, ctx) => applyMemoryMetadata(entry, ctx.renderContext),
702
- });
703
- registerMetadataContributor({
704
- name: "script-comment-metadata",
705
- appliesTo: ({ rendererName }) => rendererName === "script-source",
706
- contribute: (entry, ctx) => applyScriptMetadata(entry, ctx.renderContext),
707
- });
708
- registerMetadataContributor({
709
- name: "env-file-metadata",
710
- appliesTo: ({ rendererName }) => rendererName === "env-file",
711
- contribute: (entry, ctx) => applyEnvMetadata(entry, ctx.renderContext),
712
- });
713
- registerMetadataContributor({
714
- name: "secret-file-metadata",
715
- appliesTo: ({ rendererName }) => rendererName === "secret-file",
716
- contribute: (entry, ctx) => applySecretMetadata(entry, ctx.renderContext),
717
- });
718
- registerMetadataContributor({
719
- name: "task-yaml-metadata",
720
- appliesTo: ({ rendererName }) => rendererName === "task-yaml",
721
- contribute: (entry, ctx) => applyTaskMetadata(entry, ctx.renderContext),
722
- });
723
- registerMetadataContributor({
724
- name: "session-md-metadata",
725
- appliesTo: ({ rendererName }) => rendererName === "session-md",
726
- contribute: (entry, ctx) => applySessionMetadata(entry, ctx.renderContext),
727
- });
728
- registerMetadataContributor({
729
- name: "fact-md-metadata",
730
- appliesTo: ({ rendererName }) => rendererName === "fact-md",
731
- contribute: (entry, ctx) => applyFactMetadata(entry, ctx.renderContext),
732
- });
733
469
  // ── Registration ─────────────────────────────────────────────────────────────
734
470
  /** All built-in renderers. */
735
471
  const builtinRenderers = [
@@ -737,11 +473,9 @@ const builtinRenderers = [
737
473
  commandMdRenderer,
738
474
  agentMdRenderer,
739
475
  knowledgeMdRenderer,
740
- wikiMdRenderer,
741
476
  lessonMdRenderer,
742
477
  memoryMdRenderer,
743
478
  workflowMdRenderer,
744
- workflowProgramRenderer,
745
479
  scriptSourceRenderer,
746
480
  envFileRenderer,
747
481
  secretFileRenderer,
@@ -759,4 +493,4 @@ export function registerBuiltinRenderers() {
759
493
  }
760
494
  }
761
495
  // ── Named exports for testing ────────────────────────────────────────────────
762
- export { agentMdRenderer, commandMdRenderer, envFileRenderer, factMdRenderer, INTERPRETER_MAP, knowledgeMdRenderer, lessonMdRenderer, memoryMdRenderer, SETUP_SIGNALS, scriptSourceRenderer, secretFileRenderer, skillMdRenderer, wikiMdRenderer, workflowMdRenderer, workflowProgramRenderer, };
496
+ export { agentMdRenderer, commandMdRenderer, envFileRenderer, factMdRenderer, INTERPRETER_MAP, knowledgeMdRenderer, lessonMdRenderer, memoryMdRenderer, SETUP_SIGNALS, scriptSourceRenderer, secretFileRenderer, skillMdRenderer, workflowMdRenderer, };
@@ -11,6 +11,9 @@ const NORMAL_FIELDS = [
11
11
  "type",
12
12
  "name",
13
13
  "ref",
14
+ "path",
15
+ "editable",
16
+ "editHint",
14
17
  "id",
15
18
  "description",
16
19
  "preview",
@@ -28,6 +31,9 @@ const AGENT_FIELDS = [
28
31
  "type",
29
32
  "name",
30
33
  "ref",
34
+ "path",
35
+ "editable",
36
+ "editHint",
31
37
  "id",
32
38
  "description",
33
39
  "supportRefs",
@@ -37,7 +43,10 @@ const AGENT_FIELDS = [
37
43
  ];
38
44
  function shapeCurateItem(item, detail, shape) {
39
45
  if (shape === "agent") {
40
- return capDescription(pickFields(item, AGENT_FIELDS), NORMAL_DESCRIPTION_LIMIT);
46
+ const shaped = pickFields(item, AGENT_FIELDS);
47
+ if (shaped.editable !== false)
48
+ delete shaped.editHint;
49
+ return capDescription(shaped, NORMAL_DESCRIPTION_LIMIT);
41
50
  }
42
51
  if (detail === "brief") {
43
52
  return pickFields(item, BRIEF_FIELDS);
@@ -1,12 +1,17 @@
1
1
  // This Source Code Form is subject to the terms of the Mozilla Public
2
2
  // License, v. 2.0. If a copy of the MPL was not distributed with this
3
3
  // file, You can obtain one at https://mozilla.org/MPL/2.0/.
4
- // Output shape registration for `akm events list` and `akm events tail` (#204).
5
- // Both share the same envelope; the renderer in text.ts uses distinct command
6
- // names so it can format streaming differently.
4
+ // Output shape registration for `akm log` (#204).
5
+ //
6
+ // R-060: renamed from `events-list` (the command group used to be `akm
7
+ // events`) to `log-list`, matching the current `akm log` command name
8
+ // (src/commands/observability-cli.ts). This string is an internal registry
9
+ // key only — `shapeEventsOutput` builds its own envelope and never stamps a
10
+ // `shape` field on the wire, so the rename does not require a schemaVersion
11
+ // bump.
12
+ //
13
+ // 0.9.0 CLI overhaul (S3): `log tail` (and its `log-tail` shape entry) was
14
+ // dropped along with the command.
7
15
  import { shapeEventsOutput } from "./helpers.js";
8
16
  const handler = (result, detail) => shapeEventsOutput(result, detail);
9
- export const eventsShapes = [
10
- { command: "events-list", handler },
11
- { command: "events-tail", handler },
12
- ];
17
+ export const eventsShapes = [{ command: "log-list", handler }];