@afokapu/atdd-bun 0.10.48 → 0.10.50

package/README.md

@@ -61,6 +61,7 @@ registerEnforcementTest({ root: import.meta.dir + "/..", profiles: ["traceabilit
 | `interlocking` | train/interlocking binding, infrastructure and route coverage |
 | `htmx` | htmx source/test conventions and Playwright browser specs (`*.e2e.ts`) |
 | `design` | design-system layering, token-only styling and responsiveness |
+| `flow` | optional ATDD Flow companion conventions for durable seats, tasks and threads |
 | `all` | every activated profile; what the hooks and CI run |
 
 `planner-nodes/ENFORCEMENT_SCOPE.yaml` says which canonical planner rules have a Bun realization.
@@ -80,6 +81,16 @@ profiles: [traceability, planner]
 by name (`bun run atdd-bun coder`) to see what remains. An unknown name or an empty list is an
 error, never a silent run of nothing.
 
+### Flow profile compatibility
+
+`flow` is the canonical optional profile name. For a compatible upgrade, a legacy explicit
+`workflow` entry in `atdd-bun.yaml`, or a direct `bun run atdd-bun workflow`, normalizes to
+`flow`; it does not make unrelated names valid. `flow` requires `@afokapu/atdd-bun` **0.10.45 or
+newer**. If a checkout reports that `flow` is unknown, it is running a stale toolkit: run
+`bun update @afokapu/atdd-bun`, then use the repository-local command
+`bun run atdd-bun flow --root .` (never a PATH-global `atdd-bun`). Keep `flow` in newly edited
+configuration.
+
 With no `profiles:` field, every profile runs, but none is governed yet. The first explicit list is
 the adoption that establishes the governed set, so a brownfield repository can declare
 `profiles: [docs]` in an ordinary pull request. From then on, the integrity check reports, against

package/integrity.json

@@ -1,9 +1,9 @@
 {
-  "version": "0.10.48",
+  "version": "0.10.50",
   "files": {
     "HOOK_AUDIT.md": "5329d840db37671b1918f688ead26865473b87db73dbc75f7c8b2a8bbe8d6d43",
     "PLANNER_PORT.md": "fb5935bac8b7ac18994de21e43ace3a5ef8cd55f85b0e3349fca261280054f11",
-    "README.md": "5b46af2c4be56303b3ef4b136e443c55d008f29705850265492328c196a3d7e2",
+    "README.md": "91e481217865f4bbb2711d89f02ce095cd2f60414b00b10e4874bfadb363e10b",
     "bunfig.toml": "b9fc65eca9014c5179380259d70e76385a6a80788fa9a2df5fb3eaa5554fd2fe",
     "conventions/_profiles/architecture.yaml": "f1808768b720a4e476047e4a0912002ca673946562cea9aeef5d0c214828d93a",
     "conventions/_profiles/coder.yaml": "3fb191556a64c9ebcf249516afa189afca24da9b22fd40b2fc66908196cdfb78",
@@ -1195,9 +1195,9 @@
     "relationships.yaml": "5860a308ebc3ee7fa8172fc2c6633984000ab3003f0ae4b6fa28db48879eda22",
     "src/agent.ts": "39ca8b3183063c60e00eb96e5629d0397aeb83cc82d4c4bc32c01715c906649b",
     "src/ci.ts": "67e54d2cbfc44a9e42837d5e750af526d6255c539d3c452a4d5fca3226c0d9ac",
-    "src/cli.ts": "cbc50f1e7fc7d0935f78230b7da6e232ed7ee6f04828e015c599fb6f6edcbfa2",
+    "src/cli.ts": "521aa363813f84877a97189d1a629b5db26c22f672e0386fb88f26d540918414",
     "src/docs-capability.ts": "bdeeb414649049b1cd4fa8008cada3a576318be51c43bec91bfa46a8e250c270",
-    "src/enforce.ts": "4738f4be630e9087415a12f8e0cbbf63ced02da027c665cf0dc5a514d4dc6d94",
+    "src/enforce.ts": "7e6b3a1fc7c90f8e1836ab3e4655778fb569a63be5e7c199de44024fc003e6be",
     "src/hooks.ts": "0b4ca8c857e637bbd144e737e78eda924e3cba7b038c0abe5e6916d200d73068",
     "src/index.ts": "4081f8b08d1d3ee9e15a9964143e53d9cfb94a5616ab3e58a180d24cc16dc381",
     "src/integrity.ts": "f5ad22759eec675454df82cdcf791b1f081951f08ca5084ebdcb8cd82aa1ecef",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afokapu/atdd-bun",
-  "version": "0.10.48",
+  "version": "0.10.50",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/afokapu/atdd-bun.git"
@@ -35,7 +35,7 @@
     "bun": ">=1.3.0"
   },
   "dependencies": {
-    "@afokapu/atdd-flow": "^0.2.3",
+    "@afokapu/atdd-flow": "^0.3.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1"
   },

package/src/cli.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
-import { enforce, profileNames, type Profile } from "./enforce";
+import { enforce, flowCompatibilityDiagnostic, normalizeProfileName, profileNames, type Profile } from "./enforce";
 import { finishWorktree, hookEvents, hooksStatus, installHooks, runHook, startWorktree, uninstallHooks, worktreeStatus } from "./hooks";
 import { ciInit, ciStatus } from "./ci";
 import { agentInit, agentStatus } from "./agent";
@@ -118,9 +118,11 @@ for (let index = 0; index < args.length; index += 1) {
 const profileValue = args.includes("--profile") ? valueAfter("--profile") : undefined;
 if (args.includes("--profile") && !profileValue) fail("--profile requires one or more comma-separated profiles");
 const requested = profileValue ? profileValue.split(",").filter(Boolean) : positional.length ? positional : ["all"];
-const invalid = requested.find(profile => !profileNames.includes(profile as Profile));
+const normalizedRequested = requested.map(normalizeProfileName);
+const invalid = normalizedRequested.find(profile => !profileNames.includes(profile as Profile));
 if (invalid) fail("unknown command or profile: " + invalid);
-const violations = await enforce({ root, profiles: requested as Profile[] });
+if (requested.includes("workflow")) console.error(flowCompatibilityDiagnostic);
+const violations = await enforce({ root, profiles: normalizedRequested as Profile[] });
 for (const violation of violations) {
   console.error([violation.file, violation.line, violation.col].join(":") + " " + violation.rule_id + " — " + violation.evidence);
 }

package/src/enforce.ts

@@ -60,6 +60,16 @@ export const optionalProfiles: ConcreteProfile[] = ["flow"];
 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[];
+/** Retired spellings accepted only to migrate old configuration and invocations to their canonical profile. */
+export const legacyProfileAliases = { workflow: "flow" } as const;
+
+/** Normalize a supported retired spelling without making it part of the canonical profile registry. */
+export function normalizeProfileName(name: string): string {
+  return legacyProfileAliases[name as keyof typeof legacyProfileAliases] ?? name;
+}
+
+/** Guidance for a repository that was configured during the workflow → flow rename. */
+export const flowCompatibilityDiagnostic = "Legacy profile workflow is normalized to canonical flow. If this checkout reports flow as unknown, it is using @afokapu/atdd-bun older than 0.10.45; run bun update @afokapu/atdd-bun, then invoke the project-local CLI with bun run atdd-bun flow --root . (not a PATH-global atdd-bun).";
 
 /**
  * The profiles the operator has activated: `profiles:` in atdd-bun.yaml, or every built-in profile when absent. A legacy
@@ -72,9 +82,10 @@ export async function enabledProfiles(root = process.cwd()): Promise<ConcretePro
   const listed = existsSync(file) ? (Bun.YAML.parse(await readFile(file, "utf8")) as { profiles?: unknown } | null)?.profiles : undefined;
   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));
+  const normalized = listed.map(name => typeof name === "string" ? normalizeProfileName(name) : name);
+  const unknown = normalized.filter(name => typeof name !== "string" || !concreteProfiles.includes(name as ConcreteProfile));
   if (unknown.length) throw new Error(`atdd-bun.yaml profiles lists unknown profile(s): ${unknown.join(", ")}; known: ${concreteProfiles.join(", ")}`);
-  return [...new Set(listed as ConcreteProfile[])];
+  return [...new Set(normalized as ConcreteProfile[])];
 }
 
 const packageRoot = resolve(import.meta.dir, "..");