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,187 @@
1
+ // The override rule (docs/github-actions.md, "Overriding a red gate"), in one place. Two
2
+ // writers of a review's verdict apply it: the CLI's final commit status write
3
+ // (src/pr/teardown.ts) and the publisher's repost of a status the CLI could not write
4
+ // (src/ci/publish.ts). They must give the same answer, so both import it from here.
5
+ //
6
+ // WHY ONLY BUILTINS AND ../brand: publish.ts runs before dependencies are installed, so it
7
+ // cannot import a package, and it imports this module. The rule needs nothing outside the
8
+ // language, and ../brand itself imports nothing, so it is the one module this file may load.
9
+ import {
10
+ canonicalStatusText,
11
+ isLegacyStatusContext,
12
+ isStatusContext,
13
+ STATUS_CONTEXT,
14
+ statusContextForms,
15
+ } from "../brand";
16
+
17
+ // The start of an override's status description. The publisher writes an override with
18
+ // it, and this rule recognises an override by it. An override an older action wrote starts
19
+ // `pr-hero: overridden by @`; readers rewrite that lead (canonicalStatusText) before they
20
+ // compare, so this one prefix serves both.
21
+ export const OVERRIDE_DESCRIPTION_PREFIX = `${STATUS_CONTEXT}: overridden by @`;
22
+
23
+ // The context both the review's verdict and an override are written on. It is brand's
24
+ // STATUS_CONTEXT, the one preflight.ts's COMMIT_STATUS_CONTEXT also is; a drift test pins
25
+ // the two together (test/ci/override.test.ts). A row on the legacy `pr-hero` name counts
26
+ // as the same context (newestStatusInContext).
27
+ export const OVERRIDE_STATUS_CONTEXT = STATUS_CONTEXT;
28
+
29
+ // WHY the allowance: a run's start is read on the runner's clock, and GitHub's created_at
30
+ // is server time, so the two can differ by a few seconds. Without the allowance an
31
+ // override posted in the run's first moments would read as posted before the run and be
32
+ // overwritten. The error is taken toward the human's explicit decision: a review that is
33
+ // deemed to start a few seconds early leaves a fresh override standing, while a missed
34
+ // override overwrites a deliberate unlock. created_at has one-second precision, which the
35
+ // same allowance already covers.
36
+ //
37
+ // WHY it is only taken when the run's own pending status landed: the allowance is safe only
38
+ // while something in the run witnesses the start, and the CLI's own pending status is that
39
+ // witness. When that pending did not land, no pr-hero status vouches for the start, and the
40
+ // cutoff is the start itself (overrideCutoffMs).
41
+ const OVERRIDE_CLOCK_SKEW_ALLOWANCE_MS = 5_000;
42
+
43
+ // The override cutoff: the instant at or after which an override counts as posted during the
44
+ // run. The CLI computes it ONCE, from its own start and whether its pending landed (teardown.ts),
45
+ // and records it (override_cutoff_ms, src/ci/cli-record.ts). The publisher reads that recorded
46
+ // cutoff and never re-derives it, so the two writers cannot disagree about the same override.
47
+ //
48
+ // WHY the start less the allowance when the pending landed: the pending is the witness that the
49
+ // start is on the head's timeline, so the skew allowance may widen the window (see above).
50
+ // WHY the start itself when it did not: nothing vouches for the start, so an override created a
51
+ // few seconds before it is not one posted during the run, and it must not stand over the run.
52
+ export function overrideCutoffMs(
53
+ runStartedMs: number,
54
+ pendingLanded: boolean,
55
+ ): number {
56
+ return pendingLanded
57
+ ? runStartedMs - OVERRIDE_CLOCK_SKEW_ALLOWANCE_MS
58
+ : runStartedMs;
59
+ }
60
+
61
+ // The fields of a commit status the rule reads. A status the reader did not describe has
62
+ // no description, and is never taken as an override.
63
+ export interface OverrideStatusFact {
64
+ state: string;
65
+ context: string;
66
+ created_at: string;
67
+ description?: string | null;
68
+ }
69
+
70
+ // Whether one status is an override: a success whose description carries the override
71
+ // prefix. This is the single test both writers and the status reader use, so none of them
72
+ // can recognise an override by a different rule. A status without a description is never one.
73
+ export function isOverrideStatus(status: OverrideStatusFact): boolean {
74
+ return (
75
+ status.state === "success" &&
76
+ typeof status.description === "string" &&
77
+ canonicalStatusText(status.description).startsWith(
78
+ OVERRIDE_DESCRIPTION_PREFIX,
79
+ )
80
+ );
81
+ }
82
+
83
+ // Whether an override stands over a review, given the review's override cutoff. The override
84
+ // stands when the newest OVERRIDE_STATUS_CONTEXT status is a successful override created at or
85
+ // after cutoffMs. A later review has posted its own status since, which is then the newest, so
86
+ // this is false and its write goes ahead.
87
+ //
88
+ // WHY no allowance here: the cutoff already carries the decision (overrideCutoffMs). Both
89
+ // writers compare with the same cutoff and nothing else.
90
+ //
91
+ // WHY the rule guards a verdict write only (`success` or `failure`): an `error` write is a
92
+ // failed review (every hunter failed, a cancel, a crash), and it may replace an override.
93
+ // The CLI checks the write's state before it calls this (teardown.ts). The publisher's
94
+ // repost is a verdict by construction: the CLI records only `success` or `failure` as an
95
+ // unsettled status, and the repost writes that record (publish.ts).
96
+ //
97
+ // WHY the state too: an override is a success. A status that merely carries the
98
+ // description (a failure or a pending one) is not an override, and must not hold the gate
99
+ // open over a review that finished.
100
+ export function overrideStandsOverRun(
101
+ statuses: readonly OverrideStatusFact[],
102
+ cutoffMs: number,
103
+ ): boolean {
104
+ const latest = newestStatusInContext(statuses, OVERRIDE_STATUS_CONTEXT);
105
+ if (latest === undefined || !isOverrideStatus(latest)) return false;
106
+ const createdMs = Date.parse(latest.created_at);
107
+ if (Number.isNaN(createdMs)) return false;
108
+ return createdMs >= cutoffMs;
109
+ }
110
+
111
+ // The login an override was written by: the text after the prefix up to the first space. The
112
+ // publisher writes `crysk: overridden by @<login> — no new review run` (an older action
113
+ // wrote `pr-hero: …`, which reads the same), and a GitHub login has no space, so this is the
114
+ // login exactly. Null when the description is not an override or names no one.
115
+ export function overrideActorOf(description: string): string | null {
116
+ const text = canonicalStatusText(description);
117
+ if (!text.startsWith(OVERRIDE_DESCRIPTION_PREFIX)) return null;
118
+ const actor = text.slice(OVERRIDE_DESCRIPTION_PREFIX.length).split(" ")[0];
119
+ return actor === undefined || actor === "" ? null : actor;
120
+ }
121
+
122
+ // The newest status of one context by created_at: a row whose time does not parse is skipped.
123
+ // A tie goes to the row that comes first in the array. GitHub's status LIST is newest-first, so
124
+ // the first of two same-second rows is the newer one: `[success@t, failure@t]` reads as success.
125
+ // The combined endpoint has one row per context, so it never ties. This is the same selection
126
+ // as preflight.ts's latestStatusInContext except on a tie, where that one takes the later row
127
+ // (`>=`). This module cannot import it. The publisher's reads use this one too.
128
+ //
129
+ // WHY one context means two names: for one version the gate is written on `crysk` and on the
130
+ // legacy `pr-hero`, and an older action still writes only `pr-hero`. The newest row across both
131
+ // names is the gate, so an override posted by an older action still beats a newer-version
132
+ // verdict that is older than it. Two rows with the same time are a pair one run wrote, with
133
+ // identical content, so either would do; the crysk row is taken so the answer never depends
134
+ // on the order of the list.
135
+ // A half-landed pair. Every write posts both names, so a name whose newest row is still
136
+ // pending while the other name holds a later settled row missed that write. The settled
137
+ // row is the verdict (a finished review, or a human's override), and the stuck name is
138
+ // what a repair copies it onto. Undefined when the two names agree.
139
+ export function strandedStatusPair<T extends OverrideStatusFact>(
140
+ statuses: readonly T[],
141
+ context: string,
142
+ ): { stranded: T; verdict: T } | undefined {
143
+ const [first, second] = statusContextForms(context).map((name) =>
144
+ newestStatusInContext(
145
+ statuses.filter((status) => status.context === name),
146
+ context,
147
+ ),
148
+ );
149
+ for (const [stranded, verdict] of [
150
+ [first, second],
151
+ [second, first],
152
+ ]) {
153
+ if (
154
+ stranded?.state === "pending" &&
155
+ verdict !== undefined &&
156
+ verdict.state !== "pending" &&
157
+ Date.parse(verdict.created_at) >= Date.parse(stranded.created_at)
158
+ ) {
159
+ return { stranded, verdict };
160
+ }
161
+ }
162
+ return undefined;
163
+ }
164
+
165
+ export function newestStatusInContext<T extends OverrideStatusFact>(
166
+ statuses: readonly T[],
167
+ context: string,
168
+ ): T | undefined {
169
+ let latest: T | undefined;
170
+ let latestMs = Number.NEGATIVE_INFINITY;
171
+ for (const status of statuses) {
172
+ if (!isStatusContext(status.context, context)) continue;
173
+ const createdMs = Date.parse(status.created_at);
174
+ if (Number.isNaN(createdMs)) continue;
175
+ const newer =
176
+ createdMs > latestMs ||
177
+ (createdMs === latestMs &&
178
+ latest !== undefined &&
179
+ isLegacyStatusContext(latest.context) &&
180
+ !isLegacyStatusContext(status.context));
181
+ if (newer) {
182
+ latest = status;
183
+ latestMs = createdMs;
184
+ }
185
+ }
186
+ return latest;
187
+ }