swarm-orchestrator 14.2.0 → 14.4.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 (192) hide show
  1. package/CHANGELOG.md +93 -1
  2. package/README.md +140 -124
  3. package/dist/action/artifacts.js +72 -0
  4. package/dist/action/artifacts.js.map +1 -0
  5. package/dist/action/comment.js +139 -0
  6. package/dist/action/comment.js.map +1 -0
  7. package/dist/action/environment.js +106 -0
  8. package/dist/action/environment.js.map +1 -0
  9. package/dist/action/verdict.js +103 -0
  10. package/dist/action/verdict.js.map +1 -0
  11. package/dist/action/verify.js +424 -0
  12. package/dist/action/verify.js.map +1 -0
  13. package/dist/cli-action.js +117 -0
  14. package/dist/cli-action.js.map +1 -0
  15. package/dist/cli-check.js +341 -0
  16. package/dist/cli-check.js.map +1 -0
  17. package/dist/cli-ci.js +27 -3
  18. package/dist/cli-ci.js.map +1 -1
  19. package/dist/cli-command-definitions.js +43 -1
  20. package/dist/cli-command-definitions.js.map +1 -1
  21. package/dist/cli-gates.js +33 -10
  22. package/dist/cli-gates.js.map +1 -1
  23. package/dist/cli-integrations.js +145 -0
  24. package/dist/cli-integrations.js.map +1 -0
  25. package/dist/cli-options.js +32 -0
  26. package/dist/cli-options.js.map +1 -1
  27. package/dist/cli-strengthen.js +527 -0
  28. package/dist/cli-strengthen.js.map +1 -0
  29. package/dist/cli-task-goal.js +58 -9
  30. package/dist/cli-task-goal.js.map +1 -1
  31. package/dist/cli-verdict.js +144 -0
  32. package/dist/cli-verdict.js.map +1 -0
  33. package/dist/cli-verify-options.js +85 -0
  34. package/dist/cli-verify-options.js.map +1 -1
  35. package/dist/cli.js +82 -8
  36. package/dist/cli.js.map +1 -1
  37. package/dist/config/init.js +1 -1
  38. package/dist/config/init.js.map +1 -1
  39. package/dist/config/package-discovery.js +47 -1
  40. package/dist/config/package-discovery.js.map +1 -1
  41. package/dist/durable/recovery-context.js +3 -2
  42. package/dist/durable/recovery-context.js.map +1 -1
  43. package/dist/evidence/blob-manifest.js +9 -0
  44. package/dist/evidence/blob-manifest.js.map +1 -1
  45. package/dist/evidence/bundle.js +17 -2
  46. package/dist/evidence/bundle.js.map +1 -1
  47. package/dist/evidence/challenge-lines.js +21 -0
  48. package/dist/evidence/challenge-lines.js.map +1 -0
  49. package/dist/evidence/ci-summary.js +5 -1
  50. package/dist/evidence/ci-summary.js.map +1 -1
  51. package/dist/evidence/goal-contract.js +132 -1
  52. package/dist/evidence/goal-contract.js.map +1 -1
  53. package/dist/evidence/signing.js +3 -1
  54. package/dist/evidence/signing.js.map +1 -1
  55. package/dist/evidence/verifier/challenges.d.mts +19 -0
  56. package/dist/evidence/verifier/challenges.mjs +203 -0
  57. package/dist/evidence/verifier/rederive.mjs +20 -2
  58. package/dist/evidence/verifier/status.d.mts +2 -0
  59. package/dist/evidence/verifier/status.mjs +638 -38
  60. package/dist/evidence/verifier/strengthening.d.mts +18 -0
  61. package/dist/evidence/verifier/strengthening.mjs +200 -0
  62. package/dist/evidence/verifier/upgrade.mjs +1 -0
  63. package/dist/evidence/verifier/verify.mjs +25 -1
  64. package/dist/exec/child-environment.js +30 -0
  65. package/dist/exec/child-environment.js.map +1 -1
  66. package/dist/exec/container-backend.js +103 -12
  67. package/dist/exec/container-backend.js.map +1 -1
  68. package/dist/exec/controlled-network.js +20 -1
  69. package/dist/exec/controlled-network.js.map +1 -1
  70. package/dist/exec/execution-mode.js +25 -13
  71. package/dist/exec/execution-mode.js.map +1 -1
  72. package/dist/exec/runtime-resource.js +6 -1
  73. package/dist/exec/runtime-resource.js.map +1 -1
  74. package/dist/gates/base-control.js +7 -2
  75. package/dist/gates/base-control.js.map +1 -1
  76. package/dist/gates/certification.js +4 -0
  77. package/dist/gates/certification.js.map +1 -1
  78. package/dist/gates/change-source.js +29 -29
  79. package/dist/gates/change-source.js.map +1 -1
  80. package/dist/gates/check-admission.js +218 -0
  81. package/dist/gates/check-admission.js.map +1 -0
  82. package/dist/gates/check-network-probe.js +42 -0
  83. package/dist/gates/check-network-probe.js.map +1 -0
  84. package/dist/gates/check-plan.js +269 -0
  85. package/dist/gates/check-plan.js.map +1 -0
  86. package/dist/gates/checkout-environment.js +119 -0
  87. package/dist/gates/checkout-environment.js.map +1 -0
  88. package/dist/gates/contract-executor.js +7 -4
  89. package/dist/gates/contract-executor.js.map +1 -1
  90. package/dist/gates/default-gates.js +2 -2
  91. package/dist/gates/default-gates.js.map +1 -1
  92. package/dist/gates/deferred-setup.js +250 -0
  93. package/dist/gates/deferred-setup.js.map +1 -0
  94. package/dist/gates/dependency-install.js +200 -41
  95. package/dist/gates/dependency-install.js.map +1 -1
  96. package/dist/gates/engine.js +7 -1
  97. package/dist/gates/engine.js.map +1 -1
  98. package/dist/gates/failure-attribution.js +444 -0
  99. package/dist/gates/failure-attribution.js.map +1 -0
  100. package/dist/gates/gate-definition.js.map +1 -1
  101. package/dist/gates/gate-runner.js +31 -5
  102. package/dist/gates/gate-runner.js.map +1 -1
  103. package/dist/gates/git-workspace.js +36 -5
  104. package/dist/gates/git-workspace.js.map +1 -1
  105. package/dist/gates/goal-challenge-runner.js +99 -0
  106. package/dist/gates/goal-challenge-runner.js.map +1 -0
  107. package/dist/gates/goal-challenges.js +337 -0
  108. package/dist/gates/goal-challenges.js.map +1 -0
  109. package/dist/gates/harness-reporting.js +7 -3
  110. package/dist/gates/harness-reporting.js.map +1 -1
  111. package/dist/gates/independent-checks.js +63 -2
  112. package/dist/gates/independent-checks.js.map +1 -1
  113. package/dist/gates/independent-verification.js +569 -82
  114. package/dist/gates/independent-verification.js.map +1 -1
  115. package/dist/gates/inspection-gates.js +5 -5
  116. package/dist/gates/inspection-gates.js.map +1 -1
  117. package/dist/gates/instrument-dependencies.js +249 -0
  118. package/dist/gates/instrument-dependencies.js.map +1 -0
  119. package/dist/gates/instrument-identity.js +794 -0
  120. package/dist/gates/instrument-identity.js.map +1 -0
  121. package/dist/gates/mutant-parse.js +23 -0
  122. package/dist/gates/mutant-parse.js.map +1 -1
  123. package/dist/gates/node-command-runner.js +16 -2
  124. package/dist/gates/node-command-runner.js.map +1 -1
  125. package/dist/gates/node-gates.js +39 -8
  126. package/dist/gates/node-gates.js.map +1 -1
  127. package/dist/gates/node-test-command.js +22 -4
  128. package/dist/gates/node-test-command.js.map +1 -1
  129. package/dist/gates/noninteractive-runner.js +106 -0
  130. package/dist/gates/noninteractive-runner.js.map +1 -0
  131. package/dist/gates/oracle-instrumentation.js +1 -4
  132. package/dist/gates/oracle-instrumentation.js.map +1 -1
  133. package/dist/gates/oracle-mutants.js +13 -3
  134. package/dist/gates/oracle-mutants.js.map +1 -1
  135. package/dist/gates/parsers.js +110 -4
  136. package/dist/gates/parsers.js.map +1 -1
  137. package/dist/gates/patch-paths.js +304 -14
  138. package/dist/gates/patch-paths.js.map +1 -1
  139. package/dist/gates/prepare-dependencies.js +2 -0
  140. package/dist/gates/prepare-dependencies.js.map +1 -1
  141. package/dist/gates/prepared-tools.js +18 -0
  142. package/dist/gates/prepared-tools.js.map +1 -0
  143. package/dist/gates/project-environment.js +1 -0
  144. package/dist/gates/project-environment.js.map +1 -1
  145. package/dist/gates/project-type.js +131 -14
  146. package/dist/gates/project-type.js.map +1 -1
  147. package/dist/gates/python-gates.js +58 -32
  148. package/dist/gates/python-gates.js.map +1 -1
  149. package/dist/gates/python-mutants.js +176 -0
  150. package/dist/gates/python-mutants.js.map +1 -0
  151. package/dist/gates/python-offline-build.js +274 -0
  152. package/dist/gates/python-offline-build.js.map +1 -0
  153. package/dist/gates/runner-results.js +96 -23
  154. package/dist/gates/runner-results.js.map +1 -1
  155. package/dist/gates/scratch-index.js +112 -3
  156. package/dist/gates/scratch-index.js.map +1 -1
  157. package/dist/gates/setup-effect.js +16 -0
  158. package/dist/gates/setup-effect.js.map +1 -0
  159. package/dist/gates/setup-follow-up.js +113 -0
  160. package/dist/gates/setup-follow-up.js.map +1 -0
  161. package/dist/gates/structured-runner.js +37 -8
  162. package/dist/gates/structured-runner.js.map +1 -1
  163. package/dist/gates/unified-diff.js +39 -9
  164. package/dist/gates/unified-diff.js.map +1 -1
  165. package/dist/gates/upgrade-contract.js +1 -0
  166. package/dist/gates/upgrade-contract.js.map +1 -1
  167. package/dist/gates/upgrade-resolution.js +8 -1
  168. package/dist/gates/upgrade-resolution.js.map +1 -1
  169. package/dist/install/health.js +3 -3
  170. package/dist/install/health.js.map +1 -1
  171. package/dist/integrations/claude-hook.js +200 -0
  172. package/dist/integrations/claude-hook.js.map +1 -0
  173. package/dist/integrations/launcher.js +17 -0
  174. package/dist/integrations/launcher.js.map +1 -0
  175. package/dist/integrations/mcp-server.js +270 -0
  176. package/dist/integrations/mcp-server.js.map +1 -0
  177. package/dist/integrations/pre-commit.js +169 -0
  178. package/dist/integrations/pre-commit.js.map +1 -0
  179. package/dist/machine-output.js +1 -0
  180. package/dist/machine-output.js.map +1 -1
  181. package/dist/node-floor.js +46 -17
  182. package/dist/node-floor.js.map +1 -1
  183. package/dist/swarm-verify.js +30 -5
  184. package/dist/swarm-verify.js.map +1 -1
  185. package/dist/workers/bootstrap-history.js +4 -3
  186. package/dist/workers/bootstrap-history.js.map +1 -1
  187. package/dist/workers/worktree.js +72 -30
  188. package/dist/workers/worktree.js.map +1 -1
  189. package/docs/README.md +17 -3
  190. package/docs/claims.md +31 -7
  191. package/docs/security-coverage.md +3 -1
  192. package/package.json +6 -2
@@ -0,0 +1,139 @@
1
+ import { challengeLines } from "../evidence/challenge-lines.js";
2
+ import { reviewerText } from "../evidence/ci-summary.js";
3
+ /**
4
+ * The pull request comment: one per pull request, updated in place, bound to the head it
5
+ * describes. Everything a candidate could have written (check names, findings, paths) arrives
6
+ * through the reviewer text escape, which also neutralises mentions, so a candidate cannot
7
+ * page a maintainer or link out of the comment. The whole body is bounded below GitHub's limit.
8
+ */
9
+ export const commentMarker = "<!-- swarm-verify -->";
10
+ /** GitHub refuses a comment body over 65536 characters; stay well under with a named cut. */
11
+ const bodyLimit = 60_000;
12
+ function marker(pullRequest, head) {
13
+ return `${commentMarker}\n<!-- swarm-verify pr=${pullRequest} head=${head} -->`;
14
+ }
15
+ /** Text a candidate could have shaped, escaped and with mentions defused. */
16
+ function untrusted(value) {
17
+ return reviewerText(value).replaceAll("@", "&#64;");
18
+ }
19
+ function resultLine(verdict) {
20
+ switch (verdict.decision.result) {
21
+ case "verified":
22
+ return "**Verified**: the recorded checks passed and every declared requirement was accepted.";
23
+ case "regression-only":
24
+ return "**Regression-only pass**: nothing this patch changed broke a check; a failure the base already had, if any, is named below as inherited. No requirement contract was supplied, so whether the work does what was asked is unmeasured.";
25
+ case "not-verified":
26
+ return "**Not verified**: a check failed or a requirement was rejected.";
27
+ case "incomplete":
28
+ return "**Incomplete**: the assessment could not measure what it needed to.";
29
+ case "head-changed":
30
+ return "**Not current**: the pull request moved before this run finished; this result describes an earlier head.";
31
+ case "refused":
32
+ return "**Refused**: the source could not be verified as identified.";
33
+ }
34
+ }
35
+ /** Render the comment body from the signed verdict and the assessment summary. */
36
+ export function renderComment(options) {
37
+ const { verdict } = options;
38
+ const scope = verdict.decision.task === "accepted" || verdict.decision.task === "rejected"
39
+ ? "requirement checks from a trusted contract were run"
40
+ : "no requirement contract was supplied, so task correctness is unmeasured";
41
+ const lines = [
42
+ marker(verdict.pullRequest ?? 0, verdict.eventHead ?? verdict.head),
43
+ "## swarm-verify",
44
+ "",
45
+ resultLine(verdict),
46
+ "",
47
+ `Source: ${verdict.target === "merge" ? "test merge" : "head"} \`${verdict.head}\` against base \`${verdict.base}\`` +
48
+ `${verdict.tree === null ? "" : `, tree \`${verdict.tree}\``}.`,
49
+ `Regression: ${verdict.decision.regression ?? "not run"}. Task: ${verdict.decision.task ?? "unjudged"} (${scope}).`,
50
+ `Execution: ${untrusted(verdict.execution.executionTrust)} under ${verdict.policy.isolation}${verdict.policy.image === null ? "" : ` \`${untrusted(verdict.policy.image)}\``}.`,
51
+ verdict.decision.unmeasured.length === 0
52
+ ? "Unmeasured: nothing the policy asked for."
53
+ : `Unmeasured: ${verdict.decision.unmeasured.map(untrusted).join(", ")}.`,
54
+ verdict.decision.reason === null ? "" : `Reason: ${untrusted(verdict.decision.reason)}.`,
55
+ ...(verdict.decision.challenges === null
56
+ ? []
57
+ : challengeLines(verdict.decision.challenges).map((line, index) => index === 0
58
+ ? `${untrusted(line.charAt(0).toUpperCase() + line.slice(1))}.`
59
+ : `- ${untrusted(line)}`)),
60
+ "",
61
+ `Signature: ${options.attestation.status === "signed"
62
+ ? `signed by this workflow ([attestation](${options.attestation.url ?? options.runUrl})); verify with \`gh attestation verify verdict.json --repo ${verdict.repository} --predicate-type https://github.com/moonrunnerkc/swarm-verify/verdict/v1\``
63
+ : options.attestation.status === "skipped"
64
+ ? `not requested (${untrusted(options.attestation.detail)})`
65
+ : `unavailable: ${untrusted(options.attestation.detail)}`}.`,
66
+ `Evidence: artifact \`${options.artifactName}\` on [this run](${options.runUrl}) holds the JSON report, the signed bundle with its own verifier, and the verdict document (${verdict.evidence.reportDigest ?? "no report"}).`,
67
+ `Verifier: swarm-verify ${untrusted(verdict.verifier.version)}, run ${verdict.execution.runId} attempt ${verdict.execution.runAttempt}.`,
68
+ "",
69
+ "<details><summary>Assessment</summary>",
70
+ "",
71
+ options.summary === null
72
+ ? "_No assessment summary was produced._"
73
+ : options.summary.replaceAll("@", "&#64;"),
74
+ "",
75
+ "</details>",
76
+ "",
77
+ "_A regression pass says nothing broke. Only a requirement contract can say the work was done._",
78
+ ].filter((line) => line !== null);
79
+ const body = lines.join("\n");
80
+ return body.length <= bodyLimit
81
+ ? body
82
+ : `${body.slice(0, bodyLimit - 80)}\n\n_Comment truncated; the full assessment is in the run artifact._`;
83
+ }
84
+ /**
85
+ * Create or update the one comment, only while the pull request still points at the head the
86
+ * verdict describes. A delayed run for an older head finds a newer head and posts nothing.
87
+ */
88
+ export async function publishComment(options) {
89
+ if (options.token === null)
90
+ return { status: "unavailable", reason: "no token was supplied to publish with" };
91
+ const doFetch = options.fetch ?? globalThis.fetch;
92
+ const headers = {
93
+ Authorization: `Bearer ${options.token}`,
94
+ Accept: "application/vnd.github+json",
95
+ "X-GitHub-Api-Version": "2022-11-28",
96
+ "User-Agent": "swarm-verify",
97
+ };
98
+ const base = `${options.apiUrl}/repos/${options.repository}`;
99
+ const read = async (url) => {
100
+ const response = await doFetch(url, { method: "GET", headers });
101
+ if (response.status !== 200)
102
+ throw new Error(`GET ${url.replace(options.apiUrl, "")} answered ${response.status}`);
103
+ return response.json();
104
+ };
105
+ try {
106
+ const pull = (await read(`${base}/pulls/${options.pullRequest}`));
107
+ const currentHead = pull.head?.sha ?? "";
108
+ if (currentHead !== options.head)
109
+ return { status: "stale-head", currentHead };
110
+ let existing = null;
111
+ for (let page = 1; page <= 10 && existing === null; page += 1) {
112
+ const comments = (await read(`${base}/issues/${options.pullRequest}/comments?per_page=100&page=${page}`));
113
+ existing = comments.find((one) => (one.body ?? "").startsWith(commentMarker)) ?? null;
114
+ if (comments.length < 100)
115
+ break;
116
+ }
117
+ const response = await doFetch(existing === null
118
+ ? `${base}/issues/${options.pullRequest}/comments`
119
+ : `${base}/issues/comments/${existing.id}`, {
120
+ method: existing === null ? "POST" : "PATCH",
121
+ headers: { ...headers, "Content-Type": "application/json" },
122
+ body: JSON.stringify({ body: options.body }),
123
+ });
124
+ if (response.status !== 200 && response.status !== 201)
125
+ return {
126
+ status: "unavailable",
127
+ reason: `${existing === null ? "POST" : "PATCH"} answered ${response.status}: ${(await response.text()).slice(0, 300)}`,
128
+ };
129
+ const written = (await response.json());
130
+ return { status: existing === null ? "created" : "updated", url: written.html_url ?? "" };
131
+ }
132
+ catch (cause) {
133
+ return {
134
+ status: "unavailable",
135
+ reason: cause instanceof Error ? cause.message : String(cause),
136
+ };
137
+ }
138
+ }
139
+ //# sourceMappingURL=comment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"comment.js","sourceRoot":"","sources":["../../src/action/comment.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,106 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { z } from "zod";
3
+ /**
4
+ * What the GitHub Actions runner tells the Action, read once and validated once. Everything
5
+ * here is data the runner set, or an input the trusted workflow declared; nothing comes from
6
+ * the candidate. The event payload is the one document the candidate influences (a pull
7
+ * request's title and body are theirs), so only the identities the Action needs are read from
8
+ * it, and each is held to its shape.
9
+ */
10
+ const sha = z.string().regex(/^[0-9a-f]{40}$/, "expected a 40-hex commit id");
11
+ const repositoryName = z.string().regex(/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/);
12
+ const pullRequestEventSchema = z.object({
13
+ pull_request: z.object({
14
+ number: z.number().int().positive(),
15
+ head: z.object({
16
+ sha,
17
+ repo: z.object({ full_name: repositoryName, fork: z.boolean() }).nullable(),
18
+ }),
19
+ base: z.object({ sha, repo: z.object({ full_name: repositoryName }) }),
20
+ }),
21
+ });
22
+ function required(env, name) {
23
+ const value = env[name];
24
+ if (value === undefined || value.length === 0)
25
+ throw new Error(`${name} is not set; this command runs inside a GitHub Actions job`);
26
+ return value;
27
+ }
28
+ function optional(env, name) {
29
+ const value = env[name];
30
+ return value === undefined || value.trim().length === 0 ? null : value.trim();
31
+ }
32
+ function flag(env, name, fallback) {
33
+ const value = optional(env, name);
34
+ if (value === null)
35
+ return fallback;
36
+ if (value === "true")
37
+ return true;
38
+ if (value === "false")
39
+ return false;
40
+ throw new Error(`${name} must be true or false, got ${JSON.stringify(value)}`);
41
+ }
42
+ /** Read the runner's environment and the workflow's inputs into one validated context. */
43
+ export async function readActionContext(env = process.env) {
44
+ const eventName = required(env, "GITHUB_EVENT_NAME");
45
+ let pullRequest = null;
46
+ if (eventName === "pull_request" || eventName === "pull_request_target") {
47
+ const payload = pullRequestEventSchema.parse(JSON.parse(await readFile(required(env, "GITHUB_EVENT_PATH"), "utf8")));
48
+ const pr = payload.pull_request;
49
+ pullRequest = {
50
+ number: pr.number,
51
+ head: pr.head.sha,
52
+ base: pr.base.sha,
53
+ headRepository: pr.head.repo?.full_name ?? null,
54
+ baseRepository: pr.base.repo.full_name,
55
+ fork: pr.head.repo?.fork ?? true,
56
+ };
57
+ }
58
+ const target = optional(env, "SWARM_INPUT_TARGET") ?? "head";
59
+ if (target !== "head" && target !== "merge")
60
+ throw new Error(`target must be head or merge, got ${JSON.stringify(target)}`);
61
+ const isolation = optional(env, "SWARM_INPUT_ISOLATION") ?? "docker";
62
+ if (isolation !== "docker" && isolation !== "host")
63
+ throw new Error(`isolation must be docker or host, got ${JSON.stringify(isolation)}`);
64
+ const challenges = optional(env, "SWARM_INPUT_CHALLENGES") ?? "report";
65
+ if (challenges !== "off" && challenges !== "report" && challenges !== "required")
66
+ throw new Error(`challenges must be off, report or required, got ${JSON.stringify(challenges)}`);
67
+ const packages = (optional(env, "SWARM_INPUT_PACKAGES") ?? "")
68
+ .split(/[\n,]/)
69
+ .map((entry) => entry.trim())
70
+ .filter((entry) => entry.length > 0);
71
+ return {
72
+ eventName,
73
+ repository: repositoryName.parse(required(env, "GITHUB_REPOSITORY")),
74
+ serverUrl: optional(env, "GITHUB_SERVER_URL") ?? "https://github.com",
75
+ apiUrl: optional(env, "GITHUB_API_URL") ?? "https://api.github.com",
76
+ runId: required(env, "GITHUB_RUN_ID"),
77
+ runAttempt: optional(env, "GITHUB_RUN_ATTEMPT") ?? "1",
78
+ workflowRef: optional(env, "GITHUB_WORKFLOW_REF") ?? "",
79
+ actor: optional(env, "GITHUB_ACTOR") ?? "",
80
+ runnerEnvironment: optional(env, "RUNNER_ENVIRONMENT") ?? "",
81
+ runnerTemp: required(env, "RUNNER_TEMP"),
82
+ outputPath: optional(env, "GITHUB_OUTPUT"),
83
+ summaryPath: optional(env, "GITHUB_STEP_SUMMARY"),
84
+ pullRequest,
85
+ inputs: {
86
+ target,
87
+ image: optional(env, "SWARM_INPUT_IMAGE") ?? "node:24-bookworm",
88
+ isolation,
89
+ goalContract: optional(env, "SWARM_INPUT_GOAL_CONTRACT"),
90
+ oracle: optional(env, "SWARM_INPUT_ORACLE"),
91
+ packages,
92
+ install: flag(env, "SWARM_INPUT_INSTALL", false),
93
+ requireTask: flag(env, "SWARM_INPUT_REQUIRE_TASK", false),
94
+ challenges,
95
+ comment: flag(env, "SWARM_INPUT_COMMENT", true),
96
+ token: optional(env, "SWARM_INPUT_TOKEN"),
97
+ head: optional(env, "SWARM_INPUT_HEAD"),
98
+ base: optional(env, "SWARM_INPUT_BASE"),
99
+ workspace: optional(env, "SWARM_INPUT_WORKSPACE"),
100
+ sourceUrl: optional(env, "SWARM_INPUT_SOURCE_URL"),
101
+ allowSelfHosted: flag(env, "SWARM_INPUT_ALLOW_SELF_HOSTED", false),
102
+ },
103
+ };
104
+ }
105
+ export const commitId = sha;
106
+ //# sourceMappingURL=environment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/action/environment.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,103 @@
1
+ import { z } from "zod";
2
+ import { asJsonValue, canonicalJson, digestOfBytes } from "../evidence/canonical-json.js";
3
+ /**
4
+ * The one document the Action signs. It binds the repository, the pull request, the exact
5
+ * head, base and tree, the verifier and its policy, the run that produced it, the digests of
6
+ * the evidence it produced, and the decision. It is canonical JSON, so the digest a signer
7
+ * binds is the digest a reader recomputes; and it is signed by an established mechanism
8
+ * (GitHub artifact attestations over Sigstore), never by anything this module invents.
9
+ *
10
+ * What a signature over it establishes is that this document was produced by the named
11
+ * workflow in the named repository on the named run. It does not establish that the decision
12
+ * is right: the decision was computed from the evidence the digests name, and that evidence
13
+ * verifies on its own.
14
+ */
15
+ export const verdictSchemaName = "swarm-verify.verdict.v1";
16
+ /** The predicate type a reader names to `gh attestation verify --predicate-type`. */
17
+ export const verdictPredicateType = "https://github.com/moonrunnerkc/swarm-verify/verdict/v1";
18
+ export const verdictSchema = z.strictObject({
19
+ schema: z.literal(verdictSchemaName),
20
+ repository: z.string().min(1),
21
+ pullRequest: z.number().int().positive().nullable(),
22
+ target: z.enum(["head", "merge"]),
23
+ /** The commit that was verified: the PR head, or GitHub's test merge of it. */
24
+ head: z.string().regex(/^[0-9a-f]{40}$/),
25
+ /** The PR head as the event named it, which under `merge` differs from `head`. */
26
+ eventHead: z
27
+ .string()
28
+ .regex(/^[0-9a-f]{40}$/)
29
+ .nullable(),
30
+ base: z.string().regex(/^[0-9a-f]{40}$/),
31
+ comparisonBase: z
32
+ .string()
33
+ .regex(/^[0-9a-f]{40}$/)
34
+ .nullable(),
35
+ tree: z
36
+ .string()
37
+ .regex(/^[0-9a-f]{40}$/)
38
+ .nullable(),
39
+ patchDigest: z.string().nullable(),
40
+ verifier: z.strictObject({ name: z.literal("swarm-verify"), version: z.string().min(1) }),
41
+ policy: z.strictObject({
42
+ isolation: z.enum(["docker", "host"]),
43
+ image: z.string().nullable(),
44
+ goalContractDigest: z.string().nullable(),
45
+ oracle: z.string().nullable(),
46
+ packages: z.array(z.string()),
47
+ install: z.boolean(),
48
+ /** Whether a regression-only pass counts as a failure for this consumer. */
49
+ requireTask: z.boolean(),
50
+ challenges: z.enum(["off", "report", "required"]),
51
+ }),
52
+ execution: z.strictObject({
53
+ eventName: z.string(),
54
+ runId: z.string(),
55
+ runAttempt: z.string(),
56
+ workflowRef: z.string(),
57
+ runnerEnvironment: z.string(),
58
+ executionTrust: z.string(),
59
+ }),
60
+ evidence: z.strictObject({
61
+ reportDigest: z.string().nullable(),
62
+ summaryDigest: z.string().nullable(),
63
+ assessmentDigest: z.string().nullable(),
64
+ bundleChainHead: z.string().nullable(),
65
+ }),
66
+ decision: z.strictObject({
67
+ /** What the Action returns: 0 verified or regression-only, 1 not verified, 4 otherwise. */
68
+ status: z.number().int(),
69
+ /** What the verifier itself exited, which refuses an unjudged task with 1. */
70
+ verifierStatus: z.number().int().nullable(),
71
+ result: z.enum([
72
+ "verified",
73
+ "regression-only",
74
+ "not-verified",
75
+ "incomplete",
76
+ "head-changed",
77
+ "refused",
78
+ ]),
79
+ regression: z.string().nullable(),
80
+ task: z.string().nullable(),
81
+ unmeasured: z.array(z.string()),
82
+ reason: z.string().nullable(),
83
+ /** Per requirement, what challenging its checks established; null where none ran. */
84
+ challenges: z
85
+ .strictObject({
86
+ satisfied: z.boolean(),
87
+ requirements: z.array(z.strictObject({
88
+ id: z.string(),
89
+ outcome: z.enum(["detected", "gap", "invalid-evidence", "unjudged", "inapplicable"]),
90
+ })),
91
+ })
92
+ .nullable(),
93
+ }),
94
+ });
95
+ /** Validate, then render the bytes a signer binds and a reader digests. */
96
+ export function canonicalVerdict(verdict) {
97
+ // The digest is over the file bytes as written, newline included: that is the subject an
98
+ // attestation binds and the number a reader recomputes with sha256sum.
99
+ const parsed = verdictSchema.parse(verdict);
100
+ const bytes = `${canonicalJson(asJsonValue(parsed))}\n`;
101
+ return { bytes, digest: digestOfBytes(bytes) };
102
+ }
103
+ //# sourceMappingURL=verdict.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../src/action/verdict.ts"],"names":[],"mappings":"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"}