crysk 0.0.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (233) hide show
  1. package/LICENSE +176 -0
  2. package/README.md +611 -3
  3. package/bin/pr-hero.js +166 -0
  4. package/config/models/anthropic.json +5 -0
  5. package/dist/SKILL-7e3725zn.md +496 -0
  6. package/dist/SKILL-7q35wcaz.md +66 -0
  7. package/dist/SKILL-9at22381.md +74 -0
  8. package/dist/SKILL-ex2hxxh3.md +134 -0
  9. package/dist/SKILL-y8rv8msh.md +134 -0
  10. package/dist/SKILL-ygka1bs0.md +515 -0
  11. package/dist/adjudicator-dtg2axnh.md +86 -0
  12. package/dist/admission-config.example-a9vqmmad.json +9 -0
  13. package/dist/ci-admission-camfbx2b.md +122 -0
  14. package/dist/ci-admission-qk9r9taq.md +124 -0
  15. package/dist/cli.js +42501 -0
  16. package/dist/consolidate-ac0mnfyj.md +24 -0
  17. package/dist/deep-review-lifecycle-m698ybjp.md +362 -0
  18. package/dist/deep-review-logic-a6b1gczf.md +156 -0
  19. package/dist/deep-review-parity-0ec904db.md +120 -0
  20. package/dist/deep-review-reliability-qyakbjb9.md +125 -0
  21. package/dist/deep-review-resilience-3tz8y26e.md +118 -0
  22. package/dist/index.js +20190 -0
  23. package/dist/opencode-ci-7b0be64p.md +141 -0
  24. package/dist/review-refuter-j4e9gezy.md +71 -0
  25. package/dist/scout-yvp153q7.md +140 -0
  26. package/dist/summarizer-zca44nxa.md +18 -0
  27. package/dist/workflow-w1g9szna.yml +151 -0
  28. package/package.json +81 -4
  29. package/prompts/consolidate.md +24 -0
  30. package/prompts/default/PROVENANCE.md +18 -0
  31. package/prompts/default/deep-review-lifecycle.md +362 -0
  32. package/prompts/default/deep-review-logic.md +156 -0
  33. package/prompts/default/deep-review-parity.md +120 -0
  34. package/prompts/default/deep-review-reliability.md +125 -0
  35. package/prompts/default/deep-review-resilience.md +118 -0
  36. package/prompts/default/review-refuter.md +71 -0
  37. package/prompts/scout.md +140 -0
  38. package/prompts/summarizer.md +18 -0
  39. package/skills/crysk/SKILL.md +74 -0
  40. package/skills/crysk-ci-setup/SKILL.md +134 -0
  41. package/skills/crysk-ci-setup/assets/admission-config.example.json +9 -0
  42. package/skills/crysk-ci-setup/assets/workflow.yml +151 -0
  43. package/skills/crysk-ci-setup/references/ci-admission.md +124 -0
  44. package/skills/crysk-ci-setup/references/opencode-ci.md +141 -0
  45. package/skills/crysk-loop/SKILL.md +515 -0
  46. package/skills/crysk-loop/adjudicator.md +86 -0
  47. package/skills/crysk-pr/SKILL.md +66 -0
  48. package/src/agent-env.ts +1084 -0
  49. package/src/asset-manifest.ts +83 -0
  50. package/src/assets.d.ts +6 -0
  51. package/src/assets.ts +183 -0
  52. package/src/brand-paths.ts +155 -0
  53. package/src/brand.ts +255 -0
  54. package/src/ci/admission-ledger.ts +350 -0
  55. package/src/ci/classify-error.ts +73 -0
  56. package/src/ci/cli-record.ts +271 -0
  57. package/src/ci/force-comment.ts +39 -0
  58. package/src/ci/gates.ts +945 -0
  59. package/src/ci/outcome.ts +2181 -0
  60. package/src/ci/override.ts +187 -0
  61. package/src/ci/publish.ts +1639 -0
  62. package/src/ci/reporter.ts +626 -0
  63. package/src/ci/review-admission.ts +910 -0
  64. package/src/ci/review-levels.ts +310 -0
  65. package/src/ci/review-policy.ts +18 -0
  66. package/src/ci/review-risk.ts +184 -0
  67. package/src/ci/setup.ts +844 -0
  68. package/src/ci/trigger.ts +1353 -0
  69. package/src/cli.ts +348 -0
  70. package/src/commands/activity.ts +67 -0
  71. package/src/commands/ci-setup-questions.ts +397 -0
  72. package/src/commands/ci-setup.ts +381 -0
  73. package/src/commands/config.ts +99 -0
  74. package/src/commands/doctor.ts +108 -0
  75. package/src/commands/init.ts +139 -0
  76. package/src/commands/mcp.ts +10 -0
  77. package/src/commands/menu.ts +129 -0
  78. package/src/commands/post.ts +302 -0
  79. package/src/commands/skills.ts +83 -0
  80. package/src/commands/status.ts +173 -0
  81. package/src/commands/triage.ts +342 -0
  82. package/src/commands/uninstall.ts +37 -0
  83. package/src/commands/upgrade.ts +214 -0
  84. package/src/commands/usage.ts +98 -0
  85. package/src/compare/compare.ts +28 -0
  86. package/src/compare/floor-test.ts +471 -0
  87. package/src/compare/martian-adapter.ts +80 -0
  88. package/src/config/config.ts +267 -0
  89. package/src/corpus/corpus.ts +1094 -0
  90. package/src/corpus/preflight.ts +1789 -0
  91. package/src/diversity/accounting.ts +90 -0
  92. package/src/diversity/adjudication.ts +145 -0
  93. package/src/diversity/admission.ts +60 -0
  94. package/src/diversity/benchmark.ts +195 -0
  95. package/src/diversity/clustering.ts +285 -0
  96. package/src/diversity/errors.ts +7 -0
  97. package/src/diversity/identity.ts +285 -0
  98. package/src/diversity/index.ts +11 -0
  99. package/src/diversity/pipeline-integration.ts +448 -0
  100. package/src/diversity/projection.ts +57 -0
  101. package/src/diversity/self-contained.ts +68 -0
  102. package/src/diversity/target-validation.ts +179 -0
  103. package/src/doctor-migration.ts +209 -0
  104. package/src/doctor.ts +723 -0
  105. package/src/errors.ts +83 -0
  106. package/src/execution/admission.ts +75 -0
  107. package/src/execution/atomic-write.ts +35 -0
  108. package/src/execution/attempt-evidence.ts +415 -0
  109. package/src/execution/bucket-id.ts +136 -0
  110. package/src/execution/concurrency-limiter.ts +175 -0
  111. package/src/execution/contracts.ts +443 -0
  112. package/src/execution/failure-classification.ts +42 -0
  113. package/src/execution/failure-policy.ts +240 -0
  114. package/src/execution/harness.ts +2548 -0
  115. package/src/execution/settlement.ts +348 -0
  116. package/src/execution/spawned-process.ts +66 -0
  117. package/src/execution/spend-limiter.ts +424 -0
  118. package/src/execution/step-artifacts.ts +55 -0
  119. package/src/execution/usage-normalized.ts +469 -0
  120. package/src/git/git.ts +396 -0
  121. package/src/git/identity.ts +64 -0
  122. package/src/git/refs.ts +140 -0
  123. package/src/home-preflight.ts +443 -0
  124. package/src/home.ts +243 -0
  125. package/src/ignore-file.ts +336 -0
  126. package/src/ignore-read.ts +118 -0
  127. package/src/index.ts +34 -0
  128. package/src/legacy-launchd.ts +29 -0
  129. package/src/mcp/mcp.ts +150 -0
  130. package/src/mcp/preflight.ts +407 -0
  131. package/src/menu-context.ts +192 -0
  132. package/src/model/catalog.ts +251 -0
  133. package/src/model/exec-snapshots.ts +390 -0
  134. package/src/model/free-discovery.ts +302 -0
  135. package/src/model/provider-capabilities.ts +814 -0
  136. package/src/model/routing.ts +600 -0
  137. package/src/pr/admission.ts +984 -0
  138. package/src/pr/answered-findings.ts +169 -0
  139. package/src/pr/ci-admission-gate.ts +743 -0
  140. package/src/pr/ci-publish.ts +76 -0
  141. package/src/pr/discovery.ts +432 -0
  142. package/src/pr/inline.ts +507 -0
  143. package/src/pr/plan.ts +366 -0
  144. package/src/pr/posting.ts +115 -0
  145. package/src/pr/pr-status.ts +845 -0
  146. package/src/pr/pr.ts +3642 -0
  147. package/src/pr/preflight.ts +1031 -0
  148. package/src/pr/publish-outcome.ts +361 -0
  149. package/src/pr/range.ts +119 -0
  150. package/src/pr/reverts-preflight.ts +606 -0
  151. package/src/pr/reverts.ts +377 -0
  152. package/src/pr/review-pr.ts +927 -0
  153. package/src/pr/status.ts +154 -0
  154. package/src/pr/target.ts +388 -0
  155. package/src/pr/teardown.ts +437 -0
  156. package/src/pr/worktree-setup.ts +60 -0
  157. package/src/production-runtime.ts +1877 -0
  158. package/src/progress.ts +487 -0
  159. package/src/rereview/adjudicate.ts +89 -0
  160. package/src/rereview/classify.ts +362 -0
  161. package/src/rereview/identity.ts +211 -0
  162. package/src/rereview/plan.ts +308 -0
  163. package/src/rereview/prepare.ts +1025 -0
  164. package/src/rereview/state.ts +767 -0
  165. package/src/rereview/verify.ts +241 -0
  166. package/src/review/boundary.ts +105 -0
  167. package/src/review/consolidate.ts +246 -0
  168. package/src/review/dedupe.ts +368 -0
  169. package/src/review/drafts.ts +448 -0
  170. package/src/review/findings-conformance.ts +120 -0
  171. package/src/review/findings.ts +714 -0
  172. package/src/review/pipeline.ts +3977 -0
  173. package/src/review/preflight.ts +3575 -0
  174. package/src/review/prompt-set.ts +177 -0
  175. package/src/review/proof-refs.ts +187 -0
  176. package/src/review/report.ts +1821 -0
  177. package/src/review/review.ts +490 -0
  178. package/src/review/root-cause.ts +120 -0
  179. package/src/review/route-preflight.ts +289 -0
  180. package/src/review/run.ts +601 -0
  181. package/src/review/scout.ts +323 -0
  182. package/src/review/size-gate.ts +595 -0
  183. package/src/review/spec.ts +235 -0
  184. package/src/review/step-runner.ts +233 -0
  185. package/src/runner-authority.ts +596 -0
  186. package/src/security/binding-policy.ts +115 -0
  187. package/src/security/credential-broker.ts +773 -0
  188. package/src/security/evidence-redaction.ts +62 -0
  189. package/src/security/execution-authority.ts +27 -0
  190. package/src/security/redact.ts +71 -0
  191. package/src/security/workspace-read-broker.ts +466 -0
  192. package/src/server/client.ts +190 -0
  193. package/src/server/preflight.ts +217 -0
  194. package/src/server/server.ts +327 -0
  195. package/src/signal-handler.ts +50 -0
  196. package/src/store/activity.ts +413 -0
  197. package/src/store/backfill-preflight.ts +49 -0
  198. package/src/store/backfill.ts +141 -0
  199. package/src/store/gc-preflight.ts +206 -0
  200. package/src/store/gc.ts +424 -0
  201. package/src/store/metrics-preflight.ts +229 -0
  202. package/src/store/metrics.ts +236 -0
  203. package/src/store/preflight.ts +748 -0
  204. package/src/store/store.ts +693 -0
  205. package/src/system-tools.ts +355 -0
  206. package/src/transport-registry.ts +1124 -0
  207. package/src/transports/claude-code-cli.ts +1348 -0
  208. package/src/transports/opencode-admission.ts +515 -0
  209. package/src/transports/opencode-client.ts +3328 -0
  210. package/src/transports/opencode-evidence.ts +557 -0
  211. package/src/transports/opencode-mcp.ts +248 -0
  212. package/src/transports/opencode-sdk.ts +2294 -0
  213. package/src/transports/opencode-server.ts +535 -0
  214. package/src/triage/adjudication.ts +113 -0
  215. package/src/triage/reply.ts +125 -0
  216. package/src/triage/triage.ts +255 -0
  217. package/src/ui/activity.ts +173 -0
  218. package/src/ui/config-edit.ts +816 -0
  219. package/src/ui/config.ts +462 -0
  220. package/src/ui/menu.ts +1325 -0
  221. package/src/ui/plan.ts +1039 -0
  222. package/src/ui/primitives.ts +300 -0
  223. package/src/ui/progress.ts +298 -0
  224. package/src/ui/result.ts +552 -0
  225. package/src/ui/review-menu.ts +312 -0
  226. package/src/ui/select.ts +528 -0
  227. package/src/ui/tree.ts +178 -0
  228. package/src/uninstaller.ts +479 -0
  229. package/src/updater.ts +836 -0
  230. package/src/usage.ts +77 -0
  231. package/src/watch/preflight.ts +1389 -0
  232. package/src/watch/watch.ts +1235 -0
  233. package/src/wizard.ts +877 -0
package/bin/pr-hero.js ADDED
@@ -0,0 +1,166 @@
1
+ #!/usr/bin/env node
2
+ // Entry point for `npx pr-hero`, `bun install -g pr-hero`, and a checkout.
3
+ // This file runs under Node (npx on a machine without Bun) or under Bun
4
+ // (bun install -g, a checkout). The runtime is detected at the top and each
5
+ // branch is self-contained.
6
+ //
7
+ // Under Bun, this file is always reached via `import`, so `import.meta.main`
8
+ // inside cli.ts is always false here: we must invoke the exported runCli()
9
+ // ourselves instead of relying on cli.ts's own `if (import.meta.main)` guard,
10
+ // which only fires for a directly executed entry file (e.g. `bun run
11
+ // src/cli.ts`).
12
+ //
13
+ // Under Node, the TypeScript CLI cannot be imported, so this file spawns Bun
14
+ // on src/cli.ts instead, where cli.ts's own `import.meta.main` guard fires
15
+ // because cli.ts is the directly executed entry. Bun is the bundled
16
+ // dependency (node_modules/bun) when present, otherwise `bun` on PATH.
17
+ import { spawn, spawnSync } from "node:child_process";
18
+ import fs from "node:fs";
19
+ import { createRequire } from "node:module";
20
+ import path from "node:path";
21
+ import { fileURLToPath } from "node:url";
22
+
23
+ if (typeof globalThis.Bun !== "undefined") {
24
+ const { runCli } = await import("../src/cli.ts");
25
+ await runCli();
26
+ } else {
27
+ launchOnBun();
28
+ }
29
+
30
+ function launchOnBun() {
31
+ const here = path.dirname(fileURLToPath(import.meta.url));
32
+ const cli = path.join(here, "..", "src", "cli.ts");
33
+ const { bun, tried } = chooseBun(here);
34
+
35
+ if (bun === null) {
36
+ if (tried.length === 0) {
37
+ process.stderr.write(
38
+ "crysk: Bun was not found. Crysk runs on Bun (>= 1.3): install it from https://bun.sh, or install Crysk with npm i -g crysk.\n",
39
+ );
40
+ } else {
41
+ process.stderr.write(
42
+ `crysk: no working Bun. Tried ${tried.join(" and ")}; neither ran \`bun --version\`. Fix: npm i -g bun, install Bun from https://bun.sh, or reinstall crysk.\n`,
43
+ );
44
+ }
45
+ process.exit(127);
46
+ }
47
+
48
+ const child = spawn(bun, [cli, ...process.argv.slice(2)], {
49
+ stdio: "inherit",
50
+ });
51
+
52
+ // WHY: without forwarding, a Node parent killed by SIGTERM exits and orphans
53
+ // the Bun child, which keeps running with nobody waiting on it.
54
+ // SIGINT on a TTY is not forwarded: the child shares the terminal's process
55
+ // group, so Ctrl+C already reaches it, and a second SIGINT would cut short the
56
+ // CLI's own async cancellation (lock release, commit-status settle). The parent
57
+ // only ignores it there, so it waits for the child's exit.
58
+ // Without a TTY (CI, a pipe, a supervisor that signals only the launcher's pid)
59
+ // nothing else delivers it, so the parent must forward it or the CLI runs on.
60
+ const onInterrupt = () => {
61
+ if (shouldForwardSigint(process.stdin.isTTY)) child.kill("SIGINT");
62
+ };
63
+ process.on("SIGINT", onInterrupt);
64
+ const forwarded = ["SIGTERM", "SIGHUP"];
65
+ const handlers = new Map([["SIGINT", onInterrupt]]);
66
+ for (const sig of forwarded) {
67
+ const handler = () => child.kill(sig);
68
+ handlers.set(sig, handler);
69
+ process.on(sig, handler);
70
+ }
71
+
72
+ child.on("error", (err) => {
73
+ process.stderr.write(
74
+ `crysk: could not start Bun (${err.code ?? err.message})\n`,
75
+ );
76
+ process.exit(127);
77
+ });
78
+
79
+ child.on("exit", (code, signal) => {
80
+ if (signal) {
81
+ // WHY: re-raising the child's signal makes this process's exit status
82
+ // match the child's, so callers see the same termination cause.
83
+ for (const [sig, handler] of handlers)
84
+ process.removeListener(sig, handler);
85
+ process.kill(process.pid, signal);
86
+ return;
87
+ }
88
+ process.exit(code ?? 1);
89
+ });
90
+ }
91
+
92
+ // WHY: the bundled Bun is probed before use, and a broken one falls back to the
93
+ // Bun on PATH. An exec bit missing, a wrong-architecture binary, or a corrupted
94
+ // download all exist as files yet cannot run; without the probe the CLI would
95
+ // fail later with an opaque spawn error. Under Node this costs one extra spawn
96
+ // per invocation; the in-process Bun path skips it.
97
+ function chooseBun(here) {
98
+ const tried = [];
99
+ const bundled = findBundledBun(here);
100
+ if (bundled !== null) {
101
+ if (runsBun(bundled)) return { bun: bundled, tried };
102
+ tried.push("the bundled Bun (node_modules/bun)");
103
+ }
104
+ const onPath = findBunOnPath();
105
+ if (onPath !== null) {
106
+ if (runsBun(onPath)) return { bun: onPath, tried };
107
+ tried.push("bun on PATH");
108
+ }
109
+ return { bun: null, tried };
110
+ }
111
+
112
+ function findBundledBun(here) {
113
+ const bundled = path.join(
114
+ here,
115
+ "..",
116
+ "node_modules",
117
+ "bun",
118
+ "bin",
119
+ "bun.exe",
120
+ );
121
+ if (isExecutableFile(bundled)) return bundled;
122
+
123
+ try {
124
+ const require = createRequire(import.meta.url);
125
+ const bunPackage = require.resolve("bun/package.json");
126
+ const resolved = path.join(path.dirname(bunPackage), "bin", "bun.exe");
127
+ if (isExecutableFile(resolved)) return resolved;
128
+ } catch {
129
+ // Not installed as a dependency; the caller falls back to PATH.
130
+ }
131
+ return null;
132
+ }
133
+
134
+ function findBunOnPath() {
135
+ const binary = process.platform === "win32" ? "bun.exe" : "bun";
136
+ for (const dir of (process.env.PATH ?? "").split(path.delimiter)) {
137
+ if (!dir) continue;
138
+ const candidate = path.join(dir, binary);
139
+ if (isExecutableFile(candidate)) return candidate;
140
+ }
141
+ return null;
142
+ }
143
+
144
+ function runsBun(bun) {
145
+ const probe = spawnSync(bun, ["--version"], {
146
+ stdio: "ignore",
147
+ timeout: 5000,
148
+ });
149
+ return probe.status === 0;
150
+ }
151
+
152
+ // WHY: a terminal delivers SIGINT to the whole process group, so the child
153
+ // already has it when stdin is a TTY and forwarding would deliver it twice.
154
+ // Anywhere else the launcher is the only thing that receives it.
155
+ function shouldForwardSigint(isTTY) {
156
+ return isTTY !== true;
157
+ }
158
+
159
+ function isExecutableFile(file) {
160
+ try {
161
+ fs.accessSync(file, fs.constants.X_OK);
162
+ return fs.statSync(file).isFile();
163
+ } catch {
164
+ return false;
165
+ }
166
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "provider": "anthropic",
3
+ "defaultBackend": "claude-code",
4
+ "aliases": ["sonnet", "opus", "haiku"]
5
+ }