Skip to content

Module: prism.volumes, contract and code ownership #445

Closed

Description

@humuhumu33

Part of the nine-module architecture in #440. This issue holds the contract and code ownership of volumes. M2 defines the contract; the issues listed below own the implementation.

Purpose: Named, declared stores from providers, under Docker's name. The capability file stays the canonical form.

Docker equivalent: Volumes

API surface: prism.volumes.create, list, inspect, remove

Prism difference: A volume is a declared store from a provider, not a mounted folder. Host-folder mounts are refused, because they would escape what was verified.

Code that moves here

  • Rust (crates/prismpm/src): None today. system/host_effect is deployment topology and stays in images.
  • JavaScript (sdk/npm/prism-code/src): bin/prism-provider-kv. prism.volumes is a new, thin view over capabilities, which stays whole in verify. The providers runner is in client, which passes it in when it builds prism.volumes.

This map follows the agreed design in docs/proposals/440-nine-modules.md, under Code ownership. A file that will split keeps its current owner until it does. Confirm each row when the code moves.

May depend on: errors, verify

Implemented by: #279 (capability sets), #294 (providers), #216 and #217 (host effects, needed for real access), #346 (glossary)

Done when: Stores can be declared, created and inspected through the SDK and the CLI; a host-folder mount is refused and tested; until #216 and #217 land, calls that need host effects raise a typed error naming that dependency. Each public capability and diagnostic is registered in model/*.toml and covered by conformance fixtures.

Depends on: #440.

Part of the Prism SDK v1.0 roadmap: Prism SDK v1.0

Activity

  1. added
    kind/api-changeChanges a public API, CLI verb, file format or predicate; needs a design proposal
    area/engineBuild pipeline inside the SDK image
    area/runtime-jsprism-code, verify, testing packages
    stability/experimentalBehind experimental_ prefix or --unstable flag; pin exact versions
    module/volumesOwned by the volumes module of PrismPM
    on Nov 1, 2026
  2. afflom commented on Nov 12, 2026

    @afflom
    Member

    The done-when holds on main as of #620 (287040c):

    Closing.


    Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/engineBuild pipeline inside the SDK imagearea/runtime-jsprism-code, verify, testing packageskind/api-changeChanges a public API, CLI verb, file format or predicate; needs a design proposalmodule/volumesOwned by the volumes module of PrismPMpriority/critical-urgentBlocks the current milestonestability/experimentalBehind experimental_ prefix or --unstable flag; pin exact versions

    Type

    No type

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions