rungate 0.2.0 → 0.3.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 (282) hide show
  1. package/bin/rungate.ts +70 -0
  2. package/lib/aes-calculator.ts +66 -0
  3. package/lib/agent-audit.ts +139 -0
  4. package/lib/agent-brief-validation.ts +359 -0
  5. package/lib/agents-md-refs.ts +90 -0
  6. package/lib/bash-file-read.ts +197 -0
  7. package/lib/behavioral-cache.ts +78 -0
  8. package/lib/branch-cleanup.ts +234 -0
  9. package/lib/brief-context-parser.ts +35 -0
  10. package/lib/canary.ts +117 -0
  11. package/lib/check-registry.ts +226 -0
  12. package/lib/ci-checkout.ts +400 -0
  13. package/lib/cli-commands.ts +137 -0
  14. package/lib/compliance-backfill.ts +220 -0
  15. package/lib/compliance-report.ts +504 -0
  16. package/lib/compliance.ts +361 -0
  17. package/lib/config-loader.ts +255 -0
  18. package/lib/conformity.ts +1818 -131
  19. package/lib/container-provenance.ts +230 -0
  20. package/lib/create-brief.ts +150 -0
  21. package/lib/create-sc.ts +272 -0
  22. package/lib/deep-merge.ts +69 -0
  23. package/lib/dev-liveness.ts +214 -0
  24. package/lib/directive-extractor.ts +210 -0
  25. package/lib/distribution-standing.ts +113 -0
  26. package/lib/doc-hygiene.ts +238 -0
  27. package/lib/eval-criteria.ts +6 -0
  28. package/lib/evidence-portability.ts +123 -0
  29. package/lib/evidence-prevalidator.ts +390 -0
  30. package/lib/evidence-required.ts +150 -0
  31. package/lib/evidence-satisfiability.ts +288 -0
  32. package/lib/frontmatter.ts +163 -0
  33. package/lib/gap-scanner.ts +348 -0
  34. package/lib/gate-enforcement.ts +366 -0
  35. package/lib/generators/agent-briefs.ts +136 -0
  36. package/lib/generators/agents-md.ts +506 -0
  37. package/lib/generators/code-map.ts +60 -0
  38. package/lib/generators/types.ts +184 -0
  39. package/lib/git-ref-normalizer.ts +107 -0
  40. package/lib/github.ts +539 -0
  41. package/lib/harness-identity.ts +63 -0
  42. package/lib/hill-climb.ts +164 -0
  43. package/lib/instruction-effectiveness.ts +131 -0
  44. package/lib/issue-closure-audit.ts +225 -0
  45. package/lib/issue-create-override.ts +343 -0
  46. package/lib/js-top-level-code.ts +250 -0
  47. package/lib/liveness-contradiction.ts +149 -0
  48. package/lib/organize.ts +505 -0
  49. package/lib/paths.ts +197 -6
  50. package/lib/post-fix-verify.ts +157 -0
  51. package/lib/prior-branch.ts +489 -0
  52. package/lib/project-state-shape.ts +166 -0
  53. package/lib/promote-outputs.ts +156 -0
  54. package/lib/prove-label-gate.ts +35 -0
  55. package/lib/reachability.ts +302 -0
  56. package/lib/release-preflight.ts +186 -0
  57. package/lib/rule-health-pipeline.ts +264 -0
  58. package/lib/rule-health-trend.ts +161 -0
  59. package/lib/rule-provenance.ts +149 -0
  60. package/lib/rule-registry.ts +128 -0
  61. package/lib/rungate-schema.ts +114 -4
  62. package/lib/sc-claim-forms.ts +179 -0
  63. package/lib/sc-cover.ts +150 -0
  64. package/lib/sc-guard.ts +157 -0
  65. package/lib/sc-ids.ts +344 -0
  66. package/lib/scaffold/defaults.ts +165 -0
  67. package/lib/scaffold/managed-workflow.ts +370 -0
  68. package/lib/scaffold/owned-files.ts +265 -0
  69. package/lib/scaffold/steps.ts +2680 -0
  70. package/lib/scanner.ts +701 -0
  71. package/lib/screenshot-upload.ts +73 -0
  72. package/lib/secret-patterns.ts +112 -0
  73. package/lib/security-verdict.ts +616 -0
  74. package/lib/signal-phrases.ts +1 -0
  75. package/lib/spec-change-conformity.ts +80 -0
  76. package/lib/spec-files.ts +62 -0
  77. package/lib/spec-registry.ts +133 -0
  78. package/lib/spec-updater.ts +96 -0
  79. package/lib/stale-cleanup.ts +224 -0
  80. package/lib/stale-issue-scanner.ts +36 -0
  81. package/lib/strip-js-comments.ts +269 -0
  82. package/lib/suite-measurement.ts +228 -0
  83. package/lib/task-completion-checks.ts +177 -0
  84. package/lib/test-suite-lock.ts +1136 -0
  85. package/lib/transcript-checker.ts +1140 -0
  86. package/lib/validators/spec-validators.ts +171 -0
  87. package/lib/verdict-capture.ts +73 -0
  88. package/lib/verified-push.ts +358 -0
  89. package/lib/workflow-security.ts +174 -0
  90. package/lib/worktree-cleanup.ts +250 -0
  91. package/lib/worktree-collect.ts +283 -0
  92. package/lib/worktree-isolation.ts +82 -0
  93. package/package.json +36 -3
  94. package/prompts/ac-adversary.md +14 -2
  95. package/prompts/aditi.md +5 -0
  96. package/prompts/blast-radius.md +5 -0
  97. package/prompts/container-verify.md +5 -0
  98. package/prompts/discovery.md +4 -0
  99. package/prompts/environment.md +5 -0
  100. package/prompts/evidence-hierarchy.md +5 -0
  101. package/prompts/evidence-validator.md +11 -0
  102. package/prompts/marcus.md +5 -0
  103. package/prompts/prevention.md +5 -0
  104. package/prompts/prove-reproducer.md +12 -0
  105. package/prompts/quinn-decision-tree.md +5 -0
  106. package/prompts/quinn-ui-brief.md +5 -0
  107. package/prompts/quinn.md +5 -0
  108. package/prompts/rca.md +5 -0
  109. package/prompts/read-before-write.md +4 -0
  110. package/prompts/regression.md +5 -0
  111. package/prompts/serena.md +5 -0
  112. package/scripts/audit-specs.ts +464 -0
  113. package/scripts/convert-spec.ts +293 -0
  114. package/scripts/create-sc.ts +92 -0
  115. package/scripts/create-spec.ts +166 -0
  116. package/scripts/extract-constraints.ts +4 -3
  117. package/scripts/generate-code-map.ts +1 -1
  118. package/scripts/scaffold-project.ts +138 -1426
  119. package/scripts/sync-spec-tests.ts +211 -126
  120. package/.claude/agents/aditi.md +0 -47
  121. package/.claude/agents/marcus.md +0 -50
  122. package/.claude/agents/quinn.md +0 -58
  123. package/.claude/agents/rook.md +0 -47
  124. package/.claude/agents/serena.md +0 -46
  125. package/.claude/rungate.json +0 -11
  126. package/.fallowrc.json +0 -28
  127. package/.github/copilot-instructions.md +0 -20
  128. package/.rungate/conformity-findings.json +0 -648
  129. package/AGENTS.md +0 -106
  130. package/CODE-MAP.md +0 -50
  131. package/HARNESS.md +0 -88
  132. package/bun.lock +0 -26
  133. package/bunfig.toml +0 -2
  134. package/config/brief-policies.json +0 -28
  135. package/config/ceremony-profiles.json +0 -212
  136. package/config/consumer-cascade-map.json +0 -24
  137. package/config/doc-cascade-map.json +0 -24
  138. package/config/eval.json +0 -84
  139. package/config/profiles/account-plan.yaml +0 -36
  140. package/config/profiles/campaign.yaml +0 -94
  141. package/config/prove-evidence.schema.json +0 -65
  142. package/config/spec-policies.json +0 -36
  143. package/config/workflow-schema.json +0 -281
  144. package/gates/SCHEMA-GUIDE.md +0 -121
  145. package/gates/ac-quality.test.ts +0 -106
  146. package/gates/adversarial.test.ts +0 -274
  147. package/gates/brief-assembler.test.ts +0 -429
  148. package/gates/brief-assembler.ts +0 -334
  149. package/gates/bunfig.toml +0 -2
  150. package/gates/chain.test.ts +0 -91
  151. package/gates/e2e-smoke.test.ts +0 -234
  152. package/gates/error-classifier.test.ts +0 -249
  153. package/gates/error-classifier.ts +0 -89
  154. package/gates/orchestrator.test.ts +0 -950
  155. package/gates/orchestrator.ts +0 -569
  156. package/gates/preload.ts +0 -77
  157. package/gates/prompts/ac-adversary.md +0 -20
  158. package/gates/prompts/evidence-validator.md +0 -22
  159. package/gates/prompts/prove-reproducer.md +0 -53
  160. package/gates/prove.test.ts +0 -164
  161. package/gates/run-gate.ts +0 -936
  162. package/gates/schema-parity.test.ts +0 -197
  163. package/gates/schema.ts +0 -362
  164. package/gates/self-heal.test.ts +0 -511
  165. package/gates/self-heal.ts +0 -121
  166. package/gates/ship-orchestrator.test.ts +0 -379
  167. package/gates/ship-orchestrator.ts +0 -363
  168. package/gates/test-fixtures/broken-no-environments.json +0 -60
  169. package/gates/test-fixtures/valid-standard.json +0 -54
  170. package/gates/test-utils.ts +0 -43
  171. package/gates/witness.ts +0 -220
  172. package/gates/workflow.test.ts +0 -1053
  173. package/hooks/AgentBriefGuard.hook.ts +0 -586
  174. package/hooks/AgentVerdictCapture.hook.ts +0 -134
  175. package/hooks/AutoVerifyGate.hook.ts +0 -76
  176. package/hooks/GateEnforcement.hook.ts +0 -273
  177. package/hooks/IssueCloseGuard.hook.ts +0 -116
  178. package/hooks/MergeGuard.hook.ts +0 -55
  179. package/hooks/StaleTTLCleanup.hook.ts +0 -133
  180. package/hooks/VerifyPhaseLock.hook.ts +0 -81
  181. package/hooks/WorkflowStateGuard.hook.ts +0 -37
  182. package/hooks/lib/agentDetection.ts +0 -70
  183. package/hooks/lib/findWorkflow.ts +0 -101
  184. package/hooks/lib/parseStdin.ts +0 -37
  185. package/hooks/lib/paths.ts +0 -111
  186. package/hooks/lib/utils.ts +0 -81
  187. package/reference/migration-manifest.json +0 -554
  188. package/reference/prompts/agent-aditi.md +0 -38
  189. package/reference/prompts/agent-marcus.md +0 -38
  190. package/reference/prompts/agent-quinn.md +0 -38
  191. package/reference/prompts/agent-rook.md +0 -37
  192. package/reference/prompts/agent-serena.md +0 -37
  193. package/reference/prompts/council-skill.md +0 -170
  194. package/reference/prompts/goal-skill.md +0 -235
  195. package/reference/prompts/prove-skill.md +0 -283
  196. package/reference/prompts/quinn-standard.md +0 -246
  197. package/reference/prompts/ship-convergence.md +0 -65
  198. package/reference/prompts/ship-escalation.md +0 -43
  199. package/reference/prompts/ship-iteration.md +0 -382
  200. package/reference/prompts/ship-pending-patches.md +0 -246
  201. package/reference/prompts/ship-reference.md +0 -250
  202. package/reference/prompts/ship-skill.md +0 -347
  203. package/reference/prompts/ship-templates.md +0 -215
  204. package/reference/scripts/batch-status.sh +0 -68
  205. package/reference/scripts/chain-compat-check.sh +0 -67
  206. package/reference/scripts/context-audit.sh +0 -314
  207. package/reference/scripts/dead-export-check.sh +0 -61
  208. package/reference/scripts/generate-qc-tables.sh +0 -92
  209. package/reference/scripts/harness-init.sh +0 -111
  210. package/reference/scripts/pai-054-baseline-check.sh +0 -40
  211. package/reference/scripts/prove-smoke-test.sh +0 -112
  212. package/reference/scripts/setup-keychain-salt.sh +0 -12
  213. package/reference/scripts/skill-optimizer-friday.sh +0 -88
  214. package/reference/scripts/skill-qc-test.sh +0 -351
  215. package/reference/scripts/skill-synthesize-tonight.sh +0 -66
  216. package/reference/specs/HARNESS-EXTRACTION-SPEC.md +0 -263
  217. package/reference/specs/harness-v3-bash-deletion-plan.md +0 -65
  218. package/reference/specs/harness-v3-migration-plan.md +0 -188
  219. package/scripts/decision-reconcile.sh +0 -74
  220. package/scripts/decision-reconcile.ts +0 -152
  221. package/scripts/git-hooks/pre-commit +0 -76
  222. package/scripts/git-hooks/pre-push +0 -271
  223. package/scripts/harness-skill-check.sh +0 -52
  224. package/scripts/lib/gap-emit.sh +0 -65
  225. package/scripts/lib/jq-update.sh +0 -30
  226. package/scripts/lib/resolve-slug.sh +0 -30
  227. package/scripts/lib/verify-spec-compliance.sh +0 -102
  228. package/scripts/prove-backfill.sh +0 -87
  229. package/scripts/scaffold-rungate-config.ts +0 -91
  230. package/scripts/self-containment-check.sh +0 -109
  231. package/scripts/skill-qc-validator.sh +0 -402
  232. package/scripts/slug-resolver.sh +0 -14
  233. package/specs/BOOTSTRAP-DATA-FLOW-SPEC.md +0 -2493
  234. package/specs/BOOTSTRAP-TEST-PLAN.md +0 -571
  235. package/specs/HARNESS-GATES.md +0 -256
  236. package/specs/HARNESS-SKILL-CHAIN.md +0 -286
  237. package/specs/HARNESS-SKILL-CONTRACT.md +0 -93
  238. package/specs/HARNESS-STANDARD.md +0 -488
  239. package/specs/SPEC-TEMPLATE.md +0 -53
  240. package/specs/bootstrap-data-flow.png +0 -0
  241. package/specs/harness-automation-matrix.md +0 -314
  242. package/specs/harness-automation-matrix.rules.json +0 -64
  243. package/test/anti.test.ts +0 -80
  244. package/test/contract-negative.test.ts +0 -86
  245. package/test/contract.test.ts +0 -158
  246. package/test/external-deps.test.ts +0 -48
  247. package/test/fixtures/golden-project/.env.example +0 -3
  248. package/test/fixtures/golden-project/Makefile +0 -7
  249. package/test/fixtures/golden-project/docs/adr/ADR-001-framework.md +0 -23
  250. package/test/fixtures/golden-project/docs/setup-guide.md +0 -10
  251. package/test/fixtures/golden-project/package.json +0 -10
  252. package/test/fixtures/golden-project/specs/api-spec.md +0 -20
  253. package/test/fixtures/golden-project/src/auth.ts +0 -8
  254. package/test/fixtures/golden-project/src/db.ts +0 -11
  255. package/test/fixtures/golden-project/src/index.ts +0 -19
  256. package/test/fixtures/golden-project/src/utils/format.ts +0 -3
  257. package/test/fixtures/golden-project/test/auth.test.ts +0 -15
  258. package/test/fixtures/golden-project/tsconfig.json +0 -12
  259. package/test/meta-sc-coverage.test.ts +0 -159
  260. package/test/phase-0.test.ts +0 -846
  261. package/test/phase-1.test.ts +0 -617
  262. package/test/phase-2.test.ts +0 -620
  263. package/test/phase-3.test.ts +0 -99
  264. package/test/scaffold-conformity.test.ts +0 -8
  265. package/test/schema-canary.test.ts +0 -51
  266. package/test/spec-compliance-auto.test.ts +0 -64
  267. package/test/spec-compliance.test.ts +0 -295
  268. package/test/spec-discovery.test.ts +0 -68
  269. package/test/spec-drift.test.ts +0 -5
  270. package/test/structure.test.ts +0 -165
  271. package/test/unit/agent-brief-guard-ship.test.ts +0 -293
  272. package/test/unit/extract-constraints.test.ts +0 -145
  273. package/test/unit/issue-close-guard.test.ts +0 -204
  274. package/test/unit/scaffold-project.test.ts +0 -417
  275. package/test/unit/skill-cooccurrence.test.ts +0 -177
  276. package/test/unit/skill-sequence-logger.test.ts +0 -244
  277. package/test/unit/workflow-state-guard.test.ts +0 -95
  278. package/workflows/batch-ship.js +0 -295
  279. package/workflows/council.js +0 -481
  280. package/workflows/prove.js +0 -560
  281. package/workflows/ship.js +0 -789
  282. package/workflows/verify.js +0 -236
@@ -1,236 +0,0 @@
1
- export const meta = {
2
- name: 'verify',
3
- description: 'Parallel verification gate: mechanical checks + evidence + Quinn + Rook',
4
- whenToUse: 'After any code change to verify correctness before merge. Called by ship workflow or standalone.',
5
- phases: [
6
- { title: 'Mechanical', detail: 'TypeScript, tests, container freshness, API smoke test' },
7
- { title: 'Evidence', detail: 'Collect evidence for each acceptance criterion' },
8
- { title: 'Agents', detail: 'Quinn UI validation + Rook security review in parallel' },
9
- ],
10
- }
11
-
12
- const VERIFY_RESULT_SCHEMA = {
13
- type: 'object',
14
- properties: {
15
- verdict: { type: 'string', enum: ['PASS', 'FAIL', 'SKIP'] },
16
- findings: { type: 'array', items: { type: 'string' } },
17
- reason: { type: 'string' },
18
- },
19
- required: ['verdict', 'reason'],
20
- }
21
-
22
- const EVIDENCE_SCHEMA = {
23
- type: 'object',
24
- properties: {
25
- acId: { type: 'string' },
26
- collected: { type: 'boolean' },
27
- evidenceType: { type: 'string' },
28
- detail: { type: 'string' },
29
- },
30
- required: ['acId', 'collected', 'detail'],
31
- }
32
-
33
- let parsedArgs = args || {}
34
- if (typeof parsedArgs === 'string') {
35
- try { parsedArgs = JSON.parse(parsedArgs) } catch { parsedArgs = {} }
36
- }
37
-
38
- if (!parsedArgs || !parsedArgs.projectRoot) {
39
- return {
40
- status: 'ARGS_ERROR',
41
- message: 'Missing required args. Usage: Workflow({ name: "verify", args: { projectRoot: "/path", changedFiles: ["src/foo.ts"], acceptanceCriteria: [...], size: "S", environment: "test" } })',
42
- received: args,
43
- }
44
- }
45
-
46
- const PROJECT_ROOT = parsedArgs.projectRoot
47
- const ACS = parsedArgs.acceptanceCriteria || []
48
- const CHANGED_FILES = parsedArgs.changedFiles || []
49
- const DECLARED_SCOPE = parsedArgs.declaredScope || []
50
- const ENV = parsedArgs.environment || 'test'
51
- const PORT = ENV === 'prod' ? '7777' : '7776'
52
- const SIZE = parsedArgs.size || 'S'
53
-
54
- // ════════════════════════════════════════════════════════════
55
- // PHASE 0: FILE-SCOPE VALIDATION (fail-fast gate)
56
- // ════════════════════════════════════════════════════════════
57
-
58
- if (DECLARED_SCOPE.length > 0 && CHANGED_FILES.length > 0) {
59
- const outOfScope = CHANGED_FILES.filter(f => !DECLARED_SCOPE.some(s => f.includes(s)))
60
- if (outOfScope.length > 0) {
61
- log(`SCOPE VIOLATION: ${outOfScope.length} file(s) modified outside declared scope`)
62
- return {
63
- status: 'FAIL',
64
- phase: 'scope-validation',
65
- message: `File-scope violation: ${outOfScope.length} file(s) modified outside declared scope. Update the issue's "Files to modify" section to include these files, then re-run verification.`,
66
- outOfScopeFiles: outOfScope,
67
- declaredScope: DECLARED_SCOPE,
68
- }
69
- }
70
- log(`Scope check passed: ${CHANGED_FILES.length} file(s) all within declared scope`)
71
- }
72
-
73
- // ════════════════════════════════════════════════════════════
74
- // PHASE 1: MECHANICAL CHECKS (all parallel)
75
- // ════════════════════════════════════════════════════════════
76
-
77
- phase('Mechanical')
78
- log('Running mechanical verification: tsc + tests + container + smoke')
79
-
80
- const mechanical = await parallel([
81
- () => agent(`
82
- Run TypeScript type checking on the project:
83
- cd ${PROJECT_ROOT} && npx tsc --noEmit 2>&1 | tail -20
84
- Report PASS if no errors, FAIL with the error output if errors found.
85
- `, { label: 'tsc', phase: 'Mechanical', model: 'haiku', schema: VERIFY_RESULT_SCHEMA }),
86
-
87
- () => agent(`
88
- Run the unit test suite:
89
- cd ${PROJECT_ROOT} && bun test --isolate test/unit/ 2>&1 | tail -30
90
- Report PASS with test count if all pass, FAIL with failing test names.
91
- `, { label: 'unit-tests', phase: 'Mechanical', model: 'haiku', schema: VERIFY_RESULT_SCHEMA }),
92
-
93
- () => agent(`
94
- Verify the running container has current code:
95
- 1. podman ps | grep pai-dashboard (check if running)
96
- 2. podman inspect pai-dashboard --format '{{.Created}}' (check container age)
97
- 3. For changed files, verify they exist in container:
98
- ${CHANGED_FILES.slice(0, 5).map(f => ` podman exec pai-dashboard test -f /app/${f} && echo "OK: ${f}" || echo "MISSING: ${f}"`).join('\n')}
99
- Report PASS if current, FAIL if stale or files missing.
100
- `, { label: 'container', phase: 'Mechanical', model: 'haiku', schema: VERIFY_RESULT_SCHEMA }),
101
-
102
- () => agent(`
103
- Smoke test critical API endpoints:
104
- 1. curl -s -w "\\n%{http_code}" http://localhost:${PORT}/api/aes | tail -1
105
- 2. curl -s -w "\\n%{http_code}" http://localhost:${PORT}/api/action-triggers | tail -1
106
- Report PASS if all return HTTP 200, FAIL if any return 404/500/empty.
107
- `, { label: 'smoke-test', phase: 'Mechanical', model: 'haiku', schema: VERIFY_RESULT_SCHEMA }),
108
- ])
109
-
110
- const [tsc, tests, container, smoke] = mechanical
111
-
112
- log(`tsc: ${tsc?.verdict} | tests: ${tests?.verdict} | container: ${container?.verdict} | smoke: ${smoke?.verdict}`)
113
-
114
- const mechanicalFailed = mechanical.filter(Boolean).some(r => r.verdict === 'FAIL')
115
- if (mechanicalFailed) {
116
- log('MECHANICAL CHECKS FAILED — stopping before agent verification')
117
- return {
118
- status: 'MECHANICAL_FAILED',
119
- tsc: tsc,
120
- tests: tests,
121
- container: container,
122
- smoke: smoke,
123
- message: 'Fix mechanical failures before running Quinn/Rook.',
124
- }
125
- }
126
-
127
- // ════════════════════════════════════════════════════════════
128
- // PHASE 2: EVIDENCE COLLECTION (pipeline over ACs)
129
- // ════════════════════════════════════════════════════════════
130
-
131
- phase('Evidence')
132
-
133
- let evidence = []
134
- if (ACS.length > 0) {
135
- log(`Collecting evidence for ${ACS.length} acceptance criteria`)
136
- evidence = await pipeline(
137
- ACS,
138
- ac => agent(`
139
- Collect evidence for acceptance criterion: ${ac.id} — ${ac.description}
140
- Evidence type required: ${ac.evidenceType}
141
-
142
- Instructions by evidence type:
143
- - code: Read the specific file and line, confirm the expected code exists
144
- - grep: Run grep for the expected pattern, report match count
145
- - screenshot: Take a Playwright screenshot of the relevant UI
146
- - api: curl the relevant endpoint and show the response
147
- - test: Run the specific test and confirm it passes
148
-
149
- Project root: ${PROJECT_ROOT}
150
- Port: ${PORT}
151
-
152
- Return whether evidence was successfully collected and the detail.
153
- `, { label: `evidence:${ac.id}`, phase: 'Evidence', model: 'haiku', schema: EVIDENCE_SCHEMA })
154
- )
155
- log(`Evidence collected for ${evidence.filter(Boolean).filter(e => e.collected).length}/${ACS.length} ACs`)
156
- }
157
-
158
- // ════════════════════════════════════════════════════════════
159
- // PHASE 3: AGENT VERIFICATION (Quinn + Rook parallel)
160
- // ════════════════════════════════════════════════════════════
161
-
162
- phase('Agents')
163
-
164
- const hasUIChanges = CHANGED_FILES.some(f => f.endsWith('.tsx') || f.endsWith('.svelte') || f.endsWith('.jsx'))
165
- const needsRook = ['M', 'L'].includes(SIZE)
166
-
167
- log(`Agent verification: Quinn=${hasUIChanges ? 'YES' : 'SKIP'} Rook=${needsRook ? 'YES' : 'SKIP'}`)
168
-
169
- const agentResults = await parallel([
170
- () => hasUIChanges
171
- ? agent(`
172
- ## QA Verification
173
- Environment: port ${PORT}, Playwright project ${ENV === 'prod' ? '--project=ci' : '--project=test'}
174
-
175
- Test as a BRAND NEW USER who has never seen this dashboard:
176
- - Every section understandable within 30 seconds?
177
- - Headings in plain language? No dev jargon?
178
- - Helpful empty states? (not just blank)
179
- - All interactive elements functional? (click each one)
180
- - Labels consistent? ("Save Changes" everywhere, not mixed)
181
-
182
- Changed files: ${CHANGED_FILES.filter(f => f.endsWith('.tsx') || f.endsWith('.svelte')).join(', ')}
183
-
184
- Acceptance criteria:
185
- ${ACS.map(ac => `- ${ac.id}: ${ac.description}`).join('\n')}
186
-
187
- Report PASS or FAIL per AC with evidence (screenshots, Playwright output).
188
- `, { label: 'quinn', phase: 'Agents', agentType: 'QATester', schema: VERIFY_RESULT_SCHEMA })
189
- : Promise.resolve({ verdict: 'SKIP', reason: 'No UI files in changed set', findings: [] }),
190
-
191
- () => needsRook
192
- ? agent(`
193
- ## Security Review
194
- Read ${PROJECT_ROOT}/ARCHITECTURE.md first.
195
-
196
- Files changed:
197
- ${CHANGED_FILES.map(f => `- ${f}`).join('\n')}
198
-
199
- Scope constraints:
200
- - Read-only on production config — NEVER write to .env, credentials, aes.json
201
- - Active probing on port ${PORT} only
202
- - Do not trigger bootstrap, wipe, or reset flows
203
-
204
- Check for: injection vulnerabilities, credential exposure, path traversal, XSS, missing input validation.
205
- Also scan pattern siblings (similar files in same directory).
206
-
207
- Report: PASS (safe to commit) or BLOCK (must fix first) with findings per file.
208
- `, { label: 'rook', phase: 'Agents', agentType: 'Pentester', schema: VERIFY_RESULT_SCHEMA })
209
- : Promise.resolve({ verdict: 'SKIP', reason: 'Size does not require security review', findings: [] }),
210
- ])
211
-
212
- const [quinn, rook] = agentResults
213
-
214
- log(`Quinn: ${quinn?.verdict} | Rook: ${rook?.verdict}`)
215
-
216
- const allPassed = ![tsc, tests, container, smoke, quinn, rook]
217
- .filter(Boolean)
218
- .some(r => r.verdict === 'FAIL')
219
-
220
- // #27 — Log verify results to signals for learning loop feedback
221
- const verifyResult = {
222
- status: allPassed ? 'ALL_PASSED' : 'SOME_FAILED',
223
- mechanical: { tsc: tsc?.verdict, tests: tests?.verdict, container: container?.verdict, smoke: smoke?.verdict },
224
- agents: { quinn: quinn?.verdict, rook: rook?.verdict },
225
- allPassed: allPassed,
226
- acCount: ACS.length,
227
- acPassed: evidence.filter(Boolean).filter(e => e.collected).length,
228
- }
229
-
230
- return {
231
- status: allPassed ? 'ALL_PASSED' : 'SOME_FAILED',
232
- mechanical: { tsc: tsc, tests: tests, container: container, smoke: smoke },
233
- evidence: evidence.filter(Boolean),
234
- agents: { quinn: quinn, rook: rook },
235
- allPassed: allPassed,
236
- }