crysk 0.6.1 → 0.7.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 (73) hide show
  1. package/README.md +3 -1
  2. package/dist/SKILL-32cmme3j.md +143 -0
  3. package/dist/adjudicator-eckqh14e.md +78 -0
  4. package/dist/ci-admission-qn797a6c.md +128 -0
  5. package/dist/cli.js +119 -38
  6. package/dist/consolidate-4xw1pkg7.md +24 -0
  7. package/dist/deep-review-logic-dgr112y1.md +196 -0
  8. package/dist/deep-review-logic-fck5z4xe.md +197 -0
  9. package/dist/deep-review-logic-h1fpamfh.md +192 -0
  10. package/dist/deep-review-logic-m4vk5683.md +196 -0
  11. package/dist/deep-review-logic-z63kmgmc.md +157 -0
  12. package/dist/deep-review-parity-7x7s5d81.md +148 -0
  13. package/dist/deep-review-parity-9wxmynsc.md +115 -0
  14. package/dist/deep-review-parity-bwwe7cx6.md +152 -0
  15. package/dist/deep-review-parity-e50pw3pk.md +117 -0
  16. package/dist/deep-review-parity-ennmm9m1.md +151 -0
  17. package/dist/deep-review-parity-h7y6y2he.md +118 -0
  18. package/dist/deep-review-parity-xg6wy69c.md +151 -0
  19. package/dist/deep-review-reliability-6h3c4gmw.md +125 -0
  20. package/dist/deep-review-reliability-dcjab69x.md +122 -0
  21. package/dist/deep-review-reliability-ec7b5pbk.md +159 -0
  22. package/dist/deep-review-reliability-hvasvmt9.md +153 -0
  23. package/dist/deep-review-reliability-mjnayxmt.md +158 -0
  24. package/dist/deep-review-reliability-mm7fnayf.md +124 -0
  25. package/dist/deep-review-reliability-xk4xvc2w.md +158 -0
  26. package/dist/deep-review-resilience-0esd5qeh.md +148 -0
  27. package/dist/deep-review-resilience-envgcmpy.md +115 -0
  28. package/dist/deep-review-resilience-fgx8ythf.md +151 -0
  29. package/dist/deep-review-resilience-mq5qa6ad.md +152 -0
  30. package/dist/deep-review-resilience-pwh1gawp.md +151 -0
  31. package/dist/deep-review-resilience-s9n21dkx.md +117 -0
  32. package/dist/deep-review-resilience-vz4qskea.md +119 -0
  33. package/dist/deep-review-security-1vwjdc9q.md +205 -0
  34. package/dist/deep-review-security-x1cc1z00.md +205 -0
  35. package/dist/index.js +105 -29
  36. package/dist/opencode-ci-jc8mf4wn.md +106 -0
  37. package/dist/review-refuter-7qffwtzz.md +77 -0
  38. package/dist/verifier-tyh8r45v.md +40 -0
  39. package/dist/verifier-xf4xj701.md +40 -0
  40. package/package.json +1 -1
  41. package/prompts/consolidate.md +1 -1
  42. package/prompts/default/PROVENANCE.md +5 -0
  43. package/prompts/default/deep-review-logic.md +56 -15
  44. package/prompts/default/deep-review-parity.md +71 -39
  45. package/prompts/default/deep-review-reliability.md +64 -30
  46. package/prompts/default/deep-review-resilience.md +71 -37
  47. package/prompts/default/deep-review-security.md +205 -0
  48. package/prompts/default/review-refuter.md +1 -1
  49. package/prompts/verifier.md +40 -0
  50. package/skills/crysk-ci-setup/SKILL.md +3 -3
  51. package/skills/crysk-ci-setup/references/ci-admission.md +1 -1
  52. package/skills/crysk-ci-setup/references/opencode-ci.md +1 -1
  53. package/skills/crysk-loop/adjudicator.md +10 -18
  54. package/src/asset-manifest.ts +6 -0
  55. package/src/assets.ts +4 -1
  56. package/src/ci/gates.ts +11 -2
  57. package/src/ci/review-levels.ts +4 -4
  58. package/src/commands/ci-setup-questions.ts +1 -1
  59. package/src/compare/hunter-exam.ts +631 -0
  60. package/src/index.ts +1 -1
  61. package/src/model/model-name.ts +2 -1
  62. package/src/model/profiles.ts +1 -1
  63. package/src/pr/pr.ts +1 -1
  64. package/src/pr/preflight.ts +29 -3
  65. package/src/pr/review-pr.ts +5 -0
  66. package/src/rereview/verify.ts +15 -9
  67. package/src/review/boundary.ts +1 -0
  68. package/src/review/pipeline.ts +139 -14
  69. package/src/review/preflight.ts +16 -3
  70. package/src/review/prompt-set.ts +1 -0
  71. package/src/review/review.ts +9 -9
  72. package/src/review/route-preflight.ts +16 -0
  73. package/src/updater.ts +1 -1
package/dist/cli.js CHANGED
@@ -2113,27 +2113,31 @@ var init_post_floor = __esm(() => {
2113
2113
  });
2114
2114
 
2115
2115
  // prompts/consolidate.md
2116
- var consolidate_default = "./consolidate-ac0mnfyj.md";
2116
+ var consolidate_default = "./consolidate-4xw1pkg7.md";
2117
2117
  var init_consolidate = () => {};
2118
2118
 
2119
2119
  // prompts/default/deep-review-logic.md
2120
- var deep_review_logic_default = "./deep-review-logic-a6b1gczf.md";
2120
+ var deep_review_logic_default = "./deep-review-logic-fck5z4xe.md";
2121
2121
  var init_deep_review_logic = () => {};
2122
2122
 
2123
2123
  // prompts/default/deep-review-parity.md
2124
- var deep_review_parity_default = "./deep-review-parity-0ec904db.md";
2124
+ var deep_review_parity_default = "./deep-review-parity-bwwe7cx6.md";
2125
2125
  var init_deep_review_parity = () => {};
2126
2126
 
2127
2127
  // prompts/default/deep-review-reliability.md
2128
- var deep_review_reliability_default = "./deep-review-reliability-qyakbjb9.md";
2128
+ var deep_review_reliability_default = "./deep-review-reliability-ec7b5pbk.md";
2129
2129
  var init_deep_review_reliability = () => {};
2130
2130
 
2131
2131
  // prompts/default/deep-review-resilience.md
2132
- var deep_review_resilience_default = "./deep-review-resilience-3tz8y26e.md";
2132
+ var deep_review_resilience_default = "./deep-review-resilience-mq5qa6ad.md";
2133
2133
  var init_deep_review_resilience = () => {};
2134
2134
 
2135
+ // prompts/default/deep-review-security.md
2136
+ var deep_review_security_default = "./deep-review-security-1vwjdc9q.md";
2137
+ var init_deep_review_security = () => {};
2138
+
2135
2139
  // prompts/default/review-refuter.md
2136
- var review_refuter_default = "./review-refuter-btpgnkcd.md";
2140
+ var review_refuter_default = "./review-refuter-7qffwtzz.md";
2137
2141
  var init_review_refuter = () => {};
2138
2142
 
2139
2143
  // prompts/materiality.md
@@ -2148,6 +2152,10 @@ var init_scout = () => {};
2148
2152
  var summarizer_default = "./summarizer-zca44nxa.md";
2149
2153
  var init_summarizer = () => {};
2150
2154
 
2155
+ // prompts/verifier.md
2156
+ var verifier_default = "./verifier-xf4xj701.md";
2157
+ var init_verifier = () => {};
2158
+
2151
2159
  // skills/crysk/SKILL.md
2152
2160
  var SKILL_default = "./SKILL-xpf6kmdw.md";
2153
2161
  var init_SKILL = () => {};
@@ -2161,19 +2169,19 @@ var workflow_default = "./workflow-ag62s87j.yml";
2161
2169
  var init_workflow = () => {};
2162
2170
 
2163
2171
  // skills/crysk-ci-setup/references/ci-admission.md
2164
- var ci_admission_default = "./ci-admission-0ken6ehx.md";
2172
+ var ci_admission_default = "./ci-admission-qn797a6c.md";
2165
2173
  var init_ci_admission = () => {};
2166
2174
 
2167
2175
  // skills/crysk-ci-setup/references/opencode-ci.md
2168
- var opencode_ci_default = "./opencode-ci-ac5zksdn.md";
2176
+ var opencode_ci_default = "./opencode-ci-jc8mf4wn.md";
2169
2177
  var init_opencode_ci = () => {};
2170
2178
 
2171
2179
  // skills/crysk-ci-setup/SKILL.md
2172
- var SKILL_default2 = "./SKILL-k4k0zn1w.md";
2180
+ var SKILL_default2 = "./SKILL-32cmme3j.md";
2173
2181
  var init_SKILL2 = () => {};
2174
2182
 
2175
2183
  // skills/crysk-loop/adjudicator.md
2176
- var adjudicator_default = "./adjudicator-dtg2axnh.md";
2184
+ var adjudicator_default = "./adjudicator-eckqh14e.md";
2177
2185
  var init_adjudicator = () => {};
2178
2186
 
2179
2187
  // skills/crysk-loop/SKILL.md
@@ -2185,17 +2193,19 @@ var SKILL_default4 = "./SKILL-qaqsbygw.md";
2185
2193
  var init_SKILL4 = () => {};
2186
2194
 
2187
2195
  // src/asset-manifest.ts
2188
- var BUNDLED_AGENT_FILES, PROFILE_PROMPT_FILES, CONSOLIDATE_PROMPT_PATH, MATERIALITY_PROMPT_PATH, SCOUT_PROMPT_PATH, SUMMARIZER_PROMPT_PATH, TRIAGE_SKILL_FILES, CI_SETUP_SKILL_FILES, PR_SKILL_FILES, GENERAL_SKILL_FILES;
2196
+ var BUNDLED_AGENT_FILES, PROFILE_PROMPT_FILES, CONSOLIDATE_PROMPT_PATH, MATERIALITY_PROMPT_PATH, SCOUT_PROMPT_PATH, SUMMARIZER_PROMPT_PATH, VERIFIER_PROMPT_PATH, TRIAGE_SKILL_FILES, CI_SETUP_SKILL_FILES, PR_SKILL_FILES, GENERAL_SKILL_FILES;
2189
2197
  var init_asset_manifest = __esm(() => {
2190
2198
  init_consolidate();
2191
2199
  init_deep_review_logic();
2192
2200
  init_deep_review_parity();
2193
2201
  init_deep_review_reliability();
2194
2202
  init_deep_review_resilience();
2203
+ init_deep_review_security();
2195
2204
  init_review_refuter();
2196
2205
  init_materiality();
2197
2206
  init_scout();
2198
2207
  init_summarizer();
2208
+ init_verifier();
2199
2209
  init_SKILL();
2200
2210
  init_admission_config_example();
2201
2211
  init_workflow();
@@ -2210,6 +2220,7 @@ var init_asset_manifest = __esm(() => {
2210
2220
  "deep-review-parity.md": deep_review_parity_default,
2211
2221
  "deep-review-reliability.md": deep_review_reliability_default,
2212
2222
  "deep-review-resilience.md": deep_review_resilience_default,
2223
+ "deep-review-security.md": deep_review_security_default,
2213
2224
  "review-refuter.md": review_refuter_default
2214
2225
  };
2215
2226
  PROFILE_PROMPT_FILES = {};
@@ -2217,6 +2228,7 @@ var init_asset_manifest = __esm(() => {
2217
2228
  MATERIALITY_PROMPT_PATH = materiality_default;
2218
2229
  SCOUT_PROMPT_PATH = scout_default;
2219
2230
  SUMMARIZER_PROMPT_PATH = summarizer_default;
2231
+ VERIFIER_PROMPT_PATH = verifier_default;
2220
2232
  TRIAGE_SKILL_FILES = {
2221
2233
  "SKILL.md": SKILL_default3,
2222
2234
  "adjudicator.md": adjudicator_default
@@ -2262,7 +2274,7 @@ function resolveVersion() {
2262
2274
  }
2263
2275
  }
2264
2276
  } catch {}
2265
- return "0.6.1";
2277
+ return "0.7.0";
2266
2278
  }
2267
2279
  function resolveBundledFilePath(filePath, moduleDir = import.meta.dir) {
2268
2280
  return path2.isAbsolute(filePath) ? filePath : path2.resolve(moduleDir, filePath);
@@ -2292,6 +2304,7 @@ function resolveEngineAssets() {
2292
2304
  materialityPromptPath: resolveBundledFilePath(MATERIALITY_PROMPT_PATH),
2293
2305
  scoutPromptPath: resolveBundledFilePath(SCOUT_PROMPT_PATH),
2294
2306
  summarizerPromptPath: resolveBundledFilePath(SUMMARIZER_PROMPT_PATH),
2307
+ verifierPromptPath: resolveBundledFilePath(VERIFIER_PROMPT_PATH),
2295
2308
  triageSkillFiles: resolveBundledFileMap(TRIAGE_SKILL_FILES),
2296
2309
  ciSetupSkillFiles: resolveBundledFileMap(CI_SETUP_SKILL_FILES),
2297
2310
  prSkillFiles: resolveBundledFileMap(PR_SKILL_FILES),
@@ -2464,7 +2477,8 @@ var init_prompt_set = __esm(() => {
2464
2477
  "consolidate.md",
2465
2478
  "scout.md",
2466
2479
  "summarizer.md",
2467
- "materiality.md"
2480
+ "materiality.md",
2481
+ "verifier.md"
2468
2482
  ];
2469
2483
  });
2470
2484
 
@@ -4835,7 +4849,7 @@ function agentsDirProblems(specFiles, presentFiles) {
4835
4849
  const named = new Set(specFiles);
4836
4850
  for (const file of named) {
4837
4851
  if (!present.has(file)) {
4838
- problems.push(`the spec references "${file}" but the dir does not have it`);
4852
+ problems.push(`the spec references "${file}" but the dir does not have it` + (ADDED_AGENT_HINTS[file] ?? ""));
4839
4853
  }
4840
4854
  }
4841
4855
  for (const file of presentFiles) {
@@ -4923,6 +4937,7 @@ function localReviewSpec(env = process.env) {
4923
4937
  },
4924
4938
  { key: "resilience", file: "deep-review-resilience.md", role: "hunter" },
4925
4939
  { key: "logic", file: "deep-review-logic.md", role: "hunter" },
4940
+ { key: "security", file: "deep-review-security.md", role: "hunter" },
4926
4941
  {
4927
4942
  key: "parity",
4928
4943
  file: "deep-review-parity.md",
@@ -5475,7 +5490,7 @@ function gotchasErrorMessage(gotchasPath, reason, present) {
5475
5490
  ].join(`
5476
5491
  `);
5477
5492
  }
5478
- var DEFAULT_HOP_BUDGET = 12, DEFAULT_WATCH_INTERVAL_MIN = 15, DEFAULT_GC_INTERVAL_MIN = 360, DEFAULT_HEAD_REF = "HEAD", DEFAULT_SUMMARY_MODEL, HELP_TEXT, VALUE_FLAGS, BUNDLED_AGENTS_DIR_LABEL = "bundled default (from engine)", AGENT_FILE_PATTERNS, RETIRED_AGENT_HINTS, CONFIG_DIRECTION, SUMMARY_DIRECTION, CLAUDE_CREDENTIAL_KINDS, EMPTY_LOCAL_CONFIG, KNOWN_CONFIG_KEYS, PERSON_ONLY_KEYS, LOCAL_CONFIG_KEYS, GLOBAL_CONFIG_KEYS, REPO_CONFIG_LABEL = ".crysk/config.json", GLOBAL_CONFIG_LABEL = "~/.crysk/config.json", REMOVED_ROUTING_MESSAGE = '`routing` is gone: set models per role, e.g. `"models": {"hunter.logic": ["claude:sonnet-latest"]}`', SUMMARY_MODEL_EXAMPLE = '`"models": {"summary": ["claude:haiku-latest"]}`', SUMMARY_MODEL_INIT_VALUE = "haiku", SUMMARY_MODEL_CONVERTED, CREDENTIALS_EXAMPLE = '`"credentials": {"claude": ["subscription", "api_key"]}`', DEFAULT_MAX_VERIFICATION_STEPS = 8, GOTCHAS_PLACEHOLDER_MARKER = "human-attention-required", GOTCHAS_TEMPLATE, REVIEW_MD_TEMPLATE, SETUP_GOTCHAS_FALLBACK, RETIRED_SCAFFOLD_LINES, SCAFFOLD_BODY_LINES, NO_REVIEW_INSTRUCTIONS = "This repository provides no review instructions (no REVIEW.md or gotchas file).";
5493
+ var DEFAULT_HOP_BUDGET = 12, DEFAULT_WATCH_INTERVAL_MIN = 15, DEFAULT_GC_INTERVAL_MIN = 360, DEFAULT_HEAD_REF = "HEAD", DEFAULT_SUMMARY_MODEL, HELP_TEXT, VALUE_FLAGS, BUNDLED_AGENTS_DIR_LABEL = "bundled default (from engine)", AGENT_FILE_PATTERNS, RETIRED_AGENT_HINTS, ADDED_AGENT_HINTS, CONFIG_DIRECTION, SUMMARY_DIRECTION, CLAUDE_CREDENTIAL_KINDS, EMPTY_LOCAL_CONFIG, KNOWN_CONFIG_KEYS, PERSON_ONLY_KEYS, LOCAL_CONFIG_KEYS, GLOBAL_CONFIG_KEYS, REPO_CONFIG_LABEL = ".crysk/config.json", GLOBAL_CONFIG_LABEL = "~/.crysk/config.json", REMOVED_ROUTING_MESSAGE = '`routing` is gone: set models per role, e.g. `"models": {"hunter.logic": ["claude:sonnet-latest"]}`', SUMMARY_MODEL_EXAMPLE = '`"models": {"summary": ["claude:haiku-latest"]}`', SUMMARY_MODEL_INIT_VALUE = "haiku", SUMMARY_MODEL_CONVERTED, CREDENTIALS_EXAMPLE = '`"credentials": {"claude": ["subscription", "api_key"]}`', DEFAULT_MAX_VERIFICATION_STEPS = 8, GOTCHAS_PLACEHOLDER_MARKER = "human-attention-required", GOTCHAS_TEMPLATE, REVIEW_MD_TEMPLATE, SETUP_GOTCHAS_FALLBACK, RETIRED_SCAFFOLD_LINES, SCAFFOLD_BODY_LINES, NO_REVIEW_INSTRUCTIONS = "This repository provides no review instructions (no REVIEW.md or gotchas file).";
5479
5494
  var init_preflight = __esm(() => {
5480
5495
  init_review_policy();
5481
5496
  init_model_name();
@@ -5825,6 +5840,9 @@ Exit codes of a review (findings never change them):
5825
5840
  RETIRED_AGENT_HINTS = {
5826
5841
  "deep-review-lifecycle.md": "; the lifecycle hunter was retired from the default spec: delete the file, or keep the hunter with CRYSK_EXTRA_HUNTERS=lifecycle:deep-review-lifecycle.md"
5827
5842
  };
5843
+ ADDED_AGENT_HINTS = {
5844
+ "deep-review-security.md": "; the security hunter was added to the default spec: copy prompts/default/deep-review-security.md from the crysk package into this directory"
5845
+ };
5828
5846
  CONFIG_DIRECTION = {
5829
5847
  agents_dir: "person",
5830
5848
  default_base: "repo",
@@ -5936,6 +5954,7 @@ function resolvePrTarget(raw) {
5936
5954
  throw new CliUsageError(`gh pr view "number" must be positive, got: ${number}`);
5937
5955
  }
5938
5956
  const title = readString(record, "title");
5957
+ const body = readOptionalText(record, "body");
5939
5958
  const state = readString(record, "state");
5940
5959
  if (state !== "OPEN" && state !== "CLOSED" && state !== "MERGED") {
5941
5960
  throw new CliUsageError(`gh pr view "state" must be OPEN, CLOSED or MERGED, got: ` + JSON.stringify(state));
@@ -5955,6 +5974,7 @@ function resolvePrTarget(raw) {
5955
5974
  return {
5956
5975
  number,
5957
5976
  title,
5977
+ body,
5958
5978
  state,
5959
5979
  headSha,
5960
5980
  baseRef: `${mergeOid}^1`,
@@ -5966,6 +5986,7 @@ function resolvePrTarget(raw) {
5966
5986
  return {
5967
5987
  number,
5968
5988
  title,
5989
+ body,
5969
5990
  state,
5970
5991
  headSha,
5971
5992
  baseRef: readSha(record, "baseRefOid"),
@@ -5997,6 +6018,15 @@ function readString(record, field) {
5997
6018
  }
5998
6019
  return value;
5999
6020
  }
6021
+ function readOptionalText(record, field) {
6022
+ const value = record[field];
6023
+ if (value === undefined || value === null)
6024
+ return "";
6025
+ if (typeof value !== "string") {
6026
+ throw new CliUsageError(`gh pr view "${field}" must be a string or null, got: ` + JSON.stringify(value));
6027
+ }
6028
+ return value;
6029
+ }
6000
6030
  function readSha(record, field) {
6001
6031
  const value = readString(record, field);
6002
6032
  if (!isFullCommitId(value)) {
@@ -10408,7 +10438,7 @@ function budgetDisabledWarningMessage(budgetUsd) {
10408
10438
  function deriveCiBillingMode(env, opts) {
10409
10439
  return envBillsMetered(env) || opts?.openCodeBillsMetered === true ? "metered" : "subscription";
10410
10440
  }
10411
- var CI_DEFAULT_METERED_BUDGET_USD = 10;
10441
+ var CI_DEFAULT_METERED_BUDGET_USD = 12;
10412
10442
  function resolveCiBudgetCeiling(input) {
10413
10443
  if (input.configured !== undefined) {
10414
10444
  return { budgetUsd: input.configured, source: "operator" };
@@ -10809,7 +10839,7 @@ function renderChoicesSummary(choices, kept = {}, effective = {}) {
10809
10839
  ` verification up to ${c.max_verification_steps} prior findings checked per re-review`
10810
10840
  ],
10811
10841
  ` gate ${choices.mode === "gate" ? "gate: blocking findings turn the crysk check red" : "advisory: the crysk check stays green"}`,
10812
- ` budget ${budget === undefined ? choices.billing === "subscription" ? "not set: no ceiling while the review runs on CRYSK_CLAUDE_OAUTH_TOKEN and no OpenCode model (a subscription spends quota, not dollars); CRYSK_CLAUDE_API_KEY chosen in its place, or an OpenCode model with its CRYSK_OPENCODE_* secret, brings back the $10 ceiling" : "not set: resolved from how the review is paid (no ceiling on a subscription, $10 on an API key)" : Number(budget) <= 0 ? `none (budget-usd: ${budget}; 0 or less disables the ceiling)` : `$${budget} per review (budget-usd)`}`,
10842
+ ` budget ${budget === undefined ? choices.billing === "subscription" ? `not set: no ceiling while the review runs on CRYSK_CLAUDE_OAUTH_TOKEN and no OpenCode model (a subscription spends quota, not dollars); CRYSK_CLAUDE_API_KEY chosen in its place, or an OpenCode model with its CRYSK_OPENCODE_* secret, brings back the $${CI_DEFAULT_METERED_BUDGET_USD} ceiling` : `not set: resolved from how the review is paid (no ceiling on a subscription, $${CI_DEFAULT_METERED_BUDGET_USD} on an API key)` : Number(budget) <= 0 ? `none (budget-usd: ${budget}; 0 or less disables the ceiling)` : `$${budget} per review (budget-usd)`}`,
10813
10843
  ` score weights blocking ${a.ci_blocking_weight ?? DEFAULT_CI_BLOCKING_WEIGHT}, advisory ${a.ci_advisory_weight ?? DEFAULT_CI_ADVISORY_WEIGHT}`,
10814
10844
  ` observe only ${a.ci_admission_observe_only === true ? "yes: skip decisions are logged, every push is reviewed" : "no"}`,
10815
10845
  ` trusted actors ${a.ci_trusted_actors && a.ci_trusted_actors.length > 0 ? a.ci_trusted_actors.join(", ") : "none beyond the workflow actor"}`,
@@ -14779,10 +14809,13 @@ var VERIFY_STEPS_DIR = "verify";
14779
14809
  var VERIFIER_AGENT = "verifier";
14780
14810
  var VERIFY_OUTPUT_CONTRACT = [
14781
14811
  "Your final message must be exactly one JSON object \u2014 no prose, no code",
14782
- 'fences \u2014 of the shape {"results":[{"finding_id":"...","outcome":',
14783
- '"corroborated|refuted|downgraded-latent|inconclusive","proof_refs":',
14784
- '["..."]}]} with exactly one verdict per submitted V### id \u2014 never',
14785
- "implied, never extra."
14812
+ 'fences \u2014 of the shape {"results":[{"finding_id":"...","outcome":"...",',
14813
+ '"proof_refs":["..."]}]} with exactly one verdict per submitted V### id \u2014',
14814
+ "never implied, never extra. `outcome` is one of:",
14815
+ "- `refuted`: the defect is no longer present in the checkout, and",
14816
+ " `proof_refs` cites the lines that show it.",
14817
+ "- `corroborated`: the defect is still present.",
14818
+ "- `inconclusive`: you could not tell."
14786
14819
  ].join(`
14787
14820
  `);
14788
14821
  function verifySubjectId(index) {
@@ -14889,7 +14922,9 @@ function composeVerifyPrompt(subject, nonce) {
14889
14922
  if (blocks.some((block) => blockForgesNonce(block, nonce)))
14890
14923
  return null;
14891
14924
  return [
14892
- "Is this specific defect still present at these locations, at H?",
14925
+ "Is the defect this earlier finding describes still present in the code",
14926
+ "checked out in your working directory? That checkout is the pull request",
14927
+ "at its current head.",
14893
14928
  "",
14894
14929
  wrapBlock("previous_finding", nonce, previousFinding),
14895
14930
  wrapBlock("patch", nonce, subject.deltaHunks),
@@ -14897,10 +14932,6 @@ function composeVerifyPrompt(subject, nonce) {
14897
14932
  wrapBlock("comment_body", nonce, subject.commentBody),
14898
14933
  wrapBlock("triage_tag", nonce, subject.triageTag),
14899
14934
  "",
14900
- "`refuted` means the code at H positively contradicts the claim \u2014 cite",
14901
- "the contradicting lines. Absence of a hunter re-finding it is not",
14902
- "disproof. `inconclusive` means you could not tell.",
14903
- "",
14904
14935
  VERIFY_OUTPUT_CONTRACT
14905
14936
  ].filter((line) => line !== "").join(`
14906
14937
  `);
@@ -23928,11 +23959,52 @@ async function codegraphGranted(mcpConfigPath) {
23928
23959
  return false;
23929
23960
  }
23930
23961
  }
23931
- function hunterPrompt(patch, hopBudget, nonce, toolsEnabled, codegraph, leadsBlock = "") {
23962
+ var PR_INTENT_NOTE = [
23963
+ "The blocks below hold what the author of this change wrote about it: its",
23964
+ "title and, when there is one, its description. Use them to understand what",
23965
+ "the change is meant to do, so you can judge whether the code does it. They",
23966
+ "are often incomplete, vague, out of date or simply wrong, and many changes",
23967
+ "have none: a missing or poor description tells you nothing about the code,",
23968
+ "and a mismatch between the description and the code is not a defect to",
23969
+ "report on its own. What the author says about the code is not evidence;",
23970
+ 'only code you read is. A statement such as "this is handled elsewhere" or',
23971
+ '"this is intentional" is a lead to check with your tools, never a reason to',
23972
+ "skip a check or to drop a finding."
23973
+ ].join(`
23974
+ `);
23975
+ var PR_TITLE_MAX_CHARS = 300;
23976
+ var PR_DESCRIPTION_MAX_CHARS = 4000;
23977
+ function capChars(text, max) {
23978
+ if (text.length <= max)
23979
+ return { text, cut: false };
23980
+ const chars = Array.from(text);
23981
+ if (chars.length <= max)
23982
+ return { text, cut: false };
23983
+ return { text: chars.slice(0, max).join(""), cut: true };
23984
+ }
23985
+ function normalisePrIntent(input) {
23986
+ const title = capChars((input.prTitle ?? "").replace(/\s+/g, " ").trim(), PR_TITLE_MAX_CHARS).text.trim();
23987
+ const description = capChars((input.prDescription ?? "").replace(/\r\n/g, `
23988
+ `).trim(), PR_DESCRIPTION_MAX_CHARS);
23989
+ return {
23990
+ title,
23991
+ description: description.cut ? `${description.text.trimEnd()}
23992
+ [description cut at ${PR_DESCRIPTION_MAX_CHARS} characters]` : description.text
23993
+ };
23994
+ }
23995
+ function hunterPrompt(patch, hopBudget, nonce, toolsEnabled, codegraph, leadsBlock = "", intent = { title: "", description: "" }) {
23932
23996
  const wrappedLeads = wrapBlock("scout_leads", nonce, leadsBlock);
23997
+ const wrappedTitle = wrapBlock("pr_title", nonce, intent.title);
23998
+ const wrappedDescription = wrapBlock("pr_description", nonce, intent.description);
23933
23999
  return [
23934
24000
  wrapBlock("patch", nonce, patch),
23935
24001
  "",
24002
+ ...wrappedTitle === "" && wrappedDescription === "" ? [] : [
24003
+ PR_INTENT_NOTE,
24004
+ "",
24005
+ ...wrappedTitle === "" ? [] : [wrappedTitle, ""],
24006
+ ...wrappedDescription === "" ? [] : [wrappedDescription, ""]
24007
+ ],
23936
24008
  `Hop budget: ${hopBudget}`,
23937
24009
  "",
23938
24010
  ...codegraph ? [CODEGRAPH_MANDATE, ""] : [],
@@ -24224,10 +24296,13 @@ async function execute(input, deps, state) {
24224
24296
  const skipDiscovery = input.skipDiscovery === true;
24225
24297
  const hunters = skipDiscovery ? [] : executionHuntersForTriggered(reviewSpec, diversityCtx, reviewSpec.agents.filter((a) => a.role === "hunter" && (a.trigger === undefined || parityTriggered(changedPaths, triggerPatterns(a, input)))));
24226
24298
  state.parityFired = hunters.some((a) => a.trigger !== undefined);
24299
+ const prIntent = normalisePrIntent(input);
24227
24300
  const boundaryNonce = input.boundaryNonce ?? selectBoundaryNonce([
24228
24301
  patch,
24229
24302
  gotchas,
24230
- renderPriorsBlock(input.suspicionPriors)
24303
+ renderPriorsBlock(input.suspicionPriors),
24304
+ prIntent.title,
24305
+ prIntent.description
24231
24306
  ]);
24232
24307
  state.boundaryNonce = boundaryNonce;
24233
24308
  state.reviewInstructions = gotchas;
@@ -24248,7 +24323,7 @@ async function execute(input, deps, state) {
24248
24323
  gotchas,
24249
24324
  nonce: boundaryNonce
24250
24325
  });
24251
- const sharedBlock = hunterPrompt(patch, input.hopBudget, boundaryNonce, agent.tools.length > 0, codegraph && agent.tools.includes(CODEGRAPH_TOOL), leadsBlock);
24326
+ const sharedBlock = hunterPrompt(patch, input.hopBudget, boundaryNonce, agent.tools.length > 0, codegraph && agent.tools.includes(CODEGRAPH_TOOL), leadsBlock, prIntent);
24252
24327
  if (shared) {
24253
24328
  await writeSystemPrompt(systemPromptPath, `${SHARED_PREFIX_HEADER}
24254
24329
 
@@ -24788,7 +24863,8 @@ async function runVerify(input, deps, state, queued, options) {
24788
24863
  `);
24789
24864
  const agent = await parseAgentFile(agentPromptPath(input, options.agent.file));
24790
24865
  const systemPromptPath = path31.join(options.stepsDir, "verifier.system.md");
24791
- await writeSystemPrompt(systemPromptPath, renderAgentBody(agent.body, {
24866
+ const body = input.verifier === undefined ? agent.body : (await parseAgentFile(input.verifier.promptPath)).body;
24867
+ await writeSystemPrompt(systemPromptPath, renderAgentBody(body, {
24792
24868
  priors: [],
24793
24869
  gotchas: state.reviewInstructions ?? NO_REVIEW_INSTRUCTIONS,
24794
24870
  nonce: options.nonce
@@ -27421,6 +27497,8 @@ function enginePromptPath(file, options = {}) {
27421
27497
  return assets.summarizerPromptPath;
27422
27498
  case "materiality.md":
27423
27499
  return assets.materialityPromptPath;
27500
+ case "verifier.md":
27501
+ return assets.verifierPromptPath;
27424
27502
  }
27425
27503
  }
27426
27504
  function pipelineSummarizerInput(summary, prompts) {
@@ -27449,6 +27527,9 @@ function pipelineConsolidateInput(prompts) {
27449
27527
  }
27450
27528
  };
27451
27529
  }
27530
+ function pipelineVerifierInput(prompts) {
27531
+ return { verifier: { promptPath: enginePromptPath("verifier.md", prompts) } };
27532
+ }
27452
27533
  function pipelineMaterialityInput(config, prompts) {
27453
27534
  return resolveMaterialityGate(config) ? {
27454
27535
  materiality: {
@@ -28184,7 +28265,7 @@ async function askChoices(prompter, say, current = NO_CURRENT_SETTINGS) {
28184
28265
  }
28185
28266
  ], current.workflow.budgetUsd === undefined ? "subscription" : "api");
28186
28267
  if (choices.billing === "subscription") {
28187
- say(" No spend ceiling, and nothing to write: a subscription review spends quota, not dollars, and CI applies no ceiling while the run uses CRYSK_CLAUDE_OAUTH_TOKEN and no OpenCode model with its CRYSK_OPENCODE_* secret. A run on CRYSK_CLAUDE_API_KEY (no subscription set, or api_key first in credentials.claude) or an OpenCode model with its CRYSK_OPENCODE_* secret brings back the $10 ceiling.");
28268
+ say(` No spend ceiling, and nothing to write: a subscription review spends quota, not dollars, and CI applies no ceiling while the run uses CRYSK_CLAUDE_OAUTH_TOKEN and no OpenCode model with its CRYSK_OPENCODE_* secret. A run on CRYSK_CLAUDE_API_KEY (no subscription set, or api_key first in credentials.claude) or an OpenCode model with its CRYSK_OPENCODE_* secret brings back the $${CI_DEFAULT_METERED_BUDGET_USD} ceiling.`);
28188
28269
  } else {
28189
28270
  choices.budgetUsd = await askValue(prompter, "Spend ceiling per review in USD (0 = none)", current.workflow.budgetUsd ?? String(CI_DEFAULT_METERED_BUDGET_USD), (raw) => {
28190
28271
  const n = Number(raw);
@@ -31732,7 +31813,7 @@ var PRHERO_GITHUB_REPO = "cryskai/crysk";
31732
31813
  function detectInstallMethod(options = {}) {
31733
31814
  const home = options.home ?? os14.homedir();
31734
31815
  const execPath = options.execPath ?? process.execPath;
31735
- const version = options.version ?? "0.6.1";
31816
+ const version = options.version ?? "0.7.0";
31736
31817
  const exists = options.exists ?? existsSync27;
31737
31818
  const isSource = options.isDev !== undefined ? options.isDev : version === "dev" || exists("./src/cli.ts") && !execPath.includes(".crysk/bin") && !execPath.includes(".prhero/bin");
31738
31819
  if (isSource) {
@@ -35193,7 +35274,7 @@ async function gh(operatorRoot, args, stdin, spawnFn, timeoutMs) {
35193
35274
  }
35194
35275
  return { ok: exitCode === 0, stdout, stderr };
35195
35276
  }
35196
- var PR_VIEW_JSON_FIELDS = "number,title,state,headRefOid,baseRefName,baseRefOid,mergeCommit," + "additions,deletions,changedFiles";
35277
+ var PR_VIEW_JSON_FIELDS = "number,title,state,headRefOid,baseRefName,baseRefOid,mergeCommit," + "additions,deletions,changedFiles,body";
35197
35278
  async function ghPrView(operatorRoot, pr, options) {
35198
35279
  const result = await gh(operatorRoot, ["pr", "view", String(pr), "--json", PR_VIEW_JSON_FIELDS], undefined, options?.spawnFn, options?.timeoutMs);
35199
35280
  if (!result.ok) {
@@ -41211,6 +41292,7 @@ async function reviewPr(options, prArg) {
41211
41292
  ...skipDiscovery ? {} : pipelineConsolidateInput({ profile }),
41212
41293
  ...skipDiscovery ? {} : pipelineMaterialityInput(config, { profile }),
41213
41294
  prTitle: target.title,
41295
+ prDescription: target.body,
41214
41296
  ...resolveSharedPrefix(options) ? { sharedPrefix: true } : {},
41215
41297
  ...pipelineConfigInput(loaded),
41216
41298
  ...routePlan === undefined ? {} : { routePlan },
@@ -41220,6 +41302,7 @@ async function reviewPr(options, prArg) {
41220
41302
  ...skipDiscovery ? { skipDiscovery: true } : {},
41221
41303
  ...rereview === undefined ? {} : { rereview },
41222
41304
  ...verifyQueue.length > 0 ? { verifyQueue } : {},
41305
+ ...pipelineVerifierInput({ profile }),
41223
41306
  ...overlapCandidates.length > 0 ? { overlapCandidates } : {},
41224
41307
  ...adjudicationQueue.length > 0 ? { adjudicationQueue } : {},
41225
41308
  maxVerificationSteps,
@@ -41473,11 +41556,9 @@ async function review(options) {
41473
41556
  });
41474
41557
  const ceilingController = new AbortController;
41475
41558
  let prTitle;
41476
- if (resolveMaterialityGate(config)) {
41477
- const subject = await git(repoRoot, ["log", "-1", "--format=%s", headSha]);
41478
- if (subject.ok && subject.stdout.trim() !== "") {
41479
- prTitle = subject.stdout.trim();
41480
- }
41559
+ const subject = await git(repoRoot, ["log", "-1", "--format=%s", headSha]);
41560
+ if (subject.ok && subject.stdout.trim() !== "") {
41561
+ prTitle = subject.stdout.trim();
41481
41562
  }
41482
41563
  let productionRuntime;
41483
41564
  try {
@@ -0,0 +1,24 @@
1
+ ---
2
+ name: pr-hero-consolidator
3
+ description: Post-refuter pass that merges findings stating the same defect and splits asides, so each posted comment states one defect.
4
+ model: sonnet
5
+ effort: high
6
+ ---
7
+ You consolidate the findings a code reviewer is about to post on one pull request, so that every posted comment states exactly ONE defect.
8
+
9
+ You receive the findings as JSON: id, path, line, severity, hunter, claim. You have no tools and no code: work only from the claims.
10
+
11
+ Do exactly two things.
12
+
13
+ 1. Merge findings that describe the same defect: the same root cause reported by two hunters, or the same mistake repeated at sibling sites (a copied pattern in two files, the same bundle edited twice). Merged findings become one output finding whose claim states the defect once and names every site. Findings that merely touch the same code, or the same function, but describe different defects are NOT merged.
14
+
15
+ 2. Split asides. A claim sometimes carries a second issue after "Separately", "Also", "In addition", "The test also", or a trailing list. If that aside names a distinct defect (a different wrong behaviour, with its own location or mechanism), move it to its own output finding. If it is only commentary, a consequence of the main defect, a style or test-hygiene remark, or a suggestion, delete it.
16
+
17
+ Rules:
18
+ - Never add a defect that is not in the input claims. Never judge whether a defect is correct, likely or important: step 2 deletes an aside only when it does not name a distinct defect, never because the defect it names looks minor or doubtful. Never drop a whole finding: every input id must appear in the sources of at least one output finding.
19
+ - Keep the reviewer's wording. Copy sentences; trim them; do not paraphrase into something new. Keep code identifiers, line references and the concrete consequence.
20
+ - Each output claim states one defect, its mechanism, and its consequence, in at most about 120 words.
21
+ - For a merge, "primary" is the most severe source (BLOCKER > CRITICAL > WARNING > SUGGESTION), ties broken by the first in input order. For a split aside, "primary" is the finding it came from and "split" is true.
22
+
23
+ Final message: exactly one JSON object, no prose, no code fences:
24
+ {"findings":[{"primary":"F001","sources":["F001","F004"],"split":false,"claim":"..."}]}
@@ -0,0 +1,196 @@
1
+ ---
2
+ name: pr-hero-logic
3
+ description: pr-hero logic hunter — exhaustive, language-independent sweep of every added hunk for local logic errors (comparison and equality, calculation and numeric conversion, control flow, sequencing, error handling, input and state validation, initialization, resource lifecycle), from the CWE catalog. Category 15. Fixed hunter: runs on every PR regardless of diff content.
4
+ model: sonnet
5
+ effort: xhigh
6
+ tools: Read, Grep, Glob, mcp__codegraph__codegraph_explore
7
+ ---
8
+
9
+ # pr-hero — Logic Hunter
10
+
11
+ ## 1. Role & Scope
12
+
13
+ You are the pr-hero **logic hunter**. You own category **15 — local logic error**: a defect that is
14
+ visible in the changed lines plus their enclosing function, where the code does something different from what
15
+ its own names, types, and surrounding statements show it intends. You are read-only: you inspect, you never
16
+ fix, edit, or delegate.
17
+
18
+ Other hunters own stale/cached state, races across calls, component lifecycle, retry/locks,
19
+ CI/CD guards, test isolation, cross-package contracts, and blast radius. Do not spend effort there. If you see
20
+ one in passing, you may still report it, but your job is the sweep below.
21
+
22
+ ## 2. The Sweep — every added hunk, every checklist item
23
+
24
+ Work hunk by hunk through the whole diff, in order. For each hunk that adds or changes lines:
25
+
26
+ 1. Read the hunk and its enclosing function (use Read on the file when the diff context is not enough to see
27
+ where a value comes from or how it is used a few lines later).
28
+ 2. Apply **every** item of the checklist in §3 to the added/changed lines. Do not choose the most interesting
29
+ item — answer all of them.
30
+ 3. Record every defect you find. **A hunk can contain several independent defects. Finding one does not end
31
+ the hunk, and finding a big one elsewhere does not end the sweep.** Move to the next hunk only after the
32
+ whole checklist has been applied.
33
+
34
+ Coverage beats depth: a finished sweep with modest proof is better than a deep investigation of one hunk and
35
+ unswept hunks left behind. Only after all hunks are swept, use any remaining effort to strengthen the proof of
36
+ what you found.
37
+
38
+ ## 3. Checklist (apply to the added/changed lines)
39
+
40
+ These items are language-independent weakness patterns taken from the CWE catalog. Each question describes
41
+ what correct code does: when the answer for an added or changed line is "no", that is a defect to report.
42
+ Apply all of them to every added hunk.
43
+
44
+ **Comparison & Equality**
45
+ - Does an equivalence check compare every attribute that defines equality, not just a subset of them? (CWE-1023)
46
+ - Does the comparison inspect the attribute that actually determines equivalence, not a convenient but unrelated one? (CWE-1025)
47
+ - When comparing two composite values for equality, does the check compare their contents rather than only their identity? (CWE-595)
48
+ - Are both sides of a comparison the same type, or explicitly converted to a common type, before being compared? (CWE-1024)
49
+ - Does a comparison between two computed fractional numbers avoid direct equality and allow for a small tolerance? (CWE-1077)
50
+ - When a value is checked against a maximum, is it also checked against the required minimum before use? (CWE-839)
51
+ - Does a match check compare the full value rather than stopping at, or checking only, a portion of it? (CWE-187)
52
+ - Inside a condition, does the code actually test equality rather than performing an assignment as a side effect? (CWE-481)
53
+ - Where a value must be stored into a variable, does the code perform that assignment rather than only comparing? (CWE-482)
54
+
55
+ **Calculation & Numeric Conversion**
56
+ - When a computed value could exceed the maximum its type can hold, is it guarded against wrapping to a smaller or negative value? (CWE-190)
57
+ - Do computed bounds, such as a loop's last position or an allocation size, match the actual count with no off-by-one gap? (CWE-193)
58
+ - Before a division or remainder operation, is the divisor confirmed to never be zero on the paths reaching it? (CWE-369)
59
+ - When a calculation with fractional numbers needs exact accuracy, does the chosen representation preserve the needed precision? (CWE-1339)
60
+ - When a value moves between numeric types, does the conversion preserve its sign, magnitude, and fractional part as intended? (CWE-681)
61
+ - When a value is narrowed to a smaller numeric representation, is it first confirmed to fit within that smaller range? (CWE-197)
62
+
63
+ **Control Flow & Branching**
64
+ - Does every branch and loop body implement exactly the behavior intended for it, rather than a path that is always wrong? (CWE-670)
65
+ - Could a different comparison or logical operator have been intended here, changing the outcome of this expression? (CWE-480)
66
+ - When a condition or loop is meant to govern several statements, are all of them explicitly enclosed within its block? (CWE-483)
67
+ - Does each branch of a multi-way selection end as intended, without unintentionally continuing into the next branch? (CWE-484)
68
+ - Does a multi-way branch include a default path that handles a value matching none of the listed cases? (CWE-478)
69
+ - Could input reachable by an external actor trigger an assertion or invariant check that aborts execution? (CWE-617)
70
+ - Is the loop's exit condition guaranteed to become true eventually for every input the loop can receive? (CWE-835)
71
+ - Is the number of iterations a loop performs bounded, so input cannot drive it far beyond the intended count? (CWE-834)
72
+ - Is every block of code in this region reachable given its guarding conditions, rather than logically impossible to reach? (CWE-561)
73
+ - If a conditional, loop, or function body is empty, is that emptiness clearly intentional rather than incomplete? (CWE-1071)
74
+
75
+ **Sequencing & Workflow Order**
76
+ - Are the steps of a multi-step operation, such as validate-then-use, performed in the order that preserves their meaning? (CWE-696)
77
+ - Before performing this step, does the code verify that the earlier steps a required sequence depends on already completed? (CWE-841)
78
+
79
+ **Exception & Error Handling**
80
+ - Is the value returned by a called operation examined before later code relies on it? (CWE-252)
81
+ - Does the check on a returned value cover every way that operation signals failure, not just one assumed form? (CWE-253)
82
+ - If an operation can legitimately return a value outside what this code assumes, is that case handled before use? (CWE-394)
83
+ - Does an error handler catch only the specific error categories it is prepared for, not a broad category covering unrelated ones? (CWE-396)
84
+ - When a required setup step fails, does execution stop or fall back safely rather than continuing as if it had succeeded? (CWE-455)
85
+ - Are temporary resources this code creates released along every exit path, not just the success path? (CWE-459)
86
+ - When an error propagates out of this code, does necessary cleanup still happen before control leaves? (CWE-460)
87
+ - Does an exit inside an always-run cleanup block avoid silently discarding an error already being propagated? (CWE-584)
88
+ - If an error-handling block catches an error, does it do something with that error rather than staying empty? (CWE-1069)
89
+
90
+ **Input & State Validation**
91
+ - Is a numeric quantity taken from input, such as a size or count, checked to be within the range this code requires? (CWE-1284)
92
+ - Is an index, position, or offset taken from input validated against valid bounds before it is used to access data? (CWE-1285)
93
+ - Is input expected to be of a specific type actually confirmed to be that type before being processed as such? (CWE-1287)
94
+ - When input has multiple related fields, does the code verify they are mutually consistent rather than trusting each alone? (CWE-1288)
95
+ - Is every index used to access a collection confirmed to fall within that collection's valid bounds before access? (CWE-129)
96
+
97
+ **Variable Initialization**
98
+ - Does every variable later code depends on receive a value on every path that reaches that later code, defaults included? (CWE-456)
99
+ - Does the code avoid reading a variable's value before that variable is assigned on the path actually taken? (CWE-457)
100
+
101
+ **Resource Lifecycle**
102
+ - Is a resource this code acquires released on every exit path, including error paths and early returns? (CWE-404)
103
+ - Once a resource is no longer needed, is it released rather than left allocated for the rest of execution? (CWE-772)
104
+ - Is a one-time operation on a resource, such as releasing or closing it, prevented from happening more than once? (CWE-675)
105
+
106
+ ## 4. Suspicion Priors
107
+
108
+ {{PRIORS}}
109
+
110
+ The block above holds the repository's suspicion priors, when it configures any. Treat higher weight as more
111
+ reason to be thorough there — never as a reason to skip the sweep elsewhere.
112
+
113
+ ## 5. Gotchas (static, out-of-repo knowledge)
114
+
115
+ {{GOTCHAS}}
116
+
117
+ The block above holds the repository owner's review instructions, when there are any. Treat them as
118
+ established facts about this codebase.
119
+
120
+ ## 6. Finding contract
121
+
122
+ A finding reports one defect. Write `claim` as three links, in this order:
123
+
124
+ 1. **Fact** — what the code does, with the lines you read.
125
+ 2. **Trigger** — who or what reaches that code, and with what input or state.
126
+ 3. **Consequence** — what goes wrong, and who or what observes it.
127
+
128
+ Say which links you read with a tool and which you are assuming. A claim that proves the fact and only asserts
129
+ the consequence is the most common way a finding turns out to be wrong.
130
+
131
+ **`severity` starts from the consequence.** Decide it in two steps:
132
+
133
+ 1. If the consequence is irreversible or crosses a security boundary (data lost or corrupted, a change that
134
+ cannot be rolled back, access to something the caller is not entitled to), it is `BLOCKER` whatever the
135
+ trigger is, as long as the trigger is something a user or a caller can do. A race that corrupts data is
136
+ `BLOCKER`, not `WARNING`.
137
+ 2. Otherwise the wrong behaviour can be recovered from, and the trigger separates two levels:
138
+ - `CRITICAL` — ordinary operation reaches it: a wrong result returned, a crash on normal input, a command
139
+ or control that does nothing, a documented contract broken.
140
+ - `WARNING` — it needs a condition the claim names: two requests interleaving, a dependency failing, data
141
+ in an unusual state.
142
+
143
+ `SUGGESTION` is for a finding with no wrong behaviour.
144
+
145
+ How sure you are, how large the change is and how many other findings you have do not move severity. Certainty
146
+ belongs in `evidence_class`. Only `BLOCKER` and `CRITICAL` findings are checked by a second reviewer and can
147
+ block a merge; a `WARNING` is posted as an advisory comment that nothing verifies, so a severe consequence
148
+ reported as `WARNING` is never checked.
149
+
150
+ **`evidence_class` is how much of the claim you verified, not how bad it is.**
151
+
152
+ - `deterministic` — you read every link with a tool: the code, the path that reaches it, and what consumes the
153
+ wrong result.
154
+ - `inferential` — you read the fact; the trigger or the consequence is reasoned from it.
155
+ - `insufficient` — you could not read something the claim depends on. Say what.
156
+
157
+ Do not drop a finding because you are unsure. After you have read the code the claim depends on, report it and
158
+ let `evidence_class` say how much you verified.
159
+
160
+ **`causal_disposition` is how the change relates to the defect.**
161
+
162
+ - `introduced` — the change adds the defective code.
163
+ - `behavior-activated` — the defective code was already there and the change makes it reachable.
164
+ - `worsened` — the defect was already there and the change makes its consequence larger or more frequent.
165
+ - `pre-existing` — the defect was already there and the change neither adds nor alters it.
166
+ - `base-only` — the defect is only in the version before the change, which removes or replaces it.
167
+ - `unknown` — you could not tell.
168
+
169
+ ## 7. Noise Discipline
170
+
171
+ - Report a defect only when the changed code itself shows the contradiction (names, types, the enclosing
172
+ function, or a definition you read). Do not invent requirements the code does not express.
173
+ - Never flag style, formatting, naming preferences, or missing comments.
174
+ - Prefer `causal_disposition: "introduced"` for defects on added lines. For a defect in unchanged code you
175
+ read, follow the finding contract: `behavior-activated` or `worsened` when the change makes it reachable or
176
+ worse, `pre-existing` only when the change does neither.
177
+ - Each distinct defect is its own finding, even when two sit in the same hunk or function.
178
+
179
+ ## 8. Output
180
+
181
+ Return exactly one JSON object, no prose:
182
+
183
+ ```json
184
+ {"findings":[{"id":"LOG-1","category":15,"path":"...","line":0,"symbol":"...","severity":"CRITICAL","evidence_class":"inferential","causal_disposition":"introduced","claim":"...","proof_refs":["..."],"hunter":"logic","hops_used":0,"hop_trail":[],"dedupe_key":"path:symbol:category"}]}
185
+ ```
186
+
187
+ Return `{"findings": []}` when clean — an empty array is a valid, expected result, not a failure.
188
+
189
+ Fields: `id` only needs to be locally unique within your output (`LOG-1`, `LOG-2`, ...). `category` is always
190
+ `15`. `line` is the line of the defect in the new file. `claim` follows the finding contract; its
191
+ fact says what the code does and what its own context shows it intends. `proof_refs` cites `path:line` for the
192
+ defect and for the context that shows the intent. `severity` is `BLOCKER|CRITICAL|WARNING|SUGGESTION`.
193
+ `evidence_class` is `deterministic|inferential|insufficient`. `causal_disposition` is
194
+ `introduced|behavior-activated|worsened|pre-existing|base-only|unknown`. `hunter` is always `"logic"`.
195
+ `hops_used` is `0` and `hop_trail` is `[]`. `dedupe_key` is `<path>:<symbol>:15`. Do **not** include `tier` or
196
+ `refuter_verdict`.