Start the arc42 contract and publish the first ADR set
Add the owner-facing publication contract, a regenerable ADR review ledger, and publication entries for this repo's ADR-0001 plus the eight ready railiance-master ADRs.
This commit is contained in:
parent
7a24e9107f
commit
a8fb62a3bc
34 changed files with 9669 additions and 28 deletions
2
Makefile
2
Makefile
|
|
@ -10,7 +10,7 @@ build:
|
||||||
|
|
||||||
check:
|
check:
|
||||||
python3 -m unittest discover -s tests -p 'test_*.py'
|
python3 -m unittest discover -s tests -p 'test_*.py'
|
||||||
python3 -m py_compile tools/render.py tools/build_site.py tools/check_currency.py tools/verify_release.py tools/source_inventory.py tools/fetch_sources.py
|
python3 -m py_compile tools/render.py tools/build_site.py tools/check_currency.py tools/verify_release.py tools/source_inventory.py tools/fetch_sources.py tools/adr_review_ledger.py
|
||||||
$(MAKE) source-audit
|
$(MAKE) source-audit
|
||||||
git diff --check
|
git diff --check
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -16,6 +16,8 @@ Not a CMS, not a documentation site, not a policy author, and not a source of
|
||||||
legal advice.
|
legal advice.
|
||||||
|
|
||||||
- Intent: `INTENT.md`
|
- Intent: `INTENT.md`
|
||||||
|
- Owner publication contract: `docs/publication-contract.md`
|
||||||
|
- ADR review ledger (unpublished work artefact): `docs/adr-review/`
|
||||||
- Workplans: `workplans/`
|
- Workplans: `workplans/`
|
||||||
|
|
||||||
Build and verify the publication locally with:
|
Build and verify the publication locally with:
|
||||||
|
|
|
||||||
214
build/adr/addressing-and-permanence/v1/index.html
Normal file
214
build/adr/addressing-and-permanence/v1/index.html
Normal file
|
|
@ -0,0 +1,214 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="7a24e9107fd62772a82d8b2a69692a09ce88eea9+working-tree.a28668fb4b8b">
|
||||||
|
<meta name="policy-source-digest" content="a28668fb4b8b6c5ec8c94baac000061276d85ef1849ec7ab8d132b913dbfe3be">
|
||||||
|
<title>Policy addressing and permanence</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>policy-nexus-adr-0001</span> <span class="stat">accepted · accepted-1</span> <span>the-custodian</span> <span>reviewed 2026-08-18</span><span>generated from canonical source — do not edit</span></div><h1>Policy addressing and permanence</h1><p class="sub">Source: <code>policy-nexus · docs/adr/ADR-0001-addressing-and-permanence.md · 7a24e9107fd62772a82d8b2a69692a09ce88eea9+working-tree.a28668fb4b8b</code></p><p class="sub">Review due: 2027-02-18</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#permanence-promise"><span class="n">·</span>Permanence promise</a></li><li><a href="#publication-scope"><span class="n">·</span>Publication scope</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li></ol></nav><main><ul><li>Status: accepted</li><li>Date: 2026-08-18</li><li>Owner: the-custodian</li></ul>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>A document has one stable current address and immutable revision addresses:</p>
|
||||||
|
<pre>/<kind>/<document>/<version>/
|
||||||
|
/<kind>/<document>/<version>/revisions/<revision>/</pre>
|
||||||
|
<p><code><kind></code> is one of <code>standards</code>, <code>architecture</code>, <code>constitution</code>, or <code>adr</code>. <code><document></code> is a kebab-case slug that is unique on the site. The owner-facing rules live in <code>docs/publication-contract.md</code>.</p>
|
||||||
|
<p>The publication manifest records both. Existing public paths become permanent redirect aliases; the first is <code>/tenancy-posture.html</code>. No URL is derived from a checkout path, branch name, build number or hosting implementation.</p>
|
||||||
|
<p>The current address advances only when the owning source publishes a new revision. A revision address is write-once: the builder records the exact git commit (or commit plus working-tree marker) and the full source-content digest. It refuses to replace that revision with different content. Committing the same bytes may update the current page's provenance but does not rewrite the already-published revision page. The generated publication manifest makes the source repository, path, revision and digest machine-readable.</p>
|
||||||
|
<p>Superseded and withdrawn documents are never deleted. The current page gains a status banner and link to its successor; every historical revision continues to resolve. “Withdrawn” means retained and visibly non-current. Deletion is not a lifecycle state.</p>
|
||||||
|
<p>Source Git history remains the authority for versions that predate this site. Once a revision is published, the built revision page is also retained by the hosting artifact/release. Rollback republishes a previous complete build; it does not rebuild old pages from a changed working tree.</p>
|
||||||
|
</section>
|
||||||
|
<section id="permanence-promise"><h2>Permanence promise</h2>
|
||||||
|
<p>A published URL is expected to resolve indefinitely. Breaking that promise requires an explicit the-custodian decision plus a redirect/export plan. A DNS, hosting or repository migration does not qualify: those must preserve paths.</p>
|
||||||
|
<p>This repo owns addressing, rendering and currency. It does not decide whether a draft is accepted; ratification belongs to the canon owner/the-custodian.</p>
|
||||||
|
</section>
|
||||||
|
<section id="publication-scope"><h2>Publication scope</h2>
|
||||||
|
<p>Canon <code>standards</code>, <code>architecture</code>, and <code>constitution</code> are in scope. <code>values</code>, <code>tpsc</code>, and <code>projects</code> are out until their owner marks individual documents as governing. Per-repo ADRs are in scope through explicit manifest entries. Workplans, evidence, runbooks and general docs are not.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<ul><li>Builds fail if a source disappears, an id differs, a path collides, or an immutable revision would change; stale output is not silently called fresh.</li><li>Pages show status, revision, owner, last review and exact source revision.</li><li>Availability remains restart recovery on the single-node rail. This contract promises stable addressing, not a high-availability SLA.</li></ul>
|
||||||
|
</section><footer><span>policy-nexus-adr-0001 · accepted-1 · accepted</span><span>policy-nexus · docs/adr/ADR-0001-addressing-and-permanence.md · 7a24e9107fd62772a82d8b2a69692a09ce88eea9+working-tree.a28668fb4b8b</span></footer></main></div></div></html>
|
||||||
|
|
@ -0,0 +1,214 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="7a24e9107fd62772a82d8b2a69692a09ce88eea9+working-tree.a28668fb4b8b">
|
||||||
|
<meta name="policy-source-digest" content="a28668fb4b8b6c5ec8c94baac000061276d85ef1849ec7ab8d132b913dbfe3be">
|
||||||
|
<title>Policy addressing and permanence</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>policy-nexus-adr-0001</span> <span class="stat">accepted · accepted-1</span> <span>the-custodian</span> <span>reviewed 2026-08-18</span><span>generated from canonical source — do not edit</span></div><h1>Policy addressing and permanence</h1><p class="sub">Source: <code>policy-nexus · docs/adr/ADR-0001-addressing-and-permanence.md · 7a24e9107fd62772a82d8b2a69692a09ce88eea9+working-tree.a28668fb4b8b</code></p><p class="sub">Review due: 2027-02-18</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#permanence-promise"><span class="n">·</span>Permanence promise</a></li><li><a href="#publication-scope"><span class="n">·</span>Publication scope</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li></ol></nav><main><ul><li>Status: accepted</li><li>Date: 2026-08-18</li><li>Owner: the-custodian</li></ul>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>A document has one stable current address and immutable revision addresses:</p>
|
||||||
|
<pre>/<kind>/<document>/<version>/
|
||||||
|
/<kind>/<document>/<version>/revisions/<revision>/</pre>
|
||||||
|
<p><code><kind></code> is one of <code>standards</code>, <code>architecture</code>, <code>constitution</code>, or <code>adr</code>. <code><document></code> is a kebab-case slug that is unique on the site. The owner-facing rules live in <code>docs/publication-contract.md</code>.</p>
|
||||||
|
<p>The publication manifest records both. Existing public paths become permanent redirect aliases; the first is <code>/tenancy-posture.html</code>. No URL is derived from a checkout path, branch name, build number or hosting implementation.</p>
|
||||||
|
<p>The current address advances only when the owning source publishes a new revision. A revision address is write-once: the builder records the exact git commit (or commit plus working-tree marker) and the full source-content digest. It refuses to replace that revision with different content. Committing the same bytes may update the current page's provenance but does not rewrite the already-published revision page. The generated publication manifest makes the source repository, path, revision and digest machine-readable.</p>
|
||||||
|
<p>Superseded and withdrawn documents are never deleted. The current page gains a status banner and link to its successor; every historical revision continues to resolve. “Withdrawn” means retained and visibly non-current. Deletion is not a lifecycle state.</p>
|
||||||
|
<p>Source Git history remains the authority for versions that predate this site. Once a revision is published, the built revision page is also retained by the hosting artifact/release. Rollback republishes a previous complete build; it does not rebuild old pages from a changed working tree.</p>
|
||||||
|
</section>
|
||||||
|
<section id="permanence-promise"><h2>Permanence promise</h2>
|
||||||
|
<p>A published URL is expected to resolve indefinitely. Breaking that promise requires an explicit the-custodian decision plus a redirect/export plan. A DNS, hosting or repository migration does not qualify: those must preserve paths.</p>
|
||||||
|
<p>This repo owns addressing, rendering and currency. It does not decide whether a draft is accepted; ratification belongs to the canon owner/the-custodian.</p>
|
||||||
|
</section>
|
||||||
|
<section id="publication-scope"><h2>Publication scope</h2>
|
||||||
|
<p>Canon <code>standards</code>, <code>architecture</code>, and <code>constitution</code> are in scope. <code>values</code>, <code>tpsc</code>, and <code>projects</code> are out until their owner marks individual documents as governing. Per-repo ADRs are in scope through explicit manifest entries. Workplans, evidence, runbooks and general docs are not.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<ul><li>Builds fail if a source disappears, an id differs, a path collides, or an immutable revision would change; stale output is not silently called fresh.</li><li>Pages show status, revision, owner, last review and exact source revision.</li><li>Availability remains restart recovery on the single-node rail. This contract promises stable addressing, not a high-availability SLA.</li></ul>
|
||||||
|
</section><footer><span>policy-nexus-adr-0001 · accepted-1 · accepted</span><span>policy-nexus · docs/adr/ADR-0001-addressing-and-permanence.md · 7a24e9107fd62772a82d8b2a69692a09ce88eea9+working-tree.a28668fb4b8b</span></footer></main></div></div></html>
|
||||||
205
build/adr/railiance-derived-rail-composition/v1/index.html
Normal file
205
build/adr/railiance-derived-rail-composition/v1/index.html
Normal file
|
|
@ -0,0 +1,205 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="e02982ce54691cf1589ac3d04012b9b9282f9eb54ed4b8f2f0544371f9b87f3e">
|
||||||
|
<title>Derived Rail Composition</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0005</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-07-26</span><span>generated from canonical source — do not edit</span></div><h1>Derived Rail Composition</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0005-derived-rail-composition.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-01-26</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li></ol></nav><main><p>Date: 2026-07-26 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Knative provides distinct workload activation and revision semantics but runs on Kubernetes. Treating it as an unrelated peer rail would duplicate generic workload lifecycle and substrate assumptions.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>Railiance distinguishes base and derived rails.</p>
|
||||||
|
<p><code>rail-kubernetes</code> is the default base rail for platform workloads. <code>rail-knative</code> is a derived rail that inherits a versioned <code>rail-kubernetes</code> common contract and overrides only Knative-specific activation, revision, autoscaling, traffic, cold-start, and rollback semantics.</p>
|
||||||
|
<p>The detailed contract is <a href="../rail-composition-contract.md"><code>docs/rail-composition-contract.md</code></a>.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<ul><li>New platform workloads continue to use <code>rail-kubernetes</code> unless a specialized rail is justified.</li><li>Derived rails declare base-rail compatibility rather than copying lifecycle contracts.</li><li>Fabric and conformance tooling must understand rail dependency and readiness.</li><li>Knative installation stays with the S2 substrate owner.</li></ul>
|
||||||
|
</section><footer><span>RMASTER-ADR-0005 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0005-derived-rail-composition.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
|
|
@ -0,0 +1,205 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="e02982ce54691cf1589ac3d04012b9b9282f9eb54ed4b8f2f0544371f9b87f3e">
|
||||||
|
<title>Derived Rail Composition</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0005</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-07-26</span><span>generated from canonical source — do not edit</span></div><h1>Derived Rail Composition</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0005-derived-rail-composition.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-01-26</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li></ol></nav><main><p>Date: 2026-07-26 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Knative provides distinct workload activation and revision semantics but runs on Kubernetes. Treating it as an unrelated peer rail would duplicate generic workload lifecycle and substrate assumptions.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>Railiance distinguishes base and derived rails.</p>
|
||||||
|
<p><code>rail-kubernetes</code> is the default base rail for platform workloads. <code>rail-knative</code> is a derived rail that inherits a versioned <code>rail-kubernetes</code> common contract and overrides only Knative-specific activation, revision, autoscaling, traffic, cold-start, and rollback semantics.</p>
|
||||||
|
<p>The detailed contract is <a href="../rail-composition-contract.md"><code>docs/rail-composition-contract.md</code></a>.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<ul><li>New platform workloads continue to use <code>rail-kubernetes</code> unless a specialized rail is justified.</li><li>Derived rails declare base-rail compatibility rather than copying lifecycle contracts.</li><li>Fabric and conformance tooling must understand rail dependency and readiness.</li><li>Knative installation stays with the S2 substrate owner.</li></ul>
|
||||||
|
</section><footer><span>RMASTER-ADR-0005 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0005-derived-rail-composition.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
217
build/adr/railiance-first-wave-reef-rollout/v1/index.html
Normal file
217
build/adr/railiance-first-wave-reef-rollout/v1/index.html
Normal file
|
|
@ -0,0 +1,217 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="36ec3aad5082ceff685d66e091c0a24b52abfc65b36595d00dce2b52a7250f4e">
|
||||||
|
<title>First-Wave reef Rollout</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0004</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-07-26</span><span>generated from canonical source — do not edit</span></div><h1>First-Wave reef Rollout</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0004-first-wave-reef-rollout.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-01-26</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li><li><a href="#notes"><span class="n">·</span>Notes</a></li></ol></nav><main><p>Date: 2026-07-25 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Railiance now has a reef model, but it needs a concrete first rollout.</p>
|
||||||
|
<p>The current substrate reality is not uniform:</p>
|
||||||
|
<ul><li>Railiance01 is the clearest new-workload home</li><li>CoulombCore is still active but transitional</li><li>the workstation role is operator edge compute rather than server substrate</li></ul>
|
||||||
|
<p>At the same time, S1 ownership is ambiguous because <code>railiance-hosts</code> and <code>railiance-infra</code> duplicate each other.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>The first-wave reef rollout is:</p>
|
||||||
|
<ol><li><code>reef-railiance</code></li><li><code>reef-coulombcore</code></li><li><code>reef-ops-workstations</code></li></ol>
|
||||||
|
<p><code>railiance-infra</code> is the canonical S1 ownership repo going forward.</p>
|
||||||
|
<p><code>railiance-hosts</code> is treated as predecessor or duplicate state to be retired, frozen, or reduced later rather than as a second canonical S1 architecture home.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<h3>Positive</h3>
|
||||||
|
<ul><li>Railiance gets a grouped home-reef seed whose name remains stable as more home servers are added.</li><li>Transitional CoulombCore reality is acknowledged without being treated as the long-term preferred production pattern.</li><li>Operator edge compute is modeled without defaulting to one repo per machine.</li><li>Reef planning now rests on one canonical S1 ownership line.</li></ul>
|
||||||
|
<h3>Required Follow-On Work</h3>
|
||||||
|
<ul><li>Create repo-local rollout work for the first reef repos.</li><li>Define how additional Railiance home servers join <code>reef-railiance</code> and what future split criteria would justify narrower reefs.</li><li>Plan the <code>railiance-hosts</code> cleanup direction relative to <code>railiance-infra</code>.</li></ul>
|
||||||
|
<h3>Constraints</h3>
|
||||||
|
<ul><li>Multi-rail reefs are acceptable early, especially on transitional substrates.</li><li>Production-grade separation should still prefer clearer purpose and primary rail boundaries as criticality rises.</li><li>Transitional substrate nicknames should remain provisional until the pattern is stable enough to canonize.</li></ul>
|
||||||
|
</section>
|
||||||
|
<section id="notes"><h2>Notes</h2>
|
||||||
|
<p>This ADR chooses the first rollout set. It does not require that every future substrate be modeled the same way.</p>
|
||||||
|
</section><footer><span>RMASTER-ADR-0004 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0004-first-wave-reef-rollout.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
|
|
@ -0,0 +1,217 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="36ec3aad5082ceff685d66e091c0a24b52abfc65b36595d00dce2b52a7250f4e">
|
||||||
|
<title>First-Wave reef Rollout</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0004</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-07-26</span><span>generated from canonical source — do not edit</span></div><h1>First-Wave reef Rollout</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0004-first-wave-reef-rollout.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-01-26</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li><li><a href="#notes"><span class="n">·</span>Notes</a></li></ol></nav><main><p>Date: 2026-07-25 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Railiance now has a reef model, but it needs a concrete first rollout.</p>
|
||||||
|
<p>The current substrate reality is not uniform:</p>
|
||||||
|
<ul><li>Railiance01 is the clearest new-workload home</li><li>CoulombCore is still active but transitional</li><li>the workstation role is operator edge compute rather than server substrate</li></ul>
|
||||||
|
<p>At the same time, S1 ownership is ambiguous because <code>railiance-hosts</code> and <code>railiance-infra</code> duplicate each other.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>The first-wave reef rollout is:</p>
|
||||||
|
<ol><li><code>reef-railiance</code></li><li><code>reef-coulombcore</code></li><li><code>reef-ops-workstations</code></li></ol>
|
||||||
|
<p><code>railiance-infra</code> is the canonical S1 ownership repo going forward.</p>
|
||||||
|
<p><code>railiance-hosts</code> is treated as predecessor or duplicate state to be retired, frozen, or reduced later rather than as a second canonical S1 architecture home.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<h3>Positive</h3>
|
||||||
|
<ul><li>Railiance gets a grouped home-reef seed whose name remains stable as more home servers are added.</li><li>Transitional CoulombCore reality is acknowledged without being treated as the long-term preferred production pattern.</li><li>Operator edge compute is modeled without defaulting to one repo per machine.</li><li>Reef planning now rests on one canonical S1 ownership line.</li></ul>
|
||||||
|
<h3>Required Follow-On Work</h3>
|
||||||
|
<ul><li>Create repo-local rollout work for the first reef repos.</li><li>Define how additional Railiance home servers join <code>reef-railiance</code> and what future split criteria would justify narrower reefs.</li><li>Plan the <code>railiance-hosts</code> cleanup direction relative to <code>railiance-infra</code>.</li></ul>
|
||||||
|
<h3>Constraints</h3>
|
||||||
|
<ul><li>Multi-rail reefs are acceptable early, especially on transitional substrates.</li><li>Production-grade separation should still prefer clearer purpose and primary rail boundaries as criticality rises.</li><li>Transitional substrate nicknames should remain provisional until the pattern is stable enough to canonize.</li></ul>
|
||||||
|
</section>
|
||||||
|
<section id="notes"><h2>Notes</h2>
|
||||||
|
<p>This ADR chooses the first rollout set. It does not require that every future substrate be modeled the same way.</p>
|
||||||
|
</section><footer><span>RMASTER-ADR-0004 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0004-first-wave-reef-rollout.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
218
build/adr/railiance-private-by-default-exposure/v1/index.html
Normal file
218
build/adr/railiance-private-by-default-exposure/v1/index.html
Normal file
|
|
@ -0,0 +1,218 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="276ea38233413f1e23670bbf57c486abc361b0a275ca67efea7d677103713b32">
|
||||||
|
<title>Private-by-default Exposure</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0008</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-08-15</span><span>generated from canonical source — do not edit</span></div><h1>Private-by-default Exposure</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0008-private-by-default-exposure.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-02-15</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li></ol></nav><main><p>Date: 2026-08-15 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>ADR-0006 says a topology binding is not permission to run a workload in production. It does not say who may reach a listener. A working deploy, a <code>hosts_rail</code> / <code>binds_rapp</code> line, or an Ingress object has been enough to put something on the public internet.</p>
|
||||||
|
<p>Family readiness vocabularies are deliberately not unified (<code>schemas/README.md</code>). Reef <code>lifecycle_state</code> has no <code>production-approved</code>. Rapp <code>readiness_state</code> has no <code>production-approved</code> either. Exposure cannot be derived from those enums.</p>
|
||||||
|
<p>Live public surfaces already exist on <code>reef-railiance</code>. They must be named as grants, not silently grandfathered and not taken down by this decision.</p>
|
||||||
|
<p>Ratified 2026-08-15 under <code>RMASTER-WP-0023-T01</code>.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>New reefs, rails, and rapps are unreachable from the public internet until they are production-safe <strong>and</strong> explicitly granted. The field name is <code>exposure</code>. Missing field means <code>private</code>.</p>
|
||||||
|
<div class="scroll"><table><thead><tr><th>Posture</th><th>Meaning</th><th>Who may reach it</th></tr></thead><tbody><tr><td><code>private</code></td><td>No extra listener we control</td><td>in-cluster DNS, same-reef services</td></tr><tr><td><code>operator</code></td><td>Same listener as <code>private</code>, plus a named ops-bridge / SSH tunnel</td><td>operator and approved agents</td></tr><tr><td><code>public</code></td><td>Internet listener we publish</td><td>anyone the Ingress / DNS / UFW surface allows</td></tr></tbody></table></div>
|
||||||
|
<p><code>operator</code> is an access annotation, not a different packet posture. It does not open a host port or a public Ingress.</p>
|
||||||
|
<p>Default for a new reef, rail, or rapp is <code>private</code>. Use <code>operator</code> only for a named admin or API surface that must be reachable before admission (k3s API, OpenBao UI). Do not prefer <code>operator</code> as the debug default.</p>
|
||||||
|
<p><code>public</code> requires both an ADR-0006 binding of <code>production-approved</code> and an explicit grant. A deploy, a binding line, or an Ingress object is not a grant. Do not key <code>public</code> off rapp <code>readiness_state</code> and do not add <code>production-approved</code> to the rapp enum for this purpose.</p>
|
||||||
|
<p>A reef public surface (host port or public DNS we publish) is a <strong>substrate grant</strong>, not reef <code>lifecycle_state</code>. A rapp cannot be <code>public</code> on a reef that has not granted a public surface. Conflicting declarations fail closed.</p>
|
||||||
|
<p>The shared vocabulary is one enum. It is not one schema shape and not one admission check:</p>
|
||||||
|
<div class="scroll"><table><thead><tr><th>Family</th><th>What the field means</th><th>What makes <code>public</code> legal</th></tr></thead><tbody><tr><td><code>rapp-*</code></td><td>intended consumer-facing listener</td><td>binding <code>production-approved</code> + grant</td></tr><tr><td><code>rail-*</code></td><td>which listener classes the rail may emit</td><td>rail may emit public Ingress only when a bound grant exists</td></tr><tr><td><code>reef-*</code></td><td>host ports and public DNS we publish</td><td>substrate grant</td></tr></tbody></table></div>
|
||||||
|
<p>A grant is accepted residual risk, not a self-serve wish. Required fields: hostname or port, reason, <code>approved_on</code>, residual-risk owner.</p>
|
||||||
|
<p><code>6443</code> / the k3s API is not a grantable public surface.</p>
|
||||||
|
<p>This contract covers listeners we control: host ports, Ingress, Service types, and public DNS we publish. Provider-native internet APIs (Scaleway S3 and other provider-delegated endpoints) are outside this enum.</p>
|
||||||
|
<p>Ops-bridge is the normal path to a shielded thing.</p>
|
||||||
|
<p>The detailed per-family reading lives in <a href="../exposure-posture-contract.md"><code>docs/exposure-posture-contract.md</code></a>.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<ul><li>ADR-0006 still answers "may this binding run in production?" This ADR answers "who may reach the listener?" Do not merge the axes.</li><li>The three readiness enums stay distinct on purpose.</li><li>Family schemas grow an additive <code>exposure</code> field. Rapp <code>data_classification: public</code> is a different field and must not be reused as the posture name.</li><li>Implementation stays in the owning repos. This ADR does not install NetworkPolicy, UFW, Ingress, or tunnels.</li><li>Existing public surfaces on <code>reef-railiance</code> remain up until named as grants. This ADR is not a shutdown plan.</li><li>CoulombCore host inventory and Q7 / Goss reaction stay outside this decision.</li></ul>
|
||||||
|
</section><footer><span>RMASTER-ADR-0008 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0008-private-by-default-exposure.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
|
|
@ -0,0 +1,218 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="276ea38233413f1e23670bbf57c486abc361b0a275ca67efea7d677103713b32">
|
||||||
|
<title>Private-by-default Exposure</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0008</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-08-15</span><span>generated from canonical source — do not edit</span></div><h1>Private-by-default Exposure</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0008-private-by-default-exposure.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-02-15</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li></ol></nav><main><p>Date: 2026-08-15 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>ADR-0006 says a topology binding is not permission to run a workload in production. It does not say who may reach a listener. A working deploy, a <code>hosts_rail</code> / <code>binds_rapp</code> line, or an Ingress object has been enough to put something on the public internet.</p>
|
||||||
|
<p>Family readiness vocabularies are deliberately not unified (<code>schemas/README.md</code>). Reef <code>lifecycle_state</code> has no <code>production-approved</code>. Rapp <code>readiness_state</code> has no <code>production-approved</code> either. Exposure cannot be derived from those enums.</p>
|
||||||
|
<p>Live public surfaces already exist on <code>reef-railiance</code>. They must be named as grants, not silently grandfathered and not taken down by this decision.</p>
|
||||||
|
<p>Ratified 2026-08-15 under <code>RMASTER-WP-0023-T01</code>.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>New reefs, rails, and rapps are unreachable from the public internet until they are production-safe <strong>and</strong> explicitly granted. The field name is <code>exposure</code>. Missing field means <code>private</code>.</p>
|
||||||
|
<div class="scroll"><table><thead><tr><th>Posture</th><th>Meaning</th><th>Who may reach it</th></tr></thead><tbody><tr><td><code>private</code></td><td>No extra listener we control</td><td>in-cluster DNS, same-reef services</td></tr><tr><td><code>operator</code></td><td>Same listener as <code>private</code>, plus a named ops-bridge / SSH tunnel</td><td>operator and approved agents</td></tr><tr><td><code>public</code></td><td>Internet listener we publish</td><td>anyone the Ingress / DNS / UFW surface allows</td></tr></tbody></table></div>
|
||||||
|
<p><code>operator</code> is an access annotation, not a different packet posture. It does not open a host port or a public Ingress.</p>
|
||||||
|
<p>Default for a new reef, rail, or rapp is <code>private</code>. Use <code>operator</code> only for a named admin or API surface that must be reachable before admission (k3s API, OpenBao UI). Do not prefer <code>operator</code> as the debug default.</p>
|
||||||
|
<p><code>public</code> requires both an ADR-0006 binding of <code>production-approved</code> and an explicit grant. A deploy, a binding line, or an Ingress object is not a grant. Do not key <code>public</code> off rapp <code>readiness_state</code> and do not add <code>production-approved</code> to the rapp enum for this purpose.</p>
|
||||||
|
<p>A reef public surface (host port or public DNS we publish) is a <strong>substrate grant</strong>, not reef <code>lifecycle_state</code>. A rapp cannot be <code>public</code> on a reef that has not granted a public surface. Conflicting declarations fail closed.</p>
|
||||||
|
<p>The shared vocabulary is one enum. It is not one schema shape and not one admission check:</p>
|
||||||
|
<div class="scroll"><table><thead><tr><th>Family</th><th>What the field means</th><th>What makes <code>public</code> legal</th></tr></thead><tbody><tr><td><code>rapp-*</code></td><td>intended consumer-facing listener</td><td>binding <code>production-approved</code> + grant</td></tr><tr><td><code>rail-*</code></td><td>which listener classes the rail may emit</td><td>rail may emit public Ingress only when a bound grant exists</td></tr><tr><td><code>reef-*</code></td><td>host ports and public DNS we publish</td><td>substrate grant</td></tr></tbody></table></div>
|
||||||
|
<p>A grant is accepted residual risk, not a self-serve wish. Required fields: hostname or port, reason, <code>approved_on</code>, residual-risk owner.</p>
|
||||||
|
<p><code>6443</code> / the k3s API is not a grantable public surface.</p>
|
||||||
|
<p>This contract covers listeners we control: host ports, Ingress, Service types, and public DNS we publish. Provider-native internet APIs (Scaleway S3 and other provider-delegated endpoints) are outside this enum.</p>
|
||||||
|
<p>Ops-bridge is the normal path to a shielded thing.</p>
|
||||||
|
<p>The detailed per-family reading lives in <a href="../exposure-posture-contract.md"><code>docs/exposure-posture-contract.md</code></a>.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<ul><li>ADR-0006 still answers "may this binding run in production?" This ADR answers "who may reach the listener?" Do not merge the axes.</li><li>The three readiness enums stay distinct on purpose.</li><li>Family schemas grow an additive <code>exposure</code> field. Rapp <code>data_classification: public</code> is a different field and must not be reused as the posture name.</li><li>Implementation stays in the owning repos. This ADR does not install NetworkPolicy, UFW, Ingress, or tunnels.</li><li>Existing public surfaces on <code>reef-railiance</code> remain up until named as grants. This ADR is not a shutdown plan.</li><li>CoulombCore host inventory and Q7 / Goss reaction stay outside this decision.</li></ul>
|
||||||
|
</section><footer><span>RMASTER-ADR-0008 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0008-private-by-default-exposure.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
|
|
@ -0,0 +1,218 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="7e1fc5aedd7294192d8702a22b9f205e5bae20793836fdc48c0c071d10d7ab9d">
|
||||||
|
<title>Wave 1 rail-kubernetes Boundary</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0002</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-07-25</span><span>generated from canonical source — do not edit</span></div><h1>Wave 1 rail-kubernetes Boundary</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-01-25</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li><li><a href="#notes"><span class="n">·</span>Notes</a></li></ol></nav><main><p>Date: 2026-07-25 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Railiance wants <code>rail-*</code> repos to represent workload execution contracts rather than abstract naming ideas.</p>
|
||||||
|
<p>Today, the concrete Kubernetes workload contract already exists, but it is embedded in <code>railiance-cluster</code>. That repo currently owns both:</p>
|
||||||
|
<ul><li>the S2 Kubernetes substrate</li><li>and the generic workload lifecycle and tooling that run on top of it</li></ul>
|
||||||
|
<p>That mixed ownership is the main blocker to introducing the first real rail.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>Railiance will treat <code>rail-kubernetes</code> as the wave-1 base rail.</p>
|
||||||
|
<p>The boundary is:</p>
|
||||||
|
<ul><li><code>railiance-cluster</code> owns the Kubernetes substrate and its prerequisites</li><li><code>rail-kubernetes</code> owns the generic workload-on-Kubernetes execution contract</li></ul>
|
||||||
|
<p>Workload-specific helper flows currently living in <code>railiance-cluster</code> are temporary exceptions and must be rehomed rather than carried forward as part of the generic rail.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<h3>Positive</h3>
|
||||||
|
<ul><li>The first real rail gains a concrete ownership boundary.</li><li><code>railiance-cluster</code> can return to a clean S2 substrate identity.</li><li>Future rails such as <code>rail-knative</code> get a stable base boundary to extend from.</li><li><code>rapp-*</code> repos gain a clearer execution-contract home for Kubernetes-managed workloads.</li></ul>
|
||||||
|
<h3>Required Follow-On Work</h3>
|
||||||
|
<ul><li>Create the detailed <code>rail-kubernetes</code> boundary contract and migration map.</li><li>Split generic lifecycle docs, schema, examples, and Stage 1-3 tooling out of <code>railiance-cluster</code>.</li><li>Leave a compatibility path so current users of the cluster repo are not broken during the migration.</li><li>Rehome workload-specific helpers that do not belong in either boundary.</li></ul>
|
||||||
|
<h3>Constraints</h3>
|
||||||
|
<ul><li><code>rail-kubernetes</code> must not take ownership of cluster bootstrap, operators, or kubeconfig management.</li><li><code>railiance-cluster</code> must not continue as the owner of generic workload promotion semantics after the split.</li><li><code>rail-knative</code> should follow this cleanup, not bypass it.</li></ul>
|
||||||
|
</section>
|
||||||
|
<section id="notes"><h2>Notes</h2>
|
||||||
|
<p>This ADR does not require all current files to move immediately.</p>
|
||||||
|
<p>It requires the ownership line to be explicit now, so practical repo separation can proceed without ambiguity.</p>
|
||||||
|
</section><footer><span>RMASTER-ADR-0002 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
|
|
@ -0,0 +1,218 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="7e1fc5aedd7294192d8702a22b9f205e5bae20793836fdc48c0c071d10d7ab9d">
|
||||||
|
<title>Wave 1 rail-kubernetes Boundary</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0002</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-07-25</span><span>generated from canonical source — do not edit</span></div><h1>Wave 1 rail-kubernetes Boundary</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-01-25</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li><li><a href="#notes"><span class="n">·</span>Notes</a></li></ol></nav><main><p>Date: 2026-07-25 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Railiance wants <code>rail-*</code> repos to represent workload execution contracts rather than abstract naming ideas.</p>
|
||||||
|
<p>Today, the concrete Kubernetes workload contract already exists, but it is embedded in <code>railiance-cluster</code>. That repo currently owns both:</p>
|
||||||
|
<ul><li>the S2 Kubernetes substrate</li><li>and the generic workload lifecycle and tooling that run on top of it</li></ul>
|
||||||
|
<p>That mixed ownership is the main blocker to introducing the first real rail.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>Railiance will treat <code>rail-kubernetes</code> as the wave-1 base rail.</p>
|
||||||
|
<p>The boundary is:</p>
|
||||||
|
<ul><li><code>railiance-cluster</code> owns the Kubernetes substrate and its prerequisites</li><li><code>rail-kubernetes</code> owns the generic workload-on-Kubernetes execution contract</li></ul>
|
||||||
|
<p>Workload-specific helper flows currently living in <code>railiance-cluster</code> are temporary exceptions and must be rehomed rather than carried forward as part of the generic rail.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<h3>Positive</h3>
|
||||||
|
<ul><li>The first real rail gains a concrete ownership boundary.</li><li><code>railiance-cluster</code> can return to a clean S2 substrate identity.</li><li>Future rails such as <code>rail-knative</code> get a stable base boundary to extend from.</li><li><code>rapp-*</code> repos gain a clearer execution-contract home for Kubernetes-managed workloads.</li></ul>
|
||||||
|
<h3>Required Follow-On Work</h3>
|
||||||
|
<ul><li>Create the detailed <code>rail-kubernetes</code> boundary contract and migration map.</li><li>Split generic lifecycle docs, schema, examples, and Stage 1-3 tooling out of <code>railiance-cluster</code>.</li><li>Leave a compatibility path so current users of the cluster repo are not broken during the migration.</li><li>Rehome workload-specific helpers that do not belong in either boundary.</li></ul>
|
||||||
|
<h3>Constraints</h3>
|
||||||
|
<ul><li><code>rail-kubernetes</code> must not take ownership of cluster bootstrap, operators, or kubeconfig management.</li><li><code>railiance-cluster</code> must not continue as the owner of generic workload promotion semantics after the split.</li><li><code>rail-knative</code> should follow this cleanup, not bypass it.</li></ul>
|
||||||
|
</section>
|
||||||
|
<section id="notes"><h2>Notes</h2>
|
||||||
|
<p>This ADR does not require all current files to move immediately.</p>
|
||||||
|
<p>It requires the ownership line to be explicit now, so practical repo separation can proceed without ambiguity.</p>
|
||||||
|
</section><footer><span>RMASTER-ADR-0002 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
210
build/adr/railiance-rapp-declaration-contract/v1/index.html
Normal file
210
build/adr/railiance-rapp-declaration-contract/v1/index.html
Normal file
|
|
@ -0,0 +1,210 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="263431f88ba04d6ab9ab3b6c0d6a2bb08634bfe83dc0719350f0855d399c18b2">
|
||||||
|
<title>Rapp Declaration Contract</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0007</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-08-13</span><span>generated from canonical source — do not edit</span></div><h1>Rapp Declaration Contract</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0007-rapp-declaration-contract.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-02-13</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li></ol></nav><main><p>Date: 2026-08-13 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p><code>RMASTER-WP-0017</code> through <code>RMASTER-WP-0019</code> established the four-axis model and materialized the first family repos. The model held up. Its enforcement did not.</p>
|
||||||
|
<p>A 2026-08-11 survey by <code>railiance-platform</code> found that the three live <code>rapp.yaml</code> files were mutually unreadable: rollout, smoke, and rollback contracts used different shapes; metadata that both rails carry consistently appeared in only one rapp; <code>reef-railiance</code> <code>bound_rapps</code> listed <code>rapp-qonto</code> only, while <code>rapp-openbao</code> and <code>rapp-postgres</code> were already live on the same reef. <code>docs/repo-family-bootstrap-contract.md</code> named fields in prose and could not catch any of this.</p>
|
||||||
|
<p>The same survey treated rapp grouping as something that might be derived from Forgejo organizations or from State Hub domains. Neither works. A repo lives in exactly one Forgejo org, so <code>org:repo</code> is one-to-many. A repo may legitimately contribute to more than one rapp, so <code>rapp:repo</code> is many-to-many. A many-to-many grouping cannot be derived from a one-to-many one. Domains fail in both directions. The three dimensions also change at different speeds.</p>
|
||||||
|
<p>Canon OAS P1 requires independent perspectives to be separate orthogonal dimensions. Decision <code>d07ee5f9</code> already recorded this from the <code>railiance-platform</code> side; this ADR is the framework record.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<ol><li><strong>Bounded rapp context is its own dimension.</strong> It is derived neither from Forgejo organizations nor from State Hub domains. Grouping is a first-class declaration, not a projection of some other axis.</li></ol>
|
||||||
|
<ol><li><strong>Two cardinalities stay distinct.</strong> Repos to rapps is many-to-many: a repo may appear in the <code>composition.member_repos</code> of more than one rapp. Deployables to rapps is one-to-one: every running deployable has exactly one rapp that owns its rollout. The coverage question — <em>does every live deployable belong to exactly one rapp?</em> — is well-formed only if these stay distinct.</li></ol>
|
||||||
|
<ol><li><strong>Granularity is grouped-by-bounded-context.</strong> One rapp per cohesive group that deploys, versions, and rolls back together, not one rapp per deployable. Grouping is legitimate only where members share rollout and rollback fate. A single-repo rapp is the one-member case of the same <code>composition</code> block, not a second shape.</li></ol>
|
||||||
|
<ol><li><strong>The schema is normative.</strong> <code>schemas/rapp.schema.json</code>, <code>schemas/rail.schema.json</code>, and <code>schemas/reef.schema.json</code> define the shapes. Framework prose cites those files. It does not restate their fields. Reef <code>bound_rapps</code> is a derived projection of <code>rapp.bound_reefs</code>, not a hand-maintained registry.</li></ol>
|
||||||
|
<p>The detailed shapes, including the single normative form of the rollout, smoke, and rollback contracts, live in the schema files and <code>schemas/README.md</code>.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<ul><li>Drift across family declarations fails in <code>tools/validate-family-declarations.py</code> instead of accumulating in prose.</li><li><code>railiance-platform</code> <code>RAILIANCE-WP-0015-T02</code> can converge <code>rapp-openbao</code> and <code>rapp-postgres</code> onto one shape. Migration belongs to the owning repos; this ADR does not move any declaration.</li><li><code>reef-railiance</code> must stop treating <code>bound_rapps: [rapp-qonto]</code> as source of truth. The list is already stale.</li><li>Three further <code>rapp-*</code> repos (<code>rapp-secrets-engine</code>, <code>rapp-tenant-engine</code>, <code>rapp-user-engine</code>) carry the family prefix and no declaration. They are visible to the validator as undeclared and must be declared, renamed, or retired by their owners.</li><li>Calling the validator from <code>fix-consistency</code> still waits on <code>the-custodian</code> admitting the family prefixes into the classification standard. That sequencing is not this repo's.</li></ul>
|
||||||
|
</section><footer><span>RMASTER-ADR-0007 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0007-rapp-declaration-contract.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
|
|
@ -0,0 +1,210 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="263431f88ba04d6ab9ab3b6c0d6a2bb08634bfe83dc0719350f0855d399c18b2">
|
||||||
|
<title>Rapp Declaration Contract</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0007</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-08-13</span><span>generated from canonical source — do not edit</span></div><h1>Rapp Declaration Contract</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0007-rapp-declaration-contract.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-02-13</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li></ol></nav><main><p>Date: 2026-08-13 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p><code>RMASTER-WP-0017</code> through <code>RMASTER-WP-0019</code> established the four-axis model and materialized the first family repos. The model held up. Its enforcement did not.</p>
|
||||||
|
<p>A 2026-08-11 survey by <code>railiance-platform</code> found that the three live <code>rapp.yaml</code> files were mutually unreadable: rollout, smoke, and rollback contracts used different shapes; metadata that both rails carry consistently appeared in only one rapp; <code>reef-railiance</code> <code>bound_rapps</code> listed <code>rapp-qonto</code> only, while <code>rapp-openbao</code> and <code>rapp-postgres</code> were already live on the same reef. <code>docs/repo-family-bootstrap-contract.md</code> named fields in prose and could not catch any of this.</p>
|
||||||
|
<p>The same survey treated rapp grouping as something that might be derived from Forgejo organizations or from State Hub domains. Neither works. A repo lives in exactly one Forgejo org, so <code>org:repo</code> is one-to-many. A repo may legitimately contribute to more than one rapp, so <code>rapp:repo</code> is many-to-many. A many-to-many grouping cannot be derived from a one-to-many one. Domains fail in both directions. The three dimensions also change at different speeds.</p>
|
||||||
|
<p>Canon OAS P1 requires independent perspectives to be separate orthogonal dimensions. Decision <code>d07ee5f9</code> already recorded this from the <code>railiance-platform</code> side; this ADR is the framework record.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<ol><li><strong>Bounded rapp context is its own dimension.</strong> It is derived neither from Forgejo organizations nor from State Hub domains. Grouping is a first-class declaration, not a projection of some other axis.</li></ol>
|
||||||
|
<ol><li><strong>Two cardinalities stay distinct.</strong> Repos to rapps is many-to-many: a repo may appear in the <code>composition.member_repos</code> of more than one rapp. Deployables to rapps is one-to-one: every running deployable has exactly one rapp that owns its rollout. The coverage question — <em>does every live deployable belong to exactly one rapp?</em> — is well-formed only if these stay distinct.</li></ol>
|
||||||
|
<ol><li><strong>Granularity is grouped-by-bounded-context.</strong> One rapp per cohesive group that deploys, versions, and rolls back together, not one rapp per deployable. Grouping is legitimate only where members share rollout and rollback fate. A single-repo rapp is the one-member case of the same <code>composition</code> block, not a second shape.</li></ol>
|
||||||
|
<ol><li><strong>The schema is normative.</strong> <code>schemas/rapp.schema.json</code>, <code>schemas/rail.schema.json</code>, and <code>schemas/reef.schema.json</code> define the shapes. Framework prose cites those files. It does not restate their fields. Reef <code>bound_rapps</code> is a derived projection of <code>rapp.bound_reefs</code>, not a hand-maintained registry.</li></ol>
|
||||||
|
<p>The detailed shapes, including the single normative form of the rollout, smoke, and rollback contracts, live in the schema files and <code>schemas/README.md</code>.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<ul><li>Drift across family declarations fails in <code>tools/validate-family-declarations.py</code> instead of accumulating in prose.</li><li><code>railiance-platform</code> <code>RAILIANCE-WP-0015-T02</code> can converge <code>rapp-openbao</code> and <code>rapp-postgres</code> onto one shape. Migration belongs to the owning repos; this ADR does not move any declaration.</li><li><code>reef-railiance</code> must stop treating <code>bound_rapps: [rapp-qonto]</code> as source of truth. The list is already stale.</li><li>Three further <code>rapp-*</code> repos (<code>rapp-secrets-engine</code>, <code>rapp-tenant-engine</code>, <code>rapp-user-engine</code>) carry the family prefix and no declaration. They are visible to the validator as undeclared and must be declared, renamed, or retired by their owners.</li><li>Calling the validator from <code>fix-consistency</code> still waits on <code>the-custodian</code> admitting the family prefixes into the classification standard. That sequencing is not this repo's.</li></ul>
|
||||||
|
</section><footer><span>RMASTER-ADR-0007 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0007-rapp-declaration-contract.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
216
build/adr/railiance-rapp-first-wave-selection/v1/index.html
Normal file
216
build/adr/railiance-rapp-first-wave-selection/v1/index.html
Normal file
|
|
@ -0,0 +1,216 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="28135e94758b6935518d2e83458c1e607deeabb341879b605eef6529b3168cbc">
|
||||||
|
<title>First-Wave rapp Selection</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0003</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-07-25</span><span>generated from canonical source — do not edit</span></div><h1>First-Wave rapp Selection</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0003-rapp-first-wave-selection.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-01-25</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li><li><a href="#notes"><span class="n">·</span>Notes</a></li></ol></nav><main><p>Date: 2026-07-25 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Railiance wants <code>rapp-*</code> repos to represent managed workload packages rather than new ownership layers.</p>
|
||||||
|
<p>The current workload surfaces already suggest several candidates:</p>
|
||||||
|
<ul><li>OpenBao in <code>railiance-platform</code></li><li>the forge workload in <code>railiance-forge</code></li><li>multiple S5 workloads in <code>railiance-apps</code></li></ul>
|
||||||
|
<p>But they are not equally ready for first extraction.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>The first-wave <code>rapp-*</code> order is:</p>
|
||||||
|
<ol><li><code>rapp-openbao</code></li><li><code>rapp-vergabe-teilnahme</code></li><li>later <code>rapp-forgejo</code> after the forge runtime target stabilizes</li></ol>
|
||||||
|
<p>The forge workload is explicitly deferred from the first wave because current Gitea operation and future Forgejo direction are both active realities.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<h3>Positive</h3>
|
||||||
|
<ul><li>The first <code>rapp-*</code> extraction proves the third-party platform-service wrapper model.</li><li>The second proves the user-facing self-built app wrapper model.</li><li>The deferred forge wrapper avoids immediate rename churn and packaging ambiguity.</li></ul>
|
||||||
|
<h3>Required Follow-On Work</h3>
|
||||||
|
<ul><li>Write repo-local extraction work for <code>rapp-openbao</code>.</li><li>Write repo-local extraction work for <code>rapp-vergabe-teilnahme</code>.</li><li>Reassess the forge wrapper when the production package target is no longer split between current Gitea and future Forgejo.</li></ul>
|
||||||
|
<h3>Constraints</h3>
|
||||||
|
<ul><li><code>rapp-*</code> repos must stay packaging-focused and must not become shadow ownership repos.</li><li>Shared S3 policy stays in <code>railiance-platform</code>.</li><li>Shared S5 release patterns stay in <code>railiance-apps</code>.</li></ul>
|
||||||
|
</section>
|
||||||
|
<section id="notes"><h2>Notes</h2>
|
||||||
|
<p>This ADR chooses sequence, not a mandatory destination for every workload in the ecosystem.</p>
|
||||||
|
</section><footer><span>RMASTER-ADR-0003 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0003-rapp-first-wave-selection.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
|
|
@ -0,0 +1,216 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="28135e94758b6935518d2e83458c1e607deeabb341879b605eef6529b3168cbc">
|
||||||
|
<title>First-Wave rapp Selection</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0003</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-07-25</span><span>generated from canonical source — do not edit</span></div><h1>First-Wave rapp Selection</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0003-rapp-first-wave-selection.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-01-25</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li><li><a href="#notes"><span class="n">·</span>Notes</a></li></ol></nav><main><p>Date: 2026-07-25 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Railiance wants <code>rapp-*</code> repos to represent managed workload packages rather than new ownership layers.</p>
|
||||||
|
<p>The current workload surfaces already suggest several candidates:</p>
|
||||||
|
<ul><li>OpenBao in <code>railiance-platform</code></li><li>the forge workload in <code>railiance-forge</code></li><li>multiple S5 workloads in <code>railiance-apps</code></li></ul>
|
||||||
|
<p>But they are not equally ready for first extraction.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>The first-wave <code>rapp-*</code> order is:</p>
|
||||||
|
<ol><li><code>rapp-openbao</code></li><li><code>rapp-vergabe-teilnahme</code></li><li>later <code>rapp-forgejo</code> after the forge runtime target stabilizes</li></ol>
|
||||||
|
<p>The forge workload is explicitly deferred from the first wave because current Gitea operation and future Forgejo direction are both active realities.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<h3>Positive</h3>
|
||||||
|
<ul><li>The first <code>rapp-*</code> extraction proves the third-party platform-service wrapper model.</li><li>The second proves the user-facing self-built app wrapper model.</li><li>The deferred forge wrapper avoids immediate rename churn and packaging ambiguity.</li></ul>
|
||||||
|
<h3>Required Follow-On Work</h3>
|
||||||
|
<ul><li>Write repo-local extraction work for <code>rapp-openbao</code>.</li><li>Write repo-local extraction work for <code>rapp-vergabe-teilnahme</code>.</li><li>Reassess the forge wrapper when the production package target is no longer split between current Gitea and future Forgejo.</li></ul>
|
||||||
|
<h3>Constraints</h3>
|
||||||
|
<ul><li><code>rapp-*</code> repos must stay packaging-focused and must not become shadow ownership repos.</li><li>Shared S3 policy stays in <code>railiance-platform</code>.</li><li>Shared S5 release patterns stay in <code>railiance-apps</code>.</li></ul>
|
||||||
|
</section>
|
||||||
|
<section id="notes"><h2>Notes</h2>
|
||||||
|
<p>This ADR chooses sequence, not a mandatory destination for every workload in the ecosystem.</p>
|
||||||
|
</section><footer><span>RMASTER-ADR-0003 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0003-rapp-first-wave-selection.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
206
build/adr/railiance-reef-production-admission/v1/index.html
Normal file
206
build/adr/railiance-reef-production-admission/v1/index.html
Normal file
|
|
@ -0,0 +1,206 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="d9fbd9d21d86e461334abc24060c39127f2158ba25317b3d3dc326c4f7eaf08c">
|
||||||
|
<title>Reef Production Admission</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0006</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-08-15</span><span>generated from canonical source — do not edit</span></div><h1>Reef Production Admission</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0006-reef-production-admission.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-02-15</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li></ol></nav><main><p>Date: 2026-07-26 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Fabric topology can say that a reef hosts a rail or binds a workload, but that does not demonstrate capacity, isolation, recoverability, or approval for a critical internet-facing service.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>Rail and <code>rapp</code> bindings use explicit readiness states: <code>declared</code>, <code>installed</code>, <code>verified</code>, <code>production-approved</code>, and <code>deprecated</code>.</p>
|
||||||
|
<p>Critical workloads require machine-readable conformance evidence plus explicit acceptance of residual risks that cannot be automated. Mixed-rail reefs use defined split triggers.</p>
|
||||||
|
<p>The detailed contract is <a href="../reef-production-readiness-contract.md"><code>docs/reef-production-readiness-contract.md</code></a>.</p>
|
||||||
|
<p>Who may reach a listener is a different axis: <a href="ADR-0008-private-by-default-exposure.md"><code>ADR-0008</code></a>. Production admission does not imply a public surface. A public surface requires this admission <strong>and</strong> an exposure grant.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<ul><li><code>hosts_rail</code> and <code>binds_rapp</code> no longer imply deployability.</li><li><code>reef-railiance</code> may host Knative in wave 2, but Qonto cannot be called production-approved solely from that declaration.</li><li>Repeated evidence collection should become functional automation.</li><li><code>production-approved</code> is not permission to publish a listener. See ADR-0008.</li></ul>
|
||||||
|
</section><footer><span>RMASTER-ADR-0006 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0006-reef-production-admission.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
|
|
@ -0,0 +1,206 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="d9fbd9d21d86e461334abc24060c39127f2158ba25317b3d3dc326c4f7eaf08c">
|
||||||
|
<title>Reef Production Admission</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0006</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-08-15</span><span>generated from canonical source — do not edit</span></div><h1>Reef Production Admission</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0006-reef-production-admission.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-02-15</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li></ol></nav><main><p>Date: 2026-07-26 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Fabric topology can say that a reef hosts a rail or binds a workload, but that does not demonstrate capacity, isolation, recoverability, or approval for a critical internet-facing service.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>Rail and <code>rapp</code> bindings use explicit readiness states: <code>declared</code>, <code>installed</code>, <code>verified</code>, <code>production-approved</code>, and <code>deprecated</code>.</p>
|
||||||
|
<p>Critical workloads require machine-readable conformance evidence plus explicit acceptance of residual risks that cannot be automated. Mixed-rail reefs use defined split triggers.</p>
|
||||||
|
<p>The detailed contract is <a href="../reef-production-readiness-contract.md"><code>docs/reef-production-readiness-contract.md</code></a>.</p>
|
||||||
|
<p>Who may reach a listener is a different axis: <a href="ADR-0008-private-by-default-exposure.md"><code>ADR-0008</code></a>. Production admission does not imply a public surface. A public surface requires this admission <strong>and</strong> an exposure grant.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<ul><li><code>hosts_rail</code> and <code>binds_rapp</code> no longer imply deployability.</li><li><code>reef-railiance</code> may host Knative in wave 2, but Qonto cannot be called production-approved solely from that declaration.</li><li>Repeated evidence collection should become functional automation.</li><li><code>production-approved</code> is not permission to publish a listener. See ADR-0008.</li></ul>
|
||||||
|
</section><footer><span>RMASTER-ADR-0006 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0006-reef-production-admission.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
235
build/adr/railiance-repository-prefix/v1/index.html
Normal file
235
build/adr/railiance-repository-prefix/v1/index.html
Normal file
|
|
@ -0,0 +1,235 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="b9c993ded8d79d6f871dba9cf08a320b2d619609a448ad3d02b632f5b6f76497">
|
||||||
|
<title>Repository Prefix Architecture</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0001</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-07-25</span><span>generated from canonical source — do not edit</span></div><h1>Repository Prefix Architecture</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0001-repository-prefix-architecture.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-01-25</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#meaning-of-each-family"><span class="n">·</span>Meaning Of Each Family</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li><li><a href="#current-interpretation-for-existing-repos"><span class="n">·</span>Current Interpretation For Existing Repos</a></li><li><a href="#notes"><span class="n">·</span>Notes</a></li></ol></nav><main><p>Date: 2026-07-25 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Railiance already has a meaningful set of ownership repos such as <code>railiance-infra</code>, <code>railiance-cluster</code>, <code>railiance-platform</code>, <code>railiance-enablement</code>, <code>railiance-apps</code>, <code>railiance-forge</code>, and <code>railiance-fabric</code>.</p>
|
||||||
|
<p>That structure is useful, but it does not by itself capture all of the dimensions Railiance now needs.</p>
|
||||||
|
<p>In particular, the architecture needs clear source-controlled homes for:</p>
|
||||||
|
<ul><li>workload execution contracts across different operations architectures,</li><li>managed workload packages as first-class repos,</li><li>and concrete substrate boundaries such as named servers, workstations, or grouped environments.</li></ul>
|
||||||
|
<p>Without that separation, Kubernetes-specific workload semantics remain mixed into <code>railiance-cluster</code>, workload wrappers remain mixed into ownership repos, and concrete substrates remain under-described.</p>
|
||||||
|
<p>Railiance also operates inside a wider ecosystem around Railiance, Net Kingdom, and the Helix Forge software factory. That wider context needs architecture that can support both exploratory operation and production-grade evolution without leaving key responsibilities ambiguous.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>Railiance adopts four canonical repository families:</p>
|
||||||
|
<ol><li><code>railiance-*</code> for ownership and responsibility areas</li><li><code>rail-*</code> for workload execution contracts</li><li><code>rapp-*</code> for Railiance-managed workload packages</li><li><code>reef-*</code> for durable substrate boundaries</li></ol>
|
||||||
|
<p>The current implementation wave is explicitly centered on <code>rail-kubernetes</code> as the default base rail. Additional rails are introduced only when a concrete workload has a sound reason to run on a distinct execution architecture.</p>
|
||||||
|
<p><code>rail-knative</code> is the first expected follow-on rail, motivated by the need to support <code>qonto-assistent</code>, but it should follow the <code>rail-kubernetes</code> boundary cleanup rather than bypass it.</p>
|
||||||
|
</section>
|
||||||
|
<section id="meaning-of-each-family"><h2>Meaning Of Each Family</h2>
|
||||||
|
<h3><code>railiance-*</code></h3>
|
||||||
|
<p>Owns major architectural responsibilities, shared policies, and durable layer boundaries.</p>
|
||||||
|
<h3><code>rail-*</code></h3>
|
||||||
|
<p>Owns how workloads run on a specific execution architecture such as Kubernetes, Knative, KEDA, Fission, or Nuclio.</p>
|
||||||
|
<p>In the current phase, <code>rail-kubernetes</code> is the default path for platform services and managed applications.</p>
|
||||||
|
<h3><code>rapp-*</code></h3>
|
||||||
|
<p>Owns the managed workload package for one service or application, whether it is an internal workload or a wrapped upstream product.</p>
|
||||||
|
<p>Its role is to provide the managed wrapper and scaffolding needed to run that workload in the Railiance and Net Kingdom context. It does not replace responsibility ownership.</p>
|
||||||
|
<h3><code>reef-*</code></h3>
|
||||||
|
<p>Owns the concrete substrate reality where rails and <code>rapp</code>s are bound, such as a named server, cluster, workstation, or grouped substrate class.</p>
|
||||||
|
<p>A reef is about purpose-bound compute resources, not merely about individual machines.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<h3>Positive</h3>
|
||||||
|
<ul><li>Ownership, execution, workload identity, and substrate identity become separate concerns.</li><li>Railiance can support multiple execution architectures without forcing all workload semantics into <code>railiance-cluster</code>.</li><li>Platform services and applications can both become first-class managed workload packages where appropriate.</li><li>Concrete substrates gain a clear architectural home without overloading the ownership repos.</li><li>The framework gains a disciplined default path for introducing new rails instead of proliferating them speculatively.</li></ul>
|
||||||
|
<h3>Required Follow-On Work</h3>
|
||||||
|
<ul><li>Define the initial <code>rail-*</code> contracts, starting with <code>rail-kubernetes</code>.</li><li>Evolve the current <code>railiance/app.toml</code> and overlay pattern into a rail-aware, eventually rail-neutral workload packaging contract.</li><li>Identify which current workloads should become <code>rapp-*</code> repos.</li><li>Extend <code>railiance-fabric</code> so rails, <code>rapp</code>s, and reefs become graph-native.</li><li>Define when mixed-rail reefs are acceptable and when clearer substrate separation should be preferred.</li></ul>
|
||||||
|
<h3>Constraints</h3>
|
||||||
|
<ul><li><code>reef-*</code> must not become a default one-repo-per-machine pattern.</li><li>Generic logic stays in the appropriate ownership repo.</li><li>A named machine gets its own reef only when that machine is itself a durable substrate boundary.</li><li><code>rapp-*</code> repos must not become shadow ownership repos.</li><li>Transitional substrate labels should not be canonized before the pattern is operationally stable.</li></ul>
|
||||||
|
</section>
|
||||||
|
<section id="current-interpretation-for-existing-repos"><h2>Current Interpretation For Existing Repos</h2>
|
||||||
|
<ul><li><code>railiance-*</code> repos remain the primary ownership axis.</li><li>Current workload-execution logic in <code>railiance-cluster</code> is a candidate to migrate into <code>rail-kubernetes</code>.</li><li>Current workload wrappers inside <code>railiance-apps</code>, <code>railiance-platform</code>, or <code>railiance-forge</code> may evolve into <code>rapp-*</code> repos over time.</li><li>Current named substrates such as COULOMBCORE, RAILIANCE01, and WORKSTATION may justify <code>reef-*</code> repos when they represent real operational boundaries.</li><li>A reef may host more than one rail in early or mixed environments, but production-critical substrates should prefer clearer purpose and primary-rail boundaries unless a mixed design is justified.</li></ul>
|
||||||
|
</section>
|
||||||
|
<section id="notes"><h2>Notes</h2>
|
||||||
|
<p>This ADR defines the repository taxonomy. It does not yet mandate a full migration or rename of existing repos. Migration should happen when it produces clearer ownership and lower ambiguity, not merely for naming purity.</p>
|
||||||
|
</section><footer><span>RMASTER-ADR-0001 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0001-repository-prefix-architecture.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
|
|
@ -0,0 +1,235 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en"><meta charset="utf-8">
|
||||||
|
<meta name="policy-source-revision" content="debbc13b4018f20db0997516b99afc1cc21084d7">
|
||||||
|
<meta name="policy-source-digest" content="b9c993ded8d79d6f871dba9cf08a320b2d619609a448ad3d02b632f5b6f76497">
|
||||||
|
<title>Repository Prefix Architecture</title>
|
||||||
|
<style>
|
||||||
|
:root{
|
||||||
|
--paper:#EDEEF0; --surface:#F6F7F8; --surface-2:#E4E6E9;
|
||||||
|
--ink:#171D24; --ink-2:#4A5561; --ink-3:#737E8A;
|
||||||
|
--rule:#D3D7DC; --rule-strong:#B6BCC3;
|
||||||
|
--brass:#8A6A2E; --brass-soft:#EFE5CD; --brass-line:#C9AE74;
|
||||||
|
--clay:#8A3A2C; --clay-soft:#F2DFDA;
|
||||||
|
--l0:#DCE0E2; --l1:#B9C4C7; --l2:#8CA1A6; --l3:#567D84; --l4:#23555E;
|
||||||
|
--chip-fg:#F6F7F8;
|
||||||
|
--font-display:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",sans-serif;
|
||||||
|
--font-body:"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;
|
||||||
|
--font-mono:ui-monospace,"SF Mono","Cascadia Code",Menlo,Consolas,monospace;
|
||||||
|
--measure:66ch;
|
||||||
|
}
|
||||||
|
@media (prefers-color-scheme:dark){
|
||||||
|
:root:not([data-theme="light"]){
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
:root[data-theme="dark"]{
|
||||||
|
--paper:#12161A; --surface:#191E24; --surface-2:#222831;
|
||||||
|
--ink:#E6E9EC; --ink-2:#A3ADB7; --ink-3:#78838E;
|
||||||
|
--rule:#2A3138; --rule-strong:#3B444D;
|
||||||
|
--brass:#C9A45C; --brass-soft:#33290F; --brass-line:#6B5426;
|
||||||
|
--clay:#D08A76; --clay-soft:#3A211B;
|
||||||
|
--l0:#262C32; --l1:#35424A; --l2:#4A626B; --l3:#6A939D; --l4:#97C4CD;
|
||||||
|
--chip-fg:#12161A;
|
||||||
|
}
|
||||||
|
|
||||||
|
*{box-sizing:border-box}
|
||||||
|
body{
|
||||||
|
margin:0; background:var(--paper); color:var(--ink);
|
||||||
|
font-family:var(--font-body); font-size:17px; line-height:1.62;
|
||||||
|
-webkit-font-smoothing:antialiased;
|
||||||
|
}
|
||||||
|
.wrap{max-width:1180px;margin:0 auto;padding:0 24px 96px}
|
||||||
|
.layout{display:grid;grid-template-columns:180px minmax(0,1fr);gap:56px;align-items:start}
|
||||||
|
@media (max-width:960px){.layout{grid-template-columns:1fr;gap:0}.rail{display:none}}
|
||||||
|
|
||||||
|
/* ---------- rail ---------- */
|
||||||
|
.rail{position:sticky;top:28px;padding-top:8px;font-family:var(--font-display);font-size:12px;line-height:1.5}
|
||||||
|
.rail ol{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px}
|
||||||
|
.rail a{color:var(--ink-3);text-decoration:none;display:flex;gap:9px}
|
||||||
|
.rail a:hover,.rail a:focus-visible{color:var(--brass)}
|
||||||
|
.rail .n{font-family:var(--font-mono);font-size:10px;color:var(--rule-strong);min-width:16px;padding-top:1px}
|
||||||
|
.rail .grp{margin-top:14px;font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--rule-strong)}
|
||||||
|
|
||||||
|
/* ---------- header ---------- */
|
||||||
|
header{padding:64px 0 40px;border-bottom:2px solid var(--ink);margin-bottom:44px}
|
||||||
|
.eyebrow{font-family:var(--font-mono);font-size:11.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);display:flex;flex-wrap:wrap;gap:14px;margin-bottom:22px}
|
||||||
|
.eyebrow .stat{color:var(--clay)}
|
||||||
|
h1{font-family:var(--font-display);font-weight:800;letter-spacing:-.035em;line-height:.94;font-size:clamp(46px,9vw,92px);margin:0 0 6px;text-wrap:balance}
|
||||||
|
.sub{font-family:var(--font-display);font-weight:500;font-size:clamp(16px,2.4vw,21px);letter-spacing:-.01em;color:var(--ink-2);margin:0 0 30px;max-width:34ch;line-height:1.3}
|
||||||
|
.metagrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:20px 28px;border-top:1px solid var(--rule);padding-top:20px}
|
||||||
|
.metagrid dt{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);margin-bottom:5px}
|
||||||
|
.metagrid dd{margin:0;font-family:var(--font-display);font-size:13.5px;line-height:1.45;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- typography ---------- */
|
||||||
|
section{margin-bottom:60px;scroll-margin-top:24px}
|
||||||
|
h2{font-family:var(--font-display);font-weight:750;letter-spacing:-.022em;font-size:clamp(24px,3.4vw,31px);line-height:1.12;margin:0 0 18px;text-wrap:balance;display:flex;gap:14px;align-items:baseline}
|
||||||
|
h2 .sn{font-family:var(--font-mono);font-size:12px;font-weight:400;color:var(--brass);letter-spacing:.06em;flex:none;padding-top:2px}
|
||||||
|
h3{font-family:var(--font-display);font-weight:700;font-size:16px;letter-spacing:-.008em;margin:34px 0 10px;color:var(--ink)}
|
||||||
|
p{margin:0 0 15px;max-width:var(--measure)}
|
||||||
|
ul,ol{max-width:var(--measure);margin:0 0 15px;padding-left:20px}
|
||||||
|
li{margin-bottom:7px}
|
||||||
|
strong{font-weight:600}
|
||||||
|
em{font-style:italic}
|
||||||
|
code{font-family:var(--font-mono);font-size:.855em;background:var(--surface-2);padding:1px 5px;border-radius:2px}
|
||||||
|
a{color:var(--brass)}
|
||||||
|
.lede{font-size:19px;line-height:1.55;color:var(--ink-2);max-width:60ch}
|
||||||
|
|
||||||
|
/* ---------- devices ---------- */
|
||||||
|
.callout{border-left:3px solid var(--brass);background:var(--brass-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.callout p:last-child{margin-bottom:0}
|
||||||
|
.callout .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
.rule-quote{border-top:2px solid var(--ink);border-bottom:2px solid var(--ink);padding:26px 0;margin:28px 0;max-width:var(--measure)}
|
||||||
|
.rule-quote p{font-family:var(--font-display);font-weight:600;font-size:19px;line-height:1.38;letter-spacing:-.014em;margin:0;text-wrap:balance}
|
||||||
|
.hard{border-left:3px solid var(--clay);background:var(--clay-soft);padding:18px 22px;margin:0 0 24px;max-width:var(--measure)}
|
||||||
|
.hard .lbl{font-family:var(--font-mono);font-size:10px;letter-spacing:.13em;text-transform:uppercase;color:var(--clay);display:block;margin-bottom:8px}
|
||||||
|
.hard p:last-child{margin-bottom:0}
|
||||||
|
.dec{font-family:var(--font-mono);font-size:10.5px;letter-spacing:.08em;color:var(--brass);text-transform:uppercase}
|
||||||
|
.vec{font-family:var(--font-mono);font-size:.9em;font-weight:600;background:var(--surface-2);padding:2px 7px;border-radius:2px;white-space:nowrap;letter-spacing:.04em}
|
||||||
|
|
||||||
|
/* ---------- tables ---------- */
|
||||||
|
.scroll{overflow-x:auto;margin:0 0 24px;-webkit-overflow-scrolling:touch}
|
||||||
|
table{border-collapse:collapse;width:100%;min-width:520px;font-family:var(--font-display);font-size:13.5px;line-height:1.45}
|
||||||
|
th{text-align:left;font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;text-transform:uppercase;color:var(--ink-3);font-weight:400;padding:0 16px 8px 0;border-bottom:1px solid var(--rule-strong);vertical-align:bottom}
|
||||||
|
td{padding:11px 16px 11px 0;border-bottom:1px solid var(--rule);vertical-align:top;color:var(--ink-2)}
|
||||||
|
td:first-child{color:var(--ink);font-weight:600}
|
||||||
|
tbody tr:last-child td{border-bottom:none}
|
||||||
|
.lvl{font-family:var(--font-mono);font-weight:600;font-size:12px;letter-spacing:.04em;color:var(--ink)}
|
||||||
|
|
||||||
|
/* ---------- ladders ---------- */
|
||||||
|
.breakout{margin:34px 0 40px}
|
||||||
|
.bhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px;border-bottom:1px solid var(--rule-strong);padding-bottom:9px;margin-bottom:22px;flex-wrap:wrap}
|
||||||
|
.bhead h3{margin:0;font-size:13px;letter-spacing:.1em;text-transform:uppercase;font-family:var(--font-mono);font-weight:400;color:var(--ink-3)}
|
||||||
|
.bhead .note{font-family:var(--font-display);font-size:12.5px;color:var(--ink-3)}
|
||||||
|
.ladders{display:grid;gap:26px}
|
||||||
|
.ladder{display:grid;grid-template-columns:126px minmax(0,1fr);gap:18px;align-items:start}
|
||||||
|
@media (max-width:700px){.ladder{grid-template-columns:1fr;gap:10px}}
|
||||||
|
.ladder .pname{font-family:var(--font-display);font-weight:700;font-size:14px;letter-spacing:-.01em;padding-top:2px}
|
||||||
|
.ladder .pname span{display:block;font-family:var(--font-mono);font-size:10px;font-weight:400;letter-spacing:.1em;text-transform:uppercase;color:var(--ink-3);margin-top:3px}
|
||||||
|
.rungs{display:grid;gap:3px;grid-template-columns:repeat(5,minmax(0,1fr))}
|
||||||
|
@media (max-width:700px){.rungs{grid-template-columns:repeat(2,minmax(0,1fr))}}
|
||||||
|
.rung{padding:9px 10px 11px;background:var(--surface);border-top:4px solid var(--l0);min-width:0}
|
||||||
|
.rung.r1{border-top-color:var(--l1)} .rung.r2{border-top-color:var(--l2)}
|
||||||
|
.rung.r3{border-top-color:var(--l3)} .rung.r4{border-top-color:var(--l4)}
|
||||||
|
.rung .code{font-family:var(--font-mono);font-size:11px;font-weight:600;letter-spacing:.06em;color:var(--ink);display:block;margin-bottom:4px}
|
||||||
|
.rung .txt{font-family:var(--font-display);font-size:11.5px;line-height:1.34;color:var(--ink-2);display:block}
|
||||||
|
.rung.na{opacity:.42}
|
||||||
|
|
||||||
|
/* ---------- matrix ---------- */
|
||||||
|
.matrix-shell{display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:stretch;margin-bottom:14px}
|
||||||
|
.ylab{writing-mode:vertical-rl;transform:rotate(180deg);font-family:var(--font-mono);font-size:9.5px;letter-spacing:.14em;text-transform:uppercase;color:var(--ink-3);text-align:center;padding-bottom:22px}
|
||||||
|
.mgrid{display:grid;grid-template-columns:34px repeat(5,minmax(0,1fr));gap:3px}
|
||||||
|
.mcell{background:var(--surface);min-height:60px;padding:6px;display:flex;flex-direction:column;justify-content:flex-end;gap:4px;min-width:0}
|
||||||
|
.mcell.tint1{background:color-mix(in srgb,var(--l1) 26%,var(--surface))}
|
||||||
|
.mcell.tint2{background:color-mix(in srgb,var(--l2) 26%,var(--surface))}
|
||||||
|
.mcell.tint3{background:color-mix(in srgb,var(--l3) 24%,var(--surface))}
|
||||||
|
.mcell.tint4{background:color-mix(in srgb,var(--l4) 22%,var(--surface))}
|
||||||
|
.mcell.void{background:repeating-linear-gradient(135deg,transparent,transparent 5px,var(--rule) 5px,var(--rule) 6px);opacity:.55}
|
||||||
|
.rlab,.clab{font-family:var(--font-mono);font-size:10px;font-weight:600;letter-spacing:.05em;color:var(--ink-3);display:flex;align-items:center;justify-content:center}
|
||||||
|
.rlab{min-height:60px}
|
||||||
|
.clab{padding-top:7px;min-height:22px}
|
||||||
|
.pin{font-family:var(--font-mono);font-size:9.5px;font-weight:600;letter-spacing:.02em;background:var(--ink);color:var(--paper);padding:2px 5px;border-radius:2px;line-height:1.3;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
|
||||||
|
.pin.ghost{background:transparent;color:var(--ink-2);border:1px dashed var(--rule-strong)}
|
||||||
|
.mnote{display:flex;gap:22px;flex-wrap:wrap;font-family:var(--font-display);font-size:12px;color:var(--ink-3);padding-top:6px}
|
||||||
|
.mnote .k{display:flex;align-items:center;gap:7px}
|
||||||
|
.sw{width:13px;height:13px;flex:none;background:var(--ink)}
|
||||||
|
.sw.g{background:transparent;border:1px dashed var(--rule-strong)}
|
||||||
|
.sw.v{background:repeating-linear-gradient(135deg,transparent,transparent 4px,var(--rule) 4px,var(--rule) 5px);border:1px solid var(--rule)}
|
||||||
|
@media (max-width:640px){
|
||||||
|
.mgrid{grid-template-columns:28px repeat(5,minmax(0,1fr))}
|
||||||
|
.mcell{min-height:52px;padding:4px}
|
||||||
|
.pin{font-size:8px;padding:1px 3px}
|
||||||
|
.rlab{min-height:52px}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ---------- methodology ---------- */
|
||||||
|
.verbs{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule)}
|
||||||
|
.verb{background:var(--surface);padding:18px 18px 20px}
|
||||||
|
.verb h4{font-family:var(--font-display);font-weight:750;font-size:15px;margin:0 0 7px;letter-spacing:-.01em}
|
||||||
|
.verb p{font-family:var(--font-display);font-size:12.5px;line-height:1.46;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.verb .step{font-family:var(--font-mono);font-size:9.5px;letter-spacing:.13em;color:var(--brass);display:block;margin-bottom:9px}
|
||||||
|
|
||||||
|
/* ---------- questions ---------- */
|
||||||
|
.qs{display:flex;flex-direction:column;gap:0;border-top:1px solid var(--rule-strong)}
|
||||||
|
.q{display:grid;grid-template-columns:34px minmax(0,1fr) 170px;gap:18px;padding:16px 0;border-bottom:1px solid var(--rule);align-items:start}
|
||||||
|
@media (max-width:760px){.q{grid-template-columns:28px minmax(0,1fr);gap:12px}.q .owner{grid-column:2}}
|
||||||
|
.q .qn{font-family:var(--font-mono);font-size:11px;color:var(--brass);padding-top:3px}
|
||||||
|
.q .qt{font-family:var(--font-display);font-size:14px;line-height:1.48;color:var(--ink-2)}
|
||||||
|
.q .qt b{color:var(--ink);font-weight:700;display:block;margin-bottom:2px;font-size:14.5px}
|
||||||
|
.owner{font-family:var(--font-mono);font-size:10px;letter-spacing:.05em;color:var(--ink-3);padding-top:4px}
|
||||||
|
.owner .tag{display:inline-block;border:1px solid var(--rule-strong);padding:2px 7px;border-radius:2px}
|
||||||
|
.owner .tag.need{border-color:var(--clay);color:var(--clay)}
|
||||||
|
|
||||||
|
/* ---------- misc ---------- */
|
||||||
|
.numbers{font-family:var(--font-mono);font-size:12.5px;line-height:1.85;background:var(--surface);border-left:3px solid var(--l3);padding:16px 20px;margin:0 0 22px;overflow-x:auto;max-width:var(--measure)}
|
||||||
|
.numbers .v{color:var(--ink);font-weight:600}
|
||||||
|
.numbers .k{color:var(--ink-3)}
|
||||||
|
pre{font-family:var(--font-mono);font-size:12.5px;line-height:1.68;background:var(--surface);border-left:3px solid var(--rule-strong);padding:16px 20px;overflow-x:auto;margin:0 0 22px;max-width:var(--measure);color:var(--ink-2)}
|
||||||
|
.alt{border-bottom:1px solid var(--rule);padding:14px 0;max-width:var(--measure)}
|
||||||
|
.alt:last-of-type{border-bottom:none}
|
||||||
|
.alt b{font-family:var(--font-display);font-size:14px;display:block;margin-bottom:3px}
|
||||||
|
.alt p{font-size:14.5px;margin:0;color:var(--ink-2)}
|
||||||
|
.alt .verdict{font-family:var(--font-mono);font-size:10px;letter-spacing:.1em;text-transform:uppercase;color:var(--clay)}
|
||||||
|
footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-family:var(--font-mono);font-size:11px;letter-spacing:.06em;color:var(--ink-3);display:flex;justify-content:space-between;gap:20px;flex-wrap:wrap}
|
||||||
|
.tm td,.tm th{text-align:center}
|
||||||
|
.tm td:first-child,.tm th:first-child{text-align:left}
|
||||||
|
.yes{color:var(--l4);font-weight:700}
|
||||||
|
.no{color:var(--clay);font-weight:700}
|
||||||
|
.kind{font-family:var(--font-mono);font-size:9px;letter-spacing:.09em;text-transform:uppercase;padding:2px 6px;border-radius:2px;white-space:nowrap;border:1px solid var(--rule-strong);color:var(--ink-3)}
|
||||||
|
.kind.adv{border-color:var(--clay);color:var(--clay)}
|
||||||
|
.routes{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:2px;background:var(--rule);border:1px solid var(--rule);margin:0 0 22px}
|
||||||
|
.route{background:var(--surface);padding:16px 18px}
|
||||||
|
.route h4{font-family:var(--font-display);font-weight:750;font-size:14px;margin:0 0 6px}
|
||||||
|
.route p{font-family:var(--font-display);font-size:12.5px;line-height:1.45;color:var(--ink-2);margin:0;max-width:none}
|
||||||
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
|
|
||||||
|
</style>
|
||||||
|
<div class="wrap"><header><div class="eyebrow"><span>RMASTER-ADR-0001</span> <span class="stat">accepted · accepted-1</span> <span>railiance-master</span> <span>reviewed 2026-07-25</span><span>generated from canonical source — do not edit</span></div><h1>Repository Prefix Architecture</h1><p class="sub">Source: <code>railiance-master · docs/adr/ADR-0001-repository-prefix-architecture.md · debbc13b4018f20db0997516b99afc1cc21084d7</code></p><p class="sub">Review due: 2027-01-25</p></header><div class="layout"><nav class="rail" aria-label="Sections"><ol><li><a href="#context"><span class="n">·</span>Context</a></li><li><a href="#decision"><span class="n">·</span>Decision</a></li><li><a href="#meaning-of-each-family"><span class="n">·</span>Meaning Of Each Family</a></li><li><a href="#consequences"><span class="n">·</span>Consequences</a></li><li><a href="#current-interpretation-for-existing-repos"><span class="n">·</span>Current Interpretation For Existing Repos</a></li><li><a href="#notes"><span class="n">·</span>Notes</a></li></ol></nav><main><p>Date: 2026-07-25 Status: Accepted</p>
|
||||||
|
<section id="context"><h2>Context</h2>
|
||||||
|
<p>Railiance already has a meaningful set of ownership repos such as <code>railiance-infra</code>, <code>railiance-cluster</code>, <code>railiance-platform</code>, <code>railiance-enablement</code>, <code>railiance-apps</code>, <code>railiance-forge</code>, and <code>railiance-fabric</code>.</p>
|
||||||
|
<p>That structure is useful, but it does not by itself capture all of the dimensions Railiance now needs.</p>
|
||||||
|
<p>In particular, the architecture needs clear source-controlled homes for:</p>
|
||||||
|
<ul><li>workload execution contracts across different operations architectures,</li><li>managed workload packages as first-class repos,</li><li>and concrete substrate boundaries such as named servers, workstations, or grouped environments.</li></ul>
|
||||||
|
<p>Without that separation, Kubernetes-specific workload semantics remain mixed into <code>railiance-cluster</code>, workload wrappers remain mixed into ownership repos, and concrete substrates remain under-described.</p>
|
||||||
|
<p>Railiance also operates inside a wider ecosystem around Railiance, Net Kingdom, and the Helix Forge software factory. That wider context needs architecture that can support both exploratory operation and production-grade evolution without leaving key responsibilities ambiguous.</p>
|
||||||
|
</section>
|
||||||
|
<section id="decision"><h2>Decision</h2>
|
||||||
|
<p>Railiance adopts four canonical repository families:</p>
|
||||||
|
<ol><li><code>railiance-*</code> for ownership and responsibility areas</li><li><code>rail-*</code> for workload execution contracts</li><li><code>rapp-*</code> for Railiance-managed workload packages</li><li><code>reef-*</code> for durable substrate boundaries</li></ol>
|
||||||
|
<p>The current implementation wave is explicitly centered on <code>rail-kubernetes</code> as the default base rail. Additional rails are introduced only when a concrete workload has a sound reason to run on a distinct execution architecture.</p>
|
||||||
|
<p><code>rail-knative</code> is the first expected follow-on rail, motivated by the need to support <code>qonto-assistent</code>, but it should follow the <code>rail-kubernetes</code> boundary cleanup rather than bypass it.</p>
|
||||||
|
</section>
|
||||||
|
<section id="meaning-of-each-family"><h2>Meaning Of Each Family</h2>
|
||||||
|
<h3><code>railiance-*</code></h3>
|
||||||
|
<p>Owns major architectural responsibilities, shared policies, and durable layer boundaries.</p>
|
||||||
|
<h3><code>rail-*</code></h3>
|
||||||
|
<p>Owns how workloads run on a specific execution architecture such as Kubernetes, Knative, KEDA, Fission, or Nuclio.</p>
|
||||||
|
<p>In the current phase, <code>rail-kubernetes</code> is the default path for platform services and managed applications.</p>
|
||||||
|
<h3><code>rapp-*</code></h3>
|
||||||
|
<p>Owns the managed workload package for one service or application, whether it is an internal workload or a wrapped upstream product.</p>
|
||||||
|
<p>Its role is to provide the managed wrapper and scaffolding needed to run that workload in the Railiance and Net Kingdom context. It does not replace responsibility ownership.</p>
|
||||||
|
<h3><code>reef-*</code></h3>
|
||||||
|
<p>Owns the concrete substrate reality where rails and <code>rapp</code>s are bound, such as a named server, cluster, workstation, or grouped substrate class.</p>
|
||||||
|
<p>A reef is about purpose-bound compute resources, not merely about individual machines.</p>
|
||||||
|
</section>
|
||||||
|
<section id="consequences"><h2>Consequences</h2>
|
||||||
|
<h3>Positive</h3>
|
||||||
|
<ul><li>Ownership, execution, workload identity, and substrate identity become separate concerns.</li><li>Railiance can support multiple execution architectures without forcing all workload semantics into <code>railiance-cluster</code>.</li><li>Platform services and applications can both become first-class managed workload packages where appropriate.</li><li>Concrete substrates gain a clear architectural home without overloading the ownership repos.</li><li>The framework gains a disciplined default path for introducing new rails instead of proliferating them speculatively.</li></ul>
|
||||||
|
<h3>Required Follow-On Work</h3>
|
||||||
|
<ul><li>Define the initial <code>rail-*</code> contracts, starting with <code>rail-kubernetes</code>.</li><li>Evolve the current <code>railiance/app.toml</code> and overlay pattern into a rail-aware, eventually rail-neutral workload packaging contract.</li><li>Identify which current workloads should become <code>rapp-*</code> repos.</li><li>Extend <code>railiance-fabric</code> so rails, <code>rapp</code>s, and reefs become graph-native.</li><li>Define when mixed-rail reefs are acceptable and when clearer substrate separation should be preferred.</li></ul>
|
||||||
|
<h3>Constraints</h3>
|
||||||
|
<ul><li><code>reef-*</code> must not become a default one-repo-per-machine pattern.</li><li>Generic logic stays in the appropriate ownership repo.</li><li>A named machine gets its own reef only when that machine is itself a durable substrate boundary.</li><li><code>rapp-*</code> repos must not become shadow ownership repos.</li><li>Transitional substrate labels should not be canonized before the pattern is operationally stable.</li></ul>
|
||||||
|
</section>
|
||||||
|
<section id="current-interpretation-for-existing-repos"><h2>Current Interpretation For Existing Repos</h2>
|
||||||
|
<ul><li><code>railiance-*</code> repos remain the primary ownership axis.</li><li>Current workload-execution logic in <code>railiance-cluster</code> is a candidate to migrate into <code>rail-kubernetes</code>.</li><li>Current workload wrappers inside <code>railiance-apps</code>, <code>railiance-platform</code>, or <code>railiance-forge</code> may evolve into <code>rapp-*</code> repos over time.</li><li>Current named substrates such as COULOMBCORE, RAILIANCE01, and WORKSTATION may justify <code>reef-*</code> repos when they represent real operational boundaries.</li><li>A reef may host more than one rail in early or mixed environments, but production-critical substrates should prefer clearer purpose and primary-rail boundaries unless a mixed design is justified.</li></ul>
|
||||||
|
</section>
|
||||||
|
<section id="notes"><h2>Notes</h2>
|
||||||
|
<p>This ADR defines the repository taxonomy. It does not yet mandate a full migration or rename of existing repos. Migration should happen when it produces clearer ownership and lower ambiguity, not merely for naming purity.</p>
|
||||||
|
</section><footer><span>RMASTER-ADR-0001 · accepted-1 · accepted</span><span>railiance-master · docs/adr/ADR-0001-repository-prefix-architecture.md · debbc13b4018f20db0997516b99afc1cc21084d7</span></footer></main></div></div></html>
|
||||||
|
|
@ -183,4 +183,4 @@ footer{border-top:2px solid var(--ink);margin-top:20px;padding-top:22px;font-fam
|
||||||
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
.route .tag{font-family:var(--font-mono);font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--brass);display:block;margin-bottom:8px}
|
||||||
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-offset:3px}
|
||||||
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||||
</style><div class="wrap"><header><div class="eyebrow"><span>policy surface</span><span>generated from canonical sources — do not edit</span></div><h1>Coulomb Policy Nexus</h1><p class="sub">Canon and architecture decisions at stable addresses, with visible currency.</p></header><main><table><thead><tr><th>Document</th><th>Status</th><th>Lifecycle</th><th>Revision</th><th>Owner</th><th>Reviewed</th><th>Review due</th><th>Currency</th></tr></thead><tbody><tr><td><a href="/standards/tenancy-posture/v0.1/index.html">NetKingdom Tenancy Posture v0.1</a></td><td>proposed</td><td>active</td><td>draft-8</td><td>net-kingdom</td><td>2026-08-17</td><td>2027-02-17</td><td>current</td></tr></tbody></table></main></div></html>
|
</style><div class="wrap"><header><div class="eyebrow"><span>policy surface</span><span>generated from canonical sources — do not edit</span></div><h1>Coulomb Policy Nexus</h1><p class="sub">Canon and architecture decisions at stable addresses, with visible currency.</p></header><main><table><thead><tr><th>Document</th><th>Status</th><th>Lifecycle</th><th>Revision</th><th>Owner</th><th>Reviewed</th><th>Review due</th><th>Currency</th></tr></thead><tbody><tr><td><a href="/standards/tenancy-posture/v0.1/index.html">NetKingdom Tenancy Posture v0.1</a></td><td>proposed</td><td>active</td><td>draft-8</td><td>net-kingdom</td><td>2026-08-17</td><td>2027-02-17</td><td>current</td></tr><tr><td><a href="/adr/addressing-and-permanence/v1/index.html">Policy addressing and permanence</a></td><td>accepted</td><td>active</td><td>accepted-1</td><td>the-custodian</td><td>2026-08-18</td><td>2027-02-18</td><td>current</td></tr><tr><td><a href="/adr/railiance-repository-prefix/v1/index.html">Repository Prefix Architecture</a></td><td>accepted</td><td>active</td><td>accepted-1</td><td>railiance-master</td><td>2026-07-25</td><td>2027-01-25</td><td>current</td></tr><tr><td><a href="/adr/railiance-rail-kubernetes-wave-1-boundary/v1/index.html">Wave 1 rail-kubernetes Boundary</a></td><td>accepted</td><td>active</td><td>accepted-1</td><td>railiance-master</td><td>2026-07-25</td><td>2027-01-25</td><td>current</td></tr><tr><td><a href="/adr/railiance-rapp-first-wave-selection/v1/index.html">First-Wave rapp Selection</a></td><td>accepted</td><td>active</td><td>accepted-1</td><td>railiance-master</td><td>2026-07-25</td><td>2027-01-25</td><td>current</td></tr><tr><td><a href="/adr/railiance-first-wave-reef-rollout/v1/index.html">First-Wave reef Rollout</a></td><td>accepted</td><td>active</td><td>accepted-1</td><td>railiance-master</td><td>2026-07-26</td><td>2027-01-26</td><td>current</td></tr><tr><td><a href="/adr/railiance-derived-rail-composition/v1/index.html">Derived Rail Composition</a></td><td>accepted</td><td>active</td><td>accepted-1</td><td>railiance-master</td><td>2026-07-26</td><td>2027-01-26</td><td>current</td></tr><tr><td><a href="/adr/railiance-reef-production-admission/v1/index.html">Reef Production Admission</a></td><td>accepted</td><td>active</td><td>accepted-1</td><td>railiance-master</td><td>2026-08-15</td><td>2027-02-15</td><td>current</td></tr><tr><td><a href="/adr/railiance-rapp-declaration-contract/v1/index.html">Rapp Declaration Contract</a></td><td>accepted</td><td>active</td><td>accepted-1</td><td>railiance-master</td><td>2026-08-13</td><td>2027-02-13</td><td>current</td></tr><tr><td><a href="/adr/railiance-private-by-default-exposure/v1/index.html">Private-by-default Exposure</a></td><td>accepted</td><td>active</td><td>accepted-1</td><td>railiance-master</td><td>2026-08-15</td><td>2027-02-15</td><td>current</td></tr></tbody></table></main></div></html>
|
||||||
|
|
|
||||||
|
|
@ -16,6 +16,159 @@
|
||||||
"source_revision": "f4f885289e196b6770fea5d509959e3031fd9295",
|
"source_revision": "f4f885289e196b6770fea5d509959e3031fd9295",
|
||||||
"status": "proposed",
|
"status": "proposed",
|
||||||
"title": "NetKingdom Tenancy Posture v0.1"
|
"title": "NetKingdom Tenancy Posture v0.1"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"canonical_path": "adr/addressing-and-permanence/v1/index.html",
|
||||||
|
"currency": "current",
|
||||||
|
"id": "policy-nexus-adr-0001",
|
||||||
|
"last_reviewed": "2026-08-18",
|
||||||
|
"lifecycle": "active",
|
||||||
|
"owner": "the-custodian",
|
||||||
|
"review_due": "2027-02-18",
|
||||||
|
"revision": "accepted-1",
|
||||||
|
"revision_path": "adr/addressing-and-permanence/v1/revisions/accepted-1/index.html",
|
||||||
|
"source_digest": "a28668fb4b8b6c5ec8c94baac000061276d85ef1849ec7ab8d132b913dbfe3be",
|
||||||
|
"source_path": "docs/adr/ADR-0001-addressing-and-permanence.md",
|
||||||
|
"source_repo": "policy-nexus",
|
||||||
|
"source_revision": "7a24e9107fd62772a82d8b2a69692a09ce88eea9+working-tree.a28668fb4b8b",
|
||||||
|
"status": "accepted",
|
||||||
|
"title": "Policy addressing and permanence"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"canonical_path": "adr/railiance-repository-prefix/v1/index.html",
|
||||||
|
"currency": "current",
|
||||||
|
"id": "RMASTER-ADR-0001",
|
||||||
|
"last_reviewed": "2026-07-25",
|
||||||
|
"lifecycle": "active",
|
||||||
|
"owner": "railiance-master",
|
||||||
|
"review_due": "2027-01-25",
|
||||||
|
"revision": "accepted-1",
|
||||||
|
"revision_path": "adr/railiance-repository-prefix/v1/revisions/accepted-1/index.html",
|
||||||
|
"source_digest": "b9c993ded8d79d6f871dba9cf08a320b2d619609a448ad3d02b632f5b6f76497",
|
||||||
|
"source_path": "docs/adr/ADR-0001-repository-prefix-architecture.md",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_revision": "debbc13b4018f20db0997516b99afc1cc21084d7",
|
||||||
|
"status": "accepted",
|
||||||
|
"title": "Repository Prefix Architecture"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"canonical_path": "adr/railiance-rail-kubernetes-wave-1-boundary/v1/index.html",
|
||||||
|
"currency": "current",
|
||||||
|
"id": "RMASTER-ADR-0002",
|
||||||
|
"last_reviewed": "2026-07-25",
|
||||||
|
"lifecycle": "active",
|
||||||
|
"owner": "railiance-master",
|
||||||
|
"review_due": "2027-01-25",
|
||||||
|
"revision": "accepted-1",
|
||||||
|
"revision_path": "adr/railiance-rail-kubernetes-wave-1-boundary/v1/revisions/accepted-1/index.html",
|
||||||
|
"source_digest": "7e1fc5aedd7294192d8702a22b9f205e5bae20793836fdc48c0c071d10d7ab9d",
|
||||||
|
"source_path": "docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_revision": "debbc13b4018f20db0997516b99afc1cc21084d7",
|
||||||
|
"status": "accepted",
|
||||||
|
"title": "Wave 1 rail-kubernetes Boundary"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"canonical_path": "adr/railiance-rapp-first-wave-selection/v1/index.html",
|
||||||
|
"currency": "current",
|
||||||
|
"id": "RMASTER-ADR-0003",
|
||||||
|
"last_reviewed": "2026-07-25",
|
||||||
|
"lifecycle": "active",
|
||||||
|
"owner": "railiance-master",
|
||||||
|
"review_due": "2027-01-25",
|
||||||
|
"revision": "accepted-1",
|
||||||
|
"revision_path": "adr/railiance-rapp-first-wave-selection/v1/revisions/accepted-1/index.html",
|
||||||
|
"source_digest": "28135e94758b6935518d2e83458c1e607deeabb341879b605eef6529b3168cbc",
|
||||||
|
"source_path": "docs/adr/ADR-0003-rapp-first-wave-selection.md",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_revision": "debbc13b4018f20db0997516b99afc1cc21084d7",
|
||||||
|
"status": "accepted",
|
||||||
|
"title": "First-Wave rapp Selection"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"canonical_path": "adr/railiance-first-wave-reef-rollout/v1/index.html",
|
||||||
|
"currency": "current",
|
||||||
|
"id": "RMASTER-ADR-0004",
|
||||||
|
"last_reviewed": "2026-07-26",
|
||||||
|
"lifecycle": "active",
|
||||||
|
"owner": "railiance-master",
|
||||||
|
"review_due": "2027-01-26",
|
||||||
|
"revision": "accepted-1",
|
||||||
|
"revision_path": "adr/railiance-first-wave-reef-rollout/v1/revisions/accepted-1/index.html",
|
||||||
|
"source_digest": "36ec3aad5082ceff685d66e091c0a24b52abfc65b36595d00dce2b52a7250f4e",
|
||||||
|
"source_path": "docs/adr/ADR-0004-first-wave-reef-rollout.md",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_revision": "debbc13b4018f20db0997516b99afc1cc21084d7",
|
||||||
|
"status": "accepted",
|
||||||
|
"title": "First-Wave reef Rollout"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"canonical_path": "adr/railiance-derived-rail-composition/v1/index.html",
|
||||||
|
"currency": "current",
|
||||||
|
"id": "RMASTER-ADR-0005",
|
||||||
|
"last_reviewed": "2026-07-26",
|
||||||
|
"lifecycle": "active",
|
||||||
|
"owner": "railiance-master",
|
||||||
|
"review_due": "2027-01-26",
|
||||||
|
"revision": "accepted-1",
|
||||||
|
"revision_path": "adr/railiance-derived-rail-composition/v1/revisions/accepted-1/index.html",
|
||||||
|
"source_digest": "e02982ce54691cf1589ac3d04012b9b9282f9eb54ed4b8f2f0544371f9b87f3e",
|
||||||
|
"source_path": "docs/adr/ADR-0005-derived-rail-composition.md",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_revision": "debbc13b4018f20db0997516b99afc1cc21084d7",
|
||||||
|
"status": "accepted",
|
||||||
|
"title": "Derived Rail Composition"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"canonical_path": "adr/railiance-reef-production-admission/v1/index.html",
|
||||||
|
"currency": "current",
|
||||||
|
"id": "RMASTER-ADR-0006",
|
||||||
|
"last_reviewed": "2026-08-15",
|
||||||
|
"lifecycle": "active",
|
||||||
|
"owner": "railiance-master",
|
||||||
|
"review_due": "2027-02-15",
|
||||||
|
"revision": "accepted-1",
|
||||||
|
"revision_path": "adr/railiance-reef-production-admission/v1/revisions/accepted-1/index.html",
|
||||||
|
"source_digest": "d9fbd9d21d86e461334abc24060c39127f2158ba25317b3d3dc326c4f7eaf08c",
|
||||||
|
"source_path": "docs/adr/ADR-0006-reef-production-admission.md",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_revision": "debbc13b4018f20db0997516b99afc1cc21084d7",
|
||||||
|
"status": "accepted",
|
||||||
|
"title": "Reef Production Admission"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"canonical_path": "adr/railiance-rapp-declaration-contract/v1/index.html",
|
||||||
|
"currency": "current",
|
||||||
|
"id": "RMASTER-ADR-0007",
|
||||||
|
"last_reviewed": "2026-08-13",
|
||||||
|
"lifecycle": "active",
|
||||||
|
"owner": "railiance-master",
|
||||||
|
"review_due": "2027-02-13",
|
||||||
|
"revision": "accepted-1",
|
||||||
|
"revision_path": "adr/railiance-rapp-declaration-contract/v1/revisions/accepted-1/index.html",
|
||||||
|
"source_digest": "263431f88ba04d6ab9ab3b6c0d6a2bb08634bfe83dc0719350f0855d399c18b2",
|
||||||
|
"source_path": "docs/adr/ADR-0007-rapp-declaration-contract.md",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_revision": "debbc13b4018f20db0997516b99afc1cc21084d7",
|
||||||
|
"status": "accepted",
|
||||||
|
"title": "Rapp Declaration Contract"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"canonical_path": "adr/railiance-private-by-default-exposure/v1/index.html",
|
||||||
|
"currency": "current",
|
||||||
|
"id": "RMASTER-ADR-0008",
|
||||||
|
"last_reviewed": "2026-08-15",
|
||||||
|
"lifecycle": "active",
|
||||||
|
"owner": "railiance-master",
|
||||||
|
"review_due": "2027-02-15",
|
||||||
|
"revision": "accepted-1",
|
||||||
|
"revision_path": "adr/railiance-private-by-default-exposure/v1/revisions/accepted-1/index.html",
|
||||||
|
"source_digest": "276ea38233413f1e23670bbf57c486abc361b0a275ca67efea7d677103713b32",
|
||||||
|
"source_path": "docs/adr/ADR-0008-private-by-default-exposure.md",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_revision": "debbc13b4018f20db0997516b99afc1cc21084d7",
|
||||||
|
"status": "accepted",
|
||||||
|
"title": "Private-by-default Exposure"
|
||||||
}
|
}
|
||||||
],
|
],
|
||||||
"generated_as_of": "2026-08-18",
|
"generated_as_of": "2026-08-18",
|
||||||
|
|
|
||||||
42
docs/adr-review/SUMMARY.md
Normal file
42
docs/adr-review/SUMMARY.md
Normal file
|
|
@ -0,0 +1,42 @@
|
||||||
|
# ADR review ledger summary
|
||||||
|
|
||||||
|
Rows: 125
|
||||||
|
|
||||||
|
## Inventory dispositions
|
||||||
|
|
||||||
|
- `excluded`: 2
|
||||||
|
- `metadata-pending`: 105
|
||||||
|
- `published`: 10
|
||||||
|
- `unsupported-format`: 8
|
||||||
|
|
||||||
|
## Proposed dispositions
|
||||||
|
|
||||||
|
- `publish`: 9
|
||||||
|
- `unreviewed`: 116
|
||||||
|
|
||||||
|
## Front-matter `id` collisions
|
||||||
|
|
||||||
|
- `ADR-001`: coulomb-loop/docs/adr/ADR-001-workplan-prefix.md, kaizen-agentic/docs/adr/ADR-001-workplan-convention.md, rein-aharness/docs/adr/ADR-001-agent-harness-architecture.md, the-custodian/canon/architecture/adr-001-workplans-as-repo-artefacts.md
|
||||||
|
- `ADR-002`: coulomb-loop/docs/adr/ADR-002-customer-supplier-boundary.md, kaizen-agentic/docs/adr/ADR-002-project-memory-convention.md, the-custodian/canon/architecture/adr-002-custodian-agent-runtime-design.md
|
||||||
|
- `ADR-003`: coulomb-loop/docs/adr/ADR-003-cadence-ramp-policy.md, kaizen-agentic/docs/adr/ADR-003-protocols-artifact-convention.md, the-custodian/canon/architecture/adr-003-materialized-derived-state.md
|
||||||
|
- `ADR-004`: coulomb-loop/docs/adr/ADR-004-repo-rotation-on-diminishing-returns.md, kaizen-agentic/docs/adr/ADR-004-project-metrics-convention.md, the-custodian/canon/architecture/adr-004-connectivity-first-network-posture.md
|
||||||
|
- `ADR-0001`: coulomb-social/docs/adr/ADR-0001-netkingdom-identity.md, key-cape/docs/adr/ADR-0001-choose-go-for-keycape.md, target-revenue/docs/adr/ADR-0001-stage0-library-stack.md
|
||||||
|
- `ADR-005`: kaizen-agentic/docs/adr/ADR-005-scheduled-agent-execution.md, the-custodian/canon/architecture/adr-005-cross-repo-workplans-project-repos.md
|
||||||
|
- `netkingdom-iam-profile`: net-kingdom/canon/standards/iam-profile_v0.2.md, net-kingdom/canon/standards/iam-profile_v0.3.md
|
||||||
|
|
||||||
|
## Bare ADR-NNNN collisions
|
||||||
|
|
||||||
|
- `ADR-0001`: activity-core/docs/adr/adr-001-event-bridge-architecture.md, coulomb-loop/docs/adr/ADR-001-workplan-prefix.md, coulomb-social/docs/adr/ADR-0001-netkingdom-identity.md, evidence-binder/docs/adr/ADR-0001-reference-ui-surface.md, glas-harness/docs/adr/ADR-001-rein-harness-family.md, kaizen-agentic/docs/adr/ADR-001-workplan-convention.md, key-cape/docs/adr/ADR-0001-choose-go-for-keycape.md, markitect-main/docs/adr/ADR-001-client-side-debug-storage.md, policy-nexus/docs/adr/ADR-0001-addressing-and-permanence.md, railiance-master/docs/adr/ADR-0001-repository-prefix-architecture.md, railiance-platform/docs/adr/ADR-0001-s3-platform-service-boundary.md, rapp-postgres/docs/adr/ADR-0001-consumer-boundary-and-tenant-isolation.md, rein-aharness/docs/adr/ADR-001-agent-harness-architecture.md, target-revenue/docs/adr/ADR-0001-stage0-library-stack.md, the-custodian/canon/architecture/adr-001-workplans-as-repo-artefacts.md
|
||||||
|
- `ADR-0002`: activity-core/docs/adr/adr-002-definition-format.md, coulomb-loop/docs/adr/ADR-002-customer-supplier-boundary.md, coulomb-social/docs/adr/ADR-0002-space-content-forgejo-markdown.md, glas-harness/docs/adr/ADR-002-credential-brokering-and-composable-reins.md, kaizen-agentic/docs/adr/ADR-002-project-memory-convention.md, markitect-main/docs/adr/ADR-002-robustness-principle-for-production-use.md, railiance-hosts/docs/adr/ADR-002-repo-boundary-hosts-vs-bootstrap.md, railiance-infra/docs/adr/ADR-002-repo-boundary-hosts-vs-bootstrap.md, railiance-master/docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md, railiance-platform/docs/adr/ADR-0002-placement-policy-ownership.md, rapp-postgres/docs/adr/ADR-0002-data-retention-and-erasure.md, target-revenue/docs/adr/ADR-0002-hosted-trust-service-stack.md, the-custodian/canon/architecture/adr-002-custodian-agent-runtime-design.md
|
||||||
|
- `ADR-0003`: activity-core/docs/adr/adr-003-rule-instruction-model.md, coulomb-loop/docs/adr/ADR-003-cadence-ramp-policy.md, coulomb-social/docs/adr/ADR-0003-page-centric-markdown-sor.md, glas-harness/docs/adr/ADR-003-scheduling-and-blueprint-sourcing-stay-rein-local.md, kaizen-agentic/docs/adr/ADR-003-protocols-artifact-convention.md, railiance-hosts/docs/adr/ADR-003-railiance-5repo-stack-architecture.md, railiance-infra/docs/adr/ADR-003-railiance-5repo-stack-architecture.md, railiance-master/docs/adr/ADR-0003-rapp-first-wave-selection.md, railiance-platform/docs/adr/ADR-0003-decisions-live-in-the-repo.md, rapp-postgres/docs/adr/ADR-0003-e3-row-level-security-contract.md, the-custodian/canon/architecture/adr-003-materialized-derived-state.md
|
||||||
|
- `ADR-0004`: activity-core/docs/adr/adr-004-producer-trust-boundary.md, coulomb-loop/docs/adr/ADR-004-repo-rotation-on-diminishing-returns.md, coulomb-social/docs/adr/ADR-0004-content-plane-thin-git-upgrades.md, glas-harness/docs/adr/ADR-004-composable-reins-stay-deferred.md, kaizen-agentic/docs/adr/ADR-004-project-metrics-convention.md, railiance-hosts/docs/adr/ADR-004-forgejo-in-cluster-actions-runner.md, railiance-infra/docs/adr/ADR-004-forgejo-in-cluster-actions-runner.md, railiance-master/docs/adr/ADR-0004-first-wave-reef-rollout.md, rapp-postgres/docs/adr/ADR-0004-platform-pg-cell-ceiling.md, the-custodian/canon/architecture/adr-004-connectivity-first-network-posture.md
|
||||||
|
- `ADR-0005`: activity-core/docs/adr/adr-005-ops-runs-vs-dev-work-records.md, kaizen-agentic/docs/adr/ADR-005-scheduled-agent-execution.md, railiance-infra/docs/adr/ADR-005-k3s-api-tunnel-only.md, railiance-master/docs/adr/ADR-0005-derived-rail-composition.md, the-custodian/canon/architecture/adr-005-cross-repo-workplans-project-repos.md
|
||||||
|
- `ADR-0006`: kaizen-agentic/docs/adr/ADR-006-customer-engagement-convention.md, net-kingdom/docs/adr/ADR-0006-recursive-multi-tenant-identity-authorization.md, railiance-master/docs/adr/ADR-0006-reef-production-admission.md, the-custodian/canon/architecture/adr-006-canon-federation-concept-ownership.md
|
||||||
|
- `ADR-0007`: kaizen-agentic/docs/adr/ADR-007-forward-deployed-engagement-convention.md, net-kingdom/docs/adr/ADR-0007-security-orchestration-boundary.md, railiance-master/docs/adr/ADR-0007-rapp-declaration-contract.md, the-custodian/canon/architecture/adr-007-workplan-identity-and-repo-worker-topology.md
|
||||||
|
- `ADR-0008`: net-kingdom/docs/adr/ADR-0008-object-storage-sts-credential-vending.md, railiance-master/docs/adr/ADR-0008-private-by-default-exposure.md, the-custodian/canon/architecture/adr-008-multi-tenancy-model.md
|
||||||
|
- `ADR-0010`: net-kingdom/docs/adr/ADR-0010-orchestration-vs-dependency-self-coherent-intent.md, the-custodian/canon/architecture/adr-010-hub-authority-and-local-cache-model.md
|
||||||
|
- `ADR-0011`: net-kingdom/docs/adr/ADR-0011-iam-profile-ownership-and-version-governance.md, the-custodian/canon/architecture/adr-011-federated-namespaces-and-reconciliation-limits.md
|
||||||
|
|
||||||
|
## Missing files
|
||||||
|
|
||||||
|
None.
|
||||||
4742
docs/adr-review/ledger.json
Normal file
4742
docs/adr-review/ledger.json
Normal file
File diff suppressed because it is too large
Load diff
83
docs/adr-review/protocol.md
Normal file
83
docs/adr-review/protocol.md
Normal file
|
|
@ -0,0 +1,83 @@
|
||||||
|
# ADR review protocol
|
||||||
|
|
||||||
|
Working protocol for POLICY-NEXUS-WP-0003. The ledger in this directory
|
||||||
|
is a work artefact. It is not published on `policy.coulomb.social`.
|
||||||
|
|
||||||
|
Input is `source-inventory.json` only. Do not rediscover by glob.
|
||||||
|
|
||||||
|
Refresh the ledger with:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
python3 tools/adr_review_ledger.py
|
||||||
|
```
|
||||||
|
|
||||||
|
## Authority
|
||||||
|
|
||||||
|
- The **owning repo** decides whether an ADR still governs and writes
|
||||||
|
the cleanup.
|
||||||
|
- **the-custodian** decides estate-level canon.
|
||||||
|
- **This repo** records the review and publishes. It does not edit
|
||||||
|
another repo's ADR body.
|
||||||
|
|
||||||
|
## Review dispositions
|
||||||
|
|
||||||
|
Every inventoried source that is not already `published` gets exactly
|
||||||
|
one proposed disposition. `unreviewed` means T02 has mapped the file
|
||||||
|
and T03/T04 have not yet ruled.
|
||||||
|
|
||||||
|
| Disposition | Meaning | Publication |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `unreviewed` | Facts recorded; relevance not ruled. | no |
|
||||||
|
| `publish` | Still governs. Front-matter complete. | `publication.json` entry |
|
||||||
|
| `superseded` | Replaced. Point at the successor. | only if a public URL exists or the successor needs the pointer live |
|
||||||
|
| `withdrawn` | No longer governs, no successor. | same as superseded |
|
||||||
|
| `local` | Useful in its repo, not governing for anyone else. | inventory `excluded` |
|
||||||
|
| `conflict` | Contradicts another ADR or the estate arc42; owner has not ruled. | no |
|
||||||
|
|
||||||
|
## Conflict kinds
|
||||||
|
|
||||||
|
1. **Identifier collision** — same publication `id`, or the same bare
|
||||||
|
`ADR-NNNN` in two repos. Publication ids must be globally unique.
|
||||||
|
2. **Status lie** — body says superseded/relocated, front-matter still
|
||||||
|
`accepted` (or the reverse).
|
||||||
|
3. **Missing successor** — status `superseded` with no target.
|
||||||
|
4. **Contradicting decisions** — two accepted ADRs that cannot both be
|
||||||
|
true.
|
||||||
|
5. **Architecture miss** — an accepted ADR that the matching first-wave
|
||||||
|
arc42 does not mention in chapter 9. Waits on WP-0002-T04/T05.
|
||||||
|
6. **Duplicate claim** — two documents claiming to be the current
|
||||||
|
decision on the same question.
|
||||||
|
|
||||||
|
## Ledger row
|
||||||
|
|
||||||
|
`ledger.json` holds one object per inventory source.
|
||||||
|
|
||||||
|
| Field | Set by | Meaning |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `source_repo`, `source_path` | inventory | Identity |
|
||||||
|
| `inventory_disposition`, `inventory_reason` | inventory | Current source-inventory state |
|
||||||
|
| `file_present` | T02 | Source file readable in the sibling checkout |
|
||||||
|
| `frontmatter` | T02 | Parsed fields used by the builder |
|
||||||
|
| `missing_fields` | T02 | Publication-contract gaps |
|
||||||
|
| `bare_adr` | T02 | `ADR-NNNN` extracted from id or filename, if any |
|
||||||
|
| `id_collisions` | T02 | Other sources sharing the same front-matter `id` |
|
||||||
|
| `bare_adr_collisions` | T02 | Other sources sharing the same bare `ADR-NNNN` |
|
||||||
|
| `notes` | T02 | Known specials |
|
||||||
|
| `proposed_disposition` | T03/T04 | Review ruling; `unreviewed` until then |
|
||||||
|
| `conflict_kinds` | T03 | List of kind numbers, or empty |
|
||||||
|
| `successor` | T03/T04 | Target when superseded |
|
||||||
|
| `review_notes` | T03/T04 | One-sentence contradiction or rationale |
|
||||||
|
|
||||||
|
T02 fills facts and leaves `proposed_disposition` as `unreviewed`
|
||||||
|
except for the first publish set named in WP-0003 (this repo's
|
||||||
|
ADR-0001 and the eight railiance-master ADRs), which start as
|
||||||
|
`publish` because they are already relevance-obvious.
|
||||||
|
|
||||||
|
## First publish set
|
||||||
|
|
||||||
|
- `policy-nexus` `docs/adr/ADR-0001-addressing-and-permanence.md`
|
||||||
|
- `railiance-master` `docs/adr/ADR-0001` through `ADR-0008`
|
||||||
|
|
||||||
|
Known duplicate-claim candidate: custodian
|
||||||
|
`canon/architecture/adr-008-multi-tenancy-model.md` vs published
|
||||||
|
Tenancy Posture.
|
||||||
|
|
@ -1,3 +1,13 @@
|
||||||
|
---
|
||||||
|
id: policy-nexus-adr-0001
|
||||||
|
title: "Policy addressing and permanence"
|
||||||
|
status: accepted
|
||||||
|
owner: the-custodian
|
||||||
|
revision: "accepted-1"
|
||||||
|
last_reviewed: "2026-08-18"
|
||||||
|
review_interval: 6m
|
||||||
|
---
|
||||||
|
|
||||||
# ADR-0001 — policy addressing and permanence
|
# ADR-0001 — policy addressing and permanence
|
||||||
|
|
||||||
- Status: accepted
|
- Status: accepted
|
||||||
|
|
@ -13,6 +23,10 @@ A document has one stable current address and immutable revision addresses:
|
||||||
/<kind>/<document>/<version>/revisions/<revision>/
|
/<kind>/<document>/<version>/revisions/<revision>/
|
||||||
```
|
```
|
||||||
|
|
||||||
|
`<kind>` is one of `standards`, `architecture`, `constitution`, or `adr`.
|
||||||
|
`<document>` is a kebab-case slug that is unique on the site. The owner-facing
|
||||||
|
rules live in `docs/publication-contract.md`.
|
||||||
|
|
||||||
The publication manifest records both. Existing public paths become permanent
|
The publication manifest records both. Existing public paths become permanent
|
||||||
redirect aliases; the first is `/tenancy-posture.html`. No URL is derived from
|
redirect aliases; the first is `/tenancy-posture.html`. No URL is derived from
|
||||||
a checkout path, branch name, build number or hosting implementation.
|
a checkout path, branch name, build number or hosting implementation.
|
||||||
|
|
|
||||||
161
docs/architecture/policy-nexus_v0.1.md
Normal file
161
docs/architecture/policy-nexus_v0.1.md
Normal file
|
|
@ -0,0 +1,161 @@
|
||||||
|
---
|
||||||
|
id: policy-nexus-architecture
|
||||||
|
title: "Policy Nexus architecture"
|
||||||
|
status: proposed
|
||||||
|
owner: the-custodian
|
||||||
|
revision: "draft-1"
|
||||||
|
version: "0.1"
|
||||||
|
last_reviewed: "2026-08-18"
|
||||||
|
review_interval: 6m
|
||||||
|
---
|
||||||
|
|
||||||
|
# Policy Nexus — Software Architecture Documentation (arc42)
|
||||||
|
|
||||||
|
## About this document
|
||||||
|
|
||||||
|
This document follows the **arc42** template for the publication surface
|
||||||
|
at `policy.coulomb.social`. It is the first-wave architecture document
|
||||||
|
this repository is allowed to author. Other first-wave systems are
|
||||||
|
written in their owning repos.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Introduction and Goals
|
||||||
|
|
||||||
|
Policy Nexus exists so estate canon and architecture decisions have a
|
||||||
|
permanent, current, addressable public home. Before this system,
|
||||||
|
governing documents were served from disposable artifact URLs.
|
||||||
|
|
||||||
|
### 1.1 Requirements Overview
|
||||||
|
|
||||||
|
- Publish canon (`standards`, `architecture`, `constitution`) and
|
||||||
|
per-repo ADRs from the repositories that own them.
|
||||||
|
- Keep one stable current URL and one immutable revision URL per
|
||||||
|
document (ADR-0001).
|
||||||
|
- Fail closed when a source disappears or an immutable revision would
|
||||||
|
change.
|
||||||
|
- Show status, owner, revision, and review currency on every page.
|
||||||
|
|
||||||
|
### 1.2 Quality Goals
|
||||||
|
|
||||||
|
1. Permanence of published addresses.
|
||||||
|
2. Honesty about staleness.
|
||||||
|
3. Source-of-truth stays upstream — this system never writes back.
|
||||||
|
4. Builds are deterministic and stdlib-only.
|
||||||
|
|
||||||
|
### 1.3 Stakeholders
|
||||||
|
|
||||||
|
| Role | Concern |
|
||||||
|
| --- | --- |
|
||||||
|
| the-custodian | What counts as canon; ratification. |
|
||||||
|
| Source-repo owners | Their document is published accurately. |
|
||||||
|
| railiance-platform / rapp-policy-nexus | Substrate, Helm, promotion. |
|
||||||
|
| Readers inside and outside the estate | A URL that still resolves. |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Architecture Constraints
|
||||||
|
|
||||||
|
N/A for this stub — first-wave complete will record stdlib-only
|
||||||
|
rendering, single-node rail availability, and the no-CMS rule.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. System Scope and Context
|
||||||
|
|
||||||
|
**In:** addressing, rendering, currency, the public static site.
|
||||||
|
**Out:** ratification, legal advice, regulatory intake (`risk-nexus`),
|
||||||
|
editing surfaces, search.
|
||||||
|
|
||||||
|
### 3.1 Business Context
|
||||||
|
|
||||||
|
Source owners publish governing documents. This system makes those
|
||||||
|
documents findable and durable. It does not decide what is current
|
||||||
|
canon.
|
||||||
|
|
||||||
|
### 3.2 Technical Context
|
||||||
|
|
||||||
|
- Inputs: `publication.json`, sibling or fetched git checkouts,
|
||||||
|
`source-inventory.json`.
|
||||||
|
- Outputs: static HTML, `publication-manifest.json`, an OCI image.
|
||||||
|
- Neighbours: owning source repos, Forgejo Actions, `rapp-policy-nexus`,
|
||||||
|
`railiance-apps`, the reef Traefik/cert-manager substrate.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Solution Strategy
|
||||||
|
|
||||||
|
N/A for this stub — pull-on-schedule ingestion, explicit manifest
|
||||||
|
entries, stdlib renderer. To be written as first-wave complete.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Building Block View
|
||||||
|
|
||||||
|
### 5.1 Level 1 – System/Top-Level
|
||||||
|
|
||||||
|
N/A for this stub — builder, inventory auditor, currency checker,
|
||||||
|
OCI artifact, Helm package in `rapp-policy-nexus`.
|
||||||
|
|
||||||
|
### 5.2 Level 2 – Key Components
|
||||||
|
|
||||||
|
N/A for this stub.
|
||||||
|
|
||||||
|
### 5.3 Level 3 – Internal Structure (as needed)
|
||||||
|
|
||||||
|
N/A for this stub.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Runtime View
|
||||||
|
|
||||||
|
N/A — the published site is static files. Daily source-pull and
|
||||||
|
promotion are operational scenarios for a later revision.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Deployment View
|
||||||
|
|
||||||
|
N/A for this stub — see WP-0001-T04. Single-node restart recovery, not
|
||||||
|
a high-availability SLA.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. Cross-Cutting Concepts
|
||||||
|
|
||||||
|
N/A for this stub.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. Architecture Decisions
|
||||||
|
|
||||||
|
| Id | Status | Decision | Source |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| `policy-nexus-adr-0001` | accepted | Stable current address + immutable revision address; no deletion | `docs/adr/ADR-0001-addressing-and-permanence.md` |
|
||||||
|
|
||||||
|
Later `publish` ADRs from WP-0003 land here. `local` and unresolved
|
||||||
|
`conflict` rows do not.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. Quality Requirements
|
||||||
|
|
||||||
|
N/A for this stub — currency failure is already a build/CI failure.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 11. Risks and Technical Debt
|
||||||
|
|
||||||
|
N/A for this stub. Known residual: Markitect `arc42-v1` schema is not
|
||||||
|
registered yet (WP-0002-T02).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 12. Glossary
|
||||||
|
|
||||||
|
| Term | Meaning |
|
||||||
|
| --- | --- |
|
||||||
|
| Current address | The stable URL for the document as it now stands. |
|
||||||
|
| Revision address | Write-once URL for one source digest. |
|
||||||
|
| Publication entry | One object in `publication.json`. Discovery is not publication. |
|
||||||
|
| First-wave complete | Chapters 1, 3, 4, 5.1, 9 and 12 are real; others real or N/A. |
|
||||||
130
docs/publication-contract.md
Normal file
130
docs/publication-contract.md
Normal file
|
|
@ -0,0 +1,130 @@
|
||||||
|
# Publication contract for source owners
|
||||||
|
|
||||||
|
How a governing document gets a permanent address on
|
||||||
|
`https://policy.coulomb.social`. This note is the owner-facing contract
|
||||||
|
from POLICY-NEXUS-WP-0002-T01. It is not itself a published policy
|
||||||
|
document.
|
||||||
|
|
||||||
|
`policy-nexus` publishes. It does not author your document and it does
|
||||||
|
not write back.
|
||||||
|
|
||||||
|
## What can be published
|
||||||
|
|
||||||
|
| Kind | What it is | Typical source path |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `standards` | Governing standard | `canon/standards/<name>_vN.md` |
|
||||||
|
| `architecture` | One arc42 document per system | `docs/architecture/<system>_v0.1.md` or `canon/architecture/<system>_v0.1.md` |
|
||||||
|
| `constitution` | Estate constitution | `canon/constitution/` |
|
||||||
|
| `adr` | Architecture decision record | `docs/adr/<file>.md` |
|
||||||
|
|
||||||
|
Workplans, evidence, runbooks, review ledgers, and general docs are out.
|
||||||
|
|
||||||
|
An ADR is published only after an explicit `publication.json` entry.
|
||||||
|
Architecture documents follow the same rule. Discovery
|
||||||
|
(`source-inventory.config.json`) is not publication.
|
||||||
|
|
||||||
|
## Front-matter the builder requires
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
id: <globally-unique-id>
|
||||||
|
title: "Human title"
|
||||||
|
status: proposed | accepted | superseded | withdrawn
|
||||||
|
owner: <owning-repo-or-canon-owner>
|
||||||
|
revision: "accepted-1"
|
||||||
|
last_reviewed: "YYYY-MM-DD"
|
||||||
|
review_interval: 6m
|
||||||
|
---
|
||||||
|
```
|
||||||
|
|
||||||
|
| Field | Rule |
|
||||||
|
| --- | --- |
|
||||||
|
| `id` | Must equal the `publication.json` `id`. Globally unique. Repo-prefix ADRs (`RMASTER-ADR-0001`, `policy-nexus-adr-0001`). Bare `ADR-001` will collide. |
|
||||||
|
| `title` | Shown on the page and the site index. |
|
||||||
|
| `status` | Honesty with the body. If the prose says relocated, the status is `superseded`. |
|
||||||
|
| `owner` | Who answers for the content. |
|
||||||
|
| `revision` or `version` | Becomes the immutable revision slug. |
|
||||||
|
| `last_reviewed` or `updated` | ISO date. Currency starts here. |
|
||||||
|
| `review_interval` | `Nd`, `Nm`, or `Ny`. Default `6m` if you do not declare one; the publication entry may also set it. |
|
||||||
|
|
||||||
|
A document missing any of those fields fails the build. Do not ask this
|
||||||
|
repo to invent them.
|
||||||
|
|
||||||
|
## Addresses
|
||||||
|
|
||||||
|
From ADR-0001:
|
||||||
|
|
||||||
|
```text
|
||||||
|
/<kind>/<document>/<version>/
|
||||||
|
/<kind>/<document>/<version>/revisions/<revision>/
|
||||||
|
```
|
||||||
|
|
||||||
|
- `<kind>` is one of the four kinds above.
|
||||||
|
- `<document>` is a kebab-case slug, unique on the site. If two systems
|
||||||
|
would share a short name, prefix with the system slug
|
||||||
|
(`railiance-repository-prefix`, not `repository-prefix`).
|
||||||
|
- `<version>` is the document series (`v0.1`, `v1`). A new major version
|
||||||
|
is a new current address; the old one stays and is marked superseded.
|
||||||
|
- `<revision>` is the front-matter `revision` (for example `draft-8`,
|
||||||
|
`accepted-1`). That URL is write-once.
|
||||||
|
|
||||||
|
Examples:
|
||||||
|
|
||||||
|
```text
|
||||||
|
/standards/tenancy-posture/v0.1/
|
||||||
|
/architecture/policy-nexus/v0.1/
|
||||||
|
/adr/addressing-and-permanence/v1/
|
||||||
|
/adr/railiance-repository-prefix/v1/
|
||||||
|
```
|
||||||
|
|
||||||
|
No URL is derived from a checkout path, branch, or build number.
|
||||||
|
|
||||||
|
## Architecture documents (arc42)
|
||||||
|
|
||||||
|
One markdown file per system, following
|
||||||
|
`markitect-main/examples/templates/TEMPLATE-ARC42.md`.
|
||||||
|
|
||||||
|
- Chapter 9 **lists** that system's ADRs (id, status, pointer). It does
|
||||||
|
not paste them.
|
||||||
|
- First-wave complete means chapters **1, 3, 4, 5.1, 9 and 12** are
|
||||||
|
real. Every other chapter is real or explicitly `N/A` with a reason.
|
||||||
|
- A stub that can be published early has real chapters **1, 3 and 9**
|
||||||
|
plus this front-matter.
|
||||||
|
|
||||||
|
Validate once Markitect registers `arc42-v1`:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
markitect validate docs/architecture/<system>_v0.1.md --schema arc42-v1
|
||||||
|
```
|
||||||
|
|
||||||
|
Until that schema exists, author against the template. This repo will
|
||||||
|
not publish an architecture document that cannot be validated after the
|
||||||
|
schema lands.
|
||||||
|
|
||||||
|
## Infospace index
|
||||||
|
|
||||||
|
The collection index lives at
|
||||||
|
`the-custodian/canon/architecture/infospace/`. It **references** the
|
||||||
|
owning-repo documents. It does not copy them. InfoTechCanon owns the
|
||||||
|
information-space model, not this estate's building-block view.
|
||||||
|
|
||||||
|
## How to request publication
|
||||||
|
|
||||||
|
1. Put the front-matter on the source document in the owning repo.
|
||||||
|
2. For an architecture document, meet the stub or first-wave bar above.
|
||||||
|
3. Open a PR against `policy-nexus` that adds one `publication.json`
|
||||||
|
entry (and a `repositories` path if the repo is new here).
|
||||||
|
4. `make check` and `make build` must pass.
|
||||||
|
|
||||||
|
Do not glob a tree into `publication.json`. Inventory records every
|
||||||
|
matching source; publication stays one explicit entry per document.
|
||||||
|
|
||||||
|
## First-wave architecture collection
|
||||||
|
|
||||||
|
| Publication id | System slug | Owning repo | Source path |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| `coulomb-estate-architecture` | `coulomb-estate` | `the-custodian` | `canon/architecture/coulomb-estate_v0.1.md` |
|
||||||
|
| `railiance-architecture` | `railiance` | `railiance-master` | `docs/architecture/railiance_v0.1.md` |
|
||||||
|
| `net-kingdom-architecture` | `net-kingdom` | `net-kingdom` | `docs/architecture/net-kingdom_v0.1.md` |
|
||||||
|
| `state-hub-architecture` | `state-hub` | `state-hub` | `docs/architecture/state-hub_v0.1.md` |
|
||||||
|
| `policy-nexus-architecture` | `policy-nexus` | `policy-nexus` | `docs/architecture/policy-nexus_v0.1.md` |
|
||||||
|
|
@ -13,7 +13,9 @@
|
||||||
"projects": false
|
"projects": false
|
||||||
},
|
},
|
||||||
"repositories": {
|
"repositories": {
|
||||||
"net-kingdom": {"path": "../net-kingdom"}
|
"net-kingdom": {"path": "../net-kingdom"},
|
||||||
|
"policy-nexus": {"path": "."},
|
||||||
|
"railiance-master": {"path": "../railiance-master"}
|
||||||
},
|
},
|
||||||
"documents": [
|
"documents": [
|
||||||
{
|
{
|
||||||
|
|
@ -25,6 +27,78 @@
|
||||||
"legacy_paths": ["tenancy-posture.html"],
|
"legacy_paths": ["tenancy-posture.html"],
|
||||||
"subtitle": "A framework for describing, holding and improving multi-tenancy — including where we are not there yet.",
|
"subtitle": "A framework for describing, holding and improving multi-tenancy — including where we are not there yet.",
|
||||||
"review_interval": "6m"
|
"review_interval": "6m"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "policy-nexus-adr-0001",
|
||||||
|
"source_repo": "policy-nexus",
|
||||||
|
"source_path": "docs/adr/ADR-0001-addressing-and-permanence.md",
|
||||||
|
"canonical_path": "adr/addressing-and-permanence/v1/index.html",
|
||||||
|
"revision_path": "adr/addressing-and-permanence/v1/revisions/{revision}/index.html",
|
||||||
|
"review_interval": "6m"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "RMASTER-ADR-0001",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_path": "docs/adr/ADR-0001-repository-prefix-architecture.md",
|
||||||
|
"canonical_path": "adr/railiance-repository-prefix/v1/index.html",
|
||||||
|
"revision_path": "adr/railiance-repository-prefix/v1/revisions/{revision}/index.html",
|
||||||
|
"review_interval": "6m"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "RMASTER-ADR-0002",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_path": "docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md",
|
||||||
|
"canonical_path": "adr/railiance-rail-kubernetes-wave-1-boundary/v1/index.html",
|
||||||
|
"revision_path": "adr/railiance-rail-kubernetes-wave-1-boundary/v1/revisions/{revision}/index.html",
|
||||||
|
"review_interval": "6m"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "RMASTER-ADR-0003",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_path": "docs/adr/ADR-0003-rapp-first-wave-selection.md",
|
||||||
|
"canonical_path": "adr/railiance-rapp-first-wave-selection/v1/index.html",
|
||||||
|
"revision_path": "adr/railiance-rapp-first-wave-selection/v1/revisions/{revision}/index.html",
|
||||||
|
"review_interval": "6m"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "RMASTER-ADR-0004",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_path": "docs/adr/ADR-0004-first-wave-reef-rollout.md",
|
||||||
|
"canonical_path": "adr/railiance-first-wave-reef-rollout/v1/index.html",
|
||||||
|
"revision_path": "adr/railiance-first-wave-reef-rollout/v1/revisions/{revision}/index.html",
|
||||||
|
"review_interval": "6m"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "RMASTER-ADR-0005",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_path": "docs/adr/ADR-0005-derived-rail-composition.md",
|
||||||
|
"canonical_path": "adr/railiance-derived-rail-composition/v1/index.html",
|
||||||
|
"revision_path": "adr/railiance-derived-rail-composition/v1/revisions/{revision}/index.html",
|
||||||
|
"review_interval": "6m"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "RMASTER-ADR-0006",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_path": "docs/adr/ADR-0006-reef-production-admission.md",
|
||||||
|
"canonical_path": "adr/railiance-reef-production-admission/v1/index.html",
|
||||||
|
"revision_path": "adr/railiance-reef-production-admission/v1/revisions/{revision}/index.html",
|
||||||
|
"review_interval": "6m"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "RMASTER-ADR-0007",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_path": "docs/adr/ADR-0007-rapp-declaration-contract.md",
|
||||||
|
"canonical_path": "adr/railiance-rapp-declaration-contract/v1/index.html",
|
||||||
|
"revision_path": "adr/railiance-rapp-declaration-contract/v1/revisions/{revision}/index.html",
|
||||||
|
"review_interval": "6m"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "RMASTER-ADR-0008",
|
||||||
|
"source_repo": "railiance-master",
|
||||||
|
"source_path": "docs/adr/ADR-0008-private-by-default-exposure.md",
|
||||||
|
"canonical_path": "adr/railiance-private-by-default-exposure/v1/index.html",
|
||||||
|
"revision_path": "adr/railiance-private-by-default-exposure/v1/revisions/{revision}/index.html",
|
||||||
|
"review_interval": "6m"
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -151,6 +151,12 @@
|
||||||
"source_path": "docs/adr/0003-topaz-aligned-mvp.md",
|
"source_path": "docs/adr/0003-topaz-aligned-mvp.md",
|
||||||
"source_repo": "flex-auth"
|
"source_repo": "flex-auth"
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"disposition": "metadata-pending",
|
||||||
|
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
||||||
|
"source_path": "docs/adr/0004-inbound-caller-authentication.md",
|
||||||
|
"source_repo": "flex-auth"
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"disposition": "metadata-pending",
|
"disposition": "metadata-pending",
|
||||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
||||||
|
|
@ -332,8 +338,8 @@
|
||||||
"source_repo": "net-kingdom"
|
"source_repo": "net-kingdom"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"disposition": "metadata-pending",
|
"disposition": "published",
|
||||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
"reason": "Published through an explicit publication.json document entry.",
|
||||||
"source_path": "docs/adr/ADR-0001-addressing-and-permanence.md",
|
"source_path": "docs/adr/ADR-0001-addressing-and-permanence.md",
|
||||||
"source_repo": "policy-nexus"
|
"source_repo": "policy-nexus"
|
||||||
},
|
},
|
||||||
|
|
@ -380,50 +386,50 @@
|
||||||
"source_repo": "railiance-infra"
|
"source_repo": "railiance-infra"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"disposition": "metadata-pending",
|
"disposition": "published",
|
||||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
"reason": "Published through an explicit publication.json document entry.",
|
||||||
"source_path": "docs/adr/ADR-0001-repository-prefix-architecture.md",
|
"source_path": "docs/adr/ADR-0001-repository-prefix-architecture.md",
|
||||||
"source_repo": "railiance-master"
|
"source_repo": "railiance-master"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"disposition": "metadata-pending",
|
"disposition": "published",
|
||||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
"reason": "Published through an explicit publication.json document entry.",
|
||||||
"source_path": "docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md",
|
"source_path": "docs/adr/ADR-0002-rail-kubernetes-wave-1-boundary.md",
|
||||||
"source_repo": "railiance-master"
|
"source_repo": "railiance-master"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"disposition": "metadata-pending",
|
"disposition": "published",
|
||||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
"reason": "Published through an explicit publication.json document entry.",
|
||||||
"source_path": "docs/adr/ADR-0003-rapp-first-wave-selection.md",
|
"source_path": "docs/adr/ADR-0003-rapp-first-wave-selection.md",
|
||||||
"source_repo": "railiance-master"
|
"source_repo": "railiance-master"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"disposition": "metadata-pending",
|
"disposition": "published",
|
||||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
"reason": "Published through an explicit publication.json document entry.",
|
||||||
"source_path": "docs/adr/ADR-0004-first-wave-reef-rollout.md",
|
"source_path": "docs/adr/ADR-0004-first-wave-reef-rollout.md",
|
||||||
"source_repo": "railiance-master"
|
"source_repo": "railiance-master"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"disposition": "metadata-pending",
|
"disposition": "published",
|
||||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
"reason": "Published through an explicit publication.json document entry.",
|
||||||
"source_path": "docs/adr/ADR-0005-derived-rail-composition.md",
|
"source_path": "docs/adr/ADR-0005-derived-rail-composition.md",
|
||||||
"source_repo": "railiance-master"
|
"source_repo": "railiance-master"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"disposition": "metadata-pending",
|
"disposition": "published",
|
||||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
"reason": "Published through an explicit publication.json document entry.",
|
||||||
"source_path": "docs/adr/ADR-0006-reef-production-admission.md",
|
"source_path": "docs/adr/ADR-0006-reef-production-admission.md",
|
||||||
"source_repo": "railiance-master"
|
"source_repo": "railiance-master"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"disposition": "metadata-pending",
|
"disposition": "published",
|
||||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
"reason": "Published through an explicit publication.json document entry.",
|
||||||
"source_path": "docs/adr/ADR-0007-rapp-declaration-contract.md",
|
"source_path": "docs/adr/ADR-0007-rapp-declaration-contract.md",
|
||||||
"source_repo": "railiance-master"
|
"source_repo": "railiance-master"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"disposition": "metadata-pending",
|
"disposition": "published",
|
||||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
"reason": "Published through an explicit publication.json document entry.",
|
||||||
"source_path": "docs/adr/ADR-0008-private-by-default-exposure.md",
|
"source_path": "docs/adr/ADR-0008-private-by-default-exposure.md",
|
||||||
"source_repo": "railiance-master"
|
"source_repo": "railiance-master"
|
||||||
},
|
},
|
||||||
|
|
|
||||||
78
tests/test_adr_review_ledger.py
Normal file
78
tests/test_adr_review_ledger.py
Normal file
|
|
@ -0,0 +1,78 @@
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
from pathlib import Path
|
||||||
|
import sys
|
||||||
|
import tempfile
|
||||||
|
import unittest
|
||||||
|
|
||||||
|
|
||||||
|
ROOT = Path(__file__).parents[1]
|
||||||
|
sys.path.insert(0, str(ROOT / "tools"))
|
||||||
|
from adr_review_ledger import build_ledger
|
||||||
|
|
||||||
|
|
||||||
|
class AdrReviewLedgerTest(unittest.TestCase):
|
||||||
|
def test_maps_inventory_and_flags_bare_adr_collisions(self) -> None:
|
||||||
|
with tempfile.TemporaryDirectory() as directory:
|
||||||
|
root = Path(directory)
|
||||||
|
left = root / "alpha"
|
||||||
|
right = root / "beta"
|
||||||
|
(left / "docs/adr").mkdir(parents=True)
|
||||||
|
(right / "docs/adr").mkdir(parents=True)
|
||||||
|
(left / "docs/adr/ADR-0001-one.md").write_text(
|
||||||
|
"---\nid: ALPHA-ADR-0001\ntitle: One\nstatus: accepted\n"
|
||||||
|
"owner: alpha\nrevision: accepted-1\n"
|
||||||
|
"last_reviewed: \"2026-08-18\"\nreview_interval: 6m\n---\n# One\n",
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
(right / "docs/adr/ADR-0001-two.md").write_text("# Two\n", encoding="utf-8")
|
||||||
|
config = root / "source-inventory.config.json"
|
||||||
|
config.write_text(
|
||||||
|
json.dumps(
|
||||||
|
{
|
||||||
|
"schema_version": 1,
|
||||||
|
"repositories": {
|
||||||
|
"alpha": {"branch": "main", "remote": "https://example.invalid/a.git", "selectors": ["docs/adr/*.md"]},
|
||||||
|
"beta": {"branch": "main", "remote": "https://example.invalid/b.git", "selectors": ["docs/adr/*.md"]},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
),
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
inventory = root / "source-inventory.json"
|
||||||
|
inventory.write_text(
|
||||||
|
json.dumps(
|
||||||
|
{
|
||||||
|
"schema_version": 1,
|
||||||
|
"sources": [
|
||||||
|
{
|
||||||
|
"source_repo": "alpha",
|
||||||
|
"source_path": "docs/adr/ADR-0001-one.md",
|
||||||
|
"disposition": "metadata-pending",
|
||||||
|
"reason": "pending",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"source_repo": "beta",
|
||||||
|
"source_path": "docs/adr/ADR-0001-two.md",
|
||||||
|
"disposition": "metadata-pending",
|
||||||
|
"reason": "pending",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
}
|
||||||
|
),
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
ledger = build_ledger(
|
||||||
|
inventory, config, policy_root=root, source_root=root
|
||||||
|
)
|
||||||
|
rows = {f"{row['source_repo']}/{row['source_path']}": row for row in ledger["rows"]}
|
||||||
|
self.assertEqual(2, len(rows))
|
||||||
|
self.assertEqual([], rows["alpha/docs/adr/ADR-0001-one.md"]["missing_fields"])
|
||||||
|
self.assertIn("id", rows["beta/docs/adr/ADR-0001-two.md"]["missing_fields"])
|
||||||
|
self.assertEqual("ADR-0001", rows["alpha/docs/adr/ADR-0001-one.md"]["bare_adr"])
|
||||||
|
self.assertEqual(
|
||||||
|
["beta/docs/adr/ADR-0001-two.md"],
|
||||||
|
rows["alpha/docs/adr/ADR-0001-one.md"]["bare_adr_collisions"],
|
||||||
|
)
|
||||||
|
self.assertEqual("unreviewed", rows["alpha/docs/adr/ADR-0001-one.md"]["proposed_disposition"])
|
||||||
255
tools/adr_review_ledger.py
Normal file
255
tools/adr_review_ledger.py
Normal file
|
|
@ -0,0 +1,255 @@
|
||||||
|
#!/usr/bin/env python3
|
||||||
|
"""Build the ADR review ledger from source-inventory.json and source files."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import argparse
|
||||||
|
import json
|
||||||
|
import re
|
||||||
|
from pathlib import Path
|
||||||
|
import sys
|
||||||
|
from typing import Any
|
||||||
|
|
||||||
|
from render import split_frontmatter
|
||||||
|
from source_inventory import _repo_paths, _read_json
|
||||||
|
|
||||||
|
|
||||||
|
BARE_ADR = re.compile(r"(?i)\bADR-0*(\d+)\b")
|
||||||
|
REQUIRED = ("id", "title", "status", "owner")
|
||||||
|
FIRST_PUBLISH = {
|
||||||
|
("policy-nexus", "docs/adr/ADR-0001-addressing-and-permanence.md"),
|
||||||
|
*(
|
||||||
|
(
|
||||||
|
"railiance-master",
|
||||||
|
f"docs/adr/ADR-000{n}-{slug}.md",
|
||||||
|
)
|
||||||
|
for n, slug in (
|
||||||
|
(1, "repository-prefix-architecture"),
|
||||||
|
(2, "rail-kubernetes-wave-1-boundary"),
|
||||||
|
(3, "rapp-first-wave-selection"),
|
||||||
|
(4, "first-wave-reef-rollout"),
|
||||||
|
(5, "derived-rail-composition"),
|
||||||
|
(6, "reef-production-admission"),
|
||||||
|
(7, "rapp-declaration-contract"),
|
||||||
|
(8, "private-by-default-exposure"),
|
||||||
|
)
|
||||||
|
),
|
||||||
|
}
|
||||||
|
SPECIALS = {
|
||||||
|
("policy-nexus", "docs/adr/ADR-0001-addressing-and-permanence.md"): (
|
||||||
|
"First publish set. This repo's addressing contract."
|
||||||
|
),
|
||||||
|
("the-custodian", "canon/architecture/adr-008-multi-tenancy-model.md"): (
|
||||||
|
"Relocated to net-kingdom Tenancy Posture. Duplicate-claim candidate (kind 6)."
|
||||||
|
),
|
||||||
|
}
|
||||||
|
for n, slug in (
|
||||||
|
(1, "repository-prefix-architecture"),
|
||||||
|
(2, "rail-kubernetes-wave-1-boundary"),
|
||||||
|
(3, "rapp-first-wave-selection"),
|
||||||
|
(4, "first-wave-reef-rollout"),
|
||||||
|
(5, "derived-rail-composition"),
|
||||||
|
(6, "reef-production-admission"),
|
||||||
|
(7, "rapp-declaration-contract"),
|
||||||
|
(8, "private-by-default-exposure"),
|
||||||
|
):
|
||||||
|
SPECIALS[("railiance-master", f"docs/adr/ADR-000{n}-{slug}.md")] = (
|
||||||
|
"First publish set. Publication-ready front-matter."
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _bare_adr(source_path: str, meta_id: str) -> str:
|
||||||
|
for text in (meta_id, Path(source_path).name):
|
||||||
|
match = BARE_ADR.search(text)
|
||||||
|
if match:
|
||||||
|
return f"ADR-{int(match.group(1)):04d}"
|
||||||
|
return ""
|
||||||
|
|
||||||
|
|
||||||
|
def _missing(meta: dict[str, str]) -> list[str]:
|
||||||
|
missing = [field for field in REQUIRED if not meta.get(field)]
|
||||||
|
if not (meta.get("revision") or meta.get("version")):
|
||||||
|
missing.append("revision|version")
|
||||||
|
if not ((meta.get("last_reviewed") or meta.get("updated")) and meta.get("review_interval")):
|
||||||
|
missing.append("review")
|
||||||
|
return missing
|
||||||
|
|
||||||
|
|
||||||
|
def _frontmatter(path: Path) -> dict[str, str]:
|
||||||
|
if not path.is_file():
|
||||||
|
return {}
|
||||||
|
meta, _body = split_frontmatter(path.read_text(encoding="utf-8", errors="replace"))
|
||||||
|
return {key: value for key, value in meta.items() if value}
|
||||||
|
|
||||||
|
|
||||||
|
def build_ledger(
|
||||||
|
inventory_path: Path, config_path: Path, *, policy_root: Path, source_root: Path
|
||||||
|
) -> dict[str, Any]:
|
||||||
|
inventory = _read_json(inventory_path)
|
||||||
|
config = _read_json(config_path)
|
||||||
|
paths = _repo_paths(config, policy_root=policy_root, source_root=source_root)
|
||||||
|
rows: list[dict[str, Any]] = []
|
||||||
|
for source in inventory.get("sources", []):
|
||||||
|
key = (source["source_repo"], source["source_path"])
|
||||||
|
repo = paths.get(source["source_repo"])
|
||||||
|
file_path = (repo / source["source_path"]) if repo is not None else None
|
||||||
|
present = bool(file_path and file_path.is_file())
|
||||||
|
meta = _frontmatter(file_path) if present and file_path is not None else {}
|
||||||
|
rows.append(
|
||||||
|
{
|
||||||
|
"source_repo": source["source_repo"],
|
||||||
|
"source_path": source["source_path"],
|
||||||
|
"inventory_disposition": source.get("disposition", ""),
|
||||||
|
"inventory_reason": source.get("reason", ""),
|
||||||
|
"file_present": present,
|
||||||
|
"frontmatter": {
|
||||||
|
field: meta.get(field, "")
|
||||||
|
for field in (
|
||||||
|
"id",
|
||||||
|
"title",
|
||||||
|
"status",
|
||||||
|
"owner",
|
||||||
|
"revision",
|
||||||
|
"version",
|
||||||
|
"last_reviewed",
|
||||||
|
"updated",
|
||||||
|
"review_interval",
|
||||||
|
)
|
||||||
|
},
|
||||||
|
"missing_fields": _missing(meta) if present else ["file-missing"],
|
||||||
|
"bare_adr": _bare_adr(source["source_path"], meta.get("id", "")),
|
||||||
|
"id_collisions": [],
|
||||||
|
"bare_adr_collisions": [],
|
||||||
|
"notes": SPECIALS.get(key, ""),
|
||||||
|
"proposed_disposition": "publish" if key in FIRST_PUBLISH else "unreviewed",
|
||||||
|
"conflict_kinds": [],
|
||||||
|
"successor": (
|
||||||
|
"netkingdom-tenancy-posture"
|
||||||
|
if key == ("the-custodian", "canon/architecture/adr-008-multi-tenancy-model.md")
|
||||||
|
else ""
|
||||||
|
),
|
||||||
|
"review_notes": "",
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
by_id: dict[str, list[str]] = {}
|
||||||
|
by_bare: dict[str, list[str]] = {}
|
||||||
|
for row in rows:
|
||||||
|
label = f"{row['source_repo']}/{row['source_path']}"
|
||||||
|
meta_id = row["frontmatter"]["id"]
|
||||||
|
if meta_id:
|
||||||
|
by_id.setdefault(meta_id, []).append(label)
|
||||||
|
if row["bare_adr"]:
|
||||||
|
by_bare.setdefault(row["bare_adr"], []).append(label)
|
||||||
|
for row in rows:
|
||||||
|
label = f"{row['source_repo']}/{row['source_path']}"
|
||||||
|
meta_id = row["frontmatter"]["id"]
|
||||||
|
if meta_id:
|
||||||
|
row["id_collisions"] = [other for other in by_id.get(meta_id, []) if other != label]
|
||||||
|
if row["bare_adr"]:
|
||||||
|
row["bare_adr_collisions"] = [
|
||||||
|
other for other in by_bare.get(row["bare_adr"], []) if other != label
|
||||||
|
]
|
||||||
|
|
||||||
|
return {
|
||||||
|
"schema_version": 1,
|
||||||
|
"protocol": "docs/adr-review/protocol.md",
|
||||||
|
"source_inventory": "source-inventory.json",
|
||||||
|
"rows": rows,
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
def _summary(ledger: dict[str, Any]) -> str:
|
||||||
|
rows = ledger["rows"]
|
||||||
|
dispositions = {}
|
||||||
|
inventory = {}
|
||||||
|
for row in rows:
|
||||||
|
dispositions[row["proposed_disposition"]] = (
|
||||||
|
dispositions.get(row["proposed_disposition"], 0) + 1
|
||||||
|
)
|
||||||
|
inventory[row["inventory_disposition"]] = inventory.get(row["inventory_disposition"], 0) + 1
|
||||||
|
missing_files = [row for row in rows if not row["file_present"]]
|
||||||
|
id_hits = [row for row in rows if row["id_collisions"]]
|
||||||
|
bare_hits = [row for row in rows if row["bare_adr_collisions"]]
|
||||||
|
lines = [
|
||||||
|
"# ADR review ledger summary",
|
||||||
|
"",
|
||||||
|
f"Rows: {len(rows)}",
|
||||||
|
"",
|
||||||
|
"## Inventory dispositions",
|
||||||
|
"",
|
||||||
|
]
|
||||||
|
for name, count in sorted(inventory.items()):
|
||||||
|
lines.append(f"- `{name}`: {count}")
|
||||||
|
lines.extend(["", "## Proposed dispositions", ""])
|
||||||
|
for name, count in sorted(dispositions.items()):
|
||||||
|
lines.append(f"- `{name}`: {count}")
|
||||||
|
lines.extend(["", "## Front-matter `id` collisions", ""])
|
||||||
|
if not id_hits:
|
||||||
|
lines.append("None.")
|
||||||
|
else:
|
||||||
|
seen = set()
|
||||||
|
for row in id_hits:
|
||||||
|
key = row["frontmatter"]["id"]
|
||||||
|
if key in seen:
|
||||||
|
continue
|
||||||
|
seen.add(key)
|
||||||
|
others = ", ".join([f"{row['source_repo']}/{row['source_path']}", *row["id_collisions"]])
|
||||||
|
lines.append(f"- `{key}`: {others}")
|
||||||
|
lines.extend(["", "## Bare ADR-NNNN collisions", ""])
|
||||||
|
if not bare_hits:
|
||||||
|
lines.append("None.")
|
||||||
|
else:
|
||||||
|
seen = set()
|
||||||
|
for row in bare_hits:
|
||||||
|
key = row["bare_adr"]
|
||||||
|
if key in seen:
|
||||||
|
continue
|
||||||
|
seen.add(key)
|
||||||
|
others = ", ".join(
|
||||||
|
[f"{row['source_repo']}/{row['source_path']}", *row["bare_adr_collisions"]]
|
||||||
|
)
|
||||||
|
lines.append(f"- `{key}`: {others}")
|
||||||
|
lines.extend(["", "## Missing files", ""])
|
||||||
|
if not missing_files:
|
||||||
|
lines.append("None.")
|
||||||
|
else:
|
||||||
|
for row in missing_files:
|
||||||
|
lines.append(f"- `{row['source_repo']}/{row['source_path']}`")
|
||||||
|
lines.append("")
|
||||||
|
return "\n".join(lines)
|
||||||
|
|
||||||
|
|
||||||
|
def main(argv: list[str] | None = None) -> int:
|
||||||
|
parser = argparse.ArgumentParser(description=__doc__)
|
||||||
|
parser.add_argument("--config", type=Path, default=Path("source-inventory.config.json"))
|
||||||
|
parser.add_argument("--inventory", type=Path, default=Path("source-inventory.json"))
|
||||||
|
parser.add_argument("--output", type=Path, default=Path("docs/adr-review/ledger.json"))
|
||||||
|
parser.add_argument("--summary", type=Path, default=Path("docs/adr-review/SUMMARY.md"))
|
||||||
|
parser.add_argument("--policy-root", type=Path)
|
||||||
|
parser.add_argument("--source-root", type=Path)
|
||||||
|
args = parser.parse_args(argv)
|
||||||
|
config_path = args.config.resolve()
|
||||||
|
policy_root = (args.policy_root or config_path.parent).resolve()
|
||||||
|
source_root = (args.source_root or policy_root.parent).resolve()
|
||||||
|
try:
|
||||||
|
ledger = build_ledger(
|
||||||
|
args.inventory.resolve(),
|
||||||
|
config_path,
|
||||||
|
policy_root=policy_root,
|
||||||
|
source_root=source_root,
|
||||||
|
)
|
||||||
|
args.output.parent.mkdir(parents=True, exist_ok=True)
|
||||||
|
args.output.write_text(
|
||||||
|
json.dumps(ledger, indent=2, sort_keys=True) + "\n", encoding="utf-8"
|
||||||
|
)
|
||||||
|
args.summary.write_text(_summary(ledger), encoding="utf-8")
|
||||||
|
print(f"{args.output}: {len(ledger['rows'])} row(s)")
|
||||||
|
return 0
|
||||||
|
except (OSError, ValueError) as exc:
|
||||||
|
print(f"adr review ledger failed: {exc}", file=sys.stderr)
|
||||||
|
return 1
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
raise SystemExit(main())
|
||||||
|
|
@ -4,7 +4,7 @@ type: workplan
|
||||||
title: "Publish an arc42 architecture collection from owning repos"
|
title: "Publish an arc42 architecture collection from owning repos"
|
||||||
domain: infotech
|
domain: infotech
|
||||||
repo: policy-nexus
|
repo: policy-nexus
|
||||||
status: proposed
|
status: active
|
||||||
owner: the-custodian
|
owner: the-custodian
|
||||||
topic_slug: policy-nexus
|
topic_slug: policy-nexus
|
||||||
created: "2026-08-18"
|
created: "2026-08-18"
|
||||||
|
|
@ -120,7 +120,7 @@ Required publication front-matter is the same contract as for ADRs: `id`,
|
||||||
|
|
||||||
```task
|
```task
|
||||||
id: POLICY-NEXUS-WP-0002-T01
|
id: POLICY-NEXUS-WP-0002-T01
|
||||||
status: todo
|
status: done
|
||||||
priority: high
|
priority: high
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -141,6 +141,11 @@ not a second architecture). Fold the addressing into ADR-0001 only if the
|
||||||
**Why first:** WP-0003's relevance and conflict checks need to know what an
|
**Why first:** WP-0003's relevance and conflict checks need to know what an
|
||||||
architecture document is.
|
architecture document is.
|
||||||
|
|
||||||
|
Completed 2026-08-18 in `docs/publication-contract.md`. ADR-0001 now names
|
||||||
|
the four kinds (`standards`, `architecture`, `constitution`, `adr`). The
|
||||||
|
policy-nexus first-wave stub is at `docs/architecture/policy-nexus_v0.1.md`
|
||||||
|
and is not published until the architecture selector and inventory catch up.
|
||||||
|
|
||||||
### T02 — Markitect arc42 schema handoff
|
### T02 — Markitect arc42 schema handoff
|
||||||
|
|
||||||
```task
|
```task
|
||||||
|
|
@ -210,7 +215,7 @@ is "this decision does not fit the estate".
|
||||||
|
|
||||||
```task
|
```task
|
||||||
id: POLICY-NEXUS-WP-0002-T05
|
id: POLICY-NEXUS-WP-0002-T05
|
||||||
status: todo
|
status: progress
|
||||||
priority: medium
|
priority: medium
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -223,6 +228,11 @@ publish. Deeper chapters are the owning repo's follow-on, not a gate here.
|
||||||
|
|
||||||
This repo authors only `docs/architecture/policy-nexus_v0.1.md`.
|
This repo authors only `docs/architecture/policy-nexus_v0.1.md`.
|
||||||
|
|
||||||
|
2026-08-18: policy-nexus stub exists with real chapters 1, 3 and 9. It is
|
||||||
|
not in `publication.json` yet — inventory selectors do not include
|
||||||
|
`docs/architecture/` until this file is on `HEAD` and T06 reviews it.
|
||||||
|
The other four documents remain owning-repo work.
|
||||||
|
|
||||||
### T06 — Register and publish
|
### T06 — Register and publish
|
||||||
|
|
||||||
```task
|
```task
|
||||||
|
|
|
||||||
|
|
@ -4,7 +4,7 @@ type: workplan
|
||||||
title: "Review ADRs for conflict, keep what governs, publish the rest properly"
|
title: "Review ADRs for conflict, keep what governs, publish the rest properly"
|
||||||
domain: infotech
|
domain: infotech
|
||||||
repo: policy-nexus
|
repo: policy-nexus
|
||||||
status: proposed
|
status: active
|
||||||
owner: the-custodian
|
owner: the-custodian
|
||||||
topic_slug: policy-nexus
|
topic_slug: policy-nexus
|
||||||
created: "2026-08-18"
|
created: "2026-08-18"
|
||||||
|
|
@ -127,7 +127,7 @@ Everything else waits on the review row.
|
||||||
|
|
||||||
```task
|
```task
|
||||||
id: POLICY-NEXUS-WP-0003-T01
|
id: POLICY-NEXUS-WP-0003-T01
|
||||||
status: todo
|
status: done
|
||||||
priority: high
|
priority: high
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -139,11 +139,14 @@ Use `source-inventory.json` as the input set. Do not rediscover by glob.
|
||||||
|
|
||||||
**Output:** `docs/adr-review/` (ledger + protocol). Not published.
|
**Output:** `docs/adr-review/` (ledger + protocol). Not published.
|
||||||
|
|
||||||
|
Completed 2026-08-18. Protocol, regenerable `ledger.json`, and
|
||||||
|
`tools/adr_review_ledger.py` are in place.
|
||||||
|
|
||||||
### T02 — Corpus map
|
### T02 — Corpus map
|
||||||
|
|
||||||
```task
|
```task
|
||||||
id: POLICY-NEXUS-WP-0003-T02
|
id: POLICY-NEXUS-WP-0003-T02
|
||||||
status: todo
|
status: done
|
||||||
priority: high
|
priority: high
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -159,6 +162,11 @@ relevance.
|
||||||
|
|
||||||
Depends on T01. Does not depend on WP-0002.
|
Depends on T01. Does not depend on WP-0002.
|
||||||
|
|
||||||
|
Completed 2026-08-18. `docs/adr-review/ledger.json` records front-matter,
|
||||||
|
gaps, identifier collisions, and the known ADR-008 / Tenancy Posture
|
||||||
|
special. First-publish-set rows start as `publish`; everything else is
|
||||||
|
`unreviewed`.
|
||||||
|
|
||||||
### T03 — Conflict and inconsistency pass
|
### T03 — Conflict and inconsistency pass
|
||||||
|
|
||||||
```task
|
```task
|
||||||
|
|
@ -220,7 +228,7 @@ not as an edit of the ADR bodies. This repo applies the packet only for
|
||||||
|
|
||||||
```task
|
```task
|
||||||
id: POLICY-NEXUS-WP-0003-T06
|
id: POLICY-NEXUS-WP-0003-T06
|
||||||
status: todo
|
status: progress
|
||||||
priority: high
|
priority: high
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -237,6 +245,11 @@ priority: high
|
||||||
Further registrations happen as packets return, still under this task
|
Further registrations happen as packets return, still under this task
|
||||||
until the ledger has no `publish` row left unpublished.
|
until the ledger has no `publish` row left unpublished.
|
||||||
|
|
||||||
|
2026-08-18: first publish set is in `publication.json` — this repo's
|
||||||
|
ADR-0001 (with publication front-matter) and railiance-master
|
||||||
|
ADR-0001–0008. Inventory dispositions match. Remaining `publish` rows
|
||||||
|
wait on later packets.
|
||||||
|
|
||||||
### T07 — Point the architecture documents at what remains
|
### T07 — Point the architecture documents at what remains
|
||||||
|
|
||||||
```task
|
```task
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue