@afokapu/atdd-bun 0.10.33 → 0.10.35

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,12 @@ 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
@@ -32,6 +33,7 @@ terms:
     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.
@@ -39,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. A legacy explicit delivery profile migrates by replacing delivery with workflow in the same profile list; that one-for-one replacement is not a policy loosening.
   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,5 +1,5 @@
 {
-  "version": "0.10.33",
+  "version": "0.10.35",
   "files": {
     "HOOK_AUDIT.md": "5329d840db37671b1918f688ead26865473b87db73dbc75f7c8b2a8bbe8d6d43",
     "PLANNER_PORT.md": "fb5935bac8b7ac18994de21e43ace3a5ef8cd55f85b0e3349fca261280054f11",
@@ -19,6 +19,7 @@
     "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",
@@ -27,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": "4f6f6367d6baa1c5f2eac8c686a7a0e309b3e6335fdaa5e6641f3cc43dbb97d0",
+    "conventions/atdd-bun.profiles/atdd-bun.profiles.presets.convention.yaml": "822c91fe1ec15ec0715a8ca2339c9379326f6a3e216829539b72ce5def272585",
     "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",
@@ -1194,18 +1195,18 @@
     "src/ci.ts": "67e54d2cbfc44a9e42837d5e750af526d6255c539d3c452a4d5fca3226c0d9ac",
     "src/cli.ts": "cbc50f1e7fc7d0935f78230b7da6e232ed7ee6f04828e015c599fb6f6edcbfa2",
     "src/docs-capability.ts": "bdeeb414649049b1cd4fa8008cada3a576318be51c43bec91bfa46a8e250c270",
-    "src/enforce.ts": "736da6a864785137f3c2ef5b4f25060d2f4a1eba5d2872b7f4e7cd7395eb46de",
+    "src/enforce.ts": "8b22a3ac30fdd35c9caa4c23f064498293a628a342d590fca1f2040ee3a8ea05",
     "src/hooks.ts": "0b4ca8c857e637bbd144e737e78eda924e3cba7b038c0abe5e6916d200d73068",
     "src/index.ts": "4081f8b08d1d3ee9e15a9964143e53d9cfb94a5616ab3e58a180d24cc16dc381",
-    "src/integrity.ts": "44ebe101933e8b1a42c563acdffcaf7a24baa4861eb8731a914bc51500d0a93d",
+    "src/integrity.ts": "556976a42bae298df14b73675102d83b6bf4df0674d8e7211aad5315548f005f",
     "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": "1c0d64172d2006a8d865bffbb47506684eb5f42b75df6308d28564dbb942088c",
+    "src/profile-registry.ts": "716ef6e75e8e6eb14ffee37095b4fc9b38ddba2170fb84e7f06476863c3c02a5",
     "src/register.ts": "6a2f1c6b8df0dc9c8f45df8ec9fac2be29044e048b08c8ffe423410e94dadedd",
     "src/release.ts": "7b0fe444ee81f476f53b9c21b6c347ef588ee616c60211419cf984132be768ba",
-    "src/setup.ts": "19629b3c03e6d35b3e0e8b8a697a3c796d0e8cc4f9bac65875a26421573f3447",
+    "src/setup.ts": "38233265afedc63499bbef3b5403889651add335a70efd3813254ba53f4fc4fe",
     "src/telemetry-plan.ts": "cdb1e8bfff414f3ea81977388973da2cf6d89567d9e060dc9d5989a33600f153",
     "src/topology.ts": "9779ee48e1c453abb76363163d4ab363463fa14e359571139f6d1f1fcc51ae2c",
     "templates/agents/AGENTS.block.md": "978ea89e1469f0a89a6ef6e4ac40bdc11ae856bb2754069743758ba204c395a1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afokapu/atdd-bun",
-  "version": "0.10.33",
+  "version": "0.10.35",
   "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/enforce.ts

@@ -4,7 +4,7 @@ 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 = {
@@ -38,15 +38,28 @@ export const profileImplementations: Record<ConcreteProfile, 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" }],
 };
 
 /** Every profile but `all`. */
 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(", ")}`);

package/src/integrity.ts

@@ -156,7 +156,10 @@ export function loosenedPolicy(base: Partial<HookPolicy> & { profiles?: unknown
   // (explicit → implicit → narrower would otherwise be a two-step bypass) is loosening a human approves.
   const before = explicitProfiles(base), after = explicitProfiles(current);
   if (before && !after) out.push(`profiles becomes implicit: the explicit list [${before.join(", ")}] was removed`);
-  const dropped = before && after ? before.filter(name => !after.includes(name)) : [];
+  // delivery was retired in favour of the workflow companion. This is a one-way package migration,
+  // not a general escape hatch for removing profiles: its replacement must be explicit in the same
+  // policy change, and every other removed profile remains a loosening.
+  const dropped = before && after ? before.filter(name => !after.includes(name) && !(name === "delivery" && after.includes("workflow"))) : [];
   if (dropped.length) out.push(`profiles drops ${dropped.join(", ")}`);
   return out;
 }

package/src/profile-registry.ts

@@ -1,7 +1,7 @@
 import { existsSync } from "node:fs";
 import { mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
 import { join, relative, resolve } from "node:path";
-import { concreteProfiles, declaredRuleIds, profileImplementations } from "./enforce";
+import { concreteProfiles, declaredRuleIds, profileConventions, profileImplementations } from "./enforce";
 
 export const PROFILE_REGISTRY_DIR = "conventions/_profiles";
 type Convention = { rule_id: string; path: string };
@@ -36,9 +36,9 @@ const scalar = (value: unknown) => value === null ? "null" : typeof value === "s
 const fields = (value: Record<string, unknown>, indent: string) => sorted(Object.entries(value), ([left], [right]) => left.localeCompare(right)).map(([key, entry]) => `${indent}${key}: ${scalar(entry)}`);
 const render = (profile: string, implementations: string[], conventions: Convention[], relationships: Relationship[]) => [
   'schema_version: "1.0.0"', `profile: ${scalar(profile)}`,
-  "implementations:", ...implementations.map(implementation => `  - ${scalar(implementation)}`),
-  "conventions:", ...conventions.flatMap(convention => [`  - rule_id: ${scalar(convention.rule_id)}`, `    path: ${scalar(convention.path)}`]),
-  "relationships:", ...relationships.flatMap(edge => { const entries = fields(edge, "    "); return [`  - ${entries[0]!.slice(4)}`, ...entries.slice(1)]; }), "",
+  implementations.length ? "implementations:" : "implementations: []", ...implementations.map(implementation => `  - ${scalar(implementation)}`),
+  conventions.length ? "conventions:" : "conventions: []", ...conventions.flatMap(convention => [`  - rule_id: ${scalar(convention.rule_id)}`, `    path: ${scalar(convention.path)}`]),
+  relationships.length ? "relationships:" : "relationships: []", ...relationships.flatMap(edge => { const entries = fields(edge, "    "); return [`  - ${entries[0]!.slice(4)}`, ...entries.slice(1)]; }), "",
 ].join("\n");
 
 /** Deterministically project profiles, detector manifests, conventions, and direct graph edges into small registries. */
@@ -53,9 +53,13 @@ export async function renderProfileRegistries(root = resolve(import.meta.dir, ".
     const ruleIds = sorted(new Set(declared.flatMap(ids => [...ids])));
     const missing = ruleIds.filter(id => !conventions.has(id));
     if (missing.length) throw new Error(`${profile} declares rule IDs without exactly one convention: ${missing.join(", ")}`);
-    const rules = new Set(ruleIds);
+    const supplementary = profileConventions[profile];
+    const duplicate = supplementary.find(convention => conventions.has(convention.rule_id) || ruleIds.includes(convention.rule_id));
+    if (duplicate) throw new Error(`${profile} duplicates convention ${duplicate.rule_id}`);
+    const selectedConventions = [...ruleIds.map(id => conventions.get(id)!), ...supplementary];
+    const rules = new Set(selectedConventions.map(convention => convention.rule_id));
     const relationships = sorted(graph.edges.filter(edge => rules.has(edge.source_ref) || rules.has(edge.target_ref)), (left, right) => relationshipKey(left).localeCompare(relationshipKey(right)));
-    rendered.set(`${PROFILE_REGISTRY_DIR}/${profile}.yaml`, render(profile, implementations, ruleIds.map(id => conventions.get(id)!), relationships));
+    rendered.set(`${PROFILE_REGISTRY_DIR}/${profile}.yaml`, render(profile, implementations, selectedConventions, relationships));
   }
   return rendered;
 }

package/src/setup.ts

@@ -2,7 +2,7 @@ import { ciInit, ciStatus } from "./ci";
 import { hooksStatus, installHooks } from "./hooks";
 import { agentInit, agentStatus } from "./agent";
 import { integrityInit, integrityStatus } from "./integrity";
-import { concreteProfiles } from "./enforce";
+import { defaultProfiles } from "./enforce";
 import { existsSync } from "node:fs";
 import { writeFile } from "node:fs/promises";
 import { join } from "node:path";
@@ -14,7 +14,7 @@ import { join } from "node:path";
 export async function policyInit(root = process.cwd()) {
   const file = join(root, "atdd-bun.yaml");
   if (existsSync(file)) return { ok: true, message: `${file} kept` };
-  await writeFile(file, `# Generated by atdd-bun init. The profiles this repository enforces; trim the list before the first commit to\n# adopt gradually. Once committed, removing a profile or the list is reported by the integrity check.\nprofiles: [${concreteProfiles.join(", ")}]\n`);
+  await writeFile(file, `# Generated by atdd-bun init. The profiles this repository enforces; trim the list before the first commit to\n# adopt gradually. Once committed, removing a profile or the list is reported by the integrity check.\nprofiles: [${defaultProfiles.join(", ")}]\n`);
   return { ok: true, message: file };
 }