feat: renumber lib reference into 4-pillar anatomy

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:
2026-10-19 17:42:55 +05:30
parent e88005d936
commit 406affcfcf
88 changed files with 3017 additions and 2295 deletions

View File

@@ -76,7 +76,7 @@ only its `ports/` seam reaches into `infra/` to bind adapters.
handlers are looked up by `operationId`. There are no decorator routers.
5. **Reuse the libraries.** Orchestration, DI, Mongo repositories, ingestion,
auth, and docs come from internal libraries — see the [Library
Registry](../lib/13_library_registry/).
Registry](../lib/93_library_registry/).
6. **Explicit state machines.** Long-running work moves through explicit,
durable statuses and can pause for human input.

View File

@@ -22,7 +22,7 @@ Gather these before starting — the `start_app` MCP prompt asks for them:
the families and their input formats (or "none").
4. **Auth needed now?** Default **no**. Auth is deferred (`py-jwt` primitives
only), and an authless app is just a spec with no `security` keys — see
[Spec-First Routing → Authless apps](../lib/04_spec_first_routing/#authless-apps).
[Spec-First Routing → Authless apps](../lib/20_spec_first_routing/#authless-apps).
5. **Integrations.** Mongo, ingestion formats, email, LLM provider.
If you can state axes 1 and 2, the rest is mechanical.
@@ -57,8 +57,8 @@ cp -r <docs>/standards/src/templates/app apps/<your-app>
## 📚 Reference
- [Build Recipe](../lib/01_build_recipe/) — the deterministic checklist
- [Genericity Matrix](../lib/12_genericity_matrix/) — Tier A / B / C
- [Library Registry](../lib/13_library_registry/) — the Tier A catalog
- [Genericity Matrix](../lib/92_genericity_matrix/) — Tier A / B / C
- [Library Registry](../lib/93_library_registry/) — the Tier A catalog
- [App Components](02_components.md) — the component model
---

View File

@@ -1,11 +1,11 @@
# Releasing & Versioning
How to cut a release of any Aetos repository. The rule lives in the reference
page [Versioning & Changelog](../lib/11_versioning_and_changelog/); this is the
page [Versioning & Changelog](../lib/91_versioning_and_changelog/); this is the
runbook you follow.
Every repository is one of two Drone shapes — a **PyPI package** or a **Docker
deployment** ([Drone Pipelines](../lib/10_drone_pipelines/)). Both release the
deployment** ([Drone Pipelines](../lib/90_drone_pipelines/)). Both release the
same way: the version bump and changelog promotion go **in the merge request**,
and the tag is created on the merged commit.
@@ -122,4 +122,4 @@ outage):
## Related
- [Testing & Quality Gates](01_testing.md) · [Versioning & Changelog](../lib/11_versioning_and_changelog/) · [Drone Pipelines](../lib/10_drone_pipelines/)
- [Testing & Quality Gates](01_testing.md) · [Versioning & Changelog](../lib/91_versioning_and_changelog/) · [Drone Pipelines](../lib/90_drone_pipelines/)

View File

@@ -9,7 +9,7 @@ portal runs each one as a FastMCP **streamable-http** app bound to
Connect your agent to the **`standards`** server first: it answers
`find_library`, `list_repos`, and the `start_app` prompt, so the agent reaches
for an internal library instead of reimplementing one (see the
[Library Registry](../lib/13_library_registry/)).
[Library Registry](../lib/93_library_registry/)).
---
@@ -356,7 +356,7 @@ Client Configuration → Copy HTTP Stream Config**.
## 📚 Reference
- [Library Registry](../lib/13_library_registry/) — the catalog each server
- [Library Registry](../lib/93_library_registry/) — the catalog each server
mirrors, and where `find_library` resolves
- [Start an App](03_start_an_app.md) — connect `standards`, then invoke
`start_app`
@@ -366,4 +366,4 @@ Client Configuration → Copy HTTP Stream Config**.
## Related
- [Start an App](03_start_an_app.md) · [Testing & Quality](04_development/01_testing.md) · [Library Registry](../lib/13_library_registry/)
- [Start an App](03_start_an_app.md) · [Testing & Quality](04_development/01_testing.md) · [Library Registry](../lib/93_library_registry/)

View File

@@ -41,15 +41,19 @@ the same shape underneath.
| [Testing & Quality](04_development/01_testing.md) | Test layout and acceptance gates |
**Reference** (separate site, mirrors the MCP bundle): the enforceable
rules — [Build Recipe](../lib/01_build_recipe/), [Layering](../lib/02_layering_rules/), [Composition
Root](../lib/03_composition_root/), [Spec-First
Routing](../lib/04_spec_first_routing/), [CRUD
Template](../lib/05_crud_template/), [Pipeline
Scaffold](../lib/06_pipeline_scaffold/), [Worker &
Progress](../lib/07_worker_and_progress/), [Human-in-the-Loop](../lib/08_human_in_loop/),
[Infra Adapters](../lib/09_infra_adaptors/), [Genericity
Matrix](../lib/12_genericity_matrix/), [Library
Registry](../lib/13_library_registry/).
anatomy — start at the [Build Recipe](../lib/01_build_recipe/), then the
pillars: domains ([Layering](../lib/10_layering_rules/)), the OpenAPI
contract ([Composition Root](../lib/02_composition_root/),
[Spec-First Routing](../lib/20_spec_first_routing/), [CRUD
Template](../lib/21_crud_template/), [Auth
Integration](../lib/22_auth_integration/)), interfaces & infra ([Infra
Adapters](../lib/30_infra_adaptors/)), UI ([Auto-Rendered
Admin](../lib/40_ui_admin/)), the optional pipelines layer ([Pipeline
Scaffold](../lib/50_pipeline_scaffold/), [Worker &
Progress](../lib/51_worker_and_progress/), [Human-in-the-Loop](../lib/52_human_in_loop/)),
and delivery/meta ([Genericity
Matrix](../lib/92_genericity_matrix/), [Library
Registry](../lib/93_library_registry/)).
---