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:
@@ -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.
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
---
|
||||
|
||||
@@ -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/)
|
||||
|
||||
@@ -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/)
|
||||
|
||||
@@ -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/)).
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user