Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ To move to 1.0, read the [migration guide](docs/site/migration/to-1-0.md).
## [Unreleased]

### Features Added
- Conformance DK-43 (#443): the `prism.containers` namespace of `prism-code`, with `dispatch`, `inspect`, `logs`, a recorded `allowUnverified` bypass, and volumes refused through `prism.volumes` with the refusal on the record. DK-40 now counts the two container-volume tests.
- `prismpm <module> <verb>` (#441): the Rust CLI groups its commands under the modules of `model/modules.toml`, as `prism-code` does: `prismpm images build|inspect|pull|push|verify|export-browser`, `prismpm verify check|attestation|signature|release|replay|model|conformance|acceptance|browser-publication`, `prismpm auth attest|sign|sign-evidence`, `prismpm system lock|update|fetch|authority|clean`, `prismpm containers run|status` and `prismpm client generate|completion|template`. Each group verb runs its flat command with the same arguments, output and result schema, and the flat commands stay. The table is the `[[group]]` rows of `model/commands.toml`: the model gate checks that each names a registered command, the CLI parses its groups from the same rows, and `CONTRACTS.md` lists them. `prismpm <module>` prints the module's verbs; an unknown verb is `PP1001`. A module that is also a command (`verify`) is a group only when the next word is one of its verbs.
- The developer view of #346 is a LexLean model (#347, experimental): `bindings/src/Foundation/Views/V1/Developer.lex.tex` declares the developer glossary once, each Docker-aligned term over the canonical term it names, the other words of the surface and the deprecated aliases. Its certified export runs in `cargo xtask check-developer-view` (part of `cargo xtask validate`), which checks every verb, flag, namespace and method of the `prism-code` surface against it and renders [docs/developer-glossary.md](docs/developer-glossary.md). Canonical model terms, schema identifiers, predicate URIs and error codes do not change; the renamed `prism-code` spellings are in its own changelog.
- `COMPLIANCE.md` shows the Rust runtime (#449, #298): `sdk/npm/conformance/runtimes.json` registers `prism-conformance-shim`, the npm conformance suite job builds it and runs the suite against it beside prism-code, and the matrix shows both runtimes passing all 24 `verify` checks. `prism.verify.pullClosure` makes every trust decision a pull needs, and signing moves to `auth` (`auth.identities.from`), so the pending `auth.mjs` to `attest.mjs` cut in `model/modules.toml` is made; see the prism-code CHANGELOG.
Expand Down
1 change: 1 addition & 0 deletions CONFORMANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -264,6 +264,7 @@ The three honesty levels:
| `DK-40` | `build` | The prism.volumes namespace of prism-code is a view over the capability file with create, list, inspect and remove: a host-folder mount, a name or provider outside the grant, and a store outside the image's declared world or the active policy are refused with CapabilityDeniedError before any provider runs, attaching a store to a guest raises a typed error naming host effects #216 and #217, and the module never reads or writes a system model and imports only errors and the capability code. |
| `DK-41` | `build` | The prism.system namespace of prism-code reports info, version, df, prune and events over the containers of its own client: info and version name the package, the holo format revision, the runtime and the toolchain and builder image a project's prismpm.lock pins, prune removes exited containers only and no image, events streams the create, start, die and destroy events of the client's containers with since, until and filters, and createPrism and Prism.fromEnv expose the eight other modules of #440 on one client. |
| `DK-42` | `build` | The Rust runtime runs @prism-code/conformance through its shim, prism-conformance-shim, which translates prism/conformance-shim/1 requests to the prismpm library's inspect and verify and judges nothing: every check of the suite runs, the digests checks pass in full, and each check the Rust runtime does not pass is named with its reason in crates/conformance/runtime/declaration.json, so a check that starts to pass or newly fails fails the run. |
| `DK-43` | `build` | The prism.containers namespace of prism-code runs images as containers with Docker's states: run, create, start, dispatch, list, inspect, logs, remove and prune work by id or unique prefix, a holo that fails check exits without instantiating the guest, an allowUnverified bypass is recorded on the prism/container/1 record with its time, error and warning, logs are served from the stored output, a volume a container asks for goes through prism.volumes and its typed host-effects refusal is kept on the record before check runs, and stop waits for #350, which builds it. |
| `DK-44` | `build` | The prism-code system and auth command groups are the CLI of prism.system and prism.auth: system info and version name the package, the holo format, the runtime and the toolchain and builder image the project's prismpm.lock pins, events replays and follows create, start, die and destroy from the container store with since, until and filters, df counts every record and prune removes exited containers only and asks first unless forced; auth login checks the credential with the registry before storing it where Docker would, refuses a password on the command line, and no password reaches stdout, stderr or an error in any spelling, and logout names an ambient token it cannot clear. |

## security
Expand Down
14 changes: 7 additions & 7 deletions ERRORS.md
Original file line number Diff line number Diff line change
Expand Up @@ -958,13 +958,13 @@ Registered in model/sdk-diagnostics.toml. These are the codes the Prism SDK modu
| `closure.glue` | | `OC-11` | The closure glue module has no initSync export, or exports neither invoke_bytes nor calculate. |
| `closure.model` | | `OC-11` | Numeric closure dispatch needs the model document (application.view.operations), and none was given. |
| `closure.provenance` | | `OC-11` | The closure's provenance.json is not JSON or names a schema other than the closure provenance schemas. |
| `container.ambiguous` | | `DK-41` | The id prefix names more than one container; give more of the id. |
| `container.input` | | `DK-41` | A container was given an input that is not one string or bytes. |
| `container.missing` | | `DK-41` | No container has that id. |
| `container.option` | | `DK-41` | prism.containers was given an option it does not have, or one of the wrong type. |
| `container.running` | | `DK-41` | The container is running and cannot be removed. |
| `container.state` | | `DK-41` | The container was read back from its store, which does not keep its input, so it cannot be started again; run the holo again. |
| `container.store` | | `DK-41` | The container store directory cannot be created or written; set PRISM_HOME to a directory that can be written. |
| `container.ambiguous` | | `DK-43` | The id prefix names more than one container; give more of the id. |
| `container.input` | | `DK-43` | A container was given an input that is not one string or bytes. |
| `container.missing` | | `DK-43` | No container has that id. |
| `container.option` | | `DK-43` | prism.containers was given an option it does not have, or one of the wrong type. |
| `container.running` | | `DK-43` | The container is running and cannot be removed. |
| `container.state` | | `DK-43` | The container was read back from its store, which does not keep its input, so it cannot be started again; run the holo again. |
| `container.store` | | `DK-43` | The container store directory cannot be created or written; set PRISM_HOME to a directory that can be written. |
| `core.allocation` | | `DK-41` | The request is larger than the guest allocation maximum. |
| `core.compile` | | `DK-41` | The guest WebAssembly does not compile. |
| `core.exports` | | `DK-41` | The guest exports differ from the exports its ABI expects. |
Expand Down
1 change: 1 addition & 0 deletions SPEC.md
Original file line number Diff line number Diff line change
Expand Up @@ -4491,6 +4491,7 @@ Every row below is normative, has the honesty level registered in `model/ids.tom
| `DK-40` | `sdk` | The prism.volumes namespace of prism-code is a view over the capability file with create, list, inspect and remove: a host-folder mount, a name or provider outside the grant, and a store outside the image's declared world or the active policy are refused with CapabilityDeniedError before any provider runs, attaching a store to a guest raises a typed error naming host effects #216 and #217, and the module never reads or writes a system model and imports only errors and the capability code. | §12 |
| `DK-41` | `sdk` | The prism.system namespace of prism-code reports info, version, df, prune and events over the containers of its own client: info and version name the package, the holo format revision, the runtime and the toolchain and builder image a project's prismpm.lock pins, prune removes exited containers only and no image, events streams the create, start, die and destroy events of the client's containers with since, until and filters, and createPrism and Prism.fromEnv expose the eight other modules of #440 on one client. | §12 |
| `DK-42` | `sdk` | The Rust runtime runs @prism-code/conformance through its shim, prism-conformance-shim, which translates prism/conformance-shim/1 requests to the prismpm library's inspect and verify and judges nothing: every check of the suite runs, the digests checks pass in full, and each check the Rust runtime does not pass is named with its reason in crates/conformance/runtime/declaration.json, so a check that starts to pass or newly fails fails the run. | §12 |
| `DK-43` | `sdk` | The prism.containers namespace of prism-code runs images as containers with Docker's states: run, create, start, dispatch, list, inspect, logs, remove and prune work by id or unique prefix, a holo that fails check exits without instantiating the guest, an allowUnverified bypass is recorded on the prism/container/1 record with its time, error and warning, logs are served from the stored output, a volume a container asks for goes through prism.volumes and its typed host-effects refusal is kept on the record before check runs, and stop waits for #350, which builds it. | §12 |
| `DK-44` | `sdk` | The prism-code system and auth command groups are the CLI of prism.system and prism.auth: system info and version name the package, the holo format, the runtime and the toolchain and builder image the project's prismpm.lock pins, events replays and follows create, start, die and destroy from the container store with since, until and filters, df counts every record and prune removes exited containers only and asks first unless forced; auth login checks the credential with the registry before storing it where Docker would, refuses a password on the command line, and no password reaches stdout, stderr or an error in any spelling, and logout names an ambient token it cannot clear. | §12 |
| `OC-01` | `oci` | Product releases use OCI 1.1 descriptors, manifests, indexes, subjects, annotations, and referrers with registered media types. | §13 |
| `OC-02` | `oci` | A locked build atomically emits a verified root only after every declared source, proof, package, oracle, and release gate passes. | §13 |
Expand Down
2 changes: 2 additions & 0 deletions STABILITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -185,6 +185,8 @@ Removed: `prism-code check [args]` with no holo, which ran `prismpm check` in th
| `prism-code` | `parseManifest`, `validateManifest`, `lintManifest`, `mergeOverlay`, `manifestCapabilities`, `resolveVariables`, `parseToml`, `MANIFEST_FILE`, `MANIFEST_TARGETS`, `MANIFEST_VERSION`, and the `manifest.*` error codes; `readManifest` in `prism-code/node` | [#280](https://github.com/UOR-Foundation/PrismPM/issues/280) |
| `prism-code` | `manifestProviders`, `ProviderError`, `ProviderNotFoundError`, `ProviderReplyError`, `ProviderFailedError` and their `code`s and `provider.*` checks, the `provider-not-granted` lint warning, the `providers` capability kind and the check `capabilities.providers`; `resolveProviders`, `releaseProviders`, `PROVIDER_MESSAGES`, `PROVIDER_MESSAGES_ENV`, `PROVIDER_TIMEOUT_MS` in `prism-code/node` | [#294](https://github.com/UOR-Foundation/PrismPM/issues/294) |
| `prism-code` | `src/volumes.mjs`: `createVolumes`, its `create`, `list`, `inspect` and `remove`, `attachVolume`, `refusalRecord`, `HOST_EFFECTS`, and the `capabilities.host-folder` and `capabilities.host-effects` checks of `CapabilityDeniedError`. Reached as `prism.volumes` on the client (#441) | [#445](https://github.com/UOR-Foundation/PrismPM/issues/445) |
| `prism-code` | The `prism-code containers create, inspect, logs, ps, rm, run, start` and `prism-code volumes create, inspect, ls, rm` groups (`src/cli/containers.mjs`, `src/cli/volumes.mjs`), their options and output | [#443](https://github.com/UOR-Foundation/PrismPM/issues/443), [#445](https://github.com/UOR-Foundation/PrismPM/issues/445) |
| `prism-code` | `prism.containers` verbs `dispatch`, `inspect` and `logs` (by id or prefix, and on the `Container`), the `volumes` option of `create`, the `allowUnverified`, `unverified` and `volumes` members of `prism/container/1`, and the `Volume`, `CreatedVolume`, `Volumes`, `ContainerVolume` and `VolumeRefusal` types | [#443](https://github.com/UOR-Foundation/PrismPM/issues/443) |
| `prism-code` | `prism.system` in `src/system.mjs`: `createSystem`, `createEventBus`, `info`, `version`, `df`, `prune` and `events`, their options, the `prism/system-info/1`, `prism/system-version/1`, `prism/system-df/1`, `prism/system-prune/1` and `prism/system-event/1` shapes, `EVENT_ACTIONS`, `EVENT_HISTORY` and `IMAGE_STORE`; `containers.list` and `containers.prune`, and the `onEvent` option of `createContainers` | [#446](https://github.com/UOR-Foundation/PrismPM/issues/446) |
| `prism-code` | The `prism-code system info\|version\|events\|df\|prune` and `prism-code auth login\|logout` groups (`src/cli/system.mjs`, `src/cli/auth.mjs`), the top-level `login` and `logout`, their options and `--json` output, and the rule that `login` takes no password on the command line | [#446](https://github.com/UOR-Foundation/PrismPM/issues/446), [#447](https://github.com/UOR-Foundation/PrismPM/issues/447) |
| `prism-code` | The client: `createPrism` exposing `images`, `containers`, `networks`, `volumes`, `system`, `auth`, `errors` and `verify`, its options, `MODULES` and `memoryCapabilityStore`; `Prism.fromEnv()` and `Prism.create` in `prism-code/node`; the `client.option`, `auth.unavailable` and `images.unavailable` codes | [#441](https://github.com/UOR-Foundation/PrismPM/issues/441) |
Expand Down
2 changes: 1 addition & 1 deletion bindings/generated/prism_bindings_js/package.json

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion bindings/generated/prism_bindings_js/provenance.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"compiler_semantics":"1427f8b629013648a480454d67202788f2303f5396f1d7c70a7c350ddab6f694","effects":["allocation","overflow","recursion"],"exports":[{"function":0,"name":"run"}],"files":{"Cargo.toml":"98ab423f0774d8ee780133ab30a1da8158dd9a8dc264cb05397cab4301988866","src/lib.rs":"f80086330586e815c2e7e1523fba27c91b4c7fb2baf929f45b360ad365953103"},"name":"prism_bindings_js","profile":"rust-std","program":"a64e014c6f759855ad7d12d538b1ac9ab68dd40b8a8dd966176300496965036d","runtime":"4bb6ab6dc7e2fc1a587876290fac070f499170ff7609aee0fd924aa8fd7bcab7","sources":["0da7ff43d9a42cee8f2e627448abc457087654dc19ddd7dd4f091ae32a63db3f"],"spec":"lexlean/rust-provenance/1","version":"0.1.0"}
{"compiler_semantics":"1427f8b629013648a480454d67202788f2303f5396f1d7c70a7c350ddab6f694","effects":["allocation","overflow","recursion"],"exports":[{"function":0,"name":"run"}],"files":{"Cargo.toml":"98ab423f0774d8ee780133ab30a1da8158dd9a8dc264cb05397cab4301988866","src/lib.rs":"f80086330586e815c2e7e1523fba27c91b4c7fb2baf929f45b360ad365953103"},"name":"prism_bindings_js","profile":"rust-std","program":"a64e014c6f759855ad7d12d538b1ac9ab68dd40b8a8dd966176300496965036d","runtime":"4bb6ab6dc7e2fc1a587876290fac070f499170ff7609aee0fd924aa8fd7bcab7","sources":["383babeda30f59257a5c3d7b962d83d6af906687a5883d8f2a2e1f4ca2467e4b"],"spec":"lexlean/rust-provenance/1","version":"0.1.0"}
2 changes: 1 addition & 1 deletion bindings/generated/prism_bindings_python/package.json

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion bindings/generated/prism_bindings_python/provenance.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"compiler_semantics":"1427f8b629013648a480454d67202788f2303f5396f1d7c70a7c350ddab6f694","effects":["allocation","overflow","recursion"],"exports":[{"function":0,"name":"run"}],"files":{"Cargo.toml":"685c22deab06866c3dc358115592c077b06d81d8c7c77103af1c2ba1b868423a","src/lib.rs":"1484465a0e22a4313b05a7b420effe6bacb058609b179def874df4f1792465d7"},"name":"prism_bindings_python","profile":"rust-std","program":"0c141b7d9fb43716ce72effd935116ca230e276f4eb5e17d26299b01cf2198c1","runtime":"4bb6ab6dc7e2fc1a587876290fac070f499170ff7609aee0fd924aa8fd7bcab7","sources":["0da7ff43d9a42cee8f2e627448abc457087654dc19ddd7dd4f091ae32a63db3f"],"spec":"lexlean/rust-provenance/1","version":"0.1.0"}
{"compiler_semantics":"1427f8b629013648a480454d67202788f2303f5396f1d7c70a7c350ddab6f694","effects":["allocation","overflow","recursion"],"exports":[{"function":0,"name":"run"}],"files":{"Cargo.toml":"685c22deab06866c3dc358115592c077b06d81d8c7c77103af1c2ba1b868423a","src/lib.rs":"1484465a0e22a4313b05a7b420effe6bacb058609b179def874df4f1792465d7"},"name":"prism_bindings_python","profile":"rust-std","program":"0c141b7d9fb43716ce72effd935116ca230e276f4eb5e17d26299b01cf2198c1","runtime":"4bb6ab6dc7e2fc1a587876290fac070f499170ff7609aee0fd924aa8fd7bcab7","sources":["383babeda30f59257a5c3d7b962d83d6af906687a5883d8f2a2e1f4ca2467e4b"],"spec":"lexlean/rust-provenance/1","version":"0.1.0"}
2 changes: 1 addition & 1 deletion bindings/generated/prism_bindings_rust/package.json

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion bindings/generated/prism_bindings_rust/provenance.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"compiler_semantics":"1427f8b629013648a480454d67202788f2303f5396f1d7c70a7c350ddab6f694","effects":["allocation","overflow","recursion"],"exports":[{"function":0,"name":"run"}],"files":{"Cargo.toml":"6f39e8d23068e508581c91e82958f2bbc1e7b5faca28194ddcd25d88210984db","src/lib.rs":"e92ffbdd00500cfd3a225a124449b6a609a4b72a356bf6b432f87e212166bd97"},"name":"prism_bindings_rust","profile":"rust-std","program":"d21f2165a32387aca02e013f0a8f6600c55e6aef3e116dca07df6951682b8cc9","runtime":"4bb6ab6dc7e2fc1a587876290fac070f499170ff7609aee0fd924aa8fd7bcab7","sources":["0da7ff43d9a42cee8f2e627448abc457087654dc19ddd7dd4f091ae32a63db3f"],"spec":"lexlean/rust-provenance/1","version":"0.1.0"}
{"compiler_semantics":"1427f8b629013648a480454d67202788f2303f5396f1d7c70a7c350ddab6f694","effects":["allocation","overflow","recursion"],"exports":[{"function":0,"name":"run"}],"files":{"Cargo.toml":"6f39e8d23068e508581c91e82958f2bbc1e7b5faca28194ddcd25d88210984db","src/lib.rs":"e92ffbdd00500cfd3a225a124449b6a609a4b72a356bf6b432f87e212166bd97"},"name":"prism_bindings_rust","profile":"rust-std","program":"d21f2165a32387aca02e013f0a8f6600c55e6aef3e116dca07df6951682b8cc9","runtime":"4bb6ab6dc7e2fc1a587876290fac070f499170ff7609aee0fd924aa8fd7bcab7","sources":["383babeda30f59257a5c3d7b962d83d6af906687a5883d8f2a2e1f4ca2467e4b"],"spec":"lexlean/rust-provenance/1","version":"0.1.0"}
2 changes: 1 addition & 1 deletion bindings/generated/prism_developer_view/package.json

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion bindings/generated/prism_developer_view/provenance.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"compiler_semantics":"1427f8b629013648a480454d67202788f2303f5396f1d7c70a7c350ddab6f694","effects":["allocation","overflow","recursion"],"exports":[{"function":0,"name":"run"}],"files":{"Cargo.toml":"b153860b8b85c016f1769175bdb9c3cca000a7cb024f1e5f5519229873ff86f1","src/lib.rs":"fa243f70a69f1ca12257cee35e2423261dd29988d27e29e87ff7f610f727b2c7"},"name":"prism_developer_view","profile":"rust-std","program":"e17d925526a88761a1e90922d03ef7c2084938594f62c7bbb50841609919a148","runtime":"4bb6ab6dc7e2fc1a587876290fac070f499170ff7609aee0fd924aa8fd7bcab7","sources":["0da7ff43d9a42cee8f2e627448abc457087654dc19ddd7dd4f091ae32a63db3f"],"spec":"lexlean/rust-provenance/1","version":"0.1.0"}
{"compiler_semantics":"1427f8b629013648a480454d67202788f2303f5396f1d7c70a7c350ddab6f694","effects":["allocation","overflow","recursion"],"exports":[{"function":0,"name":"run"}],"files":{"Cargo.toml":"b153860b8b85c016f1769175bdb9c3cca000a7cb024f1e5f5519229873ff86f1","src/lib.rs":"d980baa074c485b5af50287df376f96ad68e0fb691aebfe82ef298659ec5bf4d"},"name":"prism_developer_view","profile":"rust-std","program":"41b217326d05027bef8653149c3417b45048fd637c151a0ec4ac563cfbed747c","runtime":"4bb6ab6dc7e2fc1a587876290fac070f499170ff7609aee0fd924aa8fd7bcab7","sources":["383babeda30f59257a5c3d7b962d83d6af906687a5883d8f2a2e1f4ca2467e4b"],"spec":"lexlean/rust-provenance/1","version":"0.1.0"}
Loading
Loading