crysk 0.0.0-stage → 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 (229) hide show
  1. package/LICENSE +176 -0
  2. package/README.md +610 -2
  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/adjudicator-dtg2axnh.md +86 -0
  10. package/dist/admission-config.example-a9vqmmad.json +9 -0
  11. package/dist/ci-admission-camfbx2b.md +122 -0
  12. package/dist/cli.js +42292 -0
  13. package/dist/consolidate-ac0mnfyj.md +24 -0
  14. package/dist/deep-review-lifecycle-m698ybjp.md +362 -0
  15. package/dist/deep-review-logic-a6b1gczf.md +156 -0
  16. package/dist/deep-review-parity-0ec904db.md +120 -0
  17. package/dist/deep-review-reliability-qyakbjb9.md +125 -0
  18. package/dist/deep-review-resilience-3tz8y26e.md +118 -0
  19. package/dist/index.js +20190 -0
  20. package/dist/opencode-ci-7b0be64p.md +141 -0
  21. package/dist/review-refuter-j4e9gezy.md +71 -0
  22. package/dist/scout-yvp153q7.md +140 -0
  23. package/dist/summarizer-zca44nxa.md +18 -0
  24. package/dist/workflow-w1g9szna.yml +151 -0
  25. package/package.json +82 -4
  26. package/prompts/consolidate.md +24 -0
  27. package/prompts/default/PROVENANCE.md +18 -0
  28. package/prompts/default/deep-review-lifecycle.md +362 -0
  29. package/prompts/default/deep-review-logic.md +156 -0
  30. package/prompts/default/deep-review-parity.md +120 -0
  31. package/prompts/default/deep-review-reliability.md +125 -0
  32. package/prompts/default/deep-review-resilience.md +118 -0
  33. package/prompts/default/review-refuter.md +71 -0
  34. package/prompts/scout.md +140 -0
  35. package/prompts/summarizer.md +18 -0
  36. package/skills/crysk/SKILL.md +74 -0
  37. package/skills/crysk-ci-setup/SKILL.md +134 -0
  38. package/skills/crysk-ci-setup/assets/admission-config.example.json +9 -0
  39. package/skills/crysk-ci-setup/assets/workflow.yml +151 -0
  40. package/skills/crysk-ci-setup/references/ci-admission.md +122 -0
  41. package/skills/crysk-ci-setup/references/opencode-ci.md +141 -0
  42. package/skills/crysk-loop/SKILL.md +496 -0
  43. package/skills/crysk-loop/adjudicator.md +86 -0
  44. package/skills/crysk-pr/SKILL.md +66 -0
  45. package/src/agent-env.ts +1084 -0
  46. package/src/asset-manifest.ts +83 -0
  47. package/src/assets.d.ts +6 -0
  48. package/src/assets.ts +183 -0
  49. package/src/brand-paths.ts +155 -0
  50. package/src/brand.ts +255 -0
  51. package/src/ci/admission-ledger.ts +350 -0
  52. package/src/ci/classify-error.ts +73 -0
  53. package/src/ci/cli-record.ts +271 -0
  54. package/src/ci/force-comment.ts +39 -0
  55. package/src/ci/gates.ts +923 -0
  56. package/src/ci/outcome.ts +2181 -0
  57. package/src/ci/override.ts +187 -0
  58. package/src/ci/publish.ts +1639 -0
  59. package/src/ci/reporter.ts +626 -0
  60. package/src/ci/review-admission.ts +901 -0
  61. package/src/ci/review-levels.ts +310 -0
  62. package/src/ci/review-policy.ts +18 -0
  63. package/src/ci/review-risk.ts +184 -0
  64. package/src/ci/setup.ts +844 -0
  65. package/src/ci/trigger.ts +1353 -0
  66. package/src/cli.ts +348 -0
  67. package/src/commands/activity.ts +67 -0
  68. package/src/commands/ci-setup-questions.ts +397 -0
  69. package/src/commands/ci-setup.ts +381 -0
  70. package/src/commands/config.ts +99 -0
  71. package/src/commands/doctor.ts +108 -0
  72. package/src/commands/init.ts +139 -0
  73. package/src/commands/mcp.ts +10 -0
  74. package/src/commands/menu.ts +129 -0
  75. package/src/commands/post.ts +302 -0
  76. package/src/commands/skills.ts +83 -0
  77. package/src/commands/status.ts +173 -0
  78. package/src/commands/triage.ts +342 -0
  79. package/src/commands/uninstall.ts +37 -0
  80. package/src/commands/upgrade.ts +214 -0
  81. package/src/commands/usage.ts +98 -0
  82. package/src/compare/compare.ts +28 -0
  83. package/src/compare/floor-test.ts +471 -0
  84. package/src/compare/martian-adapter.ts +80 -0
  85. package/src/config/config.ts +267 -0
  86. package/src/corpus/corpus.ts +1094 -0
  87. package/src/corpus/preflight.ts +1789 -0
  88. package/src/diversity/accounting.ts +90 -0
  89. package/src/diversity/adjudication.ts +145 -0
  90. package/src/diversity/admission.ts +60 -0
  91. package/src/diversity/benchmark.ts +195 -0
  92. package/src/diversity/clustering.ts +285 -0
  93. package/src/diversity/errors.ts +7 -0
  94. package/src/diversity/identity.ts +285 -0
  95. package/src/diversity/index.ts +11 -0
  96. package/src/diversity/pipeline-integration.ts +448 -0
  97. package/src/diversity/projection.ts +57 -0
  98. package/src/diversity/self-contained.ts +68 -0
  99. package/src/diversity/target-validation.ts +179 -0
  100. package/src/doctor-migration.ts +209 -0
  101. package/src/doctor.ts +723 -0
  102. package/src/errors.ts +83 -0
  103. package/src/execution/admission.ts +75 -0
  104. package/src/execution/atomic-write.ts +35 -0
  105. package/src/execution/attempt-evidence.ts +415 -0
  106. package/src/execution/bucket-id.ts +136 -0
  107. package/src/execution/concurrency-limiter.ts +175 -0
  108. package/src/execution/contracts.ts +443 -0
  109. package/src/execution/failure-classification.ts +42 -0
  110. package/src/execution/failure-policy.ts +240 -0
  111. package/src/execution/harness.ts +2548 -0
  112. package/src/execution/settlement.ts +348 -0
  113. package/src/execution/spawned-process.ts +66 -0
  114. package/src/execution/spend-limiter.ts +424 -0
  115. package/src/execution/step-artifacts.ts +55 -0
  116. package/src/execution/usage-normalized.ts +469 -0
  117. package/src/git/git.ts +396 -0
  118. package/src/git/identity.ts +64 -0
  119. package/src/git/refs.ts +140 -0
  120. package/src/home-preflight.ts +443 -0
  121. package/src/home.ts +243 -0
  122. package/src/ignore-file.ts +336 -0
  123. package/src/ignore-read.ts +118 -0
  124. package/src/index.ts +34 -0
  125. package/src/legacy-launchd.ts +29 -0
  126. package/src/mcp/mcp.ts +150 -0
  127. package/src/mcp/preflight.ts +407 -0
  128. package/src/menu-context.ts +192 -0
  129. package/src/model/catalog.ts +251 -0
  130. package/src/model/exec-snapshots.ts +390 -0
  131. package/src/model/free-discovery.ts +302 -0
  132. package/src/model/provider-capabilities.ts +814 -0
  133. package/src/model/routing.ts +600 -0
  134. package/src/pr/admission.ts +847 -0
  135. package/src/pr/ci-admission-gate.ts +665 -0
  136. package/src/pr/ci-publish.ts +76 -0
  137. package/src/pr/discovery.ts +432 -0
  138. package/src/pr/inline.ts +507 -0
  139. package/src/pr/plan.ts +366 -0
  140. package/src/pr/posting.ts +115 -0
  141. package/src/pr/pr-status.ts +787 -0
  142. package/src/pr/pr.ts +3642 -0
  143. package/src/pr/preflight.ts +1031 -0
  144. package/src/pr/publish-outcome.ts +361 -0
  145. package/src/pr/range.ts +119 -0
  146. package/src/pr/reverts-preflight.ts +606 -0
  147. package/src/pr/reverts.ts +377 -0
  148. package/src/pr/review-pr.ts +927 -0
  149. package/src/pr/status.ts +154 -0
  150. package/src/pr/target.ts +388 -0
  151. package/src/pr/teardown.ts +437 -0
  152. package/src/pr/worktree-setup.ts +60 -0
  153. package/src/production-runtime.ts +1877 -0
  154. package/src/progress.ts +487 -0
  155. package/src/rereview/adjudicate.ts +89 -0
  156. package/src/rereview/classify.ts +362 -0
  157. package/src/rereview/identity.ts +211 -0
  158. package/src/rereview/plan.ts +308 -0
  159. package/src/rereview/prepare.ts +1025 -0
  160. package/src/rereview/state.ts +767 -0
  161. package/src/rereview/verify.ts +241 -0
  162. package/src/review/boundary.ts +105 -0
  163. package/src/review/consolidate.ts +246 -0
  164. package/src/review/dedupe.ts +368 -0
  165. package/src/review/drafts.ts +448 -0
  166. package/src/review/findings-conformance.ts +120 -0
  167. package/src/review/findings.ts +714 -0
  168. package/src/review/pipeline.ts +3977 -0
  169. package/src/review/preflight.ts +3575 -0
  170. package/src/review/prompt-set.ts +177 -0
  171. package/src/review/proof-refs.ts +187 -0
  172. package/src/review/report.ts +1821 -0
  173. package/src/review/review.ts +490 -0
  174. package/src/review/root-cause.ts +120 -0
  175. package/src/review/route-preflight.ts +289 -0
  176. package/src/review/run.ts +601 -0
  177. package/src/review/scout.ts +323 -0
  178. package/src/review/size-gate.ts +595 -0
  179. package/src/review/spec.ts +235 -0
  180. package/src/review/step-runner.ts +233 -0
  181. package/src/runner-authority.ts +596 -0
  182. package/src/security/binding-policy.ts +115 -0
  183. package/src/security/credential-broker.ts +773 -0
  184. package/src/security/evidence-redaction.ts +62 -0
  185. package/src/security/execution-authority.ts +27 -0
  186. package/src/security/redact.ts +71 -0
  187. package/src/security/workspace-read-broker.ts +466 -0
  188. package/src/server/client.ts +190 -0
  189. package/src/server/preflight.ts +217 -0
  190. package/src/server/server.ts +327 -0
  191. package/src/signal-handler.ts +50 -0
  192. package/src/store/activity.ts +413 -0
  193. package/src/store/backfill-preflight.ts +49 -0
  194. package/src/store/backfill.ts +141 -0
  195. package/src/store/gc-preflight.ts +206 -0
  196. package/src/store/gc.ts +424 -0
  197. package/src/store/metrics-preflight.ts +229 -0
  198. package/src/store/metrics.ts +236 -0
  199. package/src/store/preflight.ts +748 -0
  200. package/src/store/store.ts +693 -0
  201. package/src/system-tools.ts +355 -0
  202. package/src/transport-registry.ts +1124 -0
  203. package/src/transports/claude-code-cli.ts +1348 -0
  204. package/src/transports/opencode-admission.ts +515 -0
  205. package/src/transports/opencode-client.ts +3328 -0
  206. package/src/transports/opencode-evidence.ts +557 -0
  207. package/src/transports/opencode-mcp.ts +248 -0
  208. package/src/transports/opencode-sdk.ts +2294 -0
  209. package/src/transports/opencode-server.ts +535 -0
  210. package/src/triage/adjudication.ts +113 -0
  211. package/src/triage/reply.ts +125 -0
  212. package/src/triage/triage.ts +255 -0
  213. package/src/ui/activity.ts +173 -0
  214. package/src/ui/config-edit.ts +816 -0
  215. package/src/ui/config.ts +462 -0
  216. package/src/ui/menu.ts +1325 -0
  217. package/src/ui/plan.ts +1039 -0
  218. package/src/ui/primitives.ts +300 -0
  219. package/src/ui/progress.ts +298 -0
  220. package/src/ui/result.ts +552 -0
  221. package/src/ui/review-menu.ts +312 -0
  222. package/src/ui/select.ts +528 -0
  223. package/src/ui/tree.ts +178 -0
  224. package/src/uninstaller.ts +479 -0
  225. package/src/updater.ts +836 -0
  226. package/src/usage.ts +77 -0
  227. package/src/watch/preflight.ts +1389 -0
  228. package/src/watch/watch.ts +1235 -0
  229. package/src/wizard.ts +877 -0
@@ -0,0 +1,214 @@
1
+ import os from "node:os";
2
+ import { engineIdentity } from "#git/identity";
3
+ import type { CliOptions } from "#review/preflight";
4
+ import { log } from "#ui/primitives";
5
+ import { CliError } from "../errors";
6
+ import { prheroLayout } from "../home-preflight";
7
+ import {
8
+ detectInstallMethod,
9
+ downloadReleaseBinary,
10
+ installStandaloneBinary,
11
+ PRHERO_GITHUB_REPO,
12
+ planUpgrade,
13
+ readUpgradeCache,
14
+ reconcileUpgrade,
15
+ writeUpgradeCache,
16
+ } from "../updater";
17
+
18
+ export async function upgradeCommand(options: CliOptions): Promise<number> {
19
+ const home = os.homedir();
20
+ const layout = prheroLayout(home);
21
+ const identity = await engineIdentity();
22
+ const currentVersion = identity.version;
23
+
24
+ if (options.reconcile) {
25
+ log("Reconciling agent skills, MCP registrations, and product database...");
26
+ const res = await reconcileUpgrade({ home });
27
+ if (!res.ok) {
28
+ log(
29
+ `warning: reconciliation encountered issues: ${res.errors.join("; ")}`,
30
+ );
31
+ return 1;
32
+ }
33
+ const cache = readUpgradeCache(layout.upgradeCheckPath);
34
+ if (cache) {
35
+ writeUpgradeCache(layout.upgradeCheckPath, {
36
+ ...cache,
37
+ reconciled_version: currentVersion,
38
+ });
39
+ }
40
+ log(
41
+ "✓ Reconciliation complete (skills synced, MCP verified, store ready).",
42
+ );
43
+ return 0;
44
+ }
45
+
46
+ const method = detectInstallMethod({
47
+ home,
48
+ execPath: process.execPath,
49
+ version: currentVersion,
50
+ });
51
+
52
+ // Query latest release
53
+ let latestVersion = currentVersion;
54
+ let releaseUrl = `https://github.com/${PRHERO_GITHUB_REPO}/releases/latest`;
55
+ let changelog = "";
56
+
57
+ try {
58
+ const resp = await fetch(
59
+ `https://api.github.com/repos/${PRHERO_GITHUB_REPO}/releases/latest`,
60
+ {
61
+ headers: { "User-Agent": "pr-hero-cli" },
62
+ },
63
+ );
64
+ if (resp.ok) {
65
+ const data = (await resp.json()) as {
66
+ tag_name?: string;
67
+ html_url?: string;
68
+ body?: string;
69
+ };
70
+ if (data.tag_name) {
71
+ latestVersion = data.tag_name.replace(/^v/, "");
72
+ }
73
+ if (data.html_url) releaseUrl = data.html_url;
74
+ if (data.body) changelog = data.body;
75
+
76
+ writeUpgradeCache(layout.upgradeCheckPath, {
77
+ checked_at: new Date().toISOString(),
78
+ current_version: currentVersion,
79
+ latest_version: latestVersion,
80
+ reconciled_version: currentVersion,
81
+ release_url: releaseUrl,
82
+ changelog,
83
+ });
84
+ }
85
+ } catch {
86
+ // Network failure fallback to cache
87
+ const cache = readUpgradeCache(layout.upgradeCheckPath);
88
+ if (cache?.latest_version) {
89
+ latestVersion = cache.latest_version;
90
+ }
91
+ }
92
+
93
+ if (options.check) {
94
+ log(`crysk version: v${currentVersion}`);
95
+ log(`latest release: v${latestVersion} (${releaseUrl})`);
96
+ if (currentVersion === latestVersion) {
97
+ log("✓ Crysk is up to date.");
98
+ } else {
99
+ log(`Update available! Run 'crysk upgrade' to update.`);
100
+ }
101
+ return 0;
102
+ }
103
+
104
+ const plan = await planUpgrade({
105
+ installMethod: method,
106
+ currentVersion,
107
+ targetVersion: latestVersion,
108
+ home,
109
+ });
110
+
111
+ if (plan.action === "noop_source") {
112
+ log(`info: ${plan.message}`);
113
+ log("Running asset reconciliation to keep skills & MCP in sync...");
114
+ await reconcileUpgrade({ home });
115
+ log("✓ Synced skills & MCP registrations.");
116
+ return 0;
117
+ }
118
+
119
+ if (plan.action === "up_to_date") {
120
+ log(`✓ Crysk is already up to date (v${currentVersion}).`);
121
+ log("Running asset reconciliation to keep skills & MCP in sync...");
122
+ await reconcileUpgrade({ home });
123
+ log("✓ Synced skills & MCP registrations.");
124
+ return 0;
125
+ }
126
+
127
+ if (options.dryRun) {
128
+ log("Planned upgrade steps (--dry-run):");
129
+ for (const step of plan.steps) {
130
+ log(` • ${step}`);
131
+ }
132
+ return 0;
133
+ }
134
+
135
+ if (plan.action === "upgrade_package_manager") {
136
+ log("Crysk is installed via global package manager.");
137
+ log(
138
+ `Please run: ${method.kind === "package_manager" ? method.manager : "npm"} install -g crysk@latest`,
139
+ );
140
+ // The crysk package also links the pr-hero bin, which a global install of
141
+ // the old package still owns, so that install fails until it is removed.
142
+ log(
143
+ `If the global package is still the old pr-hero one, remove it first: ${method.kind === "package_manager" ? method.manager : "npm"} uninstall -g pr-hero`,
144
+ );
145
+ return 0;
146
+ }
147
+
148
+ if (plan.action === "upgrade_standalone") {
149
+ const targetBinary = plan.targetBinary;
150
+ if (!plan.downloadUrl || !targetBinary) {
151
+ throw new CliError("Incomplete standalone upgrade plan.");
152
+ }
153
+
154
+ log(`Downloading ${plan.downloadUrl}...`);
155
+ let downloaded: Awaited<ReturnType<typeof downloadReleaseBinary>>;
156
+ try {
157
+ downloaded = await downloadReleaseBinary(plan);
158
+ } catch (error) {
159
+ throw new CliError(
160
+ error instanceof Error ? error.message : String(error),
161
+ );
162
+ }
163
+ log(`Verified SHA256 of ${downloaded.assetName}.`);
164
+
165
+ const installed = await installStandaloneBinary(
166
+ plan,
167
+ Buffer.from(downloaded.bytes),
168
+ );
169
+ if (installed.status === "rolled_back") {
170
+ throw new CliError(
171
+ "Upgrade stopped: the downloaded binary did not answer --help (it failed, or hung past 30s). Nothing installed was changed.",
172
+ );
173
+ }
174
+ if (installed.alias === "copy") {
175
+ log(
176
+ `note: could not symlink ${plan.aliasBinary}; wrote a copy instead. 'upgrade' refreshes it.`,
177
+ );
178
+ } else if (installed.alias === "failed") {
179
+ // A re-run would find crysk up to date and never reach the alias, so the
180
+ // fix is the alias itself; the run still exits non-zero (below). Plain
181
+ // `ln -sf` is not suggested: with a directory at that path it links inside
182
+ // it, exits 0 and leaves pr-hero unresolved.
183
+ log(
184
+ `warning: crysk is upgraded, but ${plan.aliasBinary} could not be updated (${installed.aliasError ?? "unknown error"}). Use 'crysk', or move whatever is at ${plan.aliasBinary} out of the way and link it again: ln -s crysk ${plan.aliasBinary}`,
185
+ );
186
+ }
187
+
188
+ log("Running reconciliation via upgraded binary...");
189
+ let exitCode = 0;
190
+ try {
191
+ const proc = Bun.spawn([targetBinary, "upgrade", "--reconcile"], {
192
+ stdout: "inherit",
193
+ stderr: "inherit",
194
+ });
195
+ exitCode = await proc.exited;
196
+ } catch {
197
+ exitCode = 1;
198
+ }
199
+
200
+ if (exitCode !== 0) {
201
+ log(
202
+ "warning: reconciliation reported errors. Run 'crysk upgrade --reconcile' to retry.",
203
+ );
204
+ return exitCode;
205
+ }
206
+ // A missing pr-hero alias is a failed upgrade for any script that calls it.
207
+ if (installed.alias === "failed") return 1;
208
+
209
+ log(`✓ Successfully upgraded Crysk to v${latestVersion}!`);
210
+ return 0;
211
+ }
212
+
213
+ return 0;
214
+ }
@@ -0,0 +1,98 @@
1
+ import { existsSync } from "node:fs";
2
+ import os from "node:os";
3
+ import { resolveRepoRoot } from "#git/git";
4
+ import type { CliOptions } from "#review/preflight";
5
+ import { queryUsage } from "#store/metrics";
6
+ import { type RunRow, renderUsage } from "#store/metrics-preflight";
7
+ import { openProductStore, queryRuns } from "#store/store";
8
+ import { log, styleEnabled } from "#ui/primitives";
9
+ import { resolveRepoHome } from "../home";
10
+ import { prheroLayout } from "../home-preflight";
11
+
12
+ // `pr-hero usage` (W4 / #23) — the thin read side of the observability
13
+ // store every completed review auto-ingests into. Origin-scoped by default
14
+ // (spec "Origin-Scoped Usage By Default"); `--all` is the operator-wide
15
+ // escape hatch and DELIBERATELY skips resolveRepoHome entirely — it must
16
+ // run from anywhere, including outside a git repo (design "usage render").
17
+ // A checkout with no resolvable origin fails/warns via the SAME CliError
18
+ // gitOriginUrl already throws (spec "No-origin checkout"): resolveRepoRoot
19
+ // still needs the cwd to be a git repo, resolveRepoHome still needs an
20
+ // origin, and neither is bypassed in scoped mode.
21
+ // The scoped-mode half of `usage`'s origin resolution, pulled out on its own
22
+ // (W4 Phase 6 remediation, GitHub #23 option D) so a no-origin checkout's
23
+ // failure path — the pre-existing CliError/missingOriginMessage that
24
+ // resolveRepoHome's gitOriginUrl call already throws — is exercisable
25
+ // directly, without needing `usageCommand`'s whole `--all`/parseArgs
26
+ // surface around it. persist:false: `usage` must never write a registry.
27
+ export async function originUsageScope(
28
+ home: string,
29
+ operatorRoot: string,
30
+ ): Promise<{ repoId: string }> {
31
+ const repoHome = await resolveRepoHome({
32
+ home,
33
+ operatorRoot,
34
+ persist: false,
35
+ });
36
+ return { repoId: repoHome.repoId };
37
+ }
38
+
39
+ export async function usageCommand(options: CliOptions): Promise<number> {
40
+ const layout = prheroLayout(os.homedir());
41
+ const scope = options.all
42
+ ? ({ all: true } as const)
43
+ : await originUsageScope(os.homedir(), await resolveRepoRoot(options.repo));
44
+
45
+ const canonicalRows = existsSync(layout.prheroDbPath)
46
+ ? (() => {
47
+ const db = openProductStore(layout.prheroDbPath);
48
+ try {
49
+ return queryRuns(db, scope);
50
+ } finally {
51
+ db.close();
52
+ }
53
+ })()
54
+ : [];
55
+
56
+ let runRows: RunRow[] = canonicalRows.map((r) => ({
57
+ repo_id: r.repo_id,
58
+ run_dir: r.run_dir,
59
+ pr: r.pr,
60
+ checkout_path: r.checkout_path,
61
+ head_sha: r.head_sha,
62
+ base_sha: r.base_sha,
63
+ run_status: r.run_status,
64
+ session_failed: r.session_failed === 1 ? 1 : 0,
65
+ model: r.model,
66
+ generated_at: r.generated_at,
67
+ wall_ms: r.wall_ms,
68
+ index_ms: r.index_ms,
69
+ tokens_in: r.tokens_in,
70
+ tokens_out: r.tokens_out,
71
+ tokens_total: r.tokens_total,
72
+ cost_usd_est: r.cost_usd_est,
73
+ blocking: r.blocking,
74
+ advisory: r.advisory,
75
+ }));
76
+
77
+ if (runRows.length === 0 && existsSync(layout.metricsDbPath)) {
78
+ runRows = queryUsage(layout.metricsDbPath, scope);
79
+ }
80
+
81
+ // An empty store is a valid state of the world (no review has ingested
82
+ // yet, or none matches this scope), not an error — same split as
83
+ // every read-only report command: a human note on stderr, stdout left clean, exit 0.
84
+ if (runRows.length === 0) {
85
+ log(
86
+ `no usage rows found in ${layout.prheroDbPath} — run \`crysk review\` or ` +
87
+ "`crysk review --pr <n>` first",
88
+ );
89
+ return 0;
90
+ }
91
+ // The report IS this command's product, same stdout/stderr split as
92
+ // every read-only report command: everything human-facing above went to stderr via log(),
93
+ // so stdout stays pipeable.
94
+ process.stdout.write(
95
+ `${renderUsage(runRows, { styles: styleEnabled() }).join("\n")}\n`,
96
+ );
97
+ return 0;
98
+ }
@@ -0,0 +1,28 @@
1
+ // Shared location rules for pr-hero findings: how a repo path is normalized and
2
+ // how wide the line window is when a finding is said to sit "near" a location.
3
+ // Re-review identity, scout lead matching, the CI review-risk path set and the
4
+ // floor-test case gate all compare paths through `normalizePath`; the floor-test
5
+ // case gate and the scout probe use `DEFAULT_LINE_WINDOW`.
6
+ //
7
+ // Pure: no I/O, no clock.
8
+
9
+ // The subset of a pr-hero `Finding` that location matching needs. Deliberately
10
+ // structural rather than an import of `Finding`: artifacts written by an older
11
+ // schema version must still be readable without failing on unrelated fields.
12
+ export interface PrHeroFindingRef {
13
+ id: string;
14
+ path: string;
15
+ line: number;
16
+ claim: string;
17
+ tier: string;
18
+ }
19
+
20
+ export const DEFAULT_LINE_WINDOW = 25;
21
+
22
+ // Normalization is intentionally minimal — trim and drop one leading `./`.
23
+ // Both sides quote repo-relative paths already; anything more aggressive
24
+ // (case folding, basename matching) would start inventing matches across
25
+ // packages/, which this monorepo has plenty of duplicate filenames in.
26
+ export function normalizePath(path: string): string {
27
+ return path.trim().replace(/^\.\//, "");
28
+ }