@intentius/chant 0.124.85 → 0.124.87

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 (286) hide show
  1. package/dist/bundle-check.d.ts +102 -0
  2. package/dist/bundle-check.d.ts.map +1 -0
  3. package/dist/bundle-check.js +310 -0
  4. package/dist/chant-install.d.ts +100 -0
  5. package/dist/chant-install.d.ts.map +1 -0
  6. package/dist/chant-install.js +158 -0
  7. package/dist/ci-commit.d.ts +19 -6
  8. package/dist/ci-commit.d.ts.map +1 -1
  9. package/dist/ci-commit.js +23 -4
  10. package/dist/ci-evidence-jobs.d.ts +78 -0
  11. package/dist/ci-evidence-jobs.d.ts.map +1 -0
  12. package/dist/ci-evidence-jobs.js +85 -0
  13. package/dist/ci-image.d.ts +274 -0
  14. package/dist/ci-image.d.ts.map +1 -0
  15. package/dist/ci-image.js +635 -0
  16. package/dist/ci-login.d.ts +150 -0
  17. package/dist/ci-login.d.ts.map +1 -0
  18. package/dist/ci-login.js +240 -0
  19. package/dist/ci-product.d.ts +16 -0
  20. package/dist/ci-product.d.ts.map +1 -1
  21. package/dist/ci-product.js +17 -0
  22. package/dist/cli/commands/import-index.js +2 -2
  23. package/dist/cli/handlers/build.d.ts +8 -0
  24. package/dist/cli/handlers/build.d.ts.map +1 -1
  25. package/dist/cli/handlers/build.js +22 -4
  26. package/dist/cli/handlers/ci-check.d.ts.map +1 -1
  27. package/dist/cli/handlers/ci-check.js +61 -2
  28. package/dist/cli/handlers/ci-evidence.d.ts +3 -0
  29. package/dist/cli/handlers/ci-evidence.d.ts.map +1 -0
  30. package/dist/cli/handlers/ci-evidence.js +174 -0
  31. package/dist/cli/handlers/components.js +3 -3
  32. package/dist/cli/handlers/dead-guards.d.ts +3 -0
  33. package/dist/cli/handlers/dead-guards.d.ts.map +1 -0
  34. package/dist/cli/handlers/dead-guards.js +35 -0
  35. package/dist/cli/handlers/graph.js +4 -4
  36. package/dist/cli/handlers/lifecycle.d.ts +2 -1
  37. package/dist/cli/handlers/lifecycle.d.ts.map +1 -1
  38. package/dist/cli/handlers/lifecycle.js +5 -4
  39. package/dist/cli/handlers/local-chant.d.ts +16 -0
  40. package/dist/cli/handlers/local-chant.d.ts.map +1 -0
  41. package/dist/cli/handlers/local-chant.js +109 -0
  42. package/dist/cli/handlers/operator.js +2 -2
  43. package/dist/cli/handlers/search.js +5 -5
  44. package/dist/cli/main.d.ts.map +1 -1
  45. package/dist/cli/main.js +38 -0
  46. package/dist/cli/parse-args.d.ts.map +1 -1
  47. package/dist/cli/parse-args.js +28 -0
  48. package/dist/cli/registry.d.ts +16 -0
  49. package/dist/cli/registry.d.ts.map +1 -1
  50. package/dist/components/check-hooks.d.ts +49 -0
  51. package/dist/components/check-hooks.d.ts.map +1 -1
  52. package/dist/components/check-hooks.js +64 -4
  53. package/dist/components/check-steps.d.ts +17 -0
  54. package/dist/components/check-steps.d.ts.map +1 -1
  55. package/dist/components/check-steps.js +37 -5
  56. package/dist/components/product-pipeline.d.ts +23 -0
  57. package/dist/components/product-pipeline.d.ts.map +1 -1
  58. package/dist/components/product-pipeline.js +6 -2
  59. package/dist/components/product-plan.d.ts +143 -0
  60. package/dist/components/product-plan.d.ts.map +1 -0
  61. package/dist/components/product-plan.js +145 -0
  62. package/dist/components/release-compile.d.ts.map +1 -1
  63. package/dist/components/release-compile.js +2 -2
  64. package/dist/config.d.ts +39 -1
  65. package/dist/config.d.ts.map +1 -1
  66. package/dist/config.js +35 -3
  67. package/dist/dead-guards.d.ts +82 -0
  68. package/dist/dead-guards.d.ts.map +1 -0
  69. package/dist/dead-guards.js +436 -0
  70. package/dist/discovery/files.d.ts +3 -1
  71. package/dist/discovery/files.d.ts.map +1 -1
  72. package/dist/discovery/files.js +5 -3
  73. package/dist/drift-issue.d.ts +152 -0
  74. package/dist/drift-issue.d.ts.map +1 -0
  75. package/dist/drift-issue.js +167 -0
  76. package/dist/floor-table.d.ts +30 -0
  77. package/dist/floor-table.d.ts.map +1 -0
  78. package/dist/floor-table.data.d.ts +3 -0
  79. package/dist/floor-table.data.d.ts.map +1 -0
  80. package/dist/floor-table.data.js +179 -0
  81. package/dist/floor-table.js +56 -0
  82. package/dist/forge-flags.d.ts +90 -0
  83. package/dist/forge-flags.d.ts.map +1 -0
  84. package/dist/forge-flags.js +184 -0
  85. package/dist/lexicon.d.ts +69 -0
  86. package/dist/lexicon.d.ts.map +1 -1
  87. package/dist/lifecycle/gated-op.d.ts +7 -1
  88. package/dist/lifecycle/gated-op.d.ts.map +1 -1
  89. package/dist/lifecycle/gated-op.js +7 -4
  90. package/dist/local-chant.d.ts +98 -0
  91. package/dist/local-chant.d.ts.map +1 -0
  92. package/dist/local-chant.js +307 -0
  93. package/dist/op/activities/predict-behaviour.js +2 -2
  94. package/dist/op/op-waves-evidence-spec.d.ts +13 -0
  95. package/dist/op/op-waves-evidence-spec.d.ts.map +1 -0
  96. package/dist/op/op-waves-evidence-spec.js +21 -0
  97. package/dist/op/op-waves-evidence.d.ts +40 -0
  98. package/dist/op/op-waves-evidence.d.ts.map +1 -0
  99. package/dist/op/op-waves-evidence.js +58 -0
  100. package/dist/op/op-waves-run.d.ts +4 -0
  101. package/dist/op/op-waves-run.d.ts.map +1 -1
  102. package/dist/op/op-waves-run.js +24 -1
  103. package/dist/op/op-waves.d.ts +17 -1
  104. package/dist/op/op-waves.d.ts.map +1 -1
  105. package/dist/op/op-waves.js +23 -0
  106. package/dist/op/schedule-overdue.d.ts +41 -9
  107. package/dist/op/schedule-overdue.d.ts.map +1 -1
  108. package/dist/op/schedule-overdue.js +154 -25
  109. package/dist/plan-summary.d.ts +25 -0
  110. package/dist/plan-summary.d.ts.map +1 -1
  111. package/dist/plan-summary.js +31 -0
  112. package/dist/pr-plan-note.d.ts +35 -0
  113. package/dist/pr-plan-note.d.ts.map +1 -1
  114. package/dist/pr-plan-note.js +10 -0
  115. package/dist/pr-post.d.ts +23 -0
  116. package/dist/pr-post.d.ts.map +1 -1
  117. package/dist/pr-post.js +125 -3
  118. package/dist/release-floors.d.ts +33 -1
  119. package/dist/release-floors.d.ts.map +1 -1
  120. package/dist/release-floors.js +33 -1
  121. package/dist/state-migration.d.ts +24 -0
  122. package/dist/state-migration.d.ts.map +1 -1
  123. package/dist/state-migration.js +100 -5
  124. package/dist/wave-runtime.mjs +309 -302
  125. package/dist/workspace/ci-green.d.ts.map +1 -1
  126. package/dist/workspace/ci-green.js +4 -3
  127. package/dist/workspace/lexicon-outputs.d.ts.map +1 -1
  128. package/dist/workspace/lexicon-outputs.js +21 -7
  129. package/dist/workspace/reason-codes.d.ts +3 -0
  130. package/dist/workspace/reason-codes.d.ts.map +1 -1
  131. package/dist/workspace/reason-codes.js +4 -0
  132. package/dist/workspace/ref-gate.schema.json +85 -0
  133. package/dist/workspace/search-contract.d.ts +1 -1
  134. package/dist/workspace/search-contract.d.ts.map +1 -1
  135. package/dist/workspace/trust/check-evidence-report.d.ts +58 -0
  136. package/dist/workspace/trust/check-evidence-report.d.ts.map +1 -0
  137. package/dist/workspace/trust/check-evidence-report.js +109 -0
  138. package/dist/workspace/trust/check-evidence.d.ts +160 -0
  139. package/dist/workspace/trust/check-evidence.d.ts.map +1 -0
  140. package/dist/workspace/trust/check-evidence.js +309 -0
  141. package/dist/workspace/trust/ci-tag-statement.d.ts +2 -2
  142. package/dist/workspace/trust/ci-tag-statement.d.ts.map +1 -1
  143. package/dist/workspace/trust/dsse.d.ts +40 -2
  144. package/dist/workspace/trust/dsse.d.ts.map +1 -1
  145. package/dist/workspace/trust/dsse.js +34 -2
  146. package/dist/workspace/trust/evidence.d.ts +2 -2
  147. package/dist/workspace/trust/evidence.d.ts.map +1 -1
  148. package/dist/workspace/trust/keyless-fixture.d.ts +41 -0
  149. package/dist/workspace/trust/keyless-fixture.d.ts.map +1 -0
  150. package/dist/workspace/trust/keyless-fixture.js +161 -0
  151. package/dist/workspace/trust/keyless.d.ts +202 -0
  152. package/dist/workspace/trust/keyless.d.ts.map +1 -0
  153. package/dist/workspace/trust/keyless.js +488 -0
  154. package/dist/workspace/trust/local-evidence.d.ts +123 -0
  155. package/dist/workspace/trust/local-evidence.d.ts.map +1 -0
  156. package/dist/workspace/trust/local-evidence.js +259 -0
  157. package/dist/workspace/trust/op-run-statement.d.ts +2 -2
  158. package/dist/workspace/trust/op-run-statement.d.ts.map +1 -1
  159. package/dist/workspace/trust/policy.d.ts +140 -1
  160. package/dist/workspace/trust/policy.d.ts.map +1 -1
  161. package/dist/workspace/trust/policy.js +197 -3
  162. package/dist/workspace/trust/ref-gate-cli.d.ts +33 -0
  163. package/dist/workspace/trust/ref-gate-cli.d.ts.map +1 -0
  164. package/dist/workspace/trust/ref-gate-cli.js +234 -0
  165. package/dist/workspace/trust/ref-gate-fixture.d.ts +38 -0
  166. package/dist/workspace/trust/ref-gate-fixture.d.ts.map +1 -0
  167. package/dist/workspace/trust/ref-gate-fixture.js +97 -0
  168. package/dist/workspace/trust/ref-gate.d.ts +187 -0
  169. package/dist/workspace/trust/ref-gate.d.ts.map +1 -0
  170. package/dist/workspace/trust/ref-gate.js +432 -0
  171. package/dist/workspace/trust/run-statement.d.ts +3 -3
  172. package/dist/workspace/trust/run-statement.d.ts.map +1 -1
  173. package/dist/workspace/trust/runner-identity.d.ts +56 -0
  174. package/dist/workspace/trust/runner-identity.d.ts.map +1 -0
  175. package/dist/workspace/trust/runner-identity.js +65 -0
  176. package/dist/workspace/trust/trust-files.d.ts.map +1 -1
  177. package/dist/workspace/trust/trust-files.js +25 -1
  178. package/package.json +1 -1
  179. package/src/bundle-check.test.ts +140 -0
  180. package/src/bundle-check.ts +352 -0
  181. package/src/chant-install.test.ts +112 -0
  182. package/src/chant-install.ts +179 -0
  183. package/src/ci-commit.test.ts +45 -0
  184. package/src/ci-commit.ts +38 -4
  185. package/src/ci-evidence-jobs.ts +105 -0
  186. package/src/ci-image.test.ts +506 -0
  187. package/src/ci-image.ts +822 -0
  188. package/src/ci-login.test.ts +235 -0
  189. package/src/ci-login.ts +307 -0
  190. package/src/ci-product.ts +18 -0
  191. package/src/cli/commands/__fixtures__/source-dir-include/chant.config.json +1 -0
  192. package/src/cli/commands/__fixtures__/source-dir-include/infra.ts +1 -0
  193. package/src/cli/commands/__fixtures__/source-dir-include/scripts/run-on-load.ts +3 -0
  194. package/src/cli/commands/__fixtures__/source-dir-root/chant.config.json +1 -0
  195. package/src/cli/commands/__fixtures__/source-dir-root/infra.test.ts +1 -0
  196. package/src/cli/commands/__fixtures__/source-dir-root/infra.ts +1 -0
  197. package/src/cli/commands/__fixtures__/source-dir-root/scripts/run-on-load.ts +3 -0
  198. package/src/cli/commands/__fixtures__/source-dir-scoped/app.ts +3 -0
  199. package/src/cli/commands/__fixtures__/source-dir-scoped/chant.config.json +1 -0
  200. package/src/cli/commands/__fixtures__/source-dir-scoped/infra/net.ts +1 -0
  201. package/src/cli/commands/__fixtures__/source-dir-scoped/scripts/run-on-load.ts +3 -0
  202. package/src/cli/commands/import-index.ts +2 -2
  203. package/src/cli/handlers/build-source-dir.test.ts +64 -0
  204. package/src/cli/handlers/build.ts +21 -4
  205. package/src/cli/handlers/ci-check.ts +60 -3
  206. package/src/cli/handlers/ci-evidence.ts +167 -0
  207. package/src/cli/handlers/components.ts +3 -3
  208. package/src/cli/handlers/dead-guards.ts +37 -0
  209. package/src/cli/handlers/graph.ts +4 -4
  210. package/src/cli/handlers/lifecycle.ts +5 -4
  211. package/src/cli/handlers/local-chant.ts +106 -0
  212. package/src/cli/handlers/operator.ts +2 -2
  213. package/src/cli/handlers/search.ts +5 -5
  214. package/src/cli/main.test.ts +7 -0
  215. package/src/cli/main.ts +38 -0
  216. package/src/cli/parse-args.ts +21 -0
  217. package/src/cli/registry.ts +16 -0
  218. package/src/components/check-evidence-stage.test.ts +80 -0
  219. package/src/components/check-hooks.ts +84 -4
  220. package/src/components/check-local-evidence-stage.test.ts +141 -0
  221. package/src/components/check-steps.ts +56 -6
  222. package/src/components/product-pipeline.ts +28 -3
  223. package/src/components/product-plan.test.ts +87 -0
  224. package/src/components/product-plan.ts +230 -0
  225. package/src/components/release-compile.ts +2 -2
  226. package/src/config.ts +44 -3
  227. package/src/dead-guards.test.ts +206 -0
  228. package/src/dead-guards.ts +446 -0
  229. package/src/discovery/files.ts +5 -3
  230. package/src/drift-issue-bundle.test.ts +31 -0
  231. package/src/drift-issue.test.ts +206 -0
  232. package/src/drift-issue.ts +274 -0
  233. package/src/fit-note.test.ts +44 -0
  234. package/src/floor-table.data.ts +181 -0
  235. package/src/floor-table.ts +77 -0
  236. package/src/forge-flags.test.ts +110 -0
  237. package/src/forge-flags.ts +208 -0
  238. package/src/gate-decision-bundle.test.ts +1 -0
  239. package/src/lexicon.ts +68 -0
  240. package/src/lifecycle/gated-op.ts +10 -5
  241. package/src/local-chant.e2e.test.ts +94 -0
  242. package/src/local-chant.test.ts +162 -0
  243. package/src/local-chant.ts +341 -0
  244. package/src/op/activities/predict-behaviour.ts +2 -2
  245. package/src/op/op-waves-evidence-spec.ts +24 -0
  246. package/src/op/op-waves-evidence.test.ts +130 -0
  247. package/src/op/op-waves-evidence.ts +58 -0
  248. package/src/op/op-waves-run.ts +25 -1
  249. package/src/op/op-waves.ts +31 -1
  250. package/src/op/schedule-overdue.test.ts +85 -0
  251. package/src/op/schedule-overdue.ts +162 -26
  252. package/src/plan-summary.ts +40 -0
  253. package/src/pr-plan-note.ts +34 -0
  254. package/src/pr-post-plan-note.test.ts +146 -0
  255. package/src/pr-post.ts +127 -3
  256. package/src/release-floors.ts +47 -1
  257. package/src/stage-hooks-bundle.test.ts +1 -0
  258. package/src/state-migration.test.ts +52 -1
  259. package/src/state-migration.ts +107 -5
  260. package/src/workspace/ci-green.ts +4 -3
  261. package/src/workspace/lexicon-outputs.ts +23 -6
  262. package/src/workspace/reason-codes.test.ts +3 -0
  263. package/src/workspace/reason-codes.ts +4 -0
  264. package/src/workspace/ref-gate.schema.json +85 -0
  265. package/src/workspace/trust/check-evidence-report.ts +115 -0
  266. package/src/workspace/trust/check-evidence.test.ts +133 -0
  267. package/src/workspace/trust/check-evidence.ts +327 -0
  268. package/src/workspace/trust/ci-tag-statement.ts +2 -2
  269. package/src/workspace/trust/dsse.ts +48 -4
  270. package/src/workspace/trust/evidence.ts +2 -2
  271. package/src/workspace/trust/keyless-fixture.ts +214 -0
  272. package/src/workspace/trust/keyless.test.ts +220 -0
  273. package/src/workspace/trust/keyless.ts +557 -0
  274. package/src/workspace/trust/local-evidence.test.ts +127 -0
  275. package/src/workspace/trust/local-evidence.ts +268 -0
  276. package/src/workspace/trust/op-run-statement.ts +2 -2
  277. package/src/workspace/trust/policy.ts +263 -3
  278. package/src/workspace/trust/ref-gate-cli.ts +244 -0
  279. package/src/workspace/trust/ref-gate-fixture.ts +125 -0
  280. package/src/workspace/trust/ref-gate.e2e.test.ts +76 -0
  281. package/src/workspace/trust/ref-gate.test.ts +247 -0
  282. package/src/workspace/trust/ref-gate.ts +539 -0
  283. package/src/workspace/trust/run-statement.ts +3 -3
  284. package/src/workspace/trust/runner-identity.ts +92 -0
  285. package/src/workspace/trust/trust-files.test.ts +22 -0
  286. package/src/workspace/trust/trust-files.ts +54 -1
@@ -0,0 +1,85 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://intentius.io/chant/schemas/workspace/ref-gate/v1/ref-gate.schema.json",
4
+ "title": "chant workspace ref-gate output",
5
+ "description": "What `chant workspace ref-gate check|status|pre-receive|pre-push --json` prints (#4867): for each ref update, whether the commit carries current runner evidence for every check `refs` in `.chant/trust.json` at base requires for the ref, and the decision. Version 1 of the read contract. Readers ignore fields they do not know; a field is only ever added within a version. The codes are a closed list, each in the one closed list of `reason-codes.ts`.",
6
+ "oneOf": [
7
+ { "$ref": "#/$defs/result" },
8
+ { "$ref": "#/$defs/failure" }
9
+ ],
10
+ "$defs": {
11
+ "result": {
12
+ "type": "object",
13
+ "required": ["$schema", "contract", "chant", "ok", "decisions"],
14
+ "properties": {
15
+ "$schema": { "const": "https://intentius.io/chant/schemas/workspace/ref-gate/v1/ref-gate.schema.json" },
16
+ "contract": { "const": 1 },
17
+ "chant": { "type": "string" },
18
+ "ok": { "type": "boolean", "description": "True when every update is admitted." },
19
+ "ledger": { "type": "string", "description": "The ledger file the decisions were appended to, when they were." },
20
+ "decisions": { "type": "array", "items": { "$ref": "#/$defs/decision" } }
21
+ }
22
+ },
23
+ "failure": {
24
+ "type": "object",
25
+ "required": ["$schema", "contract", "chant", "error"],
26
+ "properties": {
27
+ "$schema": { "const": "https://intentius.io/chant/schemas/workspace/ref-gate/v1/ref-gate.schema.json" },
28
+ "contract": { "const": 1 },
29
+ "chant": { "type": "string" },
30
+ "error": { "$ref": "#/$defs/error" }
31
+ }
32
+ },
33
+ "error": {
34
+ "type": "object",
35
+ "required": ["code", "message"],
36
+ "properties": {
37
+ "code": { "enum": ["not-a-git-repository", "revision-unknown", "trust-policy-unreadable", "ref-update-invalid"] },
38
+ "message": { "type": "string" }
39
+ }
40
+ },
41
+ "oid": { "type": ["string", "null"], "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" },
42
+ "decision": {
43
+ "type": "object",
44
+ "required": ["ref", "old", "new", "base", "decision", "status", "checks"],
45
+ "properties": {
46
+ "ref": { "type": "string" },
47
+ "old": { "$ref": "#/$defs/oid", "description": "The ref's tip before the update; null for a new ref." },
48
+ "new": { "$ref": "#/$defs/oid", "description": "The tip the update sets; null for a deletion." },
49
+ "base": { "$ref": "#/$defs/oid", "description": "The commit the policy was read at; null when there is none, and nothing is required." },
50
+ "decision": { "enum": ["admit", "refuse"] },
51
+ "status": { "type": ["string", "null"], "description": "The commit status a forge requires for the ref, when a rule matched." },
52
+ "checks": { "type": "array", "items": { "$ref": "#/$defs/check" } },
53
+ "error": { "$ref": "#/$defs/error", "description": "Set when the gate could not decide; the update is refused." }
54
+ }
55
+ },
56
+ "check": {
57
+ "type": "object",
58
+ "required": ["check", "action", "command", "status", "reason", "subject"],
59
+ "properties": {
60
+ "check": { "type": "string" },
61
+ "action": { "enum": ["block", "warn"] },
62
+ "command": { "type": "string", "description": "The command that produces the evidence." },
63
+ "status": { "enum": ["current", "stale", "missing", "overridden"] },
64
+ "code": {
65
+ "enum": ["ref-evidence-missing", "ref-evidence-stale", "envelope-invalid", "envelope-untrusted", "evidence-payload-type", "evidence-statement-invalid", "evidence-runner-mismatch"],
66
+ "description": "Why the check has no current evidence."
67
+ },
68
+ "reason": { "type": "string" },
69
+ "runner": { "type": "string", "description": "The runner whose evidence counted." },
70
+ "subject": { "type": "string", "description": "The subject an override of this check names: ref-gate-<sha12>-<check>." },
71
+ "override": {
72
+ "type": "object",
73
+ "required": ["subject", "by", "at", "reason", "digest"],
74
+ "properties": {
75
+ "subject": { "type": "string" },
76
+ "by": { "type": "string" },
77
+ "at": { "type": "string" },
78
+ "reason": { "type": "string" },
79
+ "digest": { "type": "string" }
80
+ }
81
+ }
82
+ }
83
+ }
84
+ }
85
+ }
@@ -0,0 +1,115 @@
1
+ /**
2
+ * Which of the plan job's two named checks, `plan` and `policy`, passed
3
+ * (#4870), read from what the plan job hands its note job, and the line the
4
+ * plan note gets saying which were signed.
5
+ *
6
+ * The policy (Rego, CrossGuard, a product's rules) is evaluated inside the
7
+ * plan, so one job stands for both checks:
8
+ *
9
+ * - `plan` passed when the plan job succeeded and left a report.
10
+ * - `policy` passed when a policy ran and denied nothing that stands: a
11
+ * `pr-plan.json` whose `policy.result` is `passed` or `held`, or `denied`
12
+ * with an override; a plan note hand-off whose waves carry the policy's
13
+ * word and whose every denial has its override. A plan that ran no policy
14
+ * signs no `policy`.
15
+ *
16
+ * Kept apart from ./check-evidence.ts so `pr-post` reads the note file
17
+ * without loading the signer.
18
+ */
19
+
20
+ import { existsSync, readFileSync } from "node:fs";
21
+ import { join } from "node:path";
22
+
23
+ /** The variable a generated job hands the runner key in, as PEM (the same one the tick and `chant ci run` read). */
24
+ export const CHECK_EVIDENCE_KEY_ENV = "CHANT_RUNNER_KEY";
25
+
26
+ /** The variable a developer's or an agent's local evidence key is read from, as PEM (#4868). A check hook never sees it. */
27
+ export const LOCAL_EVIDENCE_KEY_ENV = "CHANT_LOCAL_EVIDENCE_KEY";
28
+
29
+ /**
30
+ * The variable a generated job sets to `oidc` when it signs keyless from
31
+ * its OIDC identity (#4869) instead of with a runner key.
32
+ */
33
+ export const RUNNER_IDENTITY_ENV = "CHANT_RUNNER_IDENTITY";
34
+
35
+ /** The GitLab `id_tokens` variable a keyless signing job's token comes in (#4869), with the signing audience. */
36
+ export const SIGNING_ID_TOKEN_VAR = "CHANT_ID_TOKEN_SIGSTORE";
37
+
38
+ /** The file the signing step writes beside the plan report, which `pr-post` reads. */
39
+ export const CHECK_EVIDENCE_FILE = "evidence.json";
40
+
41
+ /** What the signing step did, for the note and the log. */
42
+ export interface CheckEvidenceNote {
43
+ signed: Array<{ check: string; runner: string; commit: string; tree: string }>;
44
+ skipped: Array<{ check: string; reason: string }>;
45
+ }
46
+
47
+ const REPORT_FILE = "pr-plan.json";
48
+ const HANDOFF_FILE = "pr-plan-note.json";
49
+
50
+ function readJson(path: string): Record<string, unknown> | undefined {
51
+ try {
52
+ const v = JSON.parse(readFileSync(path, "utf-8")) as unknown;
53
+ return v !== null && typeof v === "object" && !Array.isArray(v) ? (v as Record<string, unknown>) : undefined;
54
+ } catch {
55
+ return undefined;
56
+ }
57
+ }
58
+
59
+ /** The policy's verdict in a report: passed, denied, or none ran. */
60
+ function policyOf(dir: string): { passed: boolean; reason: string } | null {
61
+ const report = existsSync(join(dir, REPORT_FILE)) ? readJson(join(dir, REPORT_FILE)) : undefined;
62
+ if (report) {
63
+ const p = report.policy as { result?: string; override?: unknown } | undefined;
64
+ if (!p || typeof p.result !== "string") return null;
65
+ if (p.result === "passed" || p.result === "held") return { passed: true, reason: `the policy ${p.result === "held" ? "held the plan for an approval and denied nothing" : "passed"}` };
66
+ if (p.result === "denied" && p.override) return { passed: true, reason: "the policy denied the plan and an override stands" };
67
+ return { passed: false, reason: p.result === "error" ? "the policy did not run or gave no readable answer" : "the policy denied the plan" };
68
+ }
69
+ const handoff = existsSync(join(dir, HANDOFF_FILE)) ? readJson(join(dir, HANDOFF_FILE)) : undefined;
70
+ const note = handoff?.note as { waves?: Array<{ policy?: unknown }>; overrides?: Array<{ override?: unknown }> } | undefined;
71
+ if (!note) return null;
72
+ const overrides = note.overrides ?? [];
73
+ const ran = overrides.length > 0 || (note.waves ?? []).some((w) => w.policy !== undefined);
74
+ if (!ran) return null;
75
+ const standing = overrides.filter((o) => !o.override).length;
76
+ return standing === 0 ? { passed: true, reason: "the policy denied nothing that stands" } : { passed: false, reason: `the policy denied ${standing} unit${standing === 1 ? "" : "s"} with no override` };
77
+ }
78
+
79
+ /** The checks to sign from the plan job's hand-off directory and result, and those left unsigned with why. */
80
+ export function planReportChecks(dir: string, result: string | undefined): { sign: Array<{ check: string; claim?: Buffer }>; skipped: CheckEvidenceNote["skipped"] } {
81
+ const file = [REPORT_FILE, HANDOFF_FILE].map((f) => join(dir, f)).find((f) => existsSync(f));
82
+ if (result !== "success") {
83
+ const why = `the plan job's result is ${result ?? "not given"}`;
84
+ return { sign: [], skipped: [{ check: "plan", reason: why }, { check: "policy", reason: why }] };
85
+ }
86
+ if (!file) {
87
+ const why = `the plan job left no ${REPORT_FILE} or ${HANDOFF_FILE}`;
88
+ return { sign: [], skipped: [{ check: "plan", reason: why }, { check: "policy", reason: why }] };
89
+ }
90
+ const claim = readFileSync(file);
91
+ const sign: Array<{ check: string; claim?: Buffer }> = [{ check: "plan", claim }];
92
+ const skipped: CheckEvidenceNote["skipped"] = [];
93
+ const policy = policyOf(dir);
94
+ if (policy === null) skipped.push({ check: "policy", reason: "the plan ran no policy" });
95
+ else if (policy.passed) sign.push({ check: "policy", claim });
96
+ else skipped.push({ check: "policy", reason: policy.reason });
97
+ return { sign, skipped };
98
+ }
99
+
100
+ /**
101
+ * The line the plan note ends with when the signing step wrote
102
+ * {@link CHECK_EVIDENCE_FILE} in `dir`, or undefined when it did not.
103
+ */
104
+ export function checkEvidenceNoteLine(dir: string): string | undefined {
105
+ const doc = readJson(join(dir, CHECK_EVIDENCE_FILE)) as Partial<CheckEvidenceNote> | undefined;
106
+ if (!doc || !Array.isArray(doc.signed) || !Array.isArray(doc.skipped)) return undefined;
107
+ const signed = doc.signed.map((s) => `\`${s.check}\``);
108
+ const skipped = doc.skipped.map((s) => `\`${s.check}\` (${s.reason})`);
109
+ if (signed.length === 0 && skipped.length === 0) return undefined;
110
+ const parts = [
111
+ ...(signed.length > 0 ? [`signed evidence for ${signed.join(", ")} as ${doc.signed[0]!.runner}`] : []),
112
+ ...(skipped.length > 0 ? [`not signed: ${skipped.join(", ")}`] : []),
113
+ ];
114
+ return `Checks: ${parts.join("; ")}.`;
115
+ }
@@ -0,0 +1,133 @@
1
+ /**
2
+ * #4870: evidence for each named check, attached as git notes where the ref
3
+ * gate (#4867) reads it, found by the commit's tree and verified against the
4
+ * runner keys at base. The attacker
5
+ * controls the change: a runner key the change adds, a tree that differs
6
+ * from the one signed, and a person's key posing as a runner's.
7
+ */
8
+
9
+ import { execFileSync } from "node:child_process";
10
+ import { generateKeyPairSync } from "node:crypto";
11
+ import { mkdirSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs";
12
+ import { tmpdir } from "node:os";
13
+ import { join } from "node:path";
14
+ import { describe, expect, test } from "vitest";
15
+ import { loadRunnerKey } from "./dsse";
16
+ import { checkStatement, missingCheckEvidence, readCheckEvidence, recordChecks, runnerKeyEvidenceSigner, signChecks } from "./check-evidence";
17
+ import { CHECK_EVIDENCE_FILE, checkEvidenceNoteLine, planReportChecks } from "./check-evidence-report";
18
+
19
+ function git(cwd: string, ...args: string[]): string {
20
+ return execFileSync("git", ["-c", "user.name=t", "-c", "user.email=t@example.invalid", "-c", "init.defaultBranch=main", ...args], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).trim();
21
+ }
22
+
23
+ function runnerKey(): { pem: string; pub: string } {
24
+ const { privateKey } = generateKeyPairSync("ed25519");
25
+ const pem = privateKey.export({ format: "pem", type: "pkcs8" }).toString();
26
+ return { pem, pub: loadRunnerKey(pem).publicKey };
27
+ }
28
+
29
+ function trust(runners: Array<{ principal: string; key: string }>): string {
30
+ return JSON.stringify({ schema: 1, runners: runners.map((r) => ({ ...r, class: "runner" })) });
31
+ }
32
+
33
+ /** A repository whose base lists `ci`'s key as a runner, and a change on top of it. */
34
+ function repo(): { dir: string; base: string; head: string; ci: { pem: string; pub: string } } {
35
+ const dir = mkdtempSync(join(tmpdir(), "chant-4870-"));
36
+ const ci = runnerKey();
37
+ git(dir, "init", "--quiet");
38
+ mkdirSync(join(dir, ".chant"));
39
+ writeFileSync(join(dir, ".chant/trust.json"), trust([{ principal: "ci", key: ci.pub }]));
40
+ writeFileSync(join(dir, "main.tf"), "# base\n");
41
+ git(dir, "add", ".");
42
+ git(dir, "commit", "--quiet", "-m", "base");
43
+ const base = git(dir, "rev-parse", "HEAD");
44
+ writeFileSync(join(dir, "main.tf"), "# change\n");
45
+ git(dir, "commit", "--quiet", "-am", "change");
46
+ return { dir, base, head: git(dir, "rev-parse", "HEAD"), ci };
47
+ }
48
+
49
+ describe("check evidence (#4870)", () => {
50
+ test("a signed check is current for its commit, and for another commit with the same tree", async () => {
51
+ const r = repo();
52
+ const signer = runnerKeyEvidenceSigner(r.dir, r.base, r.ci.pem);
53
+ const signed = await signChecks(r.dir, r.head, [{ check: "plan", claim: "{}" }, { check: "policy" }], signer);
54
+ expect(signed.map((s) => s.check)).toEqual(["plan", "policy"]);
55
+ await recordChecks(r.dir, signed, { push: false });
56
+ expect(await readCheckEvidence(r.dir, r.head, r.base, ["plan", "policy"])).toEqual([
57
+ { check: "plan", status: "current", runner: "ci", commit: r.head },
58
+ { check: "policy", status: "current", runner: "ci", commit: r.head },
59
+ ]);
60
+ // A squash of the same change onto the base: another commit, the same tree.
61
+ git(r.dir, "checkout", "--quiet", r.base);
62
+ git(r.dir, "checkout", "--quiet", r.head, "--", "main.tf");
63
+ git(r.dir, "commit", "--quiet", "-m", "squashed");
64
+ const squash = git(r.dir, "rev-parse", "HEAD");
65
+ expect(squash).not.toBe(r.head);
66
+ expect((await readCheckEvidence(r.dir, squash, r.base, ["plan"]))[0]).toMatchObject({ status: "current", commit: r.head });
67
+ });
68
+
69
+ test("a commit whose tree differs has none, and the refusal names each missing check and its command", async () => {
70
+ const r = repo();
71
+ await recordChecks(r.dir, await signChecks(r.dir, r.head, [{ check: "plan" }], runnerKeyEvidenceSigner(r.dir, r.base, r.ci.pem)), { push: false });
72
+ expect((await readCheckEvidence(r.dir, r.base, r.base, ["plan"]))[0]!.status).toBe("missing");
73
+ const refused = await missingCheckEvidence(r.dir, r.head, r.base, ["plan", "policy"]);
74
+ expect(refused).toContain("policy");
75
+ expect(refused).toContain("chant ci evidence sign --check-id policy");
76
+ expect(refused).not.toMatch(/\bplan \(/);
77
+ expect(await missingCheckEvidence(r.dir, r.head, r.base, ["plan"])).toBeNull();
78
+ });
79
+
80
+ test("a runner key the change adds signs nothing the base trusts", async () => {
81
+ const r = repo();
82
+ const added = runnerKey();
83
+ writeFileSync(join(r.dir, ".chant/trust.json"), trust([{ principal: "ci", key: r.ci.pub }, { principal: "mine", key: added.pub }]));
84
+ git(r.dir, "commit", "--quiet", "-am", "add my key");
85
+ const head = git(r.dir, "rev-parse", "HEAD");
86
+ expect(() => runnerKeyEvidenceSigner(r.dir, r.base, added.pem)).toThrow(/lists no runner with this key/);
87
+ // Signed against the change's own policy, and kept: the base still does not trust it.
88
+ await recordChecks(r.dir, await signChecks(r.dir, head, [{ check: "plan" }], runnerKeyEvidenceSigner(r.dir, head, added.pem)), { push: false });
89
+ expect((await readCheckEvidence(r.dir, head, r.base, ["plan"]))[0]).toMatchObject({ status: "untrusted" });
90
+ expect(await readCheckEvidence(r.dir, head, head, ["plan"])).toEqual([{ check: "plan", status: "current", runner: "mine", commit: head }]);
91
+ });
92
+
93
+ test("the statement binds the commit, its tree and the check's name, and no record", () => {
94
+ const s = checkStatement({ commit: "a".repeat(40), tree: "b".repeat(40), check: "check-root:prod", runner: "ci", claim: "x" });
95
+ expect(s.subject).toEqual([]);
96
+ expect(s.predicate).toMatchObject({ commit: "a".repeat(40), tree: "b".repeat(40), check: "check-root:prod", runner: "ci" });
97
+ expect(s.predicate.claim?.sha256).toMatch(/^[0-9a-f]{64}$/);
98
+ });
99
+ });
100
+
101
+ describe("the plan job's two checks (#4870)", () => {
102
+ const dir = (files: Record<string, unknown>): string => {
103
+ const d = mkdtempSync(join(tmpdir(), "chant-4870-report-"));
104
+ for (const [name, body] of Object.entries(files)) writeFileSync(join(d, name), JSON.stringify(body));
105
+ return d;
106
+ };
107
+
108
+ test("plan and policy from a pr-plan.json whose policy passed; only plan when it denied or ran none", () => {
109
+ expect(planReportChecks(dir({ "pr-plan.json": { policy: { result: "passed" } } }), "success").sign.map((c) => c.check)).toEqual(["plan", "policy"]);
110
+ const denied = planReportChecks(dir({ "pr-plan.json": { policy: { result: "denied" } } }), "success");
111
+ expect(denied.sign.map((c) => c.check)).toEqual(["plan"]);
112
+ expect(denied.skipped).toEqual([{ check: "policy", reason: "the policy denied the plan" }]);
113
+ expect(planReportChecks(dir({ "pr-plan.json": { policy: { result: "denied", override: { by: "a" } } } }), "success").sign.map((c) => c.check)).toEqual(["plan", "policy"]);
114
+ expect(planReportChecks(dir({ "pr-plan.json": {} }), "success").skipped).toEqual([{ check: "policy", reason: "the plan ran no policy" }]);
115
+ });
116
+
117
+ test("a plan note hand-off: policy passes when every denial has its override", () => {
118
+ const handoff = (overrides: unknown[]) => ({ "pr-plan-note.json": { kind: "plan-note-handoff", note: { waves: [{ policy: { outcome: "held", rules: [] } }], overrides } } });
119
+ expect(planReportChecks(dir(handoff([{ member: "a", rules: ["r"], override: { by: "x" }, overriders: [] }])), "success").sign.map((c) => c.check)).toEqual(["plan", "policy"]);
120
+ expect(planReportChecks(dir(handoff([{ member: "a", rules: ["r"], overriders: [] }])), "success").sign.map((c) => c.check)).toEqual(["plan"]);
121
+ });
122
+
123
+ test("a failed plan job signs neither, and the note line says which were signed", () => {
124
+ const failed = planReportChecks(dir({ "pr-plan.json": { policy: { result: "passed" } } }), "failure");
125
+ expect(failed.sign).toEqual([]);
126
+ expect(failed.skipped.map((s) => s.check)).toEqual(["plan", "policy"]);
127
+ const d = dir({});
128
+ expect(checkEvidenceNoteLine(d)).toBeUndefined();
129
+ writeFileSync(join(d, CHECK_EVIDENCE_FILE), JSON.stringify({ signed: [{ check: "plan", runner: "ci", commit: "c", tree: "t" }], skipped: [{ check: "policy", reason: "the policy denied the plan" }] }));
130
+ expect(checkEvidenceNoteLine(d)).toBe("Checks: signed evidence for `plan` as ci; not signed: `policy` (the policy denied the plan).");
131
+ expect(readFileSync(join(d, CHECK_EVIDENCE_FILE), "utf-8")).toContain("plan");
132
+ });
133
+ });