beads-orchestration 2.0.0

package/templates/hooks/validate-epic-close.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+# Hook: Validate bead close — PR must be merged, epic children must be complete
+# Prevents closing a bead whose branch has no merged PR
+# Prevents closing an epic when children are still open
+
+set -euo pipefail
+
+TOOL_INPUT="${CLAUDE_TOOL_INPUT:-}"
+
+# Only check Bash commands containing "bd close"
+if ! echo "$TOOL_INPUT" | jq -e '.command' >/dev/null 2>&1; then
+  exit 0
+fi
+
+COMMAND=$(echo "$TOOL_INPUT" | jq -r '.command // ""')
+
+# Check if this is a bd close command
+if ! echo "$COMMAND" | grep -qE 'bd\s+close'; then
+  exit 0
+fi
+
+# Allow --force override
+if echo "$COMMAND" | grep -qE '\-\-force'; then
+  exit 0
+fi
+
+# Extract the ID being closed (handles: bd close ID, bd close ID && ..., etc.)
+CLOSE_ID=$(echo "$COMMAND" | sed -E 's/.*bd\s+close\s+([A-Za-z0-9._-]+).*/\1/')
+
+if [ -z "$CLOSE_ID" ]; then
+  exit 0
+fi
+
+# === CHECK 1: PR merge validation ===
+# Only applies if repo has a remote and branch exists
+BRANCH="bd-${CLOSE_ID}"
+
+HAS_REMOTE=$(git remote get-url origin 2>/dev/null || echo "")
+if [ -n "$HAS_REMOTE" ]; then
+  REMOTE_BRANCH=$(git ls-remote --heads origin "$BRANCH" 2>/dev/null || echo "")
+
+  if [ -n "$REMOTE_BRANCH" ]; then
+    # Branch exists on remote — check for merged PR
+    if command -v gh >/dev/null 2>&1; then
+      MERGED_PR=$(gh pr list --head "$BRANCH" --state merged --json number --jq '.[0].number' 2>/dev/null || echo "")
+
+      if [ -z "$MERGED_PR" ]; then
+        cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Cannot close bead '$CLOSE_ID' — branch '$BRANCH' has no merged PR. Create and merge a PR first, or use 'bd close $CLOSE_ID --force' to override."}}
+EOF
+        exit 0
+      fi
+    fi
+  fi
+fi
+
+# === CHECK 2: Epic children validation ===
+# Check if this is an epic by looking for children
+CHILDREN=$(bd show "$CLOSE_ID" --json 2>/dev/null | jq -r '.[0].children // empty' 2>/dev/null || echo "")
+
+if [ -z "$CHILDREN" ] || [ "$CHILDREN" = "null" ]; then
+  # Not an epic or no children, allow close
+  exit 0
+fi
+
+# This is an epic - check if all children are complete
+INCOMPLETE=$(bd list --json 2>/dev/null | jq -r --arg epic "$CLOSE_ID" '
+  [.[] | select(.parent == $epic and .status != "done" and .status != "closed")] | length
+' 2>/dev/null || echo "0")
+
+if [ "$INCOMPLETE" != "0" ] && [ "$INCOMPLETE" != "" ]; then
+  # Get list of incomplete children for the error message
+  INCOMPLETE_LIST=$(bd list --json 2>/dev/null | jq -r --arg epic "$CLOSE_ID" '
+    [.[] | select(.parent == $epic and .status != "done" and .status != "closed")] | .[] | "\(.id) (\(.status))"
+  ' 2>/dev/null | tr '\n' ', ' | sed 's/,$//')
+
+  cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Cannot close epic '$CLOSE_ID' - has $INCOMPLETE incomplete children: $INCOMPLETE_LIST. Mark all children as done first."}}
+EOF
+  exit 0
+fi
+
+# All checks passed, allow close
+exit 0

package/templates/mcp.json.template

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "provider_delegator": {
+      "type": "stdio",
+      "command": "{{PROVIDER_DELEGATOR_PATH}}",
+      "args": ["-m", "mcp_provider_delegator.server"],
+      "env": {
+        "AGENT_TEMPLATES_PATH": "{{AGENT_TEMPLATES_PATH}}"
+      }
+    }
+  }
+}

package/templates/memory/recall.sh

@@ -0,0 +1,121 @@
+#!/bin/bash
+#
+# recall.sh - Search the project knowledge base
+#
+# Usage:
+#   .beads/memory/recall.sh "keyword"                  # Search by keyword
+#   .beads/memory/recall.sh "keyword" --type learned   # Filter by type
+#   .beads/memory/recall.sh --recent 10                # Show N most recent
+#   .beads/memory/recall.sh --stats                    # Knowledge base stats
+#   .beads/memory/recall.sh "keyword" --all            # Include archive
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+KNOWLEDGE_FILE="$SCRIPT_DIR/knowledge.jsonl"
+ARCHIVE_FILE="$SCRIPT_DIR/knowledge.archive.jsonl"
+
+if [[ ! -f "$KNOWLEDGE_FILE" ]] || [[ ! -s "$KNOWLEDGE_FILE" ]]; then
+  echo "No knowledge entries yet."
+  echo "Entries are created automatically from bd comment commands with INVESTIGATION: or LEARNED: prefixes."
+  exit 0
+fi
+
+# Parse arguments
+QUERY=""
+TYPE_FILTER=""
+INCLUDE_ARCHIVE=false
+SHOW_RECENT=0
+SHOW_STATS=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --type)
+      TYPE_FILTER="${2:-}"
+      shift 2
+      ;;
+    --all)
+      INCLUDE_ARCHIVE=true
+      shift
+      ;;
+    --recent)
+      SHOW_RECENT="${2:-10}"
+      shift 2
+      ;;
+    --stats)
+      SHOW_STATS=true
+      shift
+      ;;
+    --help|-h)
+      echo "Usage: recall.sh [query] [--type learned|investigation] [--all] [--recent N] [--stats]"
+      exit 0
+      ;;
+    *)
+      QUERY="$1"
+      shift
+      ;;
+  esac
+done
+
+# Stats mode
+if [[ "$SHOW_STATS" == "true" ]]; then
+  TOTAL=$(wc -l < "$KNOWLEDGE_FILE" | tr -d ' ')
+  LEARNED=$(grep -c '"type":"learned"' "$KNOWLEDGE_FILE" 2>/dev/null) || LEARNED=0
+  INVESTIGATION=$(grep -c '"type":"investigation"' "$KNOWLEDGE_FILE" 2>/dev/null) || INVESTIGATION=0
+  UNIQUE_KEYS=$(jq -r '.key' "$KNOWLEDGE_FILE" 2>/dev/null | sort -u | wc -l | tr -d ' ')
+  ARCHIVE_COUNT=0
+  [[ -f "$ARCHIVE_FILE" ]] && ARCHIVE_COUNT=$(wc -l < "$ARCHIVE_FILE" | tr -d ' ')
+
+  echo "## Knowledge Base Stats"
+  echo "  Active entries: $TOTAL"
+  echo "  Unique keys:    $UNIQUE_KEYS"
+  echo "  Learned:        $LEARNED"
+  echo "  Investigation:  $INVESTIGATION"
+  echo "  Archived:       $ARCHIVE_COUNT"
+  exit 0
+fi
+
+# Recent mode
+if [[ "$SHOW_RECENT" -gt 0 ]]; then
+  echo "## Recent Knowledge ($SHOW_RECENT entries)"
+  echo ""
+  tail -"$SHOW_RECENT" "$KNOWLEDGE_FILE" | jq -r '
+    "[\(.type | ascii_upcase | .[0:5])] \(.key)\n  \(.content | .[0:120])\n  source=\(.source) bead=\(.bead)\n"
+  ' 2>/dev/null
+  exit 0
+fi
+
+# Search mode (default)
+if [[ -z "$QUERY" ]]; then
+  echo "Usage: recall.sh <keyword> [--type learned|investigation] [--all]"
+  exit 1
+fi
+
+# Build file list
+FILES="$KNOWLEDGE_FILE"
+if [[ "$INCLUDE_ARCHIVE" == "true" && -f "$ARCHIVE_FILE" ]]; then
+  FILES="$ARCHIVE_FILE $KNOWLEDGE_FILE"
+fi
+
+# Search and deduplicate (latest entry for each key wins)
+RESULTS=$(cat $FILES | grep -i "$QUERY" 2>/dev/null || true)
+
+# Apply type filter
+if [[ -n "$TYPE_FILTER" ]]; then
+  RESULTS=$(echo "$RESULTS" | grep "\"type\":\"$TYPE_FILTER\"" 2>/dev/null || true)
+fi
+
+if [[ -z "$RESULTS" ]]; then
+  echo "No knowledge entries matching '$QUERY'"
+  [[ -n "$TYPE_FILTER" ]] && echo "  (filtered by type: $TYPE_FILTER)"
+  exit 0
+fi
+
+# Deduplicate by key (latest wins) and format output
+echo "$RESULTS" | jq -s '
+  group_by(.key) | map(max_by(.ts)) | sort_by(-.ts) | .[] |
+  "[\(.type | ascii_upcase | .[0:5])] \(.key)\n  \(.content | .[0:200])\n  source=\(.source) bead=\(.bead) tags=\(.tags | join(","))\n"
+' -r 2>/dev/null
+
+exit 0

package/templates/settings.json

@@ -0,0 +1,74 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/block-orchestrator-tools.sh"}
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/enforce-bead-for-supervisor.sh"},
+          {"type": "command", "command": ".claude/hooks/enforce-sequential-dispatch.sh"},
+          {"type": "command", "command": ".claude/hooks/remind-inprogress.sh"},
+          {"type": "command", "command": ".claude/hooks/inject-discipline-reminder.sh"}
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/enforce-branch-before-edit.sh"}
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/enforce-branch-before-edit.sh"}
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/validate-epic-close.sh"}
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Task",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/enforce-concise-response.sh"},
+          {"type": "command", "command": ".claude/hooks/log-dispatch-prompt.sh", "timeout": 10}
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/memory-capture.sh", "timeout": 10}
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/validate-completion.sh"}
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/session-start.sh"}
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/clarify-vague-request.sh"}
+        ]
+      }
+    ]
+  }
+}