> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentvolumes.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Namespace and URI publications

> Stable public documentation routes for Agent Volumes-owned namespaces, URI identifiers, schema IDs, problem types, and release evidence.

Agent Volumes publishes owned namespaces and URI identifiers under `agentvolumes.org` so implementers can cite, dereference, and validate the identifiers used by the specification and its companion artifacts.

The repository remains authoritative. The public site is a publication layer for the canonical specification, schemas, OpenAPI contract, conformance fixtures, and decision records.

Semantic identifier routes such as `https://agentvolumes.org/build/manual/v0.1`, `https://agentvolumes.org/predicates/external-dependency-declarations/v0.1`, `https://agentvolumes.org/ns/spdx/external-dependency-declarations/v0.1#`, and `https://agentvolumes.org/problems/<slug>` resolve to stable landing pages for the identifier itself. The SPDX JSON-LD context also has a stable canonical remote context URL at `https://agentvolumes.org/contexts/spdx-external-dependency-declarations-v0.1.jsonld`. Those stable routes link back to this release archive and to canonical repository artifacts. JSON Schema `$id` URLs remain release-scoped under `https://agentvolumes.org/spec/<version>/schemas/<artifact>`.

## Publication matrix

| Checklist item                             | Public URL or identifier                                                                                                   | Source artifact                                                                                                                                                                                            | Immutability / check evidence                                                                                                       |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| SPDX extension namespace                   | `https://agentvolumes.org/ns/spdx/external-dependency-declarations/v0.1#`                                                  | `agent-volumes-spec.md`; `conformance/fixtures/mapping-matrix.json`; `conformance/fixtures/mapping-sample.json`; ADR-0141; ADR-0158                                                                        | Stable `v0.1` namespace landing page plus archived release documentation. Record route status, content type, and release evidence.  |
| SPDX extension JSON-LD context             | `https://agentvolumes.org/contexts/spdx-external-dependency-declarations-v0.1.jsonld`                                      | `site/contexts/spdx-external-dependency-declarations-v0.1.jsonld`; `site/spec/0.1.0-rc.1/contexts/spdx-external-dependency-declarations-v0.1.jsonld`; `conformance/fixtures/mapping-sample.json`; ADR-0141 | Stable canonical remote context URL plus release archive copy. Record dereference, content-type, and drift-check evidence.          |
| in-toto predicate URI                      | `https://agentvolumes.org/predicates/external-dependency-declarations/v0.1`                                                | `agent-volumes-spec.md`; `conformance/fixtures/mapping-matrix.json`; `conformance/fixtures/mapping-sample.json`; ADR-0142; ADR-0158                                                                        | Stable `v0.1` predicate landing page plus archived schema and examples. Record route status, content type, and schema evidence.     |
| Problem Details type URIs                  | `https://agentvolumes.org/problems/<slug>`                                                                                 | `schemas/problem-details.schema.json`; `schemas/problem-registry.schema.json`; `conformance/fixtures/problem-details-cases.json`; `openapi/bibliotheca.openapi.yaml`; ADR-0152; ADR-0158                   | Stable problem type landing pages plus archived closed v0.1 problem set. Check each slug route and record evidence before tagging.  |
| JSON Schema `$id` URLs                     | `https://agentvolumes.org/spec/0.1.0-rc.1/schemas/<artifact>`                                                              | `schemas/*.json`; `schemas/README.md`; `conformance/README.md`                                                                                                                                             | Release-versioned schema IDs are immutable after release. Record dereference and content-type checks for current release artifacts. |
| SLSA build type URI                        | `https://agentvolumes.org/build/manual/v0.1`                                                                               | `conformance/fixtures/mapping-sample.json`; `conformance/fixtures/mapping-matrix.json`; ADR-0158                                                                                                           | Stable `v0.1` build type landing page plus archived examples. Record route and example evidence in the release evidence issue.      |
| Agent Volumes BOM/profile identifiers      | `agent-volumes-bom-v0.1` and related profile identifiers                                                                   | `agent-volumes-spec.md`; `conformance/fixtures/mapping-matrix.json`; `conformance/fixtures/mapping-sample.json`; trust fixture families                                                                    | Local string identifiers unless explicitly URI-backed. Record profile semantics and fixture evidence before tagging.                |
| External dependency declaration key syntax | `av-extdep-v1:sha256:<lowercase-hex-sha256>`                                                                               | `agent-volumes-spec.md`; `schemas/external-dependency-validation-case.schema.json`; `conformance/fixtures/external-dependency-validation-cases.json`; ADR-0143                                             | Grammar is versioned by the `av-extdep-v1` prefix. Record valid and invalid fixture evidence before tagging.                        |
| Capability extension reserved namespaces   | `agent-volumes`, `core`, `spec`                                                                                            | `schemas/reserved-extension-namespaces.json`; `schemas/capability-metadata.schema.json`; capability fixtures                                                                                               | Reserved-name set is version-aligned with schema release. Record schema ID and validator evidence before tagging.                   |
| Bridge and warning companion artifacts     | `bridge-metadata.schema.json`; `warning.schema.json`; `external-dependency-potential-exposure-warning-context.schema.json` | `schemas/bridge-metadata.schema.json`; `schemas/warning.schema.json`; `schemas/external-dependency-potential-exposure-warning-context.schema.json`; bridge fixtures; external-dependency warning fixtures  | Versioned schema IDs are immutable after release. Record dereference and validator evidence with the schema publication checks.     |

## Identifier pages

Stable semantic identifier pages:

* [Manual build type v0.1](/build/manual/v0.1)
* [SPDX external dependency namespace v0.1](/ns/spdx/external-dependency-declarations/v0.1)
* [SPDX external dependency JSON-LD context](/contexts/spdx-external-dependency-declarations-v0.1.jsonld)
* [External dependency declarations predicate v0.1](/predicates/external-dependency-declarations/v0.1)
* [Problem Details type URIs](/problems)

<CardGroup cols={2}>
  <Card title="Schema ID URLs" icon="file-code" href="/spec/0.1.0-rc.1/uri-publications/schema-ids">
    Versioned JSON Schema `$id` publication pages for the v0.1.0-rc.1 artifact set.
  </Card>

  <Card title="SPDX namespace" icon="diagram-project" href="/spec/0.1.0-rc.1/uri-publications/spdx-external-dependency-namespace">
    URI-backed SPDX extension terms for external dependency declarations.
  </Card>

  <Card title="SPDX JSON-LD context" icon="code" href="/spec/0.1.0-rc.1/uri-publications/spdx-external-dependency-context">
    Published JSON-LD context for compact SPDX external dependency declaration terms.
  </Card>

  <Card title="in-toto predicate" icon="route" href="/spec/0.1.0-rc.1/uri-publications/in-toto-external-dependency-predicate">
    Optional predicate identifier for declaration-plane external dependency metadata.
  </Card>

  <Card title="Problem Details types" icon="triangle-exclamation" href="/spec/0.1.0-rc.1/problems">
    Stable pages for every closed v0.1 Problem Details type URI.
  </Card>

  <Card title="Reserved namespaces" icon="lock" href="/spec/0.1.0-rc.1/uri-publications/reserved-extension-namespaces">
    Reserved capability extension namespace keys for the release line.
  </Card>

  <Card title="PURL/VERS exceptions" icon="arrows-left-right" href="/spec/0.1.0-rc.1/uri-publications/purl-vers-compatibility-exceptions">
    Machine-readable compatibility exceptions for validation and warning context.
  </Card>

  <Card title="Upstream baselines" icon="code-branch" href="/spec/0.1.0-rc.1/uri-publications/upstream-baselines">
    Pinned upstream PURL and VERS references used by conformance fixtures.
  </Card>

  <Card title="SLSA manual build type" icon="hammer" href="/spec/0.1.0-rc.1/build/manual/v0.1">
    SLSA `buildType` identifier for manually assembled Agent Volumes mapping fixtures.
  </Card>

  <Card title="BOM/profile identifiers" icon="id-card" href="/spec/0.1.0-rc.1/uri-publications/bom-profile-identifiers">
    Release-context strings used by trust metadata and BOM/provenance mapping fixtures.
  </Card>

  <Card title="Declaration keys" icon="key" href="/spec/0.1.0-rc.1/uri-publications/external-dependency-declaration-keys">
    Versioned external dependency declaration key syntax and canonical digest input.
  </Card>
</CardGroup>

## Release evidence workflow

For each release candidate or stable release:

1. Install repository and site dependencies with `bun install` and `(cd site && bun install)`.
2. Refresh the Mintlify OpenAPI publication artifact with `bun run build:site:openapi -- 0.1.0-rc.1`.
3. Validate the public site with `bun run lint:site`.
4. Run the canonical gates: `bun run lint:openapi` and `bun run validate:artifacts`.
5. Create a release evidence issue from `.github/ISSUE_TEMPLATE/release-evidence.md`.
6. Fill the Namespace and URI publication evidence table with the public URL, source artifact, and route or immutability check evidence for each Issue #29 row.

## Related sources

* [Agent Volumes specification](https://github.com/agent-volumes/agent-volumes-spec/blob/main/agent-volumes-spec.md)
* [JSON Schema artifacts](https://github.com/agent-volumes/agent-volumes-spec/tree/main/schemas)
* [Bibliotheca OpenAPI contract](https://github.com/agent-volumes/agent-volumes-spec/blob/main/openapi/bibliotheca.openapi.yaml)
* [Conformance fixtures](https://github.com/agent-volumes/agent-volumes-spec/tree/main/conformance)
* [Issue #29](https://github.com/agent-volumes/agent-volumes-spec/issues/29)