Record ADR conflicts and publish the estate arc42
Some checks failed
Build and publish policy-nexus image / build-and-push (push) Failing after 39s
Some checks failed
Build and publish policy-nexus image / build-and-push (push) Failing after 39s
T03 writes a rulings overlay and a readable conflict list. T04 starts relevance: five superseded, five live conflicts, estate and activity-core ADRs marked publish-after-prefix. The Coulomb estate map is now a published architecture document.
This commit is contained in:
parent
9c6a1d3ce0
commit
d1f9ac6cd7
17 changed files with 1263 additions and 126 deletions
|
|
@ -1,6 +1,6 @@
|
|||
<!doctype html>
|
||||
<html lang="en"><meta charset="utf-8">
|
||||
<meta name="policy-source-revision" content="a8fb62a3bcbff3daf03e5d3d56c3ca3a5bd991f8">
|
||||
<meta name="policy-source-revision" content="9c6a1d3ce0a76b3cbd342ab74d3914aa339fd4e0">
|
||||
<meta name="policy-source-digest" content="a28668fb4b8b6c5ec8c94baac000061276d85ef1849ec7ab8d132b913dbfe3be">
|
||||
<title>Policy addressing and permanence</title>
|
||||
<style>
|
||||
|
|
@ -191,7 +191,7 @@ a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-off
|
|||
@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 · a8fb62a3bcbff3daf03e5d3d56c3ca3a5bd991f8</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>
|
||||
<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 · 9c6a1d3ce0a76b3cbd342ab74d3914aa339fd4e0</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>/
|
||||
|
|
@ -211,4 +211,4 @@ a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-off
|
|||
</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 · a8fb62a3bcbff3daf03e5d3d56c3ca3a5bd991f8</span></footer></main></div></div></html>
|
||||
</section><footer><span>policy-nexus-adr-0001 · accepted-1 · accepted</span><span>policy-nexus · docs/adr/ADR-0001-addressing-and-permanence.md · 9c6a1d3ce0a76b3cbd342ab74d3914aa339fd4e0</span></footer></main></div></div></html>
|
||||
|
|
|
|||
274
build/architecture/coulomb-estate/v0.1/index.html
Normal file
274
build/architecture/coulomb-estate/v0.1/index.html
Normal file
|
|
@ -0,0 +1,274 @@
|
|||
<!doctype html>
|
||||
<html lang="en"><meta charset="utf-8">
|
||||
<meta name="policy-source-revision" content="5b51623198d9959793762f447f5813960c0b5df8">
|
||||
<meta name="policy-source-digest" content="0ab59ab79931e19615648da435e4a636836904a1189f5b53e3ee8467bea49841">
|
||||
<title>Coulomb estate 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>coulomb-estate-architecture</span> <span class="stat">proposed · draft-1</span> <span>the-custodian</span> <span>reviewed 2026-08-18</span><span>generated from canonical source — do not edit</span></div><h1>Coulomb estate architecture</h1><p class="sub">Source: <code>the-custodian · canon/architecture/coulomb-estate_v0.1.md · 5b51623198d9959793762f447f5813960c0b5df8</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="#about-this-document"><span class="n">·</span>About this document</a></li><li><a href="#s1"><span class="n">1</span>Introduction and Goals</a></li><li><a href="#s2"><span class="n">2</span>Architecture Constraints</a></li><li><a href="#s3"><span class="n">3</span>System Scope and Context</a></li><li><a href="#s4"><span class="n">4</span>Solution Strategy</a></li><li><a href="#s5"><span class="n">5</span>Building Block View</a></li><li><a href="#s6"><span class="n">6</span>Runtime View</a></li><li><a href="#s7"><span class="n">7</span>Deployment View</a></li><li><a href="#s8"><span class="n">8</span>Cross-Cutting Concepts</a></li><li><a href="#s9"><span class="n">9</span>Architecture Decisions</a></li><li><a href="#s10"><span class="n">10</span>Quality Requirements</a></li><li><a href="#s11"><span class="n">11</span>Risks and Technical Debt</a></li><li><a href="#s12"><span class="n">12</span>Glossary</a></li></ol></nav><main><section id="about-this-document"><h2>About this document</h2>
|
||||
<p>This is the first-wave <strong>estate map</strong>. It describes how the Coulomb / Custodian estate is put together: canons, hubs, rails, and publication. System-level arc42 documents (Railiance, NetKingdom, State Hub, Policy Nexus) live in their owning repos. Chapter 9 lists estate ADRs; it does not paste them.</p>
|
||||
</section>
|
||||
<section id="s1"><h2><span class="sn">01</span>Introduction and Goals</h2>
|
||||
<p>the-custodian holds meaning, boundaries, and continuity for a local-first agent estate. Implementation lives in product repos. Coordination state is a read-model of repository files, not the origin of those files.</p>
|
||||
<h3>1.1 Requirements Overview</h3>
|
||||
<ul><li>Work, decisions, and canon originate as files in the owning repo.</li><li>A publication surface keeps governing documents at permanent URLs.</li><li>Runtime (Rails, rApps, identity, storage) is consumed from platform packages, not reimplemented in the custodian.</li><li>Cross-repo work is coordinated, not owned, by a dedicated project repo when it does not belong to one product.</li></ul>
|
||||
<h3>1.2 Quality Goals</h3>
|
||||
<ol><li>Rebuildability — State Hub can be reconstructed from registered repository files (ADR-001).</li><li>Concept ownership — canons import, they do not redefine (ADR-006).</li><li>Permanence of published policy addresses (policy-nexus ADR-0001).</li><li>Honest currency — stale documents are visibly stale.</li></ol>
|
||||
<h3>1.3 Stakeholders</h3>
|
||||
<div class="scroll"><table><thead><tr><th>Role</th><th>Concern</th></tr></thead><tbody><tr><td>Operator</td><td>What must be discussed in person; ratification.</td></tr><tr><td>the-custodian</td><td>Canon, values, constitution, estate ADRs.</td></tr><tr><td>Product repos</td><td>Implementation and per-repo ADRs.</td></tr><tr><td>railiance-platform</td><td>Substrate: DNS, TLS, ingress, hosting.</td></tr><tr><td>policy-nexus</td><td>Publication only.</td></tr><tr><td>info-tech-canon</td><td>Semantic model, not this estate's building blocks.</td></tr></tbody></table></div>
|
||||
</section>
|
||||
<section id="s2"><h2><span class="sn">02</span>Architecture Constraints</h2>
|
||||
<p>N/A in this revision — local-first files, no second source of truth, stdlib-preferring tooling, single-node rail availability. To be written as first-wave complete.</p>
|
||||
</section>
|
||||
<section id="s3"><h2><span class="sn">03</span>System Scope and Context</h2>
|
||||
<p><strong>In:</strong> estate canon (<code>constitution</code>, <code>standards</code>, <code>architecture</code> ADRs), the federation of canons, the publication contract, the hub-as-read-model rule, and the map of first-wave systems.</p>
|
||||
<p><strong>Out:</strong> product implementation, InfoTechCanon's landscape model, regulatory intake (<code>risk-nexus</code>), and per-system deployment detail (those belong in the system arc42).</p>
|
||||
<h3>3.1 Business Context</h3>
|
||||
<p>The estate is a set of repositories that together run Coulomb products and the agent work-factory. Readers need one map of what governs what. Owners need a place that is not also the implementation.</p>
|
||||
<h3>3.2 Technical Context</h3>
|
||||
<div class="scroll"><table><thead><tr><th>Neighbour</th><th>Interface</th></tr></thead><tbody><tr><td>Owning git repos</td><td>Source of workplans, ADRs, canon.</td></tr><tr><td>State Hub</td><td>Derived index / cache of those files.</td></tr><tr><td>policy.coulomb.social</td><td>Generated publication of canon and ADRs.</td></tr><tr><td>Railiance reef</td><td>Runtime for hubs, rApps, Forgejo.</td></tr><tr><td>NetKingdom</td><td>Identity, tenancy, IAM profile.</td></tr><tr><td>info-tech-canon</td><td>Imported semantics, not estate structure.</td></tr></tbody></table></div>
|
||||
</section>
|
||||
<section id="s4"><h2><span class="sn">04</span>Solution Strategy</h2>
|
||||
<ul><li><strong>Files first.</strong> Workplans and ADRs are markdown in git. The hub rebuilds from them (ADR-001, ADR-003).</li><li><strong>One registrar.</strong> Workplan identifiers are globally unique; this workstation is not the registrar (ADR-007).</li><li><strong>Three canons, federated.</strong> Custodian (governance), InfoTechCanon (information-system semantics), CommerceCanon (counterparty semantics). They import, they do not redefine (ADR-006).</li><li><strong>Publish, do not author.</strong> policy-nexus reads owning repos and emits static addresses. It never writes back.</li><li><strong>Project repos for cross-repo work</strong> (<code>prj-*</code>), not an unbound hub workplan (ADR-005).</li></ul>
|
||||
</section>
|
||||
<section id="s5"><h2><span class="sn">05</span>Building Block View</h2>
|
||||
<h3>5.1 Level 1 – System/Top-Level</h3>
|
||||
<pre> ┌─────────────────────────┐
|
||||
│ the-custodian │
|
||||
│ constitution, values, │
|
||||
│ estate ADRs, memory │
|
||||
└────────────┬────────────┘
|
||||
┌─────────────────────┼─────────────────────┐
|
||||
▼ ▼ ▼
|
||||
┌───────────────┐ ┌────────────────┐ ┌─────────────────┐
|
||||
│ info-tech- │ │ commerce-canon │ │ net-kingdom │
|
||||
│ canon │ │ │ │ (identity / │
|
||||
│ (semantics) │ │ │ │ tenancy) │
|
||||
└───────────────┘ └────────────────┘ └────────┬────────┘
|
||||
│
|
||||
┌───────────────┐ ┌────────────────┐ │
|
||||
│ state-hub │◄───│ product repos │◄────────────┘
|
||||
│ (read model) │ │ + project repos│
|
||||
└───────────────┘ └────────┬───────┘
|
||||
│
|
||||
┌────────────┴────────────┐
|
||||
▼ ▼
|
||||
┌────────────────┐ ┌─────────────────┐
|
||||
│ railiance │ │ policy-nexus │
|
||||
│ (reef, rApps) │ │ (publication) │
|
||||
└────────────────┘ └─────────────────┘</pre>
|
||||
<h3>5.2 Level 2 – Key Components</h3>
|
||||
<p>N/A in this revision.</p>
|
||||
<h3>5.3 Level 3 – Internal Structure (as needed)</h3>
|
||||
<p>N/A in this revision.</p>
|
||||
</section>
|
||||
<section id="s6"><h2><span class="sn">06</span>Runtime View</h2>
|
||||
<p>N/A — estate coordination is file sync plus hub rebuild, not a single runtime scenario. System runtimes belong in their own arc42.</p>
|
||||
</section>
|
||||
<section id="s7"><h2><span class="sn">07</span>Deployment View</h2>
|
||||
<p>N/A — Railiance owns where things run. This document names the substrate; it does not map nodes.</p>
|
||||
</section>
|
||||
<section id="s8"><h2><span class="sn">08</span>Cross-Cutting Concepts</h2>
|
||||
<p>N/A in this revision. Concept ownership and the hub/cache split are already in §4 and the ADRs in §9.</p>
|
||||
</section>
|
||||
<section id="s9"><h2><span class="sn">09</span>Architecture Decisions</h2>
|
||||
<p>Estate ADRs in <code>the-custodian/canon/architecture/</code>. Publication ids still need repo prefixes (WP-0003). Status is the source front-matter.</p>
|
||||
<div class="scroll"><table><thead><tr><th>Source</th><th>Status</th><th>Decision</th></tr></thead><tbody><tr><td><code>adr-001-workplans-as-repo-artefacts.md</code></td><td>accepted</td><td>Workplans and tasks originate as repo files; the hub is a read model.</td></tr><tr><td><code>adr-002-custodian-agent-runtime-design.md</code></td><td>accepted</td><td>Custodian agent runtime design.</td></tr><tr><td><code>adr-003-materialized-derived-state.md</code></td><td>accepted</td><td>Hub state is derived and fingerprint-invalidated.</td></tr><tr><td><code>adr-004-connectivity-first-network-posture.md</code></td><td>accepted</td><td>Connectivity-first network posture.</td></tr><tr><td><code>adr-005-cross-repo-workplans-project-repos.md</code></td><td>accepted</td><td>Cross-repo work lives in a <code>prj-*</code> repo.</td></tr><tr><td><code>adr-006-canon-federation-concept-ownership.md</code></td><td>accepted</td><td>Three canons; import, do not redefine.</td></tr><tr><td><code>adr-007-workplan-identity-and-repo-worker-topology.md</code></td><td>accepted</td><td>Globally unique workplan ids; one registrar.</td></tr><tr><td><code>adr-008-multi-tenancy-model.md</code></td><td>superseded</td><td>Relocated to NetKingdom Tenancy Posture.</td></tr><tr><td><code>adr-010-hub-authority-and-local-cache-model.md</code></td><td>proposed</td><td>Two kinds of hub data; local cache vs authority.</td></tr><tr><td><code>adr-011-federated-namespaces-and-reconciliation-limits.md</code></td><td>proposed</td><td>Federated namespaces and reconciliation limits.</td></tr></tbody></table></div>
|
||||
<p>Related, not estate-owned: policy-nexus ADR-0001 (addressing), NetKingdom Tenancy Posture (published), railiance-master ADR-0001–0008 (published).</p>
|
||||
<p>Unresolved WP-0003 conflicts (hosts/infra duplicate ADR-003/004, coulomb-social ADR-0002 partial supersession) are <strong>not</strong> listed as current.</p>
|
||||
</section>
|
||||
<section id="s10"><h2><span class="sn">10</span>Quality Requirements</h2>
|
||||
<p>N/A in this revision — rebuildability and currency already have mechanical checks (<code>fix-consistency</code>, <code>make currency</code>).</p>
|
||||
</section>
|
||||
<section id="s11"><h2><span class="sn">11</span>Risks and Technical Debt</h2>
|
||||
<p>N/A in this revision. Known residual: this workstation cannot mint hub UUIDs (ADR-007 registrar). Markitect <code>arc42-v1</code> is not registered yet.</p>
|
||||
</section>
|
||||
<section id="s12"><h2><span class="sn">12</span>Glossary</h2>
|
||||
<div class="scroll"><table><thead><tr><th>Term</th><th>Meaning</th></tr></thead><tbody><tr><td>Estate</td><td>The set of Coulomb / Custodian repos, canons, hubs, and rails.</td></tr><tr><td>Canon</td><td>Governing documents owned by one of the three federated canons.</td></tr><tr><td>Read model</td><td>A derived index. Never the origin of work or decisions.</td></tr><tr><td>Publication entry</td><td>One explicit object in policy-nexus <code>publication.json</code>.</td></tr><tr><td>First-wave complete</td><td>Chapters 1, 3, 4, 5.1, 9 and 12 are real; others real or N/A.</td></tr><tr><td>Project repo</td><td>A <code>prj-*</code> repo that coordinates cross-repo work (ADR-005).</td></tr></tbody></table></div>
|
||||
</section><footer><span>coulomb-estate-architecture · draft-1 · proposed</span><span>the-custodian · canon/architecture/coulomb-estate_v0.1.md · 5b51623198d9959793762f447f5813960c0b5df8</span></footer></main></div></div></html>
|
||||
|
|
@ -0,0 +1,274 @@
|
|||
<!doctype html>
|
||||
<html lang="en"><meta charset="utf-8">
|
||||
<meta name="policy-source-revision" content="5b51623198d9959793762f447f5813960c0b5df8">
|
||||
<meta name="policy-source-digest" content="0ab59ab79931e19615648da435e4a636836904a1189f5b53e3ee8467bea49841">
|
||||
<title>Coulomb estate 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>coulomb-estate-architecture</span> <span class="stat">proposed · draft-1</span> <span>the-custodian</span> <span>reviewed 2026-08-18</span><span>generated from canonical source — do not edit</span></div><h1>Coulomb estate architecture</h1><p class="sub">Source: <code>the-custodian · canon/architecture/coulomb-estate_v0.1.md · 5b51623198d9959793762f447f5813960c0b5df8</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="#about-this-document"><span class="n">·</span>About this document</a></li><li><a href="#s1"><span class="n">1</span>Introduction and Goals</a></li><li><a href="#s2"><span class="n">2</span>Architecture Constraints</a></li><li><a href="#s3"><span class="n">3</span>System Scope and Context</a></li><li><a href="#s4"><span class="n">4</span>Solution Strategy</a></li><li><a href="#s5"><span class="n">5</span>Building Block View</a></li><li><a href="#s6"><span class="n">6</span>Runtime View</a></li><li><a href="#s7"><span class="n">7</span>Deployment View</a></li><li><a href="#s8"><span class="n">8</span>Cross-Cutting Concepts</a></li><li><a href="#s9"><span class="n">9</span>Architecture Decisions</a></li><li><a href="#s10"><span class="n">10</span>Quality Requirements</a></li><li><a href="#s11"><span class="n">11</span>Risks and Technical Debt</a></li><li><a href="#s12"><span class="n">12</span>Glossary</a></li></ol></nav><main><section id="about-this-document"><h2>About this document</h2>
|
||||
<p>This is the first-wave <strong>estate map</strong>. It describes how the Coulomb / Custodian estate is put together: canons, hubs, rails, and publication. System-level arc42 documents (Railiance, NetKingdom, State Hub, Policy Nexus) live in their owning repos. Chapter 9 lists estate ADRs; it does not paste them.</p>
|
||||
</section>
|
||||
<section id="s1"><h2><span class="sn">01</span>Introduction and Goals</h2>
|
||||
<p>the-custodian holds meaning, boundaries, and continuity for a local-first agent estate. Implementation lives in product repos. Coordination state is a read-model of repository files, not the origin of those files.</p>
|
||||
<h3>1.1 Requirements Overview</h3>
|
||||
<ul><li>Work, decisions, and canon originate as files in the owning repo.</li><li>A publication surface keeps governing documents at permanent URLs.</li><li>Runtime (Rails, rApps, identity, storage) is consumed from platform packages, not reimplemented in the custodian.</li><li>Cross-repo work is coordinated, not owned, by a dedicated project repo when it does not belong to one product.</li></ul>
|
||||
<h3>1.2 Quality Goals</h3>
|
||||
<ol><li>Rebuildability — State Hub can be reconstructed from registered repository files (ADR-001).</li><li>Concept ownership — canons import, they do not redefine (ADR-006).</li><li>Permanence of published policy addresses (policy-nexus ADR-0001).</li><li>Honest currency — stale documents are visibly stale.</li></ol>
|
||||
<h3>1.3 Stakeholders</h3>
|
||||
<div class="scroll"><table><thead><tr><th>Role</th><th>Concern</th></tr></thead><tbody><tr><td>Operator</td><td>What must be discussed in person; ratification.</td></tr><tr><td>the-custodian</td><td>Canon, values, constitution, estate ADRs.</td></tr><tr><td>Product repos</td><td>Implementation and per-repo ADRs.</td></tr><tr><td>railiance-platform</td><td>Substrate: DNS, TLS, ingress, hosting.</td></tr><tr><td>policy-nexus</td><td>Publication only.</td></tr><tr><td>info-tech-canon</td><td>Semantic model, not this estate's building blocks.</td></tr></tbody></table></div>
|
||||
</section>
|
||||
<section id="s2"><h2><span class="sn">02</span>Architecture Constraints</h2>
|
||||
<p>N/A in this revision — local-first files, no second source of truth, stdlib-preferring tooling, single-node rail availability. To be written as first-wave complete.</p>
|
||||
</section>
|
||||
<section id="s3"><h2><span class="sn">03</span>System Scope and Context</h2>
|
||||
<p><strong>In:</strong> estate canon (<code>constitution</code>, <code>standards</code>, <code>architecture</code> ADRs), the federation of canons, the publication contract, the hub-as-read-model rule, and the map of first-wave systems.</p>
|
||||
<p><strong>Out:</strong> product implementation, InfoTechCanon's landscape model, regulatory intake (<code>risk-nexus</code>), and per-system deployment detail (those belong in the system arc42).</p>
|
||||
<h3>3.1 Business Context</h3>
|
||||
<p>The estate is a set of repositories that together run Coulomb products and the agent work-factory. Readers need one map of what governs what. Owners need a place that is not also the implementation.</p>
|
||||
<h3>3.2 Technical Context</h3>
|
||||
<div class="scroll"><table><thead><tr><th>Neighbour</th><th>Interface</th></tr></thead><tbody><tr><td>Owning git repos</td><td>Source of workplans, ADRs, canon.</td></tr><tr><td>State Hub</td><td>Derived index / cache of those files.</td></tr><tr><td>policy.coulomb.social</td><td>Generated publication of canon and ADRs.</td></tr><tr><td>Railiance reef</td><td>Runtime for hubs, rApps, Forgejo.</td></tr><tr><td>NetKingdom</td><td>Identity, tenancy, IAM profile.</td></tr><tr><td>info-tech-canon</td><td>Imported semantics, not estate structure.</td></tr></tbody></table></div>
|
||||
</section>
|
||||
<section id="s4"><h2><span class="sn">04</span>Solution Strategy</h2>
|
||||
<ul><li><strong>Files first.</strong> Workplans and ADRs are markdown in git. The hub rebuilds from them (ADR-001, ADR-003).</li><li><strong>One registrar.</strong> Workplan identifiers are globally unique; this workstation is not the registrar (ADR-007).</li><li><strong>Three canons, federated.</strong> Custodian (governance), InfoTechCanon (information-system semantics), CommerceCanon (counterparty semantics). They import, they do not redefine (ADR-006).</li><li><strong>Publish, do not author.</strong> policy-nexus reads owning repos and emits static addresses. It never writes back.</li><li><strong>Project repos for cross-repo work</strong> (<code>prj-*</code>), not an unbound hub workplan (ADR-005).</li></ul>
|
||||
</section>
|
||||
<section id="s5"><h2><span class="sn">05</span>Building Block View</h2>
|
||||
<h3>5.1 Level 1 – System/Top-Level</h3>
|
||||
<pre> ┌─────────────────────────┐
|
||||
│ the-custodian │
|
||||
│ constitution, values, │
|
||||
│ estate ADRs, memory │
|
||||
└────────────┬────────────┘
|
||||
┌─────────────────────┼─────────────────────┐
|
||||
▼ ▼ ▼
|
||||
┌───────────────┐ ┌────────────────┐ ┌─────────────────┐
|
||||
│ info-tech- │ │ commerce-canon │ │ net-kingdom │
|
||||
│ canon │ │ │ │ (identity / │
|
||||
│ (semantics) │ │ │ │ tenancy) │
|
||||
└───────────────┘ └────────────────┘ └────────┬────────┘
|
||||
│
|
||||
┌───────────────┐ ┌────────────────┐ │
|
||||
│ state-hub │◄───│ product repos │◄────────────┘
|
||||
│ (read model) │ │ + project repos│
|
||||
└───────────────┘ └────────┬───────┘
|
||||
│
|
||||
┌────────────┴────────────┐
|
||||
▼ ▼
|
||||
┌────────────────┐ ┌─────────────────┐
|
||||
│ railiance │ │ policy-nexus │
|
||||
│ (reef, rApps) │ │ (publication) │
|
||||
└────────────────┘ └─────────────────┘</pre>
|
||||
<h3>5.2 Level 2 – Key Components</h3>
|
||||
<p>N/A in this revision.</p>
|
||||
<h3>5.3 Level 3 – Internal Structure (as needed)</h3>
|
||||
<p>N/A in this revision.</p>
|
||||
</section>
|
||||
<section id="s6"><h2><span class="sn">06</span>Runtime View</h2>
|
||||
<p>N/A — estate coordination is file sync plus hub rebuild, not a single runtime scenario. System runtimes belong in their own arc42.</p>
|
||||
</section>
|
||||
<section id="s7"><h2><span class="sn">07</span>Deployment View</h2>
|
||||
<p>N/A — Railiance owns where things run. This document names the substrate; it does not map nodes.</p>
|
||||
</section>
|
||||
<section id="s8"><h2><span class="sn">08</span>Cross-Cutting Concepts</h2>
|
||||
<p>N/A in this revision. Concept ownership and the hub/cache split are already in §4 and the ADRs in §9.</p>
|
||||
</section>
|
||||
<section id="s9"><h2><span class="sn">09</span>Architecture Decisions</h2>
|
||||
<p>Estate ADRs in <code>the-custodian/canon/architecture/</code>. Publication ids still need repo prefixes (WP-0003). Status is the source front-matter.</p>
|
||||
<div class="scroll"><table><thead><tr><th>Source</th><th>Status</th><th>Decision</th></tr></thead><tbody><tr><td><code>adr-001-workplans-as-repo-artefacts.md</code></td><td>accepted</td><td>Workplans and tasks originate as repo files; the hub is a read model.</td></tr><tr><td><code>adr-002-custodian-agent-runtime-design.md</code></td><td>accepted</td><td>Custodian agent runtime design.</td></tr><tr><td><code>adr-003-materialized-derived-state.md</code></td><td>accepted</td><td>Hub state is derived and fingerprint-invalidated.</td></tr><tr><td><code>adr-004-connectivity-first-network-posture.md</code></td><td>accepted</td><td>Connectivity-first network posture.</td></tr><tr><td><code>adr-005-cross-repo-workplans-project-repos.md</code></td><td>accepted</td><td>Cross-repo work lives in a <code>prj-*</code> repo.</td></tr><tr><td><code>adr-006-canon-federation-concept-ownership.md</code></td><td>accepted</td><td>Three canons; import, do not redefine.</td></tr><tr><td><code>adr-007-workplan-identity-and-repo-worker-topology.md</code></td><td>accepted</td><td>Globally unique workplan ids; one registrar.</td></tr><tr><td><code>adr-008-multi-tenancy-model.md</code></td><td>superseded</td><td>Relocated to NetKingdom Tenancy Posture.</td></tr><tr><td><code>adr-010-hub-authority-and-local-cache-model.md</code></td><td>proposed</td><td>Two kinds of hub data; local cache vs authority.</td></tr><tr><td><code>adr-011-federated-namespaces-and-reconciliation-limits.md</code></td><td>proposed</td><td>Federated namespaces and reconciliation limits.</td></tr></tbody></table></div>
|
||||
<p>Related, not estate-owned: policy-nexus ADR-0001 (addressing), NetKingdom Tenancy Posture (published), railiance-master ADR-0001–0008 (published).</p>
|
||||
<p>Unresolved WP-0003 conflicts (hosts/infra duplicate ADR-003/004, coulomb-social ADR-0002 partial supersession) are <strong>not</strong> listed as current.</p>
|
||||
</section>
|
||||
<section id="s10"><h2><span class="sn">10</span>Quality Requirements</h2>
|
||||
<p>N/A in this revision — rebuildability and currency already have mechanical checks (<code>fix-consistency</code>, <code>make currency</code>).</p>
|
||||
</section>
|
||||
<section id="s11"><h2><span class="sn">11</span>Risks and Technical Debt</h2>
|
||||
<p>N/A in this revision. Known residual: this workstation cannot mint hub UUIDs (ADR-007 registrar). Markitect <code>arc42-v1</code> is not registered yet.</p>
|
||||
</section>
|
||||
<section id="s12"><h2><span class="sn">12</span>Glossary</h2>
|
||||
<div class="scroll"><table><thead><tr><th>Term</th><th>Meaning</th></tr></thead><tbody><tr><td>Estate</td><td>The set of Coulomb / Custodian repos, canons, hubs, and rails.</td></tr><tr><td>Canon</td><td>Governing documents owned by one of the three federated canons.</td></tr><tr><td>Read model</td><td>A derived index. Never the origin of work or decisions.</td></tr><tr><td>Publication entry</td><td>One explicit object in policy-nexus <code>publication.json</code>.</td></tr><tr><td>First-wave complete</td><td>Chapters 1, 3, 4, 5.1, 9 and 12 are real; others real or N/A.</td></tr><tr><td>Project repo</td><td>A <code>prj-*</code> repo that coordinates cross-repo work (ADR-005).</td></tr></tbody></table></div>
|
||||
</section><footer><span>coulomb-estate-architecture · draft-1 · proposed</span><span>the-custodian · canon/architecture/coulomb-estate_v0.1.md · 5b51623198d9959793762f447f5813960c0b5df8</span></footer></main></div></div></html>
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
<!doctype html>
|
||||
<html lang="en"><meta charset="utf-8">
|
||||
<meta name="policy-source-revision" content="a8fb62a3bcbff3daf03e5d3d56c3ca3a5bd991f8">
|
||||
<meta name="policy-source-revision" content="9c6a1d3ce0a76b3cbd342ab74d3914aa339fd4e0">
|
||||
<meta name="policy-source-digest" content="179cbb86bca95f71f46f51ca1971ff1c274eed7d900adf0672b537d4bcc5b480">
|
||||
<title>Policy Nexus architecture</title>
|
||||
<style>
|
||||
|
|
@ -191,7 +191,7 @@ a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-off
|
|||
@media (prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}}
|
||||
|
||||
</style>
|
||||
<div class="wrap"><header><div class="eyebrow"><span>policy-nexus-architecture</span> <span class="stat">proposed · draft-1</span> <span>the-custodian</span> <span>reviewed 2026-08-18</span><span>generated from canonical source — do not edit</span></div><h1>Policy Nexus architecture</h1><p class="sub">Source: <code>policy-nexus · docs/architecture/policy-nexus_v0.1.md · a8fb62a3bcbff3daf03e5d3d56c3ca3a5bd991f8</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="#about-this-document"><span class="n">·</span>About this document</a></li><li><a href="#s1"><span class="n">1</span>Introduction and Goals</a></li><li><a href="#s2"><span class="n">2</span>Architecture Constraints</a></li><li><a href="#s3"><span class="n">3</span>System Scope and Context</a></li><li><a href="#s4"><span class="n">4</span>Solution Strategy</a></li><li><a href="#s5"><span class="n">5</span>Building Block View</a></li><li><a href="#s6"><span class="n">6</span>Runtime View</a></li><li><a href="#s7"><span class="n">7</span>Deployment View</a></li><li><a href="#s8"><span class="n">8</span>Cross-Cutting Concepts</a></li><li><a href="#s9"><span class="n">9</span>Architecture Decisions</a></li><li><a href="#s10"><span class="n">10</span>Quality Requirements</a></li><li><a href="#s11"><span class="n">11</span>Risks and Technical Debt</a></li><li><a href="#s12"><span class="n">12</span>Glossary</a></li></ol></nav><main><section id="about-this-document"><h2>About this document</h2>
|
||||
<div class="wrap"><header><div class="eyebrow"><span>policy-nexus-architecture</span> <span class="stat">proposed · draft-1</span> <span>the-custodian</span> <span>reviewed 2026-08-18</span><span>generated from canonical source — do not edit</span></div><h1>Policy Nexus architecture</h1><p class="sub">Source: <code>policy-nexus · docs/architecture/policy-nexus_v0.1.md · 9c6a1d3ce0a76b3cbd342ab74d3914aa339fd4e0</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="#about-this-document"><span class="n">·</span>About this document</a></li><li><a href="#s1"><span class="n">1</span>Introduction and Goals</a></li><li><a href="#s2"><span class="n">2</span>Architecture Constraints</a></li><li><a href="#s3"><span class="n">3</span>System Scope and Context</a></li><li><a href="#s4"><span class="n">4</span>Solution Strategy</a></li><li><a href="#s5"><span class="n">5</span>Building Block View</a></li><li><a href="#s6"><span class="n">6</span>Runtime View</a></li><li><a href="#s7"><span class="n">7</span>Deployment View</a></li><li><a href="#s8"><span class="n">8</span>Cross-Cutting Concepts</a></li><li><a href="#s9"><span class="n">9</span>Architecture Decisions</a></li><li><a href="#s10"><span class="n">10</span>Quality Requirements</a></li><li><a href="#s11"><span class="n">11</span>Risks and Technical Debt</a></li><li><a href="#s12"><span class="n">12</span>Glossary</a></li></ol></nav><main><section id="about-this-document"><h2>About this document</h2>
|
||||
<p>This document follows the <strong>arc42</strong> template for the publication surface at <code>policy.coulomb.social</code>. It is the first-wave architecture document this repository is allowed to author. Other first-wave systems are written in their owning repos.</p>
|
||||
</section>
|
||||
<section id="s1"><h2><span class="sn">01</span>Introduction and Goals</h2>
|
||||
|
|
@ -245,4 +245,4 @@ a:focus-visible,.rail a:focus-visible{outline:2px solid var(--brass);outline-off
|
|||
</section>
|
||||
<section id="s12"><h2><span class="sn">12</span>Glossary</h2>
|
||||
<div class="scroll"><table><thead><tr><th>Term</th><th>Meaning</th></tr></thead><tbody><tr><td>Current address</td><td>The stable URL for the document as it now stands.</td></tr><tr><td>Revision address</td><td>Write-once URL for one source digest.</td></tr><tr><td>Publication entry</td><td>One object in <code>publication.json</code>. Discovery is not publication.</td></tr><tr><td>First-wave complete</td><td>Chapters 1, 3, 4, 5.1, 9 and 12 are real; others real or N/A.</td></tr></tbody></table></div>
|
||||
</section><footer><span>policy-nexus-architecture · draft-1 · proposed</span><span>policy-nexus · docs/architecture/policy-nexus_v0.1.md · a8fb62a3bcbff3daf03e5d3d56c3ca3a5bd991f8</span></footer></main></div></div></html>
|
||||
</section><footer><span>policy-nexus-architecture · draft-1 · proposed</span><span>policy-nexus · docs/architecture/policy-nexus_v0.1.md · 9c6a1d3ce0a76b3cbd342ab74d3914aa339fd4e0</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}
|
||||
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 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="/architecture/policy-nexus/v0.1/index.html">Policy Nexus architecture</a></td><td>proposed</td><td>active</td><td>draft-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/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>
|
||||
</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="/architecture/coulomb-estate/v0.1/index.html">Coulomb estate architecture</a></td><td>proposed</td><td>active</td><td>draft-1</td><td>the-custodian</td><td>2026-08-18</td><td>2027-02-18</td><td>current</td></tr><tr><td><a href="/architecture/policy-nexus/v0.1/index.html">Policy Nexus architecture</a></td><td>proposed</td><td>active</td><td>draft-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/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>
|
||||
|
|
|
|||
|
|
@ -17,6 +17,23 @@
|
|||
"status": "proposed",
|
||||
"title": "NetKingdom Tenancy Posture v0.1"
|
||||
},
|
||||
{
|
||||
"canonical_path": "architecture/coulomb-estate/v0.1/index.html",
|
||||
"currency": "current",
|
||||
"id": "coulomb-estate-architecture",
|
||||
"last_reviewed": "2026-08-18",
|
||||
"lifecycle": "active",
|
||||
"owner": "the-custodian",
|
||||
"review_due": "2027-02-18",
|
||||
"revision": "draft-1",
|
||||
"revision_path": "architecture/coulomb-estate/v0.1/revisions/draft-1/index.html",
|
||||
"source_digest": "0ab59ab79931e19615648da435e4a636836904a1189f5b53e3ee8467bea49841",
|
||||
"source_path": "canon/architecture/coulomb-estate_v0.1.md",
|
||||
"source_repo": "the-custodian",
|
||||
"source_revision": "5b51623198d9959793762f447f5813960c0b5df8",
|
||||
"status": "proposed",
|
||||
"title": "Coulomb estate architecture"
|
||||
},
|
||||
{
|
||||
"canonical_path": "architecture/policy-nexus/v0.1/index.html",
|
||||
"currency": "current",
|
||||
|
|
@ -30,7 +47,7 @@
|
|||
"source_digest": "179cbb86bca95f71f46f51ca1971ff1c274eed7d900adf0672b537d4bcc5b480",
|
||||
"source_path": "docs/architecture/policy-nexus_v0.1.md",
|
||||
"source_repo": "policy-nexus",
|
||||
"source_revision": "a8fb62a3bcbff3daf03e5d3d56c3ca3a5bd991f8",
|
||||
"source_revision": "9c6a1d3ce0a76b3cbd342ab74d3914aa339fd4e0",
|
||||
"status": "proposed",
|
||||
"title": "Policy Nexus architecture"
|
||||
},
|
||||
|
|
@ -47,7 +64,7 @@
|
|||
"source_digest": "a28668fb4b8b6c5ec8c94baac000061276d85ef1849ec7ab8d132b913dbfe3be",
|
||||
"source_path": "docs/adr/ADR-0001-addressing-and-permanence.md",
|
||||
"source_repo": "policy-nexus",
|
||||
"source_revision": "a8fb62a3bcbff3daf03e5d3d56c3ca3a5bd991f8",
|
||||
"source_revision": "9c6a1d3ce0a76b3cbd342ab74d3914aa339fd4e0",
|
||||
"status": "accepted",
|
||||
"title": "Policy addressing and permanence"
|
||||
},
|
||||
|
|
|
|||
|
|
@ -1,18 +1,20 @@
|
|||
# ADR review ledger summary
|
||||
|
||||
Rows: 126
|
||||
Rows: 127
|
||||
|
||||
## Inventory dispositions
|
||||
|
||||
- `excluded`: 2
|
||||
- `metadata-pending`: 105
|
||||
- `published`: 11
|
||||
- `published`: 12
|
||||
- `unsupported-format`: 8
|
||||
|
||||
## Proposed dispositions
|
||||
|
||||
- `publish`: 9
|
||||
- `unreviewed`: 117
|
||||
- `conflict`: 5
|
||||
- `publish`: 27
|
||||
- `superseded`: 5
|
||||
- `unreviewed`: 90
|
||||
|
||||
## Front-matter `id` collisions
|
||||
|
||||
|
|
@ -37,6 +39,14 @@ Rows: 126
|
|||
- `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
|
||||
|
||||
## Conflict rows
|
||||
|
||||
- `coulomb-social/docs/adr/ADR-0002-space-content-forgejo-markdown.md` (kinds 2): Status is 'superseded in part' by ADR-0003/0004. Not a clean superseded or accepted. Who rules: coulomb-social.
|
||||
- `railiance-hosts/docs/adr/ADR-003-railiance-5repo-stack-architecture.md` (kinds 6): Accepted 5-repo stack ADR is byte-identical in railiance-hosts and railiance-infra. Two current copies of one decision. Who rules: those two repos, or railiance-master if the stack story moved.
|
||||
- `railiance-hosts/docs/adr/ADR-004-forgejo-in-cluster-actions-runner.md` (kinds 6): Accepted Forgejo runner ADR is byte-identical in railiance-hosts and railiance-infra. Who rules: those two repos.
|
||||
- `railiance-infra/docs/adr/ADR-003-railiance-5repo-stack-architecture.md` (kinds 6): Identical accepted copy of the hosts ADR-003. Do not publish both.
|
||||
- `railiance-infra/docs/adr/ADR-004-forgejo-in-cluster-actions-runner.md` (kinds 6): Identical accepted copy of the hosts ADR-004. Do not publish both.
|
||||
|
||||
## Missing files
|
||||
|
||||
None.
|
||||
|
|
|
|||
60
docs/adr-review/conflicts.md
Normal file
60
docs/adr-review/conflicts.md
Normal file
|
|
@ -0,0 +1,60 @@
|
|||
# ADR conflict pass (WP-0003-T03)
|
||||
|
||||
Kinds 1–4 and 6. Kind 5 waits on the estate arc42 chapter 9. Rulings
|
||||
live in `rulings.json` and survive a ledger refresh.
|
||||
|
||||
## How kind 1 is treated
|
||||
|
||||
A shared **front-matter `id`** (`ADR-001` in four repos, `ADR-0001` in
|
||||
three, `netkingdom-iam-profile` on two files) cannot appear twice in
|
||||
`publication.json`. That is a prefix/rename packet, not a contradiction
|
||||
of decisions. The ledger records kind `1` automatically. Disposition
|
||||
stays `publish` or `unreviewed` unless another kind applies.
|
||||
|
||||
Bare `ADR-NNNN` in many filenames is expected. It is not kind 1.
|
||||
|
||||
## Kind 2 — status lie
|
||||
|
||||
| Source | What the files say | Who rules |
|
||||
| --- | --- | --- |
|
||||
| `net-kingdom/canon/standards/iam-profile_v0.2.md` | Front-matter `accepted`. v0.3 says it supersedes v0.2. | net-kingdom |
|
||||
| `railiance-hosts` and `railiance-infra` `ADR-002` | Body **Status: Superseded by ADR-003**. No YAML `status`. | those repos |
|
||||
| `coulomb-social/docs/adr/ADR-0002-…` | Status is **superseded in part** by ADR-0003/0004. | coulomb-social |
|
||||
|
||||
Mentions of “supersedes” meaning *this* ADR replaces an older one (flex-auth
|
||||
0003, artifact-store 0001, glas-harness 001) are not status lies.
|
||||
|
||||
## Kind 3 — missing / stale successor
|
||||
|
||||
| Source | Gap | Who rules |
|
||||
| --- | --- | --- |
|
||||
| `the-custodian/canon/standards/iam-profile_v0.1.md` | `superseded_by` still names v0.2; current is v0.3. | the-custodian |
|
||||
|
||||
Custodian ADR-008 already names Tenancy Posture. No gap.
|
||||
|
||||
## Kind 4 — contradicting decisions
|
||||
|
||||
No pair of *accepted* ADRs was found that cannot both be true.
|
||||
railiance-platform ADR-0003 restates custodian ADR-001 (hub is a read
|
||||
model). That is alignment, not a clash.
|
||||
|
||||
## Kind 6 — duplicate current claim
|
||||
|
||||
| Sources | Claim | Who rules |
|
||||
| --- | --- | --- |
|
||||
| custodian ADR-008 vs Tenancy Posture | Multi-tenancy framework. ADR-008 is already superseded. T04: `superseded`. | already ruled in the source |
|
||||
| iam-profile v0.2 and v0.3 | Same `id`, both `accepted`. T04: v0.2 `superseded`, v0.3 `publish` after id fix. | net-kingdom |
|
||||
| railiance-hosts and railiance-infra ADR-002 | Identical superseded copies. | those repos (historical only) |
|
||||
| railiance-hosts and railiance-infra ADR-003 | Identical **accepted** 5-repo stack ADR. **Conflict.** | those repos or railiance-master |
|
||||
| railiance-hosts and railiance-infra ADR-004 | Identical **accepted** Forgejo runner ADR. **Conflict.** | those repos |
|
||||
|
||||
## Conflict rows that stay unpublished
|
||||
|
||||
Until the owner rules:
|
||||
|
||||
1. `railiance-hosts` / `railiance-infra` ADR-003
|
||||
2. `railiance-hosts` / `railiance-infra` ADR-004
|
||||
3. `coulomb-social` ADR-0002 (partial supersession)
|
||||
|
||||
Kind 5 (architecture miss) is not run yet. It starts when
|
||||
`coulomb-estate_v0.1.md` chapter 9 exists.
|
||||
|
|
@ -41,8 +41,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Cross-repo event bridge. Id ACT-ADR-001 is unique. Needs owner/revision/review front-matter.",
|
||||
"source_path": "docs/adr/adr-001-event-bridge-architecture.md",
|
||||
"source_repo": "activity-core",
|
||||
"successor": ""
|
||||
|
|
@ -85,8 +85,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Cross-repo definition format. Unique id. Needs owner/revision/review.",
|
||||
"source_path": "docs/adr/adr-002-definition-format.md",
|
||||
"source_repo": "activity-core",
|
||||
"successor": ""
|
||||
|
|
@ -127,8 +127,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Cross-repo rule/instruction split. Unique id. Needs owner/revision/review.",
|
||||
"source_path": "docs/adr/adr-003-rule-instruction-model.md",
|
||||
"source_repo": "activity-core",
|
||||
"successor": ""
|
||||
|
|
@ -168,8 +168,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Cross-repo producer trust boundary. Unique id. Needs owner/revision/review.",
|
||||
"source_path": "docs/adr/adr-004-producer-trust-boundary.md",
|
||||
"source_repo": "activity-core",
|
||||
"successor": ""
|
||||
|
|
@ -204,8 +204,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Cross-repo ops-run vs work-record split. Unique id. Needs owner/revision/review.",
|
||||
"source_path": "docs/adr/adr-005-ops-runs-vs-dev-work-records.md",
|
||||
"source_repo": "activity-core",
|
||||
"successor": ""
|
||||
|
|
@ -500,7 +500,9 @@
|
|||
"target-revenue/docs/adr/ADR-0001-stage0-library-stack.md",
|
||||
"the-custodian/canon/architecture/adr-001-workplans-as-repo-artefacts.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-001",
|
||||
|
|
@ -527,7 +529,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-001' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-001-workplan-prefix.md",
|
||||
"source_repo": "coulomb-loop",
|
||||
"successor": ""
|
||||
|
|
@ -548,7 +550,9 @@
|
|||
"target-revenue/docs/adr/ADR-0002-hosted-trust-service-stack.md",
|
||||
"the-custodian/canon/architecture/adr-002-custodian-agent-runtime-design.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-002",
|
||||
|
|
@ -574,7 +578,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-002' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-002-customer-supplier-boundary.md",
|
||||
"source_repo": "coulomb-loop",
|
||||
"successor": ""
|
||||
|
|
@ -593,7 +597,9 @@
|
|||
"rapp-postgres/docs/adr/ADR-0003-e3-row-level-security-contract.md",
|
||||
"the-custodian/canon/architecture/adr-003-materialized-derived-state.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-003",
|
||||
|
|
@ -619,7 +625,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-003' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-003-cadence-ramp-policy.md",
|
||||
"source_repo": "coulomb-loop",
|
||||
"successor": ""
|
||||
|
|
@ -637,7 +643,9 @@
|
|||
"rapp-postgres/docs/adr/ADR-0004-platform-pg-cell-ceiling.md",
|
||||
"the-custodian/canon/architecture/adr-004-connectivity-first-network-posture.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-004",
|
||||
|
|
@ -663,7 +671,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-004' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-004-repo-rotation-on-diminishing-returns.md",
|
||||
"source_repo": "coulomb-loop",
|
||||
"successor": ""
|
||||
|
|
@ -686,7 +694,9 @@
|
|||
"target-revenue/docs/adr/ADR-0001-stage0-library-stack.md",
|
||||
"the-custodian/canon/architecture/adr-001-workplans-as-repo-artefacts.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-0001",
|
||||
|
|
@ -712,7 +722,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-0001' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-0001-netkingdom-identity.md",
|
||||
"source_repo": "coulomb-social",
|
||||
"successor": ""
|
||||
|
|
@ -733,7 +743,9 @@
|
|||
"target-revenue/docs/adr/ADR-0002-hosted-trust-service-stack.md",
|
||||
"the-custodian/canon/architecture/adr-002-custodian-agent-runtime-design.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
2
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "",
|
||||
|
|
@ -758,11 +770,11 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "conflict",
|
||||
"review_notes": "Status is 'superseded in part' by ADR-0003/0004. Not a clean superseded or accepted. Who rules: coulomb-social.",
|
||||
"source_path": "docs/adr/ADR-0002-space-content-forgejo-markdown.md",
|
||||
"source_repo": "coulomb-social",
|
||||
"successor": ""
|
||||
"successor": "coulomb-social/docs/adr/ADR-0003-page-centric-markdown-sor.md"
|
||||
},
|
||||
{
|
||||
"bare_adr": "ADR-0003",
|
||||
|
|
@ -1235,7 +1247,9 @@
|
|||
"target-revenue/docs/adr/ADR-0001-stage0-library-stack.md",
|
||||
"the-custodian/canon/architecture/adr-001-workplans-as-repo-artefacts.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-001",
|
||||
|
|
@ -1262,7 +1276,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-001' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-001-workplan-convention.md",
|
||||
"source_repo": "kaizen-agentic",
|
||||
"successor": ""
|
||||
|
|
@ -1283,7 +1297,9 @@
|
|||
"target-revenue/docs/adr/ADR-0002-hosted-trust-service-stack.md",
|
||||
"the-custodian/canon/architecture/adr-002-custodian-agent-runtime-design.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-002",
|
||||
|
|
@ -1309,7 +1325,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-002' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-002-project-memory-convention.md",
|
||||
"source_repo": "kaizen-agentic",
|
||||
"successor": ""
|
||||
|
|
@ -1328,7 +1344,9 @@
|
|||
"rapp-postgres/docs/adr/ADR-0003-e3-row-level-security-contract.md",
|
||||
"the-custodian/canon/architecture/adr-003-materialized-derived-state.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-003",
|
||||
|
|
@ -1354,7 +1372,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-003' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-003-protocols-artifact-convention.md",
|
||||
"source_repo": "kaizen-agentic",
|
||||
"successor": ""
|
||||
|
|
@ -1372,7 +1390,9 @@
|
|||
"rapp-postgres/docs/adr/ADR-0004-platform-pg-cell-ceiling.md",
|
||||
"the-custodian/canon/architecture/adr-004-connectivity-first-network-posture.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-004",
|
||||
|
|
@ -1398,7 +1418,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-004' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-004-project-metrics-convention.md",
|
||||
"source_repo": "kaizen-agentic",
|
||||
"successor": ""
|
||||
|
|
@ -1411,7 +1431,9 @@
|
|||
"railiance-master/docs/adr/ADR-0005-derived-rail-composition.md",
|
||||
"the-custodian/canon/architecture/adr-005-cross-repo-workplans-project-repos.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-005",
|
||||
|
|
@ -1436,7 +1458,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-005' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-005-scheduled-agent-execution.md",
|
||||
"source_repo": "kaizen-agentic",
|
||||
"successor": ""
|
||||
|
|
@ -1535,7 +1557,9 @@
|
|||
"target-revenue/docs/adr/ADR-0001-stage0-library-stack.md",
|
||||
"the-custodian/canon/architecture/adr-001-workplans-as-repo-artefacts.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-0001",
|
||||
|
|
@ -1561,7 +1585,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-0001' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-0001-choose-go-for-keycape.md",
|
||||
"source_repo": "key-cape",
|
||||
"successor": ""
|
||||
|
|
@ -1699,7 +1723,11 @@
|
|||
{
|
||||
"bare_adr": "",
|
||||
"bare_adr_collisions": [],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1,
|
||||
2,
|
||||
6
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "netkingdom-iam-profile",
|
||||
|
|
@ -1722,16 +1750,19 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "superseded",
|
||||
"review_notes": "v0.3 says it supersedes v0.2, but v0.2 is still status accepted and shares id netkingdom-iam-profile. Who rules: net-kingdom (status + unique id).",
|
||||
"source_path": "canon/standards/iam-profile_v0.2.md",
|
||||
"source_repo": "net-kingdom",
|
||||
"successor": ""
|
||||
"successor": "net-kingdom/canon/standards/iam-profile_v0.3.md"
|
||||
},
|
||||
{
|
||||
"bare_adr": "",
|
||||
"bare_adr_collisions": [],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1,
|
||||
6
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "netkingdom-iam-profile",
|
||||
|
|
@ -1754,8 +1785,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Current IAM profile. Cannot publish until id is unique (e.g. netkingdom-iam-profile-v0.3). Who rules: net-kingdom.",
|
||||
"source_path": "canon/standards/iam-profile_v0.3.md",
|
||||
"source_repo": "net-kingdom",
|
||||
"successor": ""
|
||||
|
|
@ -2283,7 +2314,10 @@
|
|||
"target-revenue/docs/adr/ADR-0002-hosted-trust-service-stack.md",
|
||||
"the-custodian/canon/architecture/adr-002-custodian-agent-runtime-design.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
2,
|
||||
6
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "",
|
||||
|
|
@ -2308,11 +2342,11 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "superseded",
|
||||
"review_notes": "Body is superseded by ADR-003. Byte-identical copy also lives in railiance-infra. Who rules: railiance-hosts/infra which copy is historical.",
|
||||
"source_path": "docs/adr/ADR-002-repo-boundary-hosts-vs-bootstrap.md",
|
||||
"source_repo": "railiance-hosts",
|
||||
"successor": ""
|
||||
"successor": "railiance-hosts/docs/adr/ADR-003-railiance-5repo-stack-architecture.md"
|
||||
},
|
||||
{
|
||||
"bare_adr": "ADR-0003",
|
||||
|
|
@ -2328,7 +2362,9 @@
|
|||
"rapp-postgres/docs/adr/ADR-0003-e3-row-level-security-contract.md",
|
||||
"the-custodian/canon/architecture/adr-003-materialized-derived-state.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
6
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "",
|
||||
|
|
@ -2353,8 +2389,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "conflict",
|
||||
"review_notes": "Accepted 5-repo stack ADR is byte-identical in railiance-hosts and railiance-infra. Two current copies of one decision. Who rules: those two repos, or railiance-master if the stack story moved.",
|
||||
"source_path": "docs/adr/ADR-003-railiance-5repo-stack-architecture.md",
|
||||
"source_repo": "railiance-hosts",
|
||||
"successor": ""
|
||||
|
|
@ -2372,7 +2408,9 @@
|
|||
"rapp-postgres/docs/adr/ADR-0004-platform-pg-cell-ceiling.md",
|
||||
"the-custodian/canon/architecture/adr-004-connectivity-first-network-posture.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
6
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "",
|
||||
|
|
@ -2397,8 +2435,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "conflict",
|
||||
"review_notes": "Accepted Forgejo runner ADR is byte-identical in railiance-hosts and railiance-infra. Who rules: those two repos.",
|
||||
"source_path": "docs/adr/ADR-004-forgejo-in-cluster-actions-runner.md",
|
||||
"source_repo": "railiance-hosts",
|
||||
"successor": ""
|
||||
|
|
@ -2419,7 +2457,10 @@
|
|||
"target-revenue/docs/adr/ADR-0002-hosted-trust-service-stack.md",
|
||||
"the-custodian/canon/architecture/adr-002-custodian-agent-runtime-design.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
2,
|
||||
6
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "",
|
||||
|
|
@ -2444,11 +2485,11 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "superseded",
|
||||
"review_notes": "Identical to the railiance-hosts copy; both say superseded by ADR-003.",
|
||||
"source_path": "docs/adr/ADR-002-repo-boundary-hosts-vs-bootstrap.md",
|
||||
"source_repo": "railiance-infra",
|
||||
"successor": ""
|
||||
"successor": "railiance-infra/docs/adr/ADR-003-railiance-5repo-stack-architecture.md"
|
||||
},
|
||||
{
|
||||
"bare_adr": "ADR-0003",
|
||||
|
|
@ -2464,7 +2505,9 @@
|
|||
"rapp-postgres/docs/adr/ADR-0003-e3-row-level-security-contract.md",
|
||||
"the-custodian/canon/architecture/adr-003-materialized-derived-state.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
6
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "",
|
||||
|
|
@ -2489,8 +2532,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "conflict",
|
||||
"review_notes": "Identical accepted copy of the hosts ADR-003. Do not publish both.",
|
||||
"source_path": "docs/adr/ADR-003-railiance-5repo-stack-architecture.md",
|
||||
"source_repo": "railiance-infra",
|
||||
"successor": ""
|
||||
|
|
@ -2508,7 +2551,9 @@
|
|||
"rapp-postgres/docs/adr/ADR-0004-platform-pg-cell-ceiling.md",
|
||||
"the-custodian/canon/architecture/adr-004-connectivity-first-network-posture.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
6
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "",
|
||||
|
|
@ -2533,8 +2578,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "conflict",
|
||||
"review_notes": "Identical accepted copy of the hosts ADR-004. Do not publish both.",
|
||||
"source_path": "docs/adr/ADR-004-forgejo-in-cluster-actions-runner.md",
|
||||
"source_repo": "railiance-infra",
|
||||
"successor": ""
|
||||
|
|
@ -2897,8 +2942,8 @@
|
|||
"id"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Binds other repos on S3. Needs a unique publication id in front-matter.",
|
||||
"source_path": "docs/adr/ADR-0001-s3-platform-service-boundary.md",
|
||||
"source_repo": "railiance-platform",
|
||||
"successor": ""
|
||||
|
|
@ -2939,8 +2984,8 @@
|
|||
"id"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Proposed placement-policy ownership. Bindings are cross-repo. Needs a unique id.",
|
||||
"source_path": "docs/adr/ADR-0002-placement-policy-ownership.md",
|
||||
"source_repo": "railiance-platform",
|
||||
"successor": ""
|
||||
|
|
@ -2979,8 +3024,8 @@
|
|||
"id"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Restates ADR-001 for this repo. Needs a unique publication id (front-matter has title but no id).",
|
||||
"source_path": "docs/adr/ADR-0003-decisions-live-in-the-repo.md",
|
||||
"source_repo": "railiance-platform",
|
||||
"successor": ""
|
||||
|
|
@ -3217,7 +3262,9 @@
|
|||
"target-revenue/docs/adr/ADR-0001-stage0-library-stack.md",
|
||||
"the-custodian/canon/architecture/adr-001-workplans-as-repo-artefacts.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-001",
|
||||
|
|
@ -3244,7 +3291,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-001' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-001-agent-harness-architecture.md",
|
||||
"source_repo": "rein-aharness",
|
||||
"successor": ""
|
||||
|
|
@ -3267,7 +3314,9 @@
|
|||
"rein-aharness/docs/adr/ADR-001-agent-harness-architecture.md",
|
||||
"the-custodian/canon/architecture/adr-001-workplans-as-repo-artefacts.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-0001",
|
||||
|
|
@ -3293,7 +3342,7 @@
|
|||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"review_notes": "Front-matter id 'ADR-0001' is shared; pick a repo-prefixed publication id before publish. Who rules: owning repo.",
|
||||
"source_path": "docs/adr/ADR-0001-stage0-library-stack.md",
|
||||
"source_repo": "target-revenue",
|
||||
"successor": ""
|
||||
|
|
@ -3360,7 +3409,9 @@
|
|||
"rein-aharness/docs/adr/ADR-001-agent-harness-architecture.md",
|
||||
"target-revenue/docs/adr/ADR-0001-stage0-library-stack.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-001",
|
||||
|
|
@ -3386,8 +3437,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Estate rule: workplans originate as repo files. Needs a unique publication id (e.g. CUST-ADR-001) before publish.",
|
||||
"source_path": "canon/architecture/adr-001-workplans-as-repo-artefacts.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
|
|
@ -3408,7 +3459,9 @@
|
|||
"rapp-postgres/docs/adr/ADR-0002-data-retention-and-erasure.md",
|
||||
"target-revenue/docs/adr/ADR-0002-hosted-trust-service-stack.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-002",
|
||||
|
|
@ -3433,8 +3486,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Estate ADR. Prefix the publication id before publish.",
|
||||
"source_path": "canon/architecture/adr-002-custodian-agent-runtime-design.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
|
|
@ -3453,7 +3506,9 @@
|
|||
"railiance-platform/docs/adr/ADR-0003-decisions-live-in-the-repo.md",
|
||||
"rapp-postgres/docs/adr/ADR-0003-e3-row-level-security-contract.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-003",
|
||||
|
|
@ -3478,8 +3533,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Estate ADR: hub is a derived read-model. Prefix the publication id before publish.",
|
||||
"source_path": "canon/architecture/adr-003-materialized-derived-state.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
|
|
@ -3497,7 +3552,9 @@
|
|||
"railiance-master/docs/adr/ADR-0004-first-wave-reef-rollout.md",
|
||||
"rapp-postgres/docs/adr/ADR-0004-platform-pg-cell-ceiling.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-004",
|
||||
|
|
@ -3522,8 +3579,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Estate ADR. Prefix the publication id before publish.",
|
||||
"source_path": "canon/architecture/adr-004-connectivity-first-network-posture.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
|
|
@ -3536,7 +3593,9 @@
|
|||
"railiance-infra/docs/adr/ADR-005-k3s-api-tunnel-only.md",
|
||||
"railiance-master/docs/adr/ADR-0005-derived-rail-composition.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
1
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-005",
|
||||
|
|
@ -3560,8 +3619,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Estate ADR. Prefix the publication id before publish.",
|
||||
"source_path": "canon/architecture/adr-005-cross-repo-workplans-project-repos.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
|
|
@ -3595,8 +3654,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Estate ADR. Id ADR-006 is unique in front-matter today; still prefix for consistency.",
|
||||
"source_path": "canon/architecture/adr-006-canon-federation-concept-ownership.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
|
|
@ -3630,8 +3689,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Estate ADR. Prefix the publication id for consistency.",
|
||||
"source_path": "canon/architecture/adr-007-workplan-identity-and-repo-worker-topology.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
|
|
@ -3642,7 +3701,9 @@
|
|||
"net-kingdom/docs/adr/ADR-0008-object-storage-sts-credential-vending.md",
|
||||
"railiance-master/docs/adr/ADR-0008-private-by-default-exposure.md"
|
||||
],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
6
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "ADR-008",
|
||||
|
|
@ -3664,8 +3725,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "Relocated to net-kingdom Tenancy Posture. Duplicate-claim candidate (kind 6).",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "superseded",
|
||||
"review_notes": "Body and front-matter already say relocated to Tenancy Posture. Not a live duplicate claim. Who ruled: T04 from the document itself.",
|
||||
"source_path": "canon/architecture/adr-008-multi-tenancy-model.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": "netkingdom-tenancy-posture"
|
||||
|
|
@ -3697,8 +3758,8 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Proposed estate ADR. Publish as proposed once prefixed and review metadata is added.",
|
||||
"source_path": "canon/architecture/adr-010-hub-authority-and-local-cache-model.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
|
|
@ -3729,9 +3790,36 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "publish",
|
||||
"review_notes": "Proposed estate ADR. Publish as proposed once prefixed and review metadata is added.",
|
||||
"source_path": "canon/architecture/adr-011-federated-namespaces-and-reconciliation-limits.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
},
|
||||
{
|
||||
"bare_adr": "",
|
||||
"bare_adr_collisions": [],
|
||||
"conflict_kinds": [],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "coulomb-estate-architecture",
|
||||
"last_reviewed": "2026-08-18",
|
||||
"owner": "the-custodian",
|
||||
"review_interval": "6m",
|
||||
"revision": "draft-1",
|
||||
"status": "proposed",
|
||||
"title": "Coulomb estate architecture",
|
||||
"updated": "",
|
||||
"version": "0.1"
|
||||
},
|
||||
"id_collisions": [],
|
||||
"inventory_disposition": "published",
|
||||
"inventory_reason": "Published through an explicit publication.json document entry.",
|
||||
"missing_fields": [],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"source_path": "canon/architecture/adr-011-federated-namespaces-and-reconciliation-limits.md",
|
||||
"source_path": "canon/architecture/coulomb-estate_v0.1.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
},
|
||||
|
|
@ -4110,7 +4198,9 @@
|
|||
{
|
||||
"bare_adr": "",
|
||||
"bare_adr_collisions": [],
|
||||
"conflict_kinds": [],
|
||||
"conflict_kinds": [
|
||||
3
|
||||
],
|
||||
"file_present": true,
|
||||
"frontmatter": {
|
||||
"id": "canon-iam-profile",
|
||||
|
|
@ -4131,11 +4221,11 @@
|
|||
"review"
|
||||
],
|
||||
"notes": "",
|
||||
"proposed_disposition": "unreviewed",
|
||||
"review_notes": "",
|
||||
"proposed_disposition": "superseded",
|
||||
"review_notes": "Already superseded. Recorded successor still points at v0.2; v0.3 now supersedes v0.2. Who rules: the-custodian to update superseded_by.",
|
||||
"source_path": "canon/standards/iam-profile_v0.1.md",
|
||||
"source_repo": "the-custodian",
|
||||
"successor": ""
|
||||
"successor": "net-kingdom/canon/standards/iam-profile_v0.3.md"
|
||||
},
|
||||
{
|
||||
"bare_adr": "",
|
||||
|
|
@ -4764,6 +4854,7 @@
|
|||
"successor": ""
|
||||
}
|
||||
],
|
||||
"rulings": "/home/worsch/policy-nexus/docs/adr-review/rulings.json",
|
||||
"schema_version": 1,
|
||||
"source_inventory": "source-inventory.json"
|
||||
}
|
||||
|
|
|
|||
|
|
@ -73,6 +73,12 @@ 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.
|
||||
|
||||
T03/T04 write `rulings.json`. A ledger refresh merges those four
|
||||
review fields onto the regenerated facts. Kind `1` is also applied
|
||||
automatically when a front-matter `id` is shared; that alone does not
|
||||
flip the row to `conflict` — it is a prefix packet, not a
|
||||
contradiction.
|
||||
|
||||
## First publish set
|
||||
|
||||
- `policy-nexus` `docs/adr/ADR-0001-addressing-and-permanence.md`
|
||||
|
|
|
|||
232
docs/adr-review/rulings.json
Normal file
232
docs/adr-review/rulings.json
Normal file
|
|
@ -0,0 +1,232 @@
|
|||
{
|
||||
"schema_version": 1,
|
||||
"ruled_at": "2026-08-18",
|
||||
"workplan": "POLICY-NEXUS-WP-0003",
|
||||
"note": "T03/T04 overlay. Regenerating the ledger merges these fields onto inventory facts. Kind 1 on a shared front-matter id is also applied automatically.",
|
||||
"rulings": [
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/adr-008-multi-tenancy-model.md",
|
||||
"proposed_disposition": "superseded",
|
||||
"conflict_kinds": [6],
|
||||
"successor": "netkingdom-tenancy-posture",
|
||||
"review_notes": "Body and front-matter already say relocated to Tenancy Posture. Not a live duplicate claim. Who ruled: T04 from the document itself."
|
||||
},
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/standards/iam-profile_v0.1.md",
|
||||
"proposed_disposition": "superseded",
|
||||
"conflict_kinds": [3],
|
||||
"successor": "net-kingdom/canon/standards/iam-profile_v0.3.md",
|
||||
"review_notes": "Already superseded. Recorded successor still points at v0.2; v0.3 now supersedes v0.2. Who rules: the-custodian to update superseded_by."
|
||||
},
|
||||
{
|
||||
"source_repo": "net-kingdom",
|
||||
"source_path": "canon/standards/iam-profile_v0.2.md",
|
||||
"proposed_disposition": "superseded",
|
||||
"conflict_kinds": [1, 2, 6],
|
||||
"successor": "net-kingdom/canon/standards/iam-profile_v0.3.md",
|
||||
"review_notes": "v0.3 says it supersedes v0.2, but v0.2 is still status accepted and shares id netkingdom-iam-profile. Who rules: net-kingdom (status + unique id)."
|
||||
},
|
||||
{
|
||||
"source_repo": "net-kingdom",
|
||||
"source_path": "canon/standards/iam-profile_v0.3.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [1, 6],
|
||||
"successor": "",
|
||||
"review_notes": "Current IAM profile. Cannot publish until id is unique (e.g. netkingdom-iam-profile-v0.3). Who rules: net-kingdom."
|
||||
},
|
||||
{
|
||||
"source_repo": "railiance-hosts",
|
||||
"source_path": "docs/adr/ADR-002-repo-boundary-hosts-vs-bootstrap.md",
|
||||
"proposed_disposition": "superseded",
|
||||
"conflict_kinds": [2, 6],
|
||||
"successor": "railiance-hosts/docs/adr/ADR-003-railiance-5repo-stack-architecture.md",
|
||||
"review_notes": "Body is superseded by ADR-003. Byte-identical copy also lives in railiance-infra. Who rules: railiance-hosts/infra which copy is historical."
|
||||
},
|
||||
{
|
||||
"source_repo": "railiance-infra",
|
||||
"source_path": "docs/adr/ADR-002-repo-boundary-hosts-vs-bootstrap.md",
|
||||
"proposed_disposition": "superseded",
|
||||
"conflict_kinds": [2, 6],
|
||||
"successor": "railiance-infra/docs/adr/ADR-003-railiance-5repo-stack-architecture.md",
|
||||
"review_notes": "Identical to the railiance-hosts copy; both say superseded by ADR-003."
|
||||
},
|
||||
{
|
||||
"source_repo": "railiance-hosts",
|
||||
"source_path": "docs/adr/ADR-003-railiance-5repo-stack-architecture.md",
|
||||
"proposed_disposition": "conflict",
|
||||
"conflict_kinds": [6],
|
||||
"successor": "",
|
||||
"review_notes": "Accepted 5-repo stack ADR is byte-identical in railiance-hosts and railiance-infra. Two current copies of one decision. Who rules: those two repos, or railiance-master if the stack story moved."
|
||||
},
|
||||
{
|
||||
"source_repo": "railiance-infra",
|
||||
"source_path": "docs/adr/ADR-003-railiance-5repo-stack-architecture.md",
|
||||
"proposed_disposition": "conflict",
|
||||
"conflict_kinds": [6],
|
||||
"successor": "",
|
||||
"review_notes": "Identical accepted copy of the hosts ADR-003. Do not publish both."
|
||||
},
|
||||
{
|
||||
"source_repo": "railiance-hosts",
|
||||
"source_path": "docs/adr/ADR-004-forgejo-in-cluster-actions-runner.md",
|
||||
"proposed_disposition": "conflict",
|
||||
"conflict_kinds": [6],
|
||||
"successor": "",
|
||||
"review_notes": "Accepted Forgejo runner ADR is byte-identical in railiance-hosts and railiance-infra. Who rules: those two repos."
|
||||
},
|
||||
{
|
||||
"source_repo": "railiance-infra",
|
||||
"source_path": "docs/adr/ADR-004-forgejo-in-cluster-actions-runner.md",
|
||||
"proposed_disposition": "conflict",
|
||||
"conflict_kinds": [6],
|
||||
"successor": "",
|
||||
"review_notes": "Identical accepted copy of the hosts ADR-004. Do not publish both."
|
||||
},
|
||||
{
|
||||
"source_repo": "coulomb-social",
|
||||
"source_path": "docs/adr/ADR-0002-space-content-forgejo-markdown.md",
|
||||
"proposed_disposition": "conflict",
|
||||
"conflict_kinds": [2],
|
||||
"successor": "coulomb-social/docs/adr/ADR-0003-page-centric-markdown-sor.md",
|
||||
"review_notes": "Status is 'superseded in part' by ADR-0003/0004. Not a clean superseded or accepted. Who rules: coulomb-social."
|
||||
},
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/adr-001-workplans-as-repo-artefacts.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [1],
|
||||
"successor": "",
|
||||
"review_notes": "Estate rule: workplans originate as repo files. Needs a unique publication id (e.g. CUST-ADR-001) before publish."
|
||||
},
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/adr-002-custodian-agent-runtime-design.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [1],
|
||||
"successor": "",
|
||||
"review_notes": "Estate ADR. Prefix the publication id before publish."
|
||||
},
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/adr-003-materialized-derived-state.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [1],
|
||||
"successor": "",
|
||||
"review_notes": "Estate ADR: hub is a derived read-model. Prefix the publication id before publish."
|
||||
},
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/adr-004-connectivity-first-network-posture.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [1],
|
||||
"successor": "",
|
||||
"review_notes": "Estate ADR. Prefix the publication id before publish."
|
||||
},
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/adr-005-cross-repo-workplans-project-repos.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [1],
|
||||
"successor": "",
|
||||
"review_notes": "Estate ADR. Prefix the publication id before publish."
|
||||
},
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/adr-006-canon-federation-concept-ownership.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Estate ADR. Id ADR-006 is unique in front-matter today; still prefix for consistency."
|
||||
},
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/adr-007-workplan-identity-and-repo-worker-topology.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Estate ADR. Prefix the publication id for consistency."
|
||||
},
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/adr-010-hub-authority-and-local-cache-model.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Proposed estate ADR. Publish as proposed once prefixed and review metadata is added."
|
||||
},
|
||||
{
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/adr-011-federated-namespaces-and-reconciliation-limits.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Proposed estate ADR. Publish as proposed once prefixed and review metadata is added."
|
||||
},
|
||||
{
|
||||
"source_repo": "activity-core",
|
||||
"source_path": "docs/adr/adr-001-event-bridge-architecture.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Cross-repo event bridge. Id ACT-ADR-001 is unique. Needs owner/revision/review front-matter."
|
||||
},
|
||||
{
|
||||
"source_repo": "activity-core",
|
||||
"source_path": "docs/adr/adr-002-definition-format.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Cross-repo definition format. Unique id. Needs owner/revision/review."
|
||||
},
|
||||
{
|
||||
"source_repo": "activity-core",
|
||||
"source_path": "docs/adr/adr-003-rule-instruction-model.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Cross-repo rule/instruction split. Unique id. Needs owner/revision/review."
|
||||
},
|
||||
{
|
||||
"source_repo": "activity-core",
|
||||
"source_path": "docs/adr/adr-004-producer-trust-boundary.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Cross-repo producer trust boundary. Unique id. Needs owner/revision/review."
|
||||
},
|
||||
{
|
||||
"source_repo": "activity-core",
|
||||
"source_path": "docs/adr/adr-005-ops-runs-vs-dev-work-records.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Cross-repo ops-run vs work-record split. Unique id. Needs owner/revision/review."
|
||||
},
|
||||
{
|
||||
"source_repo": "railiance-platform",
|
||||
"source_path": "docs/adr/ADR-0001-s3-platform-service-boundary.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Binds other repos on S3. Needs a unique publication id in front-matter."
|
||||
},
|
||||
{
|
||||
"source_repo": "railiance-platform",
|
||||
"source_path": "docs/adr/ADR-0002-placement-policy-ownership.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Proposed placement-policy ownership. Bindings are cross-repo. Needs a unique id."
|
||||
},
|
||||
{
|
||||
"source_repo": "railiance-platform",
|
||||
"source_path": "docs/adr/ADR-0003-decisions-live-in-the-repo.md",
|
||||
"proposed_disposition": "publish",
|
||||
"conflict_kinds": [],
|
||||
"successor": "",
|
||||
"review_notes": "Restates ADR-001 for this repo. Needs a unique publication id (front-matter has title but no id)."
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -15,7 +15,8 @@
|
|||
"repositories": {
|
||||
"net-kingdom": {"path": "../net-kingdom"},
|
||||
"policy-nexus": {"path": "."},
|
||||
"railiance-master": {"path": "../railiance-master"}
|
||||
"railiance-master": {"path": "../railiance-master"},
|
||||
"the-custodian": {"path": "../the-custodian"}
|
||||
},
|
||||
"documents": [
|
||||
{
|
||||
|
|
@ -28,6 +29,14 @@
|
|||
"subtitle": "A framework for describing, holding and improving multi-tenancy — including where we are not there yet.",
|
||||
"review_interval": "6m"
|
||||
},
|
||||
{
|
||||
"id": "coulomb-estate-architecture",
|
||||
"source_repo": "the-custodian",
|
||||
"source_path": "canon/architecture/coulomb-estate_v0.1.md",
|
||||
"canonical_path": "architecture/coulomb-estate/v0.1/index.html",
|
||||
"revision_path": "architecture/coulomb-estate/v0.1/revisions/{revision}/index.html",
|
||||
"review_interval": "6m"
|
||||
},
|
||||
{
|
||||
"id": "policy-nexus-architecture",
|
||||
"source_repo": "policy-nexus",
|
||||
|
|
|
|||
|
|
@ -565,6 +565,12 @@
|
|||
"source_path": "canon/architecture/adr-011-federated-namespaces-and-reconciliation-limits.md",
|
||||
"source_repo": "the-custodian"
|
||||
},
|
||||
{
|
||||
"disposition": "published",
|
||||
"reason": "Published through an explicit publication.json document entry.",
|
||||
"source_path": "canon/architecture/coulomb-estate_v0.1.md",
|
||||
"source_repo": "the-custodian"
|
||||
},
|
||||
{
|
||||
"disposition": "metadata-pending",
|
||||
"reason": "In scope; awaits explicit publication addressing and owner/revision/review metadata.",
|
||||
|
|
|
|||
|
|
@ -76,3 +76,94 @@ class AdrReviewLedgerTest(unittest.TestCase):
|
|||
rows["alpha/docs/adr/ADR-0001-one.md"]["bare_adr_collisions"],
|
||||
)
|
||||
self.assertEqual("unreviewed", rows["alpha/docs/adr/ADR-0001-one.md"]["proposed_disposition"])
|
||||
|
||||
def test_rulings_overlay_and_shared_id_kind_one(self) -> None:
|
||||
with tempfile.TemporaryDirectory() as directory:
|
||||
root = Path(directory)
|
||||
(root / "alpha/docs/adr").mkdir(parents=True)
|
||||
(root / "beta/docs/adr").mkdir(parents=True)
|
||||
(root / "alpha/docs/adr/one.md").write_text(
|
||||
"---\nid: ADR-001\ntitle: One\nstatus: accepted\nowner: alpha\n"
|
||||
"revision: 1\nlast_reviewed: \"2026-08-18\"\nreview_interval: 6m\n---\n# One\n",
|
||||
encoding="utf-8",
|
||||
)
|
||||
(root / "beta/docs/adr/two.md").write_text(
|
||||
"---\nid: ADR-001\ntitle: Two\nstatus: accepted\nowner: beta\n"
|
||||
"revision: 1\nlast_reviewed: \"2026-08-18\"\nreview_interval: 6m\n---\n# 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/one.md",
|
||||
"disposition": "metadata-pending",
|
||||
"reason": "pending",
|
||||
},
|
||||
{
|
||||
"source_repo": "beta",
|
||||
"source_path": "docs/adr/two.md",
|
||||
"disposition": "metadata-pending",
|
||||
"reason": "pending",
|
||||
},
|
||||
],
|
||||
}
|
||||
),
|
||||
encoding="utf-8",
|
||||
)
|
||||
rulings = root / "rulings.json"
|
||||
rulings.write_text(
|
||||
json.dumps(
|
||||
{
|
||||
"schema_version": 1,
|
||||
"rulings": [
|
||||
{
|
||||
"source_repo": "beta",
|
||||
"source_path": "docs/adr/two.md",
|
||||
"proposed_disposition": "conflict",
|
||||
"conflict_kinds": [6],
|
||||
"successor": "",
|
||||
"review_notes": "duplicate claim",
|
||||
}
|
||||
],
|
||||
}
|
||||
),
|
||||
encoding="utf-8",
|
||||
)
|
||||
ledger = build_ledger(
|
||||
inventory,
|
||||
config,
|
||||
policy_root=root,
|
||||
source_root=root,
|
||||
rulings_path=rulings,
|
||||
)
|
||||
rows = {f"{row['source_repo']}/{row['source_path']}": row for row in ledger["rows"]}
|
||||
self.assertEqual("unreviewed", rows["alpha/docs/adr/one.md"]["proposed_disposition"])
|
||||
self.assertIn(1, rows["alpha/docs/adr/one.md"]["conflict_kinds"])
|
||||
self.assertEqual("conflict", rows["beta/docs/adr/two.md"]["proposed_disposition"])
|
||||
self.assertEqual([6, 1], rows["beta/docs/adr/two.md"]["conflict_kinds"])
|
||||
|
|
|
|||
|
|
@ -82,11 +82,30 @@ def _frontmatter(path: Path) -> dict[str, str]:
|
|||
return {key: value for key, value in meta.items() if value}
|
||||
|
||||
|
||||
def _load_rulings(path: Path | None) -> dict[tuple[str, str], dict[str, Any]]:
|
||||
if path is None or not path.exists():
|
||||
return {}
|
||||
payload = _read_json(path)
|
||||
rulings: dict[tuple[str, str], dict[str, Any]] = {}
|
||||
for ruling in payload.get("rulings", []):
|
||||
key = (ruling["source_repo"], ruling["source_path"])
|
||||
if key in rulings:
|
||||
raise ValueError(f"duplicate ruling: {key[0]}/{key[1]}")
|
||||
rulings[key] = ruling
|
||||
return rulings
|
||||
|
||||
|
||||
def build_ledger(
|
||||
inventory_path: Path, config_path: Path, *, policy_root: Path, source_root: Path
|
||||
inventory_path: Path,
|
||||
config_path: Path,
|
||||
*,
|
||||
policy_root: Path,
|
||||
source_root: Path,
|
||||
rulings_path: Path | None = None,
|
||||
) -> dict[str, Any]:
|
||||
inventory = _read_json(inventory_path)
|
||||
config = _read_json(config_path)
|
||||
rulings = _load_rulings(rulings_path)
|
||||
paths = _repo_paths(config, policy_root=policy_root, source_root=source_root)
|
||||
rows: list[dict[str, Any]] = []
|
||||
for source in inventory.get("sources", []):
|
||||
|
|
@ -123,11 +142,7 @@ def build_ledger(
|
|||
"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 ""
|
||||
),
|
||||
"successor": "",
|
||||
"review_notes": "",
|
||||
}
|
||||
)
|
||||
|
|
@ -150,11 +165,31 @@ def build_ledger(
|
|||
row["bare_adr_collisions"] = [
|
||||
other for other in by_bare.get(row["bare_adr"], []) if other != label
|
||||
]
|
||||
key = (row["source_repo"], row["source_path"])
|
||||
ruling = rulings.get(key)
|
||||
if ruling:
|
||||
for field in (
|
||||
"proposed_disposition",
|
||||
"conflict_kinds",
|
||||
"successor",
|
||||
"review_notes",
|
||||
):
|
||||
if field in ruling:
|
||||
row[field] = ruling[field]
|
||||
if row["id_collisions"] and 1 not in row["conflict_kinds"]:
|
||||
row["conflict_kinds"] = [*row["conflict_kinds"], 1]
|
||||
if not row["review_notes"]:
|
||||
row["review_notes"] = (
|
||||
f"Front-matter id {row['frontmatter']['id']!r} is shared; "
|
||||
"pick a repo-prefixed publication id before publish. "
|
||||
"Who rules: owning repo."
|
||||
)
|
||||
|
||||
return {
|
||||
"schema_version": 1,
|
||||
"protocol": "docs/adr-review/protocol.md",
|
||||
"source_inventory": "source-inventory.json",
|
||||
"rulings": str(rulings_path) if rulings_path else "",
|
||||
"rows": rows,
|
||||
}
|
||||
|
||||
|
|
@ -210,6 +245,17 @@ def _summary(ledger: dict[str, Any]) -> str:
|
|||
[f"{row['source_repo']}/{row['source_path']}", *row["bare_adr_collisions"]]
|
||||
)
|
||||
lines.append(f"- `{key}`: {others}")
|
||||
conflicts = [row for row in rows if row["proposed_disposition"] == "conflict"]
|
||||
lines.extend(["", "## Conflict rows", ""])
|
||||
if not conflicts:
|
||||
lines.append("None.")
|
||||
else:
|
||||
for row in conflicts:
|
||||
kinds = ",".join(str(kind) for kind in row["conflict_kinds"]) or "-"
|
||||
lines.append(
|
||||
f"- `{row['source_repo']}/{row['source_path']}` "
|
||||
f"(kinds {kinds}): {row['review_notes']}"
|
||||
)
|
||||
lines.extend(["", "## Missing files", ""])
|
||||
if not missing_files:
|
||||
lines.append("None.")
|
||||
|
|
@ -226,6 +272,7 @@ def main(argv: list[str] | None = None) -> int:
|
|||
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("--rulings", type=Path, default=Path("docs/adr-review/rulings.json"))
|
||||
parser.add_argument("--policy-root", type=Path)
|
||||
parser.add_argument("--source-root", type=Path)
|
||||
args = parser.parse_args(argv)
|
||||
|
|
@ -238,6 +285,7 @@ def main(argv: list[str] | None = None) -> int:
|
|||
config_path,
|
||||
policy_root=policy_root,
|
||||
source_root=source_root,
|
||||
rulings_path=args.rulings.resolve() if args.rulings else None,
|
||||
)
|
||||
args.output.parent.mkdir(parents=True, exist_ok=True)
|
||||
args.output.write_text(
|
||||
|
|
|
|||
|
|
@ -196,7 +196,7 @@ even as a stub.
|
|||
|
||||
```task
|
||||
id: POLICY-NEXUS-WP-0002-T04
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
```
|
||||
|
||||
|
|
@ -211,6 +211,11 @@ satisfy T01 so this repo can publish it.
|
|||
This is the document WP-0003 checks other ADRs against when the conflict
|
||||
is "this decision does not fit the estate".
|
||||
|
||||
Completed 2026-08-18 in
|
||||
`the-custodian/canon/architecture/coulomb-estate_v0.1.md`. Chapters 1, 3,
|
||||
4, 5.1, 9 and 12 are real. Chapter 9 lists the estate ADRs and excludes
|
||||
unresolved WP-0003 conflicts.
|
||||
|
||||
### T05 — Remaining first-wave stubs in owning repos
|
||||
|
||||
```task
|
||||
|
|
@ -254,7 +259,8 @@ publication stays explicit.
|
|||
|
||||
2026-08-18: `docs/architecture/*.md` is a policy-nexus selector.
|
||||
`policy-nexus-architecture` is published at
|
||||
`/architecture/policy-nexus/v0.1/`. Other first-wave documents still
|
||||
`/architecture/policy-nexus/v0.1/`. Estate map is published at
|
||||
`/architecture/coulomb-estate/v0.1/`. Other first-wave documents still
|
||||
need owning-repo files.
|
||||
|
||||
### T07 — Smoke the published collection
|
||||
|
|
|
|||
|
|
@ -171,7 +171,7 @@ special. First-publish-set rows start as `publish`; everything else is
|
|||
|
||||
```task
|
||||
id: POLICY-NEXUS-WP-0003-T03
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
```
|
||||
|
||||
|
|
@ -185,11 +185,17 @@ estate-level). Do not resolve a custodian-level clash in this repo.
|
|||
**Acceptance:** every `conflict` row is readable by the owning-repo
|
||||
agent that will have to act on it.
|
||||
|
||||
Completed 2026-08-18. `docs/adr-review/conflicts.md` and `rulings.json`.
|
||||
Kind 1 is automatic on a shared front-matter id and is a prefix packet.
|
||||
Live unpublished conflicts: hosts/infra ADR-003, hosts/infra ADR-004,
|
||||
coulomb-social ADR-0002. No kind-4 contradiction found. Kind 5 waits
|
||||
on chapter 9 (now present on the estate stub; re-check in T04).
|
||||
|
||||
### T04 — Relevance filter
|
||||
|
||||
```task
|
||||
id: POLICY-NEXUS-WP-0003-T04
|
||||
status: todo
|
||||
status: progress
|
||||
priority: high
|
||||
```
|
||||
|
||||
|
|
@ -207,6 +213,13 @@ publishes them. Per-repo proposals go out in T05 packets.
|
|||
Kind-5 (architecture miss) runs here once WP-0002-T04 exists, and again
|
||||
when T05 of that workplan lands a system document.
|
||||
|
||||
2026-08-18: first relevance slice is in `rulings.json`. Superseded:
|
||||
custodian ADR-008, both IAM Profile predecessors, both ADR-002 host/infra
|
||||
copies. Publish (after prefix/metadata packets): estate ADRs 001–007 and
|
||||
010–011, activity-core 001–005, railiance-platform 0001–0003, IAM
|
||||
Profile v0.3. Remainder still `unreviewed`. Kind 5 against the estate
|
||||
chapter 9: the listed estate ADRs match; no miss on that document.
|
||||
|
||||
### T05 — Cleanup packets
|
||||
|
||||
```task
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue