akm-cli 0.7.0 → 0.7.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 (332) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/dist/{src/cli.js → cli.js} +22 -8
  3. package/dist/{src/commands → commands}/installed-stashes.js +1 -1
  4. package/dist/{src/commands → commands}/source-add.js +1 -1
  5. package/dist/{src/core → core}/common.js +16 -1
  6. package/dist/{src/core → core}/config.js +5 -2
  7. package/dist/{src/indexer → indexer}/db-search.js +16 -1
  8. package/dist/{src/indexer → indexer}/graph-extraction.js +5 -3
  9. package/dist/{src/indexer → indexer}/indexer.js +27 -11
  10. package/dist/{src/indexer → indexer}/memory-inference.js +47 -58
  11. package/dist/{src/indexer → indexer}/search-source.js +1 -1
  12. package/dist/{src/llm → llm}/client.js +61 -1
  13. package/dist/{src/llm → llm}/embedder.js +8 -5
  14. package/dist/{src/llm → llm}/embedders/local.js +8 -2
  15. package/dist/{src/llm → llm}/embedders/remote.js +4 -2
  16. package/dist/{src/llm → llm}/graph-extract.js +4 -4
  17. package/dist/llm/memory-infer.js +114 -0
  18. package/dist/{src/llm → llm}/metadata-enhance.js +2 -2
  19. package/dist/{src/output → output}/cli-hints.js +2 -0
  20. package/dist/{src/setup → setup}/setup.js +30 -20
  21. package/dist/sources/providers/website.js +27 -0
  22. package/dist/{src/sources/providers/website.js → sources/website-ingest.js} +38 -51
  23. package/docs/README.md +7 -0
  24. package/docs/migration/release-notes/0.7.0.md +14 -0
  25. package/package.json +11 -8
  26. package/dist/src/llm/memory-infer.js +0 -86
  27. package/dist/tests/add-website-source.test.js +0 -119
  28. package/dist/tests/agent/agent-config-loader.test.js +0 -70
  29. package/dist/tests/agent/agent-config.test.js +0 -221
  30. package/dist/tests/agent/agent-detect.test.js +0 -100
  31. package/dist/tests/agent/agent-spawn.test.js +0 -234
  32. package/dist/tests/agent-output.test.js +0 -186
  33. package/dist/tests/architecture/agent-no-llm-sdk-guard.test.js +0 -103
  34. package/dist/tests/architecture/agent-spawn-seam.test.js +0 -193
  35. package/dist/tests/architecture/llm-stateless-seam.test.js +0 -112
  36. package/dist/tests/asset-ref.test.js +0 -192
  37. package/dist/tests/asset-registry.test.js +0 -103
  38. package/dist/tests/asset-spec.test.js +0 -241
  39. package/dist/tests/bench/attribution.test.js +0 -996
  40. package/dist/tests/bench/cleanup-sigint.test.js +0 -83
  41. package/dist/tests/bench/cleanup.js +0 -234
  42. package/dist/tests/bench/cleanup.test.js +0 -166
  43. package/dist/tests/bench/cli.js +0 -1018
  44. package/dist/tests/bench/cli.test.js +0 -445
  45. package/dist/tests/bench/compare.test.js +0 -556
  46. package/dist/tests/bench/corpus.js +0 -317
  47. package/dist/tests/bench/corpus.test.js +0 -258
  48. package/dist/tests/bench/doctor.js +0 -525
  49. package/dist/tests/bench/driver.js +0 -401
  50. package/dist/tests/bench/driver.test.js +0 -584
  51. package/dist/tests/bench/environment.js +0 -233
  52. package/dist/tests/bench/environment.test.js +0 -199
  53. package/dist/tests/bench/evolve-metrics.js +0 -179
  54. package/dist/tests/bench/evolve-metrics.test.js +0 -187
  55. package/dist/tests/bench/evolve.js +0 -647
  56. package/dist/tests/bench/evolve.test.js +0 -624
  57. package/dist/tests/bench/failure-modes.test.js +0 -349
  58. package/dist/tests/bench/feedback-integrity.test.js +0 -457
  59. package/dist/tests/bench/leakage.test.js +0 -228
  60. package/dist/tests/bench/learning-curve.test.js +0 -134
  61. package/dist/tests/bench/metrics.js +0 -2395
  62. package/dist/tests/bench/metrics.test.js +0 -1150
  63. package/dist/tests/bench/no-os-tmpdir-invariant.test.js +0 -43
  64. package/dist/tests/bench/opencode-config.js +0 -194
  65. package/dist/tests/bench/opencode-config.test.js +0 -370
  66. package/dist/tests/bench/report.js +0 -1885
  67. package/dist/tests/bench/report.test.js +0 -1038
  68. package/dist/tests/bench/run-config.js +0 -355
  69. package/dist/tests/bench/run-config.test.js +0 -298
  70. package/dist/tests/bench/run-curate-test.js +0 -32
  71. package/dist/tests/bench/run-failing-tasks.js +0 -56
  72. package/dist/tests/bench/run-full-bench.js +0 -51
  73. package/dist/tests/bench/run-items36-targeted.js +0 -69
  74. package/dist/tests/bench/run-nano-quick.js +0 -42
  75. package/dist/tests/bench/run-waveg-targeted.js +0 -62
  76. package/dist/tests/bench/runner.js +0 -699
  77. package/dist/tests/bench/runner.test.js +0 -958
  78. package/dist/tests/bench/search-bridge.test.js +0 -331
  79. package/dist/tests/bench/tmp.js +0 -131
  80. package/dist/tests/bench/trajectory.js +0 -116
  81. package/dist/tests/bench/trajectory.test.js +0 -127
  82. package/dist/tests/bench/verifier.js +0 -114
  83. package/dist/tests/bench/verifier.test.js +0 -118
  84. package/dist/tests/bench/workflow-evaluator.js +0 -557
  85. package/dist/tests/bench/workflow-evaluator.test.js +0 -421
  86. package/dist/tests/bench/workflow-spec.js +0 -345
  87. package/dist/tests/bench/workflow-spec.test.js +0 -363
  88. package/dist/tests/bench/workflow-trace.js +0 -472
  89. package/dist/tests/bench/workflow-trace.test.js +0 -254
  90. package/dist/tests/benchmark-search-quality.js +0 -536
  91. package/dist/tests/benchmark-suite.js +0 -1441
  92. package/dist/tests/capture-cli.test.js +0 -112
  93. package/dist/tests/cli-errors.test.js +0 -204
  94. package/dist/tests/commands/events.test.js +0 -370
  95. package/dist/tests/commands/history.test.js +0 -418
  96. package/dist/tests/commands/import.test.js +0 -103
  97. package/dist/tests/commands/proposal-cli.test.js +0 -209
  98. package/dist/tests/commands/reflect-propose-cli.test.js +0 -333
  99. package/dist/tests/commands/remember.test.js +0 -97
  100. package/dist/tests/commands/scope-flags.test.js +0 -300
  101. package/dist/tests/commands/search.test.js +0 -537
  102. package/dist/tests/commands/show-indexer-parity.test.js +0 -117
  103. package/dist/tests/commands/show.test.js +0 -294
  104. package/dist/tests/common.test.js +0 -266
  105. package/dist/tests/completions.test.js +0 -142
  106. package/dist/tests/config-cli.test.js +0 -193
  107. package/dist/tests/config-llm-features.test.js +0 -139
  108. package/dist/tests/config.test.js +0 -569
  109. package/dist/tests/contracts/migration-baseline.test.js +0 -43
  110. package/dist/tests/contracts/reflect-propose-envelope.test.js +0 -139
  111. package/dist/tests/contracts/spec-helpers.js +0 -46
  112. package/dist/tests/contracts/v1-spec-section-11-proposal-queue.test.js +0 -228
  113. package/dist/tests/contracts/v1-spec-section-12-agent-config.test.js +0 -56
  114. package/dist/tests/contracts/v1-spec-section-13-lesson-type.test.js +0 -34
  115. package/dist/tests/contracts/v1-spec-section-14-llm-features.test.js +0 -94
  116. package/dist/tests/contracts/v1-spec-section-4-1-asset-types.test.js +0 -39
  117. package/dist/tests/contracts/v1-spec-section-4-2-quality-rules.test.js +0 -44
  118. package/dist/tests/contracts/v1-spec-section-5-configuration.test.js +0 -47
  119. package/dist/tests/contracts/v1-spec-section-6-orchestration.test.js +0 -40
  120. package/dist/tests/contracts/v1-spec-section-7-module-layout.test.js +0 -58
  121. package/dist/tests/contracts/v1-spec-section-8-extension-points.test.js +0 -34
  122. package/dist/tests/contracts/v1-spec-section-9-4-cli-surface.test.js +0 -75
  123. package/dist/tests/contracts/v1-spec-section-9-7-llm-agent-boundary.test.js +0 -36
  124. package/dist/tests/core/write-source.test.js +0 -366
  125. package/dist/tests/curate-command.test.js +0 -87
  126. package/dist/tests/db-scoring.test.js +0 -201
  127. package/dist/tests/db.test.js +0 -654
  128. package/dist/tests/distill-cli-flag.test.js +0 -208
  129. package/dist/tests/distill.test.js +0 -515
  130. package/dist/tests/docker-install.test.js +0 -120
  131. package/dist/tests/e2e.test.js +0 -1419
  132. package/dist/tests/embedder.test.js +0 -340
  133. package/dist/tests/embedding-model-config.test.js +0 -379
  134. package/dist/tests/feedback-command.test.js +0 -172
  135. package/dist/tests/file-context.test.js +0 -552
  136. package/dist/tests/fixtures/scripts/git/summarize-diff.js +0 -9
  137. package/dist/tests/fixtures/scripts/lint/eslint-check.js +0 -7
  138. package/dist/tests/fixtures/stashes/load.js +0 -166
  139. package/dist/tests/fixtures/stashes/load.test.js +0 -97
  140. package/dist/tests/fixtures/stashes/ranking-baseline/scripts/mem0-search.js +0 -12
  141. package/dist/tests/frontmatter.test.js +0 -190
  142. package/dist/tests/fts-field-weighting.test.js +0 -254
  143. package/dist/tests/fuzzy-search.test.js +0 -230
  144. package/dist/tests/git-provider-clone.test.js +0 -45
  145. package/dist/tests/github.test.js +0 -161
  146. package/dist/tests/graph-boost-ranking.test.js +0 -305
  147. package/dist/tests/graph-extraction.test.js +0 -282
  148. package/dist/tests/helpers/usage-events.js +0 -8
  149. package/dist/tests/index-pass-llm.test.js +0 -161
  150. package/dist/tests/indexer.test.js +0 -570
  151. package/dist/tests/info-command.test.js +0 -166
  152. package/dist/tests/init.test.js +0 -69
  153. package/dist/tests/install-script.test.js +0 -246
  154. package/dist/tests/integration/agent-real-profile.test.js +0 -94
  155. package/dist/tests/issue-36-repro.test.js +0 -304
  156. package/dist/tests/issues-191-194.test.js +0 -160
  157. package/dist/tests/lesson-lint.test.js +0 -111
  158. package/dist/tests/llm-client.test.js +0 -115
  159. package/dist/tests/llm-feature-gate.test.js +0 -151
  160. package/dist/tests/llm.test.js +0 -139
  161. package/dist/tests/lockfile.test.js +0 -216
  162. package/dist/tests/manifest.test.js +0 -205
  163. package/dist/tests/markdown.test.js +0 -126
  164. package/dist/tests/matchers-unit.test.js +0 -189
  165. package/dist/tests/memory-inference.test.js +0 -299
  166. package/dist/tests/merge-scoring.test.js +0 -136
  167. package/dist/tests/metadata.test.js +0 -313
  168. package/dist/tests/migration-help.test.js +0 -89
  169. package/dist/tests/origin-resolve.test.js +0 -124
  170. package/dist/tests/output-baseline.test.js +0 -218
  171. package/dist/tests/output-shapes-unit.test.js +0 -478
  172. package/dist/tests/parallel-search.test.js +0 -272
  173. package/dist/tests/parameter-metadata.test.js +0 -365
  174. package/dist/tests/paths.test.js +0 -177
  175. package/dist/tests/progressive-disclosure.test.js +0 -280
  176. package/dist/tests/proposals.test.js +0 -279
  177. package/dist/tests/proposed-quality.test.js +0 -271
  178. package/dist/tests/provider-registry.test.js +0 -32
  179. package/dist/tests/ranking-regression.test.js +0 -548
  180. package/dist/tests/reflect-propose.test.js +0 -455
  181. package/dist/tests/registry-build-index.test.js +0 -394
  182. package/dist/tests/registry-cli.test.js +0 -290
  183. package/dist/tests/registry-index-v2.test.js +0 -430
  184. package/dist/tests/registry-install.test.js +0 -728
  185. package/dist/tests/registry-providers/parity.test.js +0 -189
  186. package/dist/tests/registry-providers/skills-sh.test.js +0 -309
  187. package/dist/tests/registry-providers/static-index.test.js +0 -238
  188. package/dist/tests/registry-resolve.test.js +0 -126
  189. package/dist/tests/registry-search.test.js +0 -923
  190. package/dist/tests/remember-frontmatter.test.js +0 -378
  191. package/dist/tests/remember-unit.test.js +0 -123
  192. package/dist/tests/ripgrep-install.test.js +0 -251
  193. package/dist/tests/ripgrep-resolve.test.js +0 -108
  194. package/dist/tests/ripgrep.test.js +0 -163
  195. package/dist/tests/save-command.test.js +0 -94
  196. package/dist/tests/save-trust-qa-fixes.test.js +0 -270
  197. package/dist/tests/scoring-pipeline.test.js +0 -648
  198. package/dist/tests/search-include-proposed-cli.test.js +0 -118
  199. package/dist/tests/self-update.test.js +0 -442
  200. package/dist/tests/semantic-search-e2e.test.js +0 -512
  201. package/dist/tests/semantic-status.test.js +0 -471
  202. package/dist/tests/setup-run.integration.js +0 -877
  203. package/dist/tests/setup-wizard.test.js +0 -198
  204. package/dist/tests/setup.test.js +0 -131
  205. package/dist/tests/source-add.test.js +0 -11
  206. package/dist/tests/source-clone.test.js +0 -254
  207. package/dist/tests/source-manage.test.js +0 -366
  208. package/dist/tests/source-providers/filesystem.test.js +0 -82
  209. package/dist/tests/source-providers/git.test.js +0 -252
  210. package/dist/tests/source-providers/website.test.js +0 -128
  211. package/dist/tests/source-qa-fixes.test.js +0 -286
  212. package/dist/tests/source-registry.test.js +0 -350
  213. package/dist/tests/source-resolve.test.js +0 -100
  214. package/dist/tests/source-source.test.js +0 -281
  215. package/dist/tests/source.test.js +0 -533
  216. package/dist/tests/tar-utils-scan.test.js +0 -73
  217. package/dist/tests/toggle-components.test.js +0 -73
  218. package/dist/tests/usage-telemetry.test.js +0 -265
  219. package/dist/tests/utility-scoring.test.js +0 -558
  220. package/dist/tests/vault-load-error.test.js +0 -78
  221. package/dist/tests/vault-qa-fixes.test.js +0 -194
  222. package/dist/tests/vault.test.js +0 -429
  223. package/dist/tests/vector-search.test.js +0 -608
  224. package/dist/tests/walker.test.js +0 -252
  225. package/dist/tests/wave2-cluster-bc.test.js +0 -228
  226. package/dist/tests/wave2-cluster-d.test.js +0 -180
  227. package/dist/tests/wave2-cluster-e.test.js +0 -179
  228. package/dist/tests/wiki-qa-fixes.test.js +0 -270
  229. package/dist/tests/wiki.test.js +0 -529
  230. package/dist/tests/workflow-cli.test.js +0 -271
  231. package/dist/tests/workflow-markdown.test.js +0 -171
  232. package/dist/tests/workflow-path-escape.test.js +0 -132
  233. package/dist/tests/workflow-qa-fixes.test.js +0 -395
  234. package/dist/tests/workflows/indexer-rejection.test.js +0 -213
  235. /package/dist/{src/commands → commands}/completions.js +0 -0
  236. /package/dist/{src/commands → commands}/config-cli.js +0 -0
  237. /package/dist/{src/commands → commands}/curate.js +0 -0
  238. /package/dist/{src/commands → commands}/distill.js +0 -0
  239. /package/dist/{src/commands → commands}/events.js +0 -0
  240. /package/dist/{src/commands → commands}/history.js +0 -0
  241. /package/dist/{src/commands → commands}/info.js +0 -0
  242. /package/dist/{src/commands → commands}/init.js +0 -0
  243. /package/dist/{src/commands → commands}/install-audit.js +0 -0
  244. /package/dist/{src/commands → commands}/migration-help.js +0 -0
  245. /package/dist/{src/commands → commands}/proposal.js +0 -0
  246. /package/dist/{src/commands → commands}/propose.js +0 -0
  247. /package/dist/{src/commands → commands}/reflect.js +0 -0
  248. /package/dist/{src/commands → commands}/registry-search.js +0 -0
  249. /package/dist/{src/commands → commands}/remember.js +0 -0
  250. /package/dist/{src/commands → commands}/search.js +0 -0
  251. /package/dist/{src/commands → commands}/self-update.js +0 -0
  252. /package/dist/{src/commands → commands}/show.js +0 -0
  253. /package/dist/{src/commands → commands}/source-clone.js +0 -0
  254. /package/dist/{src/commands → commands}/source-manage.js +0 -0
  255. /package/dist/{src/commands → commands}/vault.js +0 -0
  256. /package/dist/{src/core → core}/asset-ref.js +0 -0
  257. /package/dist/{src/core → core}/asset-registry.js +0 -0
  258. /package/dist/{src/core → core}/asset-spec.js +0 -0
  259. /package/dist/{src/core → core}/errors.js +0 -0
  260. /package/dist/{src/core → core}/events.js +0 -0
  261. /package/dist/{src/core → core}/frontmatter.js +0 -0
  262. /package/dist/{src/core → core}/lesson-lint.js +0 -0
  263. /package/dist/{src/core → core}/markdown.js +0 -0
  264. /package/dist/{src/core → core}/paths.js +0 -0
  265. /package/dist/{src/core → core}/proposals.js +0 -0
  266. /package/dist/{src/core → core}/warn.js +0 -0
  267. /package/dist/{src/core → core}/write-source.js +0 -0
  268. /package/dist/{src/indexer → indexer}/db.js +0 -0
  269. /package/dist/{src/indexer → indexer}/file-context.js +0 -0
  270. /package/dist/{src/indexer → indexer}/graph-boost.js +0 -0
  271. /package/dist/{src/indexer → indexer}/manifest.js +0 -0
  272. /package/dist/{src/indexer → indexer}/matchers.js +0 -0
  273. /package/dist/{src/indexer → indexer}/metadata.js +0 -0
  274. /package/dist/{src/indexer → indexer}/search-fields.js +0 -0
  275. /package/dist/{src/indexer → indexer}/semantic-status.js +0 -0
  276. /package/dist/{src/indexer → indexer}/usage-events.js +0 -0
  277. /package/dist/{src/indexer → indexer}/walker.js +0 -0
  278. /package/dist/{src/integrations → integrations}/agent/config.js +0 -0
  279. /package/dist/{src/integrations → integrations}/agent/detect.js +0 -0
  280. /package/dist/{src/integrations → integrations}/agent/index.js +0 -0
  281. /package/dist/{src/integrations → integrations}/agent/profiles.js +0 -0
  282. /package/dist/{src/integrations → integrations}/agent/prompts.js +0 -0
  283. /package/dist/{src/integrations → integrations}/agent/spawn.js +0 -0
  284. /package/dist/{src/integrations → integrations}/github.js +0 -0
  285. /package/dist/{src/integrations → integrations}/lockfile.js +0 -0
  286. /package/dist/{src/llm → llm}/embedders/cache.js +0 -0
  287. /package/dist/{src/llm → llm}/embedders/types.js +0 -0
  288. /package/dist/{src/llm → llm}/feature-gate.js +0 -0
  289. /package/dist/{src/llm → llm}/index-passes.js +0 -0
  290. /package/dist/{src/output → output}/context.js +0 -0
  291. /package/dist/{src/output → output}/renderers.js +0 -0
  292. /package/dist/{src/output → output}/shapes.js +0 -0
  293. /package/dist/{src/output → output}/text.js +0 -0
  294. /package/dist/{src/registry → registry}/build-index.js +0 -0
  295. /package/dist/{src/registry → registry}/create-provider-registry.js +0 -0
  296. /package/dist/{src/registry → registry}/factory.js +0 -0
  297. /package/dist/{src/registry → registry}/origin-resolve.js +0 -0
  298. /package/dist/{src/registry → registry}/providers/index.js +0 -0
  299. /package/dist/{src/registry → registry}/providers/skills-sh.js +0 -0
  300. /package/dist/{src/registry → registry}/providers/static-index.js +0 -0
  301. /package/dist/{src/registry → registry}/providers/types.js +0 -0
  302. /package/dist/{src/registry → registry}/resolve.js +0 -0
  303. /package/dist/{src/registry → registry}/types.js +0 -0
  304. /package/dist/{src/setup → setup}/detect.js +0 -0
  305. /package/dist/{src/setup → setup}/ripgrep-install.js +0 -0
  306. /package/dist/{src/setup → setup}/ripgrep-resolve.js +0 -0
  307. /package/dist/{src/setup → setup}/steps.js +0 -0
  308. /package/dist/{src/sources → sources}/include.js +0 -0
  309. /package/dist/{src/sources → sources}/provider-factory.js +0 -0
  310. /package/dist/{src/sources → sources}/provider.js +0 -0
  311. /package/dist/{src/sources → sources}/providers/filesystem.js +0 -0
  312. /package/dist/{src/sources → sources}/providers/git.js +0 -0
  313. /package/dist/{src/sources → sources}/providers/index.js +0 -0
  314. /package/dist/{src/sources → sources}/providers/install-types.js +0 -0
  315. /package/dist/{src/sources → sources}/providers/npm.js +0 -0
  316. /package/dist/{src/sources → sources}/providers/provider-utils.js +0 -0
  317. /package/dist/{src/sources → sources}/providers/sync-from-ref.js +0 -0
  318. /package/dist/{src/sources → sources}/providers/tar-utils.js +0 -0
  319. /package/dist/{src/sources → sources}/resolve.js +0 -0
  320. /package/dist/{src/sources → sources}/types.js +0 -0
  321. /package/dist/{src/templates → templates}/wiki-templates.js +0 -0
  322. /package/dist/{src/version.js → version.js} +0 -0
  323. /package/dist/{src/wiki → wiki}/wiki.js +0 -0
  324. /package/dist/{src/workflows → workflows}/authoring.js +0 -0
  325. /package/dist/{src/workflows → workflows}/cli.js +0 -0
  326. /package/dist/{src/workflows → workflows}/db.js +0 -0
  327. /package/dist/{src/workflows → workflows}/document-cache.js +0 -0
  328. /package/dist/{src/workflows → workflows}/parser.js +0 -0
  329. /package/dist/{src/workflows → workflows}/renderer.js +0 -0
  330. /package/dist/{src/workflows → workflows}/runs.js +0 -0
  331. /package/dist/{src/workflows → workflows}/schema.js +0 -0
  332. /package/dist/{src/workflows → workflows}/validator.js +0 -0
@@ -1,209 +0,0 @@
1
- /**
2
- * End-to-end CLI integration tests for `akm proposal {list,show,accept,reject,diff}`.
3
- *
4
- * Exercises the citty dispatcher as a real subprocess so:
5
- * - flag parsing,
6
- * - exit-code mapping (UsageError → 2, NotFoundError → 1, success → 0),
7
- * - JSON envelope shape,
8
- * are all covered end-to-end. A pre-built stash directory (created via the
9
- * direct `createProposal` helper) seeds the proposal queue so each subcommand
10
- * has a deterministic id to act on.
11
- *
12
- * Backfill for issue #284 GAP-CRIT 1.
13
- */
14
- import { afterAll, beforeEach, describe, expect, test } from "bun:test";
15
- import { spawnSync } from "node:child_process";
16
- import fs from "node:fs";
17
- import os from "node:os";
18
- import path from "node:path";
19
- import { createProposal } from "../../src/core/proposals";
20
- const tempDirs = [];
21
- function makeTempDir(prefix = "akm-proposal-cli-") {
22
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
23
- tempDirs.push(dir);
24
- return dir;
25
- }
26
- function makeStashDir() {
27
- const stash = makeTempDir("akm-proposal-cli-stash-");
28
- for (const sub of ["lessons", "skills", "memories", "knowledge"]) {
29
- fs.mkdirSync(path.join(stash, sub), { recursive: true });
30
- }
31
- return stash;
32
- }
33
- afterAll(() => {
34
- for (const dir of tempDirs.splice(0)) {
35
- fs.rmSync(dir, { recursive: true, force: true });
36
- }
37
- });
38
- const repoRoot = path.resolve(import.meta.dir, "..", "..");
39
- const cliPath = path.join(repoRoot, "src", "cli.ts");
40
- function runCli(args, options = { stashDir: "" }) {
41
- const xdgCache = makeTempDir("akm-proposal-cli-cache-");
42
- const xdgConfig = makeTempDir("akm-proposal-cli-config-");
43
- const home = makeTempDir("akm-proposal-cli-home-");
44
- const result = spawnSync("bun", [cliPath, ...args], {
45
- encoding: "utf8",
46
- timeout: 20_000,
47
- cwd: repoRoot,
48
- env: {
49
- ...process.env,
50
- AKM_STASH_DIR: options.stashDir || undefined,
51
- HOME: home,
52
- XDG_CACHE_HOME: xdgCache,
53
- XDG_CONFIG_HOME: xdgConfig,
54
- ...options.env,
55
- },
56
- });
57
- return {
58
- stdout: result.stdout ?? "",
59
- stderr: result.stderr ?? "",
60
- status: result.status ?? -1,
61
- };
62
- }
63
- const VALID_LESSON = `---\ndescription: Use ripgrep before grep\nwhen_to_use: Searching large repos\n---\n\nPrefer rg.\n`;
64
- function seedProposal(stash, ref = "lesson:rg-over-grep") {
65
- return createProposal(stash, {
66
- ref,
67
- source: "reflect",
68
- payload: { content: VALID_LESSON },
69
- });
70
- }
71
- beforeEach(() => {
72
- // (Each test creates its own stash dir so we get fresh state.)
73
- });
74
- describe("akm proposal list (CLI)", () => {
75
- test("happy path: lists pending proposal as JSON with totalCount", () => {
76
- const stash = makeStashDir();
77
- const created = seedProposal(stash);
78
- const result = runCli(["proposal", "list", "--format=json"], { stashDir: stash });
79
- expect(result.status).toBe(0);
80
- const parsed = JSON.parse(result.stdout);
81
- expect(parsed.totalCount).toBe(1);
82
- expect(Array.isArray(parsed.proposals)).toBe(true);
83
- expect(parsed.proposals[0].id).toBe(created.id);
84
- expect(parsed.proposals[0].ref).toBe("lesson:rg-over-grep");
85
- expect(parsed.proposals[0].status).toBe("pending");
86
- });
87
- test("error path: invalid --status value → UsageError exit 2 with code", () => {
88
- const stash = makeStashDir();
89
- seedProposal(stash);
90
- const result = runCli(["proposal", "list", "--status=bogus", "--format=json"], { stashDir: stash });
91
- expect(result.status).toBe(2);
92
- const envelope = JSON.parse(result.stderr);
93
- expect(envelope.ok).toBe(false);
94
- expect(envelope.code).toBe("INVALID_FLAG_VALUE");
95
- expect(envelope.error).toContain("Invalid --status value");
96
- });
97
- });
98
- describe("akm proposal show (CLI)", () => {
99
- test("happy path: returns proposal + validation report", () => {
100
- const stash = makeStashDir();
101
- const created = seedProposal(stash);
102
- const result = runCli(["proposal", "show", created.id, "--format=json"], { stashDir: stash });
103
- expect(result.status).toBe(0);
104
- const parsed = JSON.parse(result.stdout);
105
- expect(parsed.proposal).toBeDefined();
106
- expect(parsed.proposal.id).toBe(created.id);
107
- expect(parsed.proposal.ref).toBe("lesson:rg-over-grep");
108
- expect(parsed.validation).toBeDefined();
109
- expect(parsed.validation.ok).toBe(true);
110
- });
111
- test("error path: missing id → NotFoundError, exit 1", () => {
112
- const stash = makeStashDir();
113
- const result = runCli(["proposal", "show", "00000000-dead-beef-0000-000000000000", "--format=json"], {
114
- stashDir: stash,
115
- });
116
- expect(result.status).toBe(1);
117
- const envelope = JSON.parse(result.stderr);
118
- expect(envelope.ok).toBe(false);
119
- expect(envelope.code).toBe("FILE_NOT_FOUND");
120
- expect(envelope.error).toContain("00000000-dead-beef-0000-000000000000");
121
- });
122
- });
123
- describe("akm proposal accept (CLI)", () => {
124
- test("happy path: materialises asset on disk and exits 0", () => {
125
- const stash = makeStashDir();
126
- const created = seedProposal(stash);
127
- const result = runCli(["proposal", "accept", created.id, "--format=json"], { stashDir: stash });
128
- expect(result.status).toBe(0);
129
- const parsed = JSON.parse(result.stdout);
130
- expect(parsed.ok).toBe(true);
131
- expect(parsed.id).toBe(created.id);
132
- expect(parsed.ref).toBe("lesson:rg-over-grep");
133
- expect(parsed.assetPath).toBeDefined();
134
- expect(fs.existsSync(parsed.assetPath)).toBe(true);
135
- });
136
- test("error path: missing id → NotFoundError exit 1", () => {
137
- const stash = makeStashDir();
138
- const result = runCli(["proposal", "accept", "11111111-dead-beef-0000-000000000000", "--format=json"], {
139
- stashDir: stash,
140
- });
141
- expect(result.status).toBe(1);
142
- const envelope = JSON.parse(result.stderr);
143
- expect(envelope.ok).toBe(false);
144
- expect(envelope.code).toBe("FILE_NOT_FOUND");
145
- });
146
- });
147
- describe("akm proposal reject (CLI)", () => {
148
- test("happy path: archives proposal with reason, exit 0", () => {
149
- const stash = makeStashDir();
150
- const created = seedProposal(stash);
151
- const result = runCli(["proposal", "reject", created.id, "--reason", "duplicate", "--format=json"], {
152
- stashDir: stash,
153
- });
154
- expect(result.status).toBe(0);
155
- const parsed = JSON.parse(result.stdout);
156
- expect(parsed.ok).toBe(true);
157
- expect(parsed.reason).toBe("duplicate");
158
- // Live queue should now be empty.
159
- const list = runCli(["proposal", "list", "--format=json"], { stashDir: stash });
160
- expect(JSON.parse(list.stdout).totalCount).toBe(0);
161
- });
162
- test("error path: rejecting a non-pending proposal → UsageError INVALID_FLAG_VALUE, exit 2", () => {
163
- const stash = makeStashDir();
164
- const created = seedProposal(stash);
165
- // Reject once → archive.
166
- const first = runCli(["proposal", "reject", created.id, "--format=json"], { stashDir: stash });
167
- expect(first.status).toBe(0);
168
- // Reject again → must surface UsageError because it's no longer pending.
169
- const second = runCli(["proposal", "reject", created.id, "--format=json"], { stashDir: stash });
170
- expect(second.status).toBe(2);
171
- const envelope = JSON.parse(second.stderr);
172
- expect(envelope.ok).toBe(false);
173
- expect(envelope.code).toBe("INVALID_FLAG_VALUE");
174
- expect(envelope.error).toMatch(/not pending|already/i);
175
- });
176
- test("error path: missing id → NotFoundError exit 1", () => {
177
- const stash = makeStashDir();
178
- const result = runCli(["proposal", "reject", "22222222-dead-beef-0000-000000000000", "--format=json"], {
179
- stashDir: stash,
180
- });
181
- expect(result.status).toBe(1);
182
- const envelope = JSON.parse(result.stderr);
183
- expect(envelope.code).toBe("FILE_NOT_FOUND");
184
- });
185
- });
186
- describe("akm proposal diff (CLI)", () => {
187
- test("happy path: new asset diff contains /dev/null marker", () => {
188
- const stash = makeStashDir();
189
- const created = seedProposal(stash);
190
- const result = runCli(["proposal", "diff", created.id, "--format=json"], { stashDir: stash });
191
- expect(result.status).toBe(0);
192
- const parsed = JSON.parse(result.stdout);
193
- expect(parsed.id).toBe(created.id);
194
- expect(parsed.ref).toBe("lesson:rg-over-grep");
195
- expect(parsed.isNew).toBe(true);
196
- expect(parsed.unified).toContain("/dev/null");
197
- expect(parsed.unified).toContain("Prefer rg");
198
- });
199
- test("error path: missing id → NotFoundError exit 1", () => {
200
- const stash = makeStashDir();
201
- const result = runCli(["proposal", "diff", "33333333-dead-beef-0000-000000000000", "--format=json"], {
202
- stashDir: stash,
203
- });
204
- expect(result.status).toBe(1);
205
- const envelope = JSON.parse(result.stderr);
206
- expect(envelope.ok).toBe(false);
207
- expect(envelope.code).toBe("FILE_NOT_FOUND");
208
- });
209
- });
@@ -1,333 +0,0 @@
1
- /**
2
- * In-tree CLI argv-coercion tests for `akm reflect` and `akm propose` (#226).
3
- *
4
- * The real CLI dispatcher in `src/cli.ts` coerces citty's argv shape
5
- * (`{ ref?, task?, profile?, "timeout-ms"?, type, name }`) into the
6
- * `AkmReflectOptions` / `AkmProposeOptions` shape consumed by
7
- * `akmReflect` / `akmPropose`. Exercising the live `runMain` here would
8
- * require spawning the CLI and stubbing PATH-resolved binaries, which is
9
- * brittle. Instead we replicate the exact argv coercion logic and assert it
10
- * matches the production code, then drive `akmReflect` / `akmPropose` with
11
- * a captured-spawn fake (mirroring `tests/agent/agent-spawn.test.ts`) for
12
- * deterministic happy + failure paths.
13
- *
14
- * Backfill for issue #284 GAP-CRIT 2.
15
- */
16
- import { afterEach, beforeEach, describe, expect, test } from "bun:test";
17
- import fs from "node:fs";
18
- import os from "node:os";
19
- import path from "node:path";
20
- import { akmPropose } from "../../src/commands/propose";
21
- import { akmReflect } from "../../src/commands/reflect";
22
- const tempDirs = [];
23
- const savedEnv = {
24
- AKM_STASH_DIR: process.env.AKM_STASH_DIR,
25
- XDG_CACHE_HOME: process.env.XDG_CACHE_HOME,
26
- XDG_CONFIG_HOME: process.env.XDG_CONFIG_HOME,
27
- };
28
- function makeTempDir(prefix) {
29
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
30
- tempDirs.push(dir);
31
- return dir;
32
- }
33
- function makeStashDir() {
34
- const stash = makeTempDir("akm-rp-cli-stash-");
35
- for (const sub of ["lessons", "skills", "memories", "knowledge"]) {
36
- fs.mkdirSync(path.join(stash, sub), { recursive: true });
37
- }
38
- return stash;
39
- }
40
- function makeProfile(overrides = {}) {
41
- return {
42
- name: "fake-agent",
43
- bin: "fake-agent",
44
- args: [],
45
- stdio: "captured",
46
- envPassthrough: ["PATH"],
47
- parseOutput: "text",
48
- ...overrides,
49
- };
50
- }
51
- function asReadableStream(text) {
52
- const bytes = new TextEncoder().encode(text);
53
- return new ReadableStream({
54
- start(controller) {
55
- controller.enqueue(bytes);
56
- controller.close();
57
- },
58
- });
59
- }
60
- function fakeSpawn(stdout, stderr, exitCode, capture) {
61
- return (cmd) => {
62
- capture?.(cmd);
63
- const proc = {
64
- exitCode,
65
- exited: Promise.resolve(exitCode),
66
- stdout: asReadableStream(stdout),
67
- stderr: asReadableStream(stderr),
68
- stdin: null,
69
- kill: () => undefined,
70
- };
71
- return proc;
72
- };
73
- }
74
- function hangingSpawn() {
75
- return () => {
76
- let resolveExit;
77
- const exited = new Promise((r) => {
78
- resolveExit = r;
79
- });
80
- const proc = {
81
- exitCode: null,
82
- exited,
83
- stdout: asReadableStream(""),
84
- stderr: asReadableStream(""),
85
- stdin: null,
86
- kill: () => resolveExit?.(143),
87
- };
88
- return proc;
89
- };
90
- }
91
- const VALID_LESSON_PAYLOAD = JSON.stringify({
92
- ref: "lesson:rg-over-grep",
93
- content: "---\ndescription: Use ripgrep before grep\nwhen_to_use: Searching large repos for patterns\n---\n\nPrefer rg.\n",
94
- });
95
- const VALID_SKILL_PAYLOAD = JSON.stringify({
96
- ref: "skill:hello",
97
- content: "---\ndescription: Say hi\nwhen_to_use: When greeting\n---\n\nSay hi politely.\n",
98
- });
99
- beforeEach(() => {
100
- process.env.XDG_CACHE_HOME = makeTempDir("akm-rp-cli-cache-");
101
- process.env.XDG_CONFIG_HOME = makeTempDir("akm-rp-cli-config-");
102
- });
103
- afterEach(() => {
104
- if (savedEnv.AKM_STASH_DIR === undefined)
105
- delete process.env.AKM_STASH_DIR;
106
- else
107
- process.env.AKM_STASH_DIR = savedEnv.AKM_STASH_DIR;
108
- if (savedEnv.XDG_CACHE_HOME === undefined)
109
- delete process.env.XDG_CACHE_HOME;
110
- else
111
- process.env.XDG_CACHE_HOME = savedEnv.XDG_CACHE_HOME;
112
- if (savedEnv.XDG_CONFIG_HOME === undefined)
113
- delete process.env.XDG_CONFIG_HOME;
114
- else
115
- process.env.XDG_CONFIG_HOME = savedEnv.XDG_CONFIG_HOME;
116
- for (const dir of tempDirs.splice(0)) {
117
- fs.rmSync(dir, { recursive: true, force: true });
118
- }
119
- });
120
- // ── argv coercion helpers (mirror src/cli.ts) ───────────────────────────────
121
- /**
122
- * Mirror of `cli.ts` reflect-command coercion. Exercises the same string
123
- * trimming + Number.parseInt path the CLI dispatcher uses so a regression in
124
- * either place fails this test.
125
- */
126
- function coerceReflectArgs(args) {
127
- const timeoutRaw = args["timeout-ms"];
128
- const timeoutMs = typeof timeoutRaw === "string" && timeoutRaw.trim() ? Number.parseInt(timeoutRaw, 10) : undefined;
129
- return {
130
- ref: typeof args.ref === "string" && args.ref.trim() ? args.ref : undefined,
131
- task: typeof args.task === "string" && args.task.trim() ? args.task : undefined,
132
- profile: typeof args.profile === "string" && args.profile.trim() ? args.profile : undefined,
133
- ...(timeoutMs !== undefined && Number.isFinite(timeoutMs) ? { timeoutMs } : {}),
134
- };
135
- }
136
- function coerceProposeArgs(args) {
137
- const timeoutRaw = args["timeout-ms"];
138
- const timeoutMs = typeof timeoutRaw === "string" && timeoutRaw.trim() ? Number.parseInt(timeoutRaw, 10) : undefined;
139
- return {
140
- type: String(args.type),
141
- name: String(args.name),
142
- task: String(args.task ?? ""),
143
- profile: typeof args.profile === "string" && args.profile.trim() ? args.profile : undefined,
144
- ...(timeoutMs !== undefined && Number.isFinite(timeoutMs) ? { timeoutMs } : {}),
145
- };
146
- }
147
- // ── Coercion unit tests ────────────────────────────────────────────────────
148
- describe("citty argv → akmReflect coercion", () => {
149
- test("string fields trimmed; empty strings → undefined", () => {
150
- expect(coerceReflectArgs({ ref: "lesson:foo", task: " ", profile: "" })).toEqual({
151
- ref: "lesson:foo",
152
- task: undefined,
153
- profile: undefined,
154
- });
155
- });
156
- test("--timeout-ms parsed as integer", () => {
157
- expect(coerceReflectArgs({ "timeout-ms": "1500" })).toMatchObject({ timeoutMs: 1500 });
158
- });
159
- test("non-numeric --timeout-ms → omitted (Number.isFinite filter)", () => {
160
- expect(coerceReflectArgs({ "timeout-ms": "abc" })).not.toHaveProperty("timeoutMs");
161
- });
162
- test("blank --timeout-ms is omitted", () => {
163
- expect(coerceReflectArgs({ "timeout-ms": " " })).not.toHaveProperty("timeoutMs");
164
- });
165
- });
166
- describe("citty argv → akmPropose coercion", () => {
167
- test("type/name/task always strings; profile trimmed", () => {
168
- expect(coerceProposeArgs({ type: "skill", name: "hello", task: "Say hi", profile: " " })).toEqual({
169
- type: "skill",
170
- name: "hello",
171
- task: "Say hi",
172
- profile: undefined,
173
- });
174
- });
175
- test("missing task coerced to empty string (downstream UsageError)", () => {
176
- expect(coerceProposeArgs({ type: "skill", name: "x" })).toMatchObject({ task: "" });
177
- });
178
- test("--timeout-ms parsed; profile passed through when set", () => {
179
- expect(coerceProposeArgs({ type: "skill", name: "x", task: "go", "timeout-ms": "9000", profile: "claude" })).toMatchObject({ timeoutMs: 9000, profile: "claude" });
180
- });
181
- });
182
- // ── Reflect command behaviour with coerced args ────────────────────────────
183
- describe("akmReflect — argv-coerced calls (happy + failure)", () => {
184
- test("happy: argv-shape passed through coercion → queues a proposal", async () => {
185
- const stash = makeStashDir();
186
- const coerced = coerceReflectArgs({ ref: "lesson:rg-over-grep", task: "focus on speed", "timeout-ms": "5000" });
187
- let capturedCmd = [];
188
- const result = await akmReflect({
189
- ...coerced,
190
- stashDir: stash,
191
- agentProfile: makeProfile(),
192
- runAgentOptions: {
193
- spawn: fakeSpawn(VALID_LESSON_PAYLOAD, "", 0, (cmd) => {
194
- capturedCmd = cmd;
195
- }),
196
- },
197
- });
198
- expect(result.ok).toBe(true);
199
- if (!result.ok)
200
- throw new Error("expected ok");
201
- expect(result.proposal.ref).toBe("lesson:rg-over-grep");
202
- expect(capturedCmd[0]).toBe("fake-agent");
203
- });
204
- test("parse_error: agent stdout is malformed → ok:false envelope", async () => {
205
- const stash = makeStashDir();
206
- const coerced = coerceReflectArgs({ ref: "lesson:rg-over-grep" });
207
- const result = await akmReflect({
208
- ...coerced,
209
- stashDir: stash,
210
- agentProfile: makeProfile(),
211
- runAgentOptions: { spawn: fakeSpawn("not json", "", 0) },
212
- });
213
- expect(result.ok).toBe(false);
214
- if (result.ok)
215
- throw new Error("expected failure");
216
- expect(result.reason).toBe("parse_error");
217
- });
218
- test("timeout: short --timeout-ms is honoured by the wrapper", async () => {
219
- const stash = makeStashDir();
220
- const coerced = coerceReflectArgs({ ref: "lesson:rg-over-grep", "timeout-ms": "1" });
221
- let timerCb;
222
- const result = await akmReflect({
223
- ...coerced,
224
- stashDir: stash,
225
- agentProfile: makeProfile(),
226
- runAgentOptions: {
227
- spawn: hangingSpawn(),
228
- setTimeoutFn: ((cb) => {
229
- timerCb = cb;
230
- // Fire on next tick — keeps the test deterministic.
231
- queueMicrotask(() => timerCb?.());
232
- return 1;
233
- }),
234
- clearTimeoutFn: (() => undefined),
235
- },
236
- });
237
- expect(result.ok).toBe(false);
238
- if (result.ok)
239
- throw new Error("expected failure");
240
- expect(result.reason).toBe("timeout");
241
- });
242
- test("missing agent config (no `agent` block) → ConfigError surfaces with .code", async () => {
243
- const stash = makeStashDir();
244
- let thrown;
245
- try {
246
- await akmReflect({
247
- ref: "lesson:rg-over-grep",
248
- stashDir: stash,
249
- agentConfig: undefined, // explicit: no agent block resolved
250
- // Note: we deliberately do NOT pass agentProfile so resolveProfile is exercised.
251
- // loadAgentConfigFromDisk will load empty config (no XDG_CONFIG_HOME entry exists)
252
- });
253
- }
254
- catch (err) {
255
- thrown = err;
256
- }
257
- expect(thrown).toBeInstanceOf(Error);
258
- const e = thrown;
259
- expect(e.name).toBe("ConfigError");
260
- expect(e.code).toBe("INVALID_CONFIG_FILE");
261
- expect(e.message).toContain("agent");
262
- });
263
- });
264
- // ── Propose command behaviour with coerced args ────────────────────────────
265
- describe("akmPropose — argv-coerced calls (happy + failure)", () => {
266
- test("happy: argv-shape passed through coercion → queues skill proposal", async () => {
267
- const stash = makeStashDir();
268
- const coerced = coerceProposeArgs({ type: "skill", name: "hello", task: "Say hi", "timeout-ms": "5000" });
269
- const result = await akmPropose({
270
- ...coerced,
271
- stashDir: stash,
272
- agentProfile: makeProfile(),
273
- runAgentOptions: { spawn: fakeSpawn(VALID_SKILL_PAYLOAD, "", 0) },
274
- });
275
- expect(result.ok).toBe(true);
276
- if (!result.ok)
277
- throw new Error("expected ok");
278
- expect(result.proposal.ref).toBe("skill:hello");
279
- });
280
- test("parse_error: agent returns malformed JSON", async () => {
281
- const stash = makeStashDir();
282
- const coerced = coerceProposeArgs({ type: "skill", name: "hello", task: "Say hi" });
283
- const result = await akmPropose({
284
- ...coerced,
285
- stashDir: stash,
286
- agentProfile: makeProfile(),
287
- runAgentOptions: { spawn: fakeSpawn("garbage {", "", 0) },
288
- });
289
- expect(result.ok).toBe(false);
290
- if (result.ok)
291
- throw new Error("expected failure");
292
- expect(result.reason).toBe("parse_error");
293
- });
294
- test("missing config: no agent block → ConfigError when resolveProfile runs", async () => {
295
- const stash = makeStashDir();
296
- let thrown;
297
- try {
298
- await akmPropose({
299
- type: "skill",
300
- name: "hello",
301
- task: "Say hi",
302
- stashDir: stash,
303
- // Do NOT pass agentProfile or agentConfig — exercises the disk path
304
- // which resolves to undefined under the empty XDG_CONFIG_HOME above.
305
- });
306
- }
307
- catch (err) {
308
- thrown = err;
309
- }
310
- expect(thrown).toBeInstanceOf(Error);
311
- const e = thrown;
312
- expect(e.name).toBe("ConfigError");
313
- expect(e.code).toBe("INVALID_CONFIG_FILE");
314
- });
315
- test("missing --task surfaces UsageError (matches CLI contract for empty positional)", async () => {
316
- const stash = makeStashDir();
317
- const coerced = coerceProposeArgs({ type: "skill", name: "x" }); // task absent
318
- let thrown;
319
- try {
320
- await akmPropose({
321
- ...coerced,
322
- stashDir: stash,
323
- agentProfile: makeProfile(),
324
- runAgentOptions: { spawn: fakeSpawn(VALID_SKILL_PAYLOAD, "", 0) },
325
- });
326
- }
327
- catch (err) {
328
- thrown = err;
329
- }
330
- expect(thrown).toBeInstanceOf(Error);
331
- expect(thrown.message).toContain("--task");
332
- });
333
- });
@@ -1,97 +0,0 @@
1
- /**
2
- * remember --target tests
3
- *
4
- * Verifies the `--target` flag added to `akm remember` per v1 implementation
5
- * plan §6 decision 3. Resolution order is:
6
- * --target → defaultWriteTarget → working stash → ConfigError
7
- *
8
- * These tests exercise the explicit-target path:
9
- * - resolves to a configured filesystem source by name
10
- * - errors on unknown target names (UsageError)
11
- * - errors on non-writable targets (ConfigError)
12
- */
13
- import { afterEach, describe, expect, test } from "bun:test";
14
- import { spawnSync } from "node:child_process";
15
- import fs from "node:fs";
16
- import os from "node:os";
17
- import path from "node:path";
18
- const CLI = path.join(__dirname, "..", "..", "src", "cli.ts");
19
- const tempDirs = [];
20
- function makeTempDir(prefix) {
21
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
22
- tempDirs.push(dir);
23
- return dir;
24
- }
25
- function writeConfig(configDir, body) {
26
- const akmDir = path.join(configDir, "akm");
27
- fs.mkdirSync(akmDir, { recursive: true });
28
- fs.writeFileSync(path.join(akmDir, "config.json"), JSON.stringify(body, null, 2), "utf8");
29
- }
30
- function runCli(args, options) {
31
- const stashDir = options.stashDir ?? makeTempDir("akm-remember-stash-");
32
- const xdgCache = makeTempDir("akm-remember-cache-");
33
- const result = spawnSync("bun", [CLI, ...args], {
34
- encoding: "utf8",
35
- timeout: 30_000,
36
- input: options.input,
37
- env: {
38
- ...process.env,
39
- AKM_STASH_DIR: stashDir,
40
- AKM_CONFIG_DIR: path.join(options.configDir, "akm"),
41
- XDG_CACHE_HOME: xdgCache,
42
- },
43
- });
44
- return { stashDir, result };
45
- }
46
- afterEach(() => {
47
- for (const dir of tempDirs.splice(0)) {
48
- fs.rmSync(dir, { recursive: true, force: true });
49
- }
50
- });
51
- describe("remember --target", () => {
52
- test("--target resolves to a configured filesystem source", () => {
53
- const configDir = makeTempDir("akm-remember-config-");
54
- const targetDir = makeTempDir("akm-remember-target-");
55
- writeConfig(configDir, {
56
- semanticSearchMode: "off",
57
- sources: [{ type: "filesystem", name: "writable-target", path: targetDir, writable: true }],
58
- });
59
- const { stashDir, result } = runCli(["remember", "Pinned context for the rollout", "--target", "writable-target"], {
60
- configDir,
61
- });
62
- expect(result.status).toBe(0);
63
- const json = JSON.parse(result.stdout);
64
- expect(json.ok).toBe(true);
65
- expect(json.ref).toBe("memory:pinned-context-for-the-rollout");
66
- // The memory must land in the explicit target — NOT the working stash.
67
- const expectedPath = path.join(targetDir, "memories", "pinned-context-for-the-rollout.md");
68
- expect(json.path).toBe(expectedPath);
69
- expect(fs.existsSync(expectedPath)).toBe(true);
70
- expect(fs.existsSync(path.join(stashDir, "memories", "pinned-context-for-the-rollout.md"))).toBe(false);
71
- });
72
- test("--target with an unknown source name throws a usage error", () => {
73
- const configDir = makeTempDir("akm-remember-config-");
74
- const targetDir = makeTempDir("akm-remember-target-");
75
- writeConfig(configDir, {
76
- semanticSearchMode: "off",
77
- sources: [{ type: "filesystem", name: "real-target", path: targetDir, writable: true }],
78
- });
79
- const { result } = runCli(["remember", "won't be written", "--target", "nope"], { configDir });
80
- expect(result.status).toBe(2);
81
- const json = JSON.parse(result.stderr);
82
- expect(json.error).toContain('No source named "nope" is configured');
83
- expect(json.error).toContain("--target must reference a source name");
84
- });
85
- test("--target on a non-writable source throws a config error", () => {
86
- const configDir = makeTempDir("akm-remember-config-");
87
- const targetDir = makeTempDir("akm-remember-target-");
88
- writeConfig(configDir, {
89
- semanticSearchMode: "off",
90
- sources: [{ type: "filesystem", name: "read-only", path: targetDir, writable: false }],
91
- });
92
- const { result } = runCli(["remember", "won't be written", "--target", "read-only"], { configDir });
93
- expect(result.status).not.toBe(0);
94
- const json = JSON.parse(result.stderr);
95
- expect(json.error).toContain("source read-only is not writable");
96
- });
97
- });