@detergent-software/atk 9.4.0-dev.8 → 9.4.0

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 (204) hide show
  1. package/CHANGELOG.md +398 -0
  2. package/README.md +7 -2
  3. package/build/command-manifest.json +33 -7
  4. package/build/commands/_app.d.ts.map +1 -1
  5. package/build/commands/_app.js +4 -2
  6. package/build/commands/_app.js.map +1 -1
  7. package/build/commands/audit.d.ts.map +1 -1
  8. package/build/commands/audit.js +7 -4
  9. package/build/commands/audit.js.map +1 -1
  10. package/build/commands/diff.d.ts.map +1 -1
  11. package/build/commands/diff.js +10 -10
  12. package/build/commands/diff.js.map +1 -1
  13. package/build/commands/doctor.d.ts.map +1 -1
  14. package/build/commands/doctor.js +1 -1
  15. package/build/commands/doctor.js.map +1 -1
  16. package/build/commands/info.d.ts.map +1 -1
  17. package/build/commands/info.js +16 -14
  18. package/build/commands/info.js.map +1 -1
  19. package/build/commands/init.d.ts.map +1 -1
  20. package/build/commands/init.js +1 -1
  21. package/build/commands/init.js.map +1 -1
  22. package/build/commands/install.d.ts.map +1 -1
  23. package/build/commands/install.js +145 -64
  24. package/build/commands/install.js.map +1 -1
  25. package/build/commands/move.d.ts.map +1 -1
  26. package/build/commands/move.js +5 -4
  27. package/build/commands/move.js.map +1 -1
  28. package/build/commands/outdated.js +1 -1
  29. package/build/commands/outdated.js.map +1 -1
  30. package/build/commands/sync.d.ts.map +1 -1
  31. package/build/commands/sync.js +6 -4
  32. package/build/commands/sync.js.map +1 -1
  33. package/build/commands/update.d.ts +1 -1
  34. package/build/commands/update.d.ts.map +1 -1
  35. package/build/commands/update.js +1 -1
  36. package/build/commands/update.js.map +1 -1
  37. package/build/commands/upgrade.d.ts +16 -0
  38. package/build/commands/upgrade.d.ts.map +1 -0
  39. package/build/commands/upgrade.js +64 -0
  40. package/build/commands/upgrade.js.map +1 -0
  41. package/build/commands/why.d.ts.map +1 -1
  42. package/build/commands/why.js +28 -7
  43. package/build/commands/why.js.map +1 -1
  44. package/build/components/DiffView.d.ts +3 -1
  45. package/build/components/DiffView.d.ts.map +1 -1
  46. package/build/components/DiffView.js +18 -4
  47. package/build/components/DiffView.js.map +1 -1
  48. package/build/components/EnabledEntriesHint.d.ts +14 -0
  49. package/build/components/EnabledEntriesHint.d.ts.map +1 -0
  50. package/build/components/EnabledEntriesHint.js +13 -0
  51. package/build/components/EnabledEntriesHint.js.map +1 -0
  52. package/build/components/InitSuccess.d.ts.map +1 -1
  53. package/build/components/InitSuccess.js +4 -1
  54. package/build/components/InitSuccess.js.map +1 -1
  55. package/build/components/InstallSummary.d.ts +7 -2
  56. package/build/components/InstallSummary.d.ts.map +1 -1
  57. package/build/components/InstallSummary.js +3 -1
  58. package/build/components/InstallSummary.js.map +1 -1
  59. package/build/components/LeftoverFilesHint.d.ts +21 -0
  60. package/build/components/LeftoverFilesHint.d.ts.map +1 -0
  61. package/build/components/LeftoverFilesHint.js +13 -0
  62. package/build/components/LeftoverFilesHint.js.map +1 -0
  63. package/build/components/index.d.ts +2 -0
  64. package/build/components/index.d.ts.map +1 -1
  65. package/build/components/index.js +2 -0
  66. package/build/components/index.js.map +1 -1
  67. package/build/hooks/useInitState.d.ts +9 -1
  68. package/build/hooks/useInitState.d.ts.map +1 -1
  69. package/build/hooks/useInitState.js +52 -10
  70. package/build/hooks/useInitState.js.map +1 -1
  71. package/build/hooks/useListActions.d.ts.map +1 -1
  72. package/build/hooks/useListActions.js +4 -1
  73. package/build/hooks/useListActions.js.map +1 -1
  74. package/build/hooks/useUninstallState.d.ts.map +1 -1
  75. package/build/hooks/useUninstallState.js +46 -23
  76. package/build/hooks/useUninstallState.js.map +1 -1
  77. package/build/lib/adapter.d.ts +14 -9
  78. package/build/lib/adapter.d.ts.map +1 -1
  79. package/build/lib/adapter.js +46 -8
  80. package/build/lib/adapter.js.map +1 -1
  81. package/build/lib/api-client.d.ts.map +1 -1
  82. package/build/lib/api-client.js +2 -1
  83. package/build/lib/api-client.js.map +1 -1
  84. package/build/lib/asset-tools.d.ts +8 -0
  85. package/build/lib/asset-tools.d.ts.map +1 -1
  86. package/build/lib/asset-tools.js +14 -0
  87. package/build/lib/asset-tools.js.map +1 -1
  88. package/build/lib/completion/candidates.d.ts.map +1 -1
  89. package/build/lib/completion/candidates.js +21 -8
  90. package/build/lib/completion/candidates.js.map +1 -1
  91. package/build/lib/config-entries.d.ts +3 -3
  92. package/build/lib/config-entries.d.ts.map +1 -1
  93. package/build/lib/config-entries.js +16 -6
  94. package/build/lib/config-entries.js.map +1 -1
  95. package/build/lib/config-lock.d.ts +2 -1
  96. package/build/lib/config-lock.d.ts.map +1 -1
  97. package/build/lib/config-lock.js +10 -2
  98. package/build/lib/config-lock.js.map +1 -1
  99. package/build/lib/cross-scope.d.ts +6 -2
  100. package/build/lib/cross-scope.d.ts.map +1 -1
  101. package/build/lib/cross-scope.js +20 -13
  102. package/build/lib/cross-scope.js.map +1 -1
  103. package/build/lib/diagnostics.d.ts +3 -2
  104. package/build/lib/diagnostics.d.ts.map +1 -1
  105. package/build/lib/diagnostics.js +11 -11
  106. package/build/lib/diagnostics.js.map +1 -1
  107. package/build/lib/diff-command.d.ts +9 -3
  108. package/build/lib/diff-command.d.ts.map +1 -1
  109. package/build/lib/diff-command.js +58 -21
  110. package/build/lib/diff-command.js.map +1 -1
  111. package/build/lib/diff.d.ts +8 -4
  112. package/build/lib/diff.d.ts.map +1 -1
  113. package/build/lib/diff.js +23 -4
  114. package/build/lib/diff.js.map +1 -1
  115. package/build/lib/doctor-fix.d.ts +8 -3
  116. package/build/lib/doctor-fix.d.ts.map +1 -1
  117. package/build/lib/doctor-fix.js +50 -3
  118. package/build/lib/doctor-fix.js.map +1 -1
  119. package/build/lib/enabled-list.d.ts +7 -3
  120. package/build/lib/enabled-list.d.ts.map +1 -1
  121. package/build/lib/enabled-list.js +7 -5
  122. package/build/lib/enabled-list.js.map +1 -1
  123. package/build/lib/gitignore.d.ts +8 -0
  124. package/build/lib/gitignore.d.ts.map +1 -1
  125. package/build/lib/gitignore.js +51 -6
  126. package/build/lib/gitignore.js.map +1 -1
  127. package/build/lib/hook-config.d.ts +90 -7
  128. package/build/lib/hook-config.d.ts.map +1 -1
  129. package/build/lib/hook-config.js +135 -11
  130. package/build/lib/hook-config.js.map +1 -1
  131. package/build/lib/hook-script.d.ts +45 -0
  132. package/build/lib/hook-script.d.ts.map +1 -1
  133. package/build/lib/hook-script.js +118 -1
  134. package/build/lib/hook-script.js.map +1 -1
  135. package/build/lib/init.d.ts +34 -12
  136. package/build/lib/init.d.ts.map +1 -1
  137. package/build/lib/init.js +180 -32
  138. package/build/lib/init.js.map +1 -1
  139. package/build/lib/install-targets.d.ts +35 -8
  140. package/build/lib/install-targets.d.ts.map +1 -1
  141. package/build/lib/install-targets.js +87 -14
  142. package/build/lib/install-targets.js.map +1 -1
  143. package/build/lib/installer.d.ts +15 -5
  144. package/build/lib/installer.d.ts.map +1 -1
  145. package/build/lib/installer.js +201 -41
  146. package/build/lib/installer.js.map +1 -1
  147. package/build/lib/local-edits.d.ts +15 -2
  148. package/build/lib/local-edits.d.ts.map +1 -1
  149. package/build/lib/local-edits.js +40 -13
  150. package/build/lib/local-edits.js.map +1 -1
  151. package/build/lib/lockfile.d.ts +2 -2
  152. package/build/lib/lockfile.js +4 -4
  153. package/build/lib/lockfile.js.map +1 -1
  154. package/build/lib/mover.d.ts +5 -4
  155. package/build/lib/mover.d.ts.map +1 -1
  156. package/build/lib/mover.js +43 -35
  157. package/build/lib/mover.js.map +1 -1
  158. package/build/lib/multi-tool-install.d.ts +28 -5
  159. package/build/lib/multi-tool-install.d.ts.map +1 -1
  160. package/build/lib/multi-tool-install.js +105 -26
  161. package/build/lib/multi-tool-install.js.map +1 -1
  162. package/build/lib/named-entry.d.ts +12 -0
  163. package/build/lib/named-entry.d.ts.map +1 -1
  164. package/build/lib/named-entry.js +16 -8
  165. package/build/lib/named-entry.js.map +1 -1
  166. package/build/lib/notices.d.ts +2 -0
  167. package/build/lib/notices.d.ts.map +1 -1
  168. package/build/lib/notices.js +10 -0
  169. package/build/lib/notices.js.map +1 -1
  170. package/build/lib/schemas/adapter.d.ts +33 -0
  171. package/build/lib/schemas/adapter.d.ts.map +1 -1
  172. package/build/lib/schemas/adapter.js +31 -5
  173. package/build/lib/schemas/adapter.js.map +1 -1
  174. package/build/lib/self-upgrade.d.ts +66 -0
  175. package/build/lib/self-upgrade.d.ts.map +1 -0
  176. package/build/lib/self-upgrade.js +183 -0
  177. package/build/lib/self-upgrade.js.map +1 -0
  178. package/build/lib/sync.d.ts +39 -0
  179. package/build/lib/sync.d.ts.map +1 -1
  180. package/build/lib/sync.js +181 -10
  181. package/build/lib/sync.js.map +1 -1
  182. package/build/lib/touched-paths.d.ts.map +1 -1
  183. package/build/lib/touched-paths.js +2 -1
  184. package/build/lib/touched-paths.js.map +1 -1
  185. package/build/lib/uninstaller.d.ts +29 -1
  186. package/build/lib/uninstaller.d.ts.map +1 -1
  187. package/build/lib/uninstaller.js +99 -5
  188. package/build/lib/uninstaller.js.map +1 -1
  189. package/build/lib/update-check.d.ts +27 -1
  190. package/build/lib/update-check.d.ts.map +1 -1
  191. package/build/lib/update-check.js +74 -8
  192. package/build/lib/update-check.js.map +1 -1
  193. package/build/lib/updater.d.ts +2 -0
  194. package/build/lib/updater.d.ts.map +1 -1
  195. package/build/lib/updater.js +36 -3
  196. package/build/lib/updater.js.map +1 -1
  197. package/build/lib/version.d.ts +12 -4
  198. package/build/lib/version.d.ts.map +1 -1
  199. package/build/lib/version.js +19 -7
  200. package/build/lib/version.js.map +1 -1
  201. package/package.json +1 -1
  202. package/tool-adapters/claude-code.json +2 -1
  203. package/tool-adapters/codex-cli.json +5 -1
  204. package/tool-adapters/copilot-cli.json +58 -9
package/CHANGELOG.md CHANGED
@@ -1,3 +1,401 @@
1
+ ## [9.4.0](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.3.0&targetVersion=GTv9.4.0) (2026-11-02)
2
+
3
+ ### Features
4
+
5
+ * **cli:** accept a manifest preferredScope and show it in atk info (ATK-715) ([ee8889f](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ee8889f7b7c57f8f7bfed0d854f936eff666b770))
6
+ * **cli:** atk upgrade installs the newest CLI from npm (ATK-873) ([8e2bb24](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8e2bb245a287bf07a9d36a0cf9fe7a9abb3da174))
7
+ * **cli:** build a hook's hookConfig from its Copilot hook file (ATK-819) ([db0ed0c](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/db0ed0c8bad6999ce02d7f1fee9093eb3defbdf0))
8
+ * **cli:** complete global:name for a shadowed global asset (ATK-806) ([1f248b4](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1f248b4afd26b963e3c3e794f9301a0d99791a18))
9
+ * **cli:** name the global entry with global:name (ATK-792) ([ea040a1](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ea040a17b050ce539fdadfa755a56eb583ffaa61))
10
+ * **cli:** offer an asset's preferred install scope in atk install (ATK-715) ([68e4837](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/68e4837ecfb518a372911181ff5d3e8c5dbf9110))
11
+ * **cli:** read global:name in move, why, diff and info (ATK-806) ([14f621e](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/14f621e575dc16120639cb962427550f185e2837))
12
+ * **cli:** run script hooks in Copilot CLI from a generated hook file ([c44fbbb](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/c44fbbbb0ce7d95673085cfb1f6f57b628bf148d))
13
+
14
+ ### Bug Fixes
15
+
16
+ * **cli:** act on the code review of atk upgrade (ATK-873) ([864a272](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/864a2722bef7bbdeb00bd92ad99c8d703f9b32d2))
17
+ * **cli:** act on the review of atk upgrade (ATK-873) ([04fa74a](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/04fa74a66fbac2d5c862ee1e28875e9dfa7e5c7f))
18
+ * **cli:** approve the mcp servers sync leaves in place (ATK-867) ([a3b3d75](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a3b3d752de2aedab98f36af2f9af386560ef2309))
19
+ * **cli:** check installed dependents of an asset named directly (ATK-811) ([4695684](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/4695684d2fe03a8b527b2feab67e1de7a1dbd7d9))
20
+ * **cli:** check moved dependencies once every plan entry is decided (ATK-207) ([ebed92f](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ebed92fdff13b7f655aa917858a888a4809be1cf))
21
+ * **cli:** compare the resolved version of a named asset in place (ATK-814) ([3e46afb](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/3e46afb3c2f10dd9984cae58401effa24bd25071))
22
+ * **cli:** compare the resolved version of an installed asset (ATK-812) ([990ee76](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/990ee76a1cb927a68e775d180579cf469dec5ed6))
23
+ * **cli:** count a line-ending-only difference as unchanged in atk diff (ATK-805) ([d63896e](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/d63896ec4782fd0c6c1c6207f69a1a3003afe894))
24
+ * **cli:** count an update run's assets at the version they move to (ATK-207) ([384a701](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/384a701b9c21f84769b7230b946b4615479855bb))
25
+ * **cli:** count diff lines without the final newline and label the no-newline marker (ATK-859) ([99360ec](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/99360ec825f44e04b951d1e4024e6b375cfbb595))
26
+ * **cli:** count plan entries kept as installed as dependents (ATK-207) ([8fd20d4](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8fd20d40b3b55fd954274a242811dcd92552311d))
27
+ * **cli:** diff a CRLF file line by line in atk diff (ATK-858) ([4820cc8](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/4820cc8a9624038cadd41951ad30fd9ec62f52ea))
28
+ * **cli:** don't place a script hook as Copilot's hook config ([b1af5e7](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/b1af5e743c363e25c692ecd3718b7d1cb3f2bd5c))
29
+ * **cli:** download no dependency every tool of an install skips (ATK-809) ([f085969](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/f0859698fac313179a020adcd4e888430037bbe0))
30
+ * **cli:** drop retired Copilot MCP files from the ATK gitignore block (ATK-823) ([7532ecf](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/7532ecf6b2a2e2ceeee244f8a425bd9be7163c1f))
31
+ * **cli:** fail the CI gates on a sign-in failure, not a stale cache (ATK-744) ([0297da8](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/0297da83755304c8883873a70ccb90f1fdadabf8))
32
+ * **cli:** find a Copilot hook ATK-482 kept in ~/.copilot/hooks (ATK-821) ([a10ded1](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a10ded13ae4e06362b1d6139a7b8fde069f3b606))
33
+ * **cli:** find a per-user Git Bash and fail when no bash starts ([9684085](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/9684085a2d6eb300986f9695b92a8d9451e64248))
34
+ * **cli:** fork an installed hook with its registry hookConfig (ATK-826) ([c76bb10](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/c76bb10e712b16f2cdeb7c037384c729e7ca69e9))
35
+ * **cli:** hide the update banner in atk upgrade and after doctor's upgrade (ATK-877) ([a80cfd2](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a80cfd29f2411033fa203c3011cde4b865c141f7))
36
+ * **cli:** install the version asked for of an installed dependency (ATK-812) ([2fe2534](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/2fe2534d5a2ef9f3457323a10216d562c31f0021))
37
+ * **cli:** keep a Copilot hook timeout Claude Code's binding lacks (ATK-819) ([9ed76a6](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/9ed76a62a4fb2286a726b594483a1dcfe860e78c))
38
+ * **cli:** keep a fork's own file under the new entrypoint name (ATK-825) ([2bd3154](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/2bd31543cb62385e5620ddb9c964eab5eb82c074))
39
+ * **cli:** keep a retired MCP file ignored until ATK's servers leave it (ATK-823) ([99b4119](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/99b41198d74ad13c83dedebe634a0bcf4fbeabcb))
40
+ * **cli:** keep Copilot's .sh hook running from a path with a space ([09b32a8](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/09b32a8c7ea04d70db98481e56714d5b881d93ec))
41
+ * **cli:** keep move's own refusals for a name it doesn't reach (ATK-806) ([83c053c](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/83c053c593c1c98f39ed3e452002e6773c8e54ef))
42
+ * **cli:** keep or move a dependency for every tool from atk list's update (ATK-241) ([f8c63ea](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/f8c63ea8bcddd6b91b2889c624d8398c898e9c71))
43
+ * **cli:** keep or move a dependency for every tool in a multi-tool update (ATK-241) ([f14c778](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/f14c77863c8d7a258d716998cb174b37165b1333))
44
+ * **cli:** keep the placed paths of a dependency recorded unplaced ([6004926](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/60049268adaa0bc54bdb805ccb707ddd1873bd61))
45
+ * **cli:** keep the resolved asset when install moves to its preferred scope (ATK-715) ([74e13ae](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/74e13ae2ca750ea570ed0cd999ecf52c6ffbf2de))
46
+ * **cli:** keep the script a JSON hook version places beside its JSON ([7ca3d4d](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/7ca3d4dcf6c3ceff90457589d24ce13fbea65702))
47
+ * **cli:** key the leftover-files lines by type and name (ATK-857) ([1e7bea2](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1e7bea2a3e3742a9a3b730761a9edb343d52fc84))
48
+ * **cli:** leave a dependency uninstalled for a tool in update and install (ATK-809) ([7f0e16c](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/7f0e16ce5d6e3f2ac7416620c0cfbb549292fbb7))
49
+ * **cli:** leave a hook Copilot can't take out of update, list and notices ([985de88](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/985de88efb2ca30ef08343a421334ac2815fe377))
50
+ * **cli:** leave a hook file or script another installed hook owns ([17bf234](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/17bf234a6dade299af29fc659dc4622b1d1136ff))
51
+ * **cli:** leave Copilot hook registration to the hook's own config ([8856daf](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8856daf2f006406c5728aac477cee982b208369f))
52
+ * **cli:** let Copilot on Windows parse Claude Code's .sh hook command ([ee7c507](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ee7c5073eb12fce446f5a8d147c622a1b4db8e29))
53
+ * **cli:** let Copilot's .sh hook run beside an old unquoted entry ([f1bc2cd](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/f1bc2cd325aafe1d86fb5e52ea2e64f65ec14e81))
54
+ * **cli:** limit the registry files pre-filter to copies in place (ATK-856) ([0167047](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/016704720123f818de9aa5cf15b968caf94bbdba))
55
+ * **cli:** make a renamed init --from fork the new entrypoint (ATK-825) ([0e69ebe](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/0e69ebe1ccf8f12937ba957165ca16150ef70a49))
56
+ * **cli:** match a leftover file by its path as well (ATK-854) ([588ebe5](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/588ebe57c86611de5475c008813e2db29fcac736))
57
+ * **cli:** name a shadowed global entry in diff's update hint (ATK-806) ([9df6d2f](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/9df6d2f1400e2c7fa9d302a07e981b61a0a270e7))
58
+ * **cli:** name no command in the moved-dependency refusal (ATK-207) ([6d07746](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/6d07746a5125ffc57ff178bf2f79ed25afc66228))
59
+ * **cli:** name shadowed global entries in more hints (ATK-792) ([8b7cc65](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8b7cc657830fbc5b20a7c4eefb115613b5aacbb0))
60
+ * **cli:** name the global entry exactly in uninstall's refusal (ATK-855) ([8d1fbab](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8d1fbab03c687d66c81832e3149cef46b93b15e1))
61
+ * **cli:** name the root in diff's Installed as refusal (ATK-829) ([0d7f67d](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/0d7f67d3a00fff9d44290cba9f42ac83637dd9b2))
62
+ * **cli:** name the scaffolded entrypoint in init's next steps (ATK-831) ([1a4efa8](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1a4efa8a2895b0b6af1f75bbb55d04e6047766ae))
63
+ * **cli:** notify the banner's subscribers on reset (ATK-877) ([cbc3a0d](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/cbc3a0de58d57ac17ba4c9044cd7f72a2c7b949b))
64
+ * **cli:** offer no global:name with --org, and echo it in diff's usage errors (ATK-806) ([ca93bd3](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ca93bd31f5ec54701b466083a4989480b6d9c190))
65
+ * **cli:** pin a bundle in place and dry-run an asset in place (ATK-815) ([59a6673](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/59a6673fa0d0ae3d988d26c993661422ea89a289))
66
+ * **cli:** pin an installed asset with install --pin (ATK-813) ([eee4550](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/eee45503a7bbbd700d703f0a08c1523eb33702da))
67
+ * **cli:** pin at the version the install leaves (ATK-813) ([2484325](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/24843251b7f59c12b10c4ba67a8e531ac25001de))
68
+ * **cli:** place Copilot project MCP servers in .github/mcp.json (ATK-823) ([8b0ba0c](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8b0ba0c43a67fa132359492f5d183957699e6aad))
69
+ * **cli:** place Copilot user assets in COPILOT_HOME (ATK-821) ([762b93b](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/762b93bd6b8561aae7aebeb0983871ee38a327d6))
70
+ * **cli:** prefer the forked type across scopes in init --from (ATK-847) ([ca7f22e](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ca7f22e3b00504fdf688cc9da030d15268a4c265))
71
+ * **cli:** put back a recorded dependency when a multi-tool run fails (ATK-853) ([ec6ddec](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ec6ddecd6332f3c9cf809c9d1200eb75fd653d81))
72
+ * **cli:** quote $CLAUDE_PROJECT_DIR in Claude Code's .sh hook command ([4273838](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/4273838175efa2dfbcc20a15de6c4f7f70e5550b))
73
+ * **cli:** read a forked hook's events only for a hook (ATK-826) ([7ed1efc](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/7ed1efc4c7ac25e44f4ac8d7818a8e5354b82f31))
74
+ * **cli:** record a dependency every tool of a run has uninstalled (ATK-810) ([96bce99](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/96bce99c2f1e16c592c2ce684b53b657c17ad468))
75
+ * **cli:** refuse a leftover file outside the project in a dry run too (ATK-857) ([4423eb0](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/4423eb0fd740bfbbdaaf1e28ad0e24a0ba740d7b))
76
+ * **cli:** refuse diff @org/name the org hasn't installed (ATK-829) ([eef788a](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/eef788a12f24933fc6c7b167d402138177505696))
77
+ * **cli:** refuse to move a dependency an installed dependent rejects (ATK-207) ([4791bf5](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/4791bf5a0c910312df57cef69dd6c593547cfadd))
78
+ * **cli:** refuse uninstall @org/name the org hasn't installed (ATK-855) ([e38dce4](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/e38dce4d5912331603b404bb72ec9a7615d3c8db))
79
+ * **cli:** remove an old version's files from a copy sync finds in place (ATK-856) ([46504d9](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/46504d9919e0a84947d1379f9fd3ee0b4ae87324))
80
+ * **cli:** remove files another version left when sync reinstalls (ATK-854) ([fe5bb76](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/fe5bb765a1919a125fdc310de04efc2f79c8f2fd))
81
+ * **cli:** rename an installed fork's recorded entrypoint (ATK-832) ([81cfc06](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/81cfc0697bb138fc345b339735faa6f4856903e6))
82
+ * **cli:** replace a Copilot hook's other-kind file when its entrypoint changes kind ([1308a6c](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1308a6c843456f6aa303024ab4ab918f46946540))
83
+ * **cli:** report a hook Copilot can't take as skipped, not excluded ([b3e6597](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/b3e659750d5dd48518c961dee749702c5114687e))
84
+ * **cli:** report the files other versions left that sync removes (ATK-857) ([36a2608](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/36a2608a7f8052acb167887f08348df402f988b4))
85
+ * **cli:** resolve init --from by org and type (ATK-847) ([00001be](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/00001be9caa26c8981b38e60df626f6fd4903012))
86
+ * **cli:** restore recorded dependencies before the per-tool rollbacks ([8451ebc](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8451ebca8ac6a1ab31795a4d89d1c806b14e1c50))
87
+ * **cli:** run a Copilot .sh hook with Git Bash on Windows ([a0080ce](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a0080cedd654241e9ba249c7b49d7d88c549faf7))
88
+ * **cli:** run a hook once in Copilot when Claude Code has it too ([2b93950](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/2b93950cba5dd0fff9e0aad8f4a753966be136a8))
89
+ * **cli:** run an .mjs hook with node for Codex CLI ([57594c9](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/57594c9b1f35d4c0de5c07221cb5d343d465916d))
90
+ * **cli:** say when --force moves a pinned asset off its pin (ATK-811) ([9de9fca](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/9de9fcac6a187cfa23a061ed0e6f8303ec2c0b83))
91
+ * **cli:** scaffold a hook forked from an .mjs script as an .mjs hook (ATK-831) ([eb6b3ed](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/eb6b3ed2b9d8ec83ea431e01e21b129c71498077))
92
+ * **cli:** show an .mjs hook's node command in its init README ([d430178](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/d430178d9a89b3acefbe82ed9b37911acbaba141))
93
+ * **cli:** step aside in Copilot only when Claude Code's script is there ([1788e29](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1788e29f95bdcfb297462c0e0643108669046b6b))
94
+ * **cli:** strip CR and mark a missing final newline in added and removed file diffs (ATK-860) ([157c5f3](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/157c5f3e863863b43de206b6e1bf557a1d429d58))
95
+ * **cli:** suggest global:name for a shadowed global entry (ATK-792) ([2e4dd51](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/2e4dd51c26170ed0f7f7754741c8a9917a225522))
96
+ * **cli:** suggest global:name in the pin and cross-scope hints (ATK-806) ([e9e7252](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/e9e7252f045e6a9afd7d67905707405c0f8abaf2))
97
+ * **cli:** wait for a config lock Windows is still deleting (ATK-827) ([3108d09](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/3108d09ff810a0d5688268f9ae24847cf02a3d5f))
98
+ * **cli:** write a forked hook's hookConfig into its manifest (ATK-819) ([30ebc33](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/30ebc3348b9a5d52fafd4d2e39bc36a28b7f8b69))
99
+
100
+ ### Performance
101
+
102
+ * **cli:** skip fetching installed files with equal blobs in atk diff (ATK-791) ([76a863b](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/76a863b02397299123d8d879f58fc4316ab9b143))
103
+
104
+ ### Refactoring
105
+
106
+ * **cli:** report a bundle's pin from the plan (ATK-815) ([1ad2243](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1ad2243fcad84eda46a77aa6d174c09a447ae44c))
107
+ * **cli:** require the recorded paths configDirMove reads (ATK-821) ([a695a1b](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a695a1b7b5ab5e17549222d7bc7d1d02cf82a1cd))
108
+
109
+ ### Styling
110
+
111
+ * **cli:** sort InitOptions.forkEntrypoint before from (ATK-831) ([5cebe68](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/5cebe689ed7c27c40783b2422dba05a1fff7b874))
112
+
113
+ ### Documentation
114
+
115
+ * **cli:** describe the *.fs.test.ts convention (ATK-841) ([a75c097](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a75c0971d3fa3352ae32b5d9e14a5aa96fbb365b))
116
+ * **cli:** name global: in init --from's help (ATK-847) ([864961b](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/864961b18a538f5bdf823901a09392d6a63b9f8c))
117
+ * **cli:** say sync --check needs --refresh to always check the token (ATK-744) ([5de8f1b](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/5de8f1b1b43a98409c520fbc3f03c9cbbb957c1a))
118
+
119
+ ## [9.4.0-dev.44](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.43&targetVersion=GTv9.4.0-dev.44) (2026-11-01)
120
+
121
+ ### Bug Fixes
122
+
123
+ * **cli:** hide the update banner in atk upgrade and after doctor's upgrade (ATK-877) ([a80cfd2](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a80cfd29f2411033fa203c3011cde4b865c141f7))
124
+ * **cli:** notify the banner's subscribers on reset (ATK-877) ([cbc3a0d](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/cbc3a0de58d57ac17ba4c9044cd7f72a2c7b949b))
125
+
126
+ ## [9.4.0-dev.43](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.42&targetVersion=GTv9.4.0-dev.43) (2026-11-01)
127
+
128
+ ### Features
129
+
130
+ * **cli:** atk upgrade installs the newest CLI from npm (ATK-873) ([8e2bb24](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8e2bb245a287bf07a9d36a0cf9fe7a9abb3da174))
131
+
132
+ ### Bug Fixes
133
+
134
+ * **cli:** act on the code review of atk upgrade (ATK-873) ([864a272](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/864a2722bef7bbdeb00bd92ad99c8d703f9b32d2))
135
+ * **cli:** act on the review of atk upgrade (ATK-873) ([04fa74a](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/04fa74a66fbac2d5c862ee1e28875e9dfa7e5c7f))
136
+
137
+ ## [9.4.0-dev.42](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.41&targetVersion=GTv9.4.0-dev.42) (2026-10-31)
138
+
139
+ ### Bug Fixes
140
+
141
+ * **cli:** approve the mcp servers sync leaves in place (ATK-867) ([a3b3d75](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a3b3d752de2aedab98f36af2f9af386560ef2309))
142
+
143
+ ## [9.4.0-dev.41](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.40&targetVersion=GTv9.4.0-dev.41) (2026-10-30)
144
+
145
+ ### Bug Fixes
146
+
147
+ * **cli:** strip CR and mark a missing final newline in added and removed file diffs (ATK-860) ([157c5f3](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/157c5f3e863863b43de206b6e1bf557a1d429d58))
148
+
149
+ ## [9.4.0-dev.40](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.39&targetVersion=GTv9.4.0-dev.40) (2026-10-30)
150
+
151
+ ### Bug Fixes
152
+
153
+ * **cli:** count diff lines without the final newline and label the no-newline marker (ATK-859) ([99360ec](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/99360ec825f44e04b951d1e4024e6b375cfbb595))
154
+
155
+ ## [9.4.0-dev.39](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.38&targetVersion=GTv9.4.0-dev.39) (2026-10-30)
156
+
157
+ ### Bug Fixes
158
+
159
+ * **cli:** diff a CRLF file line by line in atk diff (ATK-858) ([4820cc8](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/4820cc8a9624038cadd41951ad30fd9ec62f52ea))
160
+
161
+ ## [9.4.0-dev.38](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.37&targetVersion=GTv9.4.0-dev.38) (2026-10-30)
162
+
163
+ ### Bug Fixes
164
+
165
+ * **cli:** count a line-ending-only difference as unchanged in atk diff (ATK-805) ([d63896e](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/d63896ec4782fd0c6c1c6207f69a1a3003afe894))
166
+
167
+ ## [9.4.0-dev.37](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.36&targetVersion=GTv9.4.0-dev.37) (2026-10-30)
168
+
169
+ ### Bug Fixes
170
+
171
+ * **cli:** key the leftover-files lines by type and name (ATK-857) ([1e7bea2](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1e7bea2a3e3742a9a3b730761a9edb343d52fc84))
172
+ * **cli:** refuse a leftover file outside the project in a dry run too (ATK-857) ([4423eb0](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/4423eb0fd740bfbbdaaf1e28ad0e24a0ba740d7b))
173
+ * **cli:** report the files other versions left that sync removes (ATK-857) ([36a2608](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/36a2608a7f8052acb167887f08348df402f988b4))
174
+
175
+ ## [9.4.0-dev.36](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.35&targetVersion=GTv9.4.0-dev.36) (2026-10-30)
176
+
177
+ ### Bug Fixes
178
+
179
+ * **cli:** name the global entry exactly in uninstall's refusal (ATK-855) ([8d1fbab](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8d1fbab03c687d66c81832e3149cef46b93b15e1))
180
+ * **cli:** refuse uninstall @org/name the org hasn't installed (ATK-855) ([e38dce4](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/e38dce4d5912331603b404bb72ec9a7615d3c8db))
181
+
182
+ ## [9.4.0-dev.35](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.34&targetVersion=GTv9.4.0-dev.35) (2026-10-30)
183
+
184
+ ### Bug Fixes
185
+
186
+ * **cli:** limit the registry files pre-filter to copies in place (ATK-856) ([0167047](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/016704720123f818de9aa5cf15b968caf94bbdba))
187
+ * **cli:** remove an old version's files from a copy sync finds in place (ATK-856) ([46504d9](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/46504d9919e0a84947d1379f9fd3ee0b4ae87324))
188
+
189
+ ## [9.4.0-dev.34](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.33&targetVersion=GTv9.4.0-dev.34) (2026-10-30)
190
+
191
+ ### Bug Fixes
192
+
193
+ * **cli:** put back a recorded dependency when a multi-tool run fails (ATK-853) ([ec6ddec](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ec6ddecd6332f3c9cf809c9d1200eb75fd653d81))
194
+ * **cli:** restore recorded dependencies before the per-tool rollbacks ([8451ebc](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8451ebca8ac6a1ab31795a4d89d1c806b14e1c50))
195
+
196
+ ## [9.4.0-dev.33](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.32&targetVersion=GTv9.4.0-dev.33) (2026-10-30)
197
+
198
+ ### Bug Fixes
199
+
200
+ * **cli:** match a leftover file by its path as well (ATK-854) ([588ebe5](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/588ebe57c86611de5475c008813e2db29fcac736))
201
+ * **cli:** remove files another version left when sync reinstalls (ATK-854) ([fe5bb76](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/fe5bb765a1919a125fdc310de04efc2f79c8f2fd))
202
+
203
+ ## [9.4.0-dev.32](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.31&targetVersion=GTv9.4.0-dev.32) (2026-10-30)
204
+
205
+ ### Bug Fixes
206
+
207
+ * **cli:** name the root in diff's Installed as refusal (ATK-829) ([0d7f67d](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/0d7f67d3a00fff9d44290cba9f42ac83637dd9b2))
208
+ * **cli:** refuse diff @org/name the org hasn't installed (ATK-829) ([eef788a](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/eef788a12f24933fc6c7b167d402138177505696))
209
+
210
+ ## [9.4.0-dev.31](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.30&targetVersion=GTv9.4.0-dev.31) (2026-10-29)
211
+
212
+ ### Bug Fixes
213
+
214
+ * **cli:** keep the placed paths of a dependency recorded unplaced ([6004926](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/60049268adaa0bc54bdb805ccb707ddd1873bd61))
215
+ * **cli:** record a dependency every tool of a run has uninstalled (ATK-810) ([96bce99](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/96bce99c2f1e16c592c2ce684b53b657c17ad468))
216
+
217
+ ## [9.4.0-dev.30](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.29&targetVersion=GTv9.4.0-dev.30) (2026-10-29)
218
+
219
+ ### Bug Fixes
220
+
221
+ * **cli:** keep the script a JSON hook version places beside its JSON ([7ca3d4d](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/7ca3d4dcf6c3ceff90457589d24ce13fbea65702))
222
+ * **cli:** leave a hook file or script another installed hook owns ([17bf234](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/17bf234a6dade299af29fc659dc4622b1d1136ff))
223
+ * **cli:** replace a Copilot hook's other-kind file when its entrypoint changes kind ([1308a6c](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1308a6c843456f6aa303024ab4ab918f46946540))
224
+
225
+ ## [9.4.0-dev.29](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.28&targetVersion=GTv9.4.0-dev.29) (2026-10-29)
226
+
227
+ ### Bug Fixes
228
+
229
+ * **cli:** let Copilot on Windows parse Claude Code's .sh hook command ([ee7c507](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ee7c5073eb12fce446f5a8d147c622a1b4db8e29))
230
+
231
+ ## [9.4.0-dev.28](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.27&targetVersion=GTv9.4.0-dev.28) (2026-10-29)
232
+
233
+ ### Bug Fixes
234
+
235
+ * **cli:** let Copilot's .sh hook run beside an old unquoted entry ([f1bc2cd](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/f1bc2cd325aafe1d86fb5e52ea2e64f65ec14e81))
236
+ * **cli:** quote $CLAUDE_PROJECT_DIR in Claude Code's .sh hook command ([4273838](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/4273838175efa2dfbcc20a15de6c4f7f70e5550b))
237
+
238
+ ## [9.4.0-dev.27](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.26&targetVersion=GTv9.4.0-dev.27) (2026-10-29)
239
+
240
+ ### Bug Fixes
241
+
242
+ * **cli:** keep Copilot's .sh hook running from a path with a space ([09b32a8](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/09b32a8c7ea04d70db98481e56714d5b881d93ec))
243
+ * **cli:** run a hook once in Copilot when Claude Code has it too ([2b93950](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/2b93950cba5dd0fff9e0aad8f4a753966be136a8))
244
+ * **cli:** step aside in Copilot only when Claude Code's script is there ([1788e29](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1788e29f95bdcfb297462c0e0643108669046b6b))
245
+
246
+ ## [9.4.0-dev.26](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.25&targetVersion=GTv9.4.0-dev.26) (2026-10-29)
247
+
248
+ ### Bug Fixes
249
+
250
+ * **cli:** show an .mjs hook's node command in its init README ([d430178](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/d430178d9a89b3acefbe82ed9b37911acbaba141))
251
+
252
+ ## [9.4.0-dev.25](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.24&targetVersion=GTv9.4.0-dev.25) (2026-10-29)
253
+
254
+ ### Bug Fixes
255
+
256
+ * **cli:** find a per-user Git Bash and fail when no bash starts ([9684085](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/9684085a2d6eb300986f9695b92a8d9451e64248))
257
+ * **cli:** run a Copilot .sh hook with Git Bash on Windows ([a0080ce](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a0080cedd654241e9ba249c7b49d7d88c549faf7))
258
+
259
+ ## [9.4.0-dev.24](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.23&targetVersion=GTv9.4.0-dev.24) (2026-10-29)
260
+
261
+ ### Bug Fixes
262
+
263
+ * **cli:** prefer the forked type across scopes in init --from (ATK-847) ([ca7f22e](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ca7f22e3b00504fdf688cc9da030d15268a4c265))
264
+ * **cli:** resolve init --from by org and type (ATK-847) ([00001be](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/00001be9caa26c8981b38e60df626f6fd4903012))
265
+
266
+ ### Documentation
267
+
268
+ * **cli:** name global: in init --from's help (ATK-847) ([864961b](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/864961b18a538f5bdf823901a09392d6a63b9f8c))
269
+
270
+ ## [9.4.0-dev.23](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.22&targetVersion=GTv9.4.0-dev.23) (2026-10-29)
271
+
272
+ ### Bug Fixes
273
+
274
+ * **cli:** fork an installed hook with its registry hookConfig (ATK-826) ([c76bb10](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/c76bb10e712b16f2cdeb7c037384c729e7ca69e9))
275
+ * **cli:** read a forked hook's events only for a hook (ATK-826) ([7ed1efc](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/7ed1efc4c7ac25e44f4ac8d7818a8e5354b82f31))
276
+
277
+ ## [9.4.0-dev.22](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.21&targetVersion=GTv9.4.0-dev.22) (2026-10-29)
278
+
279
+ ### Documentation
280
+
281
+ * **cli:** describe the *.fs.test.ts convention (ATK-841) ([a75c097](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a75c0971d3fa3352ae32b5d9e14a5aa96fbb365b))
282
+
283
+ ## [9.4.0-dev.21](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.20&targetVersion=GTv9.4.0-dev.21) (2026-10-29)
284
+
285
+ ### Bug Fixes
286
+
287
+ * **cli:** name the scaffolded entrypoint in init's next steps (ATK-831) ([1a4efa8](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1a4efa8a2895b0b6af1f75bbb55d04e6047766ae))
288
+ * **cli:** scaffold a hook forked from an .mjs script as an .mjs hook (ATK-831) ([eb6b3ed](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/eb6b3ed2b9d8ec83ea431e01e21b129c71498077))
289
+
290
+ ### Styling
291
+
292
+ * **cli:** sort InitOptions.forkEntrypoint before from (ATK-831) ([5cebe68](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/5cebe689ed7c27c40783b2422dba05a1fff7b874))
293
+
294
+ ## [9.4.0-dev.20](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.19&targetVersion=GTv9.4.0-dev.20) (2026-10-29)
295
+
296
+ ### Bug Fixes
297
+
298
+ * **cli:** rename an installed fork's recorded entrypoint (ATK-832) ([81cfc06](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/81cfc0697bb138fc345b339735faa6f4856903e6))
299
+
300
+ ## [9.4.0-dev.19](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.18&targetVersion=GTv9.4.0-dev.19) (2026-10-29)
301
+
302
+ ### Bug Fixes
303
+
304
+ * **cli:** keep a fork's own file under the new entrypoint name (ATK-825) ([2bd3154](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/2bd31543cb62385e5620ddb9c964eab5eb82c074))
305
+ * **cli:** make a renamed init --from fork the new entrypoint (ATK-825) ([0e69ebe](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/0e69ebe1ccf8f12937ba957165ca16150ef70a49))
306
+
307
+ ## [9.4.0-dev.18](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.17&targetVersion=GTv9.4.0-dev.18) (2026-10-29)
308
+
309
+ ### Bug Fixes
310
+
311
+ * **cli:** wait for a config lock Windows is still deleting (ATK-827) ([3108d09](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/3108d09ff810a0d5688268f9ae24847cf02a3d5f))
312
+
313
+ ## [9.4.0-dev.17](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.16&targetVersion=GTv9.4.0-dev.17) (2026-10-29)
314
+
315
+ ### Features
316
+
317
+ * **cli:** complete global:name for a shadowed global asset (ATK-806) ([1f248b4](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1f248b4afd26b963e3c3e794f9301a0d99791a18))
318
+ * **cli:** read global:name in move, why, diff and info (ATK-806) ([14f621e](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/14f621e575dc16120639cb962427550f185e2837))
319
+
320
+ ### Bug Fixes
321
+
322
+ * **cli:** drop retired Copilot MCP files from the ATK gitignore block (ATK-823) ([7532ecf](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/7532ecf6b2a2e2ceeee244f8a425bd9be7163c1f))
323
+ * **cli:** keep a retired MCP file ignored until ATK's servers leave it (ATK-823) ([99b4119](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/99b41198d74ad13c83dedebe634a0bcf4fbeabcb))
324
+ * **cli:** keep move's own refusals for a name it doesn't reach (ATK-806) ([83c053c](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/83c053c593c1c98f39ed3e452002e6773c8e54ef))
325
+ * **cli:** name a shadowed global entry in diff's update hint (ATK-806) ([9df6d2f](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/9df6d2f1400e2c7fa9d302a07e981b61a0a270e7))
326
+ * **cli:** offer no global:name with --org, and echo it in diff's usage errors (ATK-806) ([ca93bd3](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ca93bd31f5ec54701b466083a4989480b6d9c190))
327
+ * **cli:** place Copilot project MCP servers in .github/mcp.json (ATK-823) ([8b0ba0c](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8b0ba0c43a67fa132359492f5d183957699e6aad))
328
+ * **cli:** suggest global:name in the pin and cross-scope hints (ATK-806) ([e9e7252](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/e9e7252f045e6a9afd7d67905707405c0f8abaf2))
329
+
330
+ ## [9.4.0-dev.16](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.15&targetVersion=GTv9.4.0-dev.16) (2026-10-28)
331
+
332
+ ### Features
333
+
334
+ * **cli:** build a hook's hookConfig from its Copilot hook file (ATK-819) ([db0ed0c](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/db0ed0c8bad6999ce02d7f1fee9093eb3defbdf0))
335
+
336
+ ### Bug Fixes
337
+
338
+ * **cli:** keep a Copilot hook timeout Claude Code's binding lacks (ATK-819) ([9ed76a6](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/9ed76a62a4fb2286a726b594483a1dcfe860e78c))
339
+ * **cli:** write a forked hook's hookConfig into its manifest (ATK-819) ([30ebc33](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/30ebc3348b9a5d52fafd4d2e39bc36a28b7f8b69))
340
+
341
+ ## [9.4.0-dev.15](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.14&targetVersion=GTv9.4.0-dev.15) (2026-10-28)
342
+
343
+ ### Bug Fixes
344
+
345
+ * **cli:** find a Copilot hook ATK-482 kept in ~/.copilot/hooks (ATK-821) ([a10ded1](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a10ded13ae4e06362b1d6139a7b8fde069f3b606))
346
+ * **cli:** place Copilot user assets in COPILOT_HOME (ATK-821) ([762b93b](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/762b93bd6b8561aae7aebeb0983871ee38a327d6))
347
+
348
+ ### Refactoring
349
+
350
+ * **cli:** require the recorded paths configDirMove reads (ATK-821) ([a695a1b](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/a695a1b7b5ab5e17549222d7bc7d1d02cf82a1cd))
351
+
352
+ ## [9.4.0-dev.14](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.13&targetVersion=GTv9.4.0-dev.14) (2026-10-28)
353
+
354
+ ### Features
355
+
356
+ * **cli:** run script hooks in Copilot CLI from a generated hook file ([c44fbbb](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/c44fbbbb0ce7d95673085cfb1f6f57b628bf148d))
357
+
358
+ ### Bug Fixes
359
+
360
+ * **cli:** leave Copilot hook registration to the hook's own config ([8856daf](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/8856daf2f006406c5728aac477cee982b208369f))
361
+
362
+ ## [9.4.0-dev.13](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.12&targetVersion=GTv9.4.0-dev.13) (2026-10-28)
363
+
364
+ ### Bug Fixes
365
+
366
+ * **cli:** run an .mjs hook with node for Codex CLI ([57594c9](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/57594c9b1f35d4c0de5c07221cb5d343d465916d))
367
+
368
+ ## [9.4.0-dev.12](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.11&targetVersion=GTv9.4.0-dev.12) (2026-10-28)
369
+
370
+ ### Bug Fixes
371
+
372
+ * **cli:** don't place a script hook as Copilot's hook config ([b1af5e7](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/b1af5e743c363e25c692ecd3718b7d1cb3f2bd5c))
373
+ * **cli:** leave a hook Copilot can't take out of update, list and notices ([985de88](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/985de88efb2ca30ef08343a421334ac2815fe377))
374
+ * **cli:** report a hook Copilot can't take as skipped, not excluded ([b3e6597](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/b3e659750d5dd48518c961dee749702c5114687e))
375
+
376
+ ## [9.4.0-dev.11](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.10&targetVersion=GTv9.4.0-dev.11) (2026-10-28)
377
+
378
+ ### Bug Fixes
379
+
380
+ * **cli:** compare the resolved version of a named asset in place (ATK-814) ([3e46afb](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/3e46afb3c2f10dd9984cae58401effa24bd25071))
381
+
382
+ ## [9.4.0-dev.10](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.9&targetVersion=GTv9.4.0-dev.10) (2026-10-28)
383
+
384
+ ### Bug Fixes
385
+
386
+ * **cli:** pin a bundle in place and dry-run an asset in place (ATK-815) ([59a6673](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/59a6673fa0d0ae3d988d26c993661422ea89a289))
387
+
388
+ ### Refactoring
389
+
390
+ * **cli:** report a bundle's pin from the plan (ATK-815) ([1ad2243](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1ad2243fcad84eda46a77aa6d174c09a447ae44c))
391
+
392
+ ## [9.4.0-dev.9](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.8&targetVersion=GTv9.4.0-dev.9) (2026-10-28)
393
+
394
+ ### Bug Fixes
395
+
396
+ * **cli:** pin an installed asset with install --pin (ATK-813) ([eee4550](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/eee45503a7bbbd700d703f0a08c1523eb33702da))
397
+ * **cli:** pin at the version the install leaves (ATK-813) ([2484325](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/24843251b7f59c12b10c4ba67a8e531ac25001de))
398
+
1
399
  ## [9.4.0-dev.8](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv9.4.0-dev.7&targetVersion=GTv9.4.0-dev.8) (2026-10-28)
2
400
 
3
401
  ### Bug Fixes
package/README.md CHANGED
@@ -36,6 +36,10 @@ npm install -g @detergent-software/atk@dev
36
36
 
37
37
  Dev releases follow the format `x.y.z-dev.N` and include features and fixes that haven't been promoted to a stable release yet. Use this to preview upcoming changes or test in-progress work.
38
38
 
39
+ #### Upgrading
40
+
41
+ `atk upgrade` installs the newest version on the CLI's own channel (`dev` for a `-dev.N` build, `latest` otherwise) with `npm install --global`, reading the version fresh from npm. `atk upgrade --tag latest --allow-downgrade` moves a dev install back to the stable channel; without `--allow-downgrade` it refuses a version older than the running one. It replaces only an npm global install: under `npx`, an `npm link`ed checkout, or a pnpm, yarn or bun global install, it installs nothing and prints the npm command to run instead. `atk doctor --fix` runs it when the CLI is behind its channel.
42
+
39
43
  ### Basic Usage
40
44
 
41
45
  ```bash
@@ -100,6 +104,7 @@ atk update
100
104
  | `atk unpin <assets...>` | Remove the version pins from assets |
101
105
  | `atk unpublish <name>` | Remove an asset, bundle or one version from the registry via PR |
102
106
  | `atk update [asset]` | Update installed assets to latest versions |
107
+ | `atk upgrade` | Upgrade the CLI itself to the newest on its npm channel |
103
108
  | `atk validate [path...]` | Check asset or bundle directories for errors before publishing |
104
109
  | `atk whoami` | Show who you are signed in as and where the credential came from |
105
110
  | `atk why <asset>` | Explain why an asset is installed (direct, dependency, or orphan) |
@@ -211,7 +216,7 @@ GitHub sign-in to ATK has ended. GitHub tokens are no longer read from `gh`, `GI
211
216
 
212
217
  2. **Tool Adapters** — JSON adapter files in `tool-adapters/` define how assets are placed for each AI tool. The Claude Code adapter puts skills in `.claude/skills/`, agents in `.claude/agents/`, MCP servers in `.mcp.json`, and so on. Supported tools today are **Claude Code** (`claude-code`), **GitHub Copilot CLI** (`copilot-cli`), and **OpenAI Codex CLI** (`codex-cli`); pick one or more with `atk setup`. New tools are added by dropping in an adapter file — no CLI code changes needed. Config registration targets can be JSON or TOML (`configFormat`).
213
218
 
214
- Codex CLI notes: skills are placed in `.agents/skills/` (Codex's cross-agent skill root), memory templates append to the repo-root `AGENTS.md`, hook scripts go in `.codex/hooks/` and are registered in `.codex/hooks.json` (Codex requires you to trust each hook once via `/hooks` before it runs), and MCP servers are written to `.codex/config.toml` (Codex applies project-level config only to trusted projects). ATK re-serializes `.codex/config.toml` when it writes to it, so comments in that file are not preserved (ATK warns when this happens). Rules and agents are not supported for Codex yet.
219
+ Codex CLI notes: skills are placed in `.agents/skills/` (Codex's cross-agent skill root), memory templates append to the repo-root `AGENTS.md`, hook scripts go in `.codex/hooks/` and are registered in `.codex/hooks.json`, a hook whose entrypoint is an ES module (`.mjs`) as `node .codex/hooks/<name>.mjs` (Codex requires you to trust each hook once via `/hooks` before it runs), and MCP servers are written to `.codex/config.toml` (Codex applies project-level config only to trusted projects). ATK re-serializes `.codex/config.toml` when it writes to it, so comments in that file are not preserved (ATK warns when this happens). Rules and agents are not supported for Codex yet.
215
220
 
216
221
  3. **Lockfile** — When you install an asset, ATK records it in `.atk-lock.json` with file paths, SHA-256 checksums, and timestamps. This enables auditing, syncing across machines, and precise uninstallation.
217
222
 
@@ -363,7 +368,7 @@ atk move my-skill --to user
363
368
  atk move my-skill --to project
364
369
  ```
365
370
 
366
- - The user scope has its own lockfile, `~/.atk-lock.json`, and keeps its tools in the `user` section of `~/.atkrc.json`. Each tool's assets go in its own user directory (`~/.claude/`, `~/.codex/`, `~/.copilot/`), which follows `CLAUDE_CONFIG_DIR`, `CODEX_HOME` and `XDG_CONFIG_HOME` when they are set.
371
+ - The user scope has its own lockfile, `~/.atk-lock.json`, and keeps its tools in the `user` section of `~/.atkrc.json`. Each tool's assets go in its own user directory (`~/.claude/`, `~/.codex/`, `~/.copilot/`), which follows `CLAUDE_CONFIG_DIR`, `CODEX_HOME` and `COPILOT_HOME` when they are set.
367
372
  - **Read both, write one.** In a project, `atk list` and `atk outdated` show your user installs beside the project's, each with its scope (`--project` hides them). Commands that change installs touch one scope: a project `atk update` never changes your user installs. `atk install` warns when the other scope already has the asset, and says which copy each tool uses.
368
373
  - **The user root** is your home directory unless the `userRoot` config key or the `ATK_USER_ROOT` environment variable says otherwise. A command run in the user root works in the user scope even without `--user`.
369
374
  - **A new machine:** commit `~/.atk-lock.json` to your dotfiles, then run `atk setup --user` and `atk sync --user`; or publish a personal bundle and run `atk install <bundle> --user`.
@@ -241,7 +241,7 @@
241
241
  "name": "diff",
242
242
  "args": [
243
243
  {
244
- "description": "Asset name (supports name@version, name@<a>..<b> for two versions, and @org/name syntax)",
244
+ "description": "Asset name (supports name@version, name@<a>..<b> for two versions, @org/name and global:name)",
245
245
  "name": "<name>"
246
246
  }
247
247
  ],
@@ -301,7 +301,7 @@
301
301
  "options": [
302
302
  {
303
303
  "flags": "--fix",
304
- "description": "Repair what it can (a corrupt cache, missing files, an expired sign-in), asking first",
304
+ "description": "Repair what it can (a corrupt cache, missing files, an expired sign-in, an outdated CLI), asking first",
305
305
  "defaultValue": false
306
306
  },
307
307
  {
@@ -417,7 +417,7 @@
417
417
  "name": "info",
418
418
  "args": [
419
419
  {
420
- "description": "Asset or bundle name (supports name@version and @org/name syntax)",
420
+ "description": "Asset or bundle name (supports name@version, @org/name and global:name)",
421
421
  "name": "<name>"
422
422
  }
423
423
  ],
@@ -501,7 +501,7 @@
501
501
  },
502
502
  {
503
503
  "flags": "-F, --from [from]",
504
- "description": "Fork from an installed asset name or a local file/directory path"
504
+ "description": "Fork from an installed asset, [type:][@org/|global:]name (e.g., hook:@acme/notify), or a local file/directory path"
505
505
  },
506
506
  {
507
507
  "flags": "-j, --json",
@@ -692,7 +692,7 @@
692
692
  "name": "move",
693
693
  "args": [
694
694
  {
695
- "description": "Asset name to move (supports @org/name syntax)",
695
+ "description": "Asset name to move (supports @org/name and global:name)",
696
696
  "name": "<name>"
697
697
  }
698
698
  ],
@@ -1554,7 +1554,7 @@
1554
1554
  "name": "[names...]"
1555
1555
  }
1556
1556
  ],
1557
- "description": "Update installed assets",
1557
+ "description": "Update installed assets (to upgrade the CLI itself, use atk upgrade)",
1558
1558
  "file": "update.js",
1559
1559
  "options": [
1560
1560
  {
@@ -1609,6 +1609,32 @@
1609
1609
  }
1610
1610
  ]
1611
1611
  },
1612
+ {
1613
+ "isDefault": false,
1614
+ "name": "upgrade",
1615
+ "description": "Upgrade the ATK CLI itself to the newest version on npm (to update installed assets, use atk update)",
1616
+ "file": "upgrade.js",
1617
+ "options": [
1618
+ {
1619
+ "flags": "--allow-downgrade",
1620
+ "description": "Install the tag's version even when it is older than this CLI (dev to latest, say)",
1621
+ "defaultValue": false
1622
+ },
1623
+ {
1624
+ "flags": "-j, --json",
1625
+ "description": "Output raw JSON (for scripting and CI)",
1626
+ "defaultValue": false
1627
+ },
1628
+ {
1629
+ "flags": "-g, --tag [tag]",
1630
+ "description": "The npm dist-tag to install from: dev or latest (default: this CLI's own channel)",
1631
+ "choices": [
1632
+ "dev",
1633
+ "latest"
1634
+ ]
1635
+ }
1636
+ ]
1637
+ },
1612
1638
  {
1613
1639
  "isDefault": false,
1614
1640
  "name": "validate",
@@ -1646,7 +1672,7 @@
1646
1672
  "name": "why",
1647
1673
  "args": [
1648
1674
  {
1649
- "description": "Asset name",
1675
+ "description": "Asset name (supports @org/name and global:name)",
1650
1676
  "name": "<name>"
1651
1677
  }
1652
1678
  ],
@@ -1 +1 @@
1
- {"version":3,"file":"_app.d.ts","sourceRoot":"","sources":["../../src/commands/_app.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAuEvD,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,QAAQ,qBAyDhE"}
1
+ {"version":3,"file":"_app.d.ts","sourceRoot":"","sources":["../../src/commands/_app.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAuEvD,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,QAAQ,qBA4DhE"}
@@ -11,7 +11,7 @@ import UpdateBanner from '../components/UpdateBanner.js';
11
11
  import { errorGuidance } from '../lib/errors.js';
12
12
  import { getNotices, subscribeNotices } from '../lib/notices.js';
13
13
  import { renderJson, useCanPrompt } from '../lib/output.js';
14
- import { getUpdateInfo } from '../lib/update-check.js';
14
+ import { getUpdateInfo, isUpdateBannerHidden, subscribeUpdateBanner } from '../lib/update-check.js';
15
15
  const __dirname = dirname(fileURLToPath(import.meta.url));
16
16
  const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf8'));
17
17
  class CommandErrorBoundary extends React.Component {
@@ -58,6 +58,8 @@ export default function App({ commandProps, Component }) {
58
58
  // Once-per-run notices arrive while the command runs; subscribing
59
59
  // re-renders the shell in place.
60
60
  const notices = React.useSyncExternalStore(subscribeNotices, getNotices, getNotices);
61
+ // `atk upgrade` and `atk doctor --fix` hide the banner once it would be stale.
62
+ const bannerHidden = React.useSyncExternalStore(subscribeUpdateBanner, isUpdateBannerHidden, isUpdateBannerHidden);
61
63
  const [updateInfo, setUpdateInfo] = React.useState(null);
62
64
  React.useEffect(() => {
63
65
  if (effectiveJson)
@@ -78,7 +80,7 @@ export default function App({ commandProps, Component }) {
78
80
  if (effectiveJson) {
79
81
  return (_jsx(CommandErrorBoundary, { json: true, children: _jsx(Component, { ...commandProps }) }));
80
82
  }
81
- return (_jsxs(Box, { flexDirection: 'column', marginBottom: 1, marginTop: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Header, { version: pkg.version }) }), updateInfo && (_jsx(Box, { marginBottom: 1, children: _jsx(UpdateBanner, { info: updateInfo }) })), notices.length > 0 && (_jsx(Box, { marginBottom: 1, children: _jsx(NoticeBanner, { notices: notices }) })), _jsx(CommandErrorBoundary, { json: false, children: _jsx(Component, { ...commandProps }) })] }));
83
+ return (_jsxs(Box, { flexDirection: 'column', marginBottom: 1, marginTop: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Header, { version: pkg.version }) }), updateInfo && !bannerHidden && (_jsx(Box, { marginBottom: 1, children: _jsx(UpdateBanner, { info: updateInfo }) })), notices.length > 0 && (_jsx(Box, { marginBottom: 1, children: _jsx(NoticeBanner, { notices: notices }) })), _jsx(CommandErrorBoundary, { json: false, children: _jsx(Component, { ...commandProps }) })] }));
82
84
  }
83
85
  /** `ATK_DEBUG` (any value but empty or `0`) adds the stack trace to a crash's output. */
84
86
  function isDebug() {