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.
- package/LICENSE +176 -0
- package/README.md +610 -2
- package/bin/pr-hero.js +166 -0
- package/config/models/anthropic.json +5 -0
- package/dist/SKILL-7e3725zn.md +496 -0
- package/dist/SKILL-7q35wcaz.md +66 -0
- package/dist/SKILL-9at22381.md +74 -0
- package/dist/SKILL-ex2hxxh3.md +134 -0
- package/dist/adjudicator-dtg2axnh.md +86 -0
- package/dist/admission-config.example-a9vqmmad.json +9 -0
- package/dist/ci-admission-camfbx2b.md +122 -0
- package/dist/cli.js +42292 -0
- package/dist/consolidate-ac0mnfyj.md +24 -0
- package/dist/deep-review-lifecycle-m698ybjp.md +362 -0
- package/dist/deep-review-logic-a6b1gczf.md +156 -0
- package/dist/deep-review-parity-0ec904db.md +120 -0
- package/dist/deep-review-reliability-qyakbjb9.md +125 -0
- package/dist/deep-review-resilience-3tz8y26e.md +118 -0
- package/dist/index.js +20190 -0
- package/dist/opencode-ci-7b0be64p.md +141 -0
- package/dist/review-refuter-j4e9gezy.md +71 -0
- package/dist/scout-yvp153q7.md +140 -0
- package/dist/summarizer-zca44nxa.md +18 -0
- package/dist/workflow-w1g9szna.yml +151 -0
- package/package.json +82 -4
- package/prompts/consolidate.md +24 -0
- package/prompts/default/PROVENANCE.md +18 -0
- package/prompts/default/deep-review-lifecycle.md +362 -0
- package/prompts/default/deep-review-logic.md +156 -0
- package/prompts/default/deep-review-parity.md +120 -0
- package/prompts/default/deep-review-reliability.md +125 -0
- package/prompts/default/deep-review-resilience.md +118 -0
- package/prompts/default/review-refuter.md +71 -0
- package/prompts/scout.md +140 -0
- package/prompts/summarizer.md +18 -0
- package/skills/crysk/SKILL.md +74 -0
- package/skills/crysk-ci-setup/SKILL.md +134 -0
- package/skills/crysk-ci-setup/assets/admission-config.example.json +9 -0
- package/skills/crysk-ci-setup/assets/workflow.yml +151 -0
- package/skills/crysk-ci-setup/references/ci-admission.md +122 -0
- package/skills/crysk-ci-setup/references/opencode-ci.md +141 -0
- package/skills/crysk-loop/SKILL.md +496 -0
- package/skills/crysk-loop/adjudicator.md +86 -0
- package/skills/crysk-pr/SKILL.md +66 -0
- package/src/agent-env.ts +1084 -0
- package/src/asset-manifest.ts +83 -0
- package/src/assets.d.ts +6 -0
- package/src/assets.ts +183 -0
- package/src/brand-paths.ts +155 -0
- package/src/brand.ts +255 -0
- package/src/ci/admission-ledger.ts +350 -0
- package/src/ci/classify-error.ts +73 -0
- package/src/ci/cli-record.ts +271 -0
- package/src/ci/force-comment.ts +39 -0
- package/src/ci/gates.ts +923 -0
- package/src/ci/outcome.ts +2181 -0
- package/src/ci/override.ts +187 -0
- package/src/ci/publish.ts +1639 -0
- package/src/ci/reporter.ts +626 -0
- package/src/ci/review-admission.ts +901 -0
- package/src/ci/review-levels.ts +310 -0
- package/src/ci/review-policy.ts +18 -0
- package/src/ci/review-risk.ts +184 -0
- package/src/ci/setup.ts +844 -0
- package/src/ci/trigger.ts +1353 -0
- package/src/cli.ts +348 -0
- package/src/commands/activity.ts +67 -0
- package/src/commands/ci-setup-questions.ts +397 -0
- package/src/commands/ci-setup.ts +381 -0
- package/src/commands/config.ts +99 -0
- package/src/commands/doctor.ts +108 -0
- package/src/commands/init.ts +139 -0
- package/src/commands/mcp.ts +10 -0
- package/src/commands/menu.ts +129 -0
- package/src/commands/post.ts +302 -0
- package/src/commands/skills.ts +83 -0
- package/src/commands/status.ts +173 -0
- package/src/commands/triage.ts +342 -0
- package/src/commands/uninstall.ts +37 -0
- package/src/commands/upgrade.ts +214 -0
- package/src/commands/usage.ts +98 -0
- package/src/compare/compare.ts +28 -0
- package/src/compare/floor-test.ts +471 -0
- package/src/compare/martian-adapter.ts +80 -0
- package/src/config/config.ts +267 -0
- package/src/corpus/corpus.ts +1094 -0
- package/src/corpus/preflight.ts +1789 -0
- package/src/diversity/accounting.ts +90 -0
- package/src/diversity/adjudication.ts +145 -0
- package/src/diversity/admission.ts +60 -0
- package/src/diversity/benchmark.ts +195 -0
- package/src/diversity/clustering.ts +285 -0
- package/src/diversity/errors.ts +7 -0
- package/src/diversity/identity.ts +285 -0
- package/src/diversity/index.ts +11 -0
- package/src/diversity/pipeline-integration.ts +448 -0
- package/src/diversity/projection.ts +57 -0
- package/src/diversity/self-contained.ts +68 -0
- package/src/diversity/target-validation.ts +179 -0
- package/src/doctor-migration.ts +209 -0
- package/src/doctor.ts +723 -0
- package/src/errors.ts +83 -0
- package/src/execution/admission.ts +75 -0
- package/src/execution/atomic-write.ts +35 -0
- package/src/execution/attempt-evidence.ts +415 -0
- package/src/execution/bucket-id.ts +136 -0
- package/src/execution/concurrency-limiter.ts +175 -0
- package/src/execution/contracts.ts +443 -0
- package/src/execution/failure-classification.ts +42 -0
- package/src/execution/failure-policy.ts +240 -0
- package/src/execution/harness.ts +2548 -0
- package/src/execution/settlement.ts +348 -0
- package/src/execution/spawned-process.ts +66 -0
- package/src/execution/spend-limiter.ts +424 -0
- package/src/execution/step-artifacts.ts +55 -0
- package/src/execution/usage-normalized.ts +469 -0
- package/src/git/git.ts +396 -0
- package/src/git/identity.ts +64 -0
- package/src/git/refs.ts +140 -0
- package/src/home-preflight.ts +443 -0
- package/src/home.ts +243 -0
- package/src/ignore-file.ts +336 -0
- package/src/ignore-read.ts +118 -0
- package/src/index.ts +34 -0
- package/src/legacy-launchd.ts +29 -0
- package/src/mcp/mcp.ts +150 -0
- package/src/mcp/preflight.ts +407 -0
- package/src/menu-context.ts +192 -0
- package/src/model/catalog.ts +251 -0
- package/src/model/exec-snapshots.ts +390 -0
- package/src/model/free-discovery.ts +302 -0
- package/src/model/provider-capabilities.ts +814 -0
- package/src/model/routing.ts +600 -0
- package/src/pr/admission.ts +847 -0
- package/src/pr/ci-admission-gate.ts +665 -0
- package/src/pr/ci-publish.ts +76 -0
- package/src/pr/discovery.ts +432 -0
- package/src/pr/inline.ts +507 -0
- package/src/pr/plan.ts +366 -0
- package/src/pr/posting.ts +115 -0
- package/src/pr/pr-status.ts +787 -0
- package/src/pr/pr.ts +3642 -0
- package/src/pr/preflight.ts +1031 -0
- package/src/pr/publish-outcome.ts +361 -0
- package/src/pr/range.ts +119 -0
- package/src/pr/reverts-preflight.ts +606 -0
- package/src/pr/reverts.ts +377 -0
- package/src/pr/review-pr.ts +927 -0
- package/src/pr/status.ts +154 -0
- package/src/pr/target.ts +388 -0
- package/src/pr/teardown.ts +437 -0
- package/src/pr/worktree-setup.ts +60 -0
- package/src/production-runtime.ts +1877 -0
- package/src/progress.ts +487 -0
- package/src/rereview/adjudicate.ts +89 -0
- package/src/rereview/classify.ts +362 -0
- package/src/rereview/identity.ts +211 -0
- package/src/rereview/plan.ts +308 -0
- package/src/rereview/prepare.ts +1025 -0
- package/src/rereview/state.ts +767 -0
- package/src/rereview/verify.ts +241 -0
- package/src/review/boundary.ts +105 -0
- package/src/review/consolidate.ts +246 -0
- package/src/review/dedupe.ts +368 -0
- package/src/review/drafts.ts +448 -0
- package/src/review/findings-conformance.ts +120 -0
- package/src/review/findings.ts +714 -0
- package/src/review/pipeline.ts +3977 -0
- package/src/review/preflight.ts +3575 -0
- package/src/review/prompt-set.ts +177 -0
- package/src/review/proof-refs.ts +187 -0
- package/src/review/report.ts +1821 -0
- package/src/review/review.ts +490 -0
- package/src/review/root-cause.ts +120 -0
- package/src/review/route-preflight.ts +289 -0
- package/src/review/run.ts +601 -0
- package/src/review/scout.ts +323 -0
- package/src/review/size-gate.ts +595 -0
- package/src/review/spec.ts +235 -0
- package/src/review/step-runner.ts +233 -0
- package/src/runner-authority.ts +596 -0
- package/src/security/binding-policy.ts +115 -0
- package/src/security/credential-broker.ts +773 -0
- package/src/security/evidence-redaction.ts +62 -0
- package/src/security/execution-authority.ts +27 -0
- package/src/security/redact.ts +71 -0
- package/src/security/workspace-read-broker.ts +466 -0
- package/src/server/client.ts +190 -0
- package/src/server/preflight.ts +217 -0
- package/src/server/server.ts +327 -0
- package/src/signal-handler.ts +50 -0
- package/src/store/activity.ts +413 -0
- package/src/store/backfill-preflight.ts +49 -0
- package/src/store/backfill.ts +141 -0
- package/src/store/gc-preflight.ts +206 -0
- package/src/store/gc.ts +424 -0
- package/src/store/metrics-preflight.ts +229 -0
- package/src/store/metrics.ts +236 -0
- package/src/store/preflight.ts +748 -0
- package/src/store/store.ts +693 -0
- package/src/system-tools.ts +355 -0
- package/src/transport-registry.ts +1124 -0
- package/src/transports/claude-code-cli.ts +1348 -0
- package/src/transports/opencode-admission.ts +515 -0
- package/src/transports/opencode-client.ts +3328 -0
- package/src/transports/opencode-evidence.ts +557 -0
- package/src/transports/opencode-mcp.ts +248 -0
- package/src/transports/opencode-sdk.ts +2294 -0
- package/src/transports/opencode-server.ts +535 -0
- package/src/triage/adjudication.ts +113 -0
- package/src/triage/reply.ts +125 -0
- package/src/triage/triage.ts +255 -0
- package/src/ui/activity.ts +173 -0
- package/src/ui/config-edit.ts +816 -0
- package/src/ui/config.ts +462 -0
- package/src/ui/menu.ts +1325 -0
- package/src/ui/plan.ts +1039 -0
- package/src/ui/primitives.ts +300 -0
- package/src/ui/progress.ts +298 -0
- package/src/ui/result.ts +552 -0
- package/src/ui/review-menu.ts +312 -0
- package/src/ui/select.ts +528 -0
- package/src/ui/tree.ts +178 -0
- package/src/uninstaller.ts +479 -0
- package/src/updater.ts +836 -0
- package/src/usage.ts +77 -0
- package/src/watch/preflight.ts +1389 -0
- package/src/watch/watch.ts +1235 -0
- 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
|
+
}
|