rhachet-roles-bhuild 0.1.3 → 0.4.0

package/dist/domain.roles/behaver/skills/review.behavior.test.utils.d.ts

@@ -0,0 +1,12 @@
+export declare const SKILL_PATH: string;
+export declare const FIXTURES_PATH: string;
+/**
+ * .what = finds feedback file matching pattern with timestamp
+ * .why = feedback files have dynamic timestamps in filename
+ */
+export declare const findFeedbackFile: (dir: string, pattern: string) => string | undefined;
+/**
+ * .what = creates a temp copy of fixture with real git history
+ * .why = avoids git-within-git issues by isolating in /tmp
+ */
+export declare const prepareFixtureWithGit: (fixturePath: string) => string;

package/dist/domain.roles/behaver/skills/review.behavior.test.utils.js

@@ -0,0 +1,63 @@
+"use strict";
+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.prepareFixtureWithGit = exports.findFeedbackFile = exports.FIXTURES_PATH = exports.SKILL_PATH = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+exports.SKILL_PATH = path.join(__dirname, 'review.behavior.sh');
+exports.FIXTURES_PATH = path.join(__dirname, '.test/assets/example.repo');
+/**
+ * .what = finds feedback file matching pattern with timestamp
+ * .why = feedback files have dynamic timestamps in filename
+ */
+const findFeedbackFile = (dir, pattern) => {
+    const files = fs.readdirSync(dir);
+    return files.find((f) => f.includes(pattern) && f.includes('[feedback]') && f.endsWith('.md'));
+};
+exports.findFeedbackFile = findFeedbackFile;
+/**
+ * .what = creates a temp copy of fixture with real git history
+ * .why = avoids git-within-git issues by isolating in /tmp
+ */
+const prepareFixtureWithGit = (fixturePath) => {
+    // create temp directory
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'review-behavior-'));
+    // copy fixture contents (including hidden directories like .behavior/)
+    (0, child_process_1.execSync)(`cp -a ${fixturePath}/. ${tempDir}/`);
+    // init git repo
+    (0, child_process_1.execSync)('git init', { cwd: tempDir });
+    (0, child_process_1.execSync)('git config user.email "test@test.com"', { cwd: tempDir });
+    (0, child_process_1.execSync)('git config user.name "Test"', { cwd: tempDir });
+    // commit behavior declarations on main
+    (0, child_process_1.execSync)('git add .behavior/', { cwd: tempDir });
+    (0, child_process_1.execSync)('git commit -m "initial: add behavior declarations"', {
+        cwd: tempDir,
+    });
+    return tempDir;
+};
+exports.prepareFixtureWithGit = prepareFixtureWithGit;
+//# sourceMappingURL=review.behavior.test.utils.js.map

package/dist/domain.roles/behaver/skills/review.behavior.test.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.behavior.test.utils.js","sourceRoot":"","sources":["../../../../src/domain.roles/behaver/skills/review.behavior.test.utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iDAAyC;AACzC,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAEhB,QAAA,UAAU,GAAW,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AAChE,QAAA,aAAa,GAAW,IAAI,CAAC,IAAI,CAC5C,SAAS,EACT,2BAA2B,CAC5B,CAAC;AAEF;;;GAGG;AACI,MAAM,gBAAgB,GAAG,CAC9B,GAAW,EACX,OAAe,EACK,EAAE;IACtB,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,IAAI,CACf,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC5E,CAAC;AACJ,CAAC,CAAC;AARW,QAAA,gBAAgB,oBAQ3B;AAEF;;;GAGG;AACI,MAAM,qBAAqB,GAAG,CAAC,WAAmB,EAAU,EAAE;IACnE,wBAAwB;IACxB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAE3E,uEAAuE;IACvE,IAAA,wBAAQ,EAAC,SAAS,WAAW,MAAM,OAAO,GAAG,CAAC,CAAC;IAE/C,gBAAgB;IAChB,IAAA,wBAAQ,EAAC,UAAU,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACvC,IAAA,wBAAQ,EAAC,uCAAuC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACpE,IAAA,wBAAQ,EAAC,6BAA6B,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IAE1D,uCAAuC;IACvC,IAAA,wBAAQ,EAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACjD,IAAA,wBAAQ,EAAC,oDAAoD,EAAE;QAC7D,GAAG,EAAE,OAAO;KACb,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAnBW,QAAA,qBAAqB,yBAmBhC"}

package/dist/domain.roles/behaver/skills/review.deliverable.sh

@@ -0,0 +1,344 @@
+#!/usr/bin/env bash
+######################################################################
+# .what = review deliverable against behavior declarations
+#
+# .why  = enables automated and interactive review of implementation
+#         against wish, vision, criteria, blueprint, or roadmap
+#         declarations, producing structured feedback via claude code
+#
+# .how  = 1. resolve behavior directory from --for.behavior
+#         2. resolve declaration file(s) from --against
+#         3. build prompt with declaration path(s)
+#         4. invoke claude code (interactive or non-interactive)
+#         5. feedback emits to 7.1.review.behavior.per_{targets}.[feedback].[given].by_robot.v{timestamp}.md
+#
+# usage:
+#   review.deliverable.sh --for.behavior <name> --against <target> [--interactive]
+#
+# examples:
+#   review.deliverable.sh --for.behavior get-weather-emoji --against blueprint
+#   review.deliverable.sh --for.behavior get-weather-emoji --against wish,vision,criteria
+#   review.deliverable.sh --for.behavior get-weather-emoji --against blueprint --interactive
+#
+# guarantee:
+#   - fail-fast if behavior not found or ambiguous
+#   - fail-fast if declaration file(s) missing
+#   - latest major version selected for versioned files (v3.i2 > v2.i3)
+#   - idempotent: safe to rerun
+######################################################################
+
+set -euo pipefail
+
+trap 'echo "review.deliverable.sh failed at line $LINENO"' ERR
+
+# ────────────────────────────────────────────────────────────────────
+# script location resolution
+# ────────────────────────────────────────────────────────────────────
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# resolve claude binary (prefer global, fallback to local node_modules)
+CLAUDE_BIN=""
+if command -v claude >/dev/null 2>&1; then
+  CLAUDE_BIN="claude"
+else
+  NPM_BIN_DIR="$(cd "$SCRIPT_DIR" && npm bin 2>/dev/null || echo "")"
+  if [[ -n "$NPM_BIN_DIR" && -x "$NPM_BIN_DIR/claude" ]]; then
+    CLAUDE_BIN="$NPM_BIN_DIR/claude"
+  else
+    echo "error: claude binary not found (install @anthropic-ai/claude-code or ensure claude is in PATH)"
+    exit 1
+  fi
+fi
+
+# ────────────────────────────────────────────────────────────────────
+# argument parsing
+# ────────────────────────────────────────────────────────────────────
+
+BEHAVIOR_NAME=""
+AGAINST=""
+INTERACTIVE=false
+TARGET_DIR="$PWD"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --for.behavior)
+      BEHAVIOR_NAME="$2"
+      shift 2
+      ;;
+    --against)
+      AGAINST="$2"
+      shift 2
+      ;;
+    --interactive)
+      INTERACTIVE=true
+      shift
+      ;;
+    --dir)
+      TARGET_DIR="$2"
+      shift 2
+      ;;
+    --skill|--repo|--role|-s)
+      # ignore rhachet passthrough args
+      shift 2
+      ;;
+    *)
+      echo "error: unknown argument '$1'"
+      echo "usage: review.deliverable.sh --for.behavior <name> --against <target> [--interactive]"
+      exit 1
+      ;;
+  esac
+done
+
+# validate required arguments
+if [[ -z "$BEHAVIOR_NAME" ]]; then
+  echo "error: --for.behavior is required"
+  exit 1
+fi
+if [[ -z "$AGAINST" ]]; then
+  echo "error: --against is required (wish|vision|criteria|blueprint|roadmap or comma-separated)"
+  exit 1
+fi
+
+# ────────────────────────────────────────────────────────────────────
+# behavior directory resolution
+# ────────────────────────────────────────────────────────────────────
+
+BEHAVIOR_ROOT="$TARGET_DIR/.behavior"
+if [[ ! -d "$BEHAVIOR_ROOT" ]]; then
+  echo "error: .behavior/ directory not found in $TARGET_DIR"
+  exit 1
+fi
+
+# find matching behavior directories
+MATCHES=()
+while IFS= read -r -d '' dir; do
+  MATCHES+=("$dir")
+done < <(find "$BEHAVIOR_ROOT" -maxdepth 1 -type d -name "*${BEHAVIOR_NAME}*" -print0 2>/dev/null)
+
+if [[ ${#MATCHES[@]} -eq 0 ]]; then
+  echo "error: no behavior found matching '$BEHAVIOR_NAME'"
+  echo "available behaviors:"
+  ls -1 "$BEHAVIOR_ROOT" 2>/dev/null | sed 's/^/  /'
+  exit 1
+fi
+
+if [[ ${#MATCHES[@]} -gt 1 ]]; then
+  echo "error: multiple behaviors match '$BEHAVIOR_NAME'"
+  echo "matches:"
+  printf '  %s\n' "${MATCHES[@]}"
+  echo "please provide a more specific name"
+  exit 1
+fi
+
+BEHAVIOR_DIR="${MATCHES[0]}"
+BEHAVIOR_DIR_REL=$(realpath --relative-to="$PWD" "$BEHAVIOR_DIR")
+
+# ────────────────────────────────────────────────────────────────────
+# declaration file resolution
+# ────────────────────────────────────────────────────────────────────
+
+# map target to filename pattern
+get_target_file() {
+  local target="$1"
+  local behavior_dir="$2"
+  local found
+
+  case "$target" in
+    wish|vision|criteria)
+      # find file ending in .<target>.md (e.g., *.wish.md, *.vision.md, *.criteria.md)
+      found=$(find "$behavior_dir" -maxdepth 1 -name "*.${target}.md" -print0 2>/dev/null \
+        | head -z -n1 \
+        | tr -d '\0')
+      echo "${found:-$behavior_dir/*.${target}.md}"
+      ;;
+    blueprint|roadmap)
+      # find latest major version: *.<target>.vN.iM.md
+      found=$(find "$behavior_dir" -maxdepth 1 -name "*.${target}.v*.i*.md" -print0 2>/dev/null \
+        | sort -zV -t'v' -k2 \
+        | tail -z -n1 \
+        | tr -d '\0')
+      echo "${found:-$behavior_dir/*.${target}.v*.i*.md}"
+      ;;
+    *)
+      echo ""
+      ;;
+  esac
+}
+
+# resolve all targets
+IFS=',' read -ra TARGETS <<< "$AGAINST"
+DECLARATION_FILES=()
+TARGETS_SLUG=""
+
+for target in "${TARGETS[@]}"; do
+  target=$(echo "$target" | tr -d ' ')  # trim whitespace
+  file=$(get_target_file "$target" "$BEHAVIOR_DIR")
+
+  if [[ -z "$file" ]]; then
+    echo "error: unknown target '$target'"
+    echo "valid targets: wish, vision, criteria, blueprint, roadmap"
+    exit 1
+  fi
+
+  if [[ ! -f "$file" ]]; then
+    echo "error: declaration file not found for target '$target'"
+    echo "expected: $file"
+    exit 1
+  fi
+
+  DECLARATION_FILES+=("$file")
+
+  # build slug for output filename
+  if [[ -n "$TARGETS_SLUG" ]]; then
+    TARGETS_SLUG="${TARGETS_SLUG}_${target}"
+  else
+    TARGETS_SLUG="$target"
+  fi
+done
+
+# ────────────────────────────────────────────────────────────────────
+# prompt construction
+# ────────────────────────────────────────────────────────────────────
+
+# build declaration paths for prompt (relative to TARGET_DIR where claude runs)
+DECLARATION_PATHS=""
+for file in "${DECLARATION_FILES[@]}"; do
+  rel_path=$(realpath --relative-to="$TARGET_DIR" "$file")
+  DECLARATION_PATHS="${DECLARATION_PATHS}- ${rel_path}\n"
+done
+
+# timestamp for output file and logs
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+
+# output file path (relative to TARGET_DIR where claude runs)
+OUTPUT_FILE="$BEHAVIOR_DIR/7.1.review.behavior.per_${TARGETS_SLUG}.[feedback].[given].by_robot.v${TIMESTAMP}.md"
+OUTPUT_FILE_REL=$(realpath --relative-to="$TARGET_DIR" "$OUTPUT_FILE")
+
+# feedback template path (relative to TARGET_DIR where claude runs)
+TEMPLATE_FILE="$BEHAVIOR_DIR/.ref.[feedback].v1.[given].by_human.md"
+TEMPLATE_FILE_REL=$(realpath --relative-to="$TARGET_DIR" "$TEMPLATE_FILE")
+
+# build prompt (asks claude to output review to stdout, script writes to file)
+PROMPT=$(cat <<EOF
+# review.deliverable
+
+you are reviewing the implementation deliverable against the following behavior declaration(s):
+
+$(echo -e "$DECLARATION_PATHS")
+
+## instructions
+
+1. read each declaration file listed above
+2. examine the implementation (git diff from main, staged changes, unstaged changes)
+3. compare implementation against the declared behaviors
+4. identify BLOCKERs (must fix before merge) and NITPICKs (suggestions, non-blocking)
+
+## output format
+
+output your review feedback directly to stdout (do NOT use any tools to write files).
+
+follow the template structure in:
+- $TEMPLATE_FILE_REL
+
+start your output with:
+# generated by: review.deliverable --for.behavior $BEHAVIOR_NAME --against $AGAINST
+
+then list your findings as:
+- # blocker.N = description
+- # nitpick.N = description
+
+with clear explanations for each finding.
+
+## begin review
+
+read the declaration files now and review the implementation. output review to stdout only.
+EOF
+)
+
+# ────────────────────────────────────────────────────────────────────
+# logging setup
+# ────────────────────────────────────────────────────────────────────
+
+LOG_DIR="$TARGET_DIR/.log/bhuild/review.deliverable/$TIMESTAMP"
+mkdir -p "$LOG_DIR"
+LOG_DIR_REL=$(realpath --relative-to="$PWD" "$LOG_DIR")
+
+# emit input args
+cat > "$LOG_DIR/input.args.json" <<ARGS_EOF
+{
+  "behavior_name": "$BEHAVIOR_NAME",
+  "against": "$AGAINST",
+  "interactive": $INTERACTIVE,
+  "target_dir": "$TARGET_DIR",
+  "behavior_dir": "$BEHAVIOR_DIR",
+  "output_file": "$OUTPUT_FILE"
+}
+ARGS_EOF
+
+# emit input prompt
+echo "$PROMPT" > "$LOG_DIR/input.prompt.md"
+
+# ────────────────────────────────────────────────────────────────────
+# claude code invocation
+# ────────────────────────────────────────────────────────────────────
+
+if [[ "$INTERACTIVE" == "true" ]]; then
+  echo ""
+  echo "🔭 review.deliverable (interactive)"
+  echo "├── behavior: $BEHAVIOR_DIR_REL"
+  echo "├── against: $AGAINST"
+  echo "├── prompt: $LOG_DIR_REL/input.prompt.md"
+  echo "└── output: $OUTPUT_FILE_REL"
+  echo ""
+
+  # interactive mode: open claude code shell in target dir
+  (cd "$TARGET_DIR" && "$CLAUDE_BIN" --print "$PROMPT")
+else
+  # show tree-structured status
+  echo ""
+  echo "🔭 review.deliverable"
+  echo "├── behavior: $BEHAVIOR_DIR_REL"
+  echo "├── against: $AGAINST"
+  echo "├── prompt: $LOG_DIR_REL/input.prompt.md"
+  echo "└── output: $OUTPUT_FILE_REL"
+  echo ""
+
+  # show spinner while claude runs
+  echo -n "⏳ reviewing "
+  (cd "$TARGET_DIR" && echo "$PROMPT" | "$CLAUDE_BIN" --print 2>&1) > "$LOG_DIR/output.response.md" &
+  CLAUDE_PID=$!
+
+  # spinner animation
+  SPINNER="⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
+  ELAPSED=0
+  while kill -0 $CLAUDE_PID 2>/dev/null; do
+    for (( i=0; i<${#SPINNER}; i++ )); do
+      if ! kill -0 $CLAUDE_PID 2>/dev/null; then break; fi
+      echo -ne "\r⏳ reviewing ${SPINNER:$i:1} ${ELAPSED}s"
+      sleep 0.1
+    done
+    ELAPSED=$((ELAPSED + 1))
+  done
+
+  wait $CLAUDE_PID
+  CLAUDE_EXIT=$?
+
+  # read output
+  CLAUDE_OUTPUT=$(cat "$LOG_DIR/output.response.md")
+  echo "{\"exit_code\": $CLAUDE_EXIT, \"elapsed_seconds\": $ELAPSED}" > "$LOG_DIR/output.response.json"
+
+  echo ""
+  if [[ $CLAUDE_EXIT -eq 0 ]]; then
+    # write claude's output to the feedback file
+    echo "$CLAUDE_OUTPUT" > "$OUTPUT_FILE"
+    echo ""
+    echo "✨ review complete (${ELAPSED}s)"
+    echo "└── $OUTPUT_FILE_REL"
+  else
+    echo ""
+    echo "⛈️ review failed (exit code: $CLAUDE_EXIT)"
+    echo "└── see: $LOG_DIR_REL/output.response.md"
+    exit $CLAUDE_EXIT
+  fi
+fi

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet-roles-bhuild",
   "author": "ehmpathy",
   "description": "reliable thought concept navigation roles, briefs, and skills, via rhachet",
-  "version": "0.1.3",
+  "version": "0.4.0",
   "repository": "ehmpathy/rhachet-roles-bhuild",
   "homepage": "https://github.com/ehmpathy/rhachet-roles-bhuild",
   "keywords": [
@@ -27,18 +27,17 @@
     "fix": "npm run fix:format && npm run fix:lint",
     "build:clean": "chmod -R u+w dist 2>/dev/null; rm -rf dist/",
     "build:compile": "tsc -p ./tsconfig.build.json && tsc-alias -p ./tsconfig.build.json",
-    "build:complete": "rsync -a --prune-empty-dirs --include='*/' --exclude='**/.route/**' --exclude='**/.scratch/**' --exclude='**/.behavior/**' --exclude='**/*.test.sh' --include='**/*.template.md' --include='**/briefs/**/*.md' --include='**/briefs/*.md' --include='**/skills/**/*.sh' --include='**/skills/*.sh' --include='**/skills/**/*.jsonc' --include='**/skills/*.jsonc' --exclude='*' src/ dist/",
+    "build:complete": "rsync -a --prune-empty-dirs --include='*/' --exclude='**/.route/**' --exclude='**/.scratch/**' --exclude='**/.behavior/**' --exclude='**/*.test.sh' --include='**/*.template.md' --include='**/briefs/**/*.md' --include='**/briefs/*.md' --include='**/skills/**/*.sh' --include='**/skills/*.sh' --include='**/skills/**/*.jsonc' --include='**/skills/*.jsonc' --include='**/inits/**/*.sh' --include='**/inits/*.sh' --exclude='*' src/ dist/",
     "build": "npm run build:clean && npm run build:compile && npm run build:complete --if-present",
     "test:commits": "LAST_TAG=$(git describe --tags --abbrev=0 @^ 2> /dev/null || git rev-list --max-parents=0 HEAD) && npx commitlint --from $LAST_TAG --to HEAD --verbose",
     "test:types": "tsc -p ./tsconfig.json --noEmit",
     "test:format": "npm run test:format:biome",
     "test:lint:deps": "npx depcheck -c ./.depcheckrc.yml",
-    "test:integration:hold": "jest -c ./jest.integration.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main')",
     "test:lint:biome": "biome check --diagnostic-level=error",
     "test:lint:biome:all": "biome check",
     "test:lint": "npm run test:lint:biome && npm run test:lint:deps",
     "test:unit": "jest -c ./jest.unit.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main') $([ -n $RESNAP ] && echo '--updateSnapshot')",
-    "test:integration": "echo 'todo: release'",
+    "test:integration": "jest -c ./jest.integration.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main') $([ -n $RESNAP ] && echo '--updateSnapshot')",
     "test:acceptance:locally": "npm run build && LOCALLY=true jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n $RESNAP ] && echo '--updateSnapshot')",
     "test": "npm run test:commits && npm run test:types && npm run test:format && npm run test:lint && npm run test:unit && npm run test:integration && npm run test:acceptance:locally",
     "test:acceptance": "npm run build && jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n $RESNAP ] && echo '--updateSnapshot')",
@@ -49,14 +48,17 @@
     "prepare:husky": "husky install && chmod ug+x .husky/*",
     "prepare": "if [ -e .git ] && [ -z $CI ]; then npm run prepare:husky && npm run prepare:rhachet; fi",
     "test:format:biome": "biome format",
-    "prepare:rhachet": "rhachet init && rhachet roles link --role mechanic && .agent/repo=ehmpathy/role=mechanic/skills/.skills/init.claude.sh"
+    "prepare:rhachet": "rhachet init && rhachet roles link --role mechanic && rhachet roles init --role mechanic"
   },
   "dependencies": {
     "domain-objects": "0.31.7",
     "helpful-errors": "1.5.3",
-    "rhachet": "1.15.2"
+    "rhachet": "1.15.2",
+    "rhachet-roles-bhrain": "0.3.0",
+    "test-fns": "1.7.2"
   },
   "devDependencies": {
+    "@anthropic-ai/claude-code": "2.0.76",
     "@biomejs/biome": "2.3.8",
     "@commitlint/cli": "19.5.0",
     "@commitlint/config-conventional": "19.5.0",
@@ -76,8 +78,8 @@
     "husky": "8.0.3",
     "jest": "30.2.0",
     "rhachet": "1.13.11",
-    "rhachet-roles-bhuild": "0.1.1",
-    "rhachet-roles-ehmpathy": "1.15.12",
+    "rhachet-roles-bhuild": "0.1.3",
+    "rhachet-roles-ehmpathy": "1.15.18",
     "tsc-alias": "1.8.10",
     "tsx": "4.20.6",
     "typescript": "5.4.5",

package/readme.md

@@ -39,3 +39,37 @@ Used to declare clear and testable behaviors that can be reliably built and veri
 
 Used to maximize prioritized throughput within a resource bandwidth.
 ```
+
+## skills
+
+### behaver: review.deliverable
+
+reviews an implementation deliverable against behavior declarations (wish, vision, criteria, blueprint, roadmap).
+
+```sh
+# review against a single declaration
+npx rhachet run --repo bhuild --skill review.deliverable \
+  --for.behavior get-weather-emoji \
+  --against blueprint
+
+# review against multiple declarations
+npx rhachet run --repo bhuild --skill review.deliverable \
+  --for.behavior get-weather-emoji \
+  --against wish,vision,criteria
+
+# interactive mode (opens claude code session)
+npx rhachet run --repo bhuild --skill review.deliverable \
+  --for.behavior get-weather-emoji \
+  --against blueprint \
+  --interactive
+
+# specify a different directory
+npx rhachet run --repo bhuild --skill review.deliverable \
+  --for.behavior get-weather-emoji \
+  --against blueprint \
+  --dir /path/to/project
+```
+
+output:
+- creates `.behavior/<behavior>/7.1.review.behavior.per_<targets>.[feedback].v1.[given].by_robot.v1.md`
+- logs to `.log/bhuild/review.deliverable/<timestamp>/`