agent-control-plane 0.1.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 (317) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +589 -0
  3. package/SKILL.md +149 -0
  4. package/assets/workflow-catalog.json +57 -0
  5. package/bin/audit-issue-routing.sh +74 -0
  6. package/bin/issue-resource-class.sh +58 -0
  7. package/bin/label-follow-up-issues.sh +114 -0
  8. package/bin/pr-risk.sh +532 -0
  9. package/bin/sync-pr-labels.sh +112 -0
  10. package/hooks/heartbeat-hooks.sh +573 -0
  11. package/hooks/issue-reconcile-hooks.sh +217 -0
  12. package/hooks/pr-reconcile-hooks.sh +225 -0
  13. package/npm/bin/agent-control-plane.js +1984 -0
  14. package/npm/public-bin/agent-control-plane +3 -0
  15. package/package.json +61 -0
  16. package/tools/bin/agent-cleanup-worktree +247 -0
  17. package/tools/bin/agent-github-update-labels +66 -0
  18. package/tools/bin/agent-init-worktree +216 -0
  19. package/tools/bin/agent-project-archive-run +52 -0
  20. package/tools/bin/agent-project-capture-worker +46 -0
  21. package/tools/bin/agent-project-catch-up-merged-prs +137 -0
  22. package/tools/bin/agent-project-cleanup-session +244 -0
  23. package/tools/bin/agent-project-detached-launch +107 -0
  24. package/tools/bin/agent-project-heartbeat-loop +2347 -0
  25. package/tools/bin/agent-project-open-issue-worktree +89 -0
  26. package/tools/bin/agent-project-open-pr-worktree +80 -0
  27. package/tools/bin/agent-project-publish-issue-pr +349 -0
  28. package/tools/bin/agent-project-reconcile-issue-session +1128 -0
  29. package/tools/bin/agent-project-reconcile-pr-session +1005 -0
  30. package/tools/bin/agent-project-retry-state +147 -0
  31. package/tools/bin/agent-project-run-claude-session +657 -0
  32. package/tools/bin/agent-project-run-codex-resilient +718 -0
  33. package/tools/bin/agent-project-run-codex-session +316 -0
  34. package/tools/bin/agent-project-run-kilo-session +27 -0
  35. package/tools/bin/agent-project-run-openclaw-session +984 -0
  36. package/tools/bin/agent-project-run-opencode-session +27 -0
  37. package/tools/bin/agent-project-sync-anchor-repo +128 -0
  38. package/tools/bin/agent-project-worker-status +143 -0
  39. package/tools/bin/audit-agent-worktrees.sh +310 -0
  40. package/tools/bin/audit-issue-routing.sh +11 -0
  41. package/tools/bin/audit-retained-layout.sh +58 -0
  42. package/tools/bin/audit-retained-overlap.sh +135 -0
  43. package/tools/bin/audit-retained-worktrees.sh +228 -0
  44. package/tools/bin/branch-verification-guard.sh +351 -0
  45. package/tools/bin/capture-worker.sh +18 -0
  46. package/tools/bin/check-skill-contracts.sh +324 -0
  47. package/tools/bin/cleanup-worktree.sh +44 -0
  48. package/tools/bin/codex-quota +31 -0
  49. package/tools/bin/create-follow-up-issue.sh +114 -0
  50. package/tools/bin/dashboard-launchd-bootstrap.sh +38 -0
  51. package/tools/bin/flow-config-lib.sh +2127 -0
  52. package/tools/bin/flow-resident-worker-lib.sh +683 -0
  53. package/tools/bin/flow-runtime-doctor.sh +97 -0
  54. package/tools/bin/flow-shell-lib.sh +266 -0
  55. package/tools/bin/heartbeat-recovery-preflight.sh +106 -0
  56. package/tools/bin/heartbeat-safe-auto.sh +551 -0
  57. package/tools/bin/install-dashboard-launchd.sh +152 -0
  58. package/tools/bin/install-project-launchd.sh +219 -0
  59. package/tools/bin/issue-publish-scope-guard.sh +242 -0
  60. package/tools/bin/issue-requires-local-workspace-install.sh +31 -0
  61. package/tools/bin/issue-resource-class.sh +12 -0
  62. package/tools/bin/kick-scheduler.sh +75 -0
  63. package/tools/bin/label-follow-up-issues.sh +14 -0
  64. package/tools/bin/new-pr-worktree.sh +50 -0
  65. package/tools/bin/new-worktree.sh +49 -0
  66. package/tools/bin/pr-risk.sh +12 -0
  67. package/tools/bin/prepare-worktree.sh +140 -0
  68. package/tools/bin/profile-activate.sh +109 -0
  69. package/tools/bin/profile-adopt.sh +219 -0
  70. package/tools/bin/profile-smoke.sh +461 -0
  71. package/tools/bin/project-init.sh +189 -0
  72. package/tools/bin/project-launchd-bootstrap.sh +54 -0
  73. package/tools/bin/project-remove.sh +155 -0
  74. package/tools/bin/project-runtime-supervisor.sh +56 -0
  75. package/tools/bin/project-runtimectl.sh +586 -0
  76. package/tools/bin/provider-cooldown-state.sh +166 -0
  77. package/tools/bin/publish-issue-worker.sh +31 -0
  78. package/tools/bin/reconcile-issue-worker.sh +34 -0
  79. package/tools/bin/reconcile-pr-worker.sh +34 -0
  80. package/tools/bin/record-verification.sh +71 -0
  81. package/tools/bin/render-architecture-infographics.sh +110 -0
  82. package/tools/bin/render-dashboard-demo-media.sh +333 -0
  83. package/tools/bin/render-dashboard-snapshot.py +16 -0
  84. package/tools/bin/render-flow-config.sh +86 -0
  85. package/tools/bin/retry-state.sh +31 -0
  86. package/tools/bin/reuse-issue-worktree.sh +75 -0
  87. package/tools/bin/run-codex-bypass.sh +3 -0
  88. package/tools/bin/run-codex-safe.sh +3 -0
  89. package/tools/bin/run-codex-task.sh +231 -0
  90. package/tools/bin/scaffold-profile.sh +374 -0
  91. package/tools/bin/serve-dashboard.sh +5 -0
  92. package/tools/bin/split-retained-slice.sh +124 -0
  93. package/tools/bin/start-issue-worker.sh +796 -0
  94. package/tools/bin/start-pr-fix-worker.sh +458 -0
  95. package/tools/bin/start-pr-merge-repair-worker.sh +8 -0
  96. package/tools/bin/start-pr-review-worker.sh +227 -0
  97. package/tools/bin/start-resident-issue-loop.sh +908 -0
  98. package/tools/bin/sync-agent-repo.sh +52 -0
  99. package/tools/bin/sync-dependency-baseline.sh +247 -0
  100. package/tools/bin/sync-pr-labels.sh +12 -0
  101. package/tools/bin/sync-recurring-issue-checklist.sh +274 -0
  102. package/tools/bin/sync-shared-agent-home.sh +214 -0
  103. package/tools/bin/sync-vscode-workspace.sh +157 -0
  104. package/tools/bin/test-smoke.sh +63 -0
  105. package/tools/bin/uninstall-project-launchd.sh +55 -0
  106. package/tools/bin/update-github-labels.sh +14 -0
  107. package/tools/bin/worker-status.sh +19 -0
  108. package/tools/bin/workflow-catalog.sh +77 -0
  109. package/tools/dashboard/app.js +286 -0
  110. package/tools/dashboard/dashboard_snapshot.py +466 -0
  111. package/tools/dashboard/index.html +41 -0
  112. package/tools/dashboard/server.py +64 -0
  113. package/tools/dashboard/styles.css +351 -0
  114. package/tools/templates/issue-prompt-template.md +109 -0
  115. package/tools/templates/pr-fix-template.md +120 -0
  116. package/tools/templates/pr-merge-repair-template.md +91 -0
  117. package/tools/templates/pr-review-template.md +62 -0
  118. package/tools/templates/scheduled-issue-prompt-template.md +62 -0
  119. package/tools/tests/test-agent-control-plane-npm-cli.sh +279 -0
  120. package/tools/tests/test-agent-github-update-labels-falls-back-to-repository-id.sh +56 -0
  121. package/tools/tests/test-agent-project-claude-session-wrapper-clears-stale-sandbox-artifacts.sh +89 -0
  122. package/tools/tests/test-agent-project-claude-session-wrapper-does-not-retry-provider-quota.sh +82 -0
  123. package/tools/tests/test-agent-project-claude-session-wrapper-retries-transient-failures.sh +90 -0
  124. package/tools/tests/test-agent-project-claude-session-wrapper-times-out.sh +73 -0
  125. package/tools/tests/test-agent-project-claude-session-wrapper.sh +103 -0
  126. package/tools/tests/test-agent-project-cleanup-session-orphan-fallback.sh +90 -0
  127. package/tools/tests/test-agent-project-cleanup-session-skip-worktree-cleanup.sh +90 -0
  128. package/tools/tests/test-agent-project-codex-live-thread-persist.sh +76 -0
  129. package/tools/tests/test-agent-project-codex-recovery.sh +731 -0
  130. package/tools/tests/test-agent-project-codex-session-wrapper-clears-stale-sandbox-artifacts.sh +105 -0
  131. package/tools/tests/test-agent-project-codex-session-wrapper.sh +97 -0
  132. package/tools/tests/test-agent-project-open-pr-worktree-config-prefix.sh +81 -0
  133. package/tools/tests/test-agent-project-openclaw-session-wrapper-clears-stale-sandbox-artifacts.sh +109 -0
  134. package/tools/tests/test-agent-project-openclaw-session-wrapper-infers-blocked-result-contract.sh +89 -0
  135. package/tools/tests/test-agent-project-openclaw-session-wrapper-recovers-literal-env-artifacts.sh +113 -0
  136. package/tools/tests/test-agent-project-openclaw-session-wrapper-recovers-version-mismatch.sh +135 -0
  137. package/tools/tests/test-agent-project-openclaw-session-wrapper-resident.sh +179 -0
  138. package/tools/tests/test-agent-project-openclaw-session-wrapper-reuses-existing-agent-after-add-race.sh +119 -0
  139. package/tools/tests/test-agent-project-openclaw-session-wrapper-terminates-rate-limit-hang.sh +91 -0
  140. package/tools/tests/test-agent-project-openclaw-session-wrapper.sh +117 -0
  141. package/tools/tests/test-agent-project-publish-issue-pr-prunes-stale-worktree-entry.sh +148 -0
  142. package/tools/tests/test-agent-project-publish-issue-pr-reads-archived-session.sh +146 -0
  143. package/tools/tests/test-agent-project-publish-issue-pr-recovers-final-head.sh +145 -0
  144. package/tools/tests/test-agent-project-publish-issue-pr-reuses-existing-worktree.sh +147 -0
  145. package/tools/tests/test-agent-project-reconcile-failure-reason.sh +456 -0
  146. package/tools/tests/test-agent-project-reconcile-issue-archived-session-fallback.sh +96 -0
  147. package/tools/tests/test-agent-project-reconcile-issue-before-blocked.sh +90 -0
  148. package/tools/tests/test-agent-project-reconcile-issue-host-verification-recovery-uses-recovered-worktree.sh +212 -0
  149. package/tools/tests/test-agent-project-reconcile-issue-host-verification-recovery.sh +207 -0
  150. package/tools/tests/test-agent-project-reconcile-issue-provider-quota-schedules-provider-cooldown.sh +101 -0
  151. package/tools/tests/test-agent-project-reconcile-issue-session-backfills-lane-metadata-from-worker-key.sh +113 -0
  152. package/tools/tests/test-agent-project-reconcile-issue-session-clears-stale-failed-summary.sh +117 -0
  153. package/tools/tests/test-agent-project-reconcile-issue-session-initializes-shared-agent-home.sh +55 -0
  154. package/tools/tests/test-agent-project-reconcile-issue-session-normalizes-runner-state.sh +125 -0
  155. package/tools/tests/test-agent-project-reconcile-issue-session-records-invalid-contract-summary.sh +118 -0
  156. package/tools/tests/test-agent-project-reconcile-issue-session-skips-duplicate-blocked-comment.sh +144 -0
  157. package/tools/tests/test-agent-project-reconcile-issue-session-standardizes-no-commits-blocker.sh +145 -0
  158. package/tools/tests/test-agent-project-reconcile-issue-session-synthesizes-blocked-comment.sh +139 -0
  159. package/tools/tests/test-agent-project-reconcile-pr-blocked-host-recovery.sh +242 -0
  160. package/tools/tests/test-agent-project-reconcile-pr-guard-blocked-no-commit.sh +142 -0
  161. package/tools/tests/test-agent-project-reconcile-pr-provider-quota-schedules-provider-cooldown.sh +106 -0
  162. package/tools/tests/test-agent-project-reconcile-pr-session-initializes-shared-agent-home.sh +66 -0
  163. package/tools/tests/test-agent-project-reconcile-pr-updated-branch-noop.sh +129 -0
  164. package/tools/tests/test-audit-agent-worktrees-active-launch-skips-git-inspection.sh +69 -0
  165. package/tools/tests/test-audit-agent-worktrees-broken-worktree.sh +43 -0
  166. package/tools/tests/test-audit-agent-worktrees-pending-launch-owner.sh +46 -0
  167. package/tools/tests/test-audit-agent-worktrees-unreconciled-owner.sh +79 -0
  168. package/tools/tests/test-audit-issue-routing-managed-branch-globs.sh +56 -0
  169. package/tools/tests/test-branch-verification-guard-generated-artifacts.sh +72 -0
  170. package/tools/tests/test-branch-verification-guard-targeted-coverage.sh +125 -0
  171. package/tools/tests/test-codex-quota-manager-failure-driven-rotation.sh +178 -0
  172. package/tools/tests/test-codex-quota-wrapper.sh +37 -0
  173. package/tools/tests/test-contribution-docs.sh +18 -0
  174. package/tools/tests/test-control-plane-dashboard-runtime-smoke.sh +343 -0
  175. package/tools/tests/test-create-follow-up-issue.sh +73 -0
  176. package/tools/tests/test-dashboard-launchd-bootstrap.sh +55 -0
  177. package/tools/tests/test-flow-export-execution-env-exports-repo-id.sh +30 -0
  178. package/tools/tests/test-flow-export-github-cli-auth-env-prefers-git-credential.sh +48 -0
  179. package/tools/tests/test-flow-github-api-repo-fallback-preserves-input.sh +85 -0
  180. package/tools/tests/test-flow-github-api-repo-prefers-explicit-repository-id.sh +60 -0
  181. package/tools/tests/test-flow-github-issue-list-falls-back-to-repository-id.sh +64 -0
  182. package/tools/tests/test-flow-github-pr-list-falls-back-to-repository-id.sh +77 -0
  183. package/tools/tests/test-flow-resident-can-reuse-does-not-leak-metadata.sh +52 -0
  184. package/tools/tests/test-flow-resident-reap-stale-controllers.sh +63 -0
  185. package/tools/tests/test-flow-resolve-codex-quota-tools.sh +104 -0
  186. package/tools/tests/test-flow-runtime-doctor-profile-selection.sh +27 -0
  187. package/tools/tests/test-heartbeat-codex-pr-linked-issue-exclusion.sh +79 -0
  188. package/tools/tests/test-heartbeat-hooks-enqueue-resident-issue-for-idle-controller.sh +115 -0
  189. package/tools/tests/test-heartbeat-hooks-enqueue-resident-issue-for-live-lane-controller.sh +117 -0
  190. package/tools/tests/test-heartbeat-hooks-start-resident-issue-loop-claude.sh +96 -0
  191. package/tools/tests/test-heartbeat-hooks-start-resident-issue-loop-codex.sh +96 -0
  192. package/tools/tests/test-heartbeat-hooks-start-resident-issue-loop.sh +96 -0
  193. package/tools/tests/test-heartbeat-loop-auth-wait-does-not-consume-capacity.sh +170 -0
  194. package/tools/tests/test-heartbeat-loop-blocked-recovery-lane.sh +201 -0
  195. package/tools/tests/test-heartbeat-loop-blocked-recovery-vs-pr-reservation.sh +201 -0
  196. package/tools/tests/test-heartbeat-loop-idle-resident-controller-does-not-block-launches.sh +160 -0
  197. package/tools/tests/test-heartbeat-loop-pr-launch-dedup.sh +133 -0
  198. package/tools/tests/test-heartbeat-loop-provider-cooldown-suppresses-launches.sh +157 -0
  199. package/tools/tests/test-heartbeat-loop-reaps-stale-resident-controller.sh +181 -0
  200. package/tools/tests/test-heartbeat-loop-waiting-provider-resident-controller-does-not-block-launches.sh +160 -0
  201. package/tools/tests/test-heartbeat-ready-issues-blocked-recovery.sh +134 -0
  202. package/tools/tests/test-heartbeat-safe-auto-dynamic-concurrency.sh +162 -0
  203. package/tools/tests/test-heartbeat-safe-auto-no-tmux-sessions.sh +136 -0
  204. package/tools/tests/test-heartbeat-safe-auto-openclaw-skips-codex-quota.sh +139 -0
  205. package/tools/tests/test-heartbeat-safe-auto-quota-health-signal.sh +119 -0
  206. package/tools/tests/test-heartbeat-safe-auto-stale-shared-loop-pid-does-not-skip.sh +140 -0
  207. package/tools/tests/test-heartbeat-safe-auto-static-capacity-without-quota-cache.sh +142 -0
  208. package/tools/tests/test-heartbeat-safe-auto-zero-healthy-pools.sh +141 -0
  209. package/tools/tests/test-heartbeat-sync-issue-labels-empty-schedule.sh +65 -0
  210. package/tools/tests/test-heartbeat-sync-open-agent-prs-terminal-clears-running.sh +179 -0
  211. package/tools/tests/test-install-dashboard-launchd.sh +78 -0
  212. package/tools/tests/test-install-project-launchd-adds-tool-paths.sh +87 -0
  213. package/tools/tests/test-install-project-launchd.sh +110 -0
  214. package/tools/tests/test-issue-local-workspace-install-policy.sh +81 -0
  215. package/tools/tests/test-issue-publish-scope-guard-docs-signal.sh +70 -0
  216. package/tools/tests/test-issue-reconcile-hooks-success-clears-blocked.sh +36 -0
  217. package/tools/tests/test-kick-scheduler-requires-explicit-profile.sh +47 -0
  218. package/tools/tests/test-label-follow-up-issues-falls-back-to-repository-id.sh +132 -0
  219. package/tools/tests/test-manual-operator-entrypoints-require-explicit-profile.sh +64 -0
  220. package/tools/tests/test-package-funding-metadata.sh +21 -0
  221. package/tools/tests/test-package-public-metadata.sh +62 -0
  222. package/tools/tests/test-placeholder-worker-adapters.sh +38 -0
  223. package/tools/tests/test-pr-reconcile-hooks-refreshes-recurring-issue-checklist.sh +110 -0
  224. package/tools/tests/test-pr-risk-cohesive-mobile-locale-scope.sh +70 -0
  225. package/tools/tests/test-pr-risk-fix-label-semantics.sh +114 -0
  226. package/tools/tests/test-pr-risk-local-first-no-checks.sh +70 -0
  227. package/tools/tests/test-prepare-worktree-simple-repo-baseline.sh +67 -0
  228. package/tools/tests/test-profile-activate.sh +33 -0
  229. package/tools/tests/test-profile-adopt-allow-missing-repo.sh +68 -0
  230. package/tools/tests/test-profile-adopt-skip-workspace-sync-missing-file.sh +61 -0
  231. package/tools/tests/test-profile-adopt-syncs-anchor-and-workspace.sh +90 -0
  232. package/tools/tests/test-profile-smoke-collision.sh +44 -0
  233. package/tools/tests/test-profile-smoke-invalid-claude-config.sh +31 -0
  234. package/tools/tests/test-profile-smoke-invalid-provider-pool.sh +68 -0
  235. package/tools/tests/test-profile-smoke-repo-slug-mismatch.sh +36 -0
  236. package/tools/tests/test-profile-smoke.sh +45 -0
  237. package/tools/tests/test-project-init-force-and-skip-sync.sh +61 -0
  238. package/tools/tests/test-project-init-repo-slug-mismatch.sh +29 -0
  239. package/tools/tests/test-project-init.sh +66 -0
  240. package/tools/tests/test-project-launchd-bootstrap.sh +66 -0
  241. package/tools/tests/test-project-remove.sh +150 -0
  242. package/tools/tests/test-project-runtime-supervisor.sh +47 -0
  243. package/tools/tests/test-project-runtimectl-launchd.sh +115 -0
  244. package/tools/tests/test-project-runtimectl-missing-profile.sh +54 -0
  245. package/tools/tests/test-project-runtimectl-start-falls-back-to-bootstrap.sh +108 -0
  246. package/tools/tests/test-project-runtimectl-status-reports-supervisor-as-heartbeat-parent.sh +95 -0
  247. package/tools/tests/test-project-runtimectl-status-supervisor-running.sh +59 -0
  248. package/tools/tests/test-project-runtimectl-stop-cancels-pending-kick.sh +85 -0
  249. package/tools/tests/test-project-runtimectl-stop-clears-running-labels.sh +78 -0
  250. package/tools/tests/test-project-runtimectl.sh +212 -0
  251. package/tools/tests/test-provider-cooldown-state-prefers-runtime-worker-context.sh +39 -0
  252. package/tools/tests/test-provider-cooldown-state.sh +59 -0
  253. package/tools/tests/test-public-repo-docs.sh +159 -0
  254. package/tools/tests/test-reconcile-pr-worker-acp-config-routing.sh +75 -0
  255. package/tools/tests/test-render-dashboard-snapshot.sh +149 -0
  256. package/tools/tests/test-render-flow-config-demo-profile.sh +36 -0
  257. package/tools/tests/test-render-flow-config-provider-pool-fallback.sh +81 -0
  258. package/tools/tests/test-render-flow-config.sh +52 -0
  259. package/tools/tests/test-run-codex-task-claude-routing.sh +125 -0
  260. package/tools/tests/test-run-codex-task-codex-resident-routing.sh +108 -0
  261. package/tools/tests/test-run-codex-task-kilo-routing.sh +98 -0
  262. package/tools/tests/test-run-codex-task-openclaw-resident-routing.sh +117 -0
  263. package/tools/tests/test-run-codex-task-openclaw-routing.sh +113 -0
  264. package/tools/tests/test-run-codex-task-opencode-routing.sh +98 -0
  265. package/tools/tests/test-run-codex-task-provider-pool-fallback-routing.sh +146 -0
  266. package/tools/tests/test-scaffold-profile.sh +108 -0
  267. package/tools/tests/test-serve-dashboard.sh +93 -0
  268. package/tools/tests/test-start-issue-worker-blocked-context.sh +129 -0
  269. package/tools/tests/test-start-issue-worker-blocks-complete-recurring-checklist.sh +189 -0
  270. package/tools/tests/test-start-issue-worker-local-install-routing.sh +157 -0
  271. package/tools/tests/test-start-issue-worker-profile-template-routing.sh +149 -0
  272. package/tools/tests/test-start-issue-worker-recurring-resident-reuse-codex.sh +212 -0
  273. package/tools/tests/test-start-issue-worker-recurring-resident-reuse.sh +219 -0
  274. package/tools/tests/test-start-issue-worker-renders-verification-snippet.sh +155 -0
  275. package/tools/tests/test-start-issue-worker-resident-reuse-falls-back-to-new-worktree.sh +199 -0
  276. package/tools/tests/test-start-pr-fix-worker-host-blocker-context.sh +275 -0
  277. package/tools/tests/test-start-resident-issue-loop-adopts-next-recurring-issue.sh +185 -0
  278. package/tools/tests/test-start-resident-issue-loop-clears-pending-while-waiting-due.sh +152 -0
  279. package/tools/tests/test-start-resident-issue-loop-consumes-queued-lease.sh +186 -0
  280. package/tools/tests/test-start-resident-issue-loop-fails-over-provider-pool.sh +212 -0
  281. package/tools/tests/test-start-resident-issue-loop-immediate-cycles.sh +148 -0
  282. package/tools/tests/test-start-resident-issue-loop-waits-for-provider.sh +194 -0
  283. package/tools/tests/test-start-resident-issue-loop-waits-for-terminal-reconcile-status.sh +198 -0
  284. package/tools/tests/test-start-resident-issue-loop-yields-to-live-lane-controller.sh +145 -0
  285. package/tools/tests/test-sync-pr-labels-fix-lane-uses-repair-queued.sh +67 -0
  286. package/tools/tests/test-sync-recurring-issue-checklist-backfills-workflow-complete-blocker.sh +70 -0
  287. package/tools/tests/test-sync-recurring-issue-checklist.sh +95 -0
  288. package/tools/tests/test-sync-shared-agent-home-local-source-root.sh +66 -0
  289. package/tools/tests/test-sync-shared-agent-home-preserves-unrelated-workflow-catalog-skill.sh +47 -0
  290. package/tools/tests/test-test-smoke.sh +86 -0
  291. package/tools/tests/test-uninstall-project-launchd.sh +37 -0
  292. package/tools/tests/test-update-github-labels-prefers-sibling-helper.sh +49 -0
  293. package/tools/tests/test-workflow-catalog.sh +43 -0
  294. package/tools/vendor/codex-quota/LICENSE +21 -0
  295. package/tools/vendor/codex-quota/README.md +459 -0
  296. package/tools/vendor/codex-quota/codex-quota.js +261 -0
  297. package/tools/vendor/codex-quota/lib/claude-accounts.js +226 -0
  298. package/tools/vendor/codex-quota/lib/claude-oauth.js +174 -0
  299. package/tools/vendor/codex-quota/lib/claude-tokens.js +471 -0
  300. package/tools/vendor/codex-quota/lib/claude-usage.js +929 -0
  301. package/tools/vendor/codex-quota/lib/codex-accounts.js +205 -0
  302. package/tools/vendor/codex-quota/lib/codex-tokens.js +326 -0
  303. package/tools/vendor/codex-quota/lib/codex-usage.js +32 -0
  304. package/tools/vendor/codex-quota/lib/color.js +72 -0
  305. package/tools/vendor/codex-quota/lib/constants.js +57 -0
  306. package/tools/vendor/codex-quota/lib/container.js +143 -0
  307. package/tools/vendor/codex-quota/lib/display.js +1111 -0
  308. package/tools/vendor/codex-quota/lib/fs.js +63 -0
  309. package/tools/vendor/codex-quota/lib/handlers.js +2060 -0
  310. package/tools/vendor/codex-quota/lib/jwt.js +33 -0
  311. package/tools/vendor/codex-quota/lib/oauth.js +486 -0
  312. package/tools/vendor/codex-quota/lib/paths.js +34 -0
  313. package/tools/vendor/codex-quota/lib/prompts.js +44 -0
  314. package/tools/vendor/codex-quota/lib/sync.js +1438 -0
  315. package/tools/vendor/codex-quota/lib/token-match.js +96 -0
  316. package/tools/vendor/codex-quota-manager/scripts/auto-switch.sh +500 -0
  317. package/tools/vendor/codex-quota-manager/scripts/batch-add.sh +123 -0
@@ -0,0 +1,471 @@
1
+ /**
2
+ * Claude token refresh and multi-store persistence.
3
+ * Depends on: lib/constants.js, lib/paths.js, lib/token-match.js, lib/container.js, lib/fs.js
4
+ */
5
+
6
+ import { existsSync, readFileSync } from "node:fs";
7
+ import {
8
+ CLAUDE_CREDENTIALS_PATH,
9
+ CLAUDE_MULTI_ACCOUNT_PATHS,
10
+ CLAUDE_OAUTH_TOKEN_URL,
11
+ CLAUDE_OAUTH_CLIENT_ID,
12
+ CLAUDE_OAUTH_REFRESH_BUFFER_MS,
13
+ OAUTH_TIMEOUT_MS,
14
+ } from "./constants.js";
15
+ import { getOpencodeAuthPath, getPiAuthPath } from "./paths.js";
16
+ import { isOauthTokenMatch, normalizeEntryTokens, CLAUDE_TOKEN_FIELDS } from "./token-match.js";
17
+ import { readMultiAccountContainer, writeMultiAccountContainer, mapContainerAccounts } from "./container.js";
18
+ import { writeFileAtomic } from "./fs.js";
19
+
20
+ // Internal helpers using the shared token-match generics
21
+ function isClaudeOauthTokenMatch(params) {
22
+ return isOauthTokenMatch(params);
23
+ }
24
+
25
+ function normalizeClaudeOauthEntryTokens(entry) {
26
+ return normalizeEntryTokens(entry, CLAUDE_TOKEN_FIELDS);
27
+ }
28
+
29
+ function updateClaudeOauthEntry(entry, account) {
30
+ const accessKey = "oauthToken" in entry
31
+ ? "oauthToken"
32
+ : "oauth_token" in entry
33
+ ? "oauth_token"
34
+ : "accessToken" in entry
35
+ ? "accessToken"
36
+ : "access_token" in entry
37
+ ? "access_token"
38
+ : "oauthToken";
39
+ const refreshKey = "oauthRefreshToken" in entry
40
+ ? "oauthRefreshToken"
41
+ : "oauth_refresh_token" in entry
42
+ ? "oauth_refresh_token"
43
+ : "refreshToken" in entry
44
+ ? "refreshToken"
45
+ : "refresh_token" in entry
46
+ ? "refresh_token"
47
+ : "oauthRefreshToken";
48
+ const expiresKey = "oauthExpiresAt" in entry
49
+ ? "oauthExpiresAt"
50
+ : "oauth_expires_at" in entry
51
+ ? "oauth_expires_at"
52
+ : "expiresAt" in entry
53
+ ? "expiresAt"
54
+ : "expires_at" in entry
55
+ ? "expires_at"
56
+ : "oauthExpiresAt";
57
+ const scopesKey = "oauthScopes" in entry
58
+ ? "oauthScopes"
59
+ : "oauth_scopes" in entry
60
+ ? "oauth_scopes"
61
+ : "scopes" in entry
62
+ ? "scopes"
63
+ : "oauthScopes";
64
+
65
+ entry[accessKey] = account.accessToken;
66
+ entry[refreshKey] = account.refreshToken ?? null;
67
+ entry[expiresKey] = account.expiresAt ?? null;
68
+ if (account.scopes) {
69
+ entry[scopesKey] = account.scopes;
70
+ }
71
+
72
+ return entry;
73
+ }
74
+
75
+ /**
76
+ * Update Claude Code credentials with new OAuth tokens
77
+ * @param {{ oauthToken: string, oauthRefreshToken?: string | null, oauthExpiresAt?: number | null, oauthScopes?: string[] | null }} account
78
+ * @returns {{ updated: boolean, path: string, error?: string }}
79
+ */
80
+ export function updateClaudeCredentials(account) {
81
+ const credentialsPath = process.env.CLAUDE_CREDENTIALS_PATH || CLAUDE_CREDENTIALS_PATH;
82
+ let existing = {};
83
+ if (existsSync(credentialsPath)) {
84
+ try {
85
+ const raw = readFileSync(credentialsPath, "utf-8");
86
+ const parsed = JSON.parse(raw);
87
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
88
+ return { updated: false, path: credentialsPath, error: "Invalid Claude credentials format" };
89
+ }
90
+ existing = parsed;
91
+ } catch (err) {
92
+ const message = err?.message ?? String(err);
93
+ return { updated: false, path: credentialsPath, error: `Failed to read Claude credentials: ${message}` };
94
+ }
95
+ }
96
+
97
+ const updatedOauth = {
98
+ accessToken: account.oauthToken,
99
+ refreshToken: account.oauthRefreshToken ?? null,
100
+ expiresAt: account.oauthExpiresAt ?? null,
101
+ scopes: account.oauthScopes ?? null,
102
+ };
103
+
104
+ const updatedCredentials = {
105
+ ...existing,
106
+ claudeAiOauth: updatedOauth,
107
+ };
108
+ if ("claude_ai_oauth" in updatedCredentials) {
109
+ delete updatedCredentials.claude_ai_oauth;
110
+ }
111
+
112
+ try {
113
+ writeFileAtomic(credentialsPath, JSON.stringify(updatedCredentials, null, 2) + "\n", { mode: 0o600 });
114
+ } catch (err) {
115
+ const message = err?.message ?? String(err);
116
+ return { updated: false, path: credentialsPath, error: `Failed to write Claude credentials: ${message}` };
117
+ }
118
+
119
+ return { updated: true, path: credentialsPath };
120
+ }
121
+
122
+ /**
123
+ * Update OpenCode auth.json with new Claude OAuth tokens
124
+ * @param {{ oauthToken: string, oauthRefreshToken?: string | null, oauthExpiresAt?: number | null, oauthScopes?: string[] | null }} account
125
+ * @returns {{ updated: boolean, path: string, error?: string, skipped?: boolean }}
126
+ */
127
+ export function updateOpencodeClaudeAuth(account) {
128
+ const authPath = getOpencodeAuthPath();
129
+ if (!existsSync(authPath)) {
130
+ return { updated: false, path: authPath, skipped: true };
131
+ }
132
+
133
+ let existingAuth = {};
134
+ try {
135
+ const raw = readFileSync(authPath, "utf-8");
136
+ const parsed = JSON.parse(raw);
137
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
138
+ return { updated: false, path: authPath, error: "Invalid OpenCode auth.json format" };
139
+ }
140
+ existingAuth = parsed;
141
+ } catch (err) {
142
+ const message = err?.message ?? String(err);
143
+ return { updated: false, path: authPath, error: `Failed to read OpenCode auth.json: ${message}` };
144
+ }
145
+
146
+ const anthropicEntry = existingAuth.anthropic;
147
+ const anthropicAuth = anthropicEntry && typeof anthropicEntry === "object" ? anthropicEntry : {};
148
+ const updatedAuth = {
149
+ ...existingAuth,
150
+ anthropic: {
151
+ ...anthropicAuth,
152
+ type: "oauth",
153
+ access: account.oauthToken,
154
+ refresh: account.oauthRefreshToken ?? null,
155
+ expires: account.oauthExpiresAt ?? null,
156
+ scopes: account.oauthScopes ?? null,
157
+ },
158
+ };
159
+
160
+ try {
161
+ writeFileAtomic(authPath, JSON.stringify(updatedAuth, null, 2) + "\n", { mode: 0o600 });
162
+ } catch (err) {
163
+ const message = err?.message ?? String(err);
164
+ return { updated: false, path: authPath, error: `Failed to write OpenCode auth.json: ${message}` };
165
+ }
166
+
167
+ return { updated: true, path: authPath };
168
+ }
169
+
170
+ /**
171
+ * Update pi auth.json with new Claude OAuth tokens
172
+ * @param {{ oauthToken: string, oauthRefreshToken?: string | null, oauthExpiresAt?: number | null, oauthScopes?: string[] | null }} account
173
+ * @returns {{ updated: boolean, path: string, error?: string, skipped?: boolean }}
174
+ */
175
+ export function updatePiClaudeAuth(account) {
176
+ const authPath = getPiAuthPath();
177
+ if (!existsSync(authPath)) {
178
+ return { updated: false, path: authPath, skipped: true };
179
+ }
180
+
181
+ let existingAuth = {};
182
+ try {
183
+ const raw = readFileSync(authPath, "utf-8");
184
+ const parsed = JSON.parse(raw);
185
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
186
+ return { updated: false, path: authPath, error: "Invalid pi auth.json format" };
187
+ }
188
+ existingAuth = parsed;
189
+ } catch (err) {
190
+ const message = err?.message ?? String(err);
191
+ return { updated: false, path: authPath, error: `Failed to read pi auth.json: ${message}` };
192
+ }
193
+
194
+ const anthropicEntry = existingAuth.anthropic;
195
+ const anthropicAuth = anthropicEntry && typeof anthropicEntry === "object" ? anthropicEntry : {};
196
+ const updatedAuth = {
197
+ ...existingAuth,
198
+ anthropic: {
199
+ ...anthropicAuth,
200
+ type: "oauth",
201
+ access: account.oauthToken,
202
+ refresh: account.oauthRefreshToken ?? null,
203
+ expires: account.oauthExpiresAt ?? null,
204
+ scopes: account.oauthScopes ?? null,
205
+ },
206
+ };
207
+
208
+ try {
209
+ writeFileAtomic(authPath, JSON.stringify(updatedAuth, null, 2) + "\n", { mode: 0o600 });
210
+ } catch (err) {
211
+ const message = err?.message ?? String(err);
212
+ return { updated: false, path: authPath, error: `Failed to write pi auth.json: ${message}` };
213
+ }
214
+
215
+ return { updated: true, path: authPath };
216
+ }
217
+
218
+ /**
219
+ * Persist refreshed Claude OAuth tokens to all known stores that match.
220
+ * @param {{ label: string, accessToken: string, refreshToken?: string | null, expiresAt?: number | null, scopes?: string[] | null, source?: string }} account
221
+ * @param {{ previousAccessToken?: string | null, previousRefreshToken?: string | null }} previousTokens
222
+ * @returns {{ updatedPaths: string[], errors: string[] }}
223
+ */
224
+ export function persistClaudeOAuthTokens(account, previousTokens = {}) {
225
+ const updatedPaths = [];
226
+ const errors = [];
227
+ const previousAccess = previousTokens.previousAccessToken ?? null;
228
+ const previousRefresh = previousTokens.previousRefreshToken ?? null;
229
+
230
+ const updatePayload = {
231
+ oauthToken: account.accessToken,
232
+ oauthRefreshToken: account.refreshToken ?? null,
233
+ oauthExpiresAt: account.expiresAt ?? null,
234
+ oauthScopes: account.scopes ?? null,
235
+ };
236
+
237
+ if (!account.source?.startsWith("env")) {
238
+ const credentialsPath = process.env.CLAUDE_CREDENTIALS_PATH || CLAUDE_CREDENTIALS_PATH;
239
+ if (existsSync(credentialsPath)) {
240
+ try {
241
+ const raw = readFileSync(credentialsPath, "utf-8");
242
+ const parsed = JSON.parse(raw);
243
+ const oauth = parsed?.claudeAiOauth ?? parsed?.claude_ai_oauth ?? null;
244
+ const stored = normalizeClaudeOauthEntryTokens(oauth ?? {});
245
+ if (isClaudeOauthTokenMatch({
246
+ storedAccess: stored.access,
247
+ storedRefresh: stored.refresh,
248
+ previousAccess,
249
+ previousRefresh,
250
+ label: account.label,
251
+ storedLabel: "claude-code",
252
+ })) {
253
+ const scopes = account.scopes ?? stored.scopes ?? null;
254
+ const result = updateClaudeCredentials({
255
+ ...updatePayload,
256
+ oauthScopes: scopes,
257
+ });
258
+ if (result.updated) updatedPaths.push(result.path);
259
+ if (result.error) errors.push(result.error);
260
+ }
261
+ } catch {
262
+ // ignore parse errors, handled by updateClaudeCredentials
263
+ }
264
+ }
265
+
266
+ const opencodePath = getOpencodeAuthPath();
267
+ if (existsSync(opencodePath)) {
268
+ try {
269
+ const raw = readFileSync(opencodePath, "utf-8");
270
+ const parsed = JSON.parse(raw);
271
+ const anthropic = parsed?.anthropic ?? null;
272
+ const storedAccess = anthropic?.access ?? null;
273
+ const storedRefresh = anthropic?.refresh ?? null;
274
+ if (isClaudeOauthTokenMatch({
275
+ storedAccess,
276
+ storedRefresh,
277
+ previousAccess,
278
+ previousRefresh,
279
+ label: account.label,
280
+ storedLabel: "opencode",
281
+ })) {
282
+ const result = updateOpencodeClaudeAuth(updatePayload);
283
+ if (result.updated) updatedPaths.push(result.path);
284
+ if (result.error) errors.push(result.error);
285
+ }
286
+ } catch {
287
+ // ignore
288
+ }
289
+ }
290
+
291
+ const piPath = getPiAuthPath();
292
+ if (existsSync(piPath)) {
293
+ try {
294
+ const raw = readFileSync(piPath, "utf-8");
295
+ const parsed = JSON.parse(raw);
296
+ const anthropic = parsed?.anthropic ?? null;
297
+ const storedAccess = anthropic?.access ?? null;
298
+ const storedRefresh = anthropic?.refresh ?? null;
299
+ if (isClaudeOauthTokenMatch({
300
+ storedAccess,
301
+ storedRefresh,
302
+ previousAccess,
303
+ previousRefresh,
304
+ label: account.label,
305
+ storedLabel: "pi",
306
+ })) {
307
+ const result = updatePiClaudeAuth(updatePayload);
308
+ if (result.updated) updatedPaths.push(result.path);
309
+ if (result.error) errors.push(result.error);
310
+ }
311
+ } catch {
312
+ // ignore
313
+ }
314
+ }
315
+
316
+ for (const path of CLAUDE_MULTI_ACCOUNT_PATHS) {
317
+ if (!existsSync(path)) continue;
318
+ try {
319
+ const container = readMultiAccountContainer(path);
320
+ if (container.rootType === "invalid") {
321
+ errors.push(`Failed to parse ${path}`);
322
+ continue;
323
+ }
324
+ const mapped = mapContainerAccounts(container, (entry) => {
325
+ if (!entry || typeof entry !== "object") return entry;
326
+ const stored = normalizeClaudeOauthEntryTokens(entry);
327
+ const matches = isClaudeOauthTokenMatch({
328
+ storedAccess: stored.access,
329
+ storedRefresh: stored.refresh,
330
+ previousAccess,
331
+ previousRefresh,
332
+ label: account.label,
333
+ storedLabel: entry?.label ?? null,
334
+ });
335
+ if (!matches) return entry;
336
+ const scopes = account.scopes ?? stored.scopes ?? null;
337
+ return updateClaudeOauthEntry({ ...entry }, { ...account, scopes });
338
+ });
339
+
340
+ if (mapped.updated) {
341
+ writeMultiAccountContainer(path, container, mapped.accounts, {}, { mode: 0o600 });
342
+ updatedPaths.push(path);
343
+ }
344
+ } catch (err) {
345
+ const message = err?.message ?? String(err);
346
+ errors.push(`Failed to update ${path}: ${message}`);
347
+ }
348
+ }
349
+ }
350
+
351
+ return { updatedPaths, errors };
352
+ }
353
+
354
+ /**
355
+ * Refresh a Claude OAuth token using the refresh token
356
+ * @param {string} refreshTokenValue - The refresh token
357
+ * @returns {Promise<{ accessToken: string, refreshToken: string, expiresIn: number }>}
358
+ */
359
+ export async function refreshClaudeToken(refreshTokenValue) {
360
+ const controller = new AbortController();
361
+ const timeout = setTimeout(() => controller.abort(), OAUTH_TIMEOUT_MS);
362
+
363
+ try {
364
+ const body = {
365
+ grant_type: "refresh_token",
366
+ refresh_token: refreshTokenValue,
367
+ client_id: CLAUDE_OAUTH_CLIENT_ID,
368
+ };
369
+
370
+ const response = await fetch(CLAUDE_OAUTH_TOKEN_URL, {
371
+ method: "POST",
372
+ headers: {
373
+ "Content-Type": "application/json",
374
+ },
375
+ body: JSON.stringify(body),
376
+ signal: controller.signal,
377
+ });
378
+
379
+ if (!response.ok) {
380
+ const text = await response.text();
381
+ throw new Error(`Token refresh failed: ${response.status} ${text}`);
382
+ }
383
+
384
+ const data = await response.json();
385
+
386
+ return {
387
+ accessToken: data.access_token,
388
+ refreshToken: data.refresh_token || refreshTokenValue,
389
+ expiresIn: data.expires_in || 3600,
390
+ };
391
+ } finally {
392
+ clearTimeout(timeout);
393
+ }
394
+ }
395
+
396
+ export function isClaudeOauthTokenExpiring(expiresAt) {
397
+ if (!expiresAt) return false;
398
+ return expiresAt <= Date.now() + CLAUDE_OAUTH_REFRESH_BUFFER_MS;
399
+ }
400
+
401
+ function resolveClaudeOauthAccountFields(account) {
402
+ const usesOauthShape = Boolean(
403
+ account
404
+ && typeof account === "object"
405
+ && (
406
+ "oauthToken" in account
407
+ || "oauthRefreshToken" in account
408
+ || "oauthExpiresAt" in account
409
+ || "oauthScopes" in account
410
+ )
411
+ );
412
+ const accessToken = usesOauthShape ? account.oauthToken : account.accessToken;
413
+ const refreshToken = usesOauthShape ? account.oauthRefreshToken : account.refreshToken;
414
+ const expiresAt = usesOauthShape ? account.oauthExpiresAt : account.expiresAt;
415
+ const scopes = usesOauthShape ? account.oauthScopes : account.scopes;
416
+ return { usesOauthShape, accessToken, refreshToken, expiresAt, scopes };
417
+ }
418
+
419
+ /**
420
+ * Ensure a Claude OAuth access token is fresh, refreshing and persisting if needed.
421
+ * @param {{ label: string, accessToken?: string, refreshToken?: string | null, expiresAt?: number | null, scopes?: string[] | null, oauthToken?: string, oauthRefreshToken?: string | null, oauthExpiresAt?: number | null, oauthScopes?: string[] | null, source?: string }} account
422
+ * @returns {Promise<boolean>}
423
+ */
424
+ export async function ensureFreshClaudeOAuthToken(account) {
425
+ const fields = resolveClaudeOauthAccountFields(account);
426
+ if (!isClaudeOauthTokenExpiring(fields.expiresAt)) return true;
427
+ if (!fields.refreshToken) return false;
428
+
429
+ const previousAccessToken = fields.accessToken;
430
+ const previousRefreshToken = fields.refreshToken;
431
+
432
+ try {
433
+ const refreshed = await refreshClaudeToken(fields.refreshToken);
434
+ if (!refreshed?.accessToken) return false;
435
+ const updatedAccessToken = refreshed.accessToken;
436
+ const updatedRefreshToken = refreshed.refreshToken ?? fields.refreshToken;
437
+ const updatedExpiresAt = Date.now() + refreshed.expiresIn * 1000;
438
+ if (fields.usesOauthShape) {
439
+ account.oauthToken = updatedAccessToken;
440
+ account.oauthRefreshToken = updatedRefreshToken;
441
+ account.oauthExpiresAt = updatedExpiresAt;
442
+ if (fields.scopes && !account.oauthScopes) {
443
+ account.oauthScopes = fields.scopes;
444
+ }
445
+ } else {
446
+ account.accessToken = updatedAccessToken;
447
+ account.refreshToken = updatedRefreshToken;
448
+ account.expiresAt = updatedExpiresAt;
449
+ if (fields.scopes && !account.scopes) {
450
+ account.scopes = fields.scopes;
451
+ }
452
+ }
453
+ persistClaudeOAuthTokens({
454
+ label: account.label,
455
+ accessToken: updatedAccessToken,
456
+ refreshToken: updatedRefreshToken,
457
+ expiresAt: updatedExpiresAt,
458
+ scopes: fields.scopes ?? null,
459
+ source: account.source,
460
+ }, {
461
+ previousAccessToken,
462
+ previousRefreshToken,
463
+ });
464
+ return true;
465
+ } catch {
466
+ return false;
467
+ }
468
+ }
469
+
470
+ // Re-export internal helpers that other modules need
471
+ export { normalizeClaudeOauthEntryTokens, updateClaudeOauthEntry };