akm-cli 0.7.0-rc1 → 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 (314) hide show
  1. package/dist/{src/cli.js → cli.js} +100 -16
  2. package/dist/{src/commands → commands}/config-cli.js +42 -0
  3. package/dist/{src/commands → commands}/history.js +78 -7
  4. package/dist/{src/commands → commands}/registry-search.js +69 -6
  5. package/dist/{src/commands → commands}/search.js +30 -3
  6. package/dist/{src/commands → commands}/show.js +29 -0
  7. package/dist/{src/commands → commands}/source-add.js +5 -1
  8. package/dist/{src/commands → commands}/source-manage.js +7 -1
  9. package/dist/{src/core → core}/config.js +28 -0
  10. package/dist/{src/indexer → indexer}/db-search.js +1 -0
  11. package/dist/{src/indexer → indexer}/indexer.js +16 -2
  12. package/dist/{src/indexer → indexer}/matchers.js +1 -1
  13. package/dist/{src/indexer → indexer}/search-source.js +4 -2
  14. package/dist/{src/integrations → integrations}/agent/profiles.js +1 -1
  15. package/dist/{src/integrations → integrations}/agent/spawn.js +67 -16
  16. package/dist/{src/integrations → integrations}/github.js +9 -3
  17. package/dist/{src/llm → llm}/embedders/remote.js +37 -3
  18. package/dist/{src/output → output}/cli-hints.js +15 -2
  19. package/dist/{src/output → output}/renderers.js +3 -1
  20. package/dist/{src/output → output}/shapes.js +8 -1
  21. package/dist/{src/output → output}/text.js +156 -3
  22. package/dist/{src/registry → registry}/build-index.js +5 -4
  23. package/dist/{src/registry → registry}/providers/static-index.js +3 -1
  24. package/dist/{src/setup → setup}/setup.js +9 -0
  25. package/dist/{src/wiki → wiki}/wiki.js +54 -6
  26. package/dist/{src/workflows → workflows}/runs.js +37 -3
  27. package/package.json +8 -8
  28. package/dist/tests/add-website-source.test.js +0 -119
  29. package/dist/tests/agent/agent-config-loader.test.js +0 -70
  30. package/dist/tests/agent/agent-config.test.js +0 -221
  31. package/dist/tests/agent/agent-detect.test.js +0 -100
  32. package/dist/tests/agent/agent-spawn.test.js +0 -234
  33. package/dist/tests/agent-output.test.js +0 -186
  34. package/dist/tests/architecture/agent-no-llm-sdk-guard.test.js +0 -103
  35. package/dist/tests/architecture/agent-spawn-seam.test.js +0 -193
  36. package/dist/tests/architecture/llm-stateless-seam.test.js +0 -112
  37. package/dist/tests/asset-ref.test.js +0 -192
  38. package/dist/tests/asset-registry.test.js +0 -103
  39. package/dist/tests/asset-spec.test.js +0 -241
  40. package/dist/tests/bench/attribution.test.js +0 -995
  41. package/dist/tests/bench/cleanup-sigint.test.js +0 -83
  42. package/dist/tests/bench/cleanup.js +0 -203
  43. package/dist/tests/bench/cleanup.test.js +0 -166
  44. package/dist/tests/bench/cli.js +0 -683
  45. package/dist/tests/bench/cli.test.js +0 -177
  46. package/dist/tests/bench/compare.test.js +0 -556
  47. package/dist/tests/bench/corpus.js +0 -314
  48. package/dist/tests/bench/corpus.test.js +0 -258
  49. package/dist/tests/bench/driver.js +0 -346
  50. package/dist/tests/bench/driver.test.js +0 -443
  51. package/dist/tests/bench/evolve-metrics.js +0 -179
  52. package/dist/tests/bench/evolve-metrics.test.js +0 -187
  53. package/dist/tests/bench/evolve.js +0 -580
  54. package/dist/tests/bench/evolve.test.js +0 -616
  55. package/dist/tests/bench/failure-modes.test.js +0 -300
  56. package/dist/tests/bench/feedback-integrity.test.js +0 -456
  57. package/dist/tests/bench/leakage.test.js +0 -125
  58. package/dist/tests/bench/learning-curve.test.js +0 -133
  59. package/dist/tests/bench/metrics.js +0 -2319
  60. package/dist/tests/bench/metrics.test.js +0 -1144
  61. package/dist/tests/bench/no-os-tmpdir-invariant.test.js +0 -43
  62. package/dist/tests/bench/report.js +0 -1821
  63. package/dist/tests/bench/report.test.js +0 -989
  64. package/dist/tests/bench/runner.js +0 -536
  65. package/dist/tests/bench/runner.test.js +0 -958
  66. package/dist/tests/bench/search-bridge.test.js +0 -331
  67. package/dist/tests/bench/tmp.js +0 -41
  68. package/dist/tests/bench/trajectory.js +0 -116
  69. package/dist/tests/bench/trajectory.test.js +0 -127
  70. package/dist/tests/bench/verifier.js +0 -109
  71. package/dist/tests/bench/verifier.test.js +0 -118
  72. package/dist/tests/bench/workflow-evaluator.js +0 -557
  73. package/dist/tests/bench/workflow-evaluator.test.js +0 -421
  74. package/dist/tests/bench/workflow-spec.js +0 -358
  75. package/dist/tests/bench/workflow-spec.test.js +0 -363
  76. package/dist/tests/bench/workflow-trace.js +0 -438
  77. package/dist/tests/bench/workflow-trace.test.js +0 -254
  78. package/dist/tests/benchmark-search-quality.js +0 -536
  79. package/dist/tests/benchmark-suite.js +0 -1441
  80. package/dist/tests/capture-cli.test.js +0 -112
  81. package/dist/tests/cli-errors.test.js +0 -203
  82. package/dist/tests/commands/events.test.js +0 -370
  83. package/dist/tests/commands/history.test.js +0 -223
  84. package/dist/tests/commands/import.test.js +0 -103
  85. package/dist/tests/commands/proposal-cli.test.js +0 -209
  86. package/dist/tests/commands/reflect-propose-cli.test.js +0 -333
  87. package/dist/tests/commands/remember.test.js +0 -97
  88. package/dist/tests/commands/scope-flags.test.js +0 -300
  89. package/dist/tests/commands/search.test.js +0 -537
  90. package/dist/tests/commands/show-indexer-parity.test.js +0 -117
  91. package/dist/tests/commands/show.test.js +0 -294
  92. package/dist/tests/common.test.js +0 -266
  93. package/dist/tests/completions.test.js +0 -142
  94. package/dist/tests/config-cli.test.js +0 -193
  95. package/dist/tests/config-llm-features.test.js +0 -139
  96. package/dist/tests/config.test.js +0 -544
  97. package/dist/tests/contracts/migration-baseline.test.js +0 -43
  98. package/dist/tests/contracts/reflect-propose-envelope.test.js +0 -139
  99. package/dist/tests/contracts/spec-helpers.js +0 -46
  100. package/dist/tests/contracts/v1-spec-section-11-proposal-queue.test.js +0 -228
  101. package/dist/tests/contracts/v1-spec-section-12-agent-config.test.js +0 -56
  102. package/dist/tests/contracts/v1-spec-section-13-lesson-type.test.js +0 -34
  103. package/dist/tests/contracts/v1-spec-section-14-llm-features.test.js +0 -94
  104. package/dist/tests/contracts/v1-spec-section-4-1-asset-types.test.js +0 -39
  105. package/dist/tests/contracts/v1-spec-section-4-2-quality-rules.test.js +0 -44
  106. package/dist/tests/contracts/v1-spec-section-5-configuration.test.js +0 -47
  107. package/dist/tests/contracts/v1-spec-section-6-orchestration.test.js +0 -40
  108. package/dist/tests/contracts/v1-spec-section-7-module-layout.test.js +0 -58
  109. package/dist/tests/contracts/v1-spec-section-8-extension-points.test.js +0 -34
  110. package/dist/tests/contracts/v1-spec-section-9-4-cli-surface.test.js +0 -75
  111. package/dist/tests/contracts/v1-spec-section-9-7-llm-agent-boundary.test.js +0 -36
  112. package/dist/tests/core/write-source.test.js +0 -366
  113. package/dist/tests/curate-command.test.js +0 -87
  114. package/dist/tests/db-scoring.test.js +0 -201
  115. package/dist/tests/db.test.js +0 -654
  116. package/dist/tests/distill-cli-flag.test.js +0 -208
  117. package/dist/tests/distill.test.js +0 -515
  118. package/dist/tests/docker-install.test.js +0 -120
  119. package/dist/tests/e2e.test.js +0 -1398
  120. package/dist/tests/embedder.test.js +0 -340
  121. package/dist/tests/embedding-model-config.test.js +0 -379
  122. package/dist/tests/feedback-command.test.js +0 -172
  123. package/dist/tests/file-context.test.js +0 -552
  124. package/dist/tests/fixtures/scripts/git/summarize-diff.js +0 -9
  125. package/dist/tests/fixtures/scripts/lint/eslint-check.js +0 -7
  126. package/dist/tests/fixtures/stashes/load.js +0 -166
  127. package/dist/tests/fixtures/stashes/load.test.js +0 -88
  128. package/dist/tests/fixtures/stashes/ranking-baseline/scripts/mem0-search.js +0 -12
  129. package/dist/tests/frontmatter.test.js +0 -190
  130. package/dist/tests/fts-field-weighting.test.js +0 -254
  131. package/dist/tests/fuzzy-search.test.js +0 -230
  132. package/dist/tests/git-provider-clone.test.js +0 -45
  133. package/dist/tests/github.test.js +0 -161
  134. package/dist/tests/graph-boost-ranking.test.js +0 -305
  135. package/dist/tests/graph-extraction.test.js +0 -282
  136. package/dist/tests/helpers/usage-events.js +0 -8
  137. package/dist/tests/index-pass-llm.test.js +0 -161
  138. package/dist/tests/indexer.test.js +0 -559
  139. package/dist/tests/info-command.test.js +0 -166
  140. package/dist/tests/init.test.js +0 -69
  141. package/dist/tests/install-script.test.js +0 -246
  142. package/dist/tests/integration/agent-real-profile.test.js +0 -94
  143. package/dist/tests/issue-36-repro.test.js +0 -304
  144. package/dist/tests/issues-191-194.test.js +0 -160
  145. package/dist/tests/lesson-lint.test.js +0 -111
  146. package/dist/tests/llm-client.test.js +0 -115
  147. package/dist/tests/llm-feature-gate.test.js +0 -151
  148. package/dist/tests/llm.test.js +0 -139
  149. package/dist/tests/lockfile.test.js +0 -216
  150. package/dist/tests/manifest.test.js +0 -205
  151. package/dist/tests/markdown.test.js +0 -126
  152. package/dist/tests/matchers-unit.test.js +0 -189
  153. package/dist/tests/memory-inference.test.js +0 -299
  154. package/dist/tests/merge-scoring.test.js +0 -136
  155. package/dist/tests/metadata.test.js +0 -313
  156. package/dist/tests/migration-help.test.js +0 -89
  157. package/dist/tests/origin-resolve.test.js +0 -124
  158. package/dist/tests/output-baseline.test.js +0 -217
  159. package/dist/tests/output-shapes-unit.test.js +0 -476
  160. package/dist/tests/parallel-search.test.js +0 -272
  161. package/dist/tests/parameter-metadata.test.js +0 -365
  162. package/dist/tests/paths.test.js +0 -177
  163. package/dist/tests/progressive-disclosure.test.js +0 -280
  164. package/dist/tests/proposals.test.js +0 -279
  165. package/dist/tests/proposed-quality.test.js +0 -271
  166. package/dist/tests/provider-registry.test.js +0 -32
  167. package/dist/tests/ranking-regression.test.js +0 -548
  168. package/dist/tests/reflect-propose.test.js +0 -455
  169. package/dist/tests/registry-build-index.test.js +0 -378
  170. package/dist/tests/registry-cli.test.js +0 -290
  171. package/dist/tests/registry-index-v2.test.js +0 -430
  172. package/dist/tests/registry-install.test.js +0 -728
  173. package/dist/tests/registry-providers/parity.test.js +0 -189
  174. package/dist/tests/registry-providers/skills-sh.test.js +0 -309
  175. package/dist/tests/registry-providers/static-index.test.js +0 -204
  176. package/dist/tests/registry-resolve.test.js +0 -126
  177. package/dist/tests/registry-search.test.js +0 -723
  178. package/dist/tests/remember-frontmatter.test.js +0 -380
  179. package/dist/tests/remember-unit.test.js +0 -123
  180. package/dist/tests/ripgrep-install.test.js +0 -251
  181. package/dist/tests/ripgrep-resolve.test.js +0 -108
  182. package/dist/tests/ripgrep.test.js +0 -163
  183. package/dist/tests/save-command.test.js +0 -94
  184. package/dist/tests/save-trust-qa-fixes.test.js +0 -270
  185. package/dist/tests/scoring-pipeline.test.js +0 -648
  186. package/dist/tests/search-include-proposed-cli.test.js +0 -118
  187. package/dist/tests/self-update.test.js +0 -442
  188. package/dist/tests/semantic-search-e2e.test.js +0 -512
  189. package/dist/tests/semantic-status.test.js +0 -471
  190. package/dist/tests/setup-run.integration.js +0 -877
  191. package/dist/tests/setup-wizard.test.js +0 -198
  192. package/dist/tests/setup.test.js +0 -131
  193. package/dist/tests/source-add.test.js +0 -11
  194. package/dist/tests/source-clone.test.js +0 -254
  195. package/dist/tests/source-manage.test.js +0 -366
  196. package/dist/tests/source-providers/filesystem.test.js +0 -82
  197. package/dist/tests/source-providers/git.test.js +0 -252
  198. package/dist/tests/source-providers/website.test.js +0 -128
  199. package/dist/tests/source-qa-fixes.test.js +0 -268
  200. package/dist/tests/source-registry.test.js +0 -350
  201. package/dist/tests/source-resolve.test.js +0 -100
  202. package/dist/tests/source-source.test.js +0 -221
  203. package/dist/tests/source.test.js +0 -533
  204. package/dist/tests/tar-utils-scan.test.js +0 -73
  205. package/dist/tests/toggle-components.test.js +0 -73
  206. package/dist/tests/usage-telemetry.test.js +0 -265
  207. package/dist/tests/utility-scoring.test.js +0 -558
  208. package/dist/tests/vault-load-error.test.js +0 -78
  209. package/dist/tests/vault-qa-fixes.test.js +0 -194
  210. package/dist/tests/vault.test.js +0 -429
  211. package/dist/tests/vector-search.test.js +0 -608
  212. package/dist/tests/walker.test.js +0 -252
  213. package/dist/tests/wave2-cluster-bc.test.js +0 -228
  214. package/dist/tests/wave2-cluster-d.test.js +0 -180
  215. package/dist/tests/wave2-cluster-e.test.js +0 -179
  216. package/dist/tests/wiki-qa-fixes.test.js +0 -270
  217. package/dist/tests/wiki.test.js +0 -529
  218. package/dist/tests/workflow-cli.test.js +0 -271
  219. package/dist/tests/workflow-markdown.test.js +0 -171
  220. package/dist/tests/workflow-path-escape.test.js +0 -132
  221. package/dist/tests/workflow-qa-fixes.test.js +0 -377
  222. package/dist/tests/workflows/indexer-rejection.test.js +0 -213
  223. /package/dist/{src/commands → commands}/completions.js +0 -0
  224. /package/dist/{src/commands → commands}/curate.js +0 -0
  225. /package/dist/{src/commands → commands}/distill.js +0 -0
  226. /package/dist/{src/commands → commands}/events.js +0 -0
  227. /package/dist/{src/commands → commands}/info.js +0 -0
  228. /package/dist/{src/commands → commands}/init.js +0 -0
  229. /package/dist/{src/commands → commands}/install-audit.js +0 -0
  230. /package/dist/{src/commands → commands}/installed-stashes.js +0 -0
  231. /package/dist/{src/commands → commands}/migration-help.js +0 -0
  232. /package/dist/{src/commands → commands}/proposal.js +0 -0
  233. /package/dist/{src/commands → commands}/propose.js +0 -0
  234. /package/dist/{src/commands → commands}/reflect.js +0 -0
  235. /package/dist/{src/commands → commands}/remember.js +0 -0
  236. /package/dist/{src/commands → commands}/self-update.js +0 -0
  237. /package/dist/{src/commands → commands}/source-clone.js +0 -0
  238. /package/dist/{src/commands → commands}/vault.js +0 -0
  239. /package/dist/{src/core → core}/asset-ref.js +0 -0
  240. /package/dist/{src/core → core}/asset-registry.js +0 -0
  241. /package/dist/{src/core → core}/asset-spec.js +0 -0
  242. /package/dist/{src/core → core}/common.js +0 -0
  243. /package/dist/{src/core → core}/errors.js +0 -0
  244. /package/dist/{src/core → core}/events.js +0 -0
  245. /package/dist/{src/core → core}/frontmatter.js +0 -0
  246. /package/dist/{src/core → core}/lesson-lint.js +0 -0
  247. /package/dist/{src/core → core}/markdown.js +0 -0
  248. /package/dist/{src/core → core}/paths.js +0 -0
  249. /package/dist/{src/core → core}/proposals.js +0 -0
  250. /package/dist/{src/core → core}/warn.js +0 -0
  251. /package/dist/{src/core → core}/write-source.js +0 -0
  252. /package/dist/{src/indexer → indexer}/db.js +0 -0
  253. /package/dist/{src/indexer → indexer}/file-context.js +0 -0
  254. /package/dist/{src/indexer → indexer}/graph-boost.js +0 -0
  255. /package/dist/{src/indexer → indexer}/graph-extraction.js +0 -0
  256. /package/dist/{src/indexer → indexer}/manifest.js +0 -0
  257. /package/dist/{src/indexer → indexer}/memory-inference.js +0 -0
  258. /package/dist/{src/indexer → indexer}/metadata.js +0 -0
  259. /package/dist/{src/indexer → indexer}/search-fields.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/prompts.js +0 -0
  267. /package/dist/{src/integrations → integrations}/lockfile.js +0 -0
  268. /package/dist/{src/llm → llm}/client.js +0 -0
  269. /package/dist/{src/llm → llm}/embedder.js +0 -0
  270. /package/dist/{src/llm → llm}/embedders/cache.js +0 -0
  271. /package/dist/{src/llm → llm}/embedders/local.js +0 -0
  272. /package/dist/{src/llm → llm}/embedders/types.js +0 -0
  273. /package/dist/{src/llm → llm}/feature-gate.js +0 -0
  274. /package/dist/{src/llm → llm}/graph-extract.js +0 -0
  275. /package/dist/{src/llm → llm}/index-passes.js +0 -0
  276. /package/dist/{src/llm → llm}/memory-infer.js +0 -0
  277. /package/dist/{src/llm → llm}/metadata-enhance.js +0 -0
  278. /package/dist/{src/output → output}/context.js +0 -0
  279. /package/dist/{src/registry → registry}/create-provider-registry.js +0 -0
  280. /package/dist/{src/registry → registry}/factory.js +0 -0
  281. /package/dist/{src/registry → registry}/origin-resolve.js +0 -0
  282. /package/dist/{src/registry → registry}/providers/index.js +0 -0
  283. /package/dist/{src/registry → registry}/providers/skills-sh.js +0 -0
  284. /package/dist/{src/registry → registry}/providers/types.js +0 -0
  285. /package/dist/{src/registry → registry}/resolve.js +0 -0
  286. /package/dist/{src/registry → registry}/types.js +0 -0
  287. /package/dist/{src/setup → setup}/detect.js +0 -0
  288. /package/dist/{src/setup → setup}/ripgrep-install.js +0 -0
  289. /package/dist/{src/setup → setup}/ripgrep-resolve.js +0 -0
  290. /package/dist/{src/setup → setup}/steps.js +0 -0
  291. /package/dist/{src/sources → sources}/include.js +0 -0
  292. /package/dist/{src/sources → sources}/provider-factory.js +0 -0
  293. /package/dist/{src/sources → sources}/provider.js +0 -0
  294. /package/dist/{src/sources → sources}/providers/filesystem.js +0 -0
  295. /package/dist/{src/sources → sources}/providers/git.js +0 -0
  296. /package/dist/{src/sources → sources}/providers/index.js +0 -0
  297. /package/dist/{src/sources → sources}/providers/install-types.js +0 -0
  298. /package/dist/{src/sources → sources}/providers/npm.js +0 -0
  299. /package/dist/{src/sources → sources}/providers/provider-utils.js +0 -0
  300. /package/dist/{src/sources → sources}/providers/sync-from-ref.js +0 -0
  301. /package/dist/{src/sources → sources}/providers/tar-utils.js +0 -0
  302. /package/dist/{src/sources → sources}/providers/website.js +0 -0
  303. /package/dist/{src/sources → sources}/resolve.js +0 -0
  304. /package/dist/{src/sources → sources}/types.js +0 -0
  305. /package/dist/{src/templates → templates}/wiki-templates.js +0 -0
  306. /package/dist/{src/version.js → version.js} +0 -0
  307. /package/dist/{src/workflows → workflows}/authoring.js +0 -0
  308. /package/dist/{src/workflows → workflows}/cli.js +0 -0
  309. /package/dist/{src/workflows → workflows}/db.js +0 -0
  310. /package/dist/{src/workflows → workflows}/document-cache.js +0 -0
  311. /package/dist/{src/workflows → workflows}/parser.js +0 -0
  312. /package/dist/{src/workflows → workflows}/renderer.js +0 -0
  313. /package/dist/{src/workflows → workflows}/schema.js +0 -0
  314. /package/dist/{src/workflows → workflows}/validator.js +0 -0
@@ -1,118 +0,0 @@
1
- /**
2
- * `akm search --include-proposed` CLI integration test (#284 GAP-HIGH 9).
3
- *
4
- * Spawns the real CLI against an indexed stash that contains both a
5
- * `quality: stable` and a `quality: proposed` skill, and asserts that:
6
- * - default search excludes the proposed entry,
7
- * - `--include-proposed` retains it in the hits list.
8
- */
9
- import { afterEach, describe, expect, test } from "bun:test";
10
- import { spawnSync } from "node:child_process";
11
- import fs from "node:fs";
12
- import os from "node:os";
13
- import path from "node:path";
14
- import { saveConfig } from "../src/core/config";
15
- import { akmIndex } from "../src/indexer/indexer";
16
- const tempDirs = [];
17
- const savedEnv = {
18
- AKM_STASH_DIR: process.env.AKM_STASH_DIR,
19
- XDG_CACHE_HOME: process.env.XDG_CACHE_HOME,
20
- XDG_CONFIG_HOME: process.env.XDG_CONFIG_HOME,
21
- };
22
- function makeTempDir(prefix) {
23
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
24
- tempDirs.push(dir);
25
- return dir;
26
- }
27
- function writeFile(filePath, content) {
28
- fs.mkdirSync(path.dirname(filePath), { recursive: true });
29
- fs.writeFileSync(filePath, content);
30
- }
31
- const CLI = path.join(__dirname, "..", "src", "cli.ts");
32
- function runCli(args, stashDir) {
33
- const result = spawnSync("bun", [CLI, ...args], {
34
- encoding: "utf8",
35
- timeout: 30_000,
36
- env: {
37
- ...process.env,
38
- AKM_STASH_DIR: stashDir,
39
- XDG_CACHE_HOME: process.env.XDG_CACHE_HOME,
40
- XDG_CONFIG_HOME: process.env.XDG_CONFIG_HOME,
41
- },
42
- });
43
- return {
44
- stdout: result.stdout ?? "",
45
- stderr: result.stderr ?? "",
46
- status: result.status ?? -1,
47
- };
48
- }
49
- afterEach(() => {
50
- if (savedEnv.AKM_STASH_DIR === undefined)
51
- delete process.env.AKM_STASH_DIR;
52
- else
53
- process.env.AKM_STASH_DIR = savedEnv.AKM_STASH_DIR;
54
- if (savedEnv.XDG_CACHE_HOME === undefined)
55
- delete process.env.XDG_CACHE_HOME;
56
- else
57
- process.env.XDG_CACHE_HOME = savedEnv.XDG_CACHE_HOME;
58
- if (savedEnv.XDG_CONFIG_HOME === undefined)
59
- delete process.env.XDG_CONFIG_HOME;
60
- else
61
- process.env.XDG_CONFIG_HOME = savedEnv.XDG_CONFIG_HOME;
62
- for (const dir of tempDirs.splice(0)) {
63
- fs.rmSync(dir, { recursive: true, force: true });
64
- }
65
- });
66
- describe("akm search --include-proposed (CLI)", () => {
67
- test("default excludes proposed entries; --include-proposed keeps them", async () => {
68
- const stash = makeTempDir("akm-search-proposed-stash-");
69
- process.env.XDG_CACHE_HOME = makeTempDir("akm-search-proposed-cache-");
70
- process.env.XDG_CONFIG_HOME = makeTempDir("akm-search-proposed-config-");
71
- for (const sub of ["skills", "commands", "agents", "knowledge", "scripts"]) {
72
- fs.mkdirSync(path.join(stash, sub), { recursive: true });
73
- }
74
- // Curated entry
75
- writeFile(path.join(stash, "skills", "stable-deploy", "SKILL.md"), "---\ndescription: deploy widgets uniformly\n---\n# Stable deploy\n");
76
- writeFile(path.join(stash, "skills", "stable-deploy", ".stash.json"), JSON.stringify({
77
- entries: [
78
- {
79
- name: "stable-deploy",
80
- type: "skill",
81
- description: "deploy widgets uniformly",
82
- tags: ["deploy"],
83
- filename: "SKILL.md",
84
- quality: "curated",
85
- },
86
- ],
87
- }));
88
- // Proposed entry
89
- writeFile(path.join(stash, "skills", "proposed-deploy", "SKILL.md"), "---\ndescription: deploy widgets experimentally\n---\n# Proposed deploy\n");
90
- writeFile(path.join(stash, "skills", "proposed-deploy", ".stash.json"), JSON.stringify({
91
- entries: [
92
- {
93
- name: "proposed-deploy",
94
- type: "skill",
95
- description: "deploy widgets experimentally",
96
- tags: ["deploy"],
97
- filename: "SKILL.md",
98
- quality: "proposed",
99
- },
100
- ],
101
- }));
102
- process.env.AKM_STASH_DIR = stash;
103
- saveConfig({ semanticSearchMode: "off" });
104
- await akmIndex({ stashDir: stash, full: true });
105
- const baseline = runCli(["search", "deploy", "--format=json"], stash);
106
- expect(baseline.status).toBe(0);
107
- const baselineJson = JSON.parse(baseline.stdout);
108
- const baselineNames = baselineJson.hits.map((h) => h.name);
109
- expect(baselineNames).toContain("stable-deploy");
110
- expect(baselineNames).not.toContain("proposed-deploy");
111
- const withProposed = runCli(["search", "deploy", "--include-proposed", "--format=json"], stash);
112
- expect(withProposed.status).toBe(0);
113
- const withProposedJson = JSON.parse(withProposed.stdout);
114
- const withProposedNames = withProposedJson.hits.map((h) => h.name);
115
- expect(withProposedNames).toContain("stable-deploy");
116
- expect(withProposedNames).toContain("proposed-deploy");
117
- });
118
- });
@@ -1,442 +0,0 @@
1
- import { afterEach, describe, expect, mock, spyOn, test } from "bun:test";
2
- import * as childProcess from "node:child_process";
3
- import { checkForUpdate, detectInstallMethod, getAkmBinaryName, getPackageManagerUpgradeCommand, performUpgrade, } from "../src/commands/self-update";
4
- // ── Fetch mocking helper ────────────────────────────────────────────────────
5
- let originalFetch;
6
- function mockFetch(handler) {
7
- originalFetch = globalThis.fetch;
8
- globalThis.fetch = (async (input) => {
9
- const url = typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
10
- return handler(url);
11
- });
12
- }
13
- afterEach(() => {
14
- mock.restore();
15
- if (originalFetch) {
16
- globalThis.fetch = originalFetch;
17
- }
18
- });
19
- function fakeRelease(tagName) {
20
- return Response.json({ tag_name: tagName });
21
- }
22
- // ── detectInstallMethod ─────────────────────────────────────────────────────
23
- describe("detectInstallMethod", () => {
24
- test("returns a valid install method when running via bun run (not compiled)", () => {
25
- const method = detectInstallMethod();
26
- // In test context we're running from source. May be "binary" if AKM_VERSION
27
- // is defined (e.g. compiled test runner), otherwise "unknown" or a package-manager install.
28
- expect(["unknown", "npm", "pnpm", "bun", "binary"]).toContain(method);
29
- });
30
- test("does not throw", () => {
31
- expect(() => detectInstallMethod()).not.toThrow();
32
- });
33
- test("returns 'binary' when Bun.main starts with /$bunfs/", () => {
34
- const signals = {
35
- bunMain: "/$bunfs/root/src/cli.ts",
36
- importMetaDir: "/some/path",
37
- hasAkmVersion: false,
38
- };
39
- expect(detectInstallMethod(signals)).toBe("binary");
40
- });
41
- test("returns 'binary' when AKM_VERSION is defined (fallback)", () => {
42
- const signals = {
43
- bunMain: "/usr/local/bin/akm",
44
- importMetaDir: "/some/path",
45
- hasAkmVersion: true,
46
- };
47
- expect(detectInstallMethod(signals)).toBe("binary");
48
- });
49
- test("returns 'bun' for Bun global install path", () => {
50
- const signals = {
51
- bunMain: "/usr/local/bin/bun",
52
- importMetaDir: "/home/user/.bun/install/global/node_modules/akm-cli/dist",
53
- hasAkmVersion: false,
54
- };
55
- expect(detectInstallMethod(signals)).toBe("bun");
56
- });
57
- test("returns 'bun' for Windows-style Bun global install path", () => {
58
- const signals = {
59
- bunMain: "C:\\Program Files\\Bun\\bun.exe",
60
- importMetaDir: "C:\\Users\\me\\.bun\\install\\global\\node_modules\\akm-cli\\dist",
61
- hasAkmVersion: false,
62
- };
63
- expect(detectInstallMethod(signals)).toBe("bun");
64
- });
65
- test("returns 'pnpm' for pnpm global install path", () => {
66
- const signals = {
67
- bunMain: "/usr/local/bin/bun",
68
- importMetaDir: "/home/user/.local/share/pnpm/global/5/node_modules/akm-cli/dist",
69
- hasAkmVersion: false,
70
- };
71
- expect(detectInstallMethod(signals)).toBe("pnpm");
72
- });
73
- test("returns 'pnpm' for Windows-style pnpm global install path", () => {
74
- const signals = {
75
- bunMain: "C:\\Program Files\\Bun\\bun.exe",
76
- importMetaDir: "C:\\Users\\me\\AppData\\Local\\pnpm\\global\\5\\node_modules\\akm-cli\\dist",
77
- hasAkmVersion: false,
78
- };
79
- expect(detectInstallMethod(signals)).toBe("pnpm");
80
- });
81
- test("returns 'npm' when importMetaDir contains node_modules without bun/pnpm markers", () => {
82
- const signals = {
83
- bunMain: "/usr/local/bin/bun",
84
- importMetaDir: "/usr/local/lib/node_modules/akm-cli/dist",
85
- hasAkmVersion: false,
86
- };
87
- expect(detectInstallMethod(signals)).toBe("npm");
88
- });
89
- test("package-manager detection takes priority over binary signals", () => {
90
- const signals = {
91
- bunMain: "/$bunfs/root/src/cli.ts",
92
- importMetaDir: "/some/node_modules/akm",
93
- hasAkmVersion: true,
94
- };
95
- expect(detectInstallMethod(signals)).toBe("npm");
96
- });
97
- test("returns 'unknown' when no signals match", () => {
98
- const signals = {
99
- bunMain: undefined,
100
- importMetaDir: "/some/path",
101
- hasAkmVersion: false,
102
- };
103
- expect(detectInstallMethod(signals)).toBe("unknown");
104
- });
105
- test("returns 'unknown' when Bun is present but no binary indicators", () => {
106
- const signals = {
107
- bunMain: "/home/user/akm/src/cli.ts",
108
- importMetaDir: "/home/user/akm/src",
109
- hasAkmVersion: false,
110
- };
111
- expect(detectInstallMethod(signals)).toBe("unknown");
112
- });
113
- });
114
- // ── getAkmBinaryName ────────────────────────────────────────────────────────
115
- describe("getAkmBinaryName", () => {
116
- test("returns a string containing 'akm'", () => {
117
- const name = getAkmBinaryName();
118
- expect(name).toContain("akm");
119
- });
120
- test("returns platform-appropriate name for current platform", () => {
121
- const name = getAkmBinaryName();
122
- const platform = process.platform;
123
- const arch = process.arch;
124
- if (platform === "linux") {
125
- expect(name).toStartWith("akm-linux-");
126
- }
127
- else if (platform === "darwin") {
128
- expect(name).toStartWith("akm-darwin-");
129
- }
130
- else if (platform === "win32") {
131
- expect(name).toStartWith("akm-windows-");
132
- expect(name).toEndWith(".exe");
133
- }
134
- if (arch === "x64") {
135
- expect(name).toContain("x64");
136
- }
137
- else if (arch === "arm64") {
138
- expect(name).toContain("arm64");
139
- }
140
- });
141
- });
142
- // ── checkForUpdate (mocked fetch) ───────────────────────────────────────────
143
- describe("checkForUpdate", () => {
144
- test("returns valid UpgradeCheckResponse", async () => {
145
- mockFetch(() => fakeRelease("v0.0.14"));
146
- const result = await checkForUpdate("0.0.13");
147
- expect(result.currentVersion).toBe("0.0.13");
148
- expect(result.latestVersion).toBe("0.0.14");
149
- expect(result.updateAvailable).toBe(true);
150
- expect(["binary", "bun", "npm", "pnpm", "unknown"]).toContain(result.installMethod);
151
- });
152
- test("updateAvailable is false when current matches latest", async () => {
153
- mockFetch(() => fakeRelease("v0.0.13"));
154
- const result = await checkForUpdate("0.0.13");
155
- expect(result.updateAvailable).toBe(false);
156
- expect(result.latestVersion).toBe("0.0.13");
157
- });
158
- test("updateAvailable is true for an old version", async () => {
159
- mockFetch(() => fakeRelease("v0.0.14"));
160
- const result = await checkForUpdate("0.0.0");
161
- expect(result.updateAvailable).toBe(true);
162
- expect(result.currentVersion).toBe("0.0.0");
163
- expect(result.latestVersion).toBe("0.0.14");
164
- });
165
- test("handles missing tag_name gracefully", async () => {
166
- mockFetch(() => Response.json({}));
167
- const result = await checkForUpdate("0.0.13");
168
- expect(result.latestVersion).toBe("");
169
- expect(result.updateAvailable).toBe(false);
170
- });
171
- test("throws on non-OK response", async () => {
172
- mockFetch(() => new Response("Not Found", { status: 404, statusText: "Not Found" }));
173
- await expect(checkForUpdate("0.0.13")).rejects.toThrow("Failed to check for updates");
174
- });
175
- });
176
- // ── performUpgrade ──────────────────────────────────────────────────────────
177
- describe("performUpgrade", () => {
178
- test("runs npm global install for npm installs", async () => {
179
- const spawnSyncSpy = spyOn(childProcess, "spawnSync").mockReturnValue({
180
- status: 0,
181
- stdout: "",
182
- stderr: "",
183
- });
184
- const result = await performUpgrade({
185
- currentVersion: "0.0.13",
186
- latestVersion: "0.0.14",
187
- updateAvailable: true,
188
- installMethod: "npm",
189
- });
190
- expect(spawnSyncSpy).toHaveBeenCalledWith(expect.stringContaining("npm"), ["install", "-g", "akm-cli@latest"], expect.objectContaining({ encoding: "utf8", stdio: "pipe" }));
191
- expect(result.upgraded).toBe(true);
192
- expect(result.installMethod).toBe("npm");
193
- });
194
- test("runs bun global install for bun installs", async () => {
195
- const spawnSyncSpy = spyOn(childProcess, "spawnSync").mockReturnValue({
196
- status: 0,
197
- stdout: "",
198
- stderr: "",
199
- });
200
- const result = await performUpgrade({
201
- currentVersion: "0.0.13",
202
- latestVersion: "0.0.14",
203
- updateAvailable: true,
204
- installMethod: "bun",
205
- });
206
- expect(spawnSyncSpy).toHaveBeenCalledWith(expect.stringContaining("bun"), ["install", "-g", "akm-cli@latest"], expect.objectContaining({ encoding: "utf8", stdio: "pipe" }));
207
- expect(result.upgraded).toBe(true);
208
- expect(result.installMethod).toBe("bun");
209
- });
210
- test("runs pnpm global add for pnpm installs", async () => {
211
- const spawnSyncSpy = spyOn(childProcess, "spawnSync").mockReturnValue({
212
- status: 0,
213
- stdout: "",
214
- stderr: "",
215
- });
216
- const result = await performUpgrade({
217
- currentVersion: "0.0.13",
218
- latestVersion: "0.0.14",
219
- updateAvailable: true,
220
- installMethod: "pnpm",
221
- });
222
- expect(spawnSyncSpy).toHaveBeenCalledWith(expect.stringContaining("pnpm"), ["add", "-g", "akm-cli@latest"], expect.objectContaining({ encoding: "utf8", stdio: "pipe" }));
223
- expect(result.upgraded).toBe(true);
224
- expect(result.installMethod).toBe("pnpm");
225
- });
226
- test("returns guidance message for unknown install method", async () => {
227
- const result = await performUpgrade({
228
- currentVersion: "0.0.13",
229
- latestVersion: "0.0.14",
230
- updateAvailable: true,
231
- installMethod: "unknown",
232
- });
233
- expect(result.upgraded).toBe(false);
234
- expect(result.installMethod).toBe("unknown");
235
- expect(result.message).toContain("manually");
236
- });
237
- test("returns already-latest message when no update available", async () => {
238
- const result = await performUpgrade({
239
- currentVersion: "0.0.13",
240
- latestVersion: "0.0.13",
241
- updateAvailable: false,
242
- installMethod: "binary",
243
- });
244
- expect(result.upgraded).toBe(false);
245
- expect(result.message).toContain("already the latest");
246
- });
247
- test("runs `akm index` post-upgrade after a successful pkg-manager install", async () => {
248
- const spawnSyncSpy = spyOn(childProcess, "spawnSync").mockReturnValue({
249
- status: 0,
250
- stdout: "",
251
- stderr: "",
252
- });
253
- const result = await performUpgrade({
254
- currentVersion: "0.0.13",
255
- latestVersion: "0.0.14",
256
- updateAvailable: true,
257
- installMethod: "npm",
258
- });
259
- expect(result.upgraded).toBe(true);
260
- expect(result.postUpgrade).toBeDefined();
261
- expect(result.postUpgrade?.ok).toBe(true);
262
- expect(result.postUpgrade?.skipped).toBe(false);
263
- expect(result.postUpgrade?.exitCode).toBe(0);
264
- // First spawnSync = the install; second spawnSync = the post-upgrade `akm index`.
265
- expect(spawnSyncSpy).toHaveBeenCalledTimes(2);
266
- expect(spawnSyncSpy).toHaveBeenLastCalledWith("akm", ["index"], expect.objectContaining({ encoding: "utf8", stdio: "pipe" }));
267
- });
268
- test("skips the post-upgrade `akm index` when skipPostUpgrade is set", async () => {
269
- const spawnSyncSpy = spyOn(childProcess, "spawnSync").mockReturnValue({
270
- status: 0,
271
- stdout: "",
272
- stderr: "",
273
- });
274
- const result = await performUpgrade({
275
- currentVersion: "0.0.13",
276
- latestVersion: "0.0.14",
277
- updateAvailable: true,
278
- installMethod: "npm",
279
- }, { skipPostUpgrade: true });
280
- expect(result.upgraded).toBe(true);
281
- expect(result.postUpgrade).toBeDefined();
282
- expect(result.postUpgrade?.skipped).toBe(true);
283
- expect(result.postUpgrade?.ok).toBe(true);
284
- // Only the install spawnSync ran — no second call for `akm index`.
285
- expect(spawnSyncSpy).toHaveBeenCalledTimes(1);
286
- });
287
- test("captures post-upgrade failure without failing the upgrade", async () => {
288
- let call = 0;
289
- const spawnSyncSpy = spyOn(childProcess, "spawnSync").mockImplementation((() => {
290
- call++;
291
- if (call === 1) {
292
- // The install itself succeeds.
293
- return { status: 0, stdout: "", stderr: "" };
294
- }
295
- // The post-upgrade `akm index` fails with a non-zero exit.
296
- return { status: 1, stdout: "", stderr: "no embedding model configured" };
297
- }));
298
- const result = await performUpgrade({
299
- currentVersion: "0.0.13",
300
- latestVersion: "0.0.14",
301
- updateAvailable: true,
302
- installMethod: "npm",
303
- });
304
- expect(result.upgraded).toBe(true); // upgrade itself succeeded
305
- expect(result.postUpgrade?.ok).toBe(false);
306
- expect(result.postUpgrade?.exitCode).toBe(1);
307
- expect(result.postUpgrade?.message).toContain("no embedding model configured");
308
- expect(spawnSyncSpy).toHaveBeenCalledTimes(2);
309
- });
310
- test("throws when latestVersion is empty and force is used", async () => {
311
- await expect(performUpgrade({
312
- currentVersion: "0.0.13",
313
- latestVersion: "",
314
- updateAvailable: false,
315
- installMethod: "binary",
316
- }, { force: true })).rejects.toThrow("Unable to determine latest version");
317
- });
318
- // Note: tests for the binary install path (installMethod: "binary") that test
319
- // checksum verification must avoid actually reaching the filesystem write step,
320
- // which would overwrite the running bun binary. We mock the download to return
321
- // a non-OK status after the checksum check fails, so the code throws before
322
- // trying to write to disk.
323
- test("blocks upgrade when checksum URL returns 404 (default)", async () => {
324
- mockFetch((url) => {
325
- if (url.includes("checksums.txt"))
326
- return new Response("", { status: 404, statusText: "Not Found" });
327
- // Use a non-OK download response so the code throws before reaching the write step
328
- return new Response("", { status: 500 });
329
- });
330
- // The binary download fails first (500), but if checksum fetch is tried before
331
- // binary download, it should throw a checksum error.
332
- const spawnSyncSpy = spyOn(childProcess, "spawnSync").mockReturnValue({
333
- status: 0,
334
- stdout: "",
335
- stderr: "",
336
- });
337
- await expect(performUpgrade({
338
- currentVersion: "0.0.13",
339
- latestVersion: "0.0.14",
340
- updateAvailable: true,
341
- installMethod: "npm",
342
- }, { skipPostUpgrade: true })).resolves.toMatchObject({ upgraded: true, installMethod: "npm" });
343
- // Only the install spawnSync ran; skipPostUpgrade keeps the test focused
344
- // on the checksum-bypass behavior, not the new post-upgrade hook.
345
- expect(spawnSyncSpy).toHaveBeenCalledTimes(1);
346
- });
347
- test("checksum URL 404 throws Checksum verification failed for binary install", async () => {
348
- // Use a mock that: binary download succeeds, checksum returns 404.
349
- // IMPORTANT: We ensure the test does NOT write to disk by making the checksum
350
- // step fail first (it runs after binary download).
351
- mockFetch((url) => {
352
- if (url.includes("checksums.txt"))
353
- return new Response("", { status: 404 });
354
- // Fake binary download — must succeed for checksum check to be reached
355
- return new Response(new Uint8Array(100), { status: 200 });
356
- });
357
- await expect(performUpgrade({
358
- currentVersion: "0.0.13",
359
- latestVersion: "0.0.14",
360
- updateAvailable: true,
361
- installMethod: "binary",
362
- })).rejects.toThrow(/Checksum verification failed/);
363
- });
364
- test("skipChecksum: true option is accepted by performUpgrade (npm path)", async () => {
365
- const spawnSyncSpy = spyOn(childProcess, "spawnSync").mockReturnValue({
366
- status: 0,
367
- stdout: "",
368
- stderr: "",
369
- });
370
- const result = await performUpgrade({
371
- currentVersion: "0.0.13",
372
- latestVersion: "0.0.14",
373
- updateAvailable: true,
374
- installMethod: "npm",
375
- }, { skipChecksum: true, skipPostUpgrade: true });
376
- // Only the install spawnSync ran; skipPostUpgrade keeps the test focused
377
- // on the skipChecksum option, not the new post-upgrade hook.
378
- expect(spawnSyncSpy).toHaveBeenCalledTimes(1);
379
- expect(result.upgraded).toBe(true);
380
- expect(result.installMethod).toBe("npm");
381
- });
382
- test("blocks upgrade when binary name not in checksums.txt (default)", async () => {
383
- const binaryName = getAkmBinaryName();
384
- mockFetch((url) => {
385
- if (url.includes("checksums.txt")) {
386
- // Valid checksums format but does NOT include the current binary name
387
- return new Response(`${"a".repeat(64)} other-binary\n${"b".repeat(64)} another-binary\n`, { status: 200 });
388
- }
389
- return new Response(new Uint8Array(100), { status: 200 });
390
- });
391
- await expect(performUpgrade({
392
- currentVersion: "0.0.13",
393
- latestVersion: "0.0.14",
394
- updateAvailable: true,
395
- installMethod: "binary",
396
- })).rejects.toThrow(new RegExp(`${binaryName.replace(".", "\\.")}.*not listed|Checksum verification failed`));
397
- });
398
- test("blocks upgrade on checksum mismatch (default)", async () => {
399
- const binaryName = getAkmBinaryName();
400
- const wrongHash = "0".repeat(64);
401
- mockFetch((url) => {
402
- if (url.includes("checksums.txt")) {
403
- return new Response(`${wrongHash} ${binaryName}\n`, { status: 200 });
404
- }
405
- // Return binary content that will NOT match the all-zeros hash
406
- return new Response(new Uint8Array(Array.from({ length: 100 }, (_, i) => i % 256)), { status: 200 });
407
- });
408
- await expect(performUpgrade({
409
- currentVersion: "0.0.13",
410
- latestVersion: "0.0.14",
411
- updateAvailable: true,
412
- installMethod: "binary",
413
- })).rejects.toThrow(/Checksum mismatch/);
414
- });
415
- });
416
- describe("getPackageManagerUpgradeCommand", () => {
417
- test("returns npm install command", () => {
418
- expect(getPackageManagerUpgradeCommand("npm", "akm-cli")).toEqual({
419
- command: expect.stringContaining("npm"),
420
- args: ["install", "-g", "akm-cli@latest"],
421
- displayCommand: "npm install -g akm-cli@latest",
422
- });
423
- });
424
- test("returns bun install command", () => {
425
- expect(getPackageManagerUpgradeCommand("bun", "akm-cli")).toEqual({
426
- command: expect.stringContaining("bun"),
427
- args: ["install", "-g", "akm-cli@latest"],
428
- displayCommand: "bun install -g akm-cli@latest",
429
- });
430
- });
431
- test("returns pnpm add command", () => {
432
- expect(getPackageManagerUpgradeCommand("pnpm", "akm-cli")).toEqual({
433
- command: expect.stringContaining("pnpm"),
434
- args: ["add", "-g", "akm-cli@latest"],
435
- displayCommand: "pnpm add -g akm-cli@latest",
436
- });
437
- });
438
- test("returns undefined for non-package-manager installs", () => {
439
- expect(getPackageManagerUpgradeCommand("binary", "akm-cli")).toBeUndefined();
440
- expect(getPackageManagerUpgradeCommand("unknown", "akm-cli")).toBeUndefined();
441
- });
442
- });