@afokapu/atdd-bun 0.10.32 → 0.10.33

package/README.md

@@ -19,8 +19,8 @@ bun run atdd-bun init
 ```
 
 `init` installs the Git hooks (`.githooks/`), the CI workflow (`.github/workflows/atdd-bun.yml`),
-the agent skill (`.agents/skills/atdd/`, `.claude/skills/atdd/`), a managed block in `AGENTS.md`
-and `CLAUDE.md`, and `atdd-bun.integrity.test.ts`. Commit all of them. Nothing is overwritten
+a managed block in `AGENTS.md` and `CLAUDE.md`, and `atdd-bun.integrity.test.ts`. Commit all of
+them. Nothing is overwritten
 without `--replace`, and adding the dependency changes nothing until you run `init`.
 
 Then require the workflow's job in the GitHub branch ruleset, so it gates merges.
@@ -33,7 +33,8 @@ Then require the workflow's job in the GitHub branch ruleset, so it gates merges
 | `atdd-bun init [--replace]` | Install hooks, CI, agent files and the integrity test |
 | `atdd-bun hooks <install\|uninstall\|status>` | Manage only the Git hooks |
 | `atdd-bun ci <init\|status>` | Manage only the CI workflow |
-| `atdd-bun agent <init\|status>` | Manage only the skills and the `AGENTS.md`/`CLAUDE.md` block |
+| `atdd-bun agent <init\|status>` | Manage the `AGENTS.md`/`CLAUDE.md` instruction block |
+| `atdd-bun profiles registry [--check]` | Generate (or verify) deterministic profile-scoped convention registries |
 | `atdd-bun integrity [init\|status]` | Check that the toolkit and its generated files are unmodified |
 | `atdd-bun docs journeys [--check]` | Generate (or verify) the journey, interlocking and train views |
 | `atdd-bun worktree <start\|finish\|status>` | Optional linked-worktree policy for agent work |
@@ -104,10 +105,12 @@ frontend:
   breakpoints: [480, 768, 1024, 1280]
 registry_paths: ["plan/_*.yaml", "contracts/_*.yaml"]   # exempt from micro-commit size caps only
 max_registry_removed_lines: 350                        # larger removals need [mass-delete-approved]
-worktrees: { enabled: false }
+worktrees: { enabled: false }                 # enabled defaults to ~/Github/worktrees/<repo>/...
 release: { enabled: false }
 ```
 
+When enabled without overrides, a primary checkout at `~/Github/<repo>` uses linked worktrees at `~/Github/worktrees/<repo>/<branch>`. The defaults use `primary_directory: .` (the current primary checkout) and `root: ../worktrees/{repo}`; `{repo}` expands to the primary checkout's directory name. Repositories that need another layout can set either field explicitly.
+
 ## Docs-site theme
 
 A repository that publishes its AsciiDoc docs as a site does not need its own theme.
@@ -125,16 +128,17 @@ To re-theme it, override its custom properties (`--paper`, `--ink`, `--accent`,
 
 ## Agents and integrity
 
-The skill gives every coding agent the lifecycle PLAN → RED → GREEN → SMOKE → REFACTOR → TRACE and
-the profile that gates each stage. The block in `AGENTS.md` and `CLAUDE.md` adds the rules: never
-modify the toolkit itself, only the configuration it offers; turn profiles on or off in
-`profiles:` only when the user asks.
+The managed block directs an agent to the profile-preset convention, then to the selected profile's
+generated registry under `conventions/_profiles/`. Each registry is a deterministic projection of
+the profile's detector manifests, convention paths, and direct relationship edges, so the agent
+opens only the conventions relevant to its task. It also prevents the agent from modifying the
+toolkit or changing profile activation without the user's choice.
 
 `atdd-bun integrity`, run by the generated test and first in CI on a clean install, fails when:
 
 - the installed package differs from its published hashes;
 - the dependency is not an npm registry version;
-- a generated file (workflow, skills, instruction block, integrity test) was edited;
+- a generated file (workflow, instruction block, integrity test) was edited;
 - `atdd-bun.yaml` is looser than on the base branch (after the first explicit `profiles:` list,
   dropping a profile or the list counts).
 
@@ -144,7 +148,7 @@ Each finding names its restore command.
 
 Every merge to this package's `main` is published to npm with provenance as the next patch and
 tagged `vX.Y.Z`. Rules and hooks change as soon as a repository upgrades the dependency. To refresh
-the skills and instruction blocks on every install, add this to the repository's own
+the managed instruction blocks on every install, add this to the repository's own
 `package.json`:
 
 ```json

package/conventions/_profiles/architecture.yaml

@@ -0,0 +1,190 @@
+schema_version: "1.0.0"
+profile: "architecture"
+implementations:
+  - "bun_clean_architecture_detector"
+conventions:
+  - rule_id: "coder.bun.boundaries-http-client"
+    path: "conventions/coder.bun/coder.bun.boundaries-http-client.convention.yaml"
+  - rule_id: "coder.bun.commons-application-no-integration"
+    path: "conventions/coder.bun/coder.bun.commons-application-no-integration.convention.yaml"
+  - rule_id: "coder.bun.commons-cross-feature-imports-in"
+    path: "conventions/coder.bun/coder.bun.commons-cross-feature-imports-in.convention.yaml"
+  - rule_id: "coder.bun.commons-domain-no-framework-import"
+    path: "conventions/coder.bun/coder.bun.commons-domain-no-framework-import.convention.yaml"
+  - rule_id: "coder.bun.commons-domain-no-outbound"
+    path: "conventions/coder.bun/coder.bun.commons-domain-no-outbound.convention.yaml"
+  - rule_id: "coder.bun.composition-consumer"
+    path: "conventions/coder.bun/coder.bun.composition-consumer.convention.yaml"
+  - rule_id: "coder.bun.composition-root"
+    path: "conventions/coder.bun/coder.bun.composition-root.convention.yaml"
+  - rule_id: "coder.bun.design-hierarchy-import"
+    path: "conventions/coder.bun/coder.bun.design-hierarchy-import.convention.yaml"
+  - rule_id: "coder.bun.dto-mapper"
+    path: "conventions/coder.bun/coder.bun.dto-mapper.convention.yaml"
+  - rule_id: "coder.bun.dto-placement"
+    path: "conventions/coder.bun/coder.bun.dto-placement.convention.yaml"
+  - rule_id: "coder.bun.dto-purity"
+    path: "conventions/coder.bun/coder.bun.dto-purity.convention.yaml"
+  - rule_id: "coder.bun.layer-naming"
+    path: "conventions/coder.bun/coder.bun.layer-naming.convention.yaml"
+relationships:
+  - confidence: 1
+    constraint: "discretionary"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "Confines outbound transport to integration, which is the hierarchy's own home for it."
+    source_ref: "coder.bun.boundaries-http-client"
+    strength: "minor"
+    target_ref: "coder.bun.design-hierarchy-import"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "A specialization: the general inward-only rule, narrowed to the commons application tree."
+    source_ref: "coder.bun.commons-application-no-integration"
+    strength: "important"
+    target_ref: "coder.bun.design-hierarchy-import"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "The hierarchy governs VERTICAL edges between layers; this governs HORIZONTAL ones between sibling features."
+    source_ref: "coder.bun.commons-cross-feature-imports-in"
+    strength: "important"
+    target_ref: "coder.bun.design-hierarchy-import"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "Outbound bans project LAYERS; this additionally bans runtime machinery, so the domain runs with no server started."
+    source_ref: "coder.bun.commons-domain-no-framework-import"
+    strength: "important"
+    target_ref: "coder.bun.commons-domain-no-outbound"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "A specialization: the general inward-only rule, narrowed to the commons domain tree."
+    source_ref: "coder.bun.commons-domain-no-outbound"
+    strength: "important"
+    target_ref: "coder.bun.design-hierarchy-import"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "Two halves of one discipline: where wiring MAY happen, and that consumers must ACCEPT what they are given."
+    source_ref: "coder.bun.composition-consumer"
+    strength: "critical"
+    target_ref: "coder.bun.composition-root"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "Reachability is measured FROM the structural roots that composition-root confines wiring to."
+    source_ref: "coder.bun.dead-code-reachability"
+    strength: "important"
+    target_ref: "coder.bun.composition-root"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "code layering and design-system layering: both require dependencies to point in one direction"
+    source_ref: "coder.bun.design-dependency-flow"
+    strength: "important"
+    target_ref: "coder.bun.design-hierarchy-import"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "The mapper translates the type whose home this rule fixes; both keep the boundary in one place."
+    source_ref: "coder.bun.dto-mapper"
+    strength: "minor"
+    target_ref: "coder.bun.dto-placement"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "Purity governs a DTO's shape, placement its home; a pure DTO in the wrong layer still couples the boundary."
+    source_ref: "coder.bun.dto-placement"
+    strength: "important"
+    target_ref: "coder.bun.dto-purity"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "The layer segment this rule validates is what the layering rules read to judge an import."
+    source_ref: "coder.bun.green-urn-layer"
+    strength: "important"
+    target_ref: "coder.bun.design-hierarchy-import"
+    type: "enables"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "Both govern server.ts as the composition root: one that collaborators are only instantiated there, the other that the JOURNEY_MAP it holds agrees with the declared route space."
+    source_ref: "coder.bun.interlocking-bilateral-binding"
+    strength: "minor"
+    target_ref: "coder.bun.composition-root"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "The layering rules can only read a layer that the naming rule guarantees is declared."
+    source_ref: "coder.bun.layer-naming"
+    strength: "critical"
+    target_ref: "coder.bun.design-hierarchy-import"
+    type: "enables"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "One governs the server you run, the other the client you call out with."
+    source_ref: "coder.bun.runtime-server-is-bun-serve"
+    strength: "minor"
+    target_ref: "coder.bun.boundaries-http-client"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd-extensions@3aa141e:official/atdd.extension.coder.bun/relationships.yaml"
+    reason: "server.ts is a composition root precisely BECAUSE Bun.serve is the assembly point of a full-stack Bun app."
+    source_ref: "coder.bun.runtime-server-is-bun-serve"
+    strength: "important"
+    target_ref: "coder.bun.composition-root"
+    type: "enables"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "vendor SDKs stay in infrastructure adapters as framework imports stay out of domain"
+    source_ref: "coder.bun.telemetry-vendor-sdk"
+    strength: "important"
+    target_ref: "coder.bun.commons-domain-no-framework-import"
+    type: "runs_alongside"