@afokapu/atdd-bun 0.10.32 → 0.10.34

package/conventions/_profiles/topology.yaml

@@ -0,0 +1,192 @@
+schema_version: "1.0.0"
+profile: "topology"
+implementations:
+  - "atdd_topology"
+conventions:
+  - rule_id: "atdd-bun.topology.e2e-location"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.e2e-location.convention.yaml"
+  - rule_id: "atdd-bun.topology.feature-source-coverage"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.feature-source-coverage.convention.yaml"
+  - rule_id: "atdd-bun.topology.feature-test-coverage"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.feature-test-coverage.convention.yaml"
+  - rule_id: "atdd-bun.topology.plan-location"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.plan-location.convention.yaml"
+  - rule_id: "atdd-bun.topology.source-location"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.source-location.convention.yaml"
+  - rule_id: "atdd-bun.topology.test-location"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.test-location.convention.yaml"
+  - rule_id: "planner.feature.wagon-link"
+    path: "planner-nodes/nodes/planner.feature.wagon-link.convention.yaml"
+  - rule_id: "planner.wagon.features"
+    path: "planner-nodes/nodes/planner.wagon.features.convention.yaml"
+relationships:
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "journey E2E paths are derived from the journeys the plan declares"
+    source_ref: "atdd-bun.topology.e2e-location"
+    strength: "critical"
+    target_ref: "planner.journey.definition"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "every route has an end-to-end proof: at its canonical path, and exercising the production runner"
+    source_ref: "atdd-bun.topology.e2e-location"
+    strength: "important"
+    target_ref: "tester.bun.interlocking-route-coverage"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "on a frontend journey a browser spec is the route's end-to-end proof"
+    source_ref: "atdd-bun.topology.e2e-location"
+    strength: "important"
+    target_ref: "tester.htmx.train-e2e-coverage"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "coverage counts only source placed beneath its feature"
+    source_ref: "atdd-bun.topology.feature-source-coverage"
+    strength: "critical"
+    target_ref: "atdd-bun.topology.source-location"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a feature with WMBTs is implemented and tested"
+    source_ref: "atdd-bun.topology.feature-test-coverage"
+    strength: "important"
+    target_ref: "atdd-bun.topology.feature-source-coverage"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "coverage counts only tests placed beneath their feature and bound to its acceptances"
+    source_ref: "atdd-bun.topology.feature-test-coverage"
+    strength: "critical"
+    target_ref: "atdd-bun.topology.test-location"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "where a feature lives and which wagon owns it: the same ownership, by path and by link"
+    source_ref: "atdd-bun.topology.plan-location"
+    strength: "important"
+    target_ref: "planner.feature.wagon-link"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "features are placed by path once the wagon's feature decomposition is declared"
+    source_ref: "atdd-bun.topology.plan-location"
+    strength: "critical"
+    target_ref: "planner.wagon.features"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "source is placed beneath a feature the plan declares at its canonical path"
+    source_ref: "atdd-bun.topology.source-location"
+    strength: "critical"
+    target_ref: "atdd-bun.topology.plan-location"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the same component URN, read for its grammar and for where the file must live"
+    source_ref: "atdd-bun.topology.source-location"
+    strength: "important"
+    target_ref: "coder.bun.green-urn-pattern"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "tests are placed beneath a feature the plan declares"
+    source_ref: "atdd-bun.topology.test-location"
+    strength: "critical"
+    target_ref: "atdd-bun.topology.plan-location"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the acceptance a test binds, read for presence and for whether a WMBT declares it"
+    source_ref: "atdd-bun.topology.test-location"
+    strength: "important"
+    target_ref: "tester.bun.acceptance-binding-declared"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "external"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "wagon-feature coverage reads the wagon features manifest"
+    source_ref: "planner.coverage.bidirectional-coverage-between-wagons"
+    strength: "important"
+    target_ref: "planner.wagon.features"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_finish"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a feature belongs to exactly one wagon"
+    source_ref: "planner.feature.definition"
+    strength: "critical"
+    target_ref: "planner.feature.wagon-link"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "external"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a feature is registered in its wagon _features.yaml"
+    source_ref: "planner.feature.wagon-link"
+    strength: "important"
+    target_ref: "planner.wagon.features"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_finish"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a wagon groups the features that decompose it"
+    source_ref: "planner.wagon.definition"
+    strength: "minor"
+    target_ref: "planner.wagon.features"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the features-manifest rule uses the urn-array features format"
+    source_ref: "planner.wagon.features-format"
+    strength: "important"
+    target_ref: "planner.wagon.features"
+    type: "runs_alongside"

package/conventions/_profiles/traceability.yaml

@@ -0,0 +1,94 @@
+schema_version: "1.0.0"
+profile: "traceability"
+implementations:
+  - "atdd_traceability_closure"
+conventions:
+  - rule_id: "traceability.plan.executable-acceptance-has-test"
+    path: "conventions/traceability/traceability.plan.executable-acceptance-has-test.convention.yaml"
+  - rule_id: "traceability.source.tested-by-present"
+    path: "conventions/traceability/traceability.source.tested-by-present.convention.yaml"
+  - rule_id: "traceability.source.tested-by-resolves"
+    path: "conventions/traceability/traceability.source.tested-by-resolves.convention.yaml"
+  - rule_id: "traceability.test.binding-resolves"
+    path: "conventions/traceability/traceability.test.binding-resolves.convention.yaml"
+relationships:
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a test can bind an acceptance only through the acc: identity the WMBT gives it"
+    source_ref: "atdd-bun.planner.acceptance-identity"
+    strength: "critical"
+    target_ref: "traceability.test.binding-resolves"
+    type: "enables"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "traceability joins with the building preset because executable-acceptance-has-test reports every acceptance until tests exist"
+    source_ref: "atdd-bun.profiles.presets"
+    strength: "minor"
+    target_ref: "traceability.plan.executable-acceptance-has-test"
+    type: "follows"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "telemetry items follow the acceptance-has-test discipline"
+    source_ref: "tester.bun.telemetry-required-item-coverage"
+    strength: "important"
+    target_ref: "traceability.plan.executable-acceptance-has-test"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the two directions of plan-test closure: every acceptance has a test, and every test names an acceptance that exists"
+    source_ref: "traceability.plan.executable-acceptance-has-test"
+    strength: "critical"
+    target_ref: "traceability.test.binding-resolves"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the same Tested-By header, read by the closure check and by the coder header rule"
+    source_ref: "traceability.source.tested-by-present"
+    strength: "important"
+    target_ref: "coder.bun.green-header-tested-by"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a testing witness can only resolve once one is declared"
+    source_ref: "traceability.source.tested-by-resolves"
+    strength: "critical"
+    target_ref: "traceability.source.tested-by-present"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "source-to-test and test-to-plan links chain into plan to test to implementation closure"
+    source_ref: "traceability.source.tested-by-resolves"
+    strength: "important"
+    target_ref: "traceability.test.binding-resolves"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a test's binding must be declared before it can be resolved against the plan"
+    source_ref: "traceability.test.binding-resolves"
+    strength: "critical"
+    target_ref: "tester.bun.acceptance-binding-declared"
+    type: "requires"

package/conventions/_profiles/workflow.yaml

@@ -0,0 +1,7 @@
+schema_version: "1.0.0"
+profile: "workflow"
+implementations: []
+conventions:
+  - rule_id: "atdd-workflow.workflow.lifecycle"
+    path: "../atdd-workflow/conventions/atdd-workflow.workflow/atdd-workflow.workflow.lifecycle.convention.yaml"
+relationships: []

package/conventions/atdd-bun.profiles/atdd-bun.profiles.presets.convention.yaml

@@ -8,11 +8,32 @@ statement: >-
 terms:
 - term_id: presets
   text: >-
-    Planning: planner (plus docs when the repository keeps documentation under docs/). Building, once RED starts: add coder, tester, traceability, security; add htmx and design for a web UI, and interlocking once trains have a runtime. Instrumenting: add telemetry.
+    Planning: planner (plus docs when the repository keeps documentation under docs/). Building, once RED starts: add coder, tester, traceability, security; add htmx and design for a web UI, and interlocking once trains have a runtime. Instrumenting: add telemetry. Coordinating durable multi-agent work: after @afokapu/atdd-workflow is installed locally, add workflow.
   values:
     planning: [planner]
     building: [coder, tester, traceability, security]
     instrumenting: [telemetry]
+    coordinating: [workflow]
+- term_id: profile_registries
+  text: >-
+    A deterministic, profile-scoped projection of the detector manifests, convention paths, and
+    direct relationship edges. Read the selected profile's registry instead of the complete graph.
+  values:
+    architecture: conventions/_profiles/architecture.yaml
+    coder: conventions/_profiles/coder.yaml
+    design: conventions/_profiles/design.yaml
+    docs: conventions/_profiles/docs.yaml
+    htmx: conventions/_profiles/htmx.yaml
+    interlocking: conventions/_profiles/interlocking.yaml
+    metrics: conventions/_profiles/metrics.yaml
+    planner: conventions/_profiles/planner.yaml
+    runtime: conventions/_profiles/runtime.yaml
+    security: conventions/_profiles/security.yaml
+    telemetry: conventions/_profiles/telemetry.yaml
+    tester: conventions/_profiles/tester.yaml
+    topology: conventions/_profiles/topology.yaml
+    traceability: conventions/_profiles/traceability.yaml
+    workflow: conventions/_profiles/workflow.yaml
 content:
   summary: >-
     A goal is easier to name than a profile. The presets map what the user is doing to the profiles that judge it, in the order the work creates what they check.
@@ -20,8 +41,9 @@ content:
     planner alone keeps the plan consistent: it parses, validates and resolves the plan with nothing else present. traceability judges the links from the plan to tests and source, so before tests exist it can only report that every acceptance is untested; it joins with building, and from then on it also catches a plan change that orphans a test.
     security joins with the first code, not at release: a secret committed during GREEN stays in history.
     coder already bundles the architecture, metrics, runtime, design and responsive detectors, so those need no later preset.
+    workflow is optional: it governs durable seats, tasks and threads only when the repository has the locally installed @afokapu/atdd-workflow companion. It is deliberately not selected by a default profile list.
   fix_hint: |
-    At a stage whose preset is missing, ask what the user wants to do (planning, building, or instrumenting), recommend that preset and say it can be adopted step by step, then write the chosen list to profiles: in atdd-bun.yaml.
+    At a stage whose preset is missing, ask what the user wants to do (planning, building, instrumenting, or coordinating), recommend that preset and say it can be adopted step by step, then write the chosen list to profiles: in atdd-bun.yaml.
   exceptions:
   - >-
     A profile can always be run by name to see what it would report (atdd-bun coder); only profiles: decides what the repository is governed by.

package/integrity.json

@@ -1,10 +1,25 @@
 {
-  "version": "0.10.32",
+  "version": "0.10.34",
   "files": {
     "HOOK_AUDIT.md": "5329d840db37671b1918f688ead26865473b87db73dbc75f7c8b2a8bbe8d6d43",
     "PLANNER_PORT.md": "fb5935bac8b7ac18994de21e43ace3a5ef8cd55f85b0e3349fca261280054f11",
-    "README.md": "78a1acc1f18f84a567448051bec90f676e3cab7956d971abc97a6201c96fc409",
+    "README.md": "edcd36ebed5853c412c89ed998cd198f7a58237a68dcf37c14be5f7f5c0e9ff4",
     "bunfig.toml": "b9fc65eca9014c5179380259d70e76385a6a80788fa9a2df5fb3eaa5554fd2fe",
+    "conventions/_profiles/architecture.yaml": "f1808768b720a4e476047e4a0912002ca673946562cea9aeef5d0c214828d93a",
+    "conventions/_profiles/coder.yaml": "c38e46405ddd7e82fd7679246d027821db19db86c307a23ce5d14f18165d0699",
+    "conventions/_profiles/design.yaml": "25a02a67152d49728ad3517f6510da7285116fa69c56cbda55613a7cfcfd3b89",
+    "conventions/_profiles/docs.yaml": "05485c3b32f1757e77c42e331eec1db651cb52ef57fc4e8607bb2f73b056cbb3",
+    "conventions/_profiles/htmx.yaml": "38fc8b3e1a53429e16977ed63e83e751b203deffe9b338ea171050fb64641559",
+    "conventions/_profiles/interlocking.yaml": "46a2a4fb2eb537941c991ef4178d009a30d14f84279e525ca0d0887d3239047d",
+    "conventions/_profiles/metrics.yaml": "6028a227ccdef6d97ff10602f1a146eb73fd02b0a03ebce6726540fa30540f3c",
+    "conventions/_profiles/planner.yaml": "b3938783793c34f832968b7293b7c301f3e1deff5f06536a078168c911d0d089",
+    "conventions/_profiles/runtime.yaml": "48fae0d31fb9228b8819243c264721037720acb1763bf27f74325c14ffef46d4",
+    "conventions/_profiles/security.yaml": "38eb6b17e35e1439fe4f19c8ccf3ba1b2f18759a984dd1d33171ec3a29128876",
+    "conventions/_profiles/telemetry.yaml": "4c07c693357fad420df0df82a3ad196cd159df017fec6b98244841530516dfd9",
+    "conventions/_profiles/tester.yaml": "348183eee5298cbb843031f6c41c3f9d0a725b11b3c66e154b47c9b340a72666",
+    "conventions/_profiles/topology.yaml": "08df698c2e5419e8f7faa83f5f15c3ba9c085cc2ce72579624eb24962a6b8612",
+    "conventions/_profiles/traceability.yaml": "adce93fb8392307685a01bec85e60534c59a9f4f0e4f8ea4767d79d22cf80878",
+    "conventions/_profiles/workflow.yaml": "162404ac861c77d1d4f4f2a8b731eb80f75677197636f96d198909661247b229",
     "conventions/atdd-bun.planner/atdd-bun.planner.acceptance-identity.convention.yaml": "81c5c773d5ee15e8d99a2c237aa9846b110b2533df45ebf407d0e3ec6ed3dd03",
     "conventions/atdd-bun.planner/atdd-bun.planner.identity-required.convention.yaml": "e96d7c1455d0c221072d82e7f2b55da1c4f9ceb17718eb6ed96affdeef37675b",
     "conventions/atdd-bun.planner/atdd-bun.planner.identity-unique.convention.yaml": "409ba1d035ed46bc45f3627b62fd3a6a5967d984cc4c071c41be3f3fa887c6d6",
@@ -13,7 +28,7 @@
     "conventions/atdd-bun.planner/atdd-bun.planner.reference-resolves.convention.yaml": "b96927d269692c29c02fee38ecbeb999480791f8dc7486c4072a9ff30183d7d6",
     "conventions/atdd-bun.planner/atdd-bun.planner.schema.convention.yaml": "16d0a26451758b759e6ca1f5b4f38ae1feff129688306ffcc2f70f6d3974b591",
     "conventions/atdd-bun.planner/atdd-bun.planner.train-wagon-resolves.convention.yaml": "6410e248351e701dcba38c671c07c4d8f6d67927984ed4d18e567abd1eb1f3f0",
-    "conventions/atdd-bun.profiles/atdd-bun.profiles.presets.convention.yaml": "a5885bfa387d0abbc4694ea2d0cf1f3639d5b45588707d4f70f2f2be4e12e847",
+    "conventions/atdd-bun.profiles/atdd-bun.profiles.presets.convention.yaml": "7ef8f1bc1a9c148f93a1929dbb854c467a508a51a7c7b2b3f49c245fd1c0c734",
     "conventions/atdd-bun.topology/atdd-bun.topology.e2e-location.convention.yaml": "3a3b991bc851b86d597636200f5cb10a0defda3920348860cdca28955ab91f4c",
     "conventions/atdd-bun.topology/atdd-bun.topology.feature-source-coverage.convention.yaml": "2b64093f1e7f1fe0e2edcadf12e560fa80cecec19536abaa5bf09af362c6694e",
     "conventions/atdd-bun.topology/atdd-bun.topology.feature-test-coverage.convention.yaml": "279be57399c9b79a1bd758414076e3053d67b7d4a7fcbbb950ea12d1201effeb",
@@ -1176,26 +1191,26 @@
     "planner-schemas/wagon.schema.json": "57b98f1ade998d745538eb3d72fb3014a50042006870f90bce47028eea336eb4",
     "planner-schemas/wmbt.schema.json": "7a3a5693bfcf01340667c2be4a3c48e74f34b1af7e8dc13372c0de06b7f4fe12",
     "relationships.yaml": "26dd50489d7cbd45400937a8949d6ff77cdd4400bfa828d6b7a17e90c64c879b",
-    "src/agent.ts": "009d3170752ded12e9e3d4f7f07fd68d4bab821046714ad68cea428581343c67",
+    "src/agent.ts": "39ca8b3183063c60e00eb96e5629d0397aeb83cc82d4c4bc32c01715c906649b",
     "src/ci.ts": "67e54d2cbfc44a9e42837d5e750af526d6255c539d3c452a4d5fca3226c0d9ac",
-    "src/cli.ts": "09e6b4bdebef32ff482a12182e2efbc2e42424ff854e813a10efd3764e45d4fc",
+    "src/cli.ts": "cbc50f1e7fc7d0935f78230b7da6e232ed7ee6f04828e015c599fb6f6edcbfa2",
     "src/docs-capability.ts": "bdeeb414649049b1cd4fa8008cada3a576318be51c43bec91bfa46a8e250c270",
-    "src/enforce.ts": "45c473ffec9f565fba24df2a7db6564d76ee885cd4b0ab8b34bc14b7f2bcc7b2",
-    "src/hooks.ts": "9779eb48f9d0cb6234c33f6616f98dde6583d2ee03ac3c19f3ace2d156af26d0",
-    "src/index.ts": "b3cc97f9867bd605aefa95650a6b8b773e32e6e52e58792d0dbf6736dd3406be",
-    "src/integrity.ts": "3a74cc03bbdebf83d607073a4a13ab4afd4a163c2307062ed137d7d21e38b988",
+    "src/enforce.ts": "8b22a3ac30fdd35c9caa4c23f064498293a628a342d590fca1f2040ee3a8ea05",
+    "src/hooks.ts": "0b4ca8c857e637bbd144e737e78eda924e3cba7b038c0abe5e6916d200d73068",
+    "src/index.ts": "4081f8b08d1d3ee9e15a9964143e53d9cfb94a5616ab3e58a180d24cc16dc381",
+    "src/integrity.ts": "44ebe101933e8b1a42c563acdffcaf7a24baa4861eb8731a914bc51500d0a93d",
     "src/journey-docs.ts": "994d229376244c84212cff951032823068a76565dd2fd427b9d44e341bd14853",
     "src/planner-kernel.ts": "5d3f5305fb59becb2cc97d8a03aca6b104f385805d91cc0410856e289dd6fbb1",
     "src/planner-schema-validator.ts": "ce529c0936171075e93c7539b3655fe895a98dd2973ebda5775958e6ebc316d9",
     "src/planner-validators.ts": "99adeb65f579af923c11f21a8f55cfb9993b007fd8df59c5f764696b55379cfc",
+    "src/profile-registry.ts": "716ef6e75e8e6eb14ffee37095b4fc9b38ddba2170fb84e7f06476863c3c02a5",
     "src/register.ts": "6a2f1c6b8df0dc9c8f45df8ec9fac2be29044e048b08c8ffe423410e94dadedd",
     "src/release.ts": "7b0fe444ee81f476f53b9c21b6c347ef588ee616c60211419cf984132be768ba",
-    "src/setup.ts": "2dbdddec898e9a3779889f3491eaa1423c4427c9ec63167663245b3ae4db1e6f",
+    "src/setup.ts": "38233265afedc63499bbef3b5403889651add335a70efd3813254ba53f4fc4fe",
     "src/telemetry-plan.ts": "cdb1e8bfff414f3ea81977388973da2cf6d89567d9e060dc9d5989a33600f153",
     "src/topology.ts": "9779ee48e1c453abb76363163d4ab363463fa14e359571139f6d1f1fcc51ae2c",
-    "templates/agents/AGENTS.block.md": "d7f6013ef7b1793f236b610f78f2898f6c10c60751f671ff2c4b72d49b4f6011",
+    "templates/agents/AGENTS.block.md": "978ea89e1469f0a89a6ef6e4ac40bdc11ae856bb2754069743758ba204c395a1",
     "templates/agents/atdd-bun.integrity.test.ts": "dec6f6e5f65a08d9512fc703b367c163f8c9da1f6aa7fd466835c1ec30348a41",
-    "templates/agents/atdd/SKILL.md": "8f36d7d571aa17beb03df5e620ff837be73eb21a4e73dabd2c12188d2b378022",
     "templates/docs/site.css": "482b3427e3a3cb02a85dc85cfbeac80592dfd53abf42fc92d6ea7071f22afc95",
     "templates/github/atdd-bun-release.yml": "d9547e9e6ef3ae010d53d55314f6a54567f88bd900f7e50d994cd308601d2684",
     "templates/github/atdd-bun.yml": "404dc06b6ff4faf5eab909f9f77bac0ae58163d810c3928c4353b1f4b3529048"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afokapu/atdd-bun",
-  "version": "0.10.32",
+  "version": "0.10.34",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/afokapu/atdd-bun.git"
@@ -39,6 +39,7 @@
     "ajv-formats": "^3.0.1"
   },
   "devDependencies": {
+    "@afokapu/atdd-workflow": "^0.1.7",
     "@axe-core/playwright": "^4.13.0",
     "@playwright/test": "^1.63.0"
   }

package/src/agent.ts

@@ -1,26 +1,26 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { readFile, rm, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
+import { join, resolve } from "node:path";
 
 const root = resolve(import.meta.dir, "..");
 const version = (await Bun.file(join(root, "package.json")).json() as { version: string }).version;
 const render = async (path: string) => (await readFile(join(root, "templates/agents", path), "utf8")).replace("{{VERSION}}", version);
-// .agents/skills is the vendor-neutral Agent Skills path (Codex, Copilot, Cursor, Gemini CLI, …); .claude/skills is Claude Code's.
-const skillPaths = [".agents/skills/atdd/SKILL.md", ".claude/skills/atdd/SKILL.md"];
+const legacySkillPaths = [".agents/skills/atdd/SKILL.md", ".claude/skills/atdd/SKILL.md"];
 // AGENTS.md is read by Codex, Cursor and most agents; CLAUDE.md by Claude Code. Both carry the same block.
 export const instructionPaths = ["AGENTS.md", "CLAUDE.md"];
 const block = /<!-- atdd-bun:start[\s\S]*?<!-- atdd-bun:end -->\n?/;
+const generatedSkill = /<!-- Generated by @afokapu\/atdd-bun /;
 /** `current` with the managed block replaced, or appended after at least one blank line; `current` itself is kept. */
 const withBlock = (current: string, managed: string) => block.test(current) ? current.replace(block, managed) : `${current}${current ? "\n\n".slice(current.match(/\n{0,2}$/)![0].length) : ""}${managed}`;
 
-/** Write the ATDD skill for every agent and a managed pointer block in AGENTS.md and CLAUDE.md. Existing files
- * and an existing block are kept unless `replace`; the rest of each instruction file is never touched. */
+/** Write the managed ATDD block in AGENTS.md and CLAUDE.md. Existing files and an existing block are kept unless
+ * `replace`; the rest of each instruction file is never touched. Generated legacy skills are retired automatically. */
 export async function agentInit(repo = process.cwd(), replace = false) {
-  const written: string[] = [], kept: string[] = [];
-  for (const path of skillPaths) {
+  const written: string[] = [], kept: string[] = [], retired: string[] = [];
+  for (const path of legacySkillPaths) {
     const output = join(repo, path);
-    if (existsSync(output) && !replace) { kept.push(output); continue; }
-    await mkdir(dirname(output), { recursive: true }); await writeFile(output, await render("atdd/SKILL.md")); written.push(output);
+    if (!existsSync(output) || (!replace && !generatedSkill.test(await readFile(output, "utf8")))) continue;
+    await rm(output); retired.push(output);
   }
   const managed = await render("AGENTS.block.md");
   for (const path of instructionPaths) {
@@ -28,12 +28,12 @@ export async function agentInit(repo = process.cwd(), replace = false) {
     if (block.test(current) && !replace) { kept.push(file); continue; }
     await writeFile(file, withBlock(current, managed)); written.push(file);
   }
-  if (!written.length) return { ok: false, message: `${kept.join(", ")} exist; use --replace` };
-  return { ok: true, message: written.join("\n") };
+  if (!written.length && !retired.length) return { ok: false, message: `${kept.join(", ")} exist; use --replace` };
+  return { ok: true, message: [...written, ...retired.map(path => `${path} removed`)].join("\n") };
 }
 export async function agentStatus(repo = process.cwd()) {
-  const expected = skillPaths;
-  const missing = expected.map(path => join(repo, path)).filter(path => !existsSync(path));
+  const missing: string[] = [];
   for (const path of instructionPaths) { const agents = join(repo, path); if (!existsSync(agents) || !block.test(await readFile(agents, "utf8"))) missing.push(`${agents} (atdd-bun block)`); }
-  return { ok: !missing.length, message: missing.length ? `missing: ${missing.join(", ")}` : [...expected, ...instructionPaths].map(path => join(repo, path)).join("\n") };
+  for (const path of legacySkillPaths) { const skill = join(repo, path); if (existsSync(skill) && generatedSkill.test(await readFile(skill, "utf8"))) missing.push(`${skill} (retired generated skill)`); }
+  return { ok: !missing.length, message: missing.length ? `missing: ${missing.join(", ")}` : instructionPaths.map(path => join(repo, path)).join("\n") };
 }

package/src/cli.ts

@@ -8,6 +8,7 @@ import { journeyDocs } from "./journey-docs";
 import { adrRegister } from "./docs-capability";
 import { releaseCheck } from "./release";
 import { initializeRepository } from "./setup";
+import { profileRegistries } from "./profile-registry";
 
 const args = process.argv.slice(2);
 const usage = {
@@ -19,6 +20,7 @@ const usage = {
     "atdd-bun worktree <start|finish|status>",
     "atdd-bun ci <init|status> [--replace]",
     "atdd-bun agent <init|status> [--replace]",
+    "atdd-bun profiles registry [--check]",
     "atdd-bun integrity [init|status] [--replace]",
     "atdd-bun docs journeys [--out <dir>] [--check] [--force]",
     "atdd-bun docs adr-register [--check]",
@@ -94,6 +96,11 @@ if (args[0] === "agent") {
   const result = args[1] === "init" ? await agentInit(process.cwd(), args.includes("--replace")) : args[1] === "status" ? await agentStatus() : fail("agent requires init or status");
   console[result.ok ? "log" : "error"](result.message); process.exit(result.ok ? 0 : 1);
 }
+if (args[0] === "profiles") {
+  if (args[1] !== "registry") fail("profiles requires registry");
+  const result = await profileRegistries({ check: args.includes("--check") });
+  console[result.ok ? "log" : "error"](result.message); process.exit(result.ok ? 0 : 1);
+}
 if (args[0] === "release") {
   if (args[1] !== "check") fail("release requires check");
   const result = await releaseCheck(); console[result.ok ? "log" : "error"](result.message); process.exit(result.ok ? 0 : 1);

package/src/enforce.ts

@@ -4,7 +4,8 @@ import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
 import { topologyFor } from "./topology";
 
-export type Profile = "traceability" | "topology" | "docs" | "planner" | "telemetry" | "coder" | "tester" | "security" | "architecture" | "metrics" | "runtime" | "interlocking" | "htmx" | "design" | "all";
+export type Profile = "traceability" | "topology" | "docs" | "planner" | "telemetry" | "coder" | "tester" | "security" | "architecture" | "metrics" | "runtime" | "interlocking" | "htmx" | "design" | "workflow" | "all";
+export type ConcreteProfile = Exclude<Profile, "all">;
 
 export type Violation = {
   rule_id: string;
@@ -22,7 +23,7 @@ export type EnforcementConfig = {
   profiles?: Profile[];
 };
 
-const profiles: Record<Exclude<Profile, "all">, string[]> = {
+export const profileImplementations: Record<ConcreteProfile, string[]> = {
   traceability: ["atdd_traceability_closure"],
   topology: ["atdd_topology"],
   docs: ["planner_docs_capability"],
@@ -37,16 +38,28 @@ const profiles: Record<Exclude<Profile, "all">, string[]> = {
   interlocking: ["bun_interlocking_binding", "bun_interlocking_coverage", "bun_interlocking_infrastructure"],
   htmx: ["htmx_hypermedia_detector", "htmx_tester_detector", "htmx_e2e_detector"],
   design: ["bun_design_system_detector", "bun_responsive_detector"],
+  // Operational policy only: its convention lives in the optional @afokapu/atdd-workflow package.
+  workflow: [],
+};
+
+/** Conventions which an installed companion package contributes to an otherwise policy-only profile. */
+export const profileConventions: Record<ConcreteProfile, Array<{ rule_id: string; path: string }>> = {
+  traceability: [], topology: [], docs: [], planner: [], telemetry: [], coder: [], tester: [], security: [],
+  architecture: [], metrics: [], runtime: [], interlocking: [], htmx: [], design: [],
+  workflow: [{ rule_id: "atdd-workflow.workflow.lifecycle", path: "../atdd-workflow/conventions/atdd-workflow.workflow/atdd-workflow.workflow.lifecycle.convention.yaml" }],
 };
 
-type ConcreteProfile = Exclude<Profile, "all">;
 /** Every profile but `all`. */
-export const concreteProfiles = Object.keys(profiles) as ConcreteProfile[];
+export const concreteProfiles = Object.keys(profileImplementations) as ConcreteProfile[];
+/** Profiles a repository adopts only when it explicitly uses the optional companion package. */
+export const optionalProfiles: ConcreteProfile[] = ["workflow"];
+/** The safe default set for repositories that have not opted into an optional companion profile. */
+export const defaultProfiles = concreteProfiles.filter(profile => !optionalProfiles.includes(profile));
 /** Profile names accepted by the CLI and public integrations. */
 export const profileNames = [...concreteProfiles, "all"] as Profile[];
 
 /**
- * The profiles the operator has activated: `profiles:` in atdd-bun.yaml, or every profile when absent. A legacy
+ * The profiles the operator has activated: `profiles:` in atdd-bun.yaml, or every built-in profile when absent. A legacy
  * repository can adopt enforcement gradually by listing only what it is ready for. `all`, the hooks and the
  * generated CI run exactly these; naming a profile explicitly still runs it. An unknown name or an empty list is
  * a configuration error, never a silent "run nothing".
@@ -54,7 +67,7 @@ export const profileNames = [...concreteProfiles, "all"] as Profile[];
 export async function enabledProfiles(root = process.cwd()): Promise<ConcreteProfile[]> {
   const file = join(resolve(root), "atdd-bun.yaml");
   const listed = existsSync(file) ? (Bun.YAML.parse(await readFile(file, "utf8")) as { profiles?: unknown } | null)?.profiles : undefined;
-  if (listed === undefined) return concreteProfiles;
+  if (listed === undefined) return defaultProfiles;
   if (!Array.isArray(listed) || !listed.length) throw new Error("atdd-bun.yaml profiles must be a non-empty list of profile names");
   const unknown = listed.filter(name => !concreteProfiles.includes(name));
   if (unknown.length) throw new Error(`atdd-bun.yaml profiles lists unknown profile(s): ${unknown.join(", ")}; known: ${concreteProfiles.join(", ")}`);
@@ -68,10 +81,10 @@ export function implementationsFor(requested: Profile[] = ["all"]): string[] {
   const selected = new Set<string>();
   for (const profile of requested) {
     if (profile === "all") {
-      for (const ids of Object.values(profiles)) ids.forEach((id) => selected.add(id));
+      for (const ids of Object.values(profileImplementations)) ids.forEach((id) => selected.add(id));
       continue;
     }
-    const ids = profiles[profile];
+    const ids = profileImplementations[profile];
     if (!ids) throw new Error(`unknown enforcement profile: ${profile}`);
     ids.forEach((id) => selected.add(id));
   }
@@ -79,10 +92,10 @@ export function implementationsFor(requested: Profile[] = ["all"]): string[] {
 }
 
 /** The rule ids a detector's manifest declares it emits (emits_rule_ids and api_emits_rule_ids). */
-export async function declaredRuleIds(implementation: string): Promise<Set<string>> {
+export async function declaredRuleIds(implementation: string, detectors = detectorRoot): Promise<Set<string>> {
   const ids = new Set<string>();
   let inList = false;
-  for (const line of (await readFile(join(detectorRoot, implementation, "atdd.implementation.yaml"), "utf8")).split("\n")) {
+  for (const line of (await readFile(join(detectors, implementation, "atdd.implementation.yaml"), "utf8")).split("\n")) {
     if (line === "emits_rule_ids:" || line === "api_emits_rule_ids:") { inList = true; continue; }
     if (/^[A-Za-z_][\w-]*:/.test(line)) { inList = false; continue; }
     const match = inList && line.match(/^\s*-\s+([^#\s]+)/);

package/src/hooks.ts

@@ -1,13 +1,13 @@
 import { chmod, mkdir, readdir, readFile, realpath, rm, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
-import { dirname, join, relative, resolve } from "node:path";
+import { basename, dirname, join, relative, resolve } from "node:path";
 import { enabledProfiles, enforce } from "./enforce";
 import { topologyFor } from "./topology";
 import { JOURNEY_DOCS_DIR } from "./journey-docs";
 
 export type WorktreePolicy = { enabled: boolean; root: string; primary_directory: string; primary_branch: string; require_linked_worktree: boolean };
 export type HookPolicy = { max_staged_files: number; max_staged_changed_lines: number; max_commits_per_push: number; max_registry_removed_lines: number; registry_paths: string[]; protected_branches: string[]; require_plan_reference: boolean; require_traceability: boolean; worktrees: WorktreePolicy };
-export const defaultWorktreePolicy: WorktreePolicy = { enabled: false, root: "../worktrees", primary_directory: "main", primary_branch: "main", require_linked_worktree: true };
+export const defaultWorktreePolicy: WorktreePolicy = { enabled: false, root: "../worktrees/{repo}", primary_directory: ".", primary_branch: "main", require_linked_worktree: true };
 export const defaultHookPolicy: HookPolicy = { max_staged_files: 20, max_staged_changed_lines: 350, max_commits_per_push: 10, max_registry_removed_lines: 350, registry_paths: ["plan/_*.yaml", "plan/_*.yml", "contracts/_*.yaml", "contracts/_*.yml"], protected_branches: ["main", "master"], require_plan_reference: true, require_traceability: true, worktrees: defaultWorktreePolicy };
 export const hookEvents = ["pre-commit", "commit-msg", "pre-push", "pre-merge-commit", "post-commit", "post-merge"] as const;
 export type HookEvent = typeof hookEvents[number];
@@ -33,7 +33,7 @@ async function validation(root: string, changed: string[], full: boolean, regist
 const inside = (parent: string, child: string) => { const path = relative(parent, child); return path === "" || (path !== ".." && !path.startsWith("../") && !path.startsWith("..\\")); };
 async function primaryRoot(root: string): Promise<string | null> { const result = await git(root, ["rev-parse", "--git-common-dir"]); if (result.code) return null; return dirname(resolve(root, result.out)); }
 export type WorktreeLayout = { primary: string; worktreeRoot: string; current: string; branch: string };
-async function layout(root: string, cfg: WorktreePolicy): Promise<WorktreeLayout | { error: string }> { const current = await realpath(resolve(root)), commonRoot = await primaryRoot(current); if (!commonRoot) return { error: "not inside a Git worktree" }; const primary = await realpath(commonRoot), expectedPrimary = join(dirname(primary), cfg.primary_directory); if (primary !== expectedPrimary) return { error: `primary checkout must be ${expectedPrimary}, not ${primary}` }; const branch = (await git(primary, ["symbolic-ref", "--quiet", "--short", "HEAD"])).out; if (branch !== cfg.primary_branch) return { error: `primary checkout ${primary} must be on ${cfg.primary_branch}, not ${branch || "a detached HEAD"}` }; return { primary, worktreeRoot: resolve(primary, cfg.root), current, branch: (await git(current, ["symbolic-ref", "--quiet", "--short", "HEAD"])).out }; }
+async function layout(root: string, cfg: WorktreePolicy): Promise<WorktreeLayout | { error: string }> { const current = await realpath(resolve(root)), commonRoot = await primaryRoot(current); if (!commonRoot) return { error: "not inside a Git worktree" }; const primary = await realpath(commonRoot), expectedPrimary = cfg.primary_directory === "." ? primary : join(dirname(primary), cfg.primary_directory); if (primary !== expectedPrimary) return { error: `primary checkout must be ${expectedPrimary}, not ${primary}` }; const branch = (await git(primary, ["symbolic-ref", "--quiet", "--short", "HEAD"])).out; if (branch !== cfg.primary_branch) return { error: `primary checkout ${primary} must be on ${cfg.primary_branch}, not ${branch || "a detached HEAD"}` }; return { primary, worktreeRoot: resolve(primary, cfg.root.replaceAll("{repo}", basename(primary))), current, branch: (await git(current, ["symbolic-ref", "--quiet", "--short", "HEAD"])).out }; }
 async function worktreeCommitPolicy(root: string, cfg: WorktreePolicy): Promise<string | null> { if (!cfg.enabled || !cfg.require_linked_worktree) return null; const state = await layout(root, cfg); if ("error" in state) return state.error; if (state.current === state.primary) return `commits must use a linked worktree beneath ${state.worktreeRoot}; run: atdd-bun worktree start <branch>`; if (!inside(state.worktreeRoot, state.current)) return `linked worktree ${state.current} is outside required root ${state.worktreeRoot}`; if (!state.branch) return "commits require a named branch, not a detached HEAD"; return null; }
 
 export async function runHook(event: HookEvent, root = process.cwd(), args: string[] = [], stdin = "") {