Przejdź do treści

Archival Package v1

Source schema: doc/schemas/archival-package.v1.schema.json

Machine-readable schema for packaging durable artifacts for archivist or vault handoff.

Governing Basis

Project Lineage

Requirements

Stories

Fields

Field Required Shape Description
schema/v yes const: 1 Schema version.
package/id yes string Stable package identifier used at archival handoff boundaries.
artifact/id yes string Identifier of the packaged artifact.
artifact/type yes enum: transcript-bundle, room-summary, response-envelope, knowledge-artifact, corpus-entry Primary semantic class of the packaged artifact.
source/question-id yes string Question lifecycle identifier that roots the packaged artifact.
created-at yes string Timestamp of archival package creation.
publication/scope yes enum: private-retained, federation-vault, public-vault Declared publication class of the archival handoff.
archival/basis yes enum: not-required, operator-consultation, explicit-consent, federation-policy, public-scope, emergency-exception Policy or consent basis for archival export.
redaction/status yes enum: none, partial, full-derived Redaction posture of the exported artifact.
payload/ref yes string Stable content, blob, or manifest reference for the packaged payload.
provenance/refs yes array Trace references that bind the package to its source discussion or promotion history.
publication/timing-profile no enum: live-mirror, delayed-bundle, curator-gated Timing profile for publication beyond storage success.
retention/max-duration-sec no integer Maximum intended storage duration in seconds when retention is bounded.
retention/max-idle-ttl-sec no integer Maximum idle time without retrieval before the package may expire.
integrity/proof yes ref: #/$defs/integrityProof
policy_annotations no object Optional implementation-local annotations that do not change the core archival semantics.

Definitions

Definition Shape Description
integrityProof object

Conditional Rules

Rule 1

When:

{
  "properties": {
    "publication/scope": {
      "const": "public-vault"
    }
  },
  "required": [
    "publication/scope"
  ]
}

Then:

{
  "required": [
    "publication/timing-profile"
  ]
}

Field Semantics

schema/v

  • Required: yes
  • Shape: const: 1

Schema version.

package/id

  • Required: yes
  • Shape: string

Stable package identifier used at archival handoff boundaries.

artifact/id

  • Required: yes
  • Shape: string

Identifier of the packaged artifact.

artifact/type

  • Required: yes
  • Shape: enum: transcript-bundle, room-summary, response-envelope, knowledge-artifact, corpus-entry

Primary semantic class of the packaged artifact.

source/question-id

  • Required: yes
  • Shape: string

Question lifecycle identifier that roots the packaged artifact.

created-at

  • Required: yes
  • Shape: string

Timestamp of archival package creation.

publication/scope

  • Required: yes
  • Shape: enum: private-retained, federation-vault, public-vault

Declared publication class of the archival handoff.

archival/basis

  • Required: yes
  • Shape: enum: not-required, operator-consultation, explicit-consent, federation-policy, public-scope, emergency-exception

Policy or consent basis for archival export.

redaction/status

  • Required: yes
  • Shape: enum: none, partial, full-derived

Redaction posture of the exported artifact.

payload/ref

  • Required: yes
  • Shape: string

Stable content, blob, or manifest reference for the packaged payload.

provenance/refs

  • Required: yes
  • Shape: array

Trace references that bind the package to its source discussion or promotion history.

publication/timing-profile

  • Required: no
  • Shape: enum: live-mirror, delayed-bundle, curator-gated

Timing profile for publication beyond storage success.

retention/max-duration-sec

  • Required: no
  • Shape: integer

Maximum intended storage duration in seconds when retention is bounded.

retention/max-idle-ttl-sec

  • Required: no
  • Shape: integer

Maximum idle time without retrieval before the package may expire.

integrity/proof

  • Required: yes
  • Shape: ref: #/$defs/integrityProof

policy_annotations

  • Required: no
  • Shape: object

Optional implementation-local annotations that do not change the core archival semantics.

Definition Semantics

$defs.integrityProof

  • Shape: object