@1aboveio/engineering-skills 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (233) hide show
  1. package/README.md +28 -2
  2. package/package.json +34 -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 +117 -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,217 @@
1
+ import { test } from 'node:test'
2
+ import assert from 'node:assert/strict'
3
+ import { spawnSync } from 'node:child_process'
4
+ import { chmodSync, mkdtempSync, writeFileSync } from 'node:fs'
5
+ import { tmpdir } from 'node:os'
6
+ import { dirname, join } from 'node:path'
7
+ import { fileURLToPath } from 'node:url'
8
+
9
+ import { DEFAULT_LABEL, ReadyCheckError, parseArgs, parseIssueRef, readyCheck, treeFetchers } from './ready-check.mjs'
10
+
11
+ const script = join(dirname(fileURLToPath(import.meta.url)), 'ready-check.mjs')
12
+
13
+ // A small in-memory GitHub: issues keyed "owner/name#n", sub-issues as API-shaped children.
14
+ function fakeGithub(issues, subIssues = {}) {
15
+ return {
16
+ fetchIssue: ({ repo, number }) => {
17
+ const issue = issues[`${repo}#${number}`]
18
+ if (!issue) throw new Error(`HTTP 404 ${repo}#${number}`)
19
+ return issue
20
+ },
21
+ fetchSubIssues: ({ repo, number }) => (subIssues[`${repo}#${number}`] || []).map((ref) => {
22
+ const [childRepo, n] = ref.split('#')
23
+ return { number: Number(n), repository_url: `https://api.github.com/repos/${childRepo}` }
24
+ }),
25
+ }
26
+ }
27
+ const issue = (labels, state = 'open', title = 't') => ({ state, title, labels: labels.map((name) => ({ name })) })
28
+
29
+ test('the default label is ready-for-agent', () => {
30
+ assert.equal(DEFAULT_LABEL, 'ready-for-agent')
31
+ })
32
+
33
+ test('an issue and all its sub-issues labeled ready passes', () => {
34
+ const gh = fakeGithub(
35
+ { 'o/r#1': issue(['epic', 'ready-for-agent']), 'o/r#2': issue(['ready-for-agent']), 'o/r#3': issue(['Ready-For-Agent']) },
36
+ { 'o/r#1': ['o/r#2', 'o/r#3'] },
37
+ )
38
+ const result = readyCheck([{ repo: 'o/r', number: 1 }], gh)
39
+ assert.equal(result.ready, true)
40
+ assert.equal(result.checked.length, 3, 'label match ignores case')
41
+ })
42
+
43
+ test('an epic without the label passes when all its open sub-issues are ready', () => {
44
+ const gh = fakeGithub(
45
+ { 'o/r#1': issue(['epic']), 'o/r#2': issue(['ready-for-agent']), 'o/r#3': issue(['epic']), 'o/r#4': issue(['ready-for-agent']) },
46
+ { 'o/r#1': ['o/r#2', 'o/r#3'], 'o/r#3': ['o/r#4'] },
47
+ )
48
+ const result = readyCheck([{ repo: 'o/r', number: 1 }], gh)
49
+ assert.equal(result.ready, true)
50
+ assert.deepEqual(result.checked.filter((c) => c.exempt).map((c) => c.ref), ['o/r#1', 'o/r#3'], 'nested epics are exempt too')
51
+ })
52
+
53
+ test('an epic without the label still reports a sub-issue that is not ready', () => {
54
+ const gh = fakeGithub({ 'o/r#1': issue(['epic']), 'o/r#2': issue(['triage']) }, { 'o/r#1': ['o/r#2'] })
55
+ const result = readyCheck([{ repo: 'o/r', number: 1 }], gh)
56
+ assert.equal(result.ready, false)
57
+ assert.deepEqual(result.missing.map((m) => m.ref), ['o/r#2'])
58
+ })
59
+
60
+ test('an open issue whose sub-issues are all closed is a unit again: a rollup that needs the label', () => {
61
+ // #1343 was held, its prerequisite #1659 was filed under it and closed: the old check
62
+ // called #1343 resolved and the run dropped its remaining work.
63
+ const gh = fakeGithub(
64
+ { 'o/r#1': issue(['epic']), 'o/r#2': issue([], 'closed'), 'o/r#3': issue(['ready-for-agent']), 'o/r#4': issue([], 'closed') },
65
+ { 'o/r#1': ['o/r#2'], 'o/r#3': ['o/r#4'] },
66
+ )
67
+ const result = readyCheck([{ repo: 'o/r', number: 1 }, { repo: 'o/r', number: 3 }], gh)
68
+ assert.equal(result.ready, false)
69
+ assert.deepEqual(result.missing.map((m) => m.ref), ['o/r#1'])
70
+ assert.deepEqual(result.rollups.map((r) => r.ref), ['o/r#1', 'o/r#3'])
71
+ })
72
+
73
+ test('an epic whose only open sub-issue is a rollup stays a container', () => {
74
+ const gh = fakeGithub(
75
+ { 'o/r#1': issue(['epic']), 'o/r#2': issue(['ready-for-agent']), 'o/r#3': issue([], 'closed') },
76
+ { 'o/r#1': ['o/r#2'], 'o/r#2': ['o/r#3'] },
77
+ )
78
+ const result = readyCheck([{ repo: 'o/r', number: 1 }], gh)
79
+ assert.equal(result.ready, true)
80
+ assert.equal(result.checked.find((c) => c.ref === 'o/r#1').exempt, 'has open sub-issues')
81
+ assert.deepEqual(result.rollups.map((r) => r.ref), ['o/r#2'])
82
+ })
83
+
84
+ test('a plain issue with no sub-issues is a unit, not a rollup', () => {
85
+ const gh = fakeGithub({ 'o/r#1': issue([]) })
86
+ const result = readyCheck([{ repo: 'o/r', number: 1 }], gh)
87
+ assert.equal(result.ready, false)
88
+ assert.deepEqual(result.rollups, [])
89
+ })
90
+
91
+ test('an epic with an unreadable sub-issue is neither exempt nor a rollup', () => {
92
+ const gh = fakeGithub({ 'o/r#1': issue(['epic']) }, { 'o/r#1': ['o/r#404'] })
93
+ const result = readyCheck([{ repo: 'o/r', number: 1 }], gh)
94
+ assert.equal(result.ready, false)
95
+ assert.deepEqual(result.missing.map((m) => m.ref), ['o/r#1'])
96
+ assert.deepEqual(result.unreadable.map((m) => m.ref), ['o/r#404'])
97
+ const partly = fakeGithub({ 'o/r#1': issue(['epic']), 'o/r#2': issue([], 'closed') }, { 'o/r#1': ['o/r#2', 'o/r#404'] })
98
+ assert.deepEqual(readyCheck([{ repo: 'o/r', number: 1 }], partly).rollups, [], 'one closed plus one unreadable is not a rollup')
99
+ })
100
+
101
+ test('tree fetchers answer from the GraphQL tree and fall back to REST for the rest', () => {
102
+ const tree = { nodes: {
103
+ 'o/r#1': { key: 'o/r#1', state: 'open', title: 'epic', labels: ['epic'], children: ['o/r#2', 'x/y#9'] },
104
+ 'o/r#2': { key: 'o/r#2', state: 'open', title: 'a', labels: ['ready-for-agent'], children: [] },
105
+ 'x/y#9': { key: 'x/y#9', state: 'open', title: 'deep', labels: ['ready-for-agent'], children: null },
106
+ } }
107
+ const calls = []
108
+ const rest = fakeGithub({ 'x/y#10': issue(['ready-for-agent']) }, { 'x/y#9': ['x/y#10'] })
109
+ const fallback = { fetchIssue: (r) => { calls.push(`issue ${r.repo}#${r.number}`); return rest.fetchIssue(r) }, fetchSubIssues: (r) => { calls.push(`subs ${r.repo}#${r.number}`); return rest.fetchSubIssues(r) } }
110
+ const result = readyCheck([{ repo: 'o/r', number: 1 }], treeFetchers([tree], fallback))
111
+ assert.equal(result.ready, true)
112
+ assert.deepEqual(calls, ['subs x/y#9', 'issue x/y#10', 'subs x/y#10'], 'only the part the tree did not cover hits REST')
113
+ })
114
+
115
+ test('a sub-issue shared by two epics makes both containers', () => {
116
+ const gh = fakeGithub(
117
+ { 'o/r#1': issue(['epic']), 'o/r#2': issue(['epic']), 'o/r#3': issue(['ready-for-agent']) },
118
+ { 'o/r#1': ['o/r#3'], 'o/r#2': ['o/r#3'] },
119
+ )
120
+ assert.equal(readyCheck([{ repo: 'o/r', number: 1 }, { repo: 'o/r', number: 2 }], gh).ready, true)
121
+ })
122
+
123
+ test('a sub-issue at any depth, in another repository, without the label is reported', () => {
124
+ const gh = fakeGithub(
125
+ { 'o/r#1': issue(['ready-for-agent']), 'o/r#2': issue(['ready-for-agent']), 'x/y#9': issue(['bug']) },
126
+ { 'o/r#1': ['o/r#2'], 'o/r#2': ['x/y#9'] },
127
+ )
128
+ const result = readyCheck([{ repo: 'o/r', number: 1 }], gh)
129
+ assert.equal(result.ready, false)
130
+ assert.deepEqual(result.missing, [{ ref: 'x/y#9', title: 't', labels: ['bug'], parent: 'o/r#2' }])
131
+ assert.equal(result.checked.find((c) => c.ref === 'x/y#9').depth, 2)
132
+ })
133
+
134
+ test('closed sub-issues are skipped; a closed named issue is still checked', () => {
135
+ const gh = fakeGithub(
136
+ { 'o/r#1': issue(['ready-for-agent']), 'o/r#2': issue([], 'closed'), 'o/r#5': issue([], 'closed') },
137
+ { 'o/r#1': ['o/r#2'] },
138
+ )
139
+ assert.equal(readyCheck([{ repo: 'o/r', number: 1 }], gh).ready, true)
140
+ assert.equal(readyCheck([{ repo: 'o/r', number: 5 }], gh).ready, false)
141
+ })
142
+
143
+ test('an unreadable issue or sub-issue list fails closed', () => {
144
+ const gh = fakeGithub({ 'o/r#1': issue(['ready-for-agent']) }, { 'o/r#1': ['o/r#404'] })
145
+ const result = readyCheck([{ repo: 'o/r', number: 1 }], gh)
146
+ assert.equal(result.ready, false)
147
+ assert.equal(result.unreadable[0].ref, 'o/r#404')
148
+ const brokenList = { ...gh, fetchSubIssues: () => { throw new Error('HTTP 502') } }
149
+ assert.equal(readyCheck([{ repo: 'o/r', number: 1 }], brokenList).ready, false)
150
+ })
151
+
152
+ test('a sub-issue loop is walked once', () => {
153
+ const gh = fakeGithub(
154
+ { 'o/r#1': issue(['ready-for-agent']), 'o/r#2': issue(['ready-for-agent']) },
155
+ { 'o/r#1': ['o/r#2'], 'o/r#2': ['o/r#1'] },
156
+ )
157
+ assert.equal(readyCheck([{ repo: 'o/r', number: 1 }], gh).checked.length, 2)
158
+ })
159
+
160
+ test('a custom label is honored', () => {
161
+ const gh = fakeGithub({ 'o/r#1': issue(['agent-ok']) })
162
+ assert.equal(readyCheck([{ repo: 'o/r', number: 1 }], { ...gh, label: 'agent-ok' }).ready, true)
163
+ assert.equal(readyCheck([{ repo: 'o/r', number: 1 }], gh).ready, false)
164
+ })
165
+
166
+ test('issue references accept owner/name#n, URLs, and bare numbers with a repo', () => {
167
+ assert.deepEqual(parseIssueRef('o/r#12'), { repo: 'o/r', number: 12 })
168
+ assert.deepEqual(parseIssueRef('https://github.com/o/r/issues/7'), { repo: 'o/r', number: 7 })
169
+ assert.deepEqual(parseIssueRef('#3', 'o/r'), { repo: 'o/r', number: 3 })
170
+ assert.throws(() => parseIssueRef('3'), ReadyCheckError)
171
+ assert.throws(() => parseArgs([]), ReadyCheckError)
172
+ assert.throws(() => parseArgs(['--bogus']), ReadyCheckError)
173
+ })
174
+
175
+ // ---- CLI against a fake `gh` on PATH ----
176
+
177
+ function withFakeGh(responses) {
178
+ const dir = mkdtempSync(join(tmpdir(), 'ready-check-gh-'))
179
+ const cases = Object.entries(responses)
180
+ .map(([path, body]) => ` "${path}") cat <<'EOF'\n${JSON.stringify(body)}\nEOF\n ;;`)
181
+ .join('\n')
182
+ // gh api [--paginate --slurp] <path>: the path is the last argument.
183
+ writeFileSync(join(dir, 'gh'), `#!/bin/sh\nfor last; do :; done\ncase "$last" in\n${cases}\n *) echo "HTTP 404" >&2; exit 1 ;;\nesac\n`)
184
+ chmodSync(join(dir, 'gh'), 0o755)
185
+ return { ...process.env, PATH: `${dir}:${process.env.PATH}` }
186
+ }
187
+
188
+ test('CLI exits 0 with the outcome in the output, 2 on bad input; --exit-outcome restores the old codes', () => {
189
+ const env = withFakeGh({
190
+ 'repos/o/r/issues/1': issue(['ready-for-agent']),
191
+ 'repos/o/r/issues/1/sub_issues': [[{ number: 2, repository_url: 'https://api.github.com/repos/o/r' }]],
192
+ 'repos/o/r/issues/2': issue(['triage'], 'open', 'Add login'),
193
+ 'repos/o/r/issues/2/sub_issues': [[]],
194
+ 'repos/o/r/issues/3': issue(['ready-for-agent']),
195
+ 'repos/o/r/issues/3/sub_issues': [[]],
196
+ })
197
+ const ok = spawnSync(process.execPath, [script, '--issue', 'o/r#3'], { env, encoding: 'utf8' })
198
+ assert.equal(ok.status, 0, ok.stderr)
199
+ assert.equal(JSON.parse(ok.stdout).outcome, 'ready')
200
+ const unlabeled = spawnSync(process.execPath, [script, '--repo', 'o/r', '--issue', '1'], { env, encoding: 'utf8' })
201
+ assert.equal(unlabeled.status, 0, unlabeled.stderr)
202
+ assert.equal(JSON.parse(unlabeled.stdout).outcome, 'unlabeled')
203
+ assert.deepEqual(JSON.parse(unlabeled.stdout).missing, [{ ref: 'o/r#2', title: 'Add login', labels: ['triage'], parent: 'o/r#1' }])
204
+ const named = spawnSync(process.execPath, [script, '--issue', 'o/r#2'], { env, encoding: 'utf8' })
205
+ assert.equal(named.status, 0, named.stderr)
206
+ assert.equal(JSON.parse(named.stdout).missing[0].parent, null)
207
+ const unreadable = spawnSync(process.execPath, [script, '--issue', 'o/r#2', '--issue', 'o/r#404'], { env, encoding: 'utf8' })
208
+ assert.equal(unreadable.status, 0, unreadable.stderr)
209
+ assert.equal(JSON.parse(unreadable.stdout).outcome, 'unreadable', 'an unreadable issue outranks an unlabeled one')
210
+ const legacy = (...args) => spawnSync(process.execPath, [script, '--exit-outcome', ...args], { env, encoding: 'utf8' }).status
211
+ assert.equal(legacy('--issue', 'o/r#3'), 0)
212
+ assert.equal(legacy('--repo', 'o/r', '--issue', '1'), 3)
213
+ assert.equal(legacy('--issue', 'o/r#2', '--issue', 'o/r#404'), 1)
214
+ assert.equal(legacy(), 2)
215
+ const usage = spawnSync(process.execPath, [script], { env, encoding: 'utf8' })
216
+ assert.equal(usage.status, 2)
217
+ })
@@ -0,0 +1,98 @@
1
+ #!/usr/bin/env node
2
+ // After a context compaction, tell the coordinator of a run in progress to read its skills in
3
+ // full again: a compaction summary keeps the run's state but drops the skill's rules.
4
+ //
5
+ // rehydrate.mjs [--cwd <dir>] [--hook]
6
+ //
7
+ // Finds runs under the nearest .resolve-issues/rush at or above <cwd> (a coordinator may stand
8
+ // in a unit workspace inside the run), in */task-plan.json whose plan changed in the last
9
+ // ACTIVE_HOURS and still has a unit not succeeded or cancelled. Prints nothing when there is
10
+ // none, so a compaction in any other session adds nothing. Otherwise prints the SKILL.md paths
11
+ // to read, each run, its next-actions command, and RULES.
12
+ //
13
+ // --hook reads the hook's JSON from stdin (its `cwd` wins over --cwd) and prints a SessionStart
14
+ // `hookSpecificOutput`, the shape both Claude Code and Codex add to context. install-hooks.mjs
15
+ // wires it to SessionStart with matcher `compact`; Pi's workflow extension runs the owner skill's
16
+ // rehydrate.mjs (rush-issues/rehydrate.mjs runs this one) with --cwd after a compaction. Always
17
+ // exits 0: a hook never blocks a session.
18
+
19
+ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
20
+ import { dirname, join, resolve } from 'node:path'
21
+ import { fileURLToPath } from 'node:url'
22
+
23
+ import { isMainModule } from '../../engineering-runtime/scripts/main-module.mjs'
24
+ import { RULES, SKILL_PATH } from './next-actions.mjs'
25
+
26
+ export const ACTIVE_HOURS = 24
27
+ const SCRIPTS = dirname(fileURLToPath(import.meta.url))
28
+ const RUSH_SKILL_PATH = join(dirname(dirname(SCRIPTS)), 'rush-issues', 'SKILL.md')
29
+ const DONE = new Set(['succeeded', 'cancelled'])
30
+
31
+ // The nearest <dir>/.resolve-issues/rush at or above cwd, or null.
32
+ export function runsRoot(cwd) {
33
+ for (let dir = resolve(cwd); ; dir = dirname(dir)) {
34
+ const root = join(dir, '.resolve-issues', 'rush')
35
+ if (existsSync(root)) return root
36
+ if (dirname(dir) === dir) return null
37
+ }
38
+ }
39
+
40
+ // Runs under runsRoot(cwd), newest first: { dir, skill, revision, open }.
41
+ export function activeRuns(cwd, now = Date.now(), hours = ACTIVE_HOURS) {
42
+ const root = runsRoot(cwd)
43
+ if (!root) return []
44
+ let names = []
45
+ try { names = readdirSync(root) } catch { return [] }
46
+ const runs = []
47
+ for (const name of names) {
48
+ const file = join(root, name, 'task-plan.json')
49
+ let mtime
50
+ try { mtime = statSync(file).mtimeMs } catch { continue }
51
+ if (now - mtime > hours * 3_600_000) continue
52
+ let plan
53
+ try { plan = JSON.parse(readFileSync(file, 'utf8')) } catch { continue }
54
+ const units = (Array.isArray(plan?.units) ? plan.units : plan?.issues) ?? []
55
+ const open = units.filter((u) => !DONE.has(u?.status)).length
56
+ if (!open) continue
57
+ runs.push({ dir: join(root, name), skill: plan.skill ?? 'resolve-issues', revision: plan.planRevision ?? null, open, mtime })
58
+ }
59
+ return runs.sort((a, b) => b.mtime - a.mtime).map(({ mtime, ...r }) => r)
60
+ }
61
+
62
+ export function message(runs, { skillPath = SKILL_PATH, rushSkillPath = RUSH_SKILL_PATH } = {}) {
63
+ if (!runs.length) return ''
64
+ const skills = [skillPath]
65
+ if (runs.some((r) => r.skill === 'rush-issues') && existsSync(rushSkillPath)) skills.push(rushSkillPath)
66
+ const nextActions = join(dirname(skillPath), 'scripts', 'next-actions.mjs')
67
+ return [
68
+ 'Your context was just compacted while you coordinate a resolve-issues run. The summary keeps the run\'s state, not the skill\'s rules.',
69
+ 'Before your next step, read each of these in full, with no line limit:',
70
+ ...skills.map((s) => `- ${s}`),
71
+ 'Read subagent_settings now and again immediately before each command below; inspect separately for every recovered run after earlier starts. Pass only that command\'s fresh structured snapshot with --capacity-json. There is no default worker count; if inspection is unavailable, follow the skill\'s explicit reconciled --slots fallback. The script exits 0 whenever it ran; read what is due from its output.',
72
+ 'Runs in progress here:',
73
+ ...runs.map((r) => `- ${r.dir} (${r.skill}, plan revision ${r.revision ?? 'unknown'}, ${r.open} units open): refresh subagent_settings immediately before node ${nextActions} --run ${r.dir} --capacity-json '<fresh snapshot JSON>'`),
74
+ `Rules a compaction most often drops: ${RULES}`,
75
+ ].join('\n')
76
+ }
77
+
78
+ export function hookOutput(text) {
79
+ return JSON.stringify({ hookSpecificOutput: { hookEventName: 'SessionStart', additionalContext: text } })
80
+ }
81
+
82
+ // The CLI, exported so rush-issues/rehydrate.mjs can run it as its own.
83
+ export function main(argv) {
84
+ try {
85
+ const hook = argv.includes('--hook')
86
+ let cwd = argv.includes('--cwd') ? argv[argv.indexOf('--cwd') + 1] : process.cwd()
87
+ if (hook) {
88
+ try { cwd = JSON.parse(readFileSync(0, 'utf8'))?.cwd || cwd } catch { /* no input: keep cwd */ }
89
+ }
90
+ const text = message(activeRuns(cwd))
91
+ if (text) process.stdout.write(hook ? `${hookOutput(text)}\n` : `${text}\n`)
92
+ } catch (error) {
93
+ process.stderr.write(`rehydrate: ${error.message}\n`)
94
+ }
95
+ process.exitCode = 0
96
+ }
97
+
98
+ if (isMainModule(import.meta.url)) main(process.argv.slice(2))
@@ -0,0 +1,91 @@
1
+ import { test } from 'node:test'
2
+ import assert from 'node:assert/strict'
3
+ import { spawnSync } from 'node:child_process'
4
+ import fs from 'node:fs'
5
+ import os from 'node:os'
6
+ import path from 'node:path'
7
+ import { fileURLToPath } from 'node:url'
8
+
9
+ import { activeRuns, message, ACTIVE_HOURS } from './rehydrate.mjs'
10
+ import { RULES, SKILL_PATH } from './next-actions.mjs'
11
+
12
+ const SCRIPT = path.join(path.dirname(fileURLToPath(import.meta.url)), 'rehydrate.mjs')
13
+
14
+ function repo(runs) {
15
+ const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'rehydrate-'))
16
+ for (const [name, plan, ageHours = 0] of runs) {
17
+ const dir = path.join(cwd, '.resolve-issues', 'rush', name)
18
+ fs.mkdirSync(dir, { recursive: true })
19
+ const file = path.join(dir, 'task-plan.json')
20
+ fs.writeFileSync(file, typeof plan === 'string' ? plan : JSON.stringify(plan))
21
+ const at = new Date(Date.now() - ageHours * 3_600_000)
22
+ fs.utimesSync(file, at, at)
23
+ }
24
+ return cwd
25
+ }
26
+
27
+ test('only a recent run with an open unit counts; finished, stale, and unreadable runs do not', () => {
28
+ const cwd = repo([
29
+ ['live', { skill: 'rush-issues', planRevision: 267, units: [{ id: '1', status: 'succeeded' }, { id: '2', status: 'in-flight' }, { id: '3', status: 'blocked' }] }, 1],
30
+ ['done', { units: [{ id: '1', status: 'succeeded' }, { id: '2', status: 'cancelled' }] }],
31
+ ['stale', { units: [{ id: '1', status: 'in-flight' }] }, ACTIVE_HOURS + 1],
32
+ ['broken', '{not json'],
33
+ ])
34
+ const runs = activeRuns(cwd)
35
+ assert.deepEqual(runs, [{ dir: path.join(cwd, '.resolve-issues', 'rush', 'live'), skill: 'rush-issues', revision: 267, open: 2 }])
36
+ assert.deepEqual(activeRuns(fs.mkdtempSync(path.join(os.tmpdir(), 'rehydrate-none-'))), [], 'no .resolve-issues: nothing')
37
+ const unit = path.join(cwd, '.resolve-issues', 'rush', 'live', 'units', '7')
38
+ fs.mkdirSync(unit, { recursive: true })
39
+ assert.deepEqual(activeRuns(unit), runs, 'a coordinator standing in a unit workspace still finds its run')
40
+ })
41
+
42
+ test('the message names both skills for a rush run, each run with its next-actions command, and the rules', () => {
43
+ const dir = '/repo/.resolve-issues/rush/r1'
44
+ const rush = path.join(path.dirname(path.dirname(SKILL_PATH)), 'rush-issues', 'SKILL.md')
45
+ const text = message([{ dir, skill: 'rush-issues', revision: 5, open: 3 }], { rushSkillPath: SKILL_PATH })
46
+ assert.match(text, /read each of these in full, with no line limit/)
47
+ assert.ok(text.includes(`- ${SKILL_PATH}\n`))
48
+ assert.ok(text.includes(`next-actions.mjs --run ${dir} --capacity-json '<fresh snapshot JSON>'`))
49
+ assert.match(text, /Read subagent_settings now/)
50
+ assert.match(text, /no default worker count/)
51
+ assert.ok(text.endsWith(RULES))
52
+ const plain = message([{ dir, skill: 'resolve-issues', revision: 5, open: 3 }], { rushSkillPath: rush })
53
+ assert.ok(!plain.includes('rush-issues/SKILL.md'), 'a resolve-issues run reads only its own skill')
54
+ assert.equal(message([]), '')
55
+ })
56
+
57
+ test('each recovered run refreshes capacity separately instead of reusing one snapshot', () => {
58
+ const text = message([
59
+ { dir: '/repo/.resolve-issues/rush/first', skill: 'resolve-issues', revision: 1, open: 6 },
60
+ { dir: '/repo/.resolve-issues/rush/second', skill: 'resolve-issues', revision: 2, open: 3 },
61
+ ])
62
+ const commands = text.split('\n').filter(line => line.includes('next-actions.mjs --run'))
63
+ assert.equal(commands.length, 2)
64
+ for (const command of commands) {
65
+ assert.match(command, /refresh subagent_settings immediately before node/)
66
+ assert.match(command, /--capacity-json '<fresh snapshot JSON>'/)
67
+ }
68
+ })
69
+
70
+ test('as a hook it reads cwd from stdin, prints SessionStart context, and prints nothing without a run', () => {
71
+ const cwd = repo([['live', { skill: 'resolve-issues', units: [{ id: '1', status: 'pending' }] }]])
72
+ const run = (input) => spawnSync(process.execPath, [SCRIPT, '--hook'], { input, encoding: 'utf8', cwd: os.tmpdir() })
73
+ const out = run(JSON.stringify({ hook_event_name: 'SessionStart', source: 'compact', cwd }))
74
+ assert.equal(out.status, 0)
75
+ const parsed = JSON.parse(out.stdout)
76
+ assert.equal(parsed.hookSpecificOutput.hookEventName, 'SessionStart')
77
+ assert.match(parsed.hookSpecificOutput.additionalContext, /Runs in progress here:/)
78
+ const empty = run(JSON.stringify({ cwd: fs.mkdtempSync(path.join(os.tmpdir(), 'rehydrate-empty-')) }))
79
+ assert.equal(empty.status, 0)
80
+ assert.equal(empty.stdout, '')
81
+ assert.equal(run('not json').status, 0, 'bad input never blocks a session')
82
+ })
83
+
84
+ test('rush-issues/rehydrate.mjs prints the same message, for a harness that runs the owner skill\'s script', () => {
85
+ const cwd = repo([['live', { skill: 'rush-issues', units: [{ id: '1', status: 'in-flight' }] }]])
86
+ const rush = path.join(path.dirname(path.dirname(SKILL_PATH)), 'rush-issues', 'rehydrate.mjs')
87
+ const out = spawnSync(process.execPath, [rush, '--cwd', cwd], { encoding: 'utf8' })
88
+ assert.equal(out.status, 0)
89
+ assert.equal(out.stdout, `${message(activeRuns(cwd))}\n`)
90
+ assert.match(out.stdout, /rush-issues\/SKILL\.md/)
91
+ })