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,569 +0,0 @@
1
- import { afterEach, beforeEach, describe, expect, test } from "bun:test";
2
- import fs from "node:fs";
3
- import os from "node:os";
4
- import path from "node:path";
5
- import { DEFAULT_CONFIG, getConfigDir, getConfigPath, loadConfig, loadUserConfig, resetConfigCache, saveConfig, updateConfig, } from "../src/core/config";
6
- import { ConfigError } from "../src/core/errors";
7
- function makeTmpDir() {
8
- return fs.mkdtempSync(path.join(os.tmpdir(), "akm-config-test-"));
9
- }
10
- function cleanup(dir) {
11
- fs.rmSync(dir, { recursive: true, force: true });
12
- }
13
- function writeRawConfig(configPath, content) {
14
- fs.mkdirSync(path.dirname(configPath), { recursive: true });
15
- fs.writeFileSync(configPath, content);
16
- }
17
- const originalXdgConfigHome = process.env.XDG_CONFIG_HOME;
18
- const originalHome = process.env.HOME;
19
- const originalStashDir = process.env.AKM_STASH_DIR;
20
- const originalCwd = process.cwd();
21
- let testConfigHome = "";
22
- beforeEach(() => {
23
- testConfigHome = makeTmpDir();
24
- process.env.XDG_CONFIG_HOME = testConfigHome;
25
- process.chdir(originalCwd);
26
- resetConfigCache();
27
- });
28
- afterEach(() => {
29
- if (originalXdgConfigHome === undefined) {
30
- delete process.env.XDG_CONFIG_HOME;
31
- }
32
- else {
33
- process.env.XDG_CONFIG_HOME = originalXdgConfigHome;
34
- }
35
- if (originalHome === undefined) {
36
- delete process.env.HOME;
37
- }
38
- else {
39
- process.env.HOME = originalHome;
40
- }
41
- if (originalStashDir === undefined) {
42
- delete process.env.AKM_STASH_DIR;
43
- }
44
- else {
45
- process.env.AKM_STASH_DIR = originalStashDir;
46
- }
47
- if (testConfigHome) {
48
- cleanup(testConfigHome);
49
- testConfigHome = "";
50
- }
51
- process.chdir(originalCwd);
52
- resetConfigCache();
53
- });
54
- // ── getConfigPath ───────────────────────────────────────────────────────────
55
- describe("getConfigPath", () => {
56
- test("returns config.json under XDG_CONFIG_HOME", () => {
57
- expect(getConfigPath()).toBe(path.join(testConfigHome, "akm", "config.json"));
58
- });
59
- test("defaults to ~/.config/akm when XDG_CONFIG_HOME is unset", () => {
60
- const home = makeTmpDir();
61
- delete process.env.XDG_CONFIG_HOME;
62
- process.env.HOME = home;
63
- expect(getConfigPath()).toBe(path.join(home, ".config", "akm", "config.json"));
64
- cleanup(home);
65
- });
66
- test("uses APPDATA on Windows", () => {
67
- const appData = String.raw `C:\Users\alice\AppData\Roaming`;
68
- expect(getConfigDir({ APPDATA: appData }, "win32")).toBe(path.join(appData, "akm"));
69
- expect(path.join(getConfigDir({ APPDATA: appData }, "win32"), "config.json")).toBe(path.join(appData, "akm", "config.json"));
70
- });
71
- test("falls back to USERPROFILE AppData Roaming on Windows", () => {
72
- const userProfile = String.raw `C:\Users\alice`;
73
- expect(getConfigDir({ USERPROFILE: userProfile }, "win32")).toBe(path.join(userProfile, "AppData", "Roaming", "akm"));
74
- });
75
- test("throws on Windows when APPDATA and USERPROFILE are missing", () => {
76
- expect(() => getConfigDir({}, "win32")).toThrow("Unable to determine config directory. Set APPDATA or USERPROFILE.");
77
- });
78
- });
79
- // ── loadConfig ──────────────────────────────────────────────────────────────
80
- describe("loadConfig", () => {
81
- test("returns defaults when no config.json exists", () => {
82
- expect(loadConfig()).toEqual(DEFAULT_CONFIG);
83
- });
84
- test("loads config without requiring AKM_STASH_DIR", () => {
85
- delete process.env.AKM_STASH_DIR;
86
- writeRawConfig(getConfigPath(), JSON.stringify({ semanticSearchMode: "off" }));
87
- const config = loadConfig();
88
- expect(config.semanticSearchMode).toBe("off");
89
- expect(config.sources).toBeUndefined();
90
- expect(config.output).toEqual({ format: "json", detail: "brief" });
91
- expect(config.registries).toEqual(DEFAULT_CONFIG.registries);
92
- });
93
- test("merges partial config with defaults", () => {
94
- writeRawConfig(getConfigPath(), JSON.stringify({ semanticSearchMode: "off" }));
95
- const config = loadConfig();
96
- expect(config.semanticSearchMode).toBe("off");
97
- expect(config.sources).toBeUndefined();
98
- expect(config.output).toEqual({ format: "json", detail: "brief" });
99
- });
100
- test("handles corrupted JSON gracefully", () => {
101
- writeRawConfig(getConfigPath(), "not valid json {{{");
102
- expect(loadConfig()).toEqual(DEFAULT_CONFIG);
103
- });
104
- test("handles non-object JSON gracefully", () => {
105
- writeRawConfig(getConfigPath(), '"just a string"');
106
- expect(loadConfig()).toEqual(DEFAULT_CONFIG);
107
- });
108
- test("handles JSON array gracefully", () => {
109
- writeRawConfig(getConfigPath(), "[1, 2, 3]");
110
- expect(loadConfig()).toEqual(DEFAULT_CONFIG);
111
- });
112
- test("drops unknown keys", () => {
113
- writeRawConfig(getConfigPath(), JSON.stringify({ semanticSearchMode: "off", futureKey: "hello", anotherKey: 42 }));
114
- const config = loadConfig();
115
- expect(config.semanticSearchMode).toBe("off");
116
- expect(config.sources).toBeUndefined();
117
- expect(config.output).toEqual({ format: "json", detail: "brief" });
118
- expect(config.registries).toEqual(DEFAULT_CONFIG.registries);
119
- expect(config.futureKey).toBeUndefined();
120
- expect(config.anotherKey).toBeUndefined();
121
- });
122
- test("ignores wrong types for known keys", () => {
123
- writeRawConfig(getConfigPath(), JSON.stringify({ semanticSearchMode: "yes", sources: "not-an-array" }));
124
- const config = loadConfig();
125
- expect(config.semanticSearchMode).toBe("auto");
126
- expect(config.sources).toBeUndefined();
127
- });
128
- test("coerces boolean true to 'auto' for semanticSearchMode", () => {
129
- writeRawConfig(getConfigPath(), JSON.stringify({ semanticSearchMode: true }));
130
- expect(loadConfig().semanticSearchMode).toBe("auto");
131
- });
132
- test("coerces boolean false to 'off' for semanticSearchMode", () => {
133
- writeRawConfig(getConfigPath(), JSON.stringify({ semanticSearchMode: false }));
134
- expect(loadConfig().semanticSearchMode).toBe("off");
135
- });
136
- test("passes through string 'auto' for semanticSearchMode", () => {
137
- writeRawConfig(getConfigPath(), JSON.stringify({ semanticSearchMode: "auto" }));
138
- expect(loadConfig().semanticSearchMode).toBe("auto");
139
- });
140
- test("passes through string 'off' for semanticSearchMode", () => {
141
- writeRawConfig(getConfigPath(), JSON.stringify({ semanticSearchMode: "off" }));
142
- expect(loadConfig().semanticSearchMode).toBe("off");
143
- });
144
- test("falls back to 'auto' for invalid semanticSearchMode values", () => {
145
- writeRawConfig(getConfigPath(), JSON.stringify({ semanticSearchMode: 42 }));
146
- expect(loadConfig().semanticSearchMode).toBe("auto");
147
- });
148
- test("ignores legacy semanticSearch boolean (compat shim retired)", () => {
149
- writeRawConfig(getConfigPath(), JSON.stringify({ semanticSearch: false }));
150
- expect(loadConfig().semanticSearchMode).toBe("auto");
151
- });
152
- test("ignores stash-root config.json files", () => {
153
- const stashDir = makeTmpDir();
154
- try {
155
- writeRawConfig(path.join(stashDir, "config.json"), JSON.stringify({ semanticSearchMode: "off" }));
156
- expect(loadConfig()).toEqual(DEFAULT_CONFIG);
157
- expect(fs.existsSync(getConfigPath())).toBe(false);
158
- }
159
- finally {
160
- cleanup(stashDir);
161
- }
162
- });
163
- test("merges ancestor project config files on top of user config", () => {
164
- const workspaceRoot = makeTmpDir();
165
- const nestedProjectDir = path.join(workspaceRoot, "apps", "demo");
166
- try {
167
- fs.mkdirSync(nestedProjectDir, { recursive: true });
168
- writeRawConfig(getConfigPath(), JSON.stringify({
169
- semanticSearchMode: "auto",
170
- output: { format: "text" },
171
- sources: [{ type: "filesystem", path: "/user-stash" }],
172
- }));
173
- writeRawConfig(path.join(workspaceRoot, ".akm", "config.json"), JSON.stringify({
174
- output: { detail: "full" },
175
- sources: [{ type: "filesystem", path: "/workspace-stash" }],
176
- }));
177
- writeRawConfig(path.join(workspaceRoot, "apps", ".akm", "config.json"), JSON.stringify({
178
- semanticSearchMode: "off",
179
- sources: [{ type: "filesystem", path: "/apps-stash" }],
180
- }));
181
- process.chdir(nestedProjectDir);
182
- expect(loadConfig()).toEqual({
183
- ...DEFAULT_CONFIG,
184
- semanticSearchMode: "off",
185
- output: { format: "text", detail: "full" },
186
- sources: [
187
- { type: "filesystem", path: "/user-stash" },
188
- { type: "filesystem", path: "/workspace-stash" },
189
- { type: "filesystem", path: "/apps-stash" },
190
- ],
191
- });
192
- }
193
- finally {
194
- cleanup(workspaceRoot);
195
- }
196
- });
197
- test("project config can replace inherited sources while keeping project sources", () => {
198
- const projectDir = makeTmpDir();
199
- try {
200
- writeRawConfig(getConfigPath(), JSON.stringify({
201
- semanticSearchMode: "auto",
202
- sources: [{ type: "filesystem", path: "/user-stash" }],
203
- }));
204
- writeRawConfig(path.join(projectDir, ".akm", "config.json"), JSON.stringify({
205
- stashInheritance: "replace",
206
- sources: [{ type: "filesystem", path: "/project-stash" }],
207
- }));
208
- process.chdir(projectDir);
209
- expect(loadConfig().sources).toEqual([{ type: "filesystem", path: "/project-stash" }]);
210
- }
211
- finally {
212
- cleanup(projectDir);
213
- }
214
- });
215
- test("project config can replace inherited sources without defining replacements", () => {
216
- const projectDir = makeTmpDir();
217
- try {
218
- writeRawConfig(getConfigPath(), JSON.stringify({
219
- semanticSearchMode: "auto",
220
- sources: [{ type: "filesystem", path: "/user-stash" }],
221
- }));
222
- writeRawConfig(path.join(projectDir, ".akm", "config.json"), JSON.stringify({
223
- stashInheritance: "replace",
224
- }));
225
- process.chdir(projectDir);
226
- expect(loadConfig().sources).toEqual([]);
227
- }
228
- finally {
229
- cleanup(projectDir);
230
- }
231
- });
232
- test("throws ConfigError when config contains an openviking-typed source", () => {
233
- writeRawConfig(getConfigPath(), JSON.stringify({
234
- sources: [{ type: "openviking", url: "https://ov.example.com", name: "my-ov" }],
235
- }));
236
- expect(() => loadConfig()).toThrow(ConfigError);
237
- expect(() => loadConfig()).toThrow("openviking is not supported in akm v1");
238
- expect(() => loadConfig()).toThrow("docs/migration/v1.md");
239
- });
240
- test("throws ConfigError with INVALID_CONFIG_FILE code for openviking source", () => {
241
- writeRawConfig(getConfigPath(), JSON.stringify({
242
- sources: [{ type: "openviking", url: "https://ov.example.com", name: "my-ov" }],
243
- }));
244
- try {
245
- loadConfig();
246
- throw new Error("Expected loadConfig to throw");
247
- }
248
- catch (err) {
249
- expect(err).toBeInstanceOf(ConfigError);
250
- expect(err.code).toBe("INVALID_CONFIG_FILE");
251
- }
252
- });
253
- test("ConfigError for openviking source carries actionable hint with source name", () => {
254
- writeRawConfig(getConfigPath(), JSON.stringify({
255
- sources: [{ type: "openviking", url: "https://ov.example.com", name: "my-ov" }],
256
- }));
257
- try {
258
- loadConfig();
259
- throw new Error("Expected loadConfig to throw");
260
- }
261
- catch (err) {
262
- expect(err).toBeInstanceOf(ConfigError);
263
- const hint = err.hint();
264
- expect(hint).toBeDefined();
265
- // QA #38: hint now uses real commands (akm remove, not akm config sources remove)
266
- expect(hint).toContain("my-ov");
267
- expect(hint).toContain("akm remove");
268
- }
269
- });
270
- test("throws ConfigError when config contains legacy stashes[]", () => {
271
- writeRawConfig(getConfigPath(), JSON.stringify({
272
- stashes: [{ type: "filesystem", path: "/legacy-stash" }],
273
- }));
274
- expect(() => loadConfig()).toThrow(ConfigError);
275
- expect(() => loadConfig()).toThrow("legacy `stashes[]` config key");
276
- });
277
- test("throws ConfigError when installed npm entry is marked writable", () => {
278
- writeRawConfig(getConfigPath(), JSON.stringify({
279
- installed: [
280
- {
281
- id: "npm:left-pad",
282
- source: "npm",
283
- ref: "npm:left-pad",
284
- artifactUrl: "https://registry.npmjs.org/left-pad/-/left-pad-1.3.0.tgz",
285
- stashRoot: "/tmp/left-pad",
286
- cacheDir: "/tmp/cache",
287
- installedAt: "2026-05-01T00:00:00.000Z",
288
- writable: true,
289
- },
290
- ],
291
- }));
292
- expect(() => loadConfig()).toThrow(ConfigError);
293
- expect(() => loadConfig()).toThrow("writable: true is only supported on filesystem and git sources");
294
- });
295
- test("recomputes merged config when cwd changes", () => {
296
- const firstProject = makeTmpDir();
297
- const secondProject = makeTmpDir();
298
- try {
299
- writeRawConfig(path.join(firstProject, ".akm", "config.json"), JSON.stringify({ sources: [{ type: "filesystem", path: "/first-project-stash" }] }));
300
- writeRawConfig(path.join(secondProject, ".akm", "config.json"), JSON.stringify({ sources: [{ type: "filesystem", path: "/second-project-stash" }] }));
301
- process.chdir(firstProject);
302
- expect(loadConfig().sources).toEqual([{ type: "filesystem", path: "/first-project-stash" }]);
303
- // Intentionally do not reset the cache here; loadConfig() should notice
304
- // the cwd change because the discovered project config path set changes.
305
- process.chdir(secondProject);
306
- expect(loadConfig().sources).toEqual([{ type: "filesystem", path: "/second-project-stash" }]);
307
- }
308
- finally {
309
- cleanup(firstProject);
310
- cleanup(secondProject);
311
- }
312
- });
313
- });
314
- // ── saveConfig ──────────────────────────────────────────────────────────────
315
- describe("saveConfig", () => {
316
- test("writes formatted JSON to config.json", () => {
317
- const config = { semanticSearchMode: "off", sources: [{ type: "filesystem", path: "/extra" }] };
318
- saveConfig(config);
319
- const raw = fs.readFileSync(getConfigPath(), "utf8");
320
- expect(JSON.parse(raw)).toEqual(config);
321
- expect(raw).toContain(" ");
322
- expect(raw.endsWith("\n")).toBe(true);
323
- });
324
- test("roundtrips with loadConfig", () => {
325
- const config = {
326
- semanticSearchMode: "off",
327
- sources: [
328
- { type: "filesystem", path: "/a" },
329
- { type: "filesystem", path: "/b" },
330
- ],
331
- };
332
- saveConfig(config);
333
- const loaded = loadConfig();
334
- expect(loaded.semanticSearchMode).toBe("off");
335
- expect(loaded.sources).toEqual([
336
- { type: "filesystem", path: "/a" },
337
- { type: "filesystem", path: "/b" },
338
- ]);
339
- expect(loaded.output).toEqual({ format: "json", detail: "brief" });
340
- });
341
- test("roundtrips output config", () => {
342
- const config = {
343
- semanticSearchMode: "off",
344
- sources: [{ type: "filesystem", path: "/a" }],
345
- output: { format: "yaml", detail: "full" },
346
- };
347
- saveConfig(config);
348
- expect(loadConfig().output).toEqual(config.output);
349
- });
350
- });
351
- // ── updateConfig ────────────────────────────────────────────────────────────
352
- describe("updateConfig", () => {
353
- test("merges partial update over existing config", () => {
354
- saveConfig({ semanticSearchMode: "auto", sources: [{ type: "filesystem", path: "/a" }] });
355
- const updated = updateConfig({ semanticSearchMode: "off" });
356
- expect(updated.semanticSearchMode).toBe("off");
357
- expect(updated.sources).toEqual([{ type: "filesystem", path: "/a" }]);
358
- expect(loadConfig()).toEqual(updated);
359
- });
360
- test("creates config.json if it does not exist", () => {
361
- const updated = updateConfig({ semanticSearchMode: "off" });
362
- expect(updated.semanticSearchMode).toBe("off");
363
- expect(updated.sources).toBeUndefined();
364
- expect(updated.output).toEqual({ format: "json", detail: "brief" });
365
- expect(fs.existsSync(getConfigPath())).toBe(true);
366
- });
367
- test("writes only user config when project config is present", () => {
368
- const projectDir = makeTmpDir();
369
- try {
370
- writeRawConfig(path.join(projectDir, ".akm", "config.json"), JSON.stringify({ sources: [{ type: "filesystem", path: "/project-stash" }] }));
371
- process.chdir(projectDir);
372
- updateConfig({ semanticSearchMode: "off" });
373
- expect(loadConfig().sources).toEqual([{ type: "filesystem", path: "/project-stash" }]);
374
- expect(loadUserConfig().sources).toBeUndefined();
375
- expect(JSON.parse(fs.readFileSync(getConfigPath(), "utf8"))).not.toHaveProperty("stashes");
376
- expect(loadUserConfig().semanticSearchMode).toBe("off");
377
- }
378
- finally {
379
- cleanup(projectDir);
380
- }
381
- });
382
- });
383
- describe("output config", () => {
384
- test("loads valid output config", () => {
385
- writeRawConfig(getConfigPath(), JSON.stringify({ output: { format: "text", detail: "full" } }));
386
- expect(loadConfig().output).toEqual({ format: "text", detail: "full" });
387
- });
388
- test("ignores invalid output config values", () => {
389
- writeRawConfig(getConfigPath(), JSON.stringify({ output: { format: "xml", detail: "max" } }));
390
- expect(loadConfig().output).toEqual({ format: "json", detail: "brief" });
391
- });
392
- });
393
- // ── embedding config ────────────────────────────────────────────────────────
394
- describe("embedding config", () => {
395
- test("loads embedding connection config", () => {
396
- writeRawConfig(getConfigPath(), JSON.stringify({
397
- embedding: {
398
- endpoint: "http://localhost:11434/v1/embeddings",
399
- model: "nomic-embed-text",
400
- },
401
- }));
402
- expect(loadConfig().embedding).toEqual({
403
- endpoint: "http://localhost:11434/v1/embeddings",
404
- model: "nomic-embed-text",
405
- });
406
- });
407
- test("loads embedding config with apiKey", () => {
408
- writeRawConfig(getConfigPath(), JSON.stringify({
409
- embedding: {
410
- endpoint: "https://api.openai.com/v1/embeddings",
411
- model: "text-embedding-3-small",
412
- apiKey: "sk-test123",
413
- },
414
- }));
415
- expect(loadConfig().embedding?.apiKey).toBe("sk-test123");
416
- });
417
- test("loads embedding config with provider and dimension", () => {
418
- writeRawConfig(getConfigPath(), JSON.stringify({
419
- embedding: {
420
- provider: "openai",
421
- endpoint: "https://api.openai.com/v1/embeddings",
422
- model: "text-embedding-3-small",
423
- dimension: 384,
424
- },
425
- }));
426
- expect(loadConfig().embedding).toEqual({
427
- provider: "openai",
428
- endpoint: "https://api.openai.com/v1/embeddings",
429
- model: "text-embedding-3-small",
430
- dimension: 384,
431
- });
432
- });
433
- test("ignores invalid embedding config (missing model)", () => {
434
- writeRawConfig(getConfigPath(), JSON.stringify({ embedding: { endpoint: "http://localhost:11434" } }));
435
- expect(loadConfig().embedding).toBeUndefined();
436
- });
437
- test("ignores invalid embedding config with non-integer dimension", () => {
438
- writeRawConfig(getConfigPath(), JSON.stringify({
439
- embedding: {
440
- endpoint: "https://api.openai.com/v1/embeddings",
441
- model: "text-embedding-3-small",
442
- dimension: 384.5,
443
- },
444
- }));
445
- expect(loadConfig().embedding).toBeUndefined();
446
- });
447
- test("ignores non-object embedding config", () => {
448
- writeRawConfig(getConfigPath(), JSON.stringify({ embedding: "not-an-object" }));
449
- expect(loadConfig().embedding).toBeUndefined();
450
- });
451
- test("defaults to no embedding config", () => {
452
- expect(loadConfig().embedding).toBeUndefined();
453
- });
454
- test("roundtrips embedding config via updateConfig", () => {
455
- const embeddingConfig = {
456
- endpoint: "http://localhost:11434/v1/embeddings",
457
- model: "nomic-embed-text",
458
- };
459
- updateConfig({ embedding: embeddingConfig });
460
- expect(loadConfig().embedding).toEqual(embeddingConfig);
461
- });
462
- test("clears embedding config with undefined", () => {
463
- const embeddingConfig = {
464
- endpoint: "http://localhost:11434/v1/embeddings",
465
- model: "nomic-embed-text",
466
- };
467
- updateConfig({ embedding: embeddingConfig });
468
- updateConfig({ embedding: undefined });
469
- expect(loadConfig().embedding).toBeUndefined();
470
- });
471
- });
472
- // ── llm config ──────────────────────────────────────────────────────────────
473
- describe("llm config", () => {
474
- test("loads llm connection config", () => {
475
- writeRawConfig(getConfigPath(), JSON.stringify({
476
- llm: {
477
- endpoint: "http://localhost:11434/v1/chat/completions",
478
- model: "llama3.2",
479
- },
480
- }));
481
- expect(loadConfig().llm).toEqual({
482
- endpoint: "http://localhost:11434/v1/chat/completions",
483
- model: "llama3.2",
484
- });
485
- });
486
- test("loads llm config with apiKey", () => {
487
- writeRawConfig(getConfigPath(), JSON.stringify({
488
- llm: {
489
- endpoint: "https://api.openai.com/v1/chat/completions",
490
- model: "gpt-4",
491
- apiKey: "sk-key",
492
- },
493
- }));
494
- expect(loadConfig().llm?.apiKey).toBe("sk-key");
495
- });
496
- test("loads llm config with provider, temperature, and maxTokens", () => {
497
- writeRawConfig(getConfigPath(), JSON.stringify({
498
- llm: {
499
- provider: "openai",
500
- endpoint: "https://api.openai.com/v1/chat/completions",
501
- model: "gpt-4o-mini",
502
- temperature: 0.6,
503
- maxTokens: 256,
504
- },
505
- }));
506
- expect(loadConfig().llm).toEqual({
507
- provider: "openai",
508
- endpoint: "https://api.openai.com/v1/chat/completions",
509
- model: "gpt-4o-mini",
510
- temperature: 0.6,
511
- maxTokens: 256,
512
- });
513
- });
514
- test("accepts llm config with endpoint and empty model (subkey-set partial)", () => {
515
- // After QA #36, `akm config set llm.endpoint <url>` persists a partial
516
- // llm config with `model: ""`. The loader must accept this so the value
517
- // round-trips; downstream callers decide if it's usable.
518
- writeRawConfig(getConfigPath(), JSON.stringify({ llm: { endpoint: "http://localhost" } }));
519
- expect(loadConfig().llm).toEqual({ endpoint: "http://localhost", model: "" });
520
- });
521
- test("ignores llm config with non-integer maxTokens", () => {
522
- writeRawConfig(getConfigPath(), JSON.stringify({
523
- llm: {
524
- endpoint: "https://api.openai.com/v1/chat/completions",
525
- model: "gpt-4o-mini",
526
- maxTokens: 256.5,
527
- },
528
- }));
529
- expect(loadConfig().llm).toBeUndefined();
530
- });
531
- test("roundtrips llm config via updateConfig", () => {
532
- const llmConfig = {
533
- endpoint: "http://localhost:11434/v1/chat/completions",
534
- model: "llama3.2",
535
- };
536
- updateConfig({ llm: llmConfig });
537
- expect(loadConfig().llm).toEqual(llmConfig);
538
- });
539
- });
540
- // ── stashDir config ──────────────────────────────────────────────────────────
541
- describe("stashDir config", () => {
542
- test("loads stashDir from config.json", () => {
543
- writeRawConfig(getConfigPath(), JSON.stringify({ stashDir: "/home/user/my-stash" }));
544
- expect(loadConfig().stashDir).toBe("/home/user/my-stash");
545
- });
546
- test("stashDir is undefined by default", () => {
547
- expect(loadConfig().stashDir).toBeUndefined();
548
- });
549
- test("roundtrips stashDir via updateConfig", () => {
550
- updateConfig({ stashDir: "/custom/stash" });
551
- expect(loadConfig().stashDir).toBe("/custom/stash");
552
- });
553
- test("saves and preserves stashDir", () => {
554
- const config = { semanticSearchMode: "auto", stashDir: "/my/stash" };
555
- saveConfig(config);
556
- const raw = fs.readFileSync(getConfigPath(), "utf8");
557
- const parsed = JSON.parse(raw);
558
- expect(parsed.stashDir).toBe("/my/stash");
559
- expect(loadConfig().stashDir).toBe("/my/stash");
560
- });
561
- test("ignores non-string stashDir", () => {
562
- writeRawConfig(getConfigPath(), JSON.stringify({ stashDir: 42 }));
563
- expect(loadConfig().stashDir).toBeUndefined();
564
- });
565
- test("ignores empty stashDir", () => {
566
- writeRawConfig(getConfigPath(), JSON.stringify({ stashDir: " " }));
567
- expect(loadConfig().stashDir).toBeUndefined();
568
- });
569
- });
@@ -1,43 +0,0 @@
1
- import { describe, expect, test } from "bun:test";
2
- import { extractSection, MIGRATION_PATH, readDoc } from "./spec-helpers";
3
- // Pins docs/migration/v1.md — pre-release migration baseline.
4
- //
5
- // The migration page must describe the delta from the current pre-release
6
- // to v1.0, not the older 0.5 → 0.6 refactor narrative. This test fails if
7
- // the page reverts to the old framing.
8
- describe("docs/migration/v1.md — pre-release migration baseline", () => {
9
- const doc = readDoc(MIGRATION_PATH);
10
- test("audience is pre-release users, not 0.5.x users", () => {
11
- expect(doc).toMatch(/0\.6\.x or 0\.7\.x \*\*pre-release\*\*/);
12
- });
13
- test("delta table names every locked planned-for-v1 surface", () => {
14
- expect(doc).toContain("`agent.*`");
15
- expect(doc).toContain("`llm.features.*`");
16
- expect(doc).toContain("`lesson`");
17
- expect(doc).toContain("Proposal queue");
18
- });
19
- test("describes the proposal queue as durable filesystem state under .akm/proposals/", () => {
20
- expect(doc).toContain("<stashRoot>/.akm/proposals/");
21
- expect(doc).toContain("proposal.json");
22
- });
23
- test("calls out the registry `curated` removal as a planned change", () => {
24
- const section = extractSection(doc, "## Planned for v1 — registry `curated` removed");
25
- expect(section).not.toBe("");
26
- expect(section).toMatch(/parses and silently ignores/);
27
- });
28
- test("locked decisions list includes the planned quality and boundary rules", () => {
29
- const tldr = extractSection(doc, "## TL;DR — locked decisions for v1");
30
- expect(tldr).not.toBe("");
31
- expect(tldr).toContain('quality: "proposed"');
32
- expect(tldr).toContain("CLI shell-out only");
33
- });
34
- test("does NOT lead with the historical 0.5 → 0.6 baseline", () => {
35
- // Sanity: the page should orient new readers around the pre-release
36
- // delta, not the old refactor narrative. The first H1 must be the v1
37
- // migration page.
38
- const firstHeading = doc.match(/^# .*$/m);
39
- expect(firstHeading?.[0]).toBe("# Migrating to akm v1");
40
- // The opening blockquote must point readers on 0.5.x to the older guide.
41
- expect(doc).toMatch(/v0\.5-to-v0\.6\.md/);
42
- });
43
- });