Artifact a4b0a9117d2d099d549910894ccde963f5831a8e0c913149aac42d0cae4b3ce4:
- File
conformance/rfcs/README.md
— part of check-in
[d5926b325c]
at
2026-10-22 11:32:23
on branch feat/horizon-cones
— conform(horizon): pin at horizon-rfc 9bf7ebfe0f, the zit#266 correction
zit#266 reported that a horizon clone pulling from stock Fossil never learns a check-in Fossil announced only inside a cluster: xfer.c clusters 100 or more unclustered artifacts and then announces only the cluster. §4.5 at 9bf7ebfe0f binds the cluster prohibition to an origin whose replies carry horizon-served, and has the clone request a horizon-ignorant origin's cluster members as transit and classify what arrives. HZ-4.5-1 is restated; implementing it waits for horizon-served, which the horizon pragmas bring. The sync draft on that branch differs from the trunk copy pinned here only by §9's editorial list of extension pragma names. (user: [email protected], size: 4687) [annotate] [blame] [check-ins using] [more...]
# Pinned drafts The conformance suite reads these documents, never edits them. Each is a byte-for-byte copy of a file under `docs/rfcs/` in the zit repository, taken from the check-in below. The requirements tables in `../requirements/` pin each copy by its SHA-256, so a refreshed copy fails the coverage test until its table has been re-read against it. The draft text is the authority. Since zit check-in `62a7d1bb3f` (2026-10-20) every erratum is applied in its draft and zit keeps no erratum files: each draft records its corrections in its own Changes appendix ("Changes in This Revision"). Since zit check-in `68a3f76cb7` (2026-10-20) the artifact-format, repo-state and sync-protocol drafts name themselves `-00` throughout, in their headers, their cross-references and their reference entries, and the copies here carry zit's file names. Against the `62a7d1bb3f` text, which these copies replace, nothing but those names and the wording of the Changes appendix's heading and introduction differs: no normative text changed and no section number moved. | File | zit check-in | zit artifact | SHA-256 | |---|---|---|---| | `draft-fossil-artifact-format-00.txt` | `68a3f76cb7` | `aa13f2e42c` | `0887d83d3c57c8b1…` | | `draft-fossil-repo-state-00.txt` | `68a3f76cb7` | `140fdf2d3b` | `137f0a573498bf27…` | | `draft-fossil-sync-protocol-00.txt` | `68a3f76cb7` | `62e9495f35` | `2195d9a18fe6bfaa…` | | `draft-fossil-delta-format-00.txt` | `62a7d1bb3f` | `d8025d6d75` | `6a28ee7e2e146f80…` | | `draft-fossil-submanifests-00.txt` | `e03d91943e57afa20c3fdeab159a23a8a5eab66c` (branch `horizon-rfc`) | `b9b19fa418` | `99ea094690fe1386…` | | `draft-fossil-sparse-cone-00.txt` | `e6ee276c89` (branch `horizon-rfc`) | `c7ef80e7e1` | `2ecfc54f4b830938…` | | `draft-fossil-horizon-00.txt` | `9bf7ebfe0f` (branch `horizon-rfc`) | `782253dc68` | `aaea870edc239842…` | The delta-format and sub-manifest files are byte-identical at `68a3f76cb7` and `62a7d1bb3f`. The delta-format draft is unchanged since `3f86ff4261` (2026-10-17). The sub-manifest draft (`draft-fossil-submanifests-00`) includes the sparse canonical-rewrite correction merged into `horizon-rfc` at the exact check-in above (2026-10-20). Sections 6.2 and 6.4 require canonical construction under the requested k, including MAX-cut shifts, final-small-group merges and propagation at every height. Opaque reuse requires verified compatible partition evidence, not the mutable setting; missing necessary nodes must be fetched or cause explicit refusal without a partial check-in. Appendix A.6 supplies the required MAX, final-merge and different/unknown-k cases. The earlier Appendix A byte vectors in `../testdata/submanifest/` remain unchanged: they are zit's `src/rfc_vectors/` copies from `3f86ff4261`, each with two leading `#` lines that the suite drops. The sparse-cone and horizon drafts follow zit's `horizon-rfc` branch, where the horizon draft lives; that branch merges trunk. The sparse-cone copy at `e6ee276c89` carries the corrections of zit #257 to #260 and #262 (the cone-served acknowledgement, the empty-cone refusal, structural retention on compaction and local filtering, and the pull-inventory clarifications) and retains the branch's §3.1 members-of-other-kinds and §6.2 outside-delta-base corrections. Its §4.2 now requires the complete canonical structural affected range and verified partition basis, with fetch or explicit refusal when necessary nodes are absent. Section 5.1 permits outside payloads to be absent but does not require discarding already-held or demand-fetched payloads; §5.3 follows the corrected canonical-writing contract. The horizon copy is pinned at `9bf7ebfe0f` (2026-10-22): `bbd1435674`, the revision zit's author called ready to implement against, plus the zit#266 correction to §4.5, which binds the cluster prohibition to an origin that serves at a horizon and has a clone request what a horizon-ignorant origin's clusters name. The sparse-cone text there is byte-identical to the copy at `e6ee276c89`. Its Appendix C lists every change to the earlier text: the leaves rule restated over P cards alone, with K closed under descendants under both rules (§3.1, §3.4); the seed carrying T cards for every entry of K, not C alone (§5.2.1); the cursor's announcements made only in reply to a request that pulls (§6.2.6); and, from the revision before, the cursor itself and the classification-memoization SHOULDs (§6.1, §6.2). The same branch adds the pragma names these two drafts define (`cone`, `cone-not`, and the `horizon` family) to the sync draft's §9 list of extension pragmas; the sync draft here follows trunk, so that addition is pending.