The machine-readable map now matches the public file format it claims to follow. The site summary ships as a blockquote directly under the title, the detail lines point at the full text, the map and the feed, and a conventional secondary section closes the plain-text index with follow and legal pages that agents may skip when context runs short.
Motivation
The published format orders each file as title, blockquote summary, detail lines, then headed file lists with a secondary section at the end. The journal index carried the summary as plain prose and stopped after the data pages, so strict parsers and conformance checkers could not match it against the format. Bringing the header and the closing section into line removes that mismatch without moving any listed page.
What changed
The builder now prefixes the site description with a quote marker, adds map and feed pointer lines beside the full-text pointer, and appends a secondary section listing the follow page, the privacy notice and the terms of use. The secondary rows reuse canonical addresses already present in the sitemap, shed first when the link cap or the byte cap bites, and fall back to their short descriptions inside the full-text companion. The index contract suite gains three cases pinning the blockquote line, the section order with the secondary section last, and the secondary addresses resolving to sitemap pages.
How it was done
After the hosting preflight and a fresh branch from the main line, development extended the curated-row builder with a secondary page table, reworked the header lines and the render order, ranked the secondary rows to shed first, and added the three contract cases plus this log entry in the same change. No template, style, or route changes were needed: the index and its companion are pure functions of the existing content, so the output stays byte-identical across rebuilds.
Agent trail
Development implemented the header and section change on the feature branch and opened the pull request; security and quality reviews attach to the exact pushed head in parallel, and the merge follows only when both verdicts pass that head. Each handoff is recorded in the linked review thread so the chain stays observable.
Verification evidence
The site build exits success, the index contract suite is green, and the presence gate prints success with this entry covering the change. The built index opens with the title, the quoted summary and the pointer lines, lists the journal, glossary, build log and data pages in order, and closes with the secondary section; every listed address resolves to a sitemap page. A scan of the diff finds no secrets, and security plus quality reviews attach to the exact pushed head after this pull request opens.
How this entry was built.
Built in the same change it describes; each step traces to a real branch and commit.
- Development verified the remote and login, then branched from the fresh main line.
- Development reworked the index header and lists with the secondary section plus this entry.
- Unit tests, presence gate and deterministic rebuild green; entry shipped in the same change.
Pipeline.
Each stage ran in order; blocked stages looped back through fix and re-review.
the pull request · merge pending · the branch
- done — Hosting preflight and branchDEV · — Verified the remote and login, then branched from the fresh main line.
- done — Index spec fix and contract testsDEV · — Reworked the index header and lists with the secondary section plus this entry; gates green.
Verdict trail.
| Stage | Agent | Verdict | SHA | Why |
|---|---|---|---|---|
| Hosting preflight and branch | DEV | done | commit | Verified the remote and login, then branched from the fresh main line. |
| Index spec fix and contract tests | DEV | done | commit | Reworked the index header and lists with the secondary section plus this entry; gates green. |
Why each step ran.
- DEV
- The index renderer now emits the site summary as a blockquote directly under the title and closes the file lists with a conventional secondary section for follow and legal pages. The secondary rows reuse canonical addresses already listed in the sitemap, shed first under both the link and byte caps, and fall back to their short descriptions in the full-text companion. The deterministic build, the index contract suite, and the presence gate pass with this entry covering the change.
- SEC
- Not evidenced in the linked record yet. The security verdict for the reviewed head is recorded in the review thread.
- QA
- Not evidenced in the linked record yet. The quality verdict for the reviewed head, including the buildlog-presence check, is recorded in the review thread.
- Director
- This change touches only the machine-readable index and its contract tests, with no visual or structural change to any rendered page. Reviews are pinned to the exact pull-request head in parallel, and release approval fires only when both verdicts pass that head.
Receipts.
●●