From 4e0f340916e8b3056a9a48655b6f6520063c8cf8 Mon Sep 17 00:00:00 2001 From: jochen Date: Mon, 16 Nov 2026 10:06:25 +0100 Subject: [PATCH] Principles: 7 becomes 'no part without a need', 9 'depend on the contract, at the level it is interchangeable' (the operator, 2026-11-16) --- 00-META/principles.md | 9 ++++++--- .../01-to-be/47-milestones/G-23-after-delivery.md | 11 ++++++----- 2 files changed, 12 insertions(+), 8 deletions(-) diff --git a/00-META/principles.md b/00-META/principles.md index d18ba416..926d7054 100644 --- a/00-META/principles.md +++ b/00-META/principles.md @@ -1,6 +1,6 @@ --- status: canonical -updated: 2026-11-11 +updated: 2026-11-16 --- # The principles @@ -22,9 +22,12 @@ add, sharpen or drop a principle in a pull request to this file. 6. **Nothing is exposed publicly.** No data leaves the mesh unasked: no secret in a record, a log or a public repository, no service reachable from outside unless it is meant to be. Inside the mesh, every agent and module is trusted; who may do what is not a question to ask. -7. **The simplest thing that works.** Prefer what already exists. No new mechanism unless it is needed, and fewer - parts over more. +7. **No part without a need.** Every mechanism, field, seat and step exists because something needs it; prefer what + exists over a new one, and remove what no longer serves. Never a shortcut instead of the right shape. 8. **One word per thing**, from the [glossary](glossary.md). +9. **Depend on the contract, at the level it is interchangeable.** A module depends on a seat where the mesh means + more than one module to be able to fill the need, and on a module where only that module does; never on another + module's internals. How it is checked: the one code review of a milestone checks the code against these principles and the design's shape; an answer to a develop question names the principle that settles it. diff --git a/03-DESIGN/01-to-be/47-milestones/G-23-after-delivery.md b/03-DESIGN/01-to-be/47-milestones/G-23-after-delivery.md index 442ef300..33e35bc9 100644 --- a/03-DESIGN/01-to-be/47-milestones/G-23-after-delivery.md +++ b/03-DESIGN/01-to-be/47-milestones/G-23-after-delivery.md @@ -53,11 +53,12 @@ deals with it, which is how the list is kept true. 11. **Silent waits met during G's start:** the indexer's first versions fill returns without a word while another fill runs, so a hung fill held every later one silently for two hours; `grants_membership` and `grants_assert` time out after 30 seconds with no log line; the tool runner says a dropped event once per key. -12. **The module graph's edges are dependencies, never verbs or bus subjects** (2026-11-16): a manifest says what its - module depends on, a seat whenever one exists and otherwise a module (a build dependency on a package module, a - program needing another module), and the graph's edges come from that alone. The verb edges of ADR 0614 §2 and §3, - and the cycle exceptions they needed (A-361, A-428, A-437), go; whether `invokes`, `uses` and the `views` forms stay - in a manifest at all is asked with the research on the mesh's accounts, and "each fact is declared in one place". +12. **The module graph's edges are dependencies, never verbs or bus subjects** (2026-11-16; principle 9): a manifest + says what its module depends on, a seat where the need is meant to be interchangeable and otherwise a module (a + build dependency on a package module, a program needing another module), and the graph's edges come from that + alone. The verb edges of ADR 0614 §2 and §3, and the cycle exceptions they needed (A-361, A-428, A-437), go; whether + `invokes`, `uses` and the `views` forms stay in a manifest at all is asked with the research on the mesh's + accounts, and "each fact is declared in one place". ## Met during G's start (2026-11-14) -- 2.54.0