rungate 0.2.0 → 0.2.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 (164) hide show
  1. package/package.json +14 -3
  2. package/.claude/agents/aditi.md +0 -47
  3. package/.claude/agents/marcus.md +0 -50
  4. package/.claude/agents/quinn.md +0 -58
  5. package/.claude/agents/rook.md +0 -47
  6. package/.claude/agents/serena.md +0 -46
  7. package/.claude/rungate.json +0 -11
  8. package/.fallowrc.json +0 -28
  9. package/.github/copilot-instructions.md +0 -20
  10. package/.rungate/conformity-findings.json +0 -648
  11. package/AGENTS.md +0 -106
  12. package/CODE-MAP.md +0 -50
  13. package/HARNESS.md +0 -88
  14. package/bun.lock +0 -26
  15. package/bunfig.toml +0 -2
  16. package/config/brief-policies.json +0 -28
  17. package/config/ceremony-profiles.json +0 -212
  18. package/config/consumer-cascade-map.json +0 -24
  19. package/config/doc-cascade-map.json +0 -24
  20. package/config/eval.json +0 -84
  21. package/config/profiles/account-plan.yaml +0 -36
  22. package/config/profiles/campaign.yaml +0 -94
  23. package/config/prove-evidence.schema.json +0 -65
  24. package/config/spec-policies.json +0 -36
  25. package/config/workflow-schema.json +0 -281
  26. package/gates/SCHEMA-GUIDE.md +0 -121
  27. package/gates/ac-quality.test.ts +0 -106
  28. package/gates/adversarial.test.ts +0 -274
  29. package/gates/brief-assembler.test.ts +0 -429
  30. package/gates/brief-assembler.ts +0 -334
  31. package/gates/bunfig.toml +0 -2
  32. package/gates/chain.test.ts +0 -91
  33. package/gates/e2e-smoke.test.ts +0 -234
  34. package/gates/error-classifier.test.ts +0 -249
  35. package/gates/error-classifier.ts +0 -89
  36. package/gates/orchestrator.test.ts +0 -950
  37. package/gates/orchestrator.ts +0 -569
  38. package/gates/preload.ts +0 -77
  39. package/gates/prompts/ac-adversary.md +0 -20
  40. package/gates/prompts/evidence-validator.md +0 -22
  41. package/gates/prompts/prove-reproducer.md +0 -53
  42. package/gates/prove.test.ts +0 -164
  43. package/gates/run-gate.ts +0 -936
  44. package/gates/schema-parity.test.ts +0 -197
  45. package/gates/schema.ts +0 -362
  46. package/gates/self-heal.test.ts +0 -511
  47. package/gates/self-heal.ts +0 -121
  48. package/gates/ship-orchestrator.test.ts +0 -379
  49. package/gates/ship-orchestrator.ts +0 -363
  50. package/gates/test-fixtures/broken-no-environments.json +0 -60
  51. package/gates/test-fixtures/valid-standard.json +0 -54
  52. package/gates/test-utils.ts +0 -43
  53. package/gates/witness.ts +0 -220
  54. package/gates/workflow.test.ts +0 -1053
  55. package/hooks/AgentBriefGuard.hook.ts +0 -586
  56. package/hooks/AgentVerdictCapture.hook.ts +0 -134
  57. package/hooks/AutoVerifyGate.hook.ts +0 -76
  58. package/hooks/GateEnforcement.hook.ts +0 -273
  59. package/hooks/IssueCloseGuard.hook.ts +0 -116
  60. package/hooks/MergeGuard.hook.ts +0 -55
  61. package/hooks/StaleTTLCleanup.hook.ts +0 -133
  62. package/hooks/VerifyPhaseLock.hook.ts +0 -81
  63. package/hooks/WorkflowStateGuard.hook.ts +0 -37
  64. package/hooks/lib/agentDetection.ts +0 -70
  65. package/hooks/lib/findWorkflow.ts +0 -101
  66. package/hooks/lib/parseStdin.ts +0 -37
  67. package/hooks/lib/paths.ts +0 -111
  68. package/hooks/lib/utils.ts +0 -81
  69. package/reference/migration-manifest.json +0 -554
  70. package/reference/prompts/agent-aditi.md +0 -38
  71. package/reference/prompts/agent-marcus.md +0 -38
  72. package/reference/prompts/agent-quinn.md +0 -38
  73. package/reference/prompts/agent-rook.md +0 -37
  74. package/reference/prompts/agent-serena.md +0 -37
  75. package/reference/prompts/council-skill.md +0 -170
  76. package/reference/prompts/goal-skill.md +0 -235
  77. package/reference/prompts/prove-skill.md +0 -283
  78. package/reference/prompts/quinn-standard.md +0 -246
  79. package/reference/prompts/ship-convergence.md +0 -65
  80. package/reference/prompts/ship-escalation.md +0 -43
  81. package/reference/prompts/ship-iteration.md +0 -382
  82. package/reference/prompts/ship-pending-patches.md +0 -246
  83. package/reference/prompts/ship-reference.md +0 -250
  84. package/reference/prompts/ship-skill.md +0 -347
  85. package/reference/prompts/ship-templates.md +0 -215
  86. package/reference/scripts/batch-status.sh +0 -68
  87. package/reference/scripts/chain-compat-check.sh +0 -67
  88. package/reference/scripts/context-audit.sh +0 -314
  89. package/reference/scripts/dead-export-check.sh +0 -61
  90. package/reference/scripts/generate-qc-tables.sh +0 -92
  91. package/reference/scripts/harness-init.sh +0 -111
  92. package/reference/scripts/pai-054-baseline-check.sh +0 -40
  93. package/reference/scripts/prove-smoke-test.sh +0 -112
  94. package/reference/scripts/setup-keychain-salt.sh +0 -12
  95. package/reference/scripts/skill-optimizer-friday.sh +0 -88
  96. package/reference/scripts/skill-qc-test.sh +0 -351
  97. package/reference/scripts/skill-synthesize-tonight.sh +0 -66
  98. package/reference/specs/HARNESS-EXTRACTION-SPEC.md +0 -263
  99. package/reference/specs/harness-v3-bash-deletion-plan.md +0 -65
  100. package/reference/specs/harness-v3-migration-plan.md +0 -188
  101. package/scripts/decision-reconcile.sh +0 -74
  102. package/scripts/decision-reconcile.ts +0 -152
  103. package/scripts/git-hooks/pre-commit +0 -76
  104. package/scripts/git-hooks/pre-push +0 -271
  105. package/scripts/harness-skill-check.sh +0 -52
  106. package/scripts/lib/gap-emit.sh +0 -65
  107. package/scripts/lib/jq-update.sh +0 -30
  108. package/scripts/lib/resolve-slug.sh +0 -30
  109. package/scripts/lib/verify-spec-compliance.sh +0 -102
  110. package/scripts/prove-backfill.sh +0 -87
  111. package/scripts/scaffold-rungate-config.ts +0 -91
  112. package/scripts/self-containment-check.sh +0 -109
  113. package/scripts/skill-qc-validator.sh +0 -402
  114. package/scripts/slug-resolver.sh +0 -14
  115. package/specs/BOOTSTRAP-DATA-FLOW-SPEC.md +0 -2493
  116. package/specs/BOOTSTRAP-TEST-PLAN.md +0 -571
  117. package/specs/HARNESS-GATES.md +0 -256
  118. package/specs/HARNESS-SKILL-CHAIN.md +0 -286
  119. package/specs/HARNESS-SKILL-CONTRACT.md +0 -93
  120. package/specs/HARNESS-STANDARD.md +0 -488
  121. package/specs/SPEC-TEMPLATE.md +0 -53
  122. package/specs/bootstrap-data-flow.png +0 -0
  123. package/specs/harness-automation-matrix.md +0 -314
  124. package/specs/harness-automation-matrix.rules.json +0 -64
  125. package/test/anti.test.ts +0 -80
  126. package/test/contract-negative.test.ts +0 -86
  127. package/test/contract.test.ts +0 -158
  128. package/test/external-deps.test.ts +0 -48
  129. package/test/fixtures/golden-project/.env.example +0 -3
  130. package/test/fixtures/golden-project/Makefile +0 -7
  131. package/test/fixtures/golden-project/docs/adr/ADR-001-framework.md +0 -23
  132. package/test/fixtures/golden-project/docs/setup-guide.md +0 -10
  133. package/test/fixtures/golden-project/package.json +0 -10
  134. package/test/fixtures/golden-project/specs/api-spec.md +0 -20
  135. package/test/fixtures/golden-project/src/auth.ts +0 -8
  136. package/test/fixtures/golden-project/src/db.ts +0 -11
  137. package/test/fixtures/golden-project/src/index.ts +0 -19
  138. package/test/fixtures/golden-project/src/utils/format.ts +0 -3
  139. package/test/fixtures/golden-project/test/auth.test.ts +0 -15
  140. package/test/fixtures/golden-project/tsconfig.json +0 -12
  141. package/test/meta-sc-coverage.test.ts +0 -159
  142. package/test/phase-0.test.ts +0 -846
  143. package/test/phase-1.test.ts +0 -617
  144. package/test/phase-2.test.ts +0 -620
  145. package/test/phase-3.test.ts +0 -99
  146. package/test/scaffold-conformity.test.ts +0 -8
  147. package/test/schema-canary.test.ts +0 -51
  148. package/test/spec-compliance-auto.test.ts +0 -64
  149. package/test/spec-compliance.test.ts +0 -295
  150. package/test/spec-discovery.test.ts +0 -68
  151. package/test/spec-drift.test.ts +0 -5
  152. package/test/structure.test.ts +0 -165
  153. package/test/unit/agent-brief-guard-ship.test.ts +0 -293
  154. package/test/unit/extract-constraints.test.ts +0 -145
  155. package/test/unit/issue-close-guard.test.ts +0 -204
  156. package/test/unit/scaffold-project.test.ts +0 -417
  157. package/test/unit/skill-cooccurrence.test.ts +0 -177
  158. package/test/unit/skill-sequence-logger.test.ts +0 -244
  159. package/test/unit/workflow-state-guard.test.ts +0 -95
  160. package/workflows/batch-ship.js +0 -295
  161. package/workflows/council.js +0 -481
  162. package/workflows/prove.js +0 -560
  163. package/workflows/ship.js +0 -789
  164. package/workflows/verify.js +0 -236
@@ -1,295 +0,0 @@
1
- export const meta = {
2
- name: 'batch-ship',
3
- description: 'Parallel issue processing with file-overlap detection and wave-based dispatch',
4
- whenToUse: 'Ship 2+ GitHub issues in parallel. Detects file overlaps, dispatches in waves, creates PRs.',
5
- phases: [
6
- { title: 'Intake', detail: 'Read and size each issue, detect file overlaps' },
7
- { title: 'Plan', detail: 'Group into waves — parallel if independent, sequential if overlapping' },
8
- { title: 'Dispatch', detail: 'Wave-based parallel execution (max 4 concurrent)' },
9
- { title: 'Verify', detail: 'Per-issue Quinn verification for UI changes' },
10
- { title: 'Report', detail: 'Summarize results, create PRs for successes' },
11
- ],
12
- }
13
-
14
- const SIZING_SCHEMA = {
15
- type: 'object',
16
- properties: {
17
- issueNumber: { type: 'number' },
18
- size: { type: 'string', enum: ['XS', 'S', 'M', 'L'] },
19
- filesToModify: { type: 'array', items: { type: 'string' } },
20
- acceptanceCriteria: {
21
- type: 'array',
22
- items: {
23
- type: 'object',
24
- properties: {
25
- id: { type: 'string' },
26
- description: { type: 'string' },
27
- evidenceType: { type: 'string' },
28
- },
29
- required: ['id', 'description'],
30
- },
31
- },
32
- hasUIChanges: { type: 'boolean' },
33
- briefSummary: { type: 'string' },
34
- },
35
- required: ['issueNumber', 'size', 'filesToModify', 'acceptanceCriteria', 'hasUIChanges'],
36
- }
37
-
38
- const BUILD_RESULT_SCHEMA = {
39
- type: 'object',
40
- properties: {
41
- issueNumber: { type: 'number' },
42
- success: { type: 'boolean' },
43
- filesChanged: { type: 'array', items: { type: 'string' } },
44
- commitSha: { type: 'string' },
45
- branch: { type: 'string' },
46
- evidence: { type: 'array', items: { type: 'string' } },
47
- testOutput: { type: 'string' },
48
- error: { type: 'string' },
49
- },
50
- required: ['issueNumber', 'success'],
51
- }
52
-
53
- let parsedArgs = args || {}
54
- if (typeof parsedArgs === 'string') {
55
- try { parsedArgs = JSON.parse(parsedArgs) } catch { parsedArgs = {} }
56
- }
57
-
58
- if (!parsedArgs || !parsedArgs.projectRoot || !parsedArgs.issues) {
59
- return {
60
- status: 'ARGS_ERROR',
61
- message: 'Missing required args. Usage: Workflow({ name: "batch-ship", args: { projectRoot: "/path", issues: [{number: 1, title: "...", body: "..."}], environment: "test" } })',
62
- received: args,
63
- }
64
- }
65
-
66
- const PROJECT_ROOT = parsedArgs.projectRoot
67
- const ISSUES = parsedArgs.issues || []
68
- const ENV = parsedArgs.environment || 'test'
69
- const MAX_CONCURRENT = 4
70
-
71
- // ════════════════════════════════════════════════════════════
72
- // PHASE 1: INTAKE — Size each issue and detect overlaps
73
- // ════════════════════════════════════════════════════════════
74
-
75
- phase('Intake')
76
- log(`Batch intake: ${ISSUES.length} issues`)
77
-
78
- const sizings = await pipeline(
79
- ISSUES,
80
- (issue) => agent(`
81
- Read GitHub issue #${issue.number}: "${issue.title}"
82
- ${issue.body}
83
-
84
- Project root: ${PROJECT_ROOT}
85
- Read ${PROJECT_ROOT}/ARCHITECTURE.md for module context.
86
-
87
- Size this issue:
88
- - XS: single file, obvious fix, <30 min
89
- - S: 1-2 files, clear target, <2 hours
90
- - M: 3+ files, crosses boundaries — FLAG for separate handling
91
- - L: too large for batch — FLAG for separate handling
92
-
93
- List the SPECIFIC files that will need modification.
94
- Will any .tsx/.svelte/.jsx files change? (hasUIChanges)
95
- Write acceptance criteria (AC-1, AC-2...).
96
- `, {
97
- label: `intake:${issue.number}`,
98
- phase: 'Intake',
99
- schema: SIZING_SCHEMA,
100
- })
101
- )
102
-
103
- const validSizings = sizings.filter(Boolean)
104
- const batchable = validSizings.filter(s => ['XS', 'S'].includes(s.size))
105
- const tooLarge = validSizings.filter(s => ['M', 'L'].includes(s.size))
106
-
107
- if (tooLarge.length > 0) {
108
- log(`${tooLarge.length} issues too large for batch: ${tooLarge.map(s => `#${s.issueNumber} (${s.size})`).join(', ')}`)
109
- }
110
-
111
- log(`${batchable.length} issues eligible for batch processing`)
112
-
113
- // ════════════════════════════════════════════════════════════
114
- // PHASE 2: PLAN — Detect overlaps, group into waves
115
- // ════════════════════════════════════════════════════════════
116
-
117
- phase('Plan')
118
-
119
- // Detect file overlaps between issues
120
- const fileToIssues = {}
121
- for (const sizing of batchable) {
122
- for (const file of sizing.filesToModify) {
123
- if (!fileToIssues[file]) fileToIssues[file] = []
124
- fileToIssues[file].push(sizing.issueNumber)
125
- }
126
- }
127
-
128
- const overlaps = Object.entries(fileToIssues)
129
- .filter(([, issues]) => issues.length > 1)
130
- .map(([file, issues]) => ({ file, issues }))
131
-
132
- if (overlaps.length > 0) {
133
- log(`File overlaps detected: ${overlaps.map(o => `${o.file} (issues ${o.issues.join(',')})`).join('; ')}`)
134
- }
135
-
136
- // Group into waves: overlapping issues go in separate waves
137
- const waves = []
138
- const assigned = new Set()
139
-
140
- for (const sizing of batchable) {
141
- if (assigned.has(sizing.issueNumber)) continue
142
-
143
- // Find a wave where this issue has no file overlap
144
- let placed = false
145
- for (const wave of waves) {
146
- const waveFiles = new Set(wave.flatMap(s => s.filesToModify))
147
- const hasOverlap = sizing.filesToModify.some(f => waveFiles.has(f))
148
- if (!hasOverlap && wave.length < MAX_CONCURRENT) {
149
- wave.push(sizing)
150
- assigned.add(sizing.issueNumber)
151
- placed = true
152
- break
153
- }
154
- }
155
-
156
- if (!placed) {
157
- waves.push([sizing])
158
- assigned.add(sizing.issueNumber)
159
- }
160
- }
161
-
162
- log(`Planned ${waves.length} waves: ${waves.map((w, i) => `wave ${i + 1}: ${w.length} issues`).join(', ')}`)
163
-
164
- // ════════════════════════════════════════════════════════════
165
- // PHASE 3: DISPATCH — Wave-based parallel execution
166
- // ════════════════════════════════════════════════════════════
167
-
168
- phase('Dispatch')
169
-
170
- const allResults = []
171
-
172
- for (let waveIdx = 0; waveIdx < waves.length; waveIdx++) {
173
- const wave = waves[waveIdx]
174
- log(`Wave ${waveIdx + 1}/${waves.length}: dispatching ${wave.length} agents`)
175
-
176
- const waveResults = await parallel(
177
- wave.map(sizing => () => agent(`
178
- ## Context (read in order)
179
- 1. ${PROJECT_ROOT}/CLAUDE.md (if exists)
180
- 2. ${PROJECT_ROOT}/PRINCIPLES.md (if exists)
181
- 3. ${PROJECT_ROOT}/ARCHITECTURE.md (if exists)
182
-
183
- ## Task — Issue #${sizing.issueNumber}
184
- ${sizing.briefSummary}
185
-
186
- ## Acceptance Criteria
187
- ${sizing.acceptanceCriteria.map(ac => `- ${ac.id}: ${ac.description}`).join('\n')}
188
-
189
- ## Files — modify ONLY these
190
- ${sizing.filesToModify.map(f => `- ${f}`).join('\n')}
191
-
192
- ## Git protocol
193
- - Branch: ${sizing.issueNumber}-batch-fix
194
- - git fetch origin && git rebase origin/main before committing
195
- - Commit ALL changes before reporting
196
- - Push with -u before reporting
197
- - Never commit to main
198
-
199
- ## Development
200
- - Write regression test FIRST (red), then implement (green)
201
- - Run tsc --noEmit after changes
202
- - Run bun test --isolate test/unit/
203
-
204
- ## Report
205
- - issueNumber, success (boolean), filesChanged, commitSha, branch
206
- - Evidence for each AC
207
- `, {
208
- label: `build:${sizing.issueNumber}`,
209
- phase: 'Dispatch',
210
- agentType: 'Engineer',
211
- ...((PROJECT_ROOT.includes('/.claude/') || PROJECT_ROOT.includes('/rungate/')) && !PROJECT_ROOT.includes('/Projects/') ? { isolation: 'worktree' } : {}),
212
- schema: BUILD_RESULT_SCHEMA,
213
- }))
214
- )
215
-
216
- allResults.push(...waveResults.map((r, i) => r || { issueNumber: wave[i].issueNumber, success: false, error: 'Agent returned null' }))
217
- log(`Wave ${waveIdx + 1} complete: ${waveResults.filter(r => r && r.success).length}/${wave.length} succeeded`)
218
- }
219
-
220
- const succeeded = allResults.filter(r => r.success)
221
- const failed = allResults.filter(r => !r.success)
222
-
223
- log(`Build complete: ${succeeded.length} succeeded, ${failed.length} failed`)
224
-
225
- // ════════════════════════════════════════════════════════════
226
- // PHASE 4: VERIFY — Quinn for UI changes
227
- // ════════════════════════════════════════════════════════════
228
-
229
- phase('Verify')
230
-
231
- const uiIssues = succeeded.filter(r => {
232
- const sizing = batchable.find(s => s.issueNumber === r.issueNumber)
233
- return sizing && sizing.hasUIChanges
234
- })
235
-
236
- let quinnResults = []
237
- if (uiIssues.length > 0) {
238
- log(`Running Quinn verification for ${uiIssues.length} UI-changing issues`)
239
- quinnResults = await parallel(
240
- uiIssues.map(result => () => agent(`
241
- ## QA Verification
242
- Port: ${ENV === 'prod' ? '7777' : '7776'}
243
- Playwright project: ${ENV === 'prod' ? '--project=ci' : '--project=test'}
244
-
245
- Test changes from issue #${result.issueNumber}.
246
- Files changed: ${(result.filesChanged || []).join(', ')}
247
-
248
- Test as brand new user. Report PASS or FAIL with evidence.
249
- `, {
250
- label: `quinn:${result.issueNumber}`,
251
- phase: 'Verify',
252
- agentType: 'QATester',
253
- schema: {
254
- type: 'object',
255
- properties: {
256
- issueNumber: { type: 'number' },
257
- verdict: { type: 'string', enum: ['PASS', 'FAIL'] },
258
- findings: { type: 'array', items: { type: 'string' } },
259
- },
260
- required: ['verdict'],
261
- },
262
- }))
263
- )
264
- } else {
265
- log('No UI changes — skipping Quinn')
266
- }
267
-
268
- // ════════════════════════════════════════════════════════════
269
- // PHASE 5: REPORT
270
- // ════════════════════════════════════════════════════════════
271
-
272
- phase('Report')
273
-
274
- log(`Final report: ${succeeded.length} shipped, ${failed.length} failed, ${tooLarge.length} deferred`)
275
-
276
- return {
277
- totalIssues: ISSUES.length,
278
- batchProcessed: batchable.length,
279
- deferredToShip: tooLarge.map(s => ({ number: s.issueNumber, size: s.size })),
280
- waves: waves.length,
281
- results: {
282
- succeeded: succeeded.map(r => ({
283
- issue: r.issueNumber,
284
- branch: r.branch,
285
- commit: r.commitSha,
286
- filesChanged: r.filesChanged,
287
- })),
288
- failed: failed.map(r => ({
289
- issue: r.issueNumber,
290
- error: r.error || 'Unknown failure',
291
- })),
292
- },
293
- quinn: quinnResults.filter(Boolean),
294
- overlapsDetected: overlaps,
295
- }