Answer engines and coding assistants now get a plain-text map of the journal, rebuilt on every build from the same sources as the feed and the sitemap.
Motivation
The site published feeds and a sitemap for machines but offered no curated reading map at the well-known plain-text path. A short index of canonical pages plus a capped full-text companion closes that gap with zero runtime cost.
What changed
The builder emits two deterministic text files: a Markdown index of the latest journal posts, every evergreen glossary page, recent log entries and the reference pages; and a companion file with the same index plus the stripped body text of each listed page under a documented byte cap. Server config now covers plain-text files for caching and compression. The live index is the plain-text map.
How it was done
A new generator step runs inside the existing build beside the feed and sitemap emission, reading only published metadata and page bodies. A new test rebuilds and pins file presence, canonical URLs against the sitemap set, the byte cap and byte-identical rebuilds.
Verification evidence
The deterministic site build passes and the full suite is green including the nine new index tests. The presence gate passes with this entry, and every listed URL resolves to a page the builder emits.
How this entry was built.
Each step ran through the company pipeline.
- The generator step was added beside the feed emission.
- The index tests were added and the suite passed.
- The pull request opened with the log entry 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 — ImplementationDEV · — Built the index generator beside the feed and sitemap emission.
- done — Pull requestDEV · — Opened the pull request with the log entry in the same change.
Verdict trail.
| Stage | Agent | Verdict | SHA | Why |
|---|---|---|---|---|
| Implementation | DEV | done | commit | Built the index generator beside the feed and sitemap emission. |
| Pull request | DEV | done | commit | Opened the pull request with the log entry in the same change. |
Why each step ran.
- DEV
- The build now emits a curated plain-text index and a full-text companion beside the existing feed and sitemap files. The set covers the latest journal posts, every evergreen glossary page, recent log entries and the reference pages. The new test pins existence, canonical URLs, the byte cap and rebuild determinism.
- 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 is recorded in the review thread.
- SRE
- Not evidenced in the linked record yet. Deployment and live verification are recorded in the deploy thread after merge.
- Director
- Not evidenced in the linked record yet. Release approval fires only when security and quality verdicts pass the exact pull-request head.
Receipts.
●●