rhachet-roles-bhuild 0.1.3 → 0.4.1

package/dist/domain.operations/behavior/bind/flattenBranchName.cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env npx tsx
+export {};

package/dist/domain.operations/behavior/bind/flattenBranchName.cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env npx tsx
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const flattenBranchName_1 = require("./flattenBranchName");
+/**
+ * .what = CLI entry point for flattenBranchName
+ * .why  = enables shell scripts to call this operation via npx tsx
+ */
+const main = () => {
+    const branchName = process.argv[2];
+    if (!branchName) {
+        console.error('usage: flattenBranchName.cli.ts <branchName>');
+        process.exit(1);
+    }
+    const flattened = (0, flattenBranchName_1.flattenBranchName)({ branchName });
+    console.log(flattened);
+};
+main();
+//# sourceMappingURL=flattenBranchName.cli.js.map

package/dist/domain.operations/behavior/bind/flattenBranchName.cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenBranchName.cli.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/bind/flattenBranchName.cli.ts"],"names":[],"mappings":";;;AAEA,2DAAwD;AAExD;;;GAGG;AACH,MAAM,IAAI,GAAG,GAAS,EAAE;IACtB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,IAAA,qCAAiB,EAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC"}

package/dist/domain.operations/behavior/bind/flattenBranchName.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = flatten branch name to filesystem-safe format
+ * .why  = bind flag filenames cannot contain forward slashes;
+ *         this utility normalizes branch names for use in flag paths
+ */
+export declare const flattenBranchName: (input: {
+    branchName: string;
+}) => string;

package/dist/domain.operations/behavior/bind/flattenBranchName.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenBranchName = void 0;
+/**
+ * .what = flatten branch name to filesystem-safe format
+ * .why  = bind flag filenames cannot contain forward slashes;
+ *         this utility normalizes branch names for use in flag paths
+ */
+const flattenBranchName = (input) => {
+    // replace forward slashes with dots
+    let flattened = input.branchName.replace(/\//g, '.');
+    // normalize other special characters (keep alphanumeric, dots, dashes, underscores)
+    flattened = flattened.replace(/[^a-zA-Z0-9._-]/g, '_');
+    // remove trailing underscore if present
+    flattened = flattened.replace(/_$/, '');
+    return flattened;
+};
+exports.flattenBranchName = flattenBranchName;
+//# sourceMappingURL=flattenBranchName.js.map

package/dist/domain.operations/behavior/bind/flattenBranchName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenBranchName.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/bind/flattenBranchName.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,CAAC,KAA6B,EAAU,EAAE;IACzE,oCAAoC;IACpC,IAAI,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAErD,oFAAoF;IACpF,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAEvD,wCAAwC;IACxC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAExC,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAXW,QAAA,iBAAiB,qBAW5B"}

package/dist/domain.operations/behavior/bind/getBoundBehaviorByBranch.cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env npx tsx
+export {};

package/dist/domain.operations/behavior/bind/getBoundBehaviorByBranch.cli.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env npx tsx
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const getBoundBehaviorByBranch_1 = require("./getBoundBehaviorByBranch");
+/**
+ * .what = CLI entry point for getBoundBehaviorByBranch
+ * .why  = enables shell scripts to call this operation via npx tsx
+ */
+const main = () => {
+    const branchName = process.argv[2]; // optional
+    const result = (0, getBoundBehaviorByBranch_1.getBoundBehaviorByBranch)({
+        branchName: branchName || undefined,
+    });
+    // output as JSON for shell parsing
+    console.log(JSON.stringify(result));
+};
+main();
+//# sourceMappingURL=getBoundBehaviorByBranch.cli.js.map

package/dist/domain.operations/behavior/bind/getBoundBehaviorByBranch.cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBoundBehaviorByBranch.cli.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/bind/getBoundBehaviorByBranch.cli.ts"],"names":[],"mappings":";;;AAEA,yEAAsE;AAEtE;;;GAGG;AACH,MAAM,IAAI,GAAG,GAAS,EAAE;IACtB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW;IAE/C,MAAM,MAAM,GAAG,IAAA,mDAAwB,EAAC;QACtC,UAAU,EAAE,UAAU,IAAI,SAAS;KACpC,CAAC,CAAC;IAEH,mCAAmC;IACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC"}

package/dist/domain.operations/behavior/bind/getBoundBehaviorByBranch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * .what = find which behavior (if any) a branch is bound to
+ * .why  = both hooks and skills need to discover bindings
+ */
+export declare const getBoundBehaviorByBranch: (input: {
+    branchName?: string;
+    cwd?: string;
+}) => {
+    behaviorDir: string | null;
+    bindings: string[];
+};

package/dist/domain.operations/behavior/bind/getBoundBehaviorByBranch.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBoundBehaviorByBranch = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const flattenBranchName_1 = require("./flattenBranchName");
+/**
+ * .what = find which behavior (if any) a branch is bound to
+ * .why  = both hooks and skills need to discover bindings
+ */
+const getBoundBehaviorByBranch = (input) => {
+    const cwd = input.cwd ?? process.cwd();
+    // get the current branch name if not provided
+    const branchName = input.branchName ??
+        (0, child_process_1.execSync)('git rev-parse --abbrev-ref HEAD', {
+            cwd,
+            encoding: 'utf-8',
+        }).trim();
+    // flatten the branch name for filesystem lookup
+    const flatBranch = (0, flattenBranchName_1.flattenBranchName)({ branchName });
+    const flagFileName = `${flatBranch}.flag`;
+    // search for .behavior/*/.bind/${flagFileName}
+    const behaviorRoot = (0, path_1.join)(cwd, '.behavior');
+    if (!(0, fs_1.existsSync)(behaviorRoot))
+        return { behaviorDir: null, bindings: [] };
+    // find all behavior directories
+    const behaviorDirs = (0, fs_1.readdirSync)(behaviorRoot, { withFileTypes: true })
+        .filter((dirent) => dirent.isDirectory())
+        .map((dirent) => dirent.name);
+    // check each behavior for a bind flag
+    const bindings = [];
+    for (const behaviorDirName of behaviorDirs) {
+        const bindDir = (0, path_1.join)(behaviorRoot, behaviorDirName, '.bind');
+        const flagPath = (0, path_1.join)(bindDir, flagFileName);
+        if ((0, fs_1.existsSync)(flagPath)) {
+            bindings.push((0, path_1.join)(behaviorRoot, behaviorDirName));
+        }
+    }
+    // return based on how many bindings found
+    if (bindings.length === 0)
+        return { behaviorDir: null, bindings: [] };
+    // single binding found
+    const singleBinding = bindings[0];
+    if (bindings.length === 1 && singleBinding)
+        return { behaviorDir: singleBinding, bindings };
+    // multiple bindings found - return null for behaviorDir, let caller decide
+    return { behaviorDir: null, bindings };
+};
+exports.getBoundBehaviorByBranch = getBoundBehaviorByBranch;
+//# sourceMappingURL=getBoundBehaviorByBranch.js.map

package/dist/domain.operations/behavior/bind/getBoundBehaviorByBranch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBoundBehaviorByBranch.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/bind/getBoundBehaviorByBranch.ts"],"names":[],"mappings":";;;AAAA,iDAAyC;AACzC,2BAA6C;AAC7C,+BAA4B;AAE5B,2DAAwD;AAExD;;;GAGG;AACI,MAAM,wBAAwB,GAAG,CAAC,KAGxC,EAAsD,EAAE;IACvD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEvC,8CAA8C;IAC9C,MAAM,UAAU,GACd,KAAK,CAAC,UAAU;QAChB,IAAA,wBAAQ,EAAC,iCAAiC,EAAE;YAC1C,GAAG;YACH,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC,IAAI,EAAE,CAAC;IAEZ,gDAAgD;IAChD,MAAM,UAAU,GAAG,IAAA,qCAAiB,EAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,GAAG,UAAU,OAAO,CAAC;IAE1C,+CAA+C;IAC/C,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAA,eAAU,EAAC,YAAY,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAE1E,gCAAgC;IAChC,MAAM,YAAY,GAAG,IAAA,gBAAW,EAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACpE,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;SACxC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhC,sCAAsC;IACtC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,eAAe,IAAI,YAAY,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,YAAY,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC7C,IAAI,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,IAAA,WAAI,EAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAEtE,uBAAuB;IACvB,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa;QACxC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;IAElD,2EAA2E;IAC3E,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC,CAAC;AA/CW,QAAA,wBAAwB,4BA+CnC"}

package/dist/domain.operations/behavior/bind/getLatestBlueprintByBehavior.cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env npx tsx
+export {};

package/dist/domain.operations/behavior/bind/getLatestBlueprintByBehavior.cli.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env npx tsx
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const getLatestBlueprintByBehavior_1 = require("./getLatestBlueprintByBehavior");
+/**
+ * .what = CLI entry point for getLatestBlueprintByBehavior
+ * .why  = enables shell scripts to call this operation via npx tsx
+ */
+const main = () => {
+    const behaviorDir = process.argv[2];
+    if (!behaviorDir) {
+        console.error('usage: getLatestBlueprintByBehavior.cli.ts <behaviorDir>');
+        process.exit(1);
+    }
+    const result = (0, getLatestBlueprintByBehavior_1.getLatestBlueprintByBehavior)({ behaviorDir });
+    // output the path or empty string if none
+    console.log(result ?? '');
+};
+main();
+//# sourceMappingURL=getLatestBlueprintByBehavior.cli.js.map

package/dist/domain.operations/behavior/bind/getLatestBlueprintByBehavior.cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLatestBlueprintByBehavior.cli.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/bind/getLatestBlueprintByBehavior.cli.ts"],"names":[],"mappings":";;;AAEA,iFAA8E;AAE9E;;;GAGG;AACH,MAAM,IAAI,GAAG,GAAS,EAAE;IACtB,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,2DAA4B,EAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAE7D,0CAA0C;IAC1C,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC"}

package/dist/domain.operations/behavior/bind/getLatestBlueprintByBehavior.d.ts

@@ -0,0 +1,11 @@
+/**
+ * .what = resolve the latest blueprint version from a behavior directory
+ * .why  = both hooks and review.deliverable need this logic
+ *
+ * .note = version precedence:
+ *         - v3.i2 > v2.i3 (major version wins)
+ *         - v2.i3 > v2.i1 (latest iteration within major)
+ */
+export declare const getLatestBlueprintByBehavior: (input: {
+    behaviorDir: string;
+}) => string | null;

package/dist/domain.operations/behavior/bind/getLatestBlueprintByBehavior.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLatestBlueprintByBehavior = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * .what = resolve the latest blueprint version from a behavior directory
+ * .why  = both hooks and review.deliverable need this logic
+ *
+ * .note = version precedence:
+ *         - v3.i2 > v2.i3 (major version wins)
+ *         - v2.i3 > v2.i1 (latest iteration within major)
+ */
+const getLatestBlueprintByBehavior = (input) => {
+    // find all blueprint files matching pattern: *.blueprint.v*.i*.md
+    const blueprintPattern = /\.blueprint\.v(\d+)\.i(\d+)\.md$/;
+    let files;
+    try {
+        files = (0, fs_1.readdirSync)(input.behaviorDir);
+    }
+    catch {
+        return null;
+    }
+    // parse version info from each matching file
+    const blueprints = [];
+    for (const file of files) {
+        const match = file.match(blueprintPattern);
+        const majorVersionStr = match?.[1];
+        const iterationStr = match?.[2];
+        if (match && majorVersionStr && iterationStr) {
+            blueprints.push({
+                path: (0, path_1.join)(input.behaviorDir, file),
+                majorVersion: parseInt(majorVersionStr, 10),
+                iteration: parseInt(iterationStr, 10),
+            });
+        }
+    }
+    if (blueprints.length === 0)
+        return null;
+    // sort by major version (descending), then by iteration (descending)
+    blueprints.sort((a, b) => {
+        if (a.majorVersion !== b.majorVersion)
+            return b.majorVersion - a.majorVersion;
+        return b.iteration - a.iteration;
+    });
+    // return the path to the latest blueprint
+    const latestBlueprint = blueprints[0];
+    return latestBlueprint?.path ?? null;
+};
+exports.getLatestBlueprintByBehavior = getLatestBlueprintByBehavior;
+//# sourceMappingURL=getLatestBlueprintByBehavior.js.map

package/dist/domain.operations/behavior/bind/getLatestBlueprintByBehavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLatestBlueprintByBehavior.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/bind/getLatestBlueprintByBehavior.ts"],"names":[],"mappings":";;;AAAA,2BAAiC;AACjC,+BAA4B;AAE5B;;;;;;;GAOG;AACI,MAAM,4BAA4B,GAAG,CAAC,KAE5C,EAAiB,EAAE;IAClB,kEAAkE;IAClE,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;IAE5D,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,IAAA,gBAAW,EAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6CAA6C;IAC7C,MAAM,UAAU,GAIX,EAAE,CAAC;IAER,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,eAAe,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,YAAY,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,KAAK,IAAI,eAAe,IAAI,YAAY,EAAE,CAAC;YAC7C,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,IAAA,WAAI,EAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC;gBACnC,YAAY,EAAE,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC;gBAC3C,SAAS,EAAE,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,qEAAqE;IACrE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACvB,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,YAAY;YACnC,OAAO,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;QACzC,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,0CAA0C;IAC1C,MAAM,eAAe,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACtC,OAAO,eAAe,EAAE,IAAI,IAAI,IAAI,CAAC;AACvC,CAAC,CAAC;AA7CW,QAAA,4BAA4B,gCA6CvC"}

package/dist/domain.operations/behavior/bind/index.d.ts

@@ -0,0 +1,3 @@
+export { flattenBranchName } from './flattenBranchName';
+export { getBoundBehaviorByBranch } from './getBoundBehaviorByBranch';
+export { getLatestBlueprintByBehavior } from './getLatestBlueprintByBehavior';

package/dist/domain.operations/behavior/bind/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLatestBlueprintByBehavior = exports.getBoundBehaviorByBranch = exports.flattenBranchName = void 0;
+var flattenBranchName_1 = require("./flattenBranchName");
+Object.defineProperty(exports, "flattenBranchName", { enumerable: true, get: function () { return flattenBranchName_1.flattenBranchName; } });
+var getBoundBehaviorByBranch_1 = require("./getBoundBehaviorByBranch");
+Object.defineProperty(exports, "getBoundBehaviorByBranch", { enumerable: true, get: function () { return getBoundBehaviorByBranch_1.getBoundBehaviorByBranch; } });
+var getLatestBlueprintByBehavior_1 = require("./getLatestBlueprintByBehavior");
+Object.defineProperty(exports, "getLatestBlueprintByBehavior", { enumerable: true, get: function () { return getLatestBlueprintByBehavior_1.getLatestBlueprintByBehavior; } });
+//# sourceMappingURL=index.js.map

package/dist/domain.operations/behavior/bind/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/bind/index.ts"],"names":[],"mappings":";;;AAAA,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,+EAA8E;AAArE,4IAAA,4BAA4B,OAAA"}

package/dist/domain.roles/behaver/briefs/practices/behavior.blueprint/rule.require.criteria-satisfied.md

@@ -0,0 +1,37 @@
+.rule = require.criteria-satisfied
+
+.what = blueprints must cover all declared criteria
+
+.why = ensures no requirements are missed in implementation; criteria define the contract that the implementation must fulfill
+
+.how = cross-reference blueprint sections against criteria usecases; verify each usecase has corresponding implementation detail
+
+.examples:
+  .positive:
+    - |
+      ## criteria coverage
+
+      | usecase | blueprint section |
+      |---------|-------------------|
+      | usecase.1 = rule briefs discoverable | deliverable.1 = rule briefs |
+      | usecase.2 = reviewing wish | deliverable.1, rule specifications |
+      | usecase.3 = reviewing criteria | deliverable.1, rule specifications |
+      | usecase.6 = composite skill | deliverable.2 = composite skill |
+      | usecase.7 = builds on bhrain | deliverable.2, implementation pattern |
+  .negative:
+    - |
+      ## implementation
+
+      we will create a skill that reviews behaviors.
+
+      ## deliverables
+
+      - review.behavior.sh
+    - |
+      ## blueprint
+
+      this implements the wish by creating rule briefs and a skill.
+
+      (no explicit criteria mapping)
+
+.severity = BLOCKER

package/dist/domain.roles/behaver/briefs/practices/behavior.blueprint/rule.require.determinism-declared.md

@@ -0,0 +1,44 @@
+.rule = require.determinism-declared
+
+.what = blueprints must declare which parts are deterministic vs probabilistic
+
+.why = different test strategies apply to each; deterministic code can be assertion-tested; probabilistic code requires example-based or snapshot testing
+
+.how = check for explicit determinism classification of components; verify probabilistic components have example references
+
+.examples:
+  .positive:
+    - |
+      ## testing
+
+      ### deterministic components
+      - argument parse
+      - behavior directory resolution
+      - artifact file resolution
+      - bhrain invocation command construction
+      - output file path generation
+
+      ### probabilistic components
+      - bhrain review feedback content (llm-generated)
+        - reference: bhrain already has examples of review output
+  .negative:
+    - |
+      ## testing
+
+      ### test coverage
+
+      **unit tests**
+      - test all the things
+
+      **integration tests**
+      - test more things
+    - |
+      ## implementation
+
+      the skill generates feedback using an llm.
+
+      ## testing
+
+      we will test the output.
+
+.severity = BLOCKER

package/dist/domain.roles/behaver/briefs/practices/behavior.blueprint/rule.require.test-coverage-specified.md

@@ -0,0 +1,42 @@
+.rule = require.test-coverage-specified
+
+.what = blueprints must specify test coverage for all components
+
+.why = untested code should never reach production; explicit test coverage specification ensures verification strategy is planned upfront
+
+.how = verify unit/integration/acceptance test specifications exist; check that each component has declared test coverage level
+
+.examples:
+  .positive:
+    - |
+      ## testing
+
+      ### test coverage
+
+      **unit tests** (review.behavior.test.ts)
+      - argument parse validates required args
+      - behavior directory resolution finds correct match
+      - artifact file resolution finds correct files
+
+      **integration tests** (review.behavior.integration.test.ts)
+      - given valid behavior, review produces feedback files
+      - given absent criteria, review warns but continues
+
+      **acceptance tests**
+      - npx rhachet run --repo bhuild --skill review.behavior --of valid-behavior
+        - produces feedback files collocated with artifacts
+  .negative:
+    - |
+      ## implementation
+
+      the skill will parse arguments, resolve directories, and invoke bhrain.
+
+      ## notes
+
+      should probably add tests later.
+    - |
+      ## testing
+
+      tests will be written as needed.
+
+.severity = BLOCKER

package/dist/domain.roles/behaver/briefs/practices/behavior.blueprint/rule.require.test-patterns-specified.md

@@ -0,0 +1,43 @@
+.rule = require.test-patterns-specified
+
+.what = blueprints must specify test patterns for integration and acceptance tests
+
+.why = clear test patterns enable fast feedback loops and thorough verification; without patterns, tests become inconsistent and unreliable
+
+.how = verify test patterns are articulated (given/when/then structure, fixtures, mocks vs real, isolation strategy); check that patterns support rapid iteration
+
+.examples:
+  .positive:
+    - |
+      ## testing
+
+      ### test patterns
+
+      **unit tests**
+      - pure function testing with mocked dependencies
+      - given/when/then structure via test-fns
+
+      **integration tests**
+      - real filesystem operations against .test/assets/example.repo/
+      - no mocking of bhrain invocation
+      - cleanup via afterEach hooks
+
+      **acceptance tests**
+      - black-box testing via CLI invocation
+      - verify file outputs exist and contain expected content
+      - use real behavior directory structure
+  .negative:
+    - |
+      ## testing
+
+      **unit tests**
+      - test the functions
+
+      **integration tests**
+      - test the integrations
+    - |
+      ## testing
+
+      we will use jest for testing.
+
+.severity = BLOCKER

package/dist/domain.roles/behaver/briefs/practices/behavior.criteria/rule.prefer.dependency-order.md

@@ -0,0 +1,43 @@
+.rule = prefer.dependency-order
+
+.what = usecases should be ordered by dependency (foundational first)
+
+.why = dependency order enables incremental verification and natural read flow; foundational behaviors must be validated before dependents; reduces debugging complexity
+
+.how = verify that referenced behaviors appear before dependents; check that usecases can be implemented and tested in declared order
+
+.examples:
+  .positive:
+    - |
+      # usecase.1 = rule briefs are discoverable
+
+      given('rule briefs exist')
+        when('searched')
+          then('found at expected paths')
+
+      # usecase.2 = single artifact review (depends on usecase.1)
+
+      given('a wish document exists')
+        when('reviewed with rules from usecase.1')
+          then('feedback produced')
+
+      # usecase.3 = composite review (depends on usecase.2)
+
+      given('behavior directory exists')
+        when('review.behavior invoked')
+          then('invokes single artifact review from usecase.2')
+  .negative:
+    - |
+      # usecase.1 = composite review (depends on undefined behaviors)
+
+      given('review.behavior invoked')
+        when('executed')
+          then('invokes single artifact review')
+
+      # usecase.2 = single artifact review (should come first)
+
+      given('a wish exists')
+        when('reviewed')
+          then('feedback produced')
+
+.severity = NITPICK

package/dist/domain.roles/behaver/briefs/practices/behavior.criteria/rule.prefer.depth-groups.md

@@ -0,0 +1,44 @@
+.rule = prefer.depth-groups
+
+.what = criteria should be grouped by depth of abstraction (foundation to contract)
+
+.why = depth groups clarify the layer at which each behavior operates; enables progressive verification from low-level to high-level; foundation behaviors must work before contract behaviors can be tested
+
+.how = check for depth progression from foundational usecases (infrastructure, data, internal logic) to contract usecases (api, user-facing, integration); verify low-level behaviors are declared before high-level dependents
+
+.examples:
+  .positive:
+    - |
+      # usecase.1 = rule briefs are discoverable (foundation)
+
+      given('rule briefs exist')
+        when('searched by artifact type')
+          then('rules are found under expected paths')
+
+      # usecase.2 = reviewing a single artifact (internal)
+
+      given('a wish document exists')
+        when('reviewed with wish rules')
+          then('feedback is produced')
+
+      # usecase.3 = composite skill orchestrates full review (contract)
+
+      given('a behavior directory exists')
+        when('review.behavior skill is invoked')
+          then('all artifacts are reviewed')
+          then('feedback is aggregated')
+  .negative:
+    - |
+      # usecase.1 = full behavior review (contract first - wrong order)
+
+      given('review.behavior is invoked')
+        when('executed')
+          then('all feedback produced')
+
+      # usecase.2 = single artifact review (foundation after contract)
+
+      given('a wish exists')
+        when('reviewed')
+          then('feedback produced')
+
+.severity = NITPICK

package/dist/domain.roles/behaver/briefs/practices/behavior.criteria/rule.prefer.usecase-groups.md

@@ -0,0 +1,41 @@
+.rule = prefer.usecase-groups
+
+.what = criteria should be grouped by usecase with `# usecase.N = description` headers
+
+.why = usecase groups improve readability and navigation; related behaviors are reviewed together; enables systematic coverage verification
+
+.how = check for usecase headers preceding related given blocks; verify each usecase has a descriptive title
+
+.examples:
+  .positive:
+    - |
+      # usecase.1 = reviewing a wish document
+
+      given('a wish document exists')
+        when('reviewed with wish rules')
+          then('feedback identifies unclear desires')
+
+      given('a wish has unclear desires')
+        when('reviewed with wish rules')
+          then('feedback flags as BLOCKER')
+
+      # usecase.2 = reviewing a criteria document
+
+      given('a criteria document exists')
+        when('reviewed with criteria rules')
+          then('feedback verifies bdd format')
+  .negative:
+    - |
+      given('a wish document exists')
+        when('reviewed')
+          then('feedback provided')
+
+      given('a criteria document exists')
+        when('reviewed')
+          then('feedback provided')
+
+      given('a wish has unclear desires')
+        when('reviewed')
+          then('flagged')
+
+.severity = NITPICK

package/dist/domain.roles/behaver/briefs/practices/behavior.criteria/rule.require.bdd-format.md

@@ -0,0 +1,25 @@
+.rule = require.bdd-format
+
+.what = criteria must use given/when/then/sothat format
+
+.why = bdd format ensures criteria are structured, testable, and machine-parseable; prose-style requirements are ambiguous and hard to verify
+
+.how = verify each usecase has given(), when(), then() declarations; check that sothat() explains the business value
+
+.examples:
+  .positive:
+    - |
+      given('a wish document exists')
+        when('reviewed with wish rules')
+          then('feedback identifies unclear desires')
+            sothat('ambiguous wishes are caught early')
+  .negative:
+    - |
+      The system should review wish documents and provide feedback
+      when they have unclear desires so that ambiguous wishes are caught.
+    - |
+      - review wish documents
+      - provide feedback on unclear desires
+      - catch ambiguous wishes
+
+.severity = BLOCKER

package/dist/domain.roles/behaver/briefs/practices/behavior.roadmap/rule.prefer.clear-deliverables.md

@@ -0,0 +1,46 @@
+.rule = prefer.clear-deliverables
+
+.what = each phase should have clear, measurable deliverables
+
+.why = clear deliverables enable progress track and completion verification; vague deliverables lead to unclear done-ness
+
+.how = check each phase has explicit deliverable statements; verify deliverables are concrete and verifiable
+
+.examples:
+  .positive:
+    - |
+      ## phase.1 = rule briefs
+
+      ### deliverables
+      - [ ] all 12 rule briefs fully implemented with content
+
+      ### acceptance criteria
+      ```
+      given('phase.1 is complete')
+        when('cat any rule file in behavior.wish/')
+          then('.what, .why, .how sections have content')
+          then('.examples.positive has at least one example')
+          then('.severity is set to BLOCKER or NITPICK')
+      ```
+
+      ### verification
+      ```sh
+      for f in src/domain.roles/behaver/briefs/practices/behavior.*/rule.*.md; do
+        grep -c ".what\|.why\|.how" "$f"
+      done
+      ```
+  .negative:
+    - |
+      ## phase.1 = rule briefs
+
+      implement the rule briefs.
+    - |
+      ## phase.1 = rule briefs
+
+      ### tasks
+      - write the rules
+      - make them good
+
+      (no explicit deliverables or verification)
+
+.severity = NITPICK