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,533 +0,0 @@
1
- import { afterAll, afterEach, beforeEach, 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 { akmInit } from "../src/commands/init";
6
- import { akmSearch } from "../src/commands/search";
7
- import { akmShowUnified as akmShow } from "../src/commands/show";
8
- import { getConfigPath, saveConfig } from "../src/core/config";
9
- import { getBinDir } from "../src/core/paths";
10
- import { akmIndex } from "../src/indexer/indexer";
11
- const createdTmpDirs = [];
12
- function createTmpDir(prefix = "akm-stash-") {
13
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
14
- createdTmpDirs.push(dir);
15
- return dir;
16
- }
17
- function writeFile(filePath, content = "") {
18
- fs.mkdirSync(path.dirname(filePath), { recursive: true });
19
- fs.writeFileSync(filePath, content);
20
- }
21
- function isLocalHit(hit) {
22
- return hit.type !== "registry";
23
- }
24
- afterAll(() => {
25
- for (const dir of createdTmpDirs) {
26
- fs.rmSync(dir, { recursive: true, force: true });
27
- }
28
- });
29
- /** Place a dummy rg binary in stashDir/bin so ensureRg skips download */
30
- function _stubRg(stashDir) {
31
- const binDir = path.join(stashDir, "bin");
32
- fs.mkdirSync(binDir, { recursive: true });
33
- const rgPath = path.join(binDir, "rg");
34
- fs.writeFileSync(rgPath, "#!/bin/sh\necho 'ripgrep 14.1.1'\n");
35
- fs.chmodSync(rgPath, 0o755);
36
- }
37
- function stubCachedRg() {
38
- const binDir = getBinDir();
39
- fs.mkdirSync(binDir, { recursive: true });
40
- const rgPath = path.join(binDir, "rg");
41
- fs.writeFileSync(rgPath, "#!/bin/sh\necho 'ripgrep 14.1.1'\n");
42
- fs.chmodSync(rgPath, 0o755);
43
- }
44
- // Isolate each test with its own cache directory so SQLite databases don't leak
45
- const originalXdgCacheHome = process.env.XDG_CACHE_HOME;
46
- const originalXdgConfigHome = process.env.XDG_CONFIG_HOME;
47
- let testCacheDir = "";
48
- let testConfigDir = "";
49
- beforeEach(() => {
50
- testCacheDir = createTmpDir("akm-stash-cache-");
51
- testConfigDir = createTmpDir("akm-stash-config-");
52
- process.env.XDG_CACHE_HOME = testCacheDir;
53
- process.env.XDG_CONFIG_HOME = testConfigDir;
54
- });
55
- afterEach(() => {
56
- if (originalXdgCacheHome === undefined) {
57
- delete process.env.XDG_CACHE_HOME;
58
- }
59
- else {
60
- process.env.XDG_CACHE_HOME = originalXdgCacheHome;
61
- }
62
- if (originalXdgConfigHome === undefined) {
63
- delete process.env.XDG_CONFIG_HOME;
64
- }
65
- else {
66
- process.env.XDG_CONFIG_HOME = originalXdgConfigHome;
67
- }
68
- if (testCacheDir) {
69
- fs.rmSync(testCacheDir, { recursive: true, force: true });
70
- testCacheDir = "";
71
- }
72
- if (testConfigDir) {
73
- fs.rmSync(testConfigDir, { recursive: true, force: true });
74
- testConfigDir = "";
75
- }
76
- });
77
- test("akmSearch only includes script files with supported extensions and returns run", async () => {
78
- const stashDir = createTmpDir("akm-stash-");
79
- writeFile(path.join(stashDir, "scripts", "deploy.sh"), "#!/usr/bin/env bash\necho deploy\n");
80
- writeFile(path.join(stashDir, "scripts", "script.ts"), "console.log('x')\n");
81
- writeFile(path.join(stashDir, "scripts", "README.md"), "ignore\n");
82
- process.env.AKM_STASH_DIR = stashDir;
83
- const result = await akmSearch({ query: "", type: "script" });
84
- const localHits = result.hits.filter(isLocalHit);
85
- expect(localHits.length).toBe(2);
86
- expect(localHits.every((hit) => hit.type === "script")).toBe(true);
87
- expect(localHits.some((hit) => hit.name === "README.md")).toBe(false);
88
- expect(localHits.some((hit) => typeof hit.run === "string")).toBe(true);
89
- });
90
- test("akmSearch creates bun run from nearest package.json up to scripts root", async () => {
91
- const stashDir = createTmpDir("akm-stash-");
92
- const nestedScript = path.join(stashDir, "scripts", "group", "nested", "job.js");
93
- writeFile(nestedScript, "console.log('job')\n");
94
- writeFile(path.join(stashDir, "scripts", "group", "package.json"), '{"name":"group"}');
95
- writeFile(path.join(stashDir, "scripts", "package.json"), '{"name":"root"}');
96
- process.env.AKM_STASH_DIR = stashDir;
97
- const result = await akmSearch({ query: "job", type: "script" });
98
- const hit = result.hits.filter(isLocalHit)[0];
99
- expect(result.hits.length).toBe(1);
100
- expect(hit.run).toContain("bun");
101
- expect(hit.run).toContain("job.js");
102
- });
103
- test("akmSearch detects setup from package.json in nearby directory", async () => {
104
- const stashDir = createTmpDir("akm-stash-");
105
- const nestedScript = path.join(stashDir, "scripts", "group", "nested", "job.js");
106
- writeFile(nestedScript, "console.log('job')\n");
107
- writeFile(path.join(stashDir, "scripts", "group", "nested", "package.json"), '{"name":"group"}');
108
- process.env.AKM_STASH_DIR = stashDir;
109
- const result = await akmSearch({ query: "job", type: "script" });
110
- const hit = result.hits.filter(isLocalHit)[0];
111
- expect(result.hits.length).toBe(1);
112
- // Search hits only expose run, not setup/cwd
113
- expect(hit.run).toContain("bun");
114
- expect(hit.run).toContain("job.js");
115
- });
116
- test("akmSearch resolves script run correctly for search path directories", async () => {
117
- const primaryStashDir = createTmpDir("akm-stash-primary-");
118
- const searchPathDir = createTmpDir("akm-stash-searchpath-");
119
- writeFile(path.join(primaryStashDir, "scripts", "placeholder.sh"), "#!/usr/bin/env bash\necho primary\n");
120
- writeFile(path.join(searchPathDir, "scripts", "group", "nested", "job.js"), "console.log('job')\n");
121
- writeFile(path.join(searchPathDir, "scripts", "group", "package.json"), '{"name":"group"}');
122
- saveConfig({ semanticSearchMode: "off", sources: [{ type: "filesystem", path: searchPathDir }] });
123
- process.env.AKM_STASH_DIR = primaryStashDir;
124
- await akmIndex({ stashDir: primaryStashDir, full: true });
125
- const result = await akmSearch({ query: "job", type: "script" });
126
- const searchPathHit = result.hits.filter(isLocalHit).find((hit) => hit.path.includes(searchPathDir));
127
- expect(searchPathHit).toBeDefined();
128
- expect(searchPathHit?.run ?? "").toContain("bun");
129
- expect(searchPathHit?.run ?? "").toContain("job.js");
130
- });
131
- test("akmSearch includes explainability reasons for indexed hits", async () => {
132
- const stashDir = createTmpDir("akm-stash-");
133
- writeFile(path.join(stashDir, "scripts", "summarize-diff.ts"), "console.log('summarize')\n");
134
- saveConfig({ semanticSearchMode: "auto" });
135
- process.env.AKM_STASH_DIR = stashDir;
136
- await akmIndex({ stashDir, full: true });
137
- const result = await akmSearch({ query: "summarize diff", type: "script" });
138
- expect(result.hits.length).toBeGreaterThan(0);
139
- expect(result.hits[0].whyMatched).toBeDefined();
140
- // Ranking mode depends on whether semantic search (embeddings) is available.
141
- // Accept "fts bm25 relevance", "semantic similarity", or "hybrid (fts + semantic)".
142
- expect(result.hits[0].whyMatched?.includes("fts bm25 relevance") ||
143
- result.hits[0].whyMatched?.includes("semantic similarity") ||
144
- result.hits[0].whyMatched?.includes("hybrid (fts + semantic)")).toBe(true);
145
- expect(result.hits[0].whyMatched).toContain("matched name tokens");
146
- });
147
- test("akmSearch includes ref, action, and size for local hits", async () => {
148
- const stashDir = createTmpDir("akm-stash-");
149
- const scriptPath = path.join(stashDir, "scripts", "deploy.sh");
150
- writeFile(scriptPath, "#!/usr/bin/env bash\necho deploy\n");
151
- writeFile(path.join(stashDir, "scripts", ".stash.json"), JSON.stringify({
152
- entries: [
153
- {
154
- name: "deploy",
155
- type: "script",
156
- description: "Deploy app",
157
- filename: "deploy.sh",
158
- },
159
- ],
160
- }));
161
- saveConfig({ semanticSearchMode: "off" });
162
- process.env.AKM_STASH_DIR = stashDir;
163
- await akmIndex({ stashDir, full: true });
164
- const result = await akmSearch({ query: "deploy", type: "script" });
165
- const hit = result.hits.filter(isLocalHit)[0];
166
- expect(hit.ref).toContain("script:deploy.sh");
167
- expect(hit.action).toContain("akm show");
168
- expect(hit.size).toBe("small");
169
- });
170
- test("akmSearch includes origin for installed-source hits", async () => {
171
- const stashDir = createTmpDir("akm-stash-");
172
- const installedStash = createTmpDir("akm-installed-");
173
- writeFile(path.join(stashDir, "scripts", "placeholder.sh"), "#!/usr/bin/env bash\necho placeholder\n");
174
- writeFile(path.join(installedStash, "scripts", "deploy.sh"), "#!/usr/bin/env bash\necho deploy\n");
175
- saveConfig({
176
- semanticSearchMode: "off",
177
- installed: [
178
- {
179
- id: "npm:@scope/deploy-stash",
180
- source: "npm",
181
- ref: "@scope/deploy-stash",
182
- artifactUrl: "https://example.com/deploy-stash.tgz",
183
- stashRoot: installedStash,
184
- cacheDir: installedStash,
185
- installedAt: new Date().toISOString(),
186
- },
187
- ],
188
- });
189
- process.env.AKM_STASH_DIR = stashDir;
190
- await akmIndex({ stashDir, full: true });
191
- const result = await akmSearch({ query: "deploy", type: "script" });
192
- expect(result.hits.filter(isLocalHit).some((hit) => hit.origin === "npm:@scope/deploy-stash")).toBe(true);
193
- });
194
- test("akmShow returns full payloads for skill/command/agent", async () => {
195
- const stashDir = createTmpDir("akm-stash-");
196
- writeFile(path.join(stashDir, "skills", "ops", "SKILL.md"), "# Ops\n");
197
- writeFile(path.join(stashDir, "commands", "release.md"), '---\ndescription: "Release command"\n---\nrun release\n');
198
- writeFile(path.join(stashDir, "agents", "coach.md"), '---\ndescription: "Coach"\nmodel: "gpt-5"\n---\nGuide users\n');
199
- process.env.AKM_STASH_DIR = stashDir;
200
- const skill = await akmShow({ ref: "skill:ops" });
201
- const command = await akmShow({ ref: "command:release.md" });
202
- const agent = await akmShow({ ref: "agent:coach.md" });
203
- expect(skill.type).toBe("skill");
204
- expect(skill.action).toContain("Read and follow");
205
- expect(skill.content ?? "").toMatch(/Ops/);
206
- expect(command.type).toBe("command");
207
- expect(command.action).toContain("dispatch");
208
- expect(command.template ?? "").toMatch(/run release/);
209
- expect(command.description).toBe("Release command");
210
- expect(agent.type).toBe("agent");
211
- expect(agent.action).toContain("verbatim");
212
- expect(agent.prompt ?? "").toMatch(/Guide users/);
213
- expect(agent.modelHint).toBe("gpt-5");
214
- });
215
- test("akmShow returns clear error when stash type root is missing", async () => {
216
- const stashDir = createTmpDir("akm-stash-");
217
- try {
218
- process.env.AKM_STASH_DIR = stashDir;
219
- // QA #27: error should not leak "Stash type root" wording; be user-facing
220
- await expect(akmShow({ ref: "agent:missing.md" })).rejects.toThrow(/Asset not found for ref: agent:missing\.md|not found for ref/i);
221
- }
222
- finally {
223
- fs.rmSync(stashDir, { recursive: true, force: true });
224
- }
225
- });
226
- test("akmShow rejects invalid asset type in ref", async () => {
227
- const stashDir = createTmpDir("akm-stash-");
228
- process.env.AKM_STASH_DIR = stashDir;
229
- await expect(akmShow({ ref: "widget:foo" })).rejects.toThrow(/Invalid asset type/);
230
- });
231
- test("akmShow rejects traversal and absolute path refs", async () => {
232
- const stashDir = createTmpDir("akm-stash-");
233
- process.env.AKM_STASH_DIR = stashDir;
234
- await expect(akmShow({ ref: "script:../outside.sh" })).rejects.toThrow(/Path traversal/);
235
- await expect(akmShow({ ref: "script:/etc/passwd" })).rejects.toThrow(/Absolute path/);
236
- });
237
- test("akmShow blocks symlink escapes outside stash type root", async () => {
238
- const stashDir = createTmpDir("akm-stash-");
239
- const outsideDir = createTmpDir("akm-outside-");
240
- const outsideFile = path.join(outsideDir, "outside.sh");
241
- const symlinkFile = path.join(stashDir, "scripts", "link.sh");
242
- writeFile(outsideFile, "echo outside\n");
243
- fs.mkdirSync(path.join(stashDir, "scripts"), { recursive: true });
244
- try {
245
- fs.symlinkSync(outsideFile, symlinkFile);
246
- }
247
- catch {
248
- // Symlinks not supported in this environment — skip
249
- return;
250
- }
251
- process.env.AKM_STASH_DIR = stashDir;
252
- await expect(akmShow({ ref: "script:link.sh" })).rejects.toThrow(/Ref resolves outside the stash root/);
253
- });
254
- // ── Knowledge tests ─────────────────────────────────────────────────────────
255
- const KNOWLEDGE_DOC = `---
256
- title: API Guide
257
- description: "API documentation"
258
- ---
259
- # Overview
260
-
261
- This is the API guide.
262
-
263
- ## Authentication
264
-
265
- Use bearer tokens.
266
-
267
- ## Endpoints
268
-
269
- ### GET /users
270
-
271
- Returns all users.
272
-
273
- ### POST /users
274
-
275
- Creates a user.
276
- `;
277
- test("akmSearch finds knowledge assets", async () => {
278
- const stashDir = createTmpDir("akm-stash-");
279
- writeFile(path.join(stashDir, "knowledge", "api-guide.md"), KNOWLEDGE_DOC);
280
- process.env.AKM_STASH_DIR = stashDir;
281
- const result = await akmSearch({ query: "", type: "knowledge" });
282
- expect(result.hits.length).toBe(1);
283
- expect(result.hits[0].type).toBe("knowledge");
284
- expect(result.hits[0].name).toBe("api-guide");
285
- });
286
- test("akmShow returns full content for knowledge by default", async () => {
287
- const stashDir = createTmpDir("akm-stash-");
288
- writeFile(path.join(stashDir, "knowledge", "api-guide.md"), KNOWLEDGE_DOC);
289
- process.env.AKM_STASH_DIR = stashDir;
290
- const result = await akmShow({ ref: "knowledge:api-guide.md" });
291
- expect(result.type).toBe("knowledge");
292
- expect(result.content).toContain("# Overview");
293
- expect(result.content).toContain("## Authentication");
294
- });
295
- test("akmShow returns TOC for knowledge with view toc", async () => {
296
- const stashDir = createTmpDir("akm-stash-");
297
- writeFile(path.join(stashDir, "knowledge", "api-guide.md"), KNOWLEDGE_DOC);
298
- process.env.AKM_STASH_DIR = stashDir;
299
- const result = await akmShow({ ref: "knowledge:api-guide.md", view: { mode: "toc" } });
300
- expect(result.type).toBe("knowledge");
301
- expect(result.content).toContain("# Overview");
302
- expect(result.content).toContain("## Authentication");
303
- expect(result.content).toContain("## Endpoints");
304
- expect(result.content).toContain("lines total");
305
- });
306
- test("akmShow extracts section for knowledge", async () => {
307
- const stashDir = createTmpDir("akm-stash-");
308
- writeFile(path.join(stashDir, "knowledge", "api-guide.md"), KNOWLEDGE_DOC);
309
- process.env.AKM_STASH_DIR = stashDir;
310
- const result = await akmShow({
311
- ref: "knowledge:api-guide.md",
312
- view: { mode: "section", heading: "Authentication" },
313
- });
314
- expect(result.type).toBe("knowledge");
315
- expect(result.content).toContain("bearer tokens");
316
- expect(result.content).not.toContain("Endpoints");
317
- });
318
- test("akmShow extracts line range for knowledge", async () => {
319
- const stashDir = createTmpDir("akm-stash-");
320
- writeFile(path.join(stashDir, "knowledge", "api-guide.md"), KNOWLEDGE_DOC);
321
- process.env.AKM_STASH_DIR = stashDir;
322
- const result = await akmShow({ ref: "knowledge:api-guide.md", view: { mode: "lines", start: 5, end: 7 } });
323
- expect(result.type).toBe("knowledge");
324
- expect(result.content).toContain("# Overview");
325
- });
326
- test("akmShow extracts frontmatter for knowledge", async () => {
327
- const stashDir = createTmpDir("akm-stash-");
328
- writeFile(path.join(stashDir, "knowledge", "api-guide.md"), KNOWLEDGE_DOC);
329
- process.env.AKM_STASH_DIR = stashDir;
330
- const result = await akmShow({ ref: "knowledge:api-guide.md", view: { mode: "frontmatter" } });
331
- expect(result.type).toBe("knowledge");
332
- expect(result.content).toContain("title: API Guide");
333
- expect(result.content).not.toContain("# Overview");
334
- });
335
- test("akmShow returns no-frontmatter message when missing", async () => {
336
- const stashDir = createTmpDir("akm-stash-");
337
- writeFile(path.join(stashDir, "knowledge", "plain.md"), "# Just a heading\nSome text.\n");
338
- process.env.AKM_STASH_DIR = stashDir;
339
- const result = await akmShow({ ref: "knowledge:plain.md", view: { mode: "frontmatter" } });
340
- expect(result.content).toBe("(no frontmatter)");
341
- });
342
- test("akmShow returns helpful message for missing section in knowledge", async () => {
343
- const stashDir = createTmpDir("akm-stash-");
344
- writeFile(path.join(stashDir, "knowledge", "api-guide.md"), KNOWLEDGE_DOC);
345
- process.env.AKM_STASH_DIR = stashDir;
346
- const result = await akmShow({
347
- ref: "knowledge:api-guide.md",
348
- view: { mode: "section", heading: "Nonexistent" },
349
- });
350
- expect(result.type).toBe("knowledge");
351
- expect(result.content).toContain('Section "Nonexistent" not found');
352
- expect(result.content).toContain("akm show");
353
- expect(result.content).toContain("toc");
354
- expect(result.content).toContain("discover available headings");
355
- });
356
- test("akmShow for script type returns run", async () => {
357
- const stashDir = createTmpDir("akm-stash-");
358
- writeFile(path.join(stashDir, "scripts", "deploy.sh"), "#!/usr/bin/env bash\necho deploy\n");
359
- process.env.AKM_STASH_DIR = stashDir;
360
- const result = await akmShow({ ref: "script:deploy.sh" });
361
- expect(result.type).toBe("script");
362
- expect(result.run).toBeTruthy();
363
- expect(typeof result.run).toBe("string");
364
- expect(result.run).toContain("bash");
365
- });
366
- test("akmInit returns created false when stash dir already exists", async () => {
367
- const origHome = process.env.HOME;
368
- const origStashDir = process.env.AKM_STASH_DIR;
369
- const tmpHome = createTmpDir("akm-home-");
370
- // Pre-create the akm directory at the new default location (~/akm)
371
- const stashPath = path.join(tmpHome, "akm");
372
- fs.mkdirSync(stashPath, { recursive: true });
373
- process.env.HOME = tmpHome;
374
- delete process.env.AKM_STASH_DIR;
375
- try {
376
- stubCachedRg();
377
- const result = await akmInit();
378
- expect(result.created).toBe(false);
379
- expect(result.stashDir).toBe(stashPath);
380
- }
381
- finally {
382
- if (origHome === undefined)
383
- delete process.env.HOME;
384
- else
385
- process.env.HOME = origHome;
386
- if (origStashDir === undefined)
387
- delete process.env.AKM_STASH_DIR;
388
- else
389
- process.env.AKM_STASH_DIR = origStashDir;
390
- fs.rmSync(tmpHome, { recursive: true, force: true });
391
- }
392
- });
393
- test("akmShow throws unsupported script extension for .txt file", async () => {
394
- const origStashDir = process.env.AKM_STASH_DIR;
395
- const stashDir = createTmpDir("akm-stash-");
396
- writeFile(path.join(stashDir, "scripts", "readme.txt"), "not a script\n");
397
- process.env.AKM_STASH_DIR = stashDir;
398
- try {
399
- await expect(akmShow({ ref: "script:readme.txt" })).rejects.toThrow(/Script ref must resolve to a file with a supported script extension/);
400
- }
401
- finally {
402
- if (origStashDir === undefined)
403
- delete process.env.AKM_STASH_DIR;
404
- else
405
- process.env.AKM_STASH_DIR = origStashDir;
406
- fs.rmSync(stashDir, { recursive: true, force: true });
407
- }
408
- });
409
- test("akmInit creates knowledge directory", async () => {
410
- const origHome = process.env.HOME;
411
- const origStashDir = process.env.AKM_STASH_DIR;
412
- const tmpHome = createTmpDir("akm-home-");
413
- process.env.HOME = tmpHome;
414
- delete process.env.AKM_STASH_DIR;
415
- try {
416
- stubCachedRg();
417
- const result = await akmInit();
418
- expect(fs.existsSync(path.join(result.stashDir, "knowledge"))).toBe(true);
419
- }
420
- finally {
421
- if (origHome === undefined)
422
- delete process.env.HOME;
423
- else
424
- process.env.HOME = origHome;
425
- if (origStashDir === undefined)
426
- delete process.env.AKM_STASH_DIR;
427
- else
428
- process.env.AKM_STASH_DIR = origStashDir;
429
- fs.rmSync(tmpHome, { recursive: true, force: true });
430
- }
431
- });
432
- // ── Script tests ────────────────────────────────────────────────────────────
433
- test("akmSearch finds script assets with broad extensions", async () => {
434
- const origStashDir = process.env.AKM_STASH_DIR;
435
- const stashDir = createTmpDir("akm-stash-");
436
- writeFile(path.join(stashDir, "scripts", "cleanup.sh"), "#!/usr/bin/env bash\necho cleanup\n");
437
- writeFile(path.join(stashDir, "scripts", "process.py"), "print('hello')\n");
438
- writeFile(path.join(stashDir, "scripts", "README.md"), "ignore\n");
439
- try {
440
- process.env.AKM_STASH_DIR = stashDir;
441
- const result = await akmSearch({ query: "", type: "script" });
442
- expect(result.hits.length).toBe(2);
443
- expect(result.hits.every((hit) => hit.type === "script")).toBe(true);
444
- expect(result.hits.some((hit) => hit.name === "README.md")).toBe(false);
445
- }
446
- finally {
447
- if (origStashDir === undefined) {
448
- delete process.env.AKM_STASH_DIR;
449
- }
450
- else {
451
- process.env.AKM_STASH_DIR = origStashDir;
452
- }
453
- fs.rmSync(stashDir, { recursive: true, force: true });
454
- }
455
- });
456
- test("akmSearch returns run for runnable script extensions", async () => {
457
- const origStashDir = process.env.AKM_STASH_DIR;
458
- const stashDir = createTmpDir("akm-stash-");
459
- writeFile(path.join(stashDir, "scripts", "deploy.sh"), "#!/usr/bin/env bash\necho deploy\n");
460
- try {
461
- process.env.AKM_STASH_DIR = stashDir;
462
- const result = await akmSearch({ query: "", type: "script" });
463
- const hit = result.hits.filter(isLocalHit)[0];
464
- expect(result.hits.length).toBe(1);
465
- expect(hit.run).toBeTruthy();
466
- expect(hit.run).toContain("bash");
467
- }
468
- finally {
469
- if (origStashDir === undefined) {
470
- delete process.env.AKM_STASH_DIR;
471
- }
472
- else {
473
- process.env.AKM_STASH_DIR = origStashDir;
474
- }
475
- fs.rmSync(stashDir, { recursive: true, force: true });
476
- }
477
- });
478
- test("akmShow returns run for python script (auto-detected interpreter)", async () => {
479
- const origStashDir = process.env.AKM_STASH_DIR;
480
- const stashDir = createTmpDir("akm-stash-");
481
- writeFile(path.join(stashDir, "scripts", "process.py"), "# A python script\nprint('hello')\n");
482
- try {
483
- process.env.AKM_STASH_DIR = stashDir;
484
- const result = await akmShow({ ref: "script:process.py" });
485
- expect(result.type).toBe("script");
486
- expect(result.run).toBeDefined();
487
- expect(result.run).toContain("python");
488
- }
489
- finally {
490
- if (origStashDir === undefined) {
491
- delete process.env.AKM_STASH_DIR;
492
- }
493
- else {
494
- process.env.AKM_STASH_DIR = origStashDir;
495
- }
496
- fs.rmSync(stashDir, { recursive: true, force: true });
497
- }
498
- });
499
- test("akmShow returns run for runnable script", async () => {
500
- const stashDir = createTmpDir("akm-stash-");
501
- writeFile(path.join(stashDir, "scripts", "deploy.sh"), "#!/usr/bin/env bash\necho deploy\n");
502
- process.env.AKM_STASH_DIR = stashDir;
503
- const result = await akmShow({ ref: "script:deploy.sh" });
504
- expect(result.type).toBe("script");
505
- expect(result.run).toBeTruthy();
506
- expect(result.run).toContain("bash");
507
- });
508
- test("akmInit writes config outside the stash directory", async () => {
509
- const origHome = process.env.HOME;
510
- const origStashDir = process.env.AKM_STASH_DIR;
511
- const tmpHome = createTmpDir("akm-home-");
512
- process.env.HOME = tmpHome;
513
- delete process.env.AKM_STASH_DIR;
514
- try {
515
- stubCachedRg();
516
- const result = await akmInit();
517
- expect(result.configPath).toBe(getConfigPath());
518
- expect(result.configPath.startsWith(result.stashDir)).toBe(false);
519
- expect(fs.existsSync(result.configPath)).toBe(true);
520
- expect(fs.existsSync(path.join(result.stashDir, "config.json"))).toBe(false);
521
- }
522
- finally {
523
- if (origHome === undefined)
524
- delete process.env.HOME;
525
- else
526
- process.env.HOME = origHome;
527
- if (origStashDir === undefined)
528
- delete process.env.AKM_STASH_DIR;
529
- else
530
- process.env.AKM_STASH_DIR = origStashDir;
531
- fs.rmSync(tmpHome, { recursive: true, force: true });
532
- }
533
- });
@@ -1,73 +0,0 @@
1
- import { afterEach, 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 { extractTarGzSecure } from "../src/sources/providers/tar-utils";
6
- /**
7
- * Regression tests for the post-extraction scanner in `tar-utils.ts`.
8
- *
9
- * PR #168 review flagged that the previous `entry.name.includes("..")`
10
- * check rejected legitimate filenames like `archive..2024.tar` or
11
- * `foo..bar.md`. The scanner now only rejects exact "." / ".." segments
12
- * and instead enforces containment via `isWithin`.
13
- *
14
- * These tests construct real tarballs in a temp directory and run them
15
- * through the actual extraction path so the post-scan logic is exercised
16
- * end-to-end.
17
- */
18
- const tmpDirs = [];
19
- function tmpDir(prefix = "akm-tar-scan-") {
20
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
21
- tmpDirs.push(dir);
22
- return dir;
23
- }
24
- afterEach(() => {
25
- for (const dir of tmpDirs.splice(0)) {
26
- fs.rmSync(dir, { recursive: true, force: true });
27
- }
28
- });
29
- /**
30
- * Build a tarball where the inner directory wraps two files. Returns the
31
- * tarball path and the destination dir for `extractTarGzSecure`.
32
- */
33
- function buildTarball(rootName, entries) {
34
- const work = tmpDir("akm-tar-build-");
35
- const root = path.join(work, rootName);
36
- fs.mkdirSync(root, { recursive: true });
37
- for (const entry of entries) {
38
- const file = path.join(root, entry.name);
39
- fs.mkdirSync(path.dirname(file), { recursive: true });
40
- fs.writeFileSync(file, entry.body, "utf8");
41
- }
42
- const tarPath = path.join(work, `${rootName}.tar.gz`);
43
- // Use system tar — present on macOS, Linux. The scanner is what we care
44
- // about; building the archive itself is incidental.
45
- const proc = Bun.spawnSync(["tar", "-czf", tarPath, "-C", work, rootName]);
46
- if (proc.exitCode !== 0) {
47
- throw new Error(`tar build failed: ${new TextDecoder().decode(proc.stderr)}`);
48
- }
49
- return tarPath;
50
- }
51
- describe("scanExtractedFiles — filename .. substring guard (PR #168 review #8)", () => {
52
- test("accepts filenames containing `..` substrings (no false positive)", () => {
53
- const tarPath = buildTarball("pkg", [
54
- { name: "archive..2024.tar", body: "tar body bytes" },
55
- { name: "notes/foo..bar.md", body: "# notes" },
56
- ]);
57
- const dest = tmpDir("akm-tar-extract-");
58
- // Should NOT throw — these names previously failed the substring check.
59
- expect(() => extractTarGzSecure(tarPath, dest)).not.toThrow();
60
- expect(fs.existsSync(path.join(dest, "archive..2024.tar"))).toBe(true);
61
- expect(fs.existsSync(path.join(dest, "notes/foo..bar.md"))).toBe(true);
62
- });
63
- test("accepts ordinary filenames", () => {
64
- const tarPath = buildTarball("pkg", [
65
- { name: "README.md", body: "# README" },
66
- { name: "src/main.ts", body: "export const x = 1;" },
67
- ]);
68
- const dest = tmpDir("akm-tar-extract-ok-");
69
- expect(() => extractTarGzSecure(tarPath, dest)).not.toThrow();
70
- expect(fs.existsSync(path.join(dest, "README.md"))).toBe(true);
71
- expect(fs.existsSync(path.join(dest, "src/main.ts"))).toBe(true);
72
- });
73
- });
@@ -1,73 +0,0 @@
1
- import { afterEach, describe, expect, test } from "bun:test";
2
- import { spawnSync } from "node:child_process";
3
- import fs from "node:fs";
4
- import os from "node:os";
5
- import path from "node:path";
6
- const CLI = path.join(__dirname, "..", "src", "cli.ts");
7
- const tempDirs = [];
8
- function makeTempDir(prefix) {
9
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
10
- tempDirs.push(dir);
11
- return dir;
12
- }
13
- afterEach(() => {
14
- for (const dir of tempDirs.splice(0)) {
15
- fs.rmSync(dir, { recursive: true, force: true });
16
- }
17
- });
18
- function runCli(args, env) {
19
- const result = spawnSync("bun", [CLI, ...args], {
20
- encoding: "utf8",
21
- timeout: 30_000,
22
- env,
23
- });
24
- return { status: result.status, stdout: result.stdout ?? "", stderr: result.stderr ?? "" };
25
- }
26
- describe("component toggles", () => {
27
- test("akm disable skills.sh marks skills.sh registry as disabled", () => {
28
- const xdgConfig = makeTempDir("akm-toggle-config-");
29
- const xdgCache = makeTempDir("akm-toggle-cache-");
30
- const stashDir = makeTempDir("akm-toggle-stash-");
31
- const result = runCli(["disable", "skills.sh", "--format=json"], {
32
- ...process.env,
33
- XDG_CONFIG_HOME: xdgConfig,
34
- XDG_CACHE_HOME: xdgCache,
35
- AKM_STASH_DIR: stashDir,
36
- });
37
- expect(result.status).toBe(0);
38
- expect(JSON.parse(result.stdout).enabled).toBe(false);
39
- const configPath = path.join(xdgConfig, "akm", "config.json");
40
- const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
41
- const skillsRegistry = config.registries?.find((entry) => entry.name === "skills.sh" || entry.provider === "skills-sh");
42
- expect(skillsRegistry).toBeDefined();
43
- expect(skillsRegistry?.enabled).toBe(false);
44
- });
45
- test("akm enable <unsupported-target> exits with usage error", () => {
46
- const xdgConfig = makeTempDir("akm-toggle-config-");
47
- const xdgCache = makeTempDir("akm-toggle-cache-");
48
- const stashDir = makeTempDir("akm-toggle-stash-");
49
- const result = runCli(["enable", "context-hub", "--format=json"], {
50
- ...process.env,
51
- XDG_CONFIG_HOME: xdgConfig,
52
- XDG_CACHE_HOME: xdgCache,
53
- AKM_STASH_DIR: stashDir,
54
- });
55
- expect(result.status).not.toBe(0);
56
- const combined = `${result.stdout}\n${result.stderr}`;
57
- expect(combined).toContain("Unsupported target");
58
- });
59
- test("akm disable <unsupported-target> exits with usage error", () => {
60
- const xdgConfig = makeTempDir("akm-toggle-config-");
61
- const xdgCache = makeTempDir("akm-toggle-cache-");
62
- const stashDir = makeTempDir("akm-toggle-stash-");
63
- const result = runCli(["disable", "context-hub", "--format=json"], {
64
- ...process.env,
65
- XDG_CONFIG_HOME: xdgConfig,
66
- XDG_CACHE_HOME: xdgCache,
67
- AKM_STASH_DIR: stashDir,
68
- });
69
- expect(result.status).not.toBe(0);
70
- const combined = `${result.stdout}\n${result.stderr}`;
71
- expect(combined).toContain("Unsupported target");
72
- });
73
- });