akm-cli 0.7.0 → 0.7.2

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