rhachet-roles-bhuild 0.5.9 → 0.6.0

package/dist/contract/cli/give.feedback.d.ts

@@ -0,0 +1,18 @@
+/**
+ * .what = create a feedback file for a behavior artifact
+ *
+ * .why  = enables structured feedback on any behavior artifact
+ *         with placeholder substitution and version support
+ *
+ * usage:
+ *   give.feedback.sh --against <name>   # create feedback for artifact
+ *   give.feedback.sh --against <name> --behavior <name>   # explicit behavior
+ *   give.feedback.sh --against <name> --version 2   # create v2 feedback
+ *   give.feedback.sh --against <name> --template <path>   # custom template
+ *
+ * guarantee:
+ *   - fail-fast if artifact not found
+ *   - fail-fast if feedback file already exists
+ *   - fail-fast if template not found
+ */
+export declare const giveFeedback: () => void;

package/dist/contract/cli/give.feedback.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * .what = create a feedback file for a behavior artifact
+ *
+ * .why  = enables structured feedback on any behavior artifact
+ *         with placeholder substitution and version support
+ *
+ * usage:
+ *   give.feedback.sh --against <name>   # create feedback for artifact
+ *   give.feedback.sh --against <name> --behavior <name>   # explicit behavior
+ *   give.feedback.sh --against <name> --version 2   # create v2 feedback
+ *   give.feedback.sh --against <name> --template <path>   # custom template
+ *
+ * guarantee:
+ *   - fail-fast if artifact not found
+ *   - fail-fast if feedback file already exists
+ *   - fail-fast if template not found
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.giveFeedback = void 0;
+const zod_1 = require("zod");
+const giveFeedback_1 = require("../../domain.operations/behavior/feedback/giveFeedback");
+const cli_1 = require("../../infra/cli");
+// ────────────────────────────────────────────────────────────────────
+// schema
+// ────────────────────────────────────────────────────────────────────
+const schemaOfArgs = zod_1.z.object({
+    named: zod_1.z.object({
+        // skill-specific args
+        against: zod_1.z.string(),
+        behavior: zod_1.z.string().optional(),
+        version: zod_1.z.coerce.number().optional(),
+        template: zod_1.z.string().optional(),
+        force: zod_1.z.boolean().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 giveFeedback = () => {
+    const { named } = (0, cli_1.getCliArgs)({ schema: schemaOfArgs });
+    const result = (0, giveFeedback_1.giveFeedback)({
+        against: named.against,
+        behavior: named.behavior,
+        version: named.version,
+        template: named.template,
+        force: named.force,
+    });
+    console.log(`✓ feedback created: ${result.feedbackFile}`);
+    console.log(`  against: ${result.artifactFile}`);
+};
+exports.giveFeedback = giveFeedback;
+//# sourceMappingURL=give.feedback.js.map

package/dist/contract/cli/give.feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"give.feedback.js","sourceRoot":"","sources":["../../../src/contract/cli/give.feedback.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,6BAAwB;AAExB,wFAAuG;AACvG,wCAA4C;AAE5C,uEAAuE;AACvE,SAAS;AACT,uEAAuE;AAEvE,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC;QACd,sBAAsB;QACtB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;QACnB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACrC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,KAAK,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC7B,+CAA+C;QAC/C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACzB,CAAC;IACF,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH,uEAAuE;AACvE,2BAA2B;AAC3B,uEAAuE;AAEhE,MAAM,YAAY,GAAG,GAAS,EAAE;IACrC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,gBAAU,EAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,IAAA,2BAAc,EAAC;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC;AAbW,QAAA,YAAY,gBAavB"}

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

@@ -31,7 +31,10 @@ 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 computeFooterOutput_1 = require("../../domain.operations/behavior/render/computeFooterOutput");
 const cli_1 = require("../../infra/cli");
+const OpenerUnavailableError_1 = require("../../infra/shell/OpenerUnavailableError");
+const openFileWithOpener_1 = require("../../infra/shell/openFileWithOpener");
 // ────────────────────────────────────────────────────────────────────
 // schema
 // ────────────────────────────────────────────────────────────────────
@@ -40,6 +43,7 @@ const schemaOfArgs = zod_1.z.object({
         // skill-specific args
         name: zod_1.z.string(),
         dir: zod_1.z.string().optional(),
+        open: zod_1.z.string().optional(),
         // rhachet passthrough args (optional, ignored)
         repo: zod_1.z.string().optional(),
         role: zod_1.z.string().optional(),
@@ -56,17 +60,19 @@ const initBehavior = () => {
     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)}`);
+    // validate --open has a value if provided
+    if (named.open !== undefined && named.open.trim() === '') {
+        console.error('⛈️  error: --open requires an editor name');
         console.error('');
-        console.error('to create a new behavior, use a new tree:');
-        console.error('  git tree set --from main --open <branch-name-new>');
+        console.error('please specify what editor to open with. for example:');
+        console.error('  --open codium');
+        console.error('  --open vim');
+        console.error('  --open zed');
+        console.error('  --open code');
         process.exit(1);
     }
+    // get current branch
+    const currentBranch = (0, bind_1.getCurrentBranch)({}, context);
     // normalize target dir (trim trailing .behavior)
     const targetDir = rawTargetDir.replace(/\/?\.behavior\/?$/, '');
     // generate isodate in format YYYY_MM_DD
@@ -74,26 +80,60 @@ const initBehavior = () => {
     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}`);
+    // check if branch already bound (must be after behaviorDir is computed)
+    const bindResult = (0, bind_1.getBranchBehaviorBind)({ branchName: currentBranch }, context);
+    if (bindResult.behaviorDir && bindResult.behaviorDir !== 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);
+    }
     // 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}`);
+    // render tree-style output
+    const treeOutput = (0, init_1.computeOutputTree)({
+        created: result.created,
+        kept: result.kept,
+        updated: [],
+    });
+    console.log(treeOutput);
+    // compute relative path to wish file
+    const wishPathRel = `${behaviorDirRel}/0.wish.md`;
+    // try opener if --open is provided (before footer render)
+    let openerUsed;
+    if (named.open) {
+        try {
+            (0, openFileWithOpener_1.openFileWithOpener)({ opener: named.open, filePath: wishPathRel });
+            openerUsed = named.open;
+        }
+        catch (error) {
+            if (error instanceof OpenerUnavailableError_1.OpenerUnavailableError) {
+                console.log('');
+                console.log(`⚠️  ${error.message}`);
+            }
+            else {
+                throw error;
+            }
+        }
     }
+    // render footer with wish path (and opener if successful)
+    console.log('');
+    const footerOutput = (0, computeFooterOutput_1.computeFooterOutput)({ wishPathRel, opener: openerUsed });
+    console.log(footerOutput);
     // auto-bind: bind current branch to newly created behavior
     (0, bind_1.setBranchBehaviorBind)({ branchName: currentBranch, behaviorDir, boundBy: 'init.behavior skill' }, context);
+    // log branch bind confirmation
+    const dim = '\x1b[2m';
+    const reset = '\x1b[0m';
     console.log('');
-    console.log('behavior thoughtroute initialized!');
-    console.log(`   ${behaviorDir}`);
-    console.log('');
-    console.log(`branch '${currentBranch}' bound to: v${isoDate}.${behaviorName}`);
+    console.log(`🍄 we'll remember,`);
+    console.log(`   ├─ branch ${currentBranch} <-> behavior v${isoDate}.${behaviorName}`);
+    console.log(`   └─ ${dim}branch bound to behavior, to boot via hooks${reset}`);
 };
 exports.initBehavior = initBehavior;
 //# sourceMappingURL=init.behavior.js.map

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

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

package/dist/domain.objects/BehaviorArtifact.d.ts

@@ -0,0 +1,32 @@
+import { DomainLiteral } from 'domain-objects';
+/**
+ * .what = a behavior artifact that can be targeted for feedback
+ * .why = provides identity and version info for artifact resolution
+ */
+interface BehaviorArtifact {
+    /**
+     * full path to the artifact file
+     */
+    path: string;
+    /**
+     * artifact name extracted from filename (e.g., 'execution', 'criteria.blackbox')
+     */
+    name: string;
+    /**
+     * version number if present in filename (vX), null otherwise
+     */
+    version: number | null;
+    /**
+     * attempt number if present in filename (iX), null otherwise
+     */
+    attempt: number | null;
+    /**
+     * the base filename without path
+     */
+    filename: string;
+}
+declare class BehaviorArtifact extends DomainLiteral<BehaviorArtifact> implements BehaviorArtifact {
+    static primary: readonly ["path"];
+    static unique: readonly ["path"];
+}
+export { BehaviorArtifact };

package/dist/domain.objects/BehaviorArtifact.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BehaviorArtifact = void 0;
+const domain_objects_1 = require("domain-objects");
+class BehaviorArtifact extends domain_objects_1.DomainLiteral {
+}
+exports.BehaviorArtifact = BehaviorArtifact;
+BehaviorArtifact.primary = ['path'];
+BehaviorArtifact.unique = ['path'];
+//# sourceMappingURL=BehaviorArtifact.js.map

package/dist/domain.objects/BehaviorArtifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BehaviorArtifact.js","sourceRoot":"","sources":["../../src/domain.objects/BehaviorArtifact.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAgC/C,MAAM,gBACJ,SAAQ,8BAA+B;;AAOhC,4CAAgB;AAJT,wBAAO,GAAG,CAAC,MAAM,CAAU,CAAC;AAC5B,uBAAM,GAAG,CAAC,MAAM,CAAU,CAAC"}

package/dist/domain.objects/BehaviorFeedback.d.ts

@@ -0,0 +1,28 @@
+import { DomainLiteral, type RefByUnique } from 'domain-objects';
+import type { BehaviorArtifact } from './BehaviorArtifact';
+/**
+ * .what = a feedback artifact linked to a target behavior artifact
+ * .why = tracks the relationship between feedback and its target
+ */
+interface BehaviorFeedback {
+    /**
+     * full path to the feedback file
+     */
+    path: string;
+    /**
+     * reference to the artifact this feedback targets
+     */
+    against: RefByUnique<typeof BehaviorArtifact>;
+    /**
+     * feedback version (v1, v2, etc.)
+     */
+    version: number;
+    /**
+     * the base filename
+     */
+    filename: string;
+}
+declare class BehaviorFeedback extends DomainLiteral<BehaviorFeedback> implements BehaviorFeedback {
+    static unique: readonly ["path"];
+}
+export { BehaviorFeedback };

package/dist/domain.objects/BehaviorFeedback.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BehaviorFeedback = void 0;
+const domain_objects_1 = require("domain-objects");
+class BehaviorFeedback extends domain_objects_1.DomainLiteral {
+}
+exports.BehaviorFeedback = BehaviorFeedback;
+BehaviorFeedback.unique = ['path'];
+//# sourceMappingURL=BehaviorFeedback.js.map

package/dist/domain.objects/BehaviorFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BehaviorFeedback.js","sourceRoot":"","sources":["../../src/domain.objects/BehaviorFeedback.ts"],"names":[],"mappings":";;;AAAA,mDAAiE;AA6BjE,MAAM,gBACJ,SAAQ,8BAA+B;;AAMhC,4CAAgB;AAHT,uBAAM,GAAG,CAAC,MAAM,CAAU,CAAC"}

package/dist/domain.operations/behavior/feedback/computeBehaviorFeedbackName.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = compute the feedback filename for a target artifact
+ * .why = centralizes the filename convention logic
+ */
+export declare const computeBehaviorFeedbackName: (input: {
+    artifactFileName: string;
+    feedbackVersion: number;
+}) => string;

package/dist/domain.operations/behavior/feedback/computeBehaviorFeedbackName.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeBehaviorFeedbackName = void 0;
+/**
+ * .what = compute the feedback filename for a target artifact
+ * .why = centralizes the filename convention logic
+ */
+const computeBehaviorFeedbackName = (input) => {
+    // append feedback suffix with version
+    return `${input.artifactFileName}.[feedback].v${input.feedbackVersion}.[given].by_human.md`;
+};
+exports.computeBehaviorFeedbackName = computeBehaviorFeedbackName;
+//# sourceMappingURL=computeBehaviorFeedbackName.js.map

package/dist/domain.operations/behavior/feedback/computeBehaviorFeedbackName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeBehaviorFeedbackName.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/feedback/computeBehaviorFeedbackName.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACI,MAAM,2BAA2B,GAAG,CAAC,KAG3C,EAAU,EAAE;IACX,sCAAsC;IACtC,OAAO,GAAG,KAAK,CAAC,gBAAgB,gBAAgB,KAAK,CAAC,eAAe,sBAAsB,CAAC;AAC9F,CAAC,CAAC;AANW,QAAA,2BAA2B,+BAMtC"}

package/dist/domain.operations/behavior/feedback/getBehaviorDirForFeedback.d.ts

@@ -0,0 +1,17 @@
+/**
+ * .what = resolve the behavior directory for feedback operations
+ * .why = supports both bound behavior discovery and explicit --behavior flag
+ *
+ * .note = priority:
+ *         - if branch is bound and no flag → use bind
+ *         - if branch is bound and flag matches → use bind
+ *         - if branch is bound and flag differs → error (unless --force)
+ *         - if branch not bound and flag → use flag
+ *         - if branch not bound and no flag → error
+ */
+export declare const getBehaviorDirForFeedback: (input: {
+    behavior?: string;
+    force?: boolean;
+}, context?: {
+    cwd?: string;
+}) => string;

package/dist/domain.operations/behavior/feedback/getBehaviorDirForFeedback.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBehaviorDirForFeedback = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const getBranchBehaviorBind_1 = require("../bind/getBranchBehaviorBind");
+const getBehaviorDir_1 = require("../getBehaviorDir");
+/**
+ * .what = resolve the behavior directory for feedback operations
+ * .why = supports both bound behavior discovery and explicit --behavior flag
+ *
+ * .note = priority:
+ *         - if branch is bound and no flag → use bind
+ *         - if branch is bound and flag matches → use bind
+ *         - if branch is bound and flag differs → error (unless --force)
+ *         - if branch not bound and flag → use flag
+ *         - if branch not bound and no flag → error
+ */
+const getBehaviorDirForFeedback = (input, context) => {
+    const cwd = context?.cwd ?? process.cwd();
+    // check for branch bind
+    const { behaviorDir: boundDir } = (0, getBranchBehaviorBind_1.getBranchBehaviorBind)({}, { cwd });
+    // branch is bound
+    if (boundDir) {
+        // no explicit flag → use bind
+        if (!input.behavior)
+            return boundDir;
+        // resolve the flag to a directory
+        const flagDir = (0, getBehaviorDir_1.getBehaviorDir)({ name: input.behavior, targetDir: cwd });
+        // flag matches bind → use bind
+        if (flagDir === boundDir)
+            return boundDir;
+        // flag differs from bind → error unless force
+        if (!input.force) {
+            throw new helpful_errors_1.BadRequestError(`branch is bound to ${boundDir} but --behavior flag specifies ${flagDir}. use --force to override.`);
+        }
+        // force override → use flag
+        return flagDir;
+    }
+    // branch not bound, flag provided → use flag
+    if (input.behavior) {
+        return (0, getBehaviorDir_1.getBehaviorDir)({ name: input.behavior, targetDir: cwd });
+    }
+    // branch not bound, no flag → error
+    throw new helpful_errors_1.BadRequestError('no behavior bound to current branch. use --behavior to specify one.');
+};
+exports.getBehaviorDirForFeedback = getBehaviorDirForFeedback;
+//# sourceMappingURL=getBehaviorDirForFeedback.js.map

package/dist/domain.operations/behavior/feedback/getBehaviorDirForFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBehaviorDirForFeedback.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/feedback/getBehaviorDirForFeedback.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAEjD,yEAAsE;AACtE,sDAAmD;AAEnD;;;;;;;;;;GAUG;AACI,MAAM,yBAAyB,GAAG,CACvC,KAA6C,EAC7C,OAA0B,EAClB,EAAE;IACV,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1C,wBAAwB;IACxB,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,IAAA,6CAAqB,EAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAErE,kBAAkB;IAClB,IAAI,QAAQ,EAAE,CAAC;QACb,8BAA8B;QAC9B,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAErC,kCAAkC;QAClC,MAAM,OAAO,GAAG,IAAA,+BAAc,EAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAEzE,+BAA+B;QAC/B,IAAI,OAAO,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE1C,8CAA8C;QAC9C,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,gCAAe,CACvB,sBAAsB,QAAQ,kCAAkC,OAAO,4BAA4B,CACpG,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,6CAA6C;IAC7C,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,OAAO,IAAA,+BAAc,EAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,oCAAoC;IACpC,MAAM,IAAI,gCAAe,CACvB,qEAAqE,CACtE,CAAC;AACJ,CAAC,CAAC;AAxCW,QAAA,yBAAyB,6BAwCpC"}

package/dist/domain.operations/behavior/feedback/getLatestArtifactByName.d.ts

@@ -0,0 +1,16 @@
+import { BehaviorArtifact } from '../../../domain.objects/BehaviorArtifact';
+/**
+ * .what = resolve the latest artifact by name from a behavior directory
+ * .why = enables feedback to target the most recent version of any artifact
+ *
+ * .note = version precedence:
+ *         - v3.i2 > v2.i3 (version wins)
+ *         - v2.i3 > v2.i1 (latest attempt within version)
+ *         - files with [feedback] in name are excluded
+ */
+export declare const getLatestArtifactByName: (input: {
+    behaviorDir: string;
+    artifactName: string;
+}, context?: {
+    cwd?: string;
+}) => BehaviorArtifact | null;

package/dist/domain.operations/behavior/feedback/getLatestArtifactByName.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLatestArtifactByName = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const BehaviorArtifact_1 = require("../../../domain.objects/BehaviorArtifact");
+/**
+ * .what = resolve the latest artifact by name from a behavior directory
+ * .why = enables feedback to target the most recent version of any artifact
+ *
+ * .note = version precedence:
+ *         - v3.i2 > v2.i3 (version wins)
+ *         - v2.i3 > v2.i1 (latest attempt within version)
+ *         - files with [feedback] in name are excluded
+ */
+const getLatestArtifactByName = (input, context) => {
+    // read directory contents
+    const files = (0, fs_1.readdirSync)(input.behaviorDir);
+    // build pattern to match artifact files
+    // matches: *.<artifactName>[.suffix]*.md where artifactName is followed by . then optional segments
+    const artifactPattern = new RegExp(`\\.${escapeRegex(input.artifactName)}(?:\\.[^.]+)*\\.md$`, 'i');
+    // parse version/attempt from filename pattern: .v{version}.i{attempt}
+    const versionPattern = /\.v(\d+)/;
+    const attemptPattern = /\.i(\d+)/;
+    // collect artifacts that match the pattern
+    const artifactsMatched = [];
+    for (const file of files) {
+        // skip if doesn't match artifact name pattern
+        if (!artifactPattern.test(file))
+            continue;
+        // skip feedback files
+        if (file.includes('[feedback]'))
+            continue;
+        // skip .src files
+        if (file.endsWith('.src'))
+            continue;
+        // parse version and attempt
+        const versionMatch = file.match(versionPattern);
+        const attemptMatch = file.match(attemptPattern);
+        artifactsMatched.push({
+            path: (0, path_1.join)(input.behaviorDir, file),
+            name: input.artifactName,
+            version: versionMatch?.[1] ? parseInt(versionMatch[1], 10) : null,
+            attempt: attemptMatch?.[1] ? parseInt(attemptMatch[1], 10) : null,
+            filename: file,
+        });
+    }
+    if (artifactsMatched.length === 0)
+        return null;
+    // sort by version desc, then attempt desc
+    // null versions/attempts come last
+    artifactsMatched.sort((a, b) => {
+        // compare versions
+        const vA = a.version ?? -1;
+        const vB = b.version ?? -1;
+        if (vA !== vB)
+            return vB - vA;
+        // compare attempts
+        const iA = a.attempt ?? -1;
+        const iB = b.attempt ?? -1;
+        return iB - iA;
+    });
+    // return latest as BehaviorArtifact
+    const latest = artifactsMatched[0];
+    if (!latest)
+        return null;
+    return new BehaviorArtifact_1.BehaviorArtifact({
+        path: latest.path,
+        name: latest.name,
+        version: latest.version,
+        attempt: latest.attempt,
+        filename: latest.filename,
+    });
+};
+exports.getLatestArtifactByName = getLatestArtifactByName;
+/**
+ * .what = escape special regex characters in a string
+ * .why = enables safe use of artifact names in regex patterns
+ */
+const escapeRegex = (str) => {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+};
+//# sourceMappingURL=getLatestArtifactByName.js.map

package/dist/domain.operations/behavior/feedback/getLatestArtifactByName.js.map

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

package/dist/domain.operations/behavior/feedback/giveFeedback.d.ts

@@ -0,0 +1,17 @@
+/**
+ * .what = create a feedback file for a behavior artifact
+ * .why = enables structured feedback on any behavior artifact with placeholder substitution
+ */
+export declare const giveFeedback: (input: {
+    against: string;
+    behavior?: string;
+    version?: number;
+    template?: string;
+    force?: boolean;
+}, context?: {
+    cwd?: string;
+}) => {
+    feedbackFile: string;
+    artifactFile: string;
+    behaviorDir: string;
+};

package/dist/domain.operations/behavior/feedback/giveFeedback.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.giveFeedback = void 0;
+const fs_1 = require("fs");
+const helpful_errors_1 = require("helpful-errors");
+const path_1 = require("path");
+const computeBehaviorFeedbackName_1 = require("./computeBehaviorFeedbackName");
+const getBehaviorDirForFeedback_1 = require("./getBehaviorDirForFeedback");
+const getLatestArtifactByName_1 = require("./getLatestArtifactByName");
+const initFeedbackTemplate_1 = require("./initFeedbackTemplate");
+/**
+ * .what = create a feedback file for a behavior artifact
+ * .why = enables structured feedback on any behavior artifact with placeholder substitution
+ */
+const giveFeedback = (input, context) => {
+    const cwd = context?.cwd ?? process.cwd();
+    // resolve behavior directory
+    const behaviorDir = (0, getBehaviorDirForFeedback_1.getBehaviorDirForFeedback)({ behavior: input.behavior, force: input.force }, { cwd });
+    // find latest artifact
+    const artifact = (0, getLatestArtifactByName_1.getLatestArtifactByName)({ behaviorDir, artifactName: input.against }, { cwd });
+    if (!artifact) {
+        throw new helpful_errors_1.BadRequestError(`no artifact found for '${input.against}' in ${behaviorDir}`);
+    }
+    // compute feedback filename
+    const feedbackVersion = input.version ?? 1;
+    const feedbackFilename = (0, computeBehaviorFeedbackName_1.computeBehaviorFeedbackName)({
+        artifactFileName: artifact.filename,
+        feedbackVersion,
+    });
+    const feedbackPath = (0, path_1.join)(behaviorDir, feedbackFilename);
+    // check if feedback file already exists
+    if ((0, fs_1.existsSync)(feedbackPath)) {
+        throw new helpful_errors_1.BadRequestError(`feedback file already exists: ${feedbackFilename}. use --version ${feedbackVersion + 1} to create a new version.`);
+    }
+    // resolve template path
+    const templatePath = input.template ??
+        (0, path_1.join)(behaviorDir, '.ref.[feedback].v1.[given].by_human.md');
+    if (!(0, fs_1.existsSync)(templatePath)) {
+        throw new helpful_errors_1.BadRequestError(`template not found: ${templatePath}`);
+    }
+    // compute relative behavior directory path
+    const behaviorDirRel = (0, path_1.relative)(cwd, behaviorDir);
+    // init feedback file from template
+    (0, initFeedbackTemplate_1.initFeedbackTemplate)({
+        templatePath,
+        targetPath: feedbackPath,
+        artifactFileName: artifact.filename,
+        behaviorDirRel,
+    });
+    return {
+        feedbackFile: feedbackPath,
+        artifactFile: artifact.path,
+        behaviorDir,
+    };
+};
+exports.giveFeedback = giveFeedback;
+//# sourceMappingURL=giveFeedback.js.map

package/dist/domain.operations/behavior/feedback/giveFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"giveFeedback.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/feedback/giveFeedback.ts"],"names":[],"mappings":";;;AAAA,2BAAgC;AAChC,mDAAiD;AACjD,+BAAsC;AAEtC,+EAA4E;AAC5E,2EAAwE;AACxE,uEAAoE;AACpE,iEAA8D;AAE9D;;;GAGG;AACI,MAAM,YAAY,GAAG,CAC1B,KAMC,EACD,OAA0B,EAC2C,EAAE;IACvE,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1C,6BAA6B;IAC7B,MAAM,WAAW,GAAG,IAAA,qDAAyB,EAC3C,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAChD,EAAE,GAAG,EAAE,CACR,CAAC;IAEF,uBAAuB;IACvB,MAAM,QAAQ,GAAG,IAAA,iDAAuB,EACtC,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,EAC5C,EAAE,GAAG,EAAE,CACR,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,gCAAe,CACvB,0BAA0B,KAAK,CAAC,OAAO,QAAQ,WAAW,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;IAC3C,MAAM,gBAAgB,GAAG,IAAA,yDAA2B,EAAC;QACnD,gBAAgB,EAAE,QAAQ,CAAC,QAAQ;QACnC,eAAe;KAChB,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAEzD,wCAAwC;IACxC,IAAI,IAAA,eAAU,EAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,gCAAe,CACvB,iCAAiC,gBAAgB,mBAAmB,eAAe,GAAG,CAAC,2BAA2B,CACnH,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,MAAM,YAAY,GAChB,KAAK,CAAC,QAAQ;QACd,IAAA,WAAI,EAAC,WAAW,EAAE,wCAAwC,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAA,eAAU,EAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,gCAAe,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,2CAA2C;IAC3C,MAAM,cAAc,GAAG,IAAA,eAAQ,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAElD,mCAAmC;IACnC,IAAA,2CAAoB,EAAC;QACnB,YAAY;QACZ,UAAU,EAAE,YAAY;QACxB,gBAAgB,EAAE,QAAQ,CAAC,QAAQ;QACnC,cAAc;KACf,CAAC,CAAC;IAEH,OAAO;QACL,YAAY,EAAE,YAAY;QAC1B,YAAY,EAAE,QAAQ,CAAC,IAAI;QAC3B,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC;AApEW,QAAA,YAAY,gBAoEvB"}

package/dist/domain.operations/behavior/feedback/initFeedbackTemplate.d.ts

@@ -0,0 +1,10 @@
+/**
+ * .what = initialize a feedback file from a template with placeholder substitution
+ * .why = enables consistent feedback file creation with behavior-specific values
+ */
+export declare const initFeedbackTemplate: (input: {
+    templatePath: string;
+    targetPath: string;
+    artifactFileName: string;
+    behaviorDirRel: string;
+}) => void;

package/dist/domain.operations/behavior/feedback/initFeedbackTemplate.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initFeedbackTemplate = void 0;
+const fs_1 = require("fs");
+/**
+ * .what = initialize a feedback file from a template with placeholder substitution
+ * .why = enables consistent feedback file creation with behavior-specific values
+ */
+const initFeedbackTemplate = (input) => {
+    // read template content
+    const templateContent = (0, fs_1.readFileSync)(input.templatePath, 'utf-8');
+    // replace placeholders with actual values
+    const content = templateContent
+        .replace(/\$BEHAVIOR_REF_NAME/g, input.artifactFileName)
+        .replace(/\$BEHAVIOR_DIR_REL/g, input.behaviorDirRel);
+    // write to target path
+    (0, fs_1.writeFileSync)(input.targetPath, content, 'utf-8');
+};
+exports.initFeedbackTemplate = initFeedbackTemplate;
+//# sourceMappingURL=initFeedbackTemplate.js.map

package/dist/domain.operations/behavior/feedback/initFeedbackTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initFeedbackTemplate.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/feedback/initFeedbackTemplate.ts"],"names":[],"mappings":";;;AAAA,2BAAiD;AAEjD;;;GAGG;AACI,MAAM,oBAAoB,GAAG,CAAC,KAKpC,EAAQ,EAAE;IACT,wBAAwB;IACxB,MAAM,eAAe,GAAG,IAAA,iBAAY,EAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAElE,0CAA0C;IAC1C,MAAM,OAAO,GAAG,eAAe;SAC5B,OAAO,CAAC,sBAAsB,EAAE,KAAK,CAAC,gBAAgB,CAAC;SACvD,OAAO,CAAC,qBAAqB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAExD,uBAAuB;IACvB,IAAA,kBAAa,EAAC,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC,CAAC;AAhBW,QAAA,oBAAoB,wBAgB/B"}

package/dist/domain.operations/behavior/init/computeOutputTree.d.ts

@@ -0,0 +1,9 @@
+/**
+ * .what = compute tree-style output for behavior init file actions
+ * .why = vibed, scannable output that shows file actions clearly
+ */
+export declare const computeOutputTree: (input: {
+    created: string[];
+    kept: string[];
+    updated: string[];
+}) => string;

package/dist/domain.operations/behavior/init/computeOutputTree.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeOutputTree = void 0;
+/**
+ * .what = compute tree-style output for behavior init file actions
+ * .why = vibed, scannable output that shows file actions clearly
+ */
+const computeOutputTree = (input) => {
+    // define symbols for each action type
+    const symbolCreated = '+';
+    const symbolKept = '✓';
+    const symbolUpdated = '↻';
+    // combine all files with their symbols
+    const entries = [
+        ...input.created.map((file) => ({ file, symbol: symbolCreated })),
+        ...input.kept.map((file) => ({ file, symbol: symbolKept })),
+        ...input.updated.map((file) => ({ file, symbol: symbolUpdated })),
+    ];
+    // sort alphabetically by filename
+    entries.sort((a, b) => a.file.localeCompare(b.file));
+    // build header
+    const header = '🦫 oh, behave!';
+    // handle empty case
+    if (entries.length === 0)
+        return header;
+    // build tree lines
+    const lines = entries.map((entry, index) => {
+        const isLast = index === entries.length - 1;
+        const branch = isLast ? '└─' : '├─';
+        return `   ${branch} ${entry.symbol} ${entry.file}`;
+    });
+    return [header, ...lines].join('\n');
+};
+exports.computeOutputTree = computeOutputTree;
+//# sourceMappingURL=computeOutputTree.js.map

package/dist/domain.operations/behavior/init/computeOutputTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeOutputTree.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/init/computeOutputTree.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAAC,KAIjC,EAAU,EAAE;IACX,sCAAsC;IACtC,MAAM,aAAa,GAAG,GAAG,CAAC;IAC1B,MAAM,UAAU,GAAG,GAAG,CAAC;IACvB,MAAM,aAAa,GAAG,GAAG,CAAC;IAE1B,uCAAuC;IACvC,MAAM,OAAO,GAA4C;QACvD,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QACjE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3D,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;KAClE,CAAC;IAEF,kCAAkC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAErD,eAAe;IACf,MAAM,MAAM,GAAG,gBAAgB,CAAC;IAEhC,oBAAoB;IACpB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAExC,mBAAmB;IACnB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACzC,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACpC,OAAO,MAAM,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC;AAlCW,QAAA,iBAAiB,qBAkC5B"}

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

@@ -1 +1,2 @@
+export { computeOutputTree } from './computeOutputTree';
 export { initBehaviorDir } from './initBehaviorDir';

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

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initBehaviorDir = void 0;
+exports.initBehaviorDir = exports.computeOutputTree = void 0;
+var computeOutputTree_1 = require("./computeOutputTree");
+Object.defineProperty(exports, "computeOutputTree", { enumerable: true, get: function () { return computeOutputTree_1.computeOutputTree; } });
 var initBehaviorDir_1 = require("./initBehaviorDir");
 Object.defineProperty(exports, "initBehaviorDir", { enumerable: true, get: function () { return initBehaviorDir_1.initBehaviorDir; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/init/index.ts"],"names":[],"mappings":";;;AAAA,qDAAoD;AAA3C,kHAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/init/index.ts"],"names":[],"mappings":";;;AAAA,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,qDAAoD;AAA3C,kHAAA,eAAe,OAAA"}

package/dist/domain.operations/behavior/init/templates/.ref.[feedback].v1.[given].by_human.md

@@ -1,5 +1,5 @@
 emit your response to the feedback into
-- $BEHAVIOR_DIR_REL/.ref.[feedback].v1.[taken].by_robot.md
+- $BEHAVIOR_DIR_REL/$BEHAVIOR_REF_NAME.[feedback].v1.[taken].by_robot.md
 
 1. emit your response checklist
 2. exec your response plan

package/dist/domain.operations/behavior/render/computeFooterOutput.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = compute footer output with relative wish path
+ * .why = easy-to-copy path for open of the wish file
+ */
+export declare const computeFooterOutput: (input: {
+    wishPathRel: string;
+    opener?: string;
+}) => string;

package/dist/domain.operations/behavior/render/computeFooterOutput.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeFooterOutput = void 0;
+/**
+ * .what = compute footer output with relative wish path
+ * .why = easy-to-copy path for open of the wish file
+ */
+const computeFooterOutput = (input) => {
+    const dim = '\x1b[2m';
+    const reset = '\x1b[0m';
+    // build output lines
+    const lines = [`🌲 go on then,`, `   ├─ ${input.wishPathRel}`];
+    // add opener line or tip based on whether opener was used
+    if (input.opener) {
+        lines.push(`   └─ ${dim}opened in ${input.opener}${reset}`);
+    }
+    else {
+        lines.push(`   └─ ${dim}tip: use --open to open the wish automatically${reset}`);
+    }
+    return lines.join('\n');
+};
+exports.computeFooterOutput = computeFooterOutput;
+//# sourceMappingURL=computeFooterOutput.js.map

package/dist/domain.operations/behavior/render/computeFooterOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeFooterOutput.js","sourceRoot":"","sources":["../../../../src/domain.operations/behavior/render/computeFooterOutput.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACI,MAAM,mBAAmB,GAAG,CAAC,KAGnC,EAAU,EAAE;IACX,MAAM,GAAG,GAAG,SAAS,CAAC;IACtB,MAAM,KAAK,GAAG,SAAS,CAAC;IAExB,qBAAqB;IACrB,MAAM,KAAK,GAAG,CAAC,gBAAgB,EAAE,SAAS,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAE/D,0DAA0D;IAC1D,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,aAAa,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,SAAS,GAAG,iDAAiD,KAAK,EAAE,CACrE,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC;AApBW,QAAA,mBAAmB,uBAoB9B"}

package/dist/domain.roles/behaver/skills/give.feedback.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+######################################################################
+# .what = generate a feedback file for a behavior artifact
+#
+# .why  = enables structured feedback on any behavior artifact
+#         - creates feedback files linked to target artifacts
+#         - supports versioned feedback (v1, v2, etc.)
+#         - replaces template placeholders with artifact references
+#
+# .when = use this skill when you need to:
+#         - provide feedback on an execution artifact
+#         - review criteria, blueprint, or research artifacts
+#         - create structured response templates for human review
+#
+# .how  = thin dispatcher to TypeScript implementation
+#
+# .args:
+#   --against <name>    (required) artifact name to target
+#                       e.g., execution, criteria.blackbox, wish, blueprint
+#   --behavior <name>   (optional) behavior directory name
+#                       required if branch is not bound to a behavior
+#   --version <N>       (optional) feedback version number (default: 1)
+#   --template <path>   (optional) custom template file path
+#   --force             (optional) override bind mismatch
+#
+# .examples:
+#   # generate feedback for latest execution artifact (branch must be bound)
+#   npx rhachet run --skill give.feedback --against execution
+#
+#   # generate feedback for criteria.blackbox with explicit behavior
+#   npx rhachet run --skill give.feedback --against criteria.blackbox --behavior give-feedback
+#
+#   # generate v2 feedback on same artifact
+#   npx rhachet run --skill give.feedback --against execution --version 2
+#
+#   # use custom template
+#   npx rhachet run --skill give.feedback --against wish --template ./my-template.md
+#
+#   # override bind mismatch with --force
+#   npx rhachet run --skill give.feedback --against blueprint --behavior other-feature --force
+#
+# .output:
+#   - creates: ${behaviorDir}/${artifactFileName}.[feedback].v${version}.[given].by_human.md
+#   - logs: feedback file path and target artifact to stdout
+#
+# .errors:
+#   - no artifact found: shows glob pattern used
+#   - feedback exists: prevents overwrite, suggests --version
+#   - template not found: indicates template path needed
+#   - bind mismatch: suggests --force to override
+######################################################################
+
+set -euo pipefail
+
+exec npx tsx -e "import('rhachet-roles-bhuild').then(m => m.cli.giveFeedback())" -- "$@"

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export declare const cli: {
     bindBehavior: () => void;
     bootBehavior: () => void;
     decomposeBehavior: () => Promise<void>;
+    giveFeedback: () => void;
     initBehavior: () => void;
     reviewBehavior: () => Promise<void>;
 };

package/dist/index.js

@@ -20,12 +20,14 @@ __exportStar(require("./contract/sdk"), exports);
 const bind_behavior_1 = require("./contract/cli/bind.behavior");
 const boot_behavior_1 = require("./contract/cli/boot.behavior");
 const decompose_behavior_1 = require("./contract/cli/decompose.behavior");
+const give_feedback_1 = require("./contract/cli/give.feedback");
 const init_behavior_1 = require("./contract/cli/init.behavior");
 const review_behavior_1 = require("./contract/cli/review.behavior");
 exports.cli = {
     bindBehavior: bind_behavior_1.bindBehavior,
     bootBehavior: boot_behavior_1.bootBehavior,
     decomposeBehavior: decompose_behavior_1.decomposeBehavior,
+    giveFeedback: give_feedback_1.giveFeedback,
     initBehavior: init_behavior_1.initBehavior,
     reviewBehavior: review_behavior_1.reviewBehavior,
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA+B;AAE/B,+CAA+C;AAC/C,gEAA4D;AAC5D,gEAA4D;AAC5D,0EAAsE;AACtE,gEAA4D;AAC5D,oEAAgE;AAEnD,QAAA,GAAG,GAAG;IACjB,YAAY,EAAZ,4BAAY;IACZ,YAAY,EAAZ,4BAAY;IACZ,iBAAiB,EAAjB,sCAAiB;IACjB,YAAY,EAAZ,4BAAY;IACZ,cAAc,EAAd,gCAAc;CACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA+B;AAE/B,+CAA+C;AAC/C,gEAA4D;AAC5D,gEAA4D;AAC5D,0EAAsE;AACtE,gEAA4D;AAC5D,gEAA4D;AAC5D,oEAAgE;AAEnD,QAAA,GAAG,GAAG;IACjB,YAAY,EAAZ,4BAAY;IACZ,YAAY,EAAZ,4BAAY;IACZ,iBAAiB,EAAjB,sCAAiB;IACjB,YAAY,EAAZ,4BAAY;IACZ,YAAY,EAAZ,4BAAY;IACZ,cAAc,EAAd,gCAAc;CACf,CAAC"}

package/dist/infra/shell/OpenerUnavailableError.d.ts

@@ -0,0 +1,7 @@
+import { HelpfulError } from 'helpful-errors';
+/**
+ * .what = error thrown when opener command is unavailable or fails
+ * .why = named error for control flow - orchestrator catches this specifically
+ */
+export declare class OpenerUnavailableError extends HelpfulError {
+}

package/dist/infra/shell/OpenerUnavailableError.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenerUnavailableError = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = error thrown when opener command is unavailable or fails
+ * .why = named error for control flow - orchestrator catches this specifically
+ */
+class OpenerUnavailableError extends helpful_errors_1.HelpfulError {
+}
+exports.OpenerUnavailableError = OpenerUnavailableError;
+//# sourceMappingURL=OpenerUnavailableError.js.map

package/dist/infra/shell/OpenerUnavailableError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenerUnavailableError.js","sourceRoot":"","sources":["../../../src/infra/shell/OpenerUnavailableError.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAE9C;;;GAGG;AACH,MAAa,sBAAuB,SAAQ,6BAAY;CAAG;AAA3D,wDAA2D"}

package/dist/infra/shell/openFileWithOpener.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = open a file with specified editor/opener
+ * .why = streamline user workflow by auto-open of wish file
+ */
+export declare const openFileWithOpener: (input: {
+    opener: string;
+    filePath: string;
+}) => void;

package/dist/infra/shell/openFileWithOpener.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openFileWithOpener = void 0;
+const child_process_1 = require("child_process");
+const OpenerUnavailableError_1 = require("./OpenerUnavailableError");
+/**
+ * .what = open a file with specified editor/opener
+ * .why = streamline user workflow by auto-open of wish file
+ */
+const openFileWithOpener = (input) => {
+    // build command with quoted path for safety
+    const command = `${input.opener} "${input.filePath}"`;
+    // execute and let errors propagate as OpenerUnavailableError
+    try {
+        (0, child_process_1.execSync)(command, { stdio: 'inherit' });
+    }
+    catch (error) {
+        throw new OpenerUnavailableError_1.OpenerUnavailableError(`opener '${input.opener}' unavailable or failed`, { cause: error instanceof Error ? error : undefined });
+    }
+};
+exports.openFileWithOpener = openFileWithOpener;
+//# sourceMappingURL=openFileWithOpener.js.map

package/dist/infra/shell/openFileWithOpener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openFileWithOpener.js","sourceRoot":"","sources":["../../../src/infra/shell/openFileWithOpener.ts"],"names":[],"mappings":";;;AAAA,iDAAyC;AAEzC,qEAAkE;AAElE;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,KAGlC,EAAQ,EAAE;IACT,4CAA4C;IAC5C,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,QAAQ,GAAG,CAAC;IAEtD,6DAA6D;IAC7D,IAAI,CAAC;QACH,IAAA,wBAAQ,EAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,+CAAsB,CAC9B,WAAW,KAAK,CAAC,MAAM,yBAAyB,EAChD,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CACtD,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAhBW,QAAA,kBAAkB,sBAgB7B"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet-roles-bhuild",
   "author": "ehmpathy",
   "description": "roles for building resilient systems, via rhachet",
-  "version": "0.5.9",
+  "version": "0.6.0",
   "repository": "ehmpathy/rhachet-roles-bhuild",
   "homepage": "https://github.com/ehmpathy/rhachet-roles-bhuild",
   "keywords": [
@@ -56,7 +56,7 @@
   "dependencies": {
     "domain-objects": "0.31.9",
     "helpful-errors": "1.5.3",
-    "rhachet-roles-bhrain": "0.5.7",
+    "rhachet-roles-bhrain": "0.5.9",
     "test-fns": "1.7.2",
     "zod": "4.3.4"
   },