rhachet-roles-bhuild 0.5.1 → 0.5.3

package/dist/contract/cli/bind.behavior.d.ts

@@ -0,0 +1,16 @@
+/**
+ * .what = bind, unbind, or query branch-to-behavior bound
+ *
+ * .why  = explicit user control over which behavior applies to current branch
+ *
+ * usage:
+ *   bind.behavior.sh set --behavior <name>   bind current branch
+ *   bind.behavior.sh del                     unbind current branch
+ *   bind.behavior.sh get                     query current bound
+ *
+ * guarantee:
+ *   - fail-fast if behavior not found or ambiguous
+ *   - fail-fast if set to different behavior (suggest del or worktree)
+ *   - idempotent: set to same behavior succeeds, del when unbound succeeds
+ */
+export declare const bindBehavior: () => void;

package/dist/contract/cli/bind.behavior.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * .what = bind, unbind, or query branch-to-behavior bound
+ *
+ * .why  = explicit user control over which behavior applies to current branch
+ *
+ * usage:
+ *   bind.behavior.sh set --behavior <name>   bind current branch
+ *   bind.behavior.sh del                     unbind current branch
+ *   bind.behavior.sh get                     query current bound
+ *
+ * guarantee:
+ *   - fail-fast if behavior not found or ambiguous
+ *   - fail-fast if set to different behavior (suggest del or worktree)
+ *   - idempotent: set to same behavior succeeds, del when unbound succeeds
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bindBehavior = void 0;
+const path_1 = require("path");
+const zod_1 = require("zod");
+const behavior_1 = require("../../domain.operations/behavior");
+const bind_1 = require("../../domain.operations/behavior/bind");
+const cli_1 = require("../../infra/cli");
+// ────────────────────────────────────────────────────────────────────
+// schema
+// ────────────────────────────────────────────────────────────────────
+const schemaOfArgs = zod_1.z.object({
+    named: zod_1.z.object({
+        // skill-specific args
+        behavior: zod_1.z.string().optional(),
+        dir: zod_1.z.string().optional(),
+        // rhachet passthrough args (optional, ignored)
+        repo: zod_1.z.string().optional(),
+        role: zod_1.z.string().optional(),
+        skill: zod_1.z.string().optional(),
+        s: zod_1.z.string().optional(),
+    }),
+    ordered: zod_1.z.array(zod_1.z.string()).default([]),
+});
+// ────────────────────────────────────────────────────────────────────
+// exported CLI entry point
+// ────────────────────────────────────────────────────────────────────
+const bindBehavior = () => {
+    const { named, ordered } = (0, cli_1.getCliArgs)({ schema: schemaOfArgs });
+    // action is first ordered arg
+    const action = ordered[0];
+    const cwd = named.dir ?? process.cwd();
+    if (!action) {
+        console.error('error: no action specified');
+        console.error('usage: bind.behavior.sh <set|get|del> [--behavior <name>] [--dir <path>]');
+        process.exit(1);
+    }
+    if (!['set', 'get', 'del'].includes(action)) {
+        console.error(`error: unknown action '${action}'`);
+        console.error('usage: bind.behavior.sh <set|get|del> [--behavior <name>] [--dir <path>]');
+        process.exit(1);
+    }
+    const context = { cwd };
+    const branchName = (0, bind_1.getCurrentBranch)({}, context);
+    // dispatch
+    if (action === 'get') {
+        const result = (0, bind_1.getBranchBehaviorBind)({ branchName }, context);
+        if (!result.behaviorDir) {
+            console.log('not bound');
+        }
+        else {
+            console.log(`bound to: ${(0, path_1.basename)(result.behaviorDir)}`);
+        }
+    }
+    else if (action === 'set') {
+        const behaviorName = named.behavior;
+        if (!behaviorName) {
+            console.error('error: --behavior is required with set');
+            process.exit(1);
+        }
+        const behaviorDir = (0, behavior_1.getBehaviorDir)({ name: behaviorName, targetDir: cwd });
+        const result = (0, bind_1.setBranchBehaviorBind)({ branchName, behaviorDir }, context);
+        if (!result.success) {
+            console.error(`error: ${result.message}`);
+            console.error('');
+            console.error('to rebind, first unbind with:');
+            console.error('  bind.behavior.sh del');
+            console.error('');
+            console.error('or use a new worktree for the new behavior:');
+            console.error('  git worktree add ../<new-branch> -b <new-branch>');
+            process.exit(1);
+        }
+        console.log(`✓ ${result.message}`);
+    }
+    else if (action === 'del') {
+        const result = (0, bind_1.delBranchBehaviorBind)({ branchName }, context);
+        console.log(`✓ ${result.message}`);
+    }
+};
+exports.bindBehavior = bindBehavior;
+//# sourceMappingURL=bind.behavior.js.map

package/dist/contract/cli/bind.behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.behavior.js","sourceRoot":"","sources":["../../../src/contract/cli/bind.behavior.ts"],"names":[],"mappings":"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"}

package/dist/contract/cli/boot.behavior.d.ts

@@ -0,0 +1,10 @@
+/**
+ * .what = output bound behavior context for session start
+ * .why  = agent starts with full awareness of current behavior
+ *
+ * guarantee:
+ *   ✔ exits 0 silently if branch not bound (unbound = normal work)
+ *   ✔ exits 0 with warning if multiple binds (don't block session)
+ *   ✔ never blocks session start (exit 0 always)
+ */
+export declare const bootBehavior: () => void;

package/dist/contract/cli/boot.behavior.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * .what = output bound behavior context for session start
+ * .why  = agent starts with full awareness of current behavior
+ *
+ * guarantee:
+ *   ✔ exits 0 silently if branch not bound (unbound = normal work)
+ *   ✔ exits 0 with warning if multiple binds (don't block session)
+ *   ✔ never blocks session start (exit 0 always)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootBehavior = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const bind_1 = require("../../domain.operations/behavior/bind");
+// ────────────────────────────────────────────────────────────────────
+// helpers
+// ────────────────────────────────────────────────────────────────────
+const outputBehaviorFile = (tag, filepath, isRequired) => {
+    if ((0, fs_1.existsSync)(filepath)) {
+        const relpath = (0, path_1.relative)(process.cwd(), filepath);
+        console.log(`<behavior-${tag} path="${relpath}">`);
+        console.log((0, fs_1.readFileSync)(filepath, 'utf-8'));
+        console.log(`</behavior-${tag}>`);
+        console.log('');
+    }
+    else if (isRequired) {
+        console.error(`⚠️  required file not found: ${filepath}`);
+    }
+};
+// ────────────────────────────────────────────────────────────────────
+// exported CLI entry point
+// ────────────────────────────────────────────────────────────────────
+const bootBehavior = () => {
+    // get current branch (exit silently if not in git repo)
+    let currentBranch;
+    try {
+        currentBranch = (0, bind_1.getCurrentBranch)({});
+    }
+    catch {
+        process.exit(0);
+    }
+    if (!currentBranch) {
+        process.exit(0);
+    }
+    // check if bound
+    const bindResult = (0, bind_1.getBranchBehaviorBind)({ branchName: currentBranch });
+    const behaviorDir = bindResult.behaviorDir;
+    const bindsCount = bindResult.binds.length;
+    // if not bound, exit silently
+    if (!behaviorDir) {
+        // check for multiple binds (conflict)
+        if (bindsCount > 1) {
+            console.error(`⚠️  warning: branch '${currentBranch}' has conflicting binds:`);
+            bindResult.binds.forEach((bind) => {
+                console.error(`  - ${(0, path_1.basename)(bind)}`);
+            });
+            console.error("use 'bind.behavior.sh --del' to unbind and 'bind.behavior.sh --set' to rebind");
+        }
+        process.exit(0);
+    }
+    // extract behavior name from path
+    const behaviorName = (0, path_1.basename)(behaviorDir);
+    // output behavior context
+    console.log('==================================================');
+    console.log(`BOUND BEHAVIOR: ${behaviorName}`);
+    console.log('==================================================');
+    console.log('');
+    // output wish (required)
+    outputBehaviorFile('wish', `${behaviorDir}/0.wish.md`, true);
+    // output vision (optional)
+    outputBehaviorFile('vision', `${behaviorDir}/1.vision.md`, false);
+    // output criteria (optional - check for both new and legacy formats)
+    if ((0, fs_1.existsSync)(`${behaviorDir}/2.criteria.blackbox.md`)) {
+        outputBehaviorFile('criteria-blackbox', `${behaviorDir}/2.criteria.blackbox.md`, false);
+        outputBehaviorFile('criteria-blueprint', `${behaviorDir}/2.criteria.blueprint.md`, false);
+    }
+    else {
+        // fallback to legacy single criteria file
+        outputBehaviorFile('criteria', `${behaviorDir}/2.criteria.md`, false);
+    }
+    // output latest blueprint (optional)
+    const latestBlueprint = (0, bind_1.getLatestBlueprintByBehavior)({ behaviorDir });
+    if (latestBlueprint && (0, fs_1.existsSync)(latestBlueprint)) {
+        outputBehaviorFile('blueprint', latestBlueprint, false);
+    }
+    console.log('==================================================');
+};
+exports.bootBehavior = bootBehavior;
+//# sourceMappingURL=boot.behavior.js.map

package/dist/contract/cli/boot.behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.behavior.js","sourceRoot":"","sources":["../../../src/contract/cli/boot.behavior.ts"],"names":[],"mappings":"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"}

package/dist/contract/cli/decompose.behavior.d.ts

@@ -0,0 +1,19 @@
+/**
+ * .what = decompose a behavior into focused sub-behaviors
+ *
+ * .why  = enables large behaviors to be split into independent,
+ *         focused sub-behaviors that fit within context window limits
+ *         and respect bounded context boundaries
+ *
+ * usage:
+ *   npx tsx decompose.behavior.ts --of <behavior-name> --mode plan [--dir <path>]
+ *   npx tsx decompose.behavior.ts --of <behavior-name> --mode apply --plan <plan-file> [--dir <path>]
+ *
+ * guarantee:
+ *   - fail-fast if behavior not found or ambiguous
+ *   - fail-fast if behavior has no criteria
+ *   - fail-fast if --mode apply without --plan
+ *   - fail-fast if behavior already decomposed (z.decomposed.md present)
+ *   - idempotent: safe to rerun
+ */
+export declare const decomposeBehavior: () => Promise<void>;

package/dist/contract/cli/decompose.behavior.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * .what = decompose a behavior into focused sub-behaviors
+ *
+ * .why  = enables large behaviors to be split into independent,
+ *         focused sub-behaviors that fit within context window limits
+ *         and respect bounded context boundaries
+ *
+ * usage:
+ *   npx tsx decompose.behavior.ts --of <behavior-name> --mode plan [--dir <path>]
+ *   npx tsx decompose.behavior.ts --of <behavior-name> --mode apply --plan <plan-file> [--dir <path>]
+ *
+ * guarantee:
+ *   - fail-fast if behavior not found or ambiguous
+ *   - fail-fast if behavior has no criteria
+ *   - fail-fast if --mode apply without --plan
+ *   - fail-fast if behavior already decomposed (z.decomposed.md present)
+ *   - idempotent: safe to rerun
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decomposeBehavior = void 0;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const BehaviorPersisted_1 = require("../../domain.objects/BehaviorPersisted");
+const behavior_1 = require("../../domain.operations/behavior");
+const applyPlan_1 = require("../../domain.operations/behavior/decompose/applyPlan");
+const computePlanFromFile_1 = require("../../domain.operations/behavior/decompose/computePlanFromFile");
+const imaginePlan_1 = require("../../domain.operations/behavior/decompose/imaginePlan");
+const invokeBrainRepl_1 = require("../../infra/brain/invokeBrainRepl");
+const loadBriefs_1 = require("../../infra/brain/loadBriefs");
+const cli_1 = require("../../infra/cli");
+// ────────────────────────────────────────────────────────────────────
+// schema
+// ────────────────────────────────────────────────────────────────────
+const schemaOfArgs = zod_1.z.object({
+    named: zod_1.z.object({
+        // skill-specific args
+        of: zod_1.z.string(),
+        mode: zod_1.z.enum(['plan', 'apply']),
+        plan: zod_1.z.string().optional(),
+        dir: zod_1.z.string().optional(),
+        // rhachet passthrough args (optional, ignored)
+        repo: zod_1.z.string().optional(),
+        role: zod_1.z.string().optional(),
+        skill: zod_1.z.string().optional(),
+        s: zod_1.z.string().optional(),
+    }),
+    ordered: zod_1.z.array(zod_1.z.string()).default([]),
+});
+// ────────────────────────────────────────────────────────────────────
+// mode: plan
+// ────────────────────────────────────────────────────────────────────
+const modePlan = async (behaviorDir, behaviorName) => {
+    const behaviorDirRel = path.relative(process.cwd(), behaviorDir);
+    console.log('');
+    console.log("🦫 let's decompose!");
+    console.log('');
+    console.log('🍄 decompose.behavior --mode plan');
+    console.log(`├── behavior = ${behaviorDirRel}`);
+    console.log('├── criteria = found');
+    console.log('└── status = plan in progress...');
+    console.log('');
+    // construct behavior domain object
+    const behavior = new BehaviorPersisted_1.BehaviorPersisted({
+        name: behaviorName,
+        path: behaviorDir,
+    });
+    // load decompose briefs
+    const roleDir = path.join(__dirname, '../../domain.roles/decomposer');
+    const briefs = await (0, loadBriefs_1.loadBriefs)({
+        roleDir,
+        skillName: 'decompose',
+    });
+    const role = { briefs };
+    // construct context with brain.repl
+    const context = {
+        brain: {
+            repl: {
+                imagine: (input) => (0, invokeBrainRepl_1.invokeBrainRepl)({
+                    prompt: input.prompt,
+                    role: input.role,
+                    outputFormat: input.outputFormat,
+                }),
+            },
+        },
+    };
+    // invoke imaginePlan
+    const plan = await (0, imaginePlan_1.imaginePlan)({ behavior, role }, context);
+    // write plan to file
+    const planOutput = path.join(behaviorDir, 'z.plan.decomposition.v1.json');
+    (0, fs_1.writeFileSync)(planOutput, JSON.stringify(plan, null, 2));
+    const planOutputRel = path.relative(process.cwd(), planOutput);
+    // output summary
+    console.log('🌲 plan generated');
+    console.log(`├── file = ${planOutputRel}`);
+    console.log(`├── behaviors proposed = ${plan.behaviorsProposed.length}`);
+    console.log(`├── context window = ${plan.contextAnalysis.usage.window.percentage}%`);
+    console.log(`└── recommendation = ${plan.contextAnalysis.recommendation}`);
+    console.log('');
+    console.log('🌲 proposed behaviors');
+    plan.behaviorsProposed.forEach((b, i) => {
+        const deps = b.dependsOn.length === 0 ? 'none' : b.dependsOn.join(', ');
+        const prefix = i === plan.behaviorsProposed.length - 1 ? '└──' : '├──';
+        console.log(`${prefix} ${b.name} (depends on: ${deps})`);
+    });
+    console.log('');
+    console.log('🌲 next step');
+    console.log('├── review the plan');
+    console.log(`└── decompose.behavior --of ${behaviorName} --mode apply --plan ${planOutputRel}`);
+    console.log('');
+};
+// ────────────────────────────────────────────────────────────────────
+// mode: apply
+// ────────────────────────────────────────────────────────────────────
+const modeApply = async (behaviorDir, planFile) => {
+    const behaviorDirRel = path.relative(process.cwd(), behaviorDir);
+    console.log('');
+    console.log("🦫 let's decompose!");
+    console.log('');
+    console.log('🍄 decompose.behavior --mode apply');
+    console.log(`├── behavior = ${behaviorDirRel}`);
+    console.log(`├── plan = ${planFile}`);
+    console.log('└── status = apply in progress...');
+    console.log('');
+    // load plan from file
+    const plan = await (0, computePlanFromFile_1.computePlanFromFile)({ planPath: planFile });
+    // apply the plan
+    const result = await (0, applyPlan_1.applyPlan)({ plan });
+    // output summary
+    console.log('🌲 plan applied');
+    console.log(`├── behaviors created = ${result.behaviorsCreated.length}`);
+    console.log(`└── marker = ${result.decomposedMarkerPath}`);
+    console.log('');
+    console.log('🌲 created behaviors');
+    result.behaviorsCreated.forEach((behaviorPath, i) => {
+        const prefix = i === result.behaviorsCreated.length - 1 ? '└──' : '├──';
+        console.log(`${prefix} ${path.basename(behaviorPath)}`);
+    });
+    console.log('');
+    console.log('🌲 next steps');
+    console.log('├── define criteria for each sub-behavior');
+    console.log('└── execute each sub-behavior independently');
+    console.log('');
+};
+// ────────────────────────────────────────────────────────────────────
+// exported CLI entry point
+// ────────────────────────────────────────────────────────────────────
+const decomposeBehavior = async () => {
+    const { named } = (0, cli_1.getCliArgs)({ schema: schemaOfArgs });
+    const behaviorName = named.of;
+    const mode = named.mode;
+    const planFile = named.plan ?? '';
+    const targetDir = named.dir ?? process.cwd();
+    // validate apply mode requires plan
+    if (mode === 'apply' && !planFile) {
+        console.error('error: --plan required for apply mode');
+        console.error('hint: produce one via --mode plan first');
+        process.exit(1);
+    }
+    if (mode === 'apply' && planFile && !(0, fs_1.existsSync)(planFile)) {
+        console.error(`error: plan file not found: ${planFile}`);
+        process.exit(1);
+    }
+    // get behavior directory
+    const behaviorDir = (0, behavior_1.getBehaviorDir)({ name: behaviorName, targetDir });
+    const behaviorDirRel = path.relative(process.cwd(), behaviorDir);
+    // criteria validation
+    const filesInDir = (0, fs_1.readdirSync)(behaviorDir);
+    const criteriaFile = filesInDir.find((f) => f.endsWith('.criteria.md'));
+    if (!criteriaFile) {
+        console.error('error: criteria required for decomposition');
+        console.error(`behavior: ${behaviorDirRel}`);
+        console.error('hint: run behaver bind.criteria first');
+        process.exit(1);
+    }
+    // already decomposed check
+    const decomposedFile = path.join(behaviorDir, 'z.decomposed.md');
+    if ((0, fs_1.existsSync)(decomposedFile)) {
+        if (mode === 'plan') {
+            console.log('warn: behavior already decomposed');
+            console.log(`behavior: ${behaviorDirRel}`);
+            console.log('');
+            console.log('peer sub-behaviors:');
+            const content = (0, fs_1.readFileSync)(decomposedFile, 'utf-8');
+            const lines = content.split('\n').filter((l) => l.startsWith('- '));
+            lines.forEach((l) => console.log(`  ${l}`));
+            console.log('');
+            console.log('hint: remove z.decomposed.md to re-decompose');
+            process.exit(0);
+        }
+        else {
+            console.error('error: behavior already decomposed');
+            console.error(`behavior: ${behaviorDirRel}`);
+            console.error('hint: remove z.decomposed.md to re-decompose');
+            process.exit(1);
+        }
+    }
+    // dispatch to mode
+    if (mode === 'plan') {
+        await modePlan(behaviorDir, behaviorName);
+    }
+    else {
+        await modeApply(behaviorDir, planFile);
+    }
+};
+exports.decomposeBehavior = decomposeBehavior;
+//# sourceMappingURL=decompose.behavior.js.map

package/dist/contract/cli/decompose.behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompose.behavior.js","sourceRoot":"","sources":["../../../src/contract/cli/decompose.behavior.ts"],"names":[],"mappings":"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"}

package/dist/contract/cli/init.behavior.d.ts

@@ -0,0 +1,27 @@
+/**
+ * .what = initialize a .behavior directory for bhuild thoughtroute
+ *
+ * .why  = standardize the behavior-driven development thoughtroute
+ *         by creating a structured directory with:
+ *           - wish definition
+ *           - vision statement
+ *           - blackbox criteria (user-facing behavioral requirements)
+ *           - blueprint criteria (implementation requirements)
+ *           - research prompts
+ *           - distillation prompts
+ *           - blueprint prompts
+ *           - roadmap prompts
+ *           - execution prompts
+ *           - feedback template
+ *
+ * usage:
+ *   npx tsx src/contract/cli/init.behavior.ts --name <behaviorname> [--dir <directory>]
+ *
+ * guarantee:
+ *   - creates .behavior/ if not found
+ *   - creates versioned behavior directory
+ *   - findserts all thoughtroute files (creates if not found, skips if exists)
+ *   - idempotent: safe to rerun
+ *   - fail-fast on errors
+ */
+export declare const initBehavior: () => void;

package/dist/contract/cli/init.behavior.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * .what = initialize a .behavior directory for bhuild thoughtroute
+ *
+ * .why  = standardize the behavior-driven development thoughtroute
+ *         by creating a structured directory with:
+ *           - wish definition
+ *           - vision statement
+ *           - blackbox criteria (user-facing behavioral requirements)
+ *           - blueprint criteria (implementation requirements)
+ *           - research prompts
+ *           - distillation prompts
+ *           - blueprint prompts
+ *           - roadmap prompts
+ *           - execution prompts
+ *           - feedback template
+ *
+ * usage:
+ *   npx tsx src/contract/cli/init.behavior.ts --name <behaviorname> [--dir <directory>]
+ *
+ * guarantee:
+ *   - creates .behavior/ if not found
+ *   - creates versioned behavior directory
+ *   - findserts all thoughtroute files (creates if not found, skips if exists)
+ *   - idempotent: safe to rerun
+ *   - fail-fast on errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initBehavior = void 0;
+const path_1 = require("path");
+const zod_1 = require("zod");
+const bind_1 = require("../../domain.operations/behavior/bind");
+const init_1 = require("../../domain.operations/behavior/init");
+const cli_1 = require("../../infra/cli");
+// ────────────────────────────────────────────────────────────────────
+// schema
+// ────────────────────────────────────────────────────────────────────
+const schemaOfArgs = zod_1.z.object({
+    named: zod_1.z.object({
+        // skill-specific args
+        name: zod_1.z.string(),
+        dir: zod_1.z.string().optional(),
+        // rhachet passthrough args (optional, ignored)
+        repo: zod_1.z.string().optional(),
+        role: zod_1.z.string().optional(),
+        skill: zod_1.z.string().optional(),
+        s: zod_1.z.string().optional(),
+    }),
+    ordered: zod_1.z.array(zod_1.z.string()).default([]),
+});
+// ────────────────────────────────────────────────────────────────────
+// exported CLI entry point
+// ────────────────────────────────────────────────────────────────────
+const initBehavior = () => {
+    const { named } = (0, cli_1.getCliArgs)({ schema: schemaOfArgs });
+    const behaviorName = named.name;
+    const rawTargetDir = named.dir ?? process.cwd();
+    const context = { cwd: rawTargetDir };
+    // get current branch
+    const currentBranch = (0, bind_1.getCurrentBranch)({}, context);
+    // check if branch already bound
+    const bindResult = (0, bind_1.getBranchBehaviorBind)({ branchName: currentBranch }, context);
+    if (bindResult.behaviorDir) {
+        console.error(`⛈️  error: branch '${currentBranch}' is already bound to: ${(0, path_1.basename)(bindResult.behaviorDir)}`);
+        console.error('');
+        console.error('to create a new behavior, use a new tree:');
+        console.error('  git tree set --from main --open <branch-name-new>');
+        process.exit(1);
+    }
+    // normalize target dir (trim trailing .behavior)
+    const targetDir = rawTargetDir.replace(/\/?\.behavior\/?$/, '');
+    // generate isodate in format YYYY_MM_DD
+    const now = new Date();
+    const isoDate = `${now.getFullYear()}_${String(now.getMonth() + 1).padStart(2, '0')}_${String(now.getDate()).padStart(2, '0')}`;
+    // construct behavior directory path (absolute)
+    const behaviorDir = (0, path_1.join)(targetDir, '.behavior', `v${isoDate}.${behaviorName}`);
+    // compute relative path from caller's PWD for file contents
+    let behaviorDirRel = (0, path_1.join)((0, path_1.relative)(process.cwd(), targetDir), '.behavior', `v${isoDate}.${behaviorName}`);
+    // normalize: remove leading ./ if present
+    behaviorDirRel = behaviorDirRel.replace(/^\.\//, '');
+    // initialize behavior directory with template files
+    const result = (0, init_1.initBehaviorDir)({ behaviorDir, behaviorDirRel });
+    // log results
+    for (const file of result.kept) {
+        console.log(`   [KEEP] ${file}`);
+    }
+    for (const file of result.created) {
+        console.log(`   [CREATE] ${file}`);
+    }
+    // auto-bind: bind current branch to newly created behavior
+    (0, bind_1.setBranchBehaviorBind)({ branchName: currentBranch, behaviorDir, boundBy: 'init.behavior skill' }, context);
+    console.log('');
+    console.log('behavior thoughtroute initialized!');
+    console.log(`   ${behaviorDir}`);
+    console.log('');
+    console.log(`branch '${currentBranch}' bound to: v${isoDate}.${behaviorName}`);
+};
+exports.initBehavior = initBehavior;
+//# sourceMappingURL=init.behavior.js.map

package/dist/contract/cli/init.behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.behavior.js","sourceRoot":"","sources":["../../../src/contract/cli/init.behavior.ts"],"names":[],"mappings":"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"}

package/dist/contract/cli/review.behavior.d.ts

@@ -0,0 +1,16 @@
+/**
+ * .what = review behavior for decomposition need
+ *
+ * .why  = enables detection of behaviors that have grown too large
+ *         for reliable execution, by measurement of context pressure
+ *         and domain breadth, with recommendation to decompose
+ *
+ * usage:
+ *   npx tsx src/contract/cli/review.behavior.ts --of <behavior-name> [--dir <path>]
+ *
+ * guarantee:
+ *   - fail-fast if behavior not found or ambiguous
+ *   - fail-fast if behavior has no criteria (required for analysis)
+ *   - idempotent: safe to rerun
+ */
+export declare const reviewBehavior: () => Promise<void>;