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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (257) hide show
  1. package/CHANGELOG.md +249 -9
  2. package/SECURITY.md +23 -24
  3. package/dist/assets/help/help-improve.md +10 -10
  4. package/dist/assets/hints/cli-hints-full.md +44 -10
  5. package/dist/assets/hints/cli-hints-short.md +6 -2
  6. package/dist/assets/{profiles → improve-strategies}/catchup.json +3 -1
  7. package/dist/assets/{profiles → improve-strategies}/consolidate.json +3 -1
  8. package/dist/assets/{profiles → improve-strategies}/default.json +1 -0
  9. package/dist/assets/{profiles → improve-strategies}/frequent.json +3 -1
  10. package/dist/assets/{profiles → improve-strategies}/graph-refresh.json +4 -2
  11. package/dist/assets/{profiles → improve-strategies}/memory-focus.json +4 -1
  12. package/dist/assets/{profiles → improve-strategies}/proactive-maintenance.json +3 -3
  13. package/dist/assets/{profiles → improve-strategies}/quick.json +3 -1
  14. package/dist/assets/{profiles → improve-strategies}/recombine-only.json +2 -0
  15. package/dist/assets/{profiles → improve-strategies}/reflect-distill.json +4 -4
  16. package/dist/assets/{profiles → improve-strategies}/synthesize.json +2 -0
  17. package/dist/assets/stash-skeleton/README.md +28 -0
  18. package/dist/assets/stash-skeleton/facts/conventions/assets/agent.md +6 -0
  19. package/dist/assets/stash-skeleton/facts/conventions/assets/command.md +6 -0
  20. package/dist/assets/stash-skeleton/facts/conventions/assets/fact.md +12 -1
  21. package/dist/assets/stash-skeleton/facts/conventions/assets/knowledge.md +11 -1
  22. package/dist/assets/stash-skeleton/facts/conventions/assets/lesson.md +6 -0
  23. package/dist/assets/stash-skeleton/facts/conventions/assets/memory.md +9 -0
  24. package/dist/assets/stash-skeleton/facts/conventions/assets/script.md +7 -0
  25. package/dist/assets/stash-skeleton/facts/conventions/assets/skill.md +7 -0
  26. package/dist/assets/stash-skeleton/facts/conventions/assets/workflow.md +6 -0
  27. package/dist/assets/stash-skeleton/facts/conventions/backlinks.md +98 -0
  28. package/dist/assets/stash-skeleton/facts/conventions/domains.md +63 -0
  29. package/dist/assets/stash-skeleton/facts/conventions/organization.md +127 -0
  30. package/dist/assets/tasks/core/backup.yml +3 -2
  31. package/dist/assets/tasks/core/extract.yml +1 -0
  32. package/dist/assets/tasks/core/improve.yml +1 -0
  33. package/dist/assets/tasks/core/index-refresh.yml +1 -0
  34. package/dist/assets/tasks/core/sync.yml +1 -0
  35. package/dist/assets/tasks/core/version-check.yml +1 -0
  36. package/dist/assets/tasks/graph-refresh-weekly.yml +4 -4
  37. package/dist/assets/templates/html/health.html +5 -1
  38. package/dist/cli/config-migrate.js +547 -126
  39. package/dist/cli/config-validate.js +10 -8
  40. package/dist/cli.js +50 -14
  41. package/dist/commands/agent/agent-dispatch.js +17 -16
  42. package/dist/commands/agent/agent-support.js +0 -24
  43. package/dist/commands/agent/contribute-cli.js +5 -15
  44. package/dist/commands/backup-cli.js +56 -0
  45. package/dist/commands/config-cli.js +48 -155
  46. package/dist/commands/env/secret.js +8 -5
  47. package/dist/commands/feedback-cli.js +24 -7
  48. package/dist/commands/health/checks.js +200 -74
  49. package/dist/commands/health/html-report.js +4 -0
  50. package/dist/commands/health/improve-metrics.js +30 -32
  51. package/dist/commands/health/llm-usage.js +19 -19
  52. package/dist/commands/health/md-report.js +4 -0
  53. package/dist/commands/health/metrics.js +2 -1
  54. package/dist/commands/health/surfaces.js +7 -5
  55. package/dist/commands/health.js +1 -1
  56. package/dist/commands/improve/anti-collapse.js +3 -3
  57. package/dist/commands/improve/collapse-detector.js +5 -5
  58. package/dist/commands/improve/consolidate/chunking.js +2 -2
  59. package/dist/commands/improve/consolidate.js +148 -88
  60. package/dist/commands/improve/distill/promote-memory.js +13 -18
  61. package/dist/commands/improve/distill/quality-gate.js +6 -8
  62. package/dist/commands/improve/distill-guards.js +1 -1
  63. package/dist/commands/improve/distill-promotion-policy.js +32 -26
  64. package/dist/commands/improve/distill.js +68 -41
  65. package/dist/commands/improve/eligibility.js +31 -20
  66. package/dist/commands/improve/extract-cli.js +47 -19
  67. package/dist/commands/improve/extract-prompt.js +2 -2
  68. package/dist/commands/improve/extract.js +153 -73
  69. package/dist/commands/improve/improve-auto-accept.js +14 -28
  70. package/dist/commands/improve/improve-cli.js +41 -17
  71. package/dist/commands/improve/improve-result-file.js +30 -24
  72. package/dist/commands/improve/improve-strategies.js +138 -0
  73. package/dist/commands/improve/improve.js +109 -38
  74. package/dist/commands/improve/locks.js +66 -45
  75. package/dist/commands/improve/loop-stages.js +86 -39
  76. package/dist/commands/improve/memory/memory-belief.js +79 -7
  77. package/dist/commands/improve/memory/memory-contradiction-detect.js +12 -4
  78. package/dist/commands/improve/preparation.js +122 -90
  79. package/dist/commands/improve/procedural.js +13 -8
  80. package/dist/commands/improve/recombine.js +33 -8
  81. package/dist/commands/improve/reflect.js +143 -228
  82. package/dist/commands/improve/salience.js +5 -1
  83. package/dist/commands/improve/shared.js +11 -5
  84. package/dist/commands/improve/source-identity.js +43 -0
  85. package/dist/commands/lint/base-linter.js +152 -42
  86. package/dist/commands/migrate-cli.js +36 -0
  87. package/dist/commands/mv-cli.js +1198 -0
  88. package/dist/commands/proposal/drain.js +16 -4
  89. package/dist/commands/proposal/proposal-cli.js +21 -10
  90. package/dist/commands/proposal/proposal.js +16 -55
  91. package/dist/commands/proposal/propose.js +64 -69
  92. package/dist/commands/proposal/repository.js +664 -58
  93. package/dist/commands/read/curate.js +4 -2
  94. package/dist/commands/read/knowledge.js +440 -5
  95. package/dist/commands/read/remember-cli.js +39 -2
  96. package/dist/commands/read/search-cli.js +6 -1
  97. package/dist/commands/read/search.js +6 -2
  98. package/dist/commands/read/show.js +8 -7
  99. package/dist/commands/registry-cli.js +29 -14
  100. package/dist/commands/remember.js +2 -0
  101. package/dist/commands/sources/init.js +13 -14
  102. package/dist/commands/sources/schema-repair.js +2 -4
  103. package/dist/commands/sources/self-update.js +156 -112
  104. package/dist/commands/sources/source-add.js +62 -73
  105. package/dist/commands/sources/source-manage.js +50 -46
  106. package/dist/commands/sources/sources-cli.js +7 -2
  107. package/dist/commands/sources/stash-cli.js +41 -4
  108. package/dist/commands/tasks/default-tasks.js +12 -12
  109. package/dist/commands/tasks/tasks-cli.js +7 -3
  110. package/dist/commands/tasks/tasks.js +113 -18
  111. package/dist/commands/wiki-cli.js +9 -10
  112. package/dist/core/asset/frontmatter.js +12 -2
  113. package/dist/core/common.js +41 -6
  114. package/dist/core/config/config-io.js +30 -19
  115. package/dist/core/config/config-schema.js +373 -69
  116. package/dist/core/config/config-types.js +3 -3
  117. package/dist/core/config/config-version.js +29 -0
  118. package/dist/core/config/config-walker.js +98 -27
  119. package/dist/core/config/config.js +135 -268
  120. package/dist/core/config/deep-merge.js +41 -0
  121. package/dist/core/config/engine-semantics.js +32 -0
  122. package/dist/core/errors.js +2 -2
  123. package/dist/core/extra-params.js +61 -0
  124. package/dist/core/file-lock.js +202 -57
  125. package/dist/core/improve-result.js +178 -0
  126. package/dist/core/maintenance-barrier.js +119 -0
  127. package/dist/core/migration-backup.js +1061 -0
  128. package/dist/core/migration-operation.js +44 -0
  129. package/dist/core/paths.js +3 -0
  130. package/dist/core/redaction.js +358 -0
  131. package/dist/core/state/migrations.js +15 -3
  132. package/dist/core/state-db.js +60 -2
  133. package/dist/core/write-source.js +86 -18
  134. package/dist/indexer/db/db.js +212 -41
  135. package/dist/indexer/graph/graph-extraction.js +28 -16
  136. package/dist/indexer/index-writer-lock.js +59 -51
  137. package/dist/indexer/index-written-assets.js +75 -49
  138. package/dist/indexer/indexer.js +52 -3
  139. package/dist/indexer/passes/memory-inference.js +10 -6
  140. package/dist/indexer/passes/metadata.js +250 -0
  141. package/dist/indexer/search/db-search.js +111 -44
  142. package/dist/indexer/search/fts-query.js +41 -0
  143. package/dist/indexer/search/ranking-contributors.js +48 -0
  144. package/dist/indexer/search/ranking.js +36 -23
  145. package/dist/indexer/search/search-fields.js +11 -1
  146. package/dist/indexer/search/search-source.js +2 -2
  147. package/dist/indexer/usage/usage-events.js +8 -2
  148. package/dist/integrations/agent/builder-shared.js +7 -0
  149. package/dist/integrations/agent/builders.js +5 -52
  150. package/dist/integrations/agent/config.js +3 -143
  151. package/dist/integrations/agent/detect.js +17 -2
  152. package/dist/integrations/agent/engine-resolution.js +209 -0
  153. package/dist/integrations/agent/index.js +1 -2
  154. package/dist/integrations/agent/model-aliases.js +7 -2
  155. package/dist/integrations/agent/profiles.js +6 -99
  156. package/dist/integrations/agent/runner-dispatch.js +76 -13
  157. package/dist/integrations/agent/runner.js +76 -207
  158. package/dist/integrations/agent/spawn.js +4 -6
  159. package/dist/integrations/harnesses/aider/agent-builder.js +2 -3
  160. package/dist/integrations/harnesses/aider/index.js +0 -1
  161. package/dist/integrations/harnesses/amazonq/agent-builder.js +2 -3
  162. package/dist/integrations/harnesses/amazonq/index.js +0 -1
  163. package/dist/integrations/harnesses/claude/agent-builder.js +2 -3
  164. package/dist/integrations/harnesses/claude/index.js +0 -2
  165. package/dist/integrations/harnesses/codex/agent-builder.js +2 -3
  166. package/dist/integrations/harnesses/codex/index.js +0 -1
  167. package/dist/integrations/harnesses/copilot/agent-builder.js +2 -3
  168. package/dist/integrations/harnesses/copilot/index.js +0 -1
  169. package/dist/integrations/harnesses/gemini/agent-builder.js +2 -3
  170. package/dist/integrations/harnesses/gemini/index.js +0 -1
  171. package/dist/integrations/harnesses/index.js +1 -24
  172. package/dist/integrations/harnesses/opencode/agent-builder.js +2 -3
  173. package/dist/integrations/harnesses/opencode/index.js +0 -6
  174. package/dist/integrations/harnesses/opencode-sdk/harness.js +1 -6
  175. package/dist/integrations/harnesses/opencode-sdk/sdk-runner.js +274 -191
  176. package/dist/integrations/harnesses/openhands/agent-builder.js +2 -3
  177. package/dist/integrations/harnesses/openhands/index.js +0 -1
  178. package/dist/integrations/harnesses/pi/agent-builder.js +2 -3
  179. package/dist/integrations/harnesses/pi/index.js +0 -1
  180. package/dist/integrations/harnesses/types.js +1 -32
  181. package/dist/integrations/lockfile.js +32 -21
  182. package/dist/llm/client.js +48 -14
  183. package/dist/llm/feature-gate.js +15 -47
  184. package/dist/llm/graph-extract.js +1 -1
  185. package/dist/llm/index-passes.js +8 -42
  186. package/dist/llm/memory-infer-impl.js +1 -1
  187. package/dist/llm/usage-persist.js +4 -0
  188. package/dist/llm/usage-telemetry.js +35 -5
  189. package/dist/output/shapes/helpers.js +2 -1
  190. package/dist/output/shapes/passthrough.js +2 -0
  191. package/dist/output/text/helpers.js +3 -1
  192. package/dist/schemas/akm-config.json +11013 -8600
  193. package/dist/schemas/akm-task.json +87 -0
  194. package/dist/schemas/akm-workflow.json +57 -13
  195. package/dist/scripts/migrate-storage.js +8502 -543
  196. package/dist/scripts/migrations/import-fs-improve-runs-to-db.js +8493 -515
  197. package/dist/setup/detected-engines.js +136 -0
  198. package/dist/setup/engine-config.js +99 -0
  199. package/dist/setup/setup.js +237 -133
  200. package/dist/setup/steps/connection.js +62 -33
  201. package/dist/setup/steps/platforms.js +4 -4
  202. package/dist/setup/steps/tasks.js +1 -1
  203. package/dist/setup/steps.js +3 -2
  204. package/dist/sources/providers/git-stash.js +58 -21
  205. package/dist/sources/providers/git.js +1 -1
  206. package/dist/storage/database.js +13 -1
  207. package/dist/storage/engines/sqlite-migrations.js +139 -3
  208. package/dist/storage/repositories/events-repository.js +24 -0
  209. package/dist/storage/repositories/improve-runs-repository.js +5 -5
  210. package/dist/storage/repositories/proposals-repository.js +14 -0
  211. package/dist/storage/repositories/task-history-repository.js +78 -0
  212. package/dist/storage/repositories/workflow-runs-repository.js +9 -8
  213. package/dist/tasks/embedded.js +2 -0
  214. package/dist/tasks/parser.js +138 -52
  215. package/dist/tasks/runner.js +71 -75
  216. package/dist/tasks/schema.js +1 -1
  217. package/dist/tasks/validator.js +11 -6
  218. package/dist/wiki/wiki.js +9 -8
  219. package/dist/workflows/authoring/workflow-program-template.yaml +3 -3
  220. package/dist/workflows/concurrency-policy.js +15 -0
  221. package/dist/workflows/db.js +78 -15
  222. package/dist/workflows/exec/brief.js +18 -24
  223. package/dist/workflows/exec/frozen-judge.js +47 -0
  224. package/dist/workflows/exec/native-executor.js +124 -65
  225. package/dist/workflows/exec/report.js +93 -33
  226. package/dist/workflows/exec/run-workflow.js +38 -25
  227. package/dist/workflows/exec/scheduler.js +12 -41
  228. package/dist/workflows/exec/step-work.js +91 -35
  229. package/dist/workflows/ir/compile.js +13 -26
  230. package/dist/workflows/ir/freeze.js +243 -0
  231. package/dist/workflows/ir/plan-hash.js +40 -5
  232. package/dist/workflows/ir/schema.js +542 -1
  233. package/dist/workflows/parser.js +7 -0
  234. package/dist/workflows/program/parser.js +132 -23
  235. package/dist/workflows/program/project.js +3 -4
  236. package/dist/workflows/program/schema.js +2 -2
  237. package/dist/workflows/resource-limits.js +20 -0
  238. package/dist/workflows/runtime/plan-classifier.js +187 -0
  239. package/dist/workflows/runtime/runs.js +54 -47
  240. package/dist/workflows/runtime/workflow-asset-loader.js +0 -22
  241. package/dist/workflows/validator.js +49 -2
  242. package/docs/data-and-telemetry.md +2 -2
  243. package/docs/migration/release-notes/0.6.0.md +1 -1
  244. package/docs/migration/release-notes/0.7.0.md +5 -4
  245. package/docs/migration/release-notes/0.9.0.md +24 -7
  246. package/docs/migration/v0.8-to-v0.9.md +506 -0
  247. package/package.json +4 -2
  248. package/schemas/akm-config.json +16638 -0
  249. package/schemas/akm-task.json +87 -0
  250. package/schemas/akm-workflow.json +372 -0
  251. package/dist/commands/improve/improve-profiles.js +0 -168
  252. package/dist/core/config/config-migration.js +0 -602
  253. package/dist/core/deep-merge.js +0 -38
  254. package/dist/llm/call-ai.js +0 -62
  255. package/dist/setup/legacy-config.js +0 -106
  256. package/docs/README.md +0 -104
  257. /package/dist/assets/{profiles → improve-strategies}/thorough.json +0 -0
@@ -1,10 +1,10 @@
1
- id: graph-refresh-weekly
1
+ version: 2
2
2
  description: >
3
3
  Weekly full-corpus graph extraction pass. Rebuilds entity and relation
4
- indexes across all stash files using the graph-refresh improve profile.
4
+ indexes across all stash files using the graph-refresh improve strategy.
5
5
  Complements the per-run improve pipeline which only extracts graph data
6
6
  for files touched by actionable refs.
7
- command: akm improve --profile graph-refresh
7
+ command: akm improve --strategy graph-refresh
8
8
  schedule: "0 3 * * 0"
9
9
  enabled: false
10
- timeout: 3600000
10
+ timeoutMs: 3600000
@@ -391,7 +391,7 @@
391
391
  <div class="table-wrap">
392
392
  <table>
393
393
  <thead>
394
- <tr><th>Started</th><th>Task</th><th>Wall</th><th>Promoted</th><th>Merged</th><th>Contradicted</th><th>MI Written</th><th>Entities</th><th>Lint Fixed</th><th>Status</th></tr>
394
+ <tr><th>Started</th><th>Task</th><th>Strategy</th><th>Legacy Profile</th><th>Wall</th><th>Promoted</th><th>Merged</th><th>Contradicted</th><th>MI Written</th><th>Entities</th><th>Lint Fixed</th><th>Status</th></tr>
395
395
  </thead>
396
396
  <tbody id="lastRunsTable"></tbody>
397
397
  </table>
@@ -683,12 +683,16 @@ tbody.innerHTML = '';
683
683
  const ts = `${d.getFullYear()}-${pad(d.getMonth()+1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
684
684
  const dur = r.wallTimeMs ? (r.wallTimeMs / 60000).toFixed(1) + 'm' : '—';
685
685
  const task = r.taskId || 'manual';
686
+ const strategy = r.strategy || '—';
687
+ const legacyProfile = r.legacyProfile || '—';
686
688
  const badge = r.ok
687
689
  ? '<span class="badge-pill badge-pass" style="padding:2px 8px;font-size:11px;"><span class="dot dot-pass" style="width:6px;height:6px;"></span>&nbsp;ok</span>'
688
690
  : '<span class="badge-pill badge-fail" style="padding:2px 8px;font-size:11px;"><span class="dot dot-fail" style="width:6px;height:6px;"></span>&nbsp;failed</span>';
689
691
  tr.innerHTML = `
690
692
  <td style="font-family:monospace;font-size:12px;">${ts}</td>
691
693
  <td><code>${task}</code></td>
694
+ <td><code>${strategy}</code></td>
695
+ <td><code>${legacyProfile}</code></td>
692
696
  <td>${dur}</td>
693
697
  <td style="color:var(--accent);font-weight:600;">${r.promoted || 0}</td>
694
698
  <td>${r.merged || 0}</td>