chrome-extensions.sgit.ai / admin
How this site is built
Static HTML in the sgit.ai design language, released the same way as the main site and its siblings: every push to dev is validated, auto-tagged, and deployed to GitHub Pages.
The release pipeline
- validate —
node admin/build/validate.js: internal links resolve, version agrees everywhere, canonical links point atchrome-extensions.sgit.ai, a key-leak tripwire bans anything shaped like a vault key, and a target-anonymity blocklist bans naming the recorder's real target (06__ §1). A failure stops the release: no tag, no publish. Also runs on pull requests, so branch work is gated before it reachesdev. - tag-release — every push to
devends taggedv{release}.{major}.{minor}. The version is owned byadmin/build/version.txt, bumped exactly once per release, and must agree with the release commit's subject (site vX.Y.Z: ...). CI verifies the two agree and that the bump is the next minor (or a deliberate major), then tags. The first run backfills tags for historical releases from commit subjects. Adapted from the SGit-AI__Website workflow. - deploy — publishes the tagged working tree to GitHub Pages. Runs on manual dispatch even without a tag, never when validation failed.
Releasing a change
# 1. bump the version — exactly once per release echo "v0.1.1" > admin/build/version.txt # 2. add a row to admin/versions.html, update admin/comms.html # 3. validate locally node admin/build/validate.js # 4. commit with the version in the subject, push to dev git commit -am "site v0.1.1: what changed" git push origin dev
Conventions carried from sgit.ai
- Light theme, same design tokens, same honest-limitations posture.
- Claim-state boxes stated per claim (
evbox/claim-*pattern) — recalled · read · measured, with a date. - The version badge fills at load time from
assets/version.js(window.SITE_VERSION) — the one place a release stamps it, so a release does not rewrite every page's badge. - Machine-readable entry points: llms.txt, index.md, rubric.json. Full
.mdtwins for every page andllms-full.txtare queued (T8 on comms) — the four guides already have raw twins under /sources/. - The git-and-sgit co-existence pattern (site tree simultaneously a vault) is not yet adopted here — this MVP is plain git, same as nhi.sgit.ai's initial release.