@consiliency/contract 0.6.5 → 0.7.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.
- package/README.md +39 -2
- package/conformance/registries/authority-key-registry.test.json +48 -0
- package/conformance/vectors/authority-algorithm-confusion.json +1 -1
- package/conformance/vectors/authority-bad-signature.json +1 -1
- package/conformance/vectors/authority-cert-digest-mismatch.json +1 -1
- package/conformance/vectors/authority-chain-appended-still-verifies.json +1 -1
- package/conformance/vectors/authority-core-validity-expired.json +1 -1
- package/conformance/vectors/authority-forged-self-minted.json +1 -1
- package/conformance/vectors/authority-key-expired.json +1 -1
- package/conformance/vectors/authority-key-revoked.json +1 -1
- package/conformance/vectors/authority-missing-signature.json +1 -1
- package/conformance/vectors/authority-signer-approver-mismatch.json +1 -1
- package/conformance/vectors/authority-unknown-key-id.json +1 -1
- package/conformance/vectors/authority-valid.json +1 -1
- package/conformance/vectors/authority-wrong-key-valid-id.json +1 -1
- package/core/authority-canon/provenance.json +1 -1
- package/core/contract.json +21 -3
- package/core/registries/authority-key-registry.json +3 -3
- package/core/schemas/git-discipline-protocol.schema.json +1 -1
- package/core/schemas/version-skew-protocol.schema.json +3 -3
- package/core/supervised-run/admitted-launch-envelope.schema.json +226 -0
- package/core/supervised-run/admitted-launch-envelope.v2.schema.json +880 -0
- package/core/supervised-run/conformance/README.md +55 -0
- package/core/supervised-run/conformance/README.v2.md +297 -0
- package/core/supervised-run/conformance/SHA256SUMS +10 -0
- package/core/supervised-run/conformance/envelope.v2.apply.vectors.json +1938 -0
- package/core/supervised-run/conformance/envelope.v2.canonical.vectors.json +2088 -0
- package/core/supervised-run/conformance/envelope.v2.vectors.json +16359 -0
- package/core/supervised-run/conformance/envelope.vectors.json +557 -0
- package/core/supervised-run/conformance/run-status.vectors.json +2150 -0
- package/core/supervised-run/provenance.json +116 -0
- package/core/supervised-run/run-status.schema.json +768 -0
- package/package.json +1 -1
- package/src/index.d.ts +3 -1
- package/src/index.js +8 -1
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Conformance vectors: admitted_launch_envelope.v1 and supervised_run_status.v1
|
|
2
|
+
|
|
3
|
+
Status: **provisional**. These files define a harness-neutral, language-neutral contract and its golden valid and
|
|
4
|
+
negative vectors. They name no deployment, repository, host or application, and are meant to be vendored unchanged.
|
|
5
|
+
|
|
6
|
+
## Files
|
|
7
|
+
|
|
8
|
+
| File | Content |
|
|
9
|
+
|---|---|
|
|
10
|
+
| `../admitted-launch-envelope.schema.json` | JSON Schema (draft 2020-12) for the envelope a harness receives after admission, its fixed enforcement tiers (`x-enforcement-tiers`) and its semantic rules (`x-semantic-rules`) |
|
|
11
|
+
| `../run-status.schema.json` | JSON Schema for the journal line, projection, page request, page and reader view (`$defs`), journal rules (`x-journal-rules`) and semantic rules (`x-semantic-rules`) |
|
|
12
|
+
| `envelope.vectors.json` | admission and caller-context echo vectors |
|
|
13
|
+
| `run-status.vectors.json` | journal, projection, liveness, reader-view and page vectors |
|
|
14
|
+
| `SHA256SUMS` | sha256 of the four files above and this README; pin its digest when vendoring |
|
|
15
|
+
|
|
16
|
+
## Reading a vector
|
|
17
|
+
|
|
18
|
+
Each file has `cases`. A case with `role: control` carries a complete `input` and expects no diagnostics. A case with
|
|
19
|
+
`role: negative` names its `control` and a `patch`: a JSON Patch (RFC 6902, operations `add`, `remove` and `replace`
|
|
20
|
+
with RFC 6901 pointers) applied to a copy of the control's input. When `rehash` is `true`, recompute
|
|
21
|
+
`envelope.envelope_digest` after patching, so the negative authority self-verifies and must be refused on its merits.
|
|
22
|
+
|
|
23
|
+
`expected` is the exact set of diagnostic codes a conforming reader or validator reports. A refusal that comes from
|
|
24
|
+
JSON Schema validation instead of the named semantic rule does not satisfy a negative vector: every vector is
|
|
25
|
+
schema-valid by construction. `expected_effect`, when present, is matched as a subset of the reported effect:
|
|
26
|
+
|
|
27
|
+
- admission: `attempt.state` is `queued` when admitted, or `refused` with `worker_invocations: 0` and a typed
|
|
28
|
+
`refusal` (`reason`, `constraint`, `tier`) before any process starts;
|
|
29
|
+
- journal and liveness: `display` lists the state shown per attempt (`unknown` for any fail-closed journal
|
|
30
|
+
condition; `stale_unknown` when the owner is not live);
|
|
31
|
+
- projection: `display` is `current` or `stale`.
|
|
32
|
+
|
|
33
|
+
## Digests and bytes
|
|
34
|
+
|
|
35
|
+
- `envelope_digest` is the SHA-256 of the RFC 8785 (JCS) serialization of the envelope without `envelope_digest`.
|
|
36
|
+
The vectors use ASCII object keys and integers only, so JCS key order is plain code-point order.
|
|
37
|
+
- A journal attempt is a list of segments. Each segment lists its lines: an object line is serialized with JCS and a
|
|
38
|
+
string line is the exact raw text of that line. Segment bytes are the lines joined by LF, plus a final LF when
|
|
39
|
+
`final_newline` is `true`. A segment header's `previous_segment_sha256` is the SHA-256 of the previous segment's
|
|
40
|
+
bytes.
|
|
41
|
+
|
|
42
|
+
## Reader obligations the vectors exercise
|
|
43
|
+
|
|
44
|
+
- `seq` is the only ordering; `observed_at` is informational.
|
|
45
|
+
- A torn last line, an unknown schema or version, a foreign writer, a seq gap or regression, a broken segment chain or
|
|
46
|
+
a foreign attempt identity fail closed: the attempt is shown unknown and the reader never truncates or repairs.
|
|
47
|
+
- `refused` exists only before a process starts. `finished` needs `termination {reason, signal, by}`.
|
|
48
|
+
`completed` is runtime data, never a work outcome or evidence.
|
|
49
|
+
- Records hold digests and repository-relative locators only; event text is at most 200 characters, has no line
|
|
50
|
+
breaks and is labelled `untrusted_display_text`.
|
|
51
|
+
- A later attempt never copies an earlier attempt's evidence; equal proposal digests across attempts are legitimate
|
|
52
|
+
when each attempt binds its own envelope, run and attempt ids.
|
|
53
|
+
- A projection behind the journal tail is shown stale; pages are bounded (at most 100) and report `has_more` and
|
|
54
|
+
omitted counts.
|
|
55
|
+
- `caller_context` is opaque and echoed byte-for-byte.
|
|
@@ -0,0 +1,297 @@
|
|
|
1
|
+
# Conformance vectors: admitted_launch_envelope.v2
|
|
2
|
+
|
|
3
|
+
Status: **provisional**. `admitted_launch_envelope.v2` is a harness-neutral, language-neutral contract, published
|
|
4
|
+
alongside the frozen `admitted_launch_envelope.v1`. It names no deployment, repository, host or application, and is
|
|
5
|
+
meant to be vendored unchanged. `README.md` in this directory still describes v1 and `supervised_run_status.v1`; it is
|
|
6
|
+
part of the frozen v1 pin set, so it is not edited.
|
|
7
|
+
|
|
8
|
+
## Files
|
|
9
|
+
|
|
10
|
+
| File | Content |
|
|
11
|
+
|---|---|
|
|
12
|
+
| `../admitted-launch-envelope.v2.schema.json` | JSON Schema (draft 2020-12) for the v2 envelope, plus its normative annotations: tiers, constraint semantics, route qualification and grant coverage, locator grammar, environment commitment, process boundary, digest forms, apply outcomes, evaluation order and semantic rules |
|
|
13
|
+
| `envelope.v2.vectors.json` | admission and caller-context echo vectors |
|
|
14
|
+
| `envelope.v2.canonical.vectors.json` | RFC 8785 number, document and parse-boundary vectors, and source-tree capture vectors |
|
|
15
|
+
| `envelope.v2.apply.vectors.json` | write_scope apply-check vectors and runtime-journal vectors |
|
|
16
|
+
| `README.v2.md` | this file |
|
|
17
|
+
| `SHA256SUMS` | its first five lines are the v1 manifest, byte for byte; the lines after them add the five v2 files |
|
|
18
|
+
|
|
19
|
+
v1 files and their digests do not change. A v1 envelope is not a v2 envelope (the `schema` const differs and `launch`
|
|
20
|
+
is required); a reader selects the contract by `schema`.
|
|
21
|
+
|
|
22
|
+
## What v2 binds
|
|
23
|
+
|
|
24
|
+
v2 keeps every v1 field with its v1 meaning and adds one required, closed `launch` block. It binds, by digest or
|
|
25
|
+
logical locator only, every input that determines what process starts and what it is given:
|
|
26
|
+
|
|
27
|
+
| `launch` field | Binds |
|
|
28
|
+
|---|---|
|
|
29
|
+
| `action`, `transport_id`, `stdin` | execution or review; the route the harness selected; stdin is the instruction bytes once then end of file (`input`) or nothing (`devnull`) |
|
|
30
|
+
| `instructions` | SHA-256 and length of the exact instruction bytes, and their `source` (null only when genuinely inline) |
|
|
31
|
+
| `references` | ordered role, SHA-256, length and `source` of every other consumed byte sequence: exactly one `baseline`, plus `context` and `config` files |
|
|
32
|
+
| `argv` | SHA-256 of the UTF-8 RFC 8785 array that starts the outermost chain entry, and its length |
|
|
33
|
+
| `executable_chain` | every wrapper, outermost first, then the executable: locator (repository-relative or a declared name) and raw-file SHA-256 |
|
|
34
|
+
| `workspace_state` | base commit (or null), tree-manifest digest of the materialized source tree including overlays, the worker `cwd`, and the workspace-to-protected target map |
|
|
35
|
+
| `environment` | SHA-256 of the redacted environment object (no secret values), and the id and raw-byte digest of the policy that builds and classifies it |
|
|
36
|
+
| `trusted_policy` | raw-byte SHA-256 of the trusted configuration, the template (including declared helper transformations) and the qualification evidence (null when there is none) |
|
|
37
|
+
| `stop` | `timeout_seconds` (integer, 1 to 3600) and `deadline_action` |
|
|
38
|
+
| `grants` (optional) | `{canonical_form, sha256}` of the filesystem view, descriptor capabilities, dependency projection, supervisor identity and egress policy actually applied |
|
|
39
|
+
|
|
40
|
+
Tier and constraints, and the assignment, snapshot, project and dependency authority, stay where v1 has them.
|
|
41
|
+
`caller_context` stays required and opaque, and is never a source of any launch input.
|
|
42
|
+
|
|
43
|
+
## Locators and sources
|
|
44
|
+
|
|
45
|
+
Every relative locator follows `x-locator-grammar`: one or more `/`-separated segments, none empty, `.` or `..`; no
|
|
46
|
+
`:`, backslash, control character, or leading, trailing or repeated `/`. Invalid input is refused
|
|
47
|
+
(`locator_not_repo_relative`), never normalized; only a cwd path may be exactly `.`.
|
|
48
|
+
|
|
49
|
+
A source is one of:
|
|
50
|
+
|
|
51
|
+
- `{"namespace": "workspace", "path": ...}`: a path in the captured source tree. The tree must hold exactly one
|
|
52
|
+
regular or executable file entry at that path with the same digest. A symlink or a missing entry does not count.
|
|
53
|
+
- `{"namespace": "declared_root", "root": ..., "path": ...}`: under a root the trusted configuration declares. The
|
|
54
|
+
physical location stays local.
|
|
55
|
+
- `{"namespace": "descriptor", "descriptor": ...}`: behind a descriptor that the bound descriptor_capabilities grant
|
|
56
|
+
lists.
|
|
57
|
+
|
|
58
|
+
Sources outside the workspace are captured, hashed and rechecked where they are. They are never copied into the
|
|
59
|
+
workspace to fit the schema.
|
|
60
|
+
|
|
61
|
+
The working directory is `{"namespace": "workspace", "path": ...}`, relative to the source tree, or
|
|
62
|
+
`{"namespace": "view_root", "root": ..., "path": ...}`, under a root the bound filesystem_view grant declares. Moving the
|
|
63
|
+
cwd never changes the source-tree digest. Files a route discovers from its cwd must be bound as references.
|
|
64
|
+
|
|
65
|
+
## Environment commitment and secrets
|
|
66
|
+
|
|
67
|
+
`environment.map_sha256` is the SHA-256 of the UTF-8 RFC 8785 serialization of the closed object below:
|
|
68
|
+
|
|
69
|
+
- `non_secret`: every non-secret variable of the effective worker environment, with its value;
|
|
70
|
+
- `secret_names`: the secret variables actually present, sorted by UTF-16 code units, names only.
|
|
71
|
+
|
|
72
|
+
The bound environment policy classifies every variable, in trust, as non-secret or as secret with its credential
|
|
73
|
+
source. A variable it does not classify fails closed. Each secret's source must be authorized by the single matching
|
|
74
|
+
qualification record (`grant_unqualified` otherwise).
|
|
75
|
+
|
|
76
|
+
No secret value, and no digest of one, may appear in any commitment: the envelope itself, `caller_context`
|
|
77
|
+
included (member names, nested values and arrays, after decoding escapes), argv, references, and policy, template or
|
|
78
|
+
grant documents. `caller_context` stays opaque. That means no field has a meaning, and generic secret-safety
|
|
79
|
+
validation is not interpretation. Its producer must not put secrets in it, and a known secret or derived digest
|
|
80
|
+
found there is `launch_input_unbound`; the payload is never redacted to pass. A route that would need one bound is not representable. Rotating a secret value leaves the envelope
|
|
81
|
+
unchanged; the vectors `E2-secret-env` and `E2-secret-env-rotated` show this. The digest is deterministic, unsalted
|
|
82
|
+
and unkeyed. It commits the non-secret content but does not keep it confidential.
|
|
83
|
+
|
|
84
|
+
## Process boundary and delivery
|
|
85
|
+
|
|
86
|
+
- **argv:** binds the outermost spawn.
|
|
87
|
+
- **environment and cwd:** bind the effective worker after the helper transformations declared in the bound template.
|
|
88
|
+
These are argument consumption, consumed and set variables, and a cwd change. The spawn environment and cwd are
|
|
89
|
+
exactly what those transformations need, with nothing ambient.
|
|
90
|
+
- **deadline:** starts at the first launch-chain process and is never restarted.
|
|
91
|
+
- **qualification probes:** run before admission. They are not worker invocations and must not change captured
|
|
92
|
+
material.
|
|
93
|
+
- **refusals:** every admission refusal happens with zero launch-chain processes and zero worker invocations. A
|
|
94
|
+
failure after the chain starts is `running -> finished` (`failed_to_start`), never `refused`.
|
|
95
|
+
|
|
96
|
+
Interactive terminal delivery is not representable in v2. That covers a pseudo-terminal, prompt responses, paste
|
|
97
|
+
framing and input after output. Routes that need it are out of scope and refused; no transport label or grant
|
|
98
|
+
changes that.
|
|
99
|
+
|
|
100
|
+
## Tiers, qualification and grants
|
|
101
|
+
|
|
102
|
+
`x-enforcement-tiers` states each tier's semantics and limits; it does not qualify any installed tool.
|
|
103
|
+
|
|
104
|
+
Admission under a defined tier needs **exactly one** validator-held record that matches the route key. That key is the
|
|
105
|
+
tier, action, transport, executable chain, template digest and qualification digest. Zero or several matches, including
|
|
106
|
+
duplicates, are `route_not_qualified`, decided before any grant check. Records are never chosen by order or merged.
|
|
107
|
+
The single record covers each grant by its exact `{canonical_form, sha256}`. A template or profile record with
|
|
108
|
+
placeholders does not cover a concrete per-run grant.
|
|
109
|
+
|
|
110
|
+
A tier's `checked_before_apply` guarantee runs whether or not `required_constraints` lists it. The write_scope apply
|
|
111
|
+
check rejects the whole proposal, or applies all of it, as an `x-apply-outcomes` work outcome. The attempt's journal
|
|
112
|
+
is still `running -> finished`; a post-launch `refused` is `refused_after_launch`. `write_prevention` is never
|
|
113
|
+
provided by a defined tier.
|
|
114
|
+
|
|
115
|
+
## Reading a vector
|
|
116
|
+
|
|
117
|
+
Each envelope case has `role`:
|
|
118
|
+
|
|
119
|
+
- `control`: a complete `input`, admitted (`expected: []`, effect `queued`).
|
|
120
|
+
- `negative`: a JSON Patch (RFC 6902 `add`, `remove` and `replace`, RFC 6901 pointers) applied to a copy of the named
|
|
121
|
+
control's input. The envelope stays schema-valid; it must be refused by the semantic rules in `expected`.
|
|
122
|
+
- `schema_negative`: a patch that makes the envelope schema-invalid. `expected` is `["envelope_schema_invalid"]`, and
|
|
123
|
+
`expected_schema_errors` is the exact set of `{instance_path, keyword}` pairs. A `type` failure masks the other
|
|
124
|
+
keywords at its node, and `anyOf` is reported at its own node.
|
|
125
|
+
|
|
126
|
+
With `rehash: true`, recompute `envelope_digest` by RFC 8785 after patching. `expected` is the exact set of diagnostics
|
|
127
|
+
of the first reporting stage of `x-evaluation-order`. `expected_effect` is matched as a subset. `finding` names the
|
|
128
|
+
review item a case closes.
|
|
129
|
+
|
|
130
|
+
An admission input has three parts.
|
|
131
|
+
|
|
132
|
+
- `envelope`: the record under test.
|
|
133
|
+
- `validator_context`: what the validator holds independently. That is the expected authority values,
|
|
134
|
+
`timeout_max_seconds`, and `qualified_routes`. Each route has `tier`, `action`, `transport_id`, `executable_chain`,
|
|
135
|
+
`template_sha256`, `qualification_sha256`, `grants` (kind to `{canonical_form, sha256}`) and `credential_sources`.
|
|
136
|
+
- `launch_material`: what the harness captured and is about to use. Text stands for exact UTF-8 bytes.
|
|
137
|
+
- `instructions`, `references[]`: `source`, `content` (null when not captured) and `within_root`.
|
|
138
|
+
- `stdin`: `mode`, which is `pipe`, `devnull` or `pty`, and `writes`, each `{after: start|output, text}`.
|
|
139
|
+
- `process`:
|
|
140
|
+
- `spawn` and `worker`, each `{argv, env, cwd}`;
|
|
141
|
+
- `cwd_resolution` (`within_root`, `discovered` sources);
|
|
142
|
+
- `deadline` (`origin`, `seconds`, `restarted_at_helper`);
|
|
143
|
+
- qualification `probes`.
|
|
144
|
+
- `executable_chain`: the resolved-file digests.
|
|
145
|
+
- `workspace`: `base_commit`, a `capture` listing of filesystem objects, and `target_map`.
|
|
146
|
+
- `environment`: `policy_id`, and `policy` as JSON text with `classification`.
|
|
147
|
+
- `policy`: `config` (with `root <id> = ...` lines), `template` (JSON text with `argv`, `spawn_cwd` and `helpers`),
|
|
148
|
+
`qualification`, and `grants`. Each grant is `{canonical_form: raw_bytes, text}` or
|
|
149
|
+
`{canonical_form: rfc8785, value}`.
|
|
150
|
+
- `unbound_inputs`: any input not covered by the launch block.
|
|
151
|
+
|
|
152
|
+
## Canonicalization (envelope.v2.canonical.vectors.json)
|
|
153
|
+
|
|
154
|
+
RFC 8785 throughout:
|
|
155
|
+
|
|
156
|
+
- members are sorted by UTF-16 code units;
|
|
157
|
+
- numbers use the ECMAScript form, and `-0` serializes as `0`;
|
|
158
|
+
- strings use only the RFC 8785 escapes;
|
|
159
|
+
- the output is UTF-8.
|
|
160
|
+
|
|
161
|
+
Before anything is hashed, the v2 input boundary is checked on raw input and again on in-memory values:
|
|
162
|
+
|
|
163
|
+
- valid UTF-8, no duplicate member names, no lone surrogates;
|
|
164
|
+
- `__proto__` is an ordinary member name like any other;
|
|
165
|
+
- numbers are finite binary64 values, and an integer-valued number must lie within -9007199254740991 through
|
|
166
|
+
9007199254740991, whatever its spelling. So `9007199254740992`, `9007199254740992.0`, `9.007199254740992e15`,
|
|
167
|
+
`1e21` and `999999999999999900000` are all refused. Non-integral numbers stay valid.
|
|
168
|
+
|
|
169
|
+
This is a deliberately narrower v2 profile, not a claim that RFC 8785 disallows larger doubles; large opaque
|
|
170
|
+
identifiers can be strings. Unrepresentable launch input is `launch_input_unbound`.
|
|
171
|
+
|
|
172
|
+
The file contains:
|
|
173
|
+
|
|
174
|
+
- `numbers`: serializer primitives only. They are IEEE-754 bit patterns and their ECMAScript Number-to-String form,
|
|
175
|
+
with the RFC 8785 Appendix B rows copied from the RFC. They prove serialization, not acceptance;
|
|
176
|
+
- `domain`: number tokens, each accepted with its canonical form or refused, through both raw parsing and in-memory
|
|
177
|
+
commitment;
|
|
178
|
+
- `documents`: raw text, the exact canonical text and its digest, or `reject`;
|
|
179
|
+
- `alternates`: wrong preimages that must not match;
|
|
180
|
+
- `tree_captures`: capture listings, the manifest each must yield and its digest, or `unbindable`;
|
|
181
|
+
- `tree_alternates`: the manifests a wrong walk produces, which fail `launch_workspace_mismatch`.
|
|
182
|
+
|
|
183
|
+
Capture follows these rules:
|
|
184
|
+
|
|
185
|
+
- The root `.git` (directory, file or symlink) is excluded without descending; a nested `.git` is ordinary content.
|
|
186
|
+
- A regular file is `executable_file` when its POSIX mode has any of `0o111` set.
|
|
187
|
+
- A symlink hashes its raw target bytes and is never followed.
|
|
188
|
+
- Entries are sorted by the UTF-8 bytes of their path.
|
|
189
|
+
- Other object types, duplicate or ungrammatical paths, and missing modes are unbindable.
|
|
190
|
+
- A represented file, symlink or other non-directory object is never a proper ancestor of another listed path,
|
|
191
|
+
whatever the listing order; directories may be implicit. Capture never traverses a symlink ancestor.
|
|
192
|
+
|
|
193
|
+
## Apply and journals (envelope.v2.apply.vectors.json)
|
|
194
|
+
|
|
195
|
+
- `applications`: a proposal against the bound scope and target map. Each gives the `x-apply-outcomes` outcome and
|
|
196
|
+
the protected state afterwards, which is unchanged unless the outcome is `proposal_applied`. Every fixture has an
|
|
197
|
+
empty `required_constraints`.
|
|
198
|
+
- `journals`: `supervised_run_status.v1` journals whose lines validate against the frozen `journal_line` schema, with
|
|
199
|
+
the diagnostics the frozen rules give.
|
|
200
|
+
|
|
201
|
+
## Worked example: grants with per-run resources (control `E2-grants-worked`)
|
|
202
|
+
|
|
203
|
+
A run writes its output to a run-specific resource. The contract names that resource by logical identity, purpose and
|
|
204
|
+
access (`run-output`, `output`, `write`). The directory it maps to, any descriptor number and any host path stay local.
|
|
205
|
+
The trusted evidence that establishes the concrete mapping for this run is the qualification evidence the validator
|
|
206
|
+
holds, a per-run attestation here; its digest is bound by `trusted_policy.qualification_sha256`.
|
|
207
|
+
|
|
208
|
+
`filesystem_view_sha256`, form `rfc8785` (in-memory structure). Exact UTF-8 preimage:
|
|
209
|
+
|
|
210
|
+
```json
|
|
211
|
+
{"resources":[{"access":"write","id":"run-output","purpose":"output"}],"roots":[{"access":"read","id":"tree"}]}
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
SHA-256: `53b5dee41446896ad01e9dbf6690489b8384a263a8c3c406b7bbc4cb7b6c3e27`
|
|
215
|
+
|
|
216
|
+
`descriptor_capabilities_sha256`, form `rfc8785` (in-memory structure). Exact UTF-8 preimage:
|
|
217
|
+
|
|
218
|
+
```json
|
|
219
|
+
{"descriptors":[{"access":"write","id":"run-output","purpose":"output"}]}
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
SHA-256: `bec2a4cd7032cb76308098bce96308a231bf93127eff0ab673a40ec87a212957`
|
|
223
|
+
|
|
224
|
+
`egress_policy_sha256`, form `raw_bytes` (the loaded document, rules in order). Exact bytes:
|
|
225
|
+
|
|
226
|
+
```text
|
|
227
|
+
egress v1
|
|
228
|
+
1 allow api.example:443
|
|
229
|
+
2 deny *
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
SHA-256: `ed47ec90e18651569e52e868eded06823ebdffd6803805ea8c245859e1d433b7`
|
|
233
|
+
|
|
234
|
+
The envelope's `launch.grants`:
|
|
235
|
+
|
|
236
|
+
```json
|
|
237
|
+
{
|
|
238
|
+
"filesystem_view_sha256": {
|
|
239
|
+
"canonical_form": "rfc8785",
|
|
240
|
+
"sha256": "53b5dee41446896ad01e9dbf6690489b8384a263a8c3c406b7bbc4cb7b6c3e27"
|
|
241
|
+
},
|
|
242
|
+
"descriptor_capabilities_sha256": {
|
|
243
|
+
"canonical_form": "rfc8785",
|
|
244
|
+
"sha256": "bec2a4cd7032cb76308098bce96308a231bf93127eff0ab673a40ec87a212957"
|
|
245
|
+
},
|
|
246
|
+
"egress_policy_sha256": {
|
|
247
|
+
"canonical_form": "raw_bytes",
|
|
248
|
+
"sha256": "ed47ec90e18651569e52e868eded06823ebdffd6803805ea8c245859e1d433b7"
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
The single validator-held qualification record for this route, which covers exactly these commitments (`grants`, serialized by RFC 8785):
|
|
254
|
+
|
|
255
|
+
```json
|
|
256
|
+
{"descriptor_capabilities_sha256":{"canonical_form":"rfc8785","sha256":"bec2a4cd7032cb76308098bce96308a231bf93127eff0ab673a40ec87a212957"},"egress_policy_sha256":{"canonical_form":"raw_bytes","sha256":"ed47ec90e18651569e52e868eded06823ebdffd6803805ea8c245859e1d433b7"},"filesystem_view_sha256":{"canonical_form":"rfc8785","sha256":"53b5dee41446896ad01e9dbf6690489b8384a263a8c3c406b7bbc4cb7b6c3e27"}}
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
Its full route key and coverage:
|
|
260
|
+
|
|
261
|
+
```json
|
|
262
|
+
{
|
|
263
|
+
"tier": "provider_readonly_patch_return_audit",
|
|
264
|
+
"action": "execution",
|
|
265
|
+
"transport_id": "cli",
|
|
266
|
+
"executable_chain": [
|
|
267
|
+
{
|
|
268
|
+
"locator_kind": "declared",
|
|
269
|
+
"locator": "provider-cli",
|
|
270
|
+
"sha256": "4b70047af52679bb9d2955b7270a2f1941c6942ecbd8540f75229d7819f933a0"
|
|
271
|
+
}
|
|
272
|
+
],
|
|
273
|
+
"template_sha256": "297f770282a217a9b0c482d20b080d1baa9eb7bf9ec308fb013ccf501bcc1fe0",
|
|
274
|
+
"qualification_sha256": "ef315227a572d65ee3bd3092be7c0fe9b655867496c6253a8dcd0025b73c3a77",
|
|
275
|
+
"grants": {
|
|
276
|
+
"filesystem_view_sha256": {
|
|
277
|
+
"canonical_form": "rfc8785",
|
|
278
|
+
"sha256": "53b5dee41446896ad01e9dbf6690489b8384a263a8c3c406b7bbc4cb7b6c3e27"
|
|
279
|
+
},
|
|
280
|
+
"descriptor_capabilities_sha256": {
|
|
281
|
+
"canonical_form": "rfc8785",
|
|
282
|
+
"sha256": "bec2a4cd7032cb76308098bce96308a231bf93127eff0ab673a40ec87a212957"
|
|
283
|
+
},
|
|
284
|
+
"egress_policy_sha256": {
|
|
285
|
+
"canonical_form": "raw_bytes",
|
|
286
|
+
"sha256": "ed47ec90e18651569e52e868eded06823ebdffd6803805ea8c245859e1d433b7"
|
|
287
|
+
}
|
|
288
|
+
},
|
|
289
|
+
"credential_sources": []
|
|
290
|
+
}
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
A record covering only the placeholder template (`{run_output}` in place of `run-output`) does not cover this grant
|
|
294
|
+
(`S2-grant-template-only`). Neither does a record that lacks the egress commitment (`S2-grant-uncovered-per-run`) or
|
|
295
|
+
lists the same digest under another form (`S2-grant-form-wrong`). Changing the applied bytes or structure is
|
|
296
|
+
`launch_policy_mismatch` (`S2-grant-raw-whitespace`, `S2-grant-raw-rule-order`, `S2-grant-jcs-value-changed`,
|
|
297
|
+
`S2-grant-jcs-list-order`).
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
0273f7a5d80eab95ee84660cd657445e881431bca3b8f91cec61015a5d39d41d ../admitted-launch-envelope.schema.json
|
|
2
|
+
5118c1ab8604e85990150d66bf6b8c1af979dcc404fc84ee5a3c4ba4fead9a30 ../run-status.schema.json
|
|
3
|
+
2d5045245105af88f1f45f720aa8bc3f366efc95c25e25a9c50e402a175533ca README.md
|
|
4
|
+
876d322c313b444e49d7a95ee8f7ca39eef13c45864c67a0b3877235e1db6d7f envelope.vectors.json
|
|
5
|
+
5bf9dfbf65805f7340290586d546038fc88659785e60e2f55532df4ac6696730 run-status.vectors.json
|
|
6
|
+
6d6b2f89c55d160c2c132c29b3aa330a0a91c40ab017707040478a60b469194f ../admitted-launch-envelope.v2.schema.json
|
|
7
|
+
c6ab5d9da4707adf5dad9602b483b201a2dfe89f638ecba84129e0c477d72637 README.v2.md
|
|
8
|
+
e742d2774d410c2508405eaffed84575b992483da68c07f28591097d6ec5bc2f envelope.v2.vectors.json
|
|
9
|
+
f7f11c7667d12b0c876102781fdd5773074f5301f152a6d18be509894bc0e8f8 envelope.v2.canonical.vectors.json
|
|
10
|
+
57e0fd4d2e88c75bb8dfbab94448431ca3c752f6444febf1bd492323b044c078 envelope.v2.apply.vectors.json
|