aetos/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: renumber lib reference into 4-pillar anatomy

Browse Source 
Renumber the 15 reference docs into pillar groups (recipe -> anatomy):
- 01 Build Recipe (entry), 02 Composition Root
- domains: 10 Layering Rules
- contract: 20 Spec-First Routing, 21 CRUD Template, 22 Auth Integration
- interfaces/infra: 30 Infra Adapters
- UI: 40 UI: Auto-Rendered Admin & Custom Pages (new; @aetoskia packages,
  client template, x- catalog via react-openapi MCP module)
- pipelines: 50 Pipeline Scaffold, 51 Worker & Progress, 52 Human-in-the-Loop
- delivery/meta: 90 Drone Pipelines, 91 Versioning & Changelog,
  92 Genericity Matrix, 93 Library Registry, 94 Repository Inventory

MCP module names are unchanged (NN_ prefix stripped); all cross-references
(wiki, templates, hooks, registry) updated; lib index rewritten pillar-first;
build recipe bootstraps the client template. Bundle + HTML sites regenerated.
This commit is contained in:
Vishesh 'ironeagle' Bangotra
2026-10-19 17:42:55 +05:30
parent e88005d936
commit 406affcfcf
88 changed files with 3017 additions and 2295 deletions
Download Patch File Download Diff File Expand all files Collapse all files

238
standards/lib/index.html
View File

@@ -232,6 +232,19 @@
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
Home
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="." class="md-nav__link md-nav__link--active">
@@ -244,6 +257,88 @@
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#anatomy" class="md-nav__link">
<span class="md-ellipsis">
Anatomy
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pillar-1-domains" class="md-nav__link">
<span class="md-ellipsis">
Pillar 1 — Domains
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pillar-2-openapi-spec-the-contract" class="md-nav__link">
<span class="md-ellipsis">
Pillar 2 — OpenAPI Spec (the contract)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pillar-3-interfaces-infra" class="md-nav__link">
<span class="md-ellipsis">
Pillar 3 — Interfaces &amp; Infra
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pillar-4-ui" class="md-nav__link">
<span class="md-ellipsis">
Pillar 4 — UI
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pipelines-optional-layer" class="md-nav__link">
<span class="md-ellipsis">
Pipelines (optional layer)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#delivery-meta" class="md-nav__link">
<span class="md-ellipsis">
Delivery &amp; Meta
</span>
</a>
</li>
</ul>
</nav>
</li>
@@ -277,7 +372,7 @@
<li class="md-nav__item">
<a href="02_layering_rules/" class="md-nav__link">
<a href="02_layering_rules.md" class="md-nav__link">
@@ -299,7 +394,7 @@
<li class="md-nav__item">
<a href="03_composition_root/" class="md-nav__link">
<a href="03_composition_root.md" class="md-nav__link">
@@ -321,7 +416,7 @@
<li class="md-nav__item">
<a href="04_spec_first_routing/" class="md-nav__link">
<a href="04_spec_first_routing.md" class="md-nav__link">
@@ -343,7 +438,7 @@
<li class="md-nav__item">
<a href="05_crud_template/" class="md-nav__link">
<a href="05_crud_template.md" class="md-nav__link">
@@ -365,7 +460,7 @@
<li class="md-nav__item">
<a href="06_pipeline_scaffold/" class="md-nav__link">
<a href="06_pipeline_scaffold.md" class="md-nav__link">
@@ -387,7 +482,7 @@
<li class="md-nav__item">
<a href="07_worker_and_progress/" class="md-nav__link">
<a href="07_worker_and_progress.md" class="md-nav__link">
@@ -409,7 +504,7 @@
<li class="md-nav__item">
<a href="08_human_in_loop/" class="md-nav__link">
<a href="08_human_in_loop.md" class="md-nav__link">
@@ -431,7 +526,7 @@
<li class="md-nav__item">
<a href="09_infra_adaptors/" class="md-nav__link">
<a href="09_infra_adaptors.md" class="md-nav__link">
@@ -453,7 +548,7 @@
<li class="md-nav__item">
<a href="10_drone_pipelines/" class="md-nav__link">
<a href="10_drone_pipelines.md" class="md-nav__link">
@@ -475,7 +570,7 @@
<li class="md-nav__item">
<a href="11_versioning_and_changelog/" class="md-nav__link">
<a href="11_versioning_and_changelog.md" class="md-nav__link">
@@ -497,7 +592,7 @@
<li class="md-nav__item">
<a href="15_repository_inventory/" class="md-nav__link">
<a href="15_repository_inventory.md" class="md-nav__link">
@@ -519,7 +614,7 @@
<li class="md-nav__item">
<a href="12_genericity_matrix/" class="md-nav__link">
<a href="12_genericity_matrix.md" class="md-nav__link">
@@ -541,7 +636,7 @@
<li class="md-nav__item">
<a href="14_auth_integration/" class="md-nav__link">
<a href="14_auth_integration.md" class="md-nav__link">
@@ -563,7 +658,7 @@
<li class="md-nav__item">
<a href="13_library_registry/" class="md-nav__link">
<a href="13_library_registry.md" class="md-nav__link">
@@ -598,6 +693,77 @@
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#anatomy" class="md-nav__link">
<span class="md-ellipsis">
Anatomy
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pillar-1-domains" class="md-nav__link">
<span class="md-ellipsis">
Pillar 1 — Domains
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pillar-2-openapi-spec-the-contract" class="md-nav__link">
<span class="md-ellipsis">
Pillar 2 — OpenAPI Spec (the contract)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pillar-3-interfaces-infra" class="md-nav__link">
<span class="md-ellipsis">
Pillar 3 — Interfaces &amp; Infra
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pillar-4-ui" class="md-nav__link">
<span class="md-ellipsis">
Pillar 4 — UI
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pipelines-optional-layer" class="md-nav__link">
<span class="md-ellipsis">
Pipelines (optional layer)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#delivery-meta" class="md-nav__link">
<span class="md-ellipsis">
Delivery &amp; Meta
</span>
</a>
</li>
</ul>
</nav>
</div>
</div>
@@ -615,26 +781,54 @@
<h1 id="standards-reference">Standards Reference</h1>
<p>The reference half of the Standards description: the enforceable rules,
patterns, and the internal library catalog that agents consult while coding.</p>
<p>The reference is organized as an <strong>anatomy</strong> — one entry checklist and four
pillars describing what an application is made of, plus delivery/meta pages
and an optional pipelines layer.</p>
<h2 id="anatomy">Anatomy</h2>
<ul>
<li><strong>Build Recipe</strong> — the ordered, agentic checklist for a new app; the entry
point that walks the whole anatomy.</li>
</ul>
<h2 id="pillar-1-domains">Pillar 1 — Domains</h2>
<ul>
<li><strong>Build Recipe</strong> — the ordered, agentic checklist for a new app.</li>
<li><strong>Layering Rules</strong> — the strict request → domain → repository layering and
the rules that enforce it.</li>
</ul>
<h2 id="pillar-2-openapi-spec-the-contract">Pillar 2 — OpenAPI Spec (the contract)</h2>
<ul>
<li><strong>Composition Root</strong> — a single composition point wiring the whole app.</li>
<li><strong>Spec-First Routing</strong> — the OpenAPI contract as the routing source of truth.</li>
<li><strong>CRUD Template</strong> — the standardized generic resource endpoint scaffold.</li>
<li><strong>Auth Integration</strong> — consuming the shared auth-server service (spec-driven,
no auth code).</li>
</ul>
<h2 id="pillar-3-interfaces-infra">Pillar 3 — Interfaces &amp; Infra</h2>
<ul>
<li><strong>Infra Adapters</strong> — how infrastructure connects without leaking into domain.</li>
</ul>
<h2 id="pillar-4-ui">Pillar 4 — UI</h2>
<ul>
<li><strong>UI: Auto-Rendered Admin &amp; Custom Pages</strong> — the <code>@aetoskia/react-openapi</code>
admin rendered from the spec's x- extensions, and <code>@aetoskia/react-auth</code>
for auth pages; the client template scaffold.</li>
</ul>
<h2 id="pipelines-optional-layer">Pipelines (optional layer)</h2>
<ul>
<li><strong>Pipeline Scaffold</strong> — the deterministic pipeline skeleton for multi-stage
jobs.</li>
<li><strong>Worker &amp; Progress</strong> — queued work, progress reporting, and visibility.</li>
<li><strong>Human-in-the-Loop</strong> — guardrails and approvals inside automations.</li>
<li><strong>Infra Adapters</strong> — how infrastructure connects without leaking into domain.</li>
<li><strong>Drone Pipelines</strong> — the two CI shapes: a PyPI package or a Docker deployment.</li>
<li><strong>Versioning &amp; Changelog</strong> — SemVer, the tag↔version contract, and the release
changelog.</li>
</ul>
<h2 id="delivery-meta">Delivery &amp; Meta</h2>
<ul>
<li><strong>Drone Pipelines</strong> — the two CI shapes: a PyPI/npm package or a Docker
deployment.</li>
<li><strong>Versioning &amp; Changelog</strong> — SemVer, the tag↔version contract, and the
release changelog.</li>
<li><strong>Repository Inventory</strong> — every covered repo, its type, version source, and
Drone shape.</li>
<li><strong>Genericity Matrix</strong> — what is library-backed, template-provided, or authored.</li>
<li><strong>Auth Integration</strong> — consuming the shared auth-server service (spec-driven,
no auth code).</li>
<li><strong>Genericity Matrix</strong> — what is library-backed, template-provided, or
authored.</li>
<li><strong>Library Registry</strong> — the catalog of internal libraries behind all of it.</li>
</ul>
<p>Read the <strong>Wiki</strong> for the philosophy and rationale; these pages are the