Skip to content
Open
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
4 changes: 2 additions & 2 deletions docs/dev/firehose-path-specs.md
Original file line number Diff line number Diff line change
Expand Up @@ -279,7 +279,7 @@ v16→v17/recovery-v19 authority retirement, and v17→v18/recovery-v20 exact
grammar takes another strand when its final shape differs from a dormant
scaffold. Dormant discriminator names never authorize reinterpretation of
their frozen payload. The exact pre-release strand count is recorded as shapes
settle and freezes at the 0.10.0 release gate; an honest extra strand is cheaper
settle and freezes at the 0.9.0 release gate; an honest extra strand is cheaper
than pre-registering a guessed on-disk contract.

The lifecycle tranche plus F3 are the operator lifecycle and maintenance
Expand Down Expand Up @@ -2229,7 +2229,7 @@ root. V17 owns `WITHDRAWN` retirement; F5 extends it for `DEAD_LETTERED`.
is either exactly the frozen scaffold already registered or takes a new honest
pre-release strand. There is no guessed numeric ceiling: every added strand is
recorded with predecessor refusal/rebuild evidence, and the complete count
freezes at the 0.10.0 release gate. No discriminator acquires a different
freezes at the 0.9.0 release gate. No discriminator acquires a different
payload meaning in place merely to save a rebuild.

**What the experimental designation does and does not buy.** It licenses
Expand Down
9 changes: 5 additions & 4 deletions docs/dev/testing.md
Original file line number Diff line number Diff line change
Expand Up @@ -940,8 +940,9 @@ OMNIGRAPH_V8_BIN=/path/to/final-v8/omnigraph \

RFC-026 §4.7 P1 (the v10 stream-profile format) added the historical
`OMNIGRAPH_V9_BIN` seam. It mints a genuine internal-v9 graph with the pinned
final-v9 binary, proves CURRENT refuses it naming the published `0.9.x` line in
both message slots (`created by omnigraph 0.9.x` and `with an omnigraph 0.9.x
final-v9 binary, proves CURRENT refuses it naming the `0.9.x` line in
both message slots (no 0.9.x binary was ultimately published — the label
predates that outcome and awaits the release-map relabel) (`created by omnigraph 0.9.x` and `with an omnigraph 0.9.x
binary` — the exact strings are also pinned in-source by
`migrations.rs::release_names_the_writing_line_for_each_stamp`), exports with
v9, rebuilds a distinct current-format root, proves row/vector fidelity plus
Expand All @@ -955,7 +956,7 @@ OMNIGRAPH_V9_BIN=/path/to/final-v9/omnigraph \
```

The historical `OMNIGRAPH_V10_BIN` seam mints a genuine final-v10 graph with
the matching 0.10.0-dev source build, proves CURRENT refuses it with
the matching 0.9.0-dev source build, proves CURRENT refuses it with
source-build/export guidance, exports with v10, rebuilds a distinct
current-format root, and proves row/vector/blob fidelity plus exact-`id` PK
metadata. The old v10 binary must refuse the current root. It remains available
Expand Down Expand Up @@ -997,7 +998,7 @@ OMNIGRAPH_V12_BIN=/path/to/final-v12/omnigraph \
```

The historical `OMNIGRAPH_V13_BIN` seam mints a
genuine final-v13 graph with the matching 0.10.0-dev source build, proves CURRENT
genuine final-v13 graph with the matching 0.9.0-dev source build, proves CURRENT
refuses it with source-build/export guidance, exports with v13, rebuilds a
distinct current-format root, and proves row/vector/blob fidelity plus exact-`id` PK
metadata. The old v13 binary must refuse the current root. The fixture is clean,
Expand Down
26 changes: 15 additions & 11 deletions docs/dev/versioning.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,8 +46,12 @@ declares exactly non-null physical `id` as Lance's unenforced primary key from
creation, and production strict insert/upsert routes use the exact-`id`
filter-bearing adapter.

Internal schema v9 maps to OmniGraph **0.9.x** — the first published release
line to serve any of these formats.
Internal schema v9 was also a 0.9.0-dev format: the 0.9.0 release was
prepared at this stamp (workspace bump plus release notes) but never tagged or
published, so — like v5–v8 — only source builds off `main` serve it. The
in-code release map still labels stamp 9 `0.9.x`, and the refusal grammar
tests pin that string; relabeling it to source-build guidance is release-prep
work, annotated next to the arm-split note in `migrations.rs`.
It preserves v8's private data-bearing MemWAL core, then activates
RFC-026's common B2 storage/recovery contract: stream-config v3, lifecycle
state v2, the grammar-impossible trusted base-row field
Expand All @@ -72,7 +76,7 @@ writer. The physical field's trailing `$` is outside the `.pg` identifier
grammar, so a genuine v8 user property named `__omnigraph_stream_v1` remains
ordinary user data and round-trips unchanged.

Internal schema v10 was the first 0.10.0-dev streaming-profile format. It
Internal schema v10 was the first 0.9.0-dev streaming-profile format. It
preserved the complete v9 contract and added RFC-026 §4.7 P1's enablement
authority: one required graph-global `stream_profile` singleton row, present
from genesis (disabled, revision 1), flipped through the shared publisher's
Expand Down Expand Up @@ -109,7 +113,7 @@ accepted v13 discriminator. It owns the exact token-ledger
selects its achieved token witness and the next profile together makes either
authoritative.

Internal schema v12 was an unreleased 0.10.0-dev format. It replaces lifecycle
Internal schema v12 was an unreleased 0.9.0-dev format. It replaces lifecycle
state-v2's inline receipt histories with lifecycle-v3 fixed-size
ledger-chain/current pointers and an authenticated WAL-tail commitment. The
recovery-sidecar ceiling is v14. Its active hidden discriminators are
Expand All @@ -126,7 +130,7 @@ historical. It did not encode the complete prior lifecycle/profile/topology,
the physical claim attempt, or the two terminal receipt families required to
recover resume safely, so v13 does not reinterpret it.

Internal schema v13 was an unreleased 0.10.0-dev format. It preserves lifecycle-v3
Internal schema v13 was an unreleased 0.9.0-dev format. It preserves lifecycle-v3
and raises the recovery-sidecar ceiling to v15. Recovery-v15 has one active
hidden discriminator, `StreamResume`, which owns the complete revision-fenced
`SEALED → OPEN` resume or guarded `DRAINING → OPEN` abort: exact request and
Expand All @@ -136,7 +140,7 @@ Receipt lookup precedes revision refusal for idempotent retry. The v14
resume/correction/retirement/ledger-maintenance/sealed-maintenance/rebind
scaffolds retain their old bytes and continue to fail closed.

Internal schema v14 was an unreleased 0.10.0-dev format. It raised the sidecar
Internal schema v14 was an unreleased 0.9.0-dev format. It raised the sidecar
ceiling to recovery-v16 for one active hidden discriminator,
`StreamSealedEnsureIndices`. V16 reuses the frozen
recovery-v8 exact CreateIndex plan and layers the enabled profile, selected
Expand All @@ -149,7 +153,7 @@ retry idempotency. Ambient EnsureIndices remains refused for enrolled tables.
Recovery-v14's sealed-maintenance
scaffold keeps its original bytes and is not reinterpreted.

Internal schema v15 was an unreleased 0.10.0-dev format. It raised the sidecar
Internal schema v15 was an unreleased 0.9.0-dev format. It raised the sidecar
ceiling to recovery-v17 for the distinct hidden `StreamSealedOptimize`
discriminator. V17 owns Optimize's bounded,
internally committing maintenance plan, exact confirmed outputs, and complete
Expand All @@ -158,7 +162,7 @@ refreshes publish atomically; a true no-work invocation is effect-free. It
writes no token row, advances no receipt chain, and accepts no caller operation
ID. Ambient Optimize remains refused for enrolled tables.

Internal schema v16 was an unreleased 0.10.0-dev format. It raised the sidecar
Internal schema v16 was an unreleased 0.9.0-dev format. It raised the sidecar
ceiling to recovery-v18 for the distinct hidden `StreamRebind` discriminator.
V18 binds the complete prior `SEALED`
authority, exact fresh physical enrollment and empty shard, immutable binding
Expand All @@ -168,7 +172,7 @@ recovery-v15 resume must claim a higher epoch within the fresh binding scope.
The v14 rebind scaffold and recovery-v17 Optimize envelope retain their exact
historical meanings and are never reinterpreted.

Internal schema v17 was an unreleased 0.10.0-dev format. It raised the sidecar ceiling to recovery-v19 for
Internal schema v17 was an unreleased 0.9.0-dev format. It raised the sidecar ceiling to recovery-v19 for
one active `StreamAuthorityRetirement` discriminator. Under checked
stopped/offline cluster authority, a read-only plan proves an exact `DISABLED`
profile, settled recovery, every enrolled lane `SEALED`, base/token parity, and
Expand All @@ -188,7 +192,7 @@ retired source cut; it need not equal the fresh target graph identity, whose
schema compatibility remains ordinary loader validation. This slice added no
production path that creates `WITHDRAWN`.

Internal schema v18 was an unreleased 0.10.0-dev format. It raised the sidecar
Internal schema v18 was an unreleased 0.9.0-dev format. It raised the sidecar
ceiling to recovery-v20 for exact `DataBlock` correction while leaving the
frozen recovery-v14 correction
scaffold unchanged. Recovery-v20 binds the exact blocked generation cut, one
Expand All @@ -198,7 +202,7 @@ management-receipt effect, fixed graph lineage, and the complete next
block; receipt lookup precedes stale block/revision refusal on exact retries.

Internal schema **v19 is the currently served format** (unreleased, current
0.10.0-dev source builds). It upgrades `_stream_tokens.lance` to schema v3,
0.9.0-dev source builds). It upgrades `_stream_tokens.lance` to schema v3,
adds terminal `DEAD_LETTERED` evidence and versioned fold attribution, and
raises the sidecar ceiling to recovery-v21. `DeadLetterFold` deterministically
partitions one bounded generation, preserves valid winners, and writes all
Expand Down
169 changes: 0 additions & 169 deletions docs/releases/v0.10.0.md

This file was deleted.

Loading