wdi-method 0.4.6 → 0.5.0

package/kit/.constitution/{document → method/document}/templates/structure-document.md

@@ -1,90 +1,90 @@
----
-type: structure
-scope: document
-verified: '{YYYY-MM-DD}'      # the day the tree was actually read
-commit: '{sha}'               # the commit it was read at — staleness is measured against this
----
-
-# Document Structure
-
-<!-- TEMPLATE GUIDE — act on these comments, then delete them.
-
-     This file is DESCRIPTIVE. It states which parts of the corpus actually carry content today.
-     The layers themselves, the placement test, the naming scheme, and slot numbering all belong to
-     corpus-guide.md and MUST NOT be restated here.
-
-     Written and refreshed only by `wdi-init` intent `structure`, never by hand. Rules for both maps live in
-     .constitution/structure-guide.md.
-
-     Same shape as the codebase map: annotated trees, folders complete, ★ inline on the documents
-     that earn it. What differs is the split — the codebase map splits by deployability, this one
-     splits by LAYER, because that is the axis a reader is lost on.
-
-     The five roots are fixed, so the top-level tree is not a discovery. Which sub-folders carry
-     content, which Product Component folders exist, and which slots have been split out of a kernel
-     ARE, and that is what this map is for. -->
-
-## Verified
-
-<!-- One line: date, commit SHA, and how the tree was read. If the commit is no longer an ancestor
-     of HEAD, this map is stale and MUST be refreshed before a gate reads it. -->
-
-## Top level
-
-<!-- The five roots, one line each, with the state of each: populated, or still empty. Mark an empty
-     root as empty rather than dropping it — a dropped root reads as a root that does not exist. -->
-
-```text
-.constitution/                # how we work — {state}
-.control/                     # what currently holds — {state}
-.what/                        # what was promised — {state}
-.how/                         # how it is built — {state}
-_bmad-output/                 # work in progress, not curated — {state}
-```
-
-## Per layer
-
-<!-- One subsection per root that carries content. Annotated tree: sub-folders complete, ★ on the
-     single-copy documents a reader must find first. Per-Product-Component folders are NOT expanded
-     here — the table below owns them, and expanding both means maintaining both. -->
-
-### {layer}
-
-```text
-{layer}/
-├── {folder}/                 # what belongs here
-│   └── {file}                # ★ why this one is key
-└── {folder}/                 # {state}
-```
-
-## Product Components
-
-<!-- One row per PC that actually exists. Both sides are expected: a PC with an SRS and no SDD, or
-     the reverse, is drift and MUST be listed under Findings rather than normalised here. List only
-     the slots that have been split out of a kernel; empty slots stay unlisted. -->
-
-| Product Component | `.what/<pc>/` | `.how/<pc>/` | Slots split out |
-| --- | --- | --- | --- |
-
-## Registries and generated
-
-<!-- Which registry files carry entries and which are still empty skeletons, and which generated
-     tables have been produced. Generated output is never written by hand; naming it here is what
-     makes a hand edit visible. -->
-
-| File | State |
-| --- | --- |
-
-## Findings
-
-<!-- Drift this map surfaced while being derived: a PC on one side only, a supplement with no
-     citation, a folder outside the five roots, a document whose home contradicts corpus-guide.md.
-     Findings are reported, never fixed here — fixing them is `wdi-reconcile` work, or the owning
-     skill's.
-     Cut the section only when it is genuinely empty. -->
-
----
-
-<!-- Keep this legend last, and keep it one line. -->
-
-★ = key document: single-copy, referenced from elsewhere, or the first thing a reader must find.
+---
+type: structure
+scope: document
+verified: '{YYYY-MM-DD}'      # the day the tree was actually read
+commit: '{sha}'               # the commit it was read at — staleness is measured against this
+---
+
+# Document Structure
+
+<!-- TEMPLATE GUIDE — act on these comments, then delete them.
+
+     This file is DESCRIPTIVE. It states which parts of the corpus actually carry content today.
+     The layers themselves, the placement test, the naming scheme, and slot numbering all belong to
+     corpus-guide.md and MUST NOT be restated here.
+
+     Written and refreshed only by `wdi-init` intent `structure`, never by hand. Rules for both maps live in
+     .constitution/method/structure-guide.md.
+
+     Same shape as the codebase map: annotated trees, folders complete, ★ inline on the documents
+     that earn it. What differs is the split — the codebase map splits by deployability, this one
+     splits by LAYER, because that is the axis a reader is lost on.
+
+     The five roots are fixed, so the top-level tree is not a discovery. Which sub-folders carry
+     content, which Product Component folders exist, and which slots have been split out of a kernel
+     ARE, and that is what this map is for. -->
+
+## Verified
+
+<!-- One line: date, commit SHA, and how the tree was read. If the commit is no longer an ancestor
+     of HEAD, this map is stale and MUST be refreshed before a gate reads it. -->
+
+## Top level
+
+<!-- The five roots, one line each, with the state of each: populated, or still empty. Mark an empty
+     root as empty rather than dropping it — a dropped root reads as a root that does not exist. -->
+
+```text
+.constitution/                # how we work — {state}
+.control/                     # what currently holds — {state}
+.what/                        # what was promised — {state}
+.how/                         # how it is built — {state}
+_bmad-output/                 # work in progress, not curated — {state}
+```
+
+## Per layer
+
+<!-- One subsection per root that carries content. Annotated tree: sub-folders complete, ★ on the
+     single-copy documents a reader must find first. Per-Product-Component folders are NOT expanded
+     here — the table below owns them, and expanding both means maintaining both. -->
+
+### {layer}
+
+```text
+{layer}/
+├── {folder}/                 # what belongs here
+│   └── {file}                # ★ why this one is key
+└── {folder}/                 # {state}
+```
+
+## Product Components
+
+<!-- One row per PC that actually exists. Both sides are expected: a PC with an SRS and no SDD, or
+     the reverse, is drift and MUST be listed under Findings rather than normalised here. List only
+     the slots that have been split out of a kernel; empty slots stay unlisted. -->
+
+| Product Component | `.what/<pc>/` | `.how/<pc>/` | Slots split out |
+| --- | --- | --- | --- |
+
+## Registries and generated
+
+<!-- Which registry files carry entries and which are still empty skeletons, and which generated
+     tables have been produced. Generated output is never written by hand; naming it here is what
+     makes a hand edit visible. -->
+
+| File | State |
+| --- | --- |
+
+## Findings
+
+<!-- Drift this map surfaced while being derived: a PC on one side only, a supplement with no
+     citation, a folder outside the five roots, a document whose home contradicts corpus-guide.md.
+     Findings are reported, never fixed here — fixing them is `wdi-reconcile` work, or the owning
+     skill's.
+     Cut the section only when it is genuinely empty. -->
+
+---
+
+<!-- Keep this legend last, and keep it one line. -->
+
+★ = key document: single-copy, referenced from elsewhere, or the first thing a reader must find.

package/kit/.constitution/{language-guide.md → method/language-guide.md}

@@ -6,7 +6,7 @@ status: Accepted
 
 **Loaded when:** naming anything — a code identifier, a database field, a file, a folder.
 
-Which language a name is written in, and nothing else. Case style → `codebase/conventions-guide.md`;
+Which language a name is written in, and nothing else. Case style → `../project/codebase-conventions-guide.md`;
 legal characters → `structure-guide.md`; the right domain word → `.control/product-glossary.md`.
 
 ## Code MUST be English
@@ -71,4 +71,4 @@ and they travel to every repo through the `wdi-method` package.
 ## A wrong name MUST NOT be fixed inside an unrelated change
 
 A rename reaches the schema, the API, and every caller. It gets a change of its own, or a ratified
-row in `codebase/brownfield-guide.md`. A **new** name MUST NOT copy a wrong neighbour.
+row in `../project/codebase-brownfield-guide.md`. A **new** name MUST NOT copy a wrong neighbour.

package/kit/.constitution/{repo-guide.md → method/repo-guide.md}

@@ -82,9 +82,22 @@ document.
 
 ## How the method arrives
 
-Method files in `.constitution/` (except this product's Articles 1, 2, and 5, `codebase/*-guide.md`
-once `Accepted`, and any extra file this repo added), the `wdi-*` skills, and `_bmad/custom/*.toml`
-arrive from the public WDI Method package via `npx wdi-method install` / `update`.
+Method files in `.constitution/`, the `wdi-*` skills, and `_bmad/custom/*.toml` arrive from the
+public WDI Method package via `npx wdi-method install` / `update`.
+
+**Three paths inside `.constitution/` are this product's, not the method's.** Each is seeded once
+when absent and then never written again — an update MUST NOT touch one, and `promote` MUST NOT
+carry one back into the package:
+
+| Path | Holds |
+|---|---|
+| `constitution.md` | This product's Articles 1, 2, and 5 |
+| `codebase/*-guide.md` | This product's stack, conventions, and brownfield rules — at **any** `status:`, including `Draft`, which is when they are being written |
+| `project/` | Any rule that binds only this product |
+
+The seam is the **path**, never a marked region inside a generic file. `AGENTS.md` uses a marked
+block because it is one file with no alternative; `.constitution/` has fifty-odd, and blocks inside
+them would make every update perform surgery in every file.
 
 At **read time** this repo is self-contained: every file the rules need is here, readable with the
 repo alone. At **change time** the method has one published writer — the WDI Method package. Two

package/kit/.constitution/{scripts → method/scripts}/timeline.py

@@ -419,7 +419,7 @@ def gantt(timeline: dict) -> str:
     return "\n".join(lines) + "\n"
 
 
-HEADER = ("> Generated by `.constitution/scripts/timeline.py --generate`. "
+HEADER = ("> Generated by `.constitution/method/scripts/timeline.py --generate`. "
           "MUST NOT be hand-edited.\n")
 
 
@@ -570,7 +570,7 @@ def publish(c: Corpus, report: dict, kind: str, asof: dt.date) -> tuple[Path, st
         "since": report["since"],
         "sha": report["sha"],
         "promise_progress": report["promise_progress"],
-        "generated_by": ".constitution/scripts/timeline.py",
+        "generated_by": ".constitution/method/scripts/timeline.py",
     })
     path.write_text(f"---\n{front}---\n\n{render_report(report, f'Report {name}')}{NOTE}",
                     encoding="utf-8")