File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change 1+ # SPDX-License-Identifier: MPL-2.0
2+ # README single-source derivation (ADR-004): README.adoc is canonical;
3+ # README.md is derived for the Glama MCP directory (Markdown-only renderer).
4+ # This caller delegates to the standards reusable, which reads the
5+ # [publishing.readme] declaration in .machine_readable/*/ECOSYSTEM.a2ml,
6+ # regenerates README.md behind a vocabulary gate, and fails-and-tells if the
7+ # committed README.md is stale relative to README.adoc.
8+ name : README Derive
9+
10+ on :
11+ push :
12+ branches : [main, master]
13+ paths :
14+ - README.adoc
15+ - README.md
16+ - .machine_readable/**/ECOSYSTEM.a2ml
17+ pull_request :
18+ paths :
19+ - README.adoc
20+ - README.md
21+ - .machine_readable/**/ECOSYSTEM.a2ml
22+
23+ permissions :
24+ contents : read
25+
26+ jobs :
27+ readme-derive :
28+ # Pinned to the standards commit that introduced readme-derive-reusable.yml.
29+ # Repin to include hyperpolymath/standards#476 (anchor-ID convention guard)
30+ # once it lands on main; this repo's README.adoc already satisfies it.
31+ uses : hyperpolymath/standards/.github/workflows/readme-derive-reusable.yml@db12a6ad3ef9076d5f7bdcf98d7d15cf8547555a
Original file line number Diff line number Diff line change @@ -15,6 +15,10 @@ permissions:
1515
1616jobs :
1717 scan :
18+ permissions :
19+ contents : read
20+ pull-requests : write
21+ actions : read
1822 uses : hyperpolymath/standards/.github/workflows/secret-scanner-reusable.yml@d135b05bfc647d0c0fbfedc7e80f37ea50f49236
1923 timeout-minutes : 10
20- secrets : inherit
24+ secrets : inherit
Original file line number Diff line number Diff line change @@ -48,3 +48,15 @@ seed-nodes = [
4848]
4949dns-status = "hyperpolymath.dev undelegated — registrar action needed (see container/fly/DNS-SETUP.adoc); *.fly.dev hostnames operative"
5050federation-protocol = "Umoja gossip (X25519 + ChaCha20-Poly1305, UDP 9999, IPv6)"
51+
52+ # ── Publishing (ADR-004: README single-source derivation) ──────────────────
53+ # README.adoc is canonical; README.md is DERIVED (GENERATED banner) for Glama,
54+ # which renders Markdown only. Regenerated + freshness-checked by the
55+ # readme-derive workflow. Never hand-edit README.md.
56+ [publishing.readme]
57+ canonical = "README.adoc"
58+ derive = true
59+ format = "gfm"
60+ path = "README.md"
61+ consumer = "glama"
62+ reason = "Glama MCP directory renders Markdown only; canonical README.adoc renders as raw markup there"
You can’t perform that action at this time.
0 commit comments