akm-cli 0.7.0 → 0.7.1

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 (327) hide show
  1. package/package.json +8 -8
  2. package/dist/tests/add-website-source.test.js +0 -119
  3. package/dist/tests/agent/agent-config-loader.test.js +0 -70
  4. package/dist/tests/agent/agent-config.test.js +0 -221
  5. package/dist/tests/agent/agent-detect.test.js +0 -100
  6. package/dist/tests/agent/agent-spawn.test.js +0 -234
  7. package/dist/tests/agent-output.test.js +0 -186
  8. package/dist/tests/architecture/agent-no-llm-sdk-guard.test.js +0 -103
  9. package/dist/tests/architecture/agent-spawn-seam.test.js +0 -193
  10. package/dist/tests/architecture/llm-stateless-seam.test.js +0 -112
  11. package/dist/tests/asset-ref.test.js +0 -192
  12. package/dist/tests/asset-registry.test.js +0 -103
  13. package/dist/tests/asset-spec.test.js +0 -241
  14. package/dist/tests/bench/attribution.test.js +0 -996
  15. package/dist/tests/bench/cleanup-sigint.test.js +0 -83
  16. package/dist/tests/bench/cleanup.js +0 -234
  17. package/dist/tests/bench/cleanup.test.js +0 -166
  18. package/dist/tests/bench/cli.js +0 -1018
  19. package/dist/tests/bench/cli.test.js +0 -445
  20. package/dist/tests/bench/compare.test.js +0 -556
  21. package/dist/tests/bench/corpus.js +0 -317
  22. package/dist/tests/bench/corpus.test.js +0 -258
  23. package/dist/tests/bench/doctor.js +0 -525
  24. package/dist/tests/bench/driver.js +0 -401
  25. package/dist/tests/bench/driver.test.js +0 -584
  26. package/dist/tests/bench/environment.js +0 -233
  27. package/dist/tests/bench/environment.test.js +0 -199
  28. package/dist/tests/bench/evolve-metrics.js +0 -179
  29. package/dist/tests/bench/evolve-metrics.test.js +0 -187
  30. package/dist/tests/bench/evolve.js +0 -647
  31. package/dist/tests/bench/evolve.test.js +0 -624
  32. package/dist/tests/bench/failure-modes.test.js +0 -349
  33. package/dist/tests/bench/feedback-integrity.test.js +0 -457
  34. package/dist/tests/bench/leakage.test.js +0 -228
  35. package/dist/tests/bench/learning-curve.test.js +0 -134
  36. package/dist/tests/bench/metrics.js +0 -2395
  37. package/dist/tests/bench/metrics.test.js +0 -1150
  38. package/dist/tests/bench/no-os-tmpdir-invariant.test.js +0 -43
  39. package/dist/tests/bench/opencode-config.js +0 -194
  40. package/dist/tests/bench/opencode-config.test.js +0 -370
  41. package/dist/tests/bench/report.js +0 -1885
  42. package/dist/tests/bench/report.test.js +0 -1038
  43. package/dist/tests/bench/run-config.js +0 -355
  44. package/dist/tests/bench/run-config.test.js +0 -298
  45. package/dist/tests/bench/run-curate-test.js +0 -32
  46. package/dist/tests/bench/run-failing-tasks.js +0 -56
  47. package/dist/tests/bench/run-full-bench.js +0 -51
  48. package/dist/tests/bench/run-items36-targeted.js +0 -69
  49. package/dist/tests/bench/run-nano-quick.js +0 -42
  50. package/dist/tests/bench/run-waveg-targeted.js +0 -62
  51. package/dist/tests/bench/runner.js +0 -699
  52. package/dist/tests/bench/runner.test.js +0 -958
  53. package/dist/tests/bench/search-bridge.test.js +0 -331
  54. package/dist/tests/bench/tmp.js +0 -131
  55. package/dist/tests/bench/trajectory.js +0 -116
  56. package/dist/tests/bench/trajectory.test.js +0 -127
  57. package/dist/tests/bench/verifier.js +0 -114
  58. package/dist/tests/bench/verifier.test.js +0 -118
  59. package/dist/tests/bench/workflow-evaluator.js +0 -557
  60. package/dist/tests/bench/workflow-evaluator.test.js +0 -421
  61. package/dist/tests/bench/workflow-spec.js +0 -345
  62. package/dist/tests/bench/workflow-spec.test.js +0 -363
  63. package/dist/tests/bench/workflow-trace.js +0 -472
  64. package/dist/tests/bench/workflow-trace.test.js +0 -254
  65. package/dist/tests/benchmark-search-quality.js +0 -536
  66. package/dist/tests/benchmark-suite.js +0 -1441
  67. package/dist/tests/capture-cli.test.js +0 -112
  68. package/dist/tests/cli-errors.test.js +0 -204
  69. package/dist/tests/commands/events.test.js +0 -370
  70. package/dist/tests/commands/history.test.js +0 -418
  71. package/dist/tests/commands/import.test.js +0 -103
  72. package/dist/tests/commands/proposal-cli.test.js +0 -209
  73. package/dist/tests/commands/reflect-propose-cli.test.js +0 -333
  74. package/dist/tests/commands/remember.test.js +0 -97
  75. package/dist/tests/commands/scope-flags.test.js +0 -300
  76. package/dist/tests/commands/search.test.js +0 -537
  77. package/dist/tests/commands/show-indexer-parity.test.js +0 -117
  78. package/dist/tests/commands/show.test.js +0 -294
  79. package/dist/tests/common.test.js +0 -266
  80. package/dist/tests/completions.test.js +0 -142
  81. package/dist/tests/config-cli.test.js +0 -193
  82. package/dist/tests/config-llm-features.test.js +0 -139
  83. package/dist/tests/config.test.js +0 -569
  84. package/dist/tests/contracts/migration-baseline.test.js +0 -43
  85. package/dist/tests/contracts/reflect-propose-envelope.test.js +0 -139
  86. package/dist/tests/contracts/spec-helpers.js +0 -46
  87. package/dist/tests/contracts/v1-spec-section-11-proposal-queue.test.js +0 -228
  88. package/dist/tests/contracts/v1-spec-section-12-agent-config.test.js +0 -56
  89. package/dist/tests/contracts/v1-spec-section-13-lesson-type.test.js +0 -34
  90. package/dist/tests/contracts/v1-spec-section-14-llm-features.test.js +0 -94
  91. package/dist/tests/contracts/v1-spec-section-4-1-asset-types.test.js +0 -39
  92. package/dist/tests/contracts/v1-spec-section-4-2-quality-rules.test.js +0 -44
  93. package/dist/tests/contracts/v1-spec-section-5-configuration.test.js +0 -47
  94. package/dist/tests/contracts/v1-spec-section-6-orchestration.test.js +0 -40
  95. package/dist/tests/contracts/v1-spec-section-7-module-layout.test.js +0 -58
  96. package/dist/tests/contracts/v1-spec-section-8-extension-points.test.js +0 -34
  97. package/dist/tests/contracts/v1-spec-section-9-4-cli-surface.test.js +0 -75
  98. package/dist/tests/contracts/v1-spec-section-9-7-llm-agent-boundary.test.js +0 -36
  99. package/dist/tests/core/write-source.test.js +0 -366
  100. package/dist/tests/curate-command.test.js +0 -87
  101. package/dist/tests/db-scoring.test.js +0 -201
  102. package/dist/tests/db.test.js +0 -654
  103. package/dist/tests/distill-cli-flag.test.js +0 -208
  104. package/dist/tests/distill.test.js +0 -515
  105. package/dist/tests/docker-install.test.js +0 -120
  106. package/dist/tests/e2e.test.js +0 -1419
  107. package/dist/tests/embedder.test.js +0 -340
  108. package/dist/tests/embedding-model-config.test.js +0 -379
  109. package/dist/tests/feedback-command.test.js +0 -172
  110. package/dist/tests/file-context.test.js +0 -552
  111. package/dist/tests/fixtures/scripts/git/summarize-diff.js +0 -9
  112. package/dist/tests/fixtures/scripts/lint/eslint-check.js +0 -7
  113. package/dist/tests/fixtures/stashes/load.js +0 -166
  114. package/dist/tests/fixtures/stashes/load.test.js +0 -97
  115. package/dist/tests/fixtures/stashes/ranking-baseline/scripts/mem0-search.js +0 -12
  116. package/dist/tests/frontmatter.test.js +0 -190
  117. package/dist/tests/fts-field-weighting.test.js +0 -254
  118. package/dist/tests/fuzzy-search.test.js +0 -230
  119. package/dist/tests/git-provider-clone.test.js +0 -45
  120. package/dist/tests/github.test.js +0 -161
  121. package/dist/tests/graph-boost-ranking.test.js +0 -305
  122. package/dist/tests/graph-extraction.test.js +0 -282
  123. package/dist/tests/helpers/usage-events.js +0 -8
  124. package/dist/tests/index-pass-llm.test.js +0 -161
  125. package/dist/tests/indexer.test.js +0 -570
  126. package/dist/tests/info-command.test.js +0 -166
  127. package/dist/tests/init.test.js +0 -69
  128. package/dist/tests/install-script.test.js +0 -246
  129. package/dist/tests/integration/agent-real-profile.test.js +0 -94
  130. package/dist/tests/issue-36-repro.test.js +0 -304
  131. package/dist/tests/issues-191-194.test.js +0 -160
  132. package/dist/tests/lesson-lint.test.js +0 -111
  133. package/dist/tests/llm-client.test.js +0 -115
  134. package/dist/tests/llm-feature-gate.test.js +0 -151
  135. package/dist/tests/llm.test.js +0 -139
  136. package/dist/tests/lockfile.test.js +0 -216
  137. package/dist/tests/manifest.test.js +0 -205
  138. package/dist/tests/markdown.test.js +0 -126
  139. package/dist/tests/matchers-unit.test.js +0 -189
  140. package/dist/tests/memory-inference.test.js +0 -299
  141. package/dist/tests/merge-scoring.test.js +0 -136
  142. package/dist/tests/metadata.test.js +0 -313
  143. package/dist/tests/migration-help.test.js +0 -89
  144. package/dist/tests/origin-resolve.test.js +0 -124
  145. package/dist/tests/output-baseline.test.js +0 -218
  146. package/dist/tests/output-shapes-unit.test.js +0 -478
  147. package/dist/tests/parallel-search.test.js +0 -272
  148. package/dist/tests/parameter-metadata.test.js +0 -365
  149. package/dist/tests/paths.test.js +0 -177
  150. package/dist/tests/progressive-disclosure.test.js +0 -280
  151. package/dist/tests/proposals.test.js +0 -279
  152. package/dist/tests/proposed-quality.test.js +0 -271
  153. package/dist/tests/provider-registry.test.js +0 -32
  154. package/dist/tests/ranking-regression.test.js +0 -548
  155. package/dist/tests/reflect-propose.test.js +0 -455
  156. package/dist/tests/registry-build-index.test.js +0 -394
  157. package/dist/tests/registry-cli.test.js +0 -290
  158. package/dist/tests/registry-index-v2.test.js +0 -430
  159. package/dist/tests/registry-install.test.js +0 -728
  160. package/dist/tests/registry-providers/parity.test.js +0 -189
  161. package/dist/tests/registry-providers/skills-sh.test.js +0 -309
  162. package/dist/tests/registry-providers/static-index.test.js +0 -238
  163. package/dist/tests/registry-resolve.test.js +0 -126
  164. package/dist/tests/registry-search.test.js +0 -923
  165. package/dist/tests/remember-frontmatter.test.js +0 -378
  166. package/dist/tests/remember-unit.test.js +0 -123
  167. package/dist/tests/ripgrep-install.test.js +0 -251
  168. package/dist/tests/ripgrep-resolve.test.js +0 -108
  169. package/dist/tests/ripgrep.test.js +0 -163
  170. package/dist/tests/save-command.test.js +0 -94
  171. package/dist/tests/save-trust-qa-fixes.test.js +0 -270
  172. package/dist/tests/scoring-pipeline.test.js +0 -648
  173. package/dist/tests/search-include-proposed-cli.test.js +0 -118
  174. package/dist/tests/self-update.test.js +0 -442
  175. package/dist/tests/semantic-search-e2e.test.js +0 -512
  176. package/dist/tests/semantic-status.test.js +0 -471
  177. package/dist/tests/setup-run.integration.js +0 -877
  178. package/dist/tests/setup-wizard.test.js +0 -198
  179. package/dist/tests/setup.test.js +0 -131
  180. package/dist/tests/source-add.test.js +0 -11
  181. package/dist/tests/source-clone.test.js +0 -254
  182. package/dist/tests/source-manage.test.js +0 -366
  183. package/dist/tests/source-providers/filesystem.test.js +0 -82
  184. package/dist/tests/source-providers/git.test.js +0 -252
  185. package/dist/tests/source-providers/website.test.js +0 -128
  186. package/dist/tests/source-qa-fixes.test.js +0 -286
  187. package/dist/tests/source-registry.test.js +0 -350
  188. package/dist/tests/source-resolve.test.js +0 -100
  189. package/dist/tests/source-source.test.js +0 -281
  190. package/dist/tests/source.test.js +0 -533
  191. package/dist/tests/tar-utils-scan.test.js +0 -73
  192. package/dist/tests/toggle-components.test.js +0 -73
  193. package/dist/tests/usage-telemetry.test.js +0 -265
  194. package/dist/tests/utility-scoring.test.js +0 -558
  195. package/dist/tests/vault-load-error.test.js +0 -78
  196. package/dist/tests/vault-qa-fixes.test.js +0 -194
  197. package/dist/tests/vault.test.js +0 -429
  198. package/dist/tests/vector-search.test.js +0 -608
  199. package/dist/tests/walker.test.js +0 -252
  200. package/dist/tests/wave2-cluster-bc.test.js +0 -228
  201. package/dist/tests/wave2-cluster-d.test.js +0 -180
  202. package/dist/tests/wave2-cluster-e.test.js +0 -179
  203. package/dist/tests/wiki-qa-fixes.test.js +0 -270
  204. package/dist/tests/wiki.test.js +0 -529
  205. package/dist/tests/workflow-cli.test.js +0 -271
  206. package/dist/tests/workflow-markdown.test.js +0 -171
  207. package/dist/tests/workflow-path-escape.test.js +0 -132
  208. package/dist/tests/workflow-qa-fixes.test.js +0 -395
  209. package/dist/tests/workflows/indexer-rejection.test.js +0 -213
  210. /package/dist/{src/cli.js → cli.js} +0 -0
  211. /package/dist/{src/commands → commands}/completions.js +0 -0
  212. /package/dist/{src/commands → commands}/config-cli.js +0 -0
  213. /package/dist/{src/commands → commands}/curate.js +0 -0
  214. /package/dist/{src/commands → commands}/distill.js +0 -0
  215. /package/dist/{src/commands → commands}/events.js +0 -0
  216. /package/dist/{src/commands → commands}/history.js +0 -0
  217. /package/dist/{src/commands → commands}/info.js +0 -0
  218. /package/dist/{src/commands → commands}/init.js +0 -0
  219. /package/dist/{src/commands → commands}/install-audit.js +0 -0
  220. /package/dist/{src/commands → commands}/installed-stashes.js +0 -0
  221. /package/dist/{src/commands → commands}/migration-help.js +0 -0
  222. /package/dist/{src/commands → commands}/proposal.js +0 -0
  223. /package/dist/{src/commands → commands}/propose.js +0 -0
  224. /package/dist/{src/commands → commands}/reflect.js +0 -0
  225. /package/dist/{src/commands → commands}/registry-search.js +0 -0
  226. /package/dist/{src/commands → commands}/remember.js +0 -0
  227. /package/dist/{src/commands → commands}/search.js +0 -0
  228. /package/dist/{src/commands → commands}/self-update.js +0 -0
  229. /package/dist/{src/commands → commands}/show.js +0 -0
  230. /package/dist/{src/commands → commands}/source-add.js +0 -0
  231. /package/dist/{src/commands → commands}/source-clone.js +0 -0
  232. /package/dist/{src/commands → commands}/source-manage.js +0 -0
  233. /package/dist/{src/commands → commands}/vault.js +0 -0
  234. /package/dist/{src/core → core}/asset-ref.js +0 -0
  235. /package/dist/{src/core → core}/asset-registry.js +0 -0
  236. /package/dist/{src/core → core}/asset-spec.js +0 -0
  237. /package/dist/{src/core → core}/common.js +0 -0
  238. /package/dist/{src/core → core}/config.js +0 -0
  239. /package/dist/{src/core → core}/errors.js +0 -0
  240. /package/dist/{src/core → core}/events.js +0 -0
  241. /package/dist/{src/core → core}/frontmatter.js +0 -0
  242. /package/dist/{src/core → core}/lesson-lint.js +0 -0
  243. /package/dist/{src/core → core}/markdown.js +0 -0
  244. /package/dist/{src/core → core}/paths.js +0 -0
  245. /package/dist/{src/core → core}/proposals.js +0 -0
  246. /package/dist/{src/core → core}/warn.js +0 -0
  247. /package/dist/{src/core → core}/write-source.js +0 -0
  248. /package/dist/{src/indexer → indexer}/db-search.js +0 -0
  249. /package/dist/{src/indexer → indexer}/db.js +0 -0
  250. /package/dist/{src/indexer → indexer}/file-context.js +0 -0
  251. /package/dist/{src/indexer → indexer}/graph-boost.js +0 -0
  252. /package/dist/{src/indexer → indexer}/graph-extraction.js +0 -0
  253. /package/dist/{src/indexer → indexer}/indexer.js +0 -0
  254. /package/dist/{src/indexer → indexer}/manifest.js +0 -0
  255. /package/dist/{src/indexer → indexer}/matchers.js +0 -0
  256. /package/dist/{src/indexer → indexer}/memory-inference.js +0 -0
  257. /package/dist/{src/indexer → indexer}/metadata.js +0 -0
  258. /package/dist/{src/indexer → indexer}/search-fields.js +0 -0
  259. /package/dist/{src/indexer → indexer}/search-source.js +0 -0
  260. /package/dist/{src/indexer → indexer}/semantic-status.js +0 -0
  261. /package/dist/{src/indexer → indexer}/usage-events.js +0 -0
  262. /package/dist/{src/indexer → indexer}/walker.js +0 -0
  263. /package/dist/{src/integrations → integrations}/agent/config.js +0 -0
  264. /package/dist/{src/integrations → integrations}/agent/detect.js +0 -0
  265. /package/dist/{src/integrations → integrations}/agent/index.js +0 -0
  266. /package/dist/{src/integrations → integrations}/agent/profiles.js +0 -0
  267. /package/dist/{src/integrations → integrations}/agent/prompts.js +0 -0
  268. /package/dist/{src/integrations → integrations}/agent/spawn.js +0 -0
  269. /package/dist/{src/integrations → integrations}/github.js +0 -0
  270. /package/dist/{src/integrations → integrations}/lockfile.js +0 -0
  271. /package/dist/{src/llm → llm}/client.js +0 -0
  272. /package/dist/{src/llm → llm}/embedder.js +0 -0
  273. /package/dist/{src/llm → llm}/embedders/cache.js +0 -0
  274. /package/dist/{src/llm → llm}/embedders/local.js +0 -0
  275. /package/dist/{src/llm → llm}/embedders/remote.js +0 -0
  276. /package/dist/{src/llm → llm}/embedders/types.js +0 -0
  277. /package/dist/{src/llm → llm}/feature-gate.js +0 -0
  278. /package/dist/{src/llm → llm}/graph-extract.js +0 -0
  279. /package/dist/{src/llm → llm}/index-passes.js +0 -0
  280. /package/dist/{src/llm → llm}/memory-infer.js +0 -0
  281. /package/dist/{src/llm → llm}/metadata-enhance.js +0 -0
  282. /package/dist/{src/output → output}/cli-hints.js +0 -0
  283. /package/dist/{src/output → output}/context.js +0 -0
  284. /package/dist/{src/output → output}/renderers.js +0 -0
  285. /package/dist/{src/output → output}/shapes.js +0 -0
  286. /package/dist/{src/output → output}/text.js +0 -0
  287. /package/dist/{src/registry → registry}/build-index.js +0 -0
  288. /package/dist/{src/registry → registry}/create-provider-registry.js +0 -0
  289. /package/dist/{src/registry → registry}/factory.js +0 -0
  290. /package/dist/{src/registry → registry}/origin-resolve.js +0 -0
  291. /package/dist/{src/registry → registry}/providers/index.js +0 -0
  292. /package/dist/{src/registry → registry}/providers/skills-sh.js +0 -0
  293. /package/dist/{src/registry → registry}/providers/static-index.js +0 -0
  294. /package/dist/{src/registry → registry}/providers/types.js +0 -0
  295. /package/dist/{src/registry → registry}/resolve.js +0 -0
  296. /package/dist/{src/registry → registry}/types.js +0 -0
  297. /package/dist/{src/setup → setup}/detect.js +0 -0
  298. /package/dist/{src/setup → setup}/ripgrep-install.js +0 -0
  299. /package/dist/{src/setup → setup}/ripgrep-resolve.js +0 -0
  300. /package/dist/{src/setup → setup}/setup.js +0 -0
  301. /package/dist/{src/setup → setup}/steps.js +0 -0
  302. /package/dist/{src/sources → sources}/include.js +0 -0
  303. /package/dist/{src/sources → sources}/provider-factory.js +0 -0
  304. /package/dist/{src/sources → sources}/provider.js +0 -0
  305. /package/dist/{src/sources → sources}/providers/filesystem.js +0 -0
  306. /package/dist/{src/sources → sources}/providers/git.js +0 -0
  307. /package/dist/{src/sources → sources}/providers/index.js +0 -0
  308. /package/dist/{src/sources → sources}/providers/install-types.js +0 -0
  309. /package/dist/{src/sources → sources}/providers/npm.js +0 -0
  310. /package/dist/{src/sources → sources}/providers/provider-utils.js +0 -0
  311. /package/dist/{src/sources → sources}/providers/sync-from-ref.js +0 -0
  312. /package/dist/{src/sources → sources}/providers/tar-utils.js +0 -0
  313. /package/dist/{src/sources → sources}/providers/website.js +0 -0
  314. /package/dist/{src/sources → sources}/resolve.js +0 -0
  315. /package/dist/{src/sources → sources}/types.js +0 -0
  316. /package/dist/{src/templates → templates}/wiki-templates.js +0 -0
  317. /package/dist/{src/version.js → version.js} +0 -0
  318. /package/dist/{src/wiki → wiki}/wiki.js +0 -0
  319. /package/dist/{src/workflows → workflows}/authoring.js +0 -0
  320. /package/dist/{src/workflows → workflows}/cli.js +0 -0
  321. /package/dist/{src/workflows → workflows}/db.js +0 -0
  322. /package/dist/{src/workflows → workflows}/document-cache.js +0 -0
  323. /package/dist/{src/workflows → workflows}/parser.js +0 -0
  324. /package/dist/{src/workflows → workflows}/renderer.js +0 -0
  325. /package/dist/{src/workflows → workflows}/runs.js +0 -0
  326. /package/dist/{src/workflows → workflows}/schema.js +0 -0
  327. /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
- });