Commit 1376eb6
docs(cartridges): add Reference implementations subsection (#333)
## Summary
Adds a short `== Reference implementations` subsection at the end of
`cartridges/CARTRIDGE-FORMAT.adoc` pointing implementers at the live
downstream consumer of this format.
The cartridge format here is now consumed by
`hyperpolymath/boj-server-cartridges`, which serves as the canonical
registry (already referenced in `<<Registry and on-demand fetch>>`) and
exercises the schema across every shipped cartridge. New section gives
implementers a worked example to read.
## Rationale
Downstream landed three pieces of machinery worth pointing at from the
spec:
- A SHA-pinned mirror of `cartridge-v1.json` at `schemas/` with
`PINNED-SHA` + `SCHEMA-MIRROR.md` documenting the refresh discipline.
- A zero-dep Deno validator at `tools/validate-cartridges/` (only
`jsr:@std/fs` + `jsr:@std/path` + `jsr:@std/assert`) with `audit` /
`audit-verbose` / `strict` / `test` tasks.
- A blocking CI gate at `.github/workflows/cartridge-schema.yml`; strict
mode went live 2026-06-01 after 139/139 manifests passed.
Subsection is ~28 lines, doesn't restate the spec, and clarifies that
downstreams pin by SHA rather than tracking `main` — bumps follow the
procedure in downstream's `schemas/SCHEMA-MIRROR.md`.
## Test plan
- [ ] AsciiDoc renders cleanly (manual review of the new subsection).
- [ ] No other content modified — diff is a pure append at end-of-file.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>1 parent 2894681 commit 1376eb6
1 file changed
Lines changed: 27 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
156 | 156 | | |
157 | 157 | | |
158 | 158 | | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
| 170 | + | |
| 171 | + | |
| 172 | + | |
| 173 | + | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
| 181 | + | |
| 182 | + | |
| 183 | + | |
| 184 | + | |
| 185 | + | |
0 commit comments