Repository navigation
v0.2.9
Release v0.2.9
Specifies the durable-record/v1 retention policy for retired-record body reclamation, designated body-removal stream recovery, and detached canonical stream-seal artifacts; adds the draft identity-evidence/v0 native-process-observation:v0 provider profile; and hardens the RFC 8785 JCS and RFC 3339 instant helper scripts.
This release completes the durable-record/v1 external-body lifecycle surfaces
for policy-bound reclamation of body bytes referenced only by retired records,
quarantined designated body-removal stream recovery via successor journals, and
detached verified stream seals across continuation chains. It also adds the
draft native-process-observation:v0 provider profile under
identity-evidence/v0 and hardens the repository's RFC 8785 canonical JSON and
RFC 3339 instant validation helpers.
Highlights
durable-record/v1 retention policy for all-retired-record body reclamation
- Eligibility rules and deterministic refusal precedence. Updates
docs/standards/durable-record-v1-contract.md
and adds
schemas/durable-record/v1/removal-eligibility-request.schema.json
to define when a store may remove external body bytes(digest, length)that
historical records have referenced once every referencing record across the
store is retired. Enforces deterministic Precedence1 -> 2 -> 2b -> 3 -> 4 -> 5
refusal ordering: designated-stream placement, request/journal wire and domain
preflight, and targetincarnationlifecycle transition eligibility (1,
refusingingest,numeric_domain,shape,instant_spelling,
body_removal_stream, orbody_lifecycle), store-wide stream coverage,
quarantined_designated_streamspredecessor-chain completeness, valid cuts,
and observable continuation ancestry (2, refusingprotection_unavailable),
same-store temporal ordering requiringdecision_time >= e["at"]across
validated cuts (2b, refusingjournal_time), active local preservation holds
and conservative continuation/sealed-ancestor hold dominance (3, refusing
protected_use), unretired referencing records across latest or superseded
revisions (4, refusingstill_referenced), and policy-bound{id, version}
removal authorization verification when the referenced set is non-empty (5,
refusingremoval_authorization). - Store-wide exclusion fence re-verification. Requires
removal_eligibility
to be evaluated under the store-wide body-removal exclusion fence before
appendingbody_removal_startedand before anyretry_unlinkattempt on an
open removal.
durable-record/v1 designated body-removal stream recovery and detached stream-seal
- Successor-stream recovery (
stream_opened.recovery). Extends
schemas/durable-record/v1/journal-entry.schema.json,
schemas/durable-record/v1/stratum-profile.schema.json,
anddocs/standards/durable-record-v1-contract.md
with Option B1 designatedbody-removalstream recovery under
runtime.incarnation_allocation: "prewrite_durable_ledger". Quarantines a
damaged designated stream without in-place tail rewriting, binds the longest
valid complete-group prefix (cut_seq,cut_digest,
quarantined_image_digest) andruntime.quarantined_designated_streams
predecessor chain, and reconciles every(digest, length)via the 19-row
R1–R19table (R1 -> R2 -> R3 -> R4..R19, addingrecovery_incompleteto
the closed refusal vocabulary). - Sticky post-recovery carry-forward and multi-hop replay. Preserves
post-recoverypublishing(R7,R9,R13,R19— transitioning to
integrity_lossif bytes disappear before republication, never reverting to
removedorunpublished) and stickyintegrity_loss(R6,R10,R16,
R18— remainingintegrity_lossacross clean cuts and subsequent recovery
hops even if un-republished bytes reappear) until cleared by a new
body_published(n')withn' > floor. Requires freshremoval_eligibility
andauthorizationbefore re-issuing an abandonedR12/R13removal. - Detached canonical stream seals (
stream-seal). Adds
schemas/durable-record/v1/stream-seal.schema.json
and
schemas/durable-record/v1/examples/stream-seal.example.json
for detached RFC 8785 JCS stream seals bindingstore,capability,
stream,cut_seq,cut_digest,effective_restriction_manifest_digest
(closed{holds, retired, inherited}preimage), sorted/unique transitive
ancestor_seals,trust_profile: {id, version}, canonicalsealed_at,
provenance, andauthorization. Enforces authenticated closer and permanent
write fencing across the exact transitive upstream boundary closure, zero raw
trailing bytes, exact fenced cut length, and conservative sealed-ancestor hold
checks inremoval_eligibility. - Logical conformance vectors and mutation controls. Expands
scripts/validate-durable-record-fixtures.pyand
scripts/test-durable-record-v1-controls.pyby 183 conformance vectors, 17
schema reject fixtures, and 107 AST mutation witnesses (to 395 vectors, 66
schema reject fixtures, and 187 AST mutation witnesses).
identity-evidence/v0 native-process-observation:v0 provider profile (draft)
- Standalone native process observation. Adds
schemas/identity-evidence/v0/profiles/native-process-observation/
(profile.json,evidence.schema.json,README.md, and platform examples)
plus
schemas/identity-evidence/v0/examples/native-process-observation.json
for observing live OS process incarnation and context facts without requiring
launch or handle possession evidence (status: draft). - Visibility vocabulary, namespace descriptors, and Linux
/procclasses.
Defines the seven-state fact visibility vocabulary (observed,not-present,
inaccessible,unsupported,not-probed,error,unknown) mapped 1:1 to
report capability status, host-scope and clock/user/PID-namespace descriptor
semantics, three-class Linux/procopenat2and magic-link resolution rules
(keepingmagic-link-leaf-not-mount-confineddisclosed),u32/u64integer
bounds, pre/post incarnation bracketing, and fail-closed projection into
local-process-session:v0, covered in
scripts/test-identity-evidence-controls.py.
RFC 8785 canonicalization and RFC 3339 instant helper hardening
scripts/rfc8785-canonicalize.pyandscripts/test-rfc8785-controls.py.
Replaces recursive JSON parsing and JCS serialization with an iterative
implementation enforcing explicit input bounds (--max-bytes,--max-depth,
--max-object-members,--max-string-bytes), rejecting all 66 RFC 7493 §2.1
Unicode noncharacters (U+FDD0..U+FDEFandU+..FFFE/U+..FFFFacross
planes0..16, raw or\uXXXXescaped), surrogate code points, duplicate
object keys, and out-of-domain integer tokens before arbitrary-precision
expansion, and adding--check,--digest,--vector,--ndjson-array
(--head N), and--sort-setCLI modes.scripts/rfc3339-instant.py. Addsmax_fraction_digitsand
reject_submicrosecond_nonzerooptions onparse_rfc3339and exact
arbitrary-precision fractional-second ordering incompare.
What a release carries
A crucible release is a GPG-signed annotated Git tag. It publishes no assets,
so there are no SHA256SUMS or SHA512SUMS files to verify. See
docs/security/README.md.
Upgrade notes
- For
durable-record/v1adopters: Stores reclaiming body bytes referenced
by retired records must evaluateremoval_eligibilityunder the store-wide
exclusion fence and verify policy-bound{id, version}removal authorizations
alongside conservative continuation/sealed-ancestor holds. Stores enabling
designatedbody-removalstream recovery must declare
runtime.incarnation_allocation: "prewrite_durable_ledger"and keep
runtime.quarantined_designated_streamsequal to the successor
stream_opened.recovery.previous_streamchain. - For
identity-evidence/v0adopters:native-process-observation:v0ships
atstatus: draft; projection intolocal-process-session:v0fails closed
with typed refusals when required session incarnation or scope facts are not
observed. - For downstream repositories vendoring helper scripts: Re-pin
scripts/rfc8785-canonicalize.pyandscripts/rfc3339-instant.pytov0.2.9
to pick up iterative JCS bounds, RFC 7493 noncharacter rejection, and
sub-microsecond instant controls.