crysk 0.0.0 → 0.3.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/LICENSE +176 -0
  2. package/README.md +611 -3
  3. package/bin/pr-hero.js +166 -0
  4. package/config/models/anthropic.json +5 -0
  5. package/dist/SKILL-7e3725zn.md +496 -0
  6. package/dist/SKILL-7q35wcaz.md +66 -0
  7. package/dist/SKILL-9at22381.md +74 -0
  8. package/dist/SKILL-ex2hxxh3.md +134 -0
  9. package/dist/SKILL-y8rv8msh.md +134 -0
  10. package/dist/SKILL-ygka1bs0.md +515 -0
  11. package/dist/adjudicator-dtg2axnh.md +86 -0
  12. package/dist/admission-config.example-a9vqmmad.json +9 -0
  13. package/dist/ci-admission-camfbx2b.md +122 -0
  14. package/dist/ci-admission-qk9r9taq.md +124 -0
  15. package/dist/cli.js +42501 -0
  16. package/dist/consolidate-ac0mnfyj.md +24 -0
  17. package/dist/deep-review-lifecycle-m698ybjp.md +362 -0
  18. package/dist/deep-review-logic-a6b1gczf.md +156 -0
  19. package/dist/deep-review-parity-0ec904db.md +120 -0
  20. package/dist/deep-review-reliability-qyakbjb9.md +125 -0
  21. package/dist/deep-review-resilience-3tz8y26e.md +118 -0
  22. package/dist/index.js +20190 -0
  23. package/dist/opencode-ci-7b0be64p.md +141 -0
  24. package/dist/review-refuter-j4e9gezy.md +71 -0
  25. package/dist/scout-yvp153q7.md +140 -0
  26. package/dist/summarizer-zca44nxa.md +18 -0
  27. package/dist/workflow-w1g9szna.yml +151 -0
  28. package/package.json +81 -4
  29. package/prompts/consolidate.md +24 -0
  30. package/prompts/default/PROVENANCE.md +18 -0
  31. package/prompts/default/deep-review-lifecycle.md +362 -0
  32. package/prompts/default/deep-review-logic.md +156 -0
  33. package/prompts/default/deep-review-parity.md +120 -0
  34. package/prompts/default/deep-review-reliability.md +125 -0
  35. package/prompts/default/deep-review-resilience.md +118 -0
  36. package/prompts/default/review-refuter.md +71 -0
  37. package/prompts/scout.md +140 -0
  38. package/prompts/summarizer.md +18 -0
  39. package/skills/crysk/SKILL.md +74 -0
  40. package/skills/crysk-ci-setup/SKILL.md +134 -0
  41. package/skills/crysk-ci-setup/assets/admission-config.example.json +9 -0
  42. package/skills/crysk-ci-setup/assets/workflow.yml +151 -0
  43. package/skills/crysk-ci-setup/references/ci-admission.md +124 -0
  44. package/skills/crysk-ci-setup/references/opencode-ci.md +141 -0
  45. package/skills/crysk-loop/SKILL.md +515 -0
  46. package/skills/crysk-loop/adjudicator.md +86 -0
  47. package/skills/crysk-pr/SKILL.md +66 -0
  48. package/src/agent-env.ts +1084 -0
  49. package/src/asset-manifest.ts +83 -0
  50. package/src/assets.d.ts +6 -0
  51. package/src/assets.ts +183 -0
  52. package/src/brand-paths.ts +155 -0
  53. package/src/brand.ts +255 -0
  54. package/src/ci/admission-ledger.ts +350 -0
  55. package/src/ci/classify-error.ts +73 -0
  56. package/src/ci/cli-record.ts +271 -0
  57. package/src/ci/force-comment.ts +39 -0
  58. package/src/ci/gates.ts +945 -0
  59. package/src/ci/outcome.ts +2181 -0
  60. package/src/ci/override.ts +187 -0
  61. package/src/ci/publish.ts +1639 -0
  62. package/src/ci/reporter.ts +626 -0
  63. package/src/ci/review-admission.ts +910 -0
  64. package/src/ci/review-levels.ts +310 -0
  65. package/src/ci/review-policy.ts +18 -0
  66. package/src/ci/review-risk.ts +184 -0
  67. package/src/ci/setup.ts +844 -0
  68. package/src/ci/trigger.ts +1353 -0
  69. package/src/cli.ts +348 -0
  70. package/src/commands/activity.ts +67 -0
  71. package/src/commands/ci-setup-questions.ts +397 -0
  72. package/src/commands/ci-setup.ts +381 -0
  73. package/src/commands/config.ts +99 -0
  74. package/src/commands/doctor.ts +108 -0
  75. package/src/commands/init.ts +139 -0
  76. package/src/commands/mcp.ts +10 -0
  77. package/src/commands/menu.ts +129 -0
  78. package/src/commands/post.ts +302 -0
  79. package/src/commands/skills.ts +83 -0
  80. package/src/commands/status.ts +173 -0
  81. package/src/commands/triage.ts +342 -0
  82. package/src/commands/uninstall.ts +37 -0
  83. package/src/commands/upgrade.ts +214 -0
  84. package/src/commands/usage.ts +98 -0
  85. package/src/compare/compare.ts +28 -0
  86. package/src/compare/floor-test.ts +471 -0
  87. package/src/compare/martian-adapter.ts +80 -0
  88. package/src/config/config.ts +267 -0
  89. package/src/corpus/corpus.ts +1094 -0
  90. package/src/corpus/preflight.ts +1789 -0
  91. package/src/diversity/accounting.ts +90 -0
  92. package/src/diversity/adjudication.ts +145 -0
  93. package/src/diversity/admission.ts +60 -0
  94. package/src/diversity/benchmark.ts +195 -0
  95. package/src/diversity/clustering.ts +285 -0
  96. package/src/diversity/errors.ts +7 -0
  97. package/src/diversity/identity.ts +285 -0
  98. package/src/diversity/index.ts +11 -0
  99. package/src/diversity/pipeline-integration.ts +448 -0
  100. package/src/diversity/projection.ts +57 -0
  101. package/src/diversity/self-contained.ts +68 -0
  102. package/src/diversity/target-validation.ts +179 -0
  103. package/src/doctor-migration.ts +209 -0
  104. package/src/doctor.ts +723 -0
  105. package/src/errors.ts +83 -0
  106. package/src/execution/admission.ts +75 -0
  107. package/src/execution/atomic-write.ts +35 -0
  108. package/src/execution/attempt-evidence.ts +415 -0
  109. package/src/execution/bucket-id.ts +136 -0
  110. package/src/execution/concurrency-limiter.ts +175 -0
  111. package/src/execution/contracts.ts +443 -0
  112. package/src/execution/failure-classification.ts +42 -0
  113. package/src/execution/failure-policy.ts +240 -0
  114. package/src/execution/harness.ts +2548 -0
  115. package/src/execution/settlement.ts +348 -0
  116. package/src/execution/spawned-process.ts +66 -0
  117. package/src/execution/spend-limiter.ts +424 -0
  118. package/src/execution/step-artifacts.ts +55 -0
  119. package/src/execution/usage-normalized.ts +469 -0
  120. package/src/git/git.ts +396 -0
  121. package/src/git/identity.ts +64 -0
  122. package/src/git/refs.ts +140 -0
  123. package/src/home-preflight.ts +443 -0
  124. package/src/home.ts +243 -0
  125. package/src/ignore-file.ts +336 -0
  126. package/src/ignore-read.ts +118 -0
  127. package/src/index.ts +34 -0
  128. package/src/legacy-launchd.ts +29 -0
  129. package/src/mcp/mcp.ts +150 -0
  130. package/src/mcp/preflight.ts +407 -0
  131. package/src/menu-context.ts +192 -0
  132. package/src/model/catalog.ts +251 -0
  133. package/src/model/exec-snapshots.ts +390 -0
  134. package/src/model/free-discovery.ts +302 -0
  135. package/src/model/provider-capabilities.ts +814 -0
  136. package/src/model/routing.ts +600 -0
  137. package/src/pr/admission.ts +984 -0
  138. package/src/pr/answered-findings.ts +169 -0
  139. package/src/pr/ci-admission-gate.ts +743 -0
  140. package/src/pr/ci-publish.ts +76 -0
  141. package/src/pr/discovery.ts +432 -0
  142. package/src/pr/inline.ts +507 -0
  143. package/src/pr/plan.ts +366 -0
  144. package/src/pr/posting.ts +115 -0
  145. package/src/pr/pr-status.ts +845 -0
  146. package/src/pr/pr.ts +3642 -0
  147. package/src/pr/preflight.ts +1031 -0
  148. package/src/pr/publish-outcome.ts +361 -0
  149. package/src/pr/range.ts +119 -0
  150. package/src/pr/reverts-preflight.ts +606 -0
  151. package/src/pr/reverts.ts +377 -0
  152. package/src/pr/review-pr.ts +927 -0
  153. package/src/pr/status.ts +154 -0
  154. package/src/pr/target.ts +388 -0
  155. package/src/pr/teardown.ts +437 -0
  156. package/src/pr/worktree-setup.ts +60 -0
  157. package/src/production-runtime.ts +1877 -0
  158. package/src/progress.ts +487 -0
  159. package/src/rereview/adjudicate.ts +89 -0
  160. package/src/rereview/classify.ts +362 -0
  161. package/src/rereview/identity.ts +211 -0
  162. package/src/rereview/plan.ts +308 -0
  163. package/src/rereview/prepare.ts +1025 -0
  164. package/src/rereview/state.ts +767 -0
  165. package/src/rereview/verify.ts +241 -0
  166. package/src/review/boundary.ts +105 -0
  167. package/src/review/consolidate.ts +246 -0
  168. package/src/review/dedupe.ts +368 -0
  169. package/src/review/drafts.ts +448 -0
  170. package/src/review/findings-conformance.ts +120 -0
  171. package/src/review/findings.ts +714 -0
  172. package/src/review/pipeline.ts +3977 -0
  173. package/src/review/preflight.ts +3575 -0
  174. package/src/review/prompt-set.ts +177 -0
  175. package/src/review/proof-refs.ts +187 -0
  176. package/src/review/report.ts +1821 -0
  177. package/src/review/review.ts +490 -0
  178. package/src/review/root-cause.ts +120 -0
  179. package/src/review/route-preflight.ts +289 -0
  180. package/src/review/run.ts +601 -0
  181. package/src/review/scout.ts +323 -0
  182. package/src/review/size-gate.ts +595 -0
  183. package/src/review/spec.ts +235 -0
  184. package/src/review/step-runner.ts +233 -0
  185. package/src/runner-authority.ts +596 -0
  186. package/src/security/binding-policy.ts +115 -0
  187. package/src/security/credential-broker.ts +773 -0
  188. package/src/security/evidence-redaction.ts +62 -0
  189. package/src/security/execution-authority.ts +27 -0
  190. package/src/security/redact.ts +71 -0
  191. package/src/security/workspace-read-broker.ts +466 -0
  192. package/src/server/client.ts +190 -0
  193. package/src/server/preflight.ts +217 -0
  194. package/src/server/server.ts +327 -0
  195. package/src/signal-handler.ts +50 -0
  196. package/src/store/activity.ts +413 -0
  197. package/src/store/backfill-preflight.ts +49 -0
  198. package/src/store/backfill.ts +141 -0
  199. package/src/store/gc-preflight.ts +206 -0
  200. package/src/store/gc.ts +424 -0
  201. package/src/store/metrics-preflight.ts +229 -0
  202. package/src/store/metrics.ts +236 -0
  203. package/src/store/preflight.ts +748 -0
  204. package/src/store/store.ts +693 -0
  205. package/src/system-tools.ts +355 -0
  206. package/src/transport-registry.ts +1124 -0
  207. package/src/transports/claude-code-cli.ts +1348 -0
  208. package/src/transports/opencode-admission.ts +515 -0
  209. package/src/transports/opencode-client.ts +3328 -0
  210. package/src/transports/opencode-evidence.ts +557 -0
  211. package/src/transports/opencode-mcp.ts +248 -0
  212. package/src/transports/opencode-sdk.ts +2294 -0
  213. package/src/transports/opencode-server.ts +535 -0
  214. package/src/triage/adjudication.ts +113 -0
  215. package/src/triage/reply.ts +125 -0
  216. package/src/triage/triage.ts +255 -0
  217. package/src/ui/activity.ts +173 -0
  218. package/src/ui/config-edit.ts +816 -0
  219. package/src/ui/config.ts +462 -0
  220. package/src/ui/menu.ts +1325 -0
  221. package/src/ui/plan.ts +1039 -0
  222. package/src/ui/primitives.ts +300 -0
  223. package/src/ui/progress.ts +298 -0
  224. package/src/ui/result.ts +552 -0
  225. package/src/ui/review-menu.ts +312 -0
  226. package/src/ui/select.ts +528 -0
  227. package/src/ui/tree.ts +178 -0
  228. package/src/uninstaller.ts +479 -0
  229. package/src/updater.ts +836 -0
  230. package/src/usage.ts +77 -0
  231. package/src/watch/preflight.ts +1389 -0
  232. package/src/watch/watch.ts +1235 -0
  233. package/src/wizard.ts +877 -0
@@ -0,0 +1,748 @@
1
+ // Canonical product store (Fundamentals #6 / observability-canonical-store.md),
2
+ // pure half: Schema DDL, table types, and projection from a completed run's facts
3
+ // (FindingsDocument, per-agent usage, the PR's diff base) into the complete
4
+ // relational model.
5
+ //
6
+ // Pure and testable offline: never opens a connection, never touches the clock or fs.
7
+
8
+ import path from "node:path";
9
+ import type {
10
+ CausalDisposition,
11
+ EvidenceClass,
12
+ FindingsDocument,
13
+ HopTrail,
14
+ IndexMode,
15
+ RefuterVerdict,
16
+ RunStatus,
17
+ Severity,
18
+ Tier,
19
+ } from "#review/findings";
20
+ import type { PerAgentUsage } from "#review/pipeline";
21
+
22
+ export const CURRENT_PRODUCT_SCHEMA_VERSION = 5;
23
+
24
+ export const PRODUCT_V4_TO_V5_STATEMENTS: string[] = [
25
+ "ALTER TABLE runs ADD COLUMN diversity_plan_json TEXT NULL;",
26
+ `CREATE TABLE IF NOT EXISTS diversity_attempts (
27
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
28
+ run_id INTEGER NOT NULL REFERENCES runs (id) ON DELETE CASCADE,
29
+ attempt_id TEXT NOT NULL,
30
+ leg_id TEXT NOT NULL,
31
+ arm_id TEXT NOT NULL,
32
+ specialty TEXT NOT NULL,
33
+ replicate INTEGER NOT NULL,
34
+ attempt INTEGER NOT NULL,
35
+ status TEXT NOT NULL,
36
+ cash_cost_usd REAL NULL,
37
+ notional_cost_usd REAL NULL
38
+ );`,
39
+ `CREATE INDEX IF NOT EXISTS idx_diversity_attempts_run_id ON diversity_attempts (run_id);`,
40
+ `CREATE TABLE IF NOT EXISTS diversity_observations (
41
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
42
+ run_id INTEGER NOT NULL REFERENCES runs (id) ON DELETE CASCADE,
43
+ observation_id TEXT NOT NULL,
44
+ attempt_id TEXT NOT NULL,
45
+ leg_id TEXT NOT NULL,
46
+ arm_id TEXT NOT NULL,
47
+ specialty TEXT NOT NULL,
48
+ observation_json TEXT NOT NULL
49
+ );`,
50
+ `CREATE INDEX IF NOT EXISTS idx_diversity_observations_run_id ON diversity_observations (run_id);`,
51
+ ];
52
+
53
+ export const PRODUCT_V3_TO_V4_STATEMENTS: string[] = [
54
+ "ALTER TABLE runs ADD COLUMN findings_schema_version TEXT NOT NULL DEFAULT '1.0.0';",
55
+ "ALTER TABLE runs ADD COLUMN engine_revision TEXT NULL;",
56
+ ];
57
+
58
+ export interface ProductSchemaMigration {
59
+ toVersion: number;
60
+ statements: string[];
61
+ }
62
+
63
+ export const PRODUCT_V2_TO_V3_STATEMENTS: string[] = [
64
+ `CREATE TABLE IF NOT EXISTS finding_triage (
65
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
66
+ run_id INTEGER NOT NULL REFERENCES runs (id) ON DELETE CASCADE,
67
+ finding_id TEXT NOT NULL,
68
+ comment_id INTEGER NULL,
69
+ tag TEXT NOT NULL,
70
+ verdict TEXT NULL,
71
+ actor TEXT NOT NULL,
72
+ reasoning TEXT NOT NULL,
73
+ issue_number INTEGER NULL,
74
+ created_at TEXT NOT NULL
75
+ );`,
76
+ `CREATE INDEX IF NOT EXISTS idx_finding_triage_run_id ON finding_triage (run_id);`,
77
+ `CREATE INDEX IF NOT EXISTS idx_finding_triage_finding_id ON finding_triage (finding_id);`,
78
+ `CREATE UNIQUE INDEX IF NOT EXISTS idx_finding_triage_unique ON finding_triage (run_id, finding_id, ifnull(comment_id, 0));`,
79
+ ];
80
+
81
+ export const PRODUCT_V1_TO_V2_STATEMENTS: string[] = [
82
+ "ALTER TABLE finding_hop_trail ADD COLUMN is_raw_string INTEGER NOT NULL DEFAULT 0;",
83
+ `CREATE TABLE IF NOT EXISTS runs_new (
84
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
85
+ repo_id TEXT NOT NULL,
86
+ run_dir TEXT NOT NULL,
87
+ pr INTEGER NULL,
88
+ checkout_path TEXT NULL,
89
+ head_sha TEXT NOT NULL,
90
+ base_sha TEXT NOT NULL,
91
+ diff_from_sha TEXT NULL,
92
+ run_status TEXT NOT NULL,
93
+ session_failed INTEGER NULL,
94
+ model TEXT NOT NULL,
95
+ iteration INTEGER NOT NULL,
96
+ parity_hunter_fired INTEGER NOT NULL,
97
+ prompt_set_name TEXT NULL,
98
+ prompt_set_sha256 TEXT NULL,
99
+ driver_sha TEXT NULL,
100
+ engine_name TEXT NULL,
101
+ engine_version TEXT NULL,
102
+ summary_prose TEXT NULL,
103
+ summary_score INTEGER NULL,
104
+ summary_score_reason TEXT NULL,
105
+ generated_at TEXT NOT NULL,
106
+ wall_ms INTEGER NOT NULL,
107
+ index_ms INTEGER NOT NULL,
108
+ index_mode TEXT NULL,
109
+ index_disk_mb REAL NULL,
110
+ sync_ms INTEGER NULL,
111
+ tokens_in INTEGER NOT NULL,
112
+ tokens_out INTEGER NOT NULL,
113
+ tokens_total INTEGER NOT NULL,
114
+ cost_usd_est REAL NOT NULL,
115
+ blocking INTEGER NOT NULL,
116
+ advisory INTEGER NOT NULL,
117
+ root_causes_json TEXT NULL,
118
+ greptile_found INTEGER NULL,
119
+ UNIQUE (repo_id, run_dir)
120
+ );`,
121
+ `INSERT OR IGNORE INTO runs_new SELECT id, repo_id, run_dir, pr, checkout_path, head_sha, base_sha, diff_from_sha, run_status, session_failed, model, iteration, parity_hunter_fired, prompt_set_name, prompt_set_sha256, driver_sha, engine_name, engine_version, summary_prose, summary_score, summary_score_reason, generated_at, wall_ms, index_ms, index_mode, index_disk_mb, sync_ms, tokens_in, tokens_out, tokens_total, cost_usd_est, blocking, advisory, root_causes_json, greptile_found FROM runs;`,
122
+ `DROP TABLE runs;`,
123
+ `ALTER TABLE runs_new RENAME TO runs;`,
124
+ `CREATE INDEX IF NOT EXISTS idx_runs_repo_id ON runs (repo_id);`,
125
+ `CREATE INDEX IF NOT EXISTS idx_runs_generated_at ON runs (generated_at);`,
126
+ ];
127
+
128
+ export const PRODUCT_V1_STATEMENTS: string[] = [
129
+ `CREATE TABLE IF NOT EXISTS runs (
130
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
131
+ repo_id TEXT NOT NULL,
132
+ run_dir TEXT NOT NULL,
133
+ pr INTEGER NULL,
134
+ checkout_path TEXT NULL,
135
+ head_sha TEXT NOT NULL,
136
+ base_sha TEXT NOT NULL,
137
+ diff_from_sha TEXT NULL,
138
+ run_status TEXT NOT NULL,
139
+ session_failed INTEGER NULL,
140
+ model TEXT NOT NULL,
141
+ iteration INTEGER NOT NULL,
142
+ parity_hunter_fired INTEGER NOT NULL,
143
+ prompt_set_name TEXT NULL,
144
+ prompt_set_sha256 TEXT NULL,
145
+ driver_sha TEXT NULL,
146
+ engine_name TEXT NULL,
147
+ engine_version TEXT NULL,
148
+ engine_revision TEXT NULL,
149
+ findings_schema_version TEXT NOT NULL DEFAULT '1.0.0',
150
+ summary_prose TEXT NULL,
151
+ summary_score INTEGER NULL,
152
+ summary_score_reason TEXT NULL,
153
+ generated_at TEXT NOT NULL,
154
+ wall_ms INTEGER NOT NULL,
155
+ index_ms INTEGER NOT NULL,
156
+ index_mode TEXT NULL,
157
+ index_disk_mb REAL NULL,
158
+ sync_ms INTEGER NULL,
159
+ tokens_in INTEGER NOT NULL,
160
+ tokens_out INTEGER NOT NULL,
161
+ tokens_total INTEGER NOT NULL,
162
+ cost_usd_est REAL NOT NULL,
163
+ blocking INTEGER NOT NULL,
164
+ advisory INTEGER NOT NULL,
165
+ root_causes_json TEXT NULL,
166
+ greptile_found INTEGER NULL,
167
+ diversity_plan_json TEXT NULL,
168
+ UNIQUE (repo_id, run_dir)
169
+ )`,
170
+ `CREATE INDEX IF NOT EXISTS idx_runs_repo_id ON runs (repo_id)`,
171
+ `CREATE INDEX IF NOT EXISTS idx_runs_generated_at ON runs (generated_at)`,
172
+
173
+ `CREATE TABLE IF NOT EXISTS findings (
174
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
175
+ run_id INTEGER NOT NULL REFERENCES runs (id) ON DELETE CASCADE,
176
+ finding_id TEXT NOT NULL,
177
+ category INTEGER NOT NULL,
178
+ path TEXT NOT NULL,
179
+ line INTEGER NOT NULL,
180
+ symbol TEXT NULL,
181
+ severity TEXT NOT NULL,
182
+ evidence_class TEXT NOT NULL,
183
+ refuter_verdict TEXT NOT NULL,
184
+ causal_disposition TEXT NOT NULL,
185
+ claim TEXT NOT NULL,
186
+ hunter TEXT NOT NULL,
187
+ tier TEXT NOT NULL,
188
+ hops_used INTEGER NOT NULL,
189
+ dedupe_key TEXT NOT NULL,
190
+ root_cause_id TEXT NULL,
191
+ finding_order INTEGER NOT NULL,
192
+ UNIQUE (run_id, finding_id)
193
+ )`,
194
+ `CREATE INDEX IF NOT EXISTS idx_findings_run_id ON findings (run_id)`,
195
+ `CREATE INDEX IF NOT EXISTS idx_findings_path ON findings (path)`,
196
+ `CREATE INDEX IF NOT EXISTS idx_findings_tier ON findings (tier)`,
197
+
198
+ `CREATE TABLE IF NOT EXISTS finding_proof_refs (
199
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
200
+ finding_id INTEGER NOT NULL REFERENCES findings (id) ON DELETE CASCADE,
201
+ ref_order INTEGER NOT NULL,
202
+ proof_ref TEXT NOT NULL,
203
+ UNIQUE (finding_id, ref_order)
204
+ )`,
205
+ `CREATE INDEX IF NOT EXISTS idx_finding_proof_refs_fid ON finding_proof_refs (finding_id)`,
206
+
207
+ `CREATE TABLE IF NOT EXISTS finding_hop_trail (
208
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
209
+ finding_id INTEGER NOT NULL REFERENCES findings (id) ON DELETE CASCADE,
210
+ step_order INTEGER NOT NULL,
211
+ step_num INTEGER NOT NULL,
212
+ kind TEXT NOT NULL,
213
+ query TEXT NOT NULL,
214
+ reached TEXT NULL,
215
+ is_raw_string INTEGER NOT NULL DEFAULT 0,
216
+ UNIQUE (finding_id, step_order)
217
+ )`,
218
+ `CREATE INDEX IF NOT EXISTS idx_finding_hop_trail_fid ON finding_hop_trail (finding_id)`,
219
+
220
+ `CREATE TABLE IF NOT EXISTS debug_findings (
221
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
222
+ run_id INTEGER NOT NULL REFERENCES runs (id) ON DELETE CASCADE,
223
+ finding_id TEXT NOT NULL,
224
+ kind TEXT NOT NULL,
225
+ merged_into TEXT NULL,
226
+ category INTEGER NOT NULL,
227
+ path TEXT NOT NULL,
228
+ line INTEGER NOT NULL,
229
+ symbol TEXT NULL,
230
+ severity TEXT NOT NULL,
231
+ evidence_class TEXT NOT NULL,
232
+ refuter_verdict TEXT NOT NULL,
233
+ causal_disposition TEXT NOT NULL,
234
+ claim TEXT NOT NULL,
235
+ proof_refs_json TEXT NOT NULL,
236
+ hunter TEXT NOT NULL,
237
+ hops_used INTEGER NOT NULL,
238
+ hop_trail_json TEXT NOT NULL,
239
+ dedupe_key TEXT NOT NULL,
240
+ root_cause_id TEXT NULL,
241
+ debug_order INTEGER NOT NULL
242
+ )`,
243
+ `CREATE INDEX IF NOT EXISTS idx_debug_findings_run_id ON debug_findings (run_id)`,
244
+
245
+ `CREATE TABLE IF NOT EXISTS run_agents (
246
+ run_id INTEGER NOT NULL REFERENCES runs (id) ON DELETE CASCADE,
247
+ agent_key TEXT NOT NULL,
248
+ tokens_total INTEGER NOT NULL,
249
+ duration_ms INTEGER NOT NULL,
250
+ tokens_in INTEGER NOT NULL,
251
+ tokens_out INTEGER NOT NULL,
252
+ cost_usd_est REAL NOT NULL,
253
+ attempts INTEGER NOT NULL,
254
+ status TEXT NOT NULL,
255
+ PRIMARY KEY (run_id, agent_key)
256
+ )`,
257
+
258
+ `CREATE TABLE IF NOT EXISTS comparison_rows (
259
+ run_id INTEGER NOT NULL REFERENCES runs (id) ON DELETE CASCADE,
260
+ row_index INTEGER NOT NULL,
261
+ bucket TEXT NOT NULL,
262
+ greptile_json TEXT NULL,
263
+ prhero_json TEXT NULL,
264
+ verdict TEXT NULL,
265
+ reasoning TEXT NULL,
266
+ actor TEXT NULL,
267
+ PRIMARY KEY (run_id, row_index)
268
+ )`,
269
+
270
+ `CREATE TABLE IF NOT EXISTS finding_triage (
271
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
272
+ run_id INTEGER NOT NULL REFERENCES runs (id) ON DELETE CASCADE,
273
+ finding_id TEXT NOT NULL,
274
+ comment_id INTEGER NULL,
275
+ tag TEXT NOT NULL,
276
+ verdict TEXT NULL,
277
+ actor TEXT NOT NULL,
278
+ reasoning TEXT NOT NULL,
279
+ issue_number INTEGER NULL,
280
+ created_at TEXT NOT NULL
281
+ )`,
282
+ `CREATE INDEX IF NOT EXISTS idx_finding_triage_run_id ON finding_triage (run_id)`,
283
+ `CREATE INDEX IF NOT EXISTS idx_finding_triage_finding_id ON finding_triage (finding_id)`,
284
+ `CREATE UNIQUE INDEX IF NOT EXISTS idx_finding_triage_unique ON finding_triage (run_id, finding_id, ifnull(comment_id, 0))`,
285
+
286
+ `CREATE TABLE IF NOT EXISTS diversity_attempts (
287
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
288
+ run_id INTEGER NOT NULL REFERENCES runs (id) ON DELETE CASCADE,
289
+ attempt_id TEXT NOT NULL,
290
+ leg_id TEXT NOT NULL,
291
+ arm_id TEXT NOT NULL,
292
+ specialty TEXT NOT NULL,
293
+ replicate INTEGER NOT NULL,
294
+ attempt INTEGER NOT NULL,
295
+ status TEXT NOT NULL,
296
+ cash_cost_usd REAL NULL,
297
+ notional_cost_usd REAL NULL
298
+ )`,
299
+ `CREATE INDEX IF NOT EXISTS idx_diversity_attempts_run_id ON diversity_attempts (run_id)`,
300
+ `CREATE TABLE IF NOT EXISTS diversity_observations (
301
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
302
+ run_id INTEGER NOT NULL REFERENCES runs (id) ON DELETE CASCADE,
303
+ observation_id TEXT NOT NULL,
304
+ attempt_id TEXT NOT NULL,
305
+ leg_id TEXT NOT NULL,
306
+ arm_id TEXT NOT NULL,
307
+ specialty TEXT NOT NULL,
308
+ observation_json TEXT NOT NULL
309
+ )`,
310
+ `CREATE INDEX IF NOT EXISTS idx_diversity_observations_run_id ON diversity_observations (run_id)`,
311
+ ];
312
+
313
+ export function migrationsForProductStore(
314
+ currentVersion: number,
315
+ ): ProductSchemaMigration {
316
+ if (currentVersion >= CURRENT_PRODUCT_SCHEMA_VERSION) {
317
+ return { toVersion: currentVersion, statements: [] };
318
+ }
319
+ if (currentVersion === 0) {
320
+ return {
321
+ toVersion: CURRENT_PRODUCT_SCHEMA_VERSION,
322
+ statements: [...PRODUCT_V1_STATEMENTS],
323
+ };
324
+ }
325
+ if (currentVersion === 1) {
326
+ return {
327
+ toVersion: CURRENT_PRODUCT_SCHEMA_VERSION,
328
+ statements: [
329
+ ...PRODUCT_V1_TO_V2_STATEMENTS,
330
+ ...PRODUCT_V2_TO_V3_STATEMENTS,
331
+ ...PRODUCT_V3_TO_V4_STATEMENTS,
332
+ ...PRODUCT_V4_TO_V5_STATEMENTS,
333
+ ],
334
+ };
335
+ }
336
+ if (currentVersion === 2) {
337
+ return {
338
+ toVersion: CURRENT_PRODUCT_SCHEMA_VERSION,
339
+ statements: [
340
+ ...PRODUCT_V2_TO_V3_STATEMENTS,
341
+ ...PRODUCT_V3_TO_V4_STATEMENTS,
342
+ ...PRODUCT_V4_TO_V5_STATEMENTS,
343
+ ],
344
+ };
345
+ }
346
+ if (currentVersion === 3) {
347
+ return {
348
+ toVersion: CURRENT_PRODUCT_SCHEMA_VERSION,
349
+ statements: [
350
+ ...PRODUCT_V3_TO_V4_STATEMENTS,
351
+ ...PRODUCT_V4_TO_V5_STATEMENTS,
352
+ ],
353
+ };
354
+ }
355
+ if (currentVersion === 4) {
356
+ return {
357
+ toVersion: CURRENT_PRODUCT_SCHEMA_VERSION,
358
+ statements: [...PRODUCT_V4_TO_V5_STATEMENTS],
359
+ };
360
+ }
361
+ return {
362
+ toVersion: CURRENT_PRODUCT_SCHEMA_VERSION,
363
+ statements: [],
364
+ };
365
+ }
366
+
367
+ export interface CanonicalRunRow {
368
+ id?: number;
369
+ repo_id: string;
370
+ run_dir: string;
371
+ pr: number | null;
372
+ checkout_path: string | null;
373
+ head_sha: string;
374
+ base_sha: string;
375
+ diff_from_sha: string | null;
376
+ run_status: RunStatus;
377
+ session_failed: 0 | 1 | null;
378
+ model: string;
379
+ iteration: number;
380
+ parity_hunter_fired: 0 | 1;
381
+ prompt_set_name: string | null;
382
+ prompt_set_sha256: string | null;
383
+ driver_sha: string | null;
384
+ engine_name: string | null;
385
+ engine_version: string | null;
386
+ engine_revision: string | null;
387
+ findings_schema_version: string;
388
+ summary_prose: string | null;
389
+ summary_score: number | null;
390
+ summary_score_reason: string | null;
391
+ generated_at: string;
392
+ wall_ms: number;
393
+ index_ms: number;
394
+ index_mode: IndexMode | null;
395
+ index_disk_mb: number | null;
396
+ sync_ms: number | null;
397
+ tokens_in: number;
398
+ tokens_out: number;
399
+ tokens_total: number;
400
+ cost_usd_est: number;
401
+ blocking: number;
402
+ advisory: number;
403
+ root_causes_json: string | null;
404
+ greptile_found: 0 | 1 | null;
405
+ diversity_plan_json: string | null;
406
+ }
407
+
408
+ export interface CanonicalFindingRow {
409
+ id?: number;
410
+ run_id?: number;
411
+ finding_id: string;
412
+ category: number;
413
+ path: string;
414
+ line: number;
415
+ symbol: string | null;
416
+ severity: Severity;
417
+ evidence_class: EvidenceClass;
418
+ refuter_verdict: RefuterVerdict;
419
+ causal_disposition: CausalDisposition;
420
+ claim: string;
421
+ hunter: string;
422
+ tier: Tier;
423
+ hops_used: number;
424
+ dedupe_key: string;
425
+ root_cause_id: string | null;
426
+ finding_order: number;
427
+ }
428
+
429
+ export interface FindingProofRefRow {
430
+ id?: number;
431
+ finding_id?: number;
432
+ ref_order: number;
433
+ proof_ref: string;
434
+ }
435
+
436
+ export interface FindingHopTrailRow {
437
+ id?: number;
438
+ finding_id?: number;
439
+ step_order: number;
440
+ step_num: number;
441
+ kind: string;
442
+ query: string;
443
+ reached: string;
444
+ is_raw_string?: number;
445
+ }
446
+
447
+ export interface DebugFindingRow {
448
+ id?: number;
449
+ run_id?: number;
450
+ finding_id: string;
451
+ kind: "refuted" | "deduped";
452
+ merged_into: string | null;
453
+ category: number;
454
+ path: string;
455
+ line: number;
456
+ symbol: string | null;
457
+ severity: Severity;
458
+ evidence_class: EvidenceClass;
459
+ refuter_verdict: RefuterVerdict;
460
+ causal_disposition: CausalDisposition;
461
+ claim: string;
462
+ proof_refs_json: string;
463
+ hunter: string;
464
+ hops_used: number;
465
+ hop_trail_json: string;
466
+ dedupe_key: string;
467
+ root_cause_id: string | null;
468
+ debug_order: number;
469
+ }
470
+
471
+ export interface RunAgentRow {
472
+ agent_key: string;
473
+ tokens_total: number;
474
+ duration_ms: number;
475
+ tokens_in: number;
476
+ tokens_out: number;
477
+ cost_usd_est: number;
478
+ attempts: number;
479
+ status: string;
480
+ }
481
+
482
+ export interface FindingTriageRow {
483
+ id?: number;
484
+ run_id: number;
485
+ finding_id: string;
486
+ comment_id?: number | null;
487
+ tag: string;
488
+ verdict?: string | null;
489
+ actor: string;
490
+ reasoning: string;
491
+ issue_number?: number | null;
492
+ created_at: string;
493
+ }
494
+
495
+ export interface ProjectedFinding {
496
+ finding: CanonicalFindingRow;
497
+ proofRefs: string[];
498
+ hopTrail: HopTrail;
499
+ }
500
+
501
+ export interface DiversityAttemptRow {
502
+ attempt_id: string;
503
+ leg_id: string;
504
+ arm_id: string;
505
+ specialty: string;
506
+ replicate: number;
507
+ attempt: number;
508
+ status: string;
509
+ cash_cost_usd: number | null;
510
+ notional_cost_usd: number | null;
511
+ }
512
+
513
+ export interface DiversityObservationRow {
514
+ observation_id: string;
515
+ attempt_id: string;
516
+ leg_id: string;
517
+ arm_id: string;
518
+ specialty: string;
519
+ observation_json: string;
520
+ }
521
+
522
+ export interface ProjectedCompleteRun {
523
+ run: CanonicalRunRow;
524
+ findings: ProjectedFinding[];
525
+ debugFindings: DebugFindingRow[];
526
+ agents: RunAgentRow[];
527
+ diversityAttempts: DiversityAttemptRow[];
528
+ diversityObservations: DiversityObservationRow[];
529
+ }
530
+
531
+ export function projectCompleteRun(input: {
532
+ doc: FindingsDocument;
533
+ perAgent?: Record<string, PerAgentUsage>;
534
+ diffFromSha?: string | null;
535
+ repoId: string;
536
+ runDir: string;
537
+ checkoutPath: string | null;
538
+ generatedAt?: string;
539
+ }): ProjectedCompleteRun {
540
+ let blocking = 0;
541
+ let advisory = 0;
542
+ for (const finding of input.doc.findings) {
543
+ if (finding.tier === "blocking") blocking++;
544
+ else advisory++;
545
+ }
546
+
547
+ let session_failed: 0 | 1 | null = null;
548
+ if (input.doc.sessionFailed !== undefined) {
549
+ session_failed = input.doc.sessionFailed ? 1 : 0;
550
+ }
551
+
552
+ const run: CanonicalRunRow = {
553
+ repo_id: input.repoId,
554
+ run_dir: path.basename(input.runDir),
555
+ pr: input.doc.pr === 0 ? null : input.doc.pr,
556
+ checkout_path: input.checkoutPath,
557
+ head_sha: input.doc.head_sha,
558
+ base_sha: input.doc.base_sha,
559
+ diff_from_sha: input.diffFromSha ?? null,
560
+ run_status: input.doc.run_status,
561
+ session_failed,
562
+ model: input.doc.model,
563
+ iteration: input.doc.iteration,
564
+ parity_hunter_fired: input.doc.parity_hunter_fired ? 1 : 0,
565
+ prompt_set_name: input.doc.prompt_set?.name ?? null,
566
+ prompt_set_sha256: input.doc.prompt_set?.sha256 ?? null,
567
+ driver_sha: input.doc.driver_sha ?? null,
568
+ engine_name: input.doc.engine?.name ?? null,
569
+ engine_version: input.doc.engine?.version ?? null,
570
+ engine_revision: input.doc.engine?.revision ?? null,
571
+ findings_schema_version: input.doc.schema_version,
572
+ summary_prose: input.doc.summary?.prose ?? null,
573
+ summary_score: input.doc.summary?.score ?? null,
574
+ summary_score_reason: input.doc.summary?.score_reason ?? null,
575
+ generated_at: input.generatedAt ?? new Date().toISOString(),
576
+ wall_ms: input.doc.telemetry.wall_ms,
577
+ index_ms: input.doc.telemetry.index_ms,
578
+ index_mode: input.doc.telemetry.index_mode,
579
+ index_disk_mb: input.doc.telemetry.index_disk_mb,
580
+ sync_ms: input.doc.telemetry.sync_ms ?? null,
581
+ tokens_in: input.doc.telemetry.tokens_in,
582
+ tokens_out: input.doc.telemetry.tokens_out,
583
+ tokens_total: input.doc.telemetry.tokens_total,
584
+ cost_usd_est: input.doc.telemetry.cost_usd_est,
585
+ blocking,
586
+ advisory,
587
+ root_causes_json: input.doc.debug.root_causes
588
+ ? JSON.stringify(input.doc.debug.root_causes)
589
+ : null,
590
+ greptile_found: null,
591
+ diversity_plan_json: input.doc.debug.diversity
592
+ ? JSON.stringify(input.doc.debug.diversity)
593
+ : null,
594
+ };
595
+
596
+ const findings: ProjectedFinding[] = input.doc.findings.map((f, index) => ({
597
+ finding: {
598
+ finding_id: f.id,
599
+ category: f.category,
600
+ path: f.path,
601
+ line: f.line,
602
+ symbol: f.symbol ?? null,
603
+ severity: f.severity,
604
+ evidence_class: f.evidence_class,
605
+ refuter_verdict: f.refuter_verdict,
606
+ causal_disposition: f.causal_disposition,
607
+ claim: f.claim,
608
+ hunter: f.hunter,
609
+ tier: f.tier,
610
+ hops_used: f.hops_used,
611
+ dedupe_key: f.dedupe_key,
612
+ root_cause_id: f.root_cause_id ?? null,
613
+ finding_order: index,
614
+ },
615
+ proofRefs: f.proof_refs,
616
+ hopTrail: f.hop_trail,
617
+ }));
618
+
619
+ const debugFindings: DebugFindingRow[] = [];
620
+ let debugOrder = 0;
621
+
622
+ for (const f of input.doc.debug.refuted) {
623
+ debugFindings.push({
624
+ finding_id: f.id,
625
+ kind: "refuted",
626
+ merged_into: null,
627
+ category: f.category,
628
+ path: f.path,
629
+ line: f.line,
630
+ symbol: f.symbol ?? null,
631
+ severity: f.severity,
632
+ evidence_class: f.evidence_class,
633
+ refuter_verdict: "refuted",
634
+ causal_disposition: f.causal_disposition,
635
+ claim: f.claim,
636
+ proof_refs_json: JSON.stringify(f.proof_refs),
637
+ hunter: f.hunter,
638
+ hops_used: f.hops_used,
639
+ hop_trail_json: JSON.stringify(f.hop_trail),
640
+ dedupe_key: f.dedupe_key,
641
+ root_cause_id: f.root_cause_id ?? null,
642
+ debug_order: debugOrder++,
643
+ });
644
+ }
645
+
646
+ if (input.doc.debug.deduped) {
647
+ for (const f of input.doc.debug.deduped) {
648
+ debugFindings.push({
649
+ finding_id: f.id,
650
+ kind: "deduped",
651
+ merged_into: f.merged_into,
652
+ category: f.category,
653
+ path: f.path,
654
+ line: f.line,
655
+ symbol: f.symbol ?? null,
656
+ severity: f.severity,
657
+ evidence_class: f.evidence_class,
658
+ refuter_verdict: f.refuter_verdict,
659
+ causal_disposition: f.causal_disposition,
660
+ claim: f.claim,
661
+ proof_refs_json: JSON.stringify(f.proof_refs),
662
+ hunter: f.hunter,
663
+ hops_used: f.hops_used,
664
+ hop_trail_json: JSON.stringify(f.hop_trail),
665
+ dedupe_key: f.dedupe_key,
666
+ root_cause_id: f.root_cause_id ?? null,
667
+ debug_order: debugOrder++,
668
+ });
669
+ }
670
+ }
671
+
672
+ const agents: RunAgentRow[] = input.perAgent
673
+ ? Object.entries(input.perAgent).map(([agentKey, usage]) => ({
674
+ agent_key: agentKey,
675
+ tokens_total: usage.tokens_total,
676
+ duration_ms: usage.duration_ms,
677
+ tokens_in: usage.tokens_in,
678
+ tokens_out: usage.tokens_out,
679
+ cost_usd_est: usage.cost_usd_est,
680
+ attempts: usage.attempts,
681
+ status: usage.status,
682
+ }))
683
+ : Object.entries(input.doc.telemetry.per_agent ?? {}).map(
684
+ ([agentKey, usage]) => ({
685
+ agent_key: agentKey,
686
+ tokens_total: usage.tokens_total,
687
+ duration_ms: usage.duration_ms,
688
+ tokens_in: 0,
689
+ tokens_out: 0,
690
+ cost_usd_est: 0,
691
+ attempts: 1,
692
+ status: "ok",
693
+ }),
694
+ );
695
+
696
+ const diversityAttempts: DiversityAttemptRow[] = [];
697
+ const diversityObservations: DiversityObservationRow[] = [];
698
+ const diversityDebug = input.doc.debug.diversity;
699
+ if (diversityDebug && typeof diversityDebug === "object") {
700
+ const attempts = (diversityDebug as Record<string, unknown>).attempts;
701
+ if (Array.isArray(attempts)) {
702
+ for (const entry of attempts) {
703
+ if (typeof entry !== "object" || entry === null) continue;
704
+ const row = entry as Record<string, unknown>;
705
+ diversityAttempts.push({
706
+ attempt_id: String(row.attemptId ?? ""),
707
+ leg_id: String(row.legId ?? ""),
708
+ arm_id: String(row.armId ?? "diversity"),
709
+ specialty: String(row.specialty ?? "unknown"),
710
+ replicate: Number(row.replicate ?? 1),
711
+ attempt: Number(row.attempt ?? 1),
712
+ status: String(row.status ?? "completed"),
713
+ cash_cost_usd:
714
+ typeof row.cashCostUsd === "number" ? row.cashCostUsd : null,
715
+ notional_cost_usd:
716
+ typeof row.notionalCostUsd === "number"
717
+ ? row.notionalCostUsd
718
+ : null,
719
+ });
720
+ }
721
+ }
722
+ const observations = (diversityDebug as Record<string, unknown>)
723
+ .observations;
724
+ if (Array.isArray(observations)) {
725
+ for (const entry of observations) {
726
+ if (typeof entry !== "object" || entry === null) continue;
727
+ const row = entry as Record<string, unknown>;
728
+ diversityObservations.push({
729
+ observation_id: String(row.observationId ?? ""),
730
+ attempt_id: String(row.attemptId ?? ""),
731
+ leg_id: String(row.legId ?? ""),
732
+ arm_id: String(row.armId ?? "diversity"),
733
+ specialty: String(row.specialty ?? "unknown"),
734
+ observation_json: JSON.stringify(row),
735
+ });
736
+ }
737
+ }
738
+ }
739
+
740
+ return {
741
+ run,
742
+ findings,
743
+ debugFindings,
744
+ agents,
745
+ diversityAttempts,
746
+ diversityObservations,
747
+ };
748
+ }