6 Commits

Include renames

Author	SHA1	Message	Date
swaits	a031c6e266	chore: repoint remaining links at git.swaits.com ... Rewrites lingering github.com / *.sr.ht references to this Gitea instance, translating GitHub and Sourcehut URL shapes to Gitea's (/blob/<ref>/ and sr.ht /tree/<ref>/item/ -> /src/branch/<ref>/, /tree/<tag> -> /src/tag/<tag>, /actions/workflows/X -> /actions?workflow=X, /edit/ -> /_edit/). Left pointing at the old hosts on purpose: pull-request links (PRs were not migrated), forks that were never migrated, and GitHub-only surfaces Gitea lacks. OpenPGP identity proofs are untouched by design.	2026-08-31 18:32:21 -06:00
swaitsandClaude Opus 4.7	9232c16f7c	feat(versioning): snapshot corpus per spec version ... A frozen spec is only meaningful if it's paired with the corpus that was current at release time — otherwise a v0.1.0 reader follows "see corpus/payloads/ack/" and lands on a file whose test vectors may have changed since v0.1.0 was cut. Three changes: 1. `cut-version` now copies BOTH src/ AND corpus/ into the snapshot directory. A release is the pair, not just the text. 2. The corpus URL rewriting in cut-version now retargets /tree/main/corpus -> /tree/main/versions/<v>/corpus (and the blob variant). This lets the link resolve on GitHub from main alone — no git tag required, since the frozen copy is a real path under main. Downgrades the "tag is REQUIRED" message from last commit back to "optionally tag the commit". 3. The frozen corpus's spec_ref fields get rewritten too: from `src/04-payload-ack.md` to `versions/<v>/04-payload-ack.md`, so a reader following a test vector lands on the spec text the vector was paired with at release time. versions/v0.1.0/ regenerated from scratch via `just cut-version v0.1.0` to pick up the corpus snapshot + the new sed patterns. The release is now self-consistent: v0.1.0 spec links go to v0.1.0 corpus, which links back to v0.1.0 spec. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-12 10:38:02 -06:00
swaitsandClaude Opus 4.7	f83d4088e3	spec: link corpus references to GitHub, version-aware ... Every "Test vectors: \`corpus/...\`" mention in the spec is now a markdown link pointing at the corresponding file or directory on GitHub. Each version build resolves its links to the correct git ref: - /latest/ -> https://github.com/swaits/meshcore-spec/tree/main/corpus/... - /v0.1.0/ -> https://github.com/swaits/meshcore-spec/tree/v0.1.0/corpus/... - future /vX.Y.Z/ -> /tree/vX.Y.Z/corpus/... Two changes: 1. src/*.md (18 files): the inline-code corpus paths in each "Cross-References" section are now markdown links. Directories point at /tree/main/corpus/..., individual .json files point at /blob/main/corpus/.... CHANGELOG and other non-corpus main links are intentionally left pointing at main — the canonical history lives there regardless of which version you're reading. 2. justfile: `cut-version` now also runs a sed over the snapshot's *.md files replacing /tree/main/corpus -> /tree/<VERSION>/corpus and /blob/main/corpus -> /blob/<VERSION>/corpus. So a freshly-cut version is self-consistent. versions/v0.1.0/* regenerated by re-running `just cut-version v0.1.0` after the new src/ links + recipe sed landed. Tagging the release commit (`git tag v0.1.0`) is now REQUIRED — not "optional" — because the rendered /v0.1.0/ pages reference /tree/v0.1.0/corpus/... on GitHub. Without the tag the links 404. cut-version's output now says so. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-12 10:35:09 -06:00
swaitsandClaude Opus 4.7	b6c91505e1	docs: switch author attribution from "Stephen Waits" to SWaits ... Per maintainer's preference, the project's outward-facing copy now refers to the author as [SWaits](https://swaits.com/) instead of his legal name and email address. Touched in this commit: - src/00-overview.md (Status and Provenance callout) - README.md (Provenance section + Author section; the email steve@waits.net is dropped — swaits.com is now the canonical contact) - book.toml (authors = ["SWaits"], plain text since TOML) - versions/v0.1.0/00-overview.md (regenerated via `just cut-version v0.1.0` after src/ was updated) Git author identity on commit metadata is a separate, git/jj-config concern and is intentionally not touched. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-12 10:33:15 -06:00
swaitsandClaude Opus 4.7	c70ab07c32	feat(mdbook): show spec version in overview body + page title ... The first version cut (v0.1.0) revealed a real gap: nothing in the rendered book identified which release the reader was on. The version-picker chip says "version: v0.1.0" when you're on /v0.1.0/, but it's a small UI affordance — and on /latest/ it can't say "v0.1.0" because /latest/ is the rolling main build, not the v0.1.0 release. Two complementary fixes, both visible without JS: 1. **Body marker.** Top of every chapter-0 (overview) page now reads `Spec version: <token>`. The token is `latest (main)` in src/, and gets frozen to the actual version (`v0.1.0`) when cut-version snapshots the directory. So /latest/ overview says "latest (main)" and /v0.1.0/ overview says "v0.1.0". 2. **Per-build page title.** scripts/build-site.sh now sets `MDBOOK_BOOK__TITLE` for each build: - latest → "MeshCore Protocol Specification — latest (main)" - vX.Y.Z → "MeshCore Protocol Specification — vX.Y.Z" The browser tab and mdBook sidebar header reflect the version. `just cut-version` updated to run a one-line sed on the snapshot's 00-overview.md replacing the `latest (main)` marker. Defensive grep warns if the marker isn't found (e.g., src/ was edited away from the expected line). versions/v0.1.0/00-overview.md regenerated by re-running `just cut-version v0.1.0` after the marker landed in src/ — so the v0.1.0 snapshot now self-identifies correctly. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-12 10:22:59 -06:00
swaitsandClaude Opus 4.7	44305a06db	release: v0.1.0 ... First cut release. Snapshots ./src/ as ./versions/v0.1.0/ via `just cut-version v0.1.0` (22 files: 21 chapter MDs + SUMMARY.md). Deployed alongside `latest` at: https://swaits.github.io/meshcore-spec/v0.1.0/ Also: - CHANGELOG.md adopts Keep a Changelog-style version sections. Future entries land under [Unreleased] and graduate to a version heading when cut. The existing date-stamped pass entries stay put as a historical record of the work captured in v0.1.0. - README.md fixes a stale "per vX.Y.Z tag" mention left over from the tag-based versioning model, and links the current release explicitly. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-12 10:04:40 -06:00