@1aboveio/engineering-skills 0.0.0-stage → 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 (233) hide show
  1. package/README.md +28 -2
  2. package/package.json +33 -4
  3. package/skills/better-review/LICENSE +3 -0
  4. package/skills/better-review/SKILL.md +249 -0
  5. package/skills/better-review/agents/openai.yaml +9 -0
  6. package/skills/better-review/references/domain-hazards.md +53 -0
  7. package/skills/better-review/references/passes.md +147 -0
  8. package/skills/better-review/references/result.md +151 -0
  9. package/skills/better-review/release-check.mjs +93 -0
  10. package/skills/better-review/scripts/pr-context.mjs +212 -0
  11. package/skills/better-review/scripts/pr-context.test.mjs +168 -0
  12. package/skills/better-review/scripts/rereview-scope.mjs +503 -0
  13. package/skills/better-review/scripts/rereview-scope.test.mjs +587 -0
  14. package/skills/better-review/scripts/scan-diff.mjs +365 -0
  15. package/skills/better-review/scripts/scan-diff.test.mjs +414 -0
  16. package/skills/better-review/scripts/vendor-sync.test.mjs +96 -0
  17. package/skills/e2e-test/LICENSE +3 -0
  18. package/skills/e2e-test/SKILL.md +98 -0
  19. package/skills/e2e-test/assets/ci-gates.cloudbuild.yaml +24 -0
  20. package/skills/e2e-test/references/authoring/auth-flows.md +159 -0
  21. package/skills/e2e-test/references/authoring/playwright-config.md +73 -0
  22. package/skills/e2e-test/references/authoring/playwright-patterns.md +144 -0
  23. package/skills/e2e-test/references/ci-integration.md +25 -0
  24. package/skills/e2e-test/references/ci-playwright-container.md +290 -0
  25. package/skills/e2e-test/references/presentation-sweep.md +104 -0
  26. package/skills/e2e-test/references/reviewing.md +41 -0
  27. package/skills/e2e-test/references/route-manifest.md +51 -0
  28. package/skills/e2e-test/release-check.mjs +93 -0
  29. package/skills/e2e-test/scripts/detect-routes-nextjs.mjs +200 -0
  30. package/skills/e2e-test/scripts/presentation-checks.mjs +171 -0
  31. package/skills/e2e-test/scripts/presentation-checks.test.mjs +106 -0
  32. package/skills/e2e-test/scripts/presentation-perceivability.mjs +179 -0
  33. package/skills/e2e-test/scripts/presentation-perceivability.test.mjs +117 -0
  34. package/skills/e2e-test/scripts/presentation-reachability.mjs +154 -0
  35. package/skills/e2e-test/scripts/presentation-reachability.test.mjs +69 -0
  36. package/skills/e2e-test/scripts/presentation-render-health.mjs +141 -0
  37. package/skills/e2e-test/scripts/presentation-render-health.test.mjs +98 -0
  38. package/skills/e2e-test/scripts/presentation-sweep.mjs +147 -0
  39. package/skills/e2e-test/scripts/presentation-sweep.test.mjs +71 -0
  40. package/skills/e2e-test/scripts/presentation-temporal.mjs +127 -0
  41. package/skills/e2e-test/scripts/presentation-temporal.test.mjs +59 -0
  42. package/skills/e2e-test/scripts/project-route-manifest.mjs +82 -0
  43. package/skills/e2e-test/scripts/project-route-manifest.test.mjs +76 -0
  44. package/skills/e2e-test/scripts/validate-manifest.mjs +106 -0
  45. package/skills/engineering-runtime/LICENSE +3 -0
  46. package/skills/engineering-runtime/SKILL.md +11 -0
  47. package/skills/engineering-runtime/agents/openai.yaml +6 -0
  48. package/skills/engineering-runtime/coherence/workflow.json +597 -0
  49. package/skills/engineering-runtime/engineering-runtime.test.mjs +68 -0
  50. package/skills/engineering-runtime/release-check.mjs +93 -0
  51. package/skills/engineering-runtime/scripts/exact-head-artifact.mjs +131 -0
  52. package/skills/engineering-runtime/scripts/head-check-set.mjs +398 -0
  53. package/skills/engineering-runtime/scripts/invocation-policy.mjs +187 -0
  54. package/skills/engineering-runtime/scripts/invocation-policy.test.mjs +95 -0
  55. package/skills/engineering-runtime/scripts/main-module.mjs +79 -0
  56. package/skills/engineering-runtime/scripts/main-module.test.mjs +288 -0
  57. package/skills/engineering-runtime/scripts/mergify-yaml.mjs +11 -0
  58. package/skills/engineering-runtime/scripts/package-lock.json +43 -0
  59. package/skills/engineering-runtime/scripts/package.json +10 -0
  60. package/skills/engineering-runtime/scripts/required-check-plan.mjs +223 -0
  61. package/skills/engineering-runtime/scripts/required-check-plan.test.mjs +96 -0
  62. package/skills/engineering-runtime/scripts/review-completion.mjs +56 -0
  63. package/skills/engineering-runtime/scripts/workflow-coherence.mjs +595 -0
  64. package/skills/engineering-runtime/scripts/workflow-policy.mjs +189 -0
  65. package/skills/engineering-runtime/scripts/yaml-mapping.mjs +18 -0
  66. package/skills/ensure-coverage/LICENSE +3 -0
  67. package/skills/ensure-coverage/SKILL.md +129 -0
  68. package/skills/ensure-coverage/references/breadth/coverage-ledger.md +92 -0
  69. package/skills/ensure-coverage/references/breadth/inventory-contract.md +85 -0
  70. package/skills/ensure-coverage/references/breadth/surface-baseline.md +44 -0
  71. package/skills/ensure-coverage/references/breadth/surface-discovery.md +16 -0
  72. package/skills/ensure-coverage/references/depth/characterization.md +68 -0
  73. package/skills/ensure-coverage/references/depth/coverage.config.example.json +19 -0
  74. package/skills/ensure-coverage/references/depth/grading.md +35 -0
  75. package/skills/ensure-coverage/references/depth/mock-policy.md +57 -0
  76. package/skills/ensure-coverage/references/depth/test-smells.md +39 -0
  77. package/skills/ensure-coverage/references/enforcement/ci-contract.md +44 -0
  78. package/skills/ensure-coverage/references/examples/coverage-ledger.md +110 -0
  79. package/skills/ensure-coverage/references/examples/refund-flow.md +35 -0
  80. package/skills/ensure-coverage/references/presentation/axis.md +64 -0
  81. package/skills/ensure-coverage/references/process/audit-mode.md +27 -0
  82. package/skills/ensure-coverage/references/process/output-template.md +139 -0
  83. package/skills/ensure-coverage/references/process/test-strategy.md +56 -0
  84. package/skills/ensure-coverage/release-check.mjs +93 -0
  85. package/skills/ensure-coverage/schemas/coverage-config.schema.json +67 -0
  86. package/skills/ensure-coverage/schemas/coverage-file.schema.json +140 -0
  87. package/skills/ensure-coverage/scripts/README.md +99 -0
  88. package/skills/ensure-coverage/scripts/adapters/nextjs-inventory.mjs +182 -0
  89. package/skills/ensure-coverage/scripts/adapters/nextjs-inventory.test.mjs +96 -0
  90. package/skills/ensure-coverage/scripts/check-quarantine-expiry.mjs +105 -0
  91. package/skills/ensure-coverage/scripts/check-quarantine-expiry.test.mjs +47 -0
  92. package/skills/ensure-coverage/scripts/ci-audit.mjs +137 -0
  93. package/skills/ensure-coverage/scripts/ci-audit.test.mjs +86 -0
  94. package/skills/ensure-coverage/scripts/coverage-ledger.mjs +674 -0
  95. package/skills/ensure-coverage/scripts/coverage-ledger.test.mjs +447 -0
  96. package/skills/ensure-coverage/scripts/design-parity.mjs +591 -0
  97. package/skills/ensure-coverage/scripts/design-parity.test.mjs +552 -0
  98. package/skills/ensure-coverage/scripts/lint-tests.mjs +282 -0
  99. package/skills/ensure-coverage/scripts/lint-tests.test.mjs +289 -0
  100. package/skills/ensure-coverage/scripts/mock-policy-config.mjs +176 -0
  101. package/skills/ensure-coverage/scripts/mock-policy-config.test.mjs +119 -0
  102. package/skills/ensure-coverage/scripts/package.json +19 -0
  103. package/skills/golden-path/LICENSE +3 -0
  104. package/skills/golden-path/SKILL.md +230 -0
  105. package/skills/golden-path/agents/openai.yaml +3 -0
  106. package/skills/golden-path/assets/golden-paths.example.json +57 -0
  107. package/skills/golden-path/references/contract.md +239 -0
  108. package/skills/golden-path/references/migration.md +111 -0
  109. package/skills/golden-path/release-check.mjs +93 -0
  110. package/skills/golden-path/scripts/golden-path-core.mjs +1779 -0
  111. package/skills/golden-path/scripts/golden-path.mjs +6 -0
  112. package/skills/golden-path/scripts/golden-path.test.mjs +1457 -0
  113. package/skills/harness-runtime/LICENSE +3 -0
  114. package/skills/harness-runtime/SKILL.md +19 -0
  115. package/skills/harness-runtime/agents/openai.yaml +6 -0
  116. package/skills/harness-runtime/bin/discover-models.mjs +4 -0
  117. package/skills/harness-runtime/bin/model-catalog.mjs +4 -0
  118. package/skills/harness-runtime/contracts.md +15 -0
  119. package/skills/harness-runtime/discover-models.mjs +392 -0
  120. package/skills/harness-runtime/discover-models.test.mjs +363 -0
  121. package/skills/harness-runtime/fixtures/native-question-schemas.json +33 -0
  122. package/skills/harness-runtime/fixtures/question-responses.json +54 -0
  123. package/skills/harness-runtime/harness-runtime.test.mjs +967 -0
  124. package/skills/harness-runtime/index.mjs +767 -0
  125. package/skills/harness-runtime/model-catalog-seed.test.mjs +829 -0
  126. package/skills/harness-runtime/model-catalog.mjs +787 -0
  127. package/skills/harness-runtime/model-catalog.test.mjs +366 -0
  128. package/skills/harness-runtime/native-question-contracts.md +37 -0
  129. package/skills/harness-runtime/references/model-catalog-seed.json +408 -0
  130. package/skills/harness-runtime/references/model-catalog.md +57 -0
  131. package/skills/harness-runtime/release-check.mjs +93 -0
  132. package/skills/resolve-issues/LICENSE +3 -0
  133. package/skills/resolve-issues/SKILL.md +250 -0
  134. package/skills/resolve-issues/agents/openai.yaml +9 -0
  135. package/skills/resolve-issues/plugin-hooks.json +17 -0
  136. package/skills/resolve-issues/references/canary.md +28 -0
  137. package/skills/resolve-issues/references/ci.md +105 -0
  138. package/skills/resolve-issues/references/done.md +25 -0
  139. package/skills/resolve-issues/references/dropbox.md +90 -0
  140. package/skills/resolve-issues/references/expire.md +318 -0
  141. package/skills/resolve-issues/references/exploration.md +202 -0
  142. package/skills/resolve-issues/references/implementation.md +303 -0
  143. package/skills/resolve-issues/references/preflight.md +445 -0
  144. package/skills/resolve-issues/references/review.md +228 -0
  145. package/skills/resolve-issues/references/shared-modules.md +44 -0
  146. package/skills/resolve-issues/references/task-plan.md +264 -0
  147. package/skills/resolve-issues/release-check.mjs +93 -0
  148. package/skills/resolve-issues/scripts/cleanup-runs.mjs +364 -0
  149. package/skills/resolve-issues/scripts/cleanup-runs.test.mjs +280 -0
  150. package/skills/resolve-issues/scripts/discover-models.mjs +9 -0
  151. package/skills/resolve-issues/scripts/dropbox.mjs +473 -0
  152. package/skills/resolve-issues/scripts/dropbox.test.mjs +346 -0
  153. package/skills/resolve-issues/scripts/findings-reuse.mjs +98 -0
  154. package/skills/resolve-issues/scripts/findings-reuse.test.mjs +88 -0
  155. package/skills/resolve-issues/scripts/github-reviews.mjs +384 -0
  156. package/skills/resolve-issues/scripts/github-reviews.test.mjs +264 -0
  157. package/skills/resolve-issues/scripts/install-hooks.mjs +135 -0
  158. package/skills/resolve-issues/scripts/install-hooks.test.mjs +79 -0
  159. package/skills/resolve-issues/scripts/issue-tree.mjs +162 -0
  160. package/skills/resolve-issues/scripts/issue-tree.test.mjs +107 -0
  161. package/skills/resolve-issues/scripts/manual-invocation.test.mjs +14 -0
  162. package/skills/resolve-issues/scripts/model-catalog.mjs +9 -0
  163. package/skills/resolve-issues/scripts/next-actions-capacity.test.mjs +149 -0
  164. package/skills/resolve-issues/scripts/next-actions.mjs +856 -0
  165. package/skills/resolve-issues/scripts/next-actions.test.mjs +915 -0
  166. package/skills/resolve-issues/scripts/plan-sync.mjs +269 -0
  167. package/skills/resolve-issues/scripts/plan-sync.test.mjs +156 -0
  168. package/skills/resolve-issues/scripts/preflight-models.mjs +736 -0
  169. package/skills/resolve-issues/scripts/preflight-models.test.mjs +448 -0
  170. package/skills/resolve-issues/scripts/ready-check.mjs +185 -0
  171. package/skills/resolve-issues/scripts/ready-check.test.mjs +217 -0
  172. package/skills/resolve-issues/scripts/rehydrate.mjs +98 -0
  173. package/skills/resolve-issues/scripts/rehydrate.test.mjs +91 -0
  174. package/skills/resolve-issues/scripts/review-verdict.mjs +509 -0
  175. package/skills/resolve-issues/scripts/review-verdict.test.mjs +1060 -0
  176. package/skills/resolve-issues/scripts/size-check.mjs +492 -0
  177. package/skills/resolve-issues/scripts/size-check.test.mjs +458 -0
  178. package/skills/resolve-release/LICENSE +3 -0
  179. package/skills/resolve-release/SKILL.md +215 -0
  180. package/skills/resolve-release/agents/openai.yaml +8 -0
  181. package/skills/resolve-release/flows/cloud-run-canary.md +13 -0
  182. package/skills/resolve-release/flows/cloud-run.md +7 -0
  183. package/skills/resolve-release/flows/root-tag-npm.md +13 -0
  184. package/skills/resolve-release/flows/workspace-npm.md +22 -0
  185. package/skills/resolve-release/references/canary.md +51 -0
  186. package/skills/resolve-release/references/candidate.md +41 -0
  187. package/skills/resolve-release/references/cut.md +131 -0
  188. package/skills/resolve-release/references/dark-launch.md +66 -0
  189. package/skills/resolve-release/references/flows.md +150 -0
  190. package/skills/resolve-release/references/preflight.md +154 -0
  191. package/skills/resolve-release/references/prepared-metadata.md +260 -0
  192. package/skills/resolve-release/references/promotion.md +82 -0
  193. package/skills/resolve-release/references/publish.md +232 -0
  194. package/skills/resolve-release/references/workspace-npm.md +103 -0
  195. package/skills/resolve-release/release-check.mjs +93 -0
  196. package/skills/resolve-release/scripts/apply.mjs +212 -0
  197. package/skills/resolve-release/scripts/apply.test.mjs +99 -0
  198. package/skills/resolve-release/scripts/dark-flags.mjs +134 -0
  199. package/skills/resolve-release/scripts/dark-flags.test.mjs +100 -0
  200. package/skills/resolve-release/scripts/flow.mjs +500 -0
  201. package/skills/resolve-release/scripts/flow.test.mjs +340 -0
  202. package/skills/resolve-release/scripts/green-head.mjs +231 -0
  203. package/skills/resolve-release/scripts/green-head.test.mjs +101 -0
  204. package/skills/resolve-release/scripts/npm-version-absence.mjs +138 -0
  205. package/skills/resolve-release/scripts/npm-version-absence.test.mjs +426 -0
  206. package/skills/resolve-release/scripts/plan-npm.test.mjs +659 -0
  207. package/skills/resolve-release/scripts/plan-toml-boundary.test.mjs +317 -0
  208. package/skills/resolve-release/scripts/plan-uv.test.mjs +291 -0
  209. package/skills/resolve-release/scripts/plan.mjs +806 -0
  210. package/skills/resolve-release/scripts/plan.test.mjs +428 -0
  211. package/skills/rush-issues/LICENSE +3 -0
  212. package/skills/rush-issues/SKILL.md +58 -0
  213. package/skills/rush-issues/agents/openai.yaml +8 -0
  214. package/skills/rush-issues/rehydrate.mjs +10 -0
  215. package/skills/rush-issues/release-check.mjs +93 -0
  216. package/skills/rush-release/LICENSE +3 -0
  217. package/skills/rush-release/SKILL.md +35 -0
  218. package/skills/rush-release/agents/openai.yaml +8 -0
  219. package/skills/rush-release/release-check.mjs +93 -0
  220. package/skills/test-quality/LICENSE +3 -0
  221. package/skills/test-quality/SKILL.md +79 -0
  222. package/skills/test-quality/references/audit.md +80 -0
  223. package/skills/test-quality/references/lint.md +24 -0
  224. package/skills/test-quality/references/principles.md +143 -0
  225. package/skills/test-quality/references/testing-conventions.md +9 -0
  226. package/skills/test-quality/release-check.mjs +93 -0
  227. package/skills/test-quality/scripts/lint-tests.mjs +574 -0
  228. package/skills/test-quality/scripts/lint-tests.test.mjs +591 -0
  229. package/skills/test-quality/scripts/mock-policy-config.mjs +176 -0
  230. package/skills/test-quality/scripts/mock-policy-config.test.mjs +119 -0
  231. package/skills/test-quality/scripts/persist-conventions-core.mjs +116 -0
  232. package/skills/test-quality/scripts/persist-conventions.mjs +17 -0
  233. package/skills/test-quality/scripts/persist-conventions.test.mjs +104 -0
@@ -0,0 +1,149 @@
1
+ import assert from 'node:assert/strict'
2
+ import { spawnSync } from 'node:child_process'
3
+ import { chmodSync, existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
4
+ import { tmpdir } from 'node:os'
5
+ import { join } from 'node:path'
6
+ import test from 'node:test'
7
+ import { nextActions, parseCliArgs, NextActionsError } from './next-actions.mjs'
8
+
9
+ const script = new URL('./next-actions.mjs', import.meta.url)
10
+ const pending = (n) => Array.from({ length: n }, (_, i) => ({ id: `p${i}`, status: 'pending', stage: 'pending' }))
11
+ const busy = (n) => Array.from({ length: n }, (_, i) => ({ id: `w${i}`, status: 'in-flight', stage: 'implement', worker: `run${i}`, workerKind: 'implement' }))
12
+ const snapshot = (maxConcurrent, runningCount = 0, pendingCount = 0) => ({
13
+ revision: 'live-settings', maxConcurrent, runningCount, pendingCount,
14
+ occupiedSlots: runningCount + pendingCount,
15
+ availableSlots: Math.max(0, maxConcurrent - runningCount - pendingCount),
16
+ })
17
+ const starts = (result) => result.due.filter(a => ['fill-slot', 'resume', 'start-review', 'start-fix'].includes(a.action)).map(a => a.unit)
18
+
19
+ test('the live Harness limit permits six independent units instead of a hidden four', () => {
20
+ const result = nextActions({ units: pending(6) }, {}, snapshot(6))
21
+ assert.deepEqual(starts(result), ['p0', 'p1', 'p2', 'p3', 'p4', 'p5'])
22
+ assert.deepEqual(result.waiting, [])
23
+ })
24
+
25
+ test('available capacity already subtracts workflow, outside, and reserved workers', () => {
26
+ const plan = { units: [...busy(2), ...pending(4)] }
27
+ const result = nextActions(plan, {}, snapshot(6, 3, 1))
28
+ assert.deepEqual(starts(result), ['p0', 'p1'])
29
+ assert.deepEqual(result.waiting.map(a => a.unit), ['p2', 'p3'])
30
+ assert.equal(result.busy, 2)
31
+ })
32
+
33
+ test('a lower cap preserves existing workers, blocks new starts, and permits coordination', () => {
34
+ const plan = { units: [...busy(4), ...pending(2),
35
+ { id: 'done', status: 'in-flight', stage: 'done', pr: '#1', headSha: 'abc', reviewedHead: 'abc' }] }
36
+ const before = structuredClone(plan)
37
+ const result = nextActions(plan, {}, snapshot(2, 4))
38
+ assert.deepEqual(starts(result), [])
39
+ assert.deepEqual(result.waiting.map(a => a.unit), ['p0', 'p1'])
40
+ assert.deepEqual(result.due.map(a => a.action), ['deliver'])
41
+ assert.deepEqual(plan, before)
42
+ })
43
+
44
+ test('each scheduling pass uses its new snapshot, not a frozen run-start budget', () => {
45
+ const plan = { units: pending(6) }
46
+ assert.deepEqual(starts(nextActions(plan, {}, snapshot(1))), ['p0'])
47
+ assert.deepEqual(starts(nextActions(plan, {}, snapshot(6))), ['p0', 'p1', 'p2', 'p3', 'p4', 'p5'])
48
+ assert.deepEqual(starts(nextActions(plan, {}, snapshot(6, 6))), [])
49
+ })
50
+
51
+ test('dependency constraints still hold even with spare capacity', () => {
52
+ const plan = { units: [...pending(6), { id: 'child', status: 'pending', dependsOn: ['p0'] }] }
53
+ assert.deepEqual(starts(nextActions(plan, {}, snapshot(8))), ['p0', 'p1', 'p2', 'p3', 'p4', 'p5'])
54
+ })
55
+
56
+ test('inconsistent capacity refuses instead of guessing; no capacity at all means unlimited', () => {
57
+ for (const capacity of [{}, [], '6', -1, 1.5, Infinity,
58
+ { ...snapshot(6), availableSlots: 7 }, { ...snapshot(6), runningCount: -1 },
59
+ { ...snapshot(6), occupiedSlots: 1 }, { ...snapshot(6), pendingCount: 0.5 },
60
+ { ...snapshot(6), maxConcurrent: 0 }, { maxConcurrent: 6, availableSlots: 6 }]) {
61
+ assert.throws(() => nextActions({ units: pending(1) }, {}, capacity), NextActionsError)
62
+ }
63
+ assert.deepEqual(starts(nextActions({ units: pending(6) }, {}, 6)), ['p0', 'p1', 'p2', 'p3', 'p4', 'p5'])
64
+ assert.deepEqual(starts(nextActions({ units: pending(1) }, {}, 0)), [])
65
+ for (const none of [undefined, null]) {
66
+ const open = nextActions({ units: [...busy(2), ...pending(6)] }, {}, none)
67
+ assert.deepEqual(open.capacity, { source: 'none' })
68
+ assert.deepEqual(starts(open), ['p0', 'p1', 'p2', 'p3', 'p4', 'p5'], 'every worker action is due without a capacity source')
69
+ assert.deepEqual(open.waiting, [])
70
+ assert.ok(open.due.every((a) => /\[needs a free worker slot\]$/.test(a.detail)))
71
+ }
72
+ })
73
+
74
+ test('CLI takes at most one capacity source, none at all, and accepts an exhausted budget', () => {
75
+ assert.equal(parseCliArgs(['--run', '/run']).slots, undefined)
76
+ assert.equal(parseCliArgs(['--run', '/run']).capacity, undefined)
77
+ assert.throws(() => parseCliArgs(['--run', '/run', '--slots', '4', '--capacity-json', JSON.stringify(snapshot(6))]), NextActionsError)
78
+ assert.throws(() => parseCliArgs(['--run', '/run', '--capacity-json', '{broken']), NextActionsError)
79
+ assert.throws(() => parseCliArgs(['--run', '/run', '--capacity-json', JSON.stringify({ maxConcurrent: 6 })]), NextActionsError)
80
+ assert.equal(parseCliArgs(['--run', '/run', '--slots', '0']).slots, 0)
81
+ })
82
+
83
+ test('malformed CLI capacity refuses before sync, network access, or run-state writes', t => {
84
+ const run = mkdtempSync(join(tmpdir(), 'next-actions-capacity-refusal-'))
85
+ t.after(() => rmSync(run, { recursive: true, force: true }))
86
+ const contents = {
87
+ 'task-plan.json': JSON.stringify({ skill: 'resolve-issues', spec: 'o/r#1', units: [{ id: '2', status: 'pending', stage: 'pending' }] }),
88
+ 'issue-tree.json': JSON.stringify({ root: 'o/r#1', complete: true, nodes: {
89
+ 'o/r#1': { key: 'o/r#1', repo: 'o/r', number: 1, state: 'open', children: ['o/r#2'], blockedBy: [] },
90
+ 'o/r#2': { key: 'o/r#2', repo: 'o/r', number: 2, title: 'Pending unit', state: 'open', children: [], blockedBy: [] },
91
+ } }),
92
+ 'next-actions-seen.json': JSON.stringify({ marker: 'preserve-seen-state' }),
93
+ }
94
+ for (const [file, value] of Object.entries(contents)) writeFileSync(join(run, file), value)
95
+ const gh = join(run, 'gh')
96
+ writeFileSync(gh, '#!/bin/sh\nprintf touched > "$CAPACITY_GH_SPY"\nexit 1\n')
97
+ chmodSync(gh, 0o755)
98
+ const spy = join(run, 'network-called')
99
+ for (const flag of ['--sync', '--resume']) {
100
+ for (const value of ['{broken', JSON.stringify({ maxConcurrent: 6 }), JSON.stringify({ ...snapshot(6), occupiedSlots: 1 })]) {
101
+ const result = spawnSync(process.execPath, [script.pathname, '--run', run, '--capacity-json', value, flag, '--json'], {
102
+ encoding: 'utf8', env: { ...process.env, PATH: run, CAPACITY_GH_SPY: spy },
103
+ })
104
+ assert.equal(result.status, 2, result.stderr)
105
+ assert.equal(result.stdout, '')
106
+ assert.equal(existsSync(spy), false, 'invalid capacity must not reach GitHub sync')
107
+ for (const [file, value] of Object.entries(contents)) assert.equal(readFileSync(join(run, file), 'utf8'), value)
108
+ }
109
+ }
110
+ const control = spawnSync(process.execPath, [script.pathname, '--run', run, '--capacity-json', JSON.stringify(snapshot(6)), '--sync', '--json', '--peek'], {
111
+ encoding: 'utf8', env: { ...process.env, PATH: run, CAPACITY_GH_SPY: spy },
112
+ })
113
+ assert.equal(control.status, 0, control.stderr)
114
+ assert.equal(existsSync(spy), true, 'positive control proves valid capacity reaches the same GitHub sync boundary')
115
+ assert.deepEqual(starts(JSON.parse(control.stdout)), ['2'])
116
+ })
117
+
118
+ test('CLI applies fresh capacity and reports its source without modifying the task plan', t => {
119
+ const run = mkdtempSync(join(tmpdir(), 'next-actions-capacity-'))
120
+ t.after(() => rmSync(run, { recursive: true, force: true }))
121
+ const path = join(run, 'task-plan.json')
122
+ const saved = JSON.stringify({ skill: 'resolve-issues', units: [...busy(2), ...pending(4)] })
123
+ writeFileSync(path, saved)
124
+ const call = (...args) => spawnSync(process.execPath, [script.pathname, '--run', run, ...args], { encoding: 'utf8' })
125
+ const unlimited = call('--json', '--peek')
126
+ assert.equal(unlimited.status, 0, unlimited.stderr)
127
+ assert.deepEqual(JSON.parse(unlimited.stdout).capacity, { source: 'none' })
128
+ assert.deepEqual(starts(JSON.parse(unlimited.stdout)), ['p0', 'p1', 'p2', 'p3'], 'with no capacity flag every worker action is due')
129
+ const unlimitedText = call('--peek')
130
+ assert.equal(unlimitedText.status, 0, unlimitedText.stderr)
131
+ assert.match(unlimitedText.stdout, /fill-slot\s+.*\[needs a free worker slot\]/)
132
+ assert.equal(unlimitedText.stdout.match(/no capacity given/g).length, 1, 'the capacity line says so once')
133
+ assert.equal(call('--exit-due', '--peek').status, 1)
134
+ assert.equal(call('--slots', '2', '--capacity-json', JSON.stringify(snapshot(6))).status, 2, 'two capacity sources are an error')
135
+ assert.equal(existsSync(join(run, 'next-actions-seen.json')), false)
136
+ const first = call('--capacity-json', JSON.stringify(snapshot(6, 3, 1)), '--json')
137
+ assert.equal(first.status, 0, first.stderr)
138
+ assert.equal(JSON.parse(first.stdout).exitDue, true)
139
+ const result = JSON.parse(first.stdout)
140
+ assert.deepEqual(starts(result), ['p0', 'p1'])
141
+ assert.deepEqual(result.capacity, { source: 'harness', ...snapshot(6, 3, 1) })
142
+ const exhausted = call('--capacity-json', JSON.stringify(snapshot(2, 4)), '--json')
143
+ assert.equal(exhausted.status, 0, exhausted.stderr)
144
+ assert.equal(JSON.parse(exhausted.stdout).exitDue, false)
145
+ assert.deepEqual(starts(JSON.parse(exhausted.stdout)), [])
146
+ assert.equal(readFileSync(path, 'utf8'), saved)
147
+ const text = call('--capacity-json', JSON.stringify(snapshot(6, 3, 1)))
148
+ assert.match(text.stdout, /Harness.*4\/6.*2 available/)
149
+ })