@drunkcoding/agents-and-skills 0.0.24 → 0.0.26

package/plugins/team-superpower/hooks/task-created.sh

@@ -1,174 +0,0 @@
-#!/usr/bin/env bash
-# TaskCreated hook — v5 prefix + wave validation for shared task list entries.
-#
-# Accepts a JSON payload on stdin. Required field:
-#   - task.title: string
-#
-# v5 changes (delta from v4):
-#   - ADDED: impl:rework-* allowed top-level. Rework tasks dispatched by
-#     team-leader (phase-end SOLID/DRY review) or qc-engineer (end-of-plan QC)
-#     do not carry a be-/fe- prefix; their original-task id is in the
-#     `Reworks:` line of the implementer's commit body and validated by
-#     task-completed.sh.
-#   - ADDED: INVALID_WAVE_REFERENCE — v5 waves are dotted strings, not single
-#     integers. Accepted shapes: "<plan-phase>.<wave>" (e.g. "1.1", "2.3"),
-#     "<plan-phase>.rework" (e.g. "1.rework"), or "qc-rework".
-#   - REMOVED: qa-fix-be-, qa-fix-fe-, review-fix-be-, review-fix-fe- prefixes
-#     (v4 QA loop is gone). Use impl:rework-* instead.
-#   - REMOVED: bare integer wave format.
-#
-# Preserved checks:
-#   - Top-level prefix must be impl: / review: / meta: / block:.
-#   - impl:* must carry a known sub-prefix per the shape file.
-#   - solo-mode guard: impl:* invalid when checkpoint mode is solo.
-#   - Shape-marker file at docs/superpowers/sessions/<slug>.shape restricts
-#     allowed sub-prefixes (be-only / fe-only / full-stack).
-
-set -euo pipefail
-
-LOG_DIR="${CLAUDE_PROJECT_DIR:-$PWD}/.claude/hooks"
-LOG_FILE="$LOG_DIR/log.jsonl"
-SESSIONS_DIR="${CLAUDE_PROJECT_DIR:-$PWD}/docs/superpowers/sessions"
-mkdir -p "$LOG_DIR"
-
-ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-
-payload="$(cat || true)"
-
-if [ -z "$payload" ]; then
-  printf '{"ts":"%s","hook":"task-created","skipped":"empty payload"}\n' "$ts" >> "$LOG_FILE"
-  exit 0
-fi
-
-if ! command -v jq >/dev/null 2>&1; then
-  printf '{"ts":"%s","hook":"task-created","skipped":"jq not installed"}\n' "$ts" >> "$LOG_FILE"
-  exit 0
-fi
-
-title="$(printf '%s' "$payload" | jq -r '.task.title // .title // ""' 2>/dev/null || echo "")"
-slug="$(printf '%s' "$payload" | jq -r '.task.metadata.slug // .metadata.slug // ""' 2>/dev/null || echo "")"
-
-# Resolve shape from the slug's marker file. If slug is unknown but exactly
-# one .shape file exists, use it (single in-flight feature is the common case).
-shape=""
-if [ -d "$SESSIONS_DIR" ]; then
-  shape_file=""
-  if [ -n "$slug" ] && [ -f "$SESSIONS_DIR/$slug.shape" ]; then
-    shape_file="$SESSIONS_DIR/$slug.shape"
-  else
-    count="$(find "$SESSIONS_DIR" -maxdepth 1 -type f -name '*.shape' 2>/dev/null | wc -l | tr -d ' ')"
-    if [ "$count" = "1" ]; then
-      shape_file="$(find "$SESSIONS_DIR" -maxdepth 1 -type f -name '*.shape' 2>/dev/null | head -n1)"
-    fi
-  fi
-  if [ -n "$shape_file" ] && [ -f "$shape_file" ]; then
-    shape="$(head -n1 "$shape_file" | tr -d '[:space:]')"
-  fi
-fi
-
-wave="$(printf '%s' "$payload" | jq -r '.task.metadata.wave // .metadata.wave // ""' 2>/dev/null || echo "")"
-
-printf '{"ts":"%s","hook":"task-created","title":%s,"shape":%s,"wave":%s}\n' \
-  "$ts" \
-  "$(printf '%s' "$title" | jq -Rs .)" \
-  "$(printf '%s' "$shape" | jq -Rs .)" \
-  "$(printf '%s' "$wave" | jq -Rs .)" \
-  >> "$LOG_FILE"
-
-# Top-level prefix check
-case "$title" in
-  review:*|meta:*|block:*) exit 0 ;;
-  impl:*) ;;
-  "")
-    printf '{"ts":"%s","hook":"task-created","warn":"bad_prefix","reason":"title missing"}\n' "$ts" >> "$LOG_FILE"
-    exit 0
-    ;;
-  *)
-    printf '{"ts":"%s","hook":"task-created","warn":"bad_prefix","title":%s}\n' "$ts" "$(printf '%s' "$title" | jq -Rs .)" >> "$LOG_FILE"
-    exit 0
-    ;;
-esac
-
-# v3: solo-mode guard. If checkpoint mode is solo, impl:* tasks are invalid.
-mode_meta="$(printf '%s' "$payload" | jq -r '.task.metadata.mode // .metadata.mode // ""' 2>/dev/null || echo "")"
-mode_marker=""
-if [ -z "$mode_meta" ] && [ -d "$SESSIONS_DIR" ]; then
-  marker_file=""
-  if [ -n "$slug" ] && [ -f "$SESSIONS_DIR/$slug.mode" ]; then
-    marker_file="$SESSIONS_DIR/$slug.mode"
-  else
-    count="$(find "$SESSIONS_DIR" -maxdepth 1 -type f -name '*.mode' 2>/dev/null | wc -l | tr -d ' ')"
-    if [ "$count" = "1" ]; then
-      marker_file="$(find "$SESSIONS_DIR" -maxdepth 1 -type f -name '*.mode' 2>/dev/null | head -n1)"
-    fi
-  fi
-  if [ -n "$marker_file" ] && [ -f "$marker_file" ]; then
-    mode_marker="$(head -n1 "$marker_file" | tr -d '[:space:]')"
-  fi
-fi
-effective_mode="${mode_meta:-$mode_marker}"
-
-if [ "$effective_mode" = "solo" ]; then
-  printf '{"ts":"%s","hook":"task-created","warn":"INVALID_FOR_SOLO_MODE","title":%s}\n' \
-    "$ts" "$(printf '%s' "$title" | jq -Rs .)" >> "$LOG_FILE"
-fi
-
-# v5 INVALID_WAVE_REFERENCE: wave metadata is required and must match the v5 shape.
-if [ -z "$wave" ]; then
-  printf '{"ts":"%s","hook":"task-created","warn":"INVALID_WAVE_REFERENCE","title":%s,"reason":"wave metadata missing"}\n' \
-    "$ts" "$(printf '%s' "$title" | jq -Rs .)" >> "$LOG_FILE"
-elif ! printf '%s' "$wave" | grep -qE '^([0-9]+\.[0-9]+|[0-9]+\.rework|qc-rework)$'; then
-  printf '{"ts":"%s","hook":"task-created","warn":"INVALID_WAVE_REFERENCE","title":%s,"wave":%s,"reason":"unrecognised wave shape"}\n' \
-    "$ts" \
-    "$(printf '%s' "$title" | jq -Rs .)" \
-    "$(printf '%s' "$wave" | jq -Rs .)" \
-    >> "$LOG_FILE"
-fi
-
-# At this point title starts with `impl:`. Strip prefix and require a known
-# v5 sub-prefix.
-rest="${title#impl:}"
-case "$rest" in
-  rework-*)
-    # Rework tasks dispatched by team-leader (phase-end review) or qc-engineer
-    # (end-of-plan QC). The Reworks: <orig-id> line in the commit body is
-    # validated by task-completed.sh (MISSING_REWORK_REFERENCE). No shape check
-    # — rework inherits the originating task's scope.
-    sub="rework"
-    ;;
-  be-*|be-migration-*|be-contract-publish-*)
-    sub="be"
-    ;;
-  fe-*)
-    sub="fe"
-    ;;
-  contract-update-*)
-    sub="contract"
-    ;;
-  *)
-    printf '{"ts":"%s","hook":"task-created","warn":"bad_subprefix","title":%s}\n' "$ts" "$(printf '%s' "$title" | jq -Rs .)" >> "$LOG_FILE"
-    exit 0
-    ;;
-esac
-
-# Shape-aware enforcement. rework + contract-update are scope-neutral and
-# allowed under any shape — they inherit scope from the originating task or
-# from BE ownership of the contract.
-case "$shape" in
-  be-only)
-    if [ "$sub" = "fe" ]; then
-      printf '{"ts":"%s","hook":"task-created","warn":"shape_rejected","shape":"be-only","title":%s}\n' "$ts" "$(printf '%s' "$title" | jq -Rs .)" >> "$LOG_FILE"
-    fi
-    ;;
-  fe-only)
-    if [ "$sub" = "be" ]; then
-      printf '{"ts":"%s","hook":"task-created","warn":"shape_rejected","shape":"fe-only","title":%s}\n' "$ts" "$(printf '%s' "$title" | jq -Rs .)" >> "$LOG_FILE"
-    fi
-    ;;
-  full-stack|"")
-    # full-stack: anything goes. Empty shape: hook can't tell — accept and
-    # let the lead serialize/validate. Logged above for tuning.
-    ;;
-esac
-
-exit 0

package/plugins/team-superpower/hooks/teammate-idle.sh

@@ -1,149 +0,0 @@
-#!/usr/bin/env bash
-# TeammateIdle hook — v5 role-aware routing.
-#
-# Reads the hook event payload from stdin. Expected JSON fields:
-#   - mailbox: array of { from, kind, replied, ... } — recent SendMessage history
-#   - teammate: string (the idling teammate's role; one of
-#       orchestrator | team-leader | solution-architect | feature-planner |
-#       security-engineer | backend-developer | frontend-developer | qc-engineer)
-#
-# v5 behaviour: routing depends on role.
-#
-#   backend-developer / frontend-developer:
-#     - block if any unanswered message FROM team-leader (implementer owes a reply)
-#     - block if a self-sent ESCALATE has no reply within heartbeat (advisory log)
-#     - otherwise advisory: wave dispatch may still be in flight; ok to idle
-#
-#   team-leader:
-#     - block if SPAWN_REQUEST or RESTART_REQUEST has no SPAWN_DONE / RESTART_DONE
-#       reply from lead/orchestrator within heartbeat (must keep coordinating)
-#     - block if any unanswered ESCALATE from an implementer (must route)
-#     - otherwise advisory tick
-#
-#   qc-engineer:
-#     - block if QC_REWORK_NEEDED has no reply (lead must acknowledge before shutdown)
-#     - otherwise advisory tick
-#
-#   solution-architect / feature-planner / security-engineer (phase A roles):
-#     - block if owner sign-off touchpoint message has no reply yet
-#     - otherwise advisory tick (shutdown is owner-driven via lead)
-#
-#   orchestrator (lead):
-#     - block if any unanswered SPAWN_REQUEST / RESTART_REQUEST inbound from
-#       team-leader (lead is the single spawner)
-#     - otherwise advisory tick (lead drives owner touchpoints separately)
-#
-# Logs every invocation to .claude/hooks/log.jsonl in the project root for tuning.
-
-set -euo pipefail
-
-LOG_DIR="${CLAUDE_PROJECT_DIR:-$PWD}/.claude/hooks"
-LOG_FILE="$LOG_DIR/log.jsonl"
-mkdir -p "$LOG_DIR"
-
-payload="$(cat || true)"
-
-ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-
-if [ -z "$payload" ]; then
-  printf '{"ts":"%s","hook":"teammate-idle","skipped":"empty payload"}\n' "$ts" >> "$LOG_FILE"
-  exit 0
-fi
-
-if ! command -v jq >/dev/null 2>&1; then
-  printf '{"ts":"%s","hook":"teammate-idle","skipped":"jq not installed"}\n' "$ts" >> "$LOG_FILE"
-  exit 0
-fi
-
-teammate="$(printf '%s' "$payload" | jq -r '.teammate // ""' 2>/dev/null || echo "")"
-
-# Helper: count unanswered inbound messages where .from matches a pattern.
-count_unanswered_from() {
-  local from_pattern="$1"
-  printf '%s' "$payload" \
-    | jq --arg p "$from_pattern" \
-        '[.mailbox[]?
-          | select(((.from // "") | test($p)))
-          | select((.replied // false) == false)
-         ] | length' \
-        2>/dev/null \
-    || echo 0
-}
-
-# Helper: count self-sent outbound messages of a given kind with no reply yet.
-count_outbound_unanswered_kind() {
-  local kind_pattern="$1"
-  printf '%s' "$payload" \
-    | jq --arg k "$kind_pattern" \
-        '[.mailbox[]?
-          | select(((.direction // "in") == "out"))
-          | select(((.kind // "") | test($k)))
-          | select((.replied // false) == false)
-         ] | length' \
-        2>/dev/null \
-    || echo 0
-}
-
-warn=""
-
-case "$teammate" in
-  backend-developer|frontend-developer)
-    unanswered_from_leader="$(count_unanswered_from '^team-leader$')"
-    if [ "${unanswered_from_leader:-0}" -gt 0 ]; then
-      warn="BLOCKED_IDLE_implementer_owes_team-leader_reply"
-    fi
-    ;;
-  team-leader)
-    spawn_pending="$(count_outbound_unanswered_kind 'SPAWN_REQUEST|RESTART_REQUEST')"
-    escalate_pending="$(count_unanswered_from '^(backend-developer|frontend-developer)$')"
-    if [ "${spawn_pending:-0}" -gt 0 ]; then
-      warn="BLOCKED_IDLE_team-leader_awaiting_lead_on_spawn_or_restart"
-    elif [ "${escalate_pending:-0}" -gt 0 ]; then
-      warn="BLOCKED_IDLE_team-leader_owes_implementer_escalate_reply"
-    fi
-    ;;
-  qc-engineer)
-    qc_pending="$(count_outbound_unanswered_kind 'QC_REWORK_NEEDED')"
-    if [ "${qc_pending:-0}" -gt 0 ]; then
-      warn="BLOCKED_IDLE_qc-engineer_awaiting_lead_ack"
-    fi
-    ;;
-  solution-architect|feature-planner|security-engineer)
-    handover_pending="$(count_outbound_unanswered_kind 'HANDOVER_READY|SEC_PASSED|SEC_BLOCKED')"
-    if [ "${handover_pending:-0}" -gt 0 ]; then
-      warn="BLOCKED_IDLE_phaseA_awaiting_owner_signoff"
-    fi
-    ;;
-  orchestrator)
-    lead_inbound_pending="$(count_unanswered_from '^team-leader$')"
-    if [ "${lead_inbound_pending:-0}" -gt 0 ]; then
-      warn="BLOCKED_IDLE_orchestrator_unhandled_team-leader_request"
-    fi
-    ;;
-  "")
-    # Unknown role: fall back to legacy v4 behaviour (any unanswered non-lead inbound).
-    legacy_unanswered="$(printf '%s' "$payload" | jq '[.mailbox[]? | select((.from // "") != "lead") | select((.replied // false) == false)] | length' 2>/dev/null || echo 0)"
-    if [ "${legacy_unanswered:-0}" -gt 0 ]; then
-      warn="BLOCKED_IDLE_legacy_unanswered_inbound"
-    fi
-    ;;
-  *)
-    # Unknown but non-empty role — log advisory only, do not block.
-    :
-    ;;
-esac
-
-if [ -n "$warn" ]; then
-  printf '{"ts":"%s","hook":"teammate-idle","teammate":%s,"warn":%s}\n' \
-    "$ts" \
-    "$(printf '%s' "$teammate" | jq -Rs .)" \
-    "$(printf '%s' "$warn" | jq -Rs .)" \
-    >> "$LOG_FILE"
-else
-  printf '{"ts":"%s","hook":"teammate-idle","teammate":%s,"ok":true}\n' \
-    "$ts" \
-    "$(printf '%s' "$teammate" | jq -Rs .)" \
-    >> "$LOG_FILE"
-fi
-
-exit 0

package/plugins/team-superpower/scripts/assess-complexity.sh

@@ -1,194 +0,0 @@
-#!/usr/bin/env bash
-# assess-complexity.sh — encode the team-superpower v3 heuristic ladder.
-#
-# Inputs:
-#   $1 — owner's launch message (required)
-#   $2 — repo root (optional, default $PWD); reads CLAUDE.md's
-#        security.domain to bias size and stack to seed `shape:`.
-#
-# Output: YAML on stdout. Always emits `mode:`, `shape:`, `mode_reasoning:`.
-# Emits `size:` only when mode == team.
-#
-# Exit codes:
-#   0 — confident decision
-#   1 — ambiguous (mode could plausibly be single-agent OR team; defaults to
-#       team and notes the ambiguity in mode_reasoning).
-#
-# This script never spawns or writes outside stdout. The lead handles writes.
-
-set -euo pipefail
-
-if [ "${1:-}" = "" ]; then
-  echo "usage: assess-complexity.sh <launch-message> [repo-root]" >&2
-  exit 2
-fi
-
-MSG="$1"
-ROOT="${2:-$PWD}"
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-DETECT="$SCRIPT_DIR/detect-stack.sh"
-PARSE="$SCRIPT_DIR/parse-claudemd.sh"
-
-lc="$(printf '%s' "$MSG" | tr '[:upper:]' '[:lower:]')"
-length="${#MSG}"
-
-# --- Discovery / size keyword tables --------------------------------------
-
-discovery_keywords=(
-  "design" "architecture" "system" "flow" "feature" "epic" "refactor"
-  "migrate" "migrate to" "replace with" "replace" "rewrite" "redesign"
-  "overhaul"
-)
-
-trivial_keywords=(
-  "fix typo" "typo in" "rename" "rename variable" "update copy"
-  "update text" "change wording" "bump version" "update readme"
-  "comment out" "add comment" "remove unused" "format" "prettify"
-  "lint fix"
-)
-
-tiny_scope_phrases=(
-  "one line" "single line" "one file" "just change" "quick fix"
-  "tiny" "trivial"
-)
-
-small_scope_verbs=(
-  "add" "create" "new " "introduce" "fix"
-)
-
-small_scope_nouns=(
-  "endpoint" "/" "component" "field" "column" "validation"
-  "bug" "error" "test" "migration" "button" "page" "route"
-  "controller" "service"
-)
-
-regulated_keywords=(
-  "compliance" "audit" "regulatory" "pii" "pci" "gdpr" "hipaa"
-)
-
-low_stakes_keywords=(
-  "prototype" "spike" "internal-only" "experiment" "poc"
-)
-
-team_request_keywords=(
-  "team" "agents" "full feature"
-)
-
-contains_any() {
-  # contains_any <text-lc> <array-name>
-  # Compatible with Bash 3.2 (no namerefs).
-  local txt="$1"
-  local arr_name="$2"
-  eval 'local kw; for kw in "${'"$arr_name"'[@]}"; do
-    case "$txt" in *"$kw"*) return 0 ;; esac
-  done'
-  return 1
-}
-
-# Rung 1: trivial / tiny-scope / single named file
-single_file_match=0
-# Detect a single path literal in the message (very rough: looks like x/y or x.y).
-if printf '%s' "$MSG" | grep -qE '(^|[[:space:]])[A-Za-z0-9_./-]+\.[A-Za-z0-9]+([[:space:]]|$)'; then
-  # Count distinct file-ish tokens; if exactly 1, treat as named file.
-  count="$(printf '%s\n' "$MSG" | grep -oE '(^|[[:space:]])[A-Za-z0-9_./-]+\.[A-Za-z0-9]+([[:space:]]|$)' | tr -d '[:space:]' | sort -u | wc -l | tr -d ' ')"
-  if [ "$count" = "1" ]; then single_file_match=1; fi
-fi
-
-solo=0
-solo_why=""
-if contains_any "$lc" trivial_keywords; then solo=1; solo_why="trivial keyword match";
-elif contains_any "$lc" tiny_scope_phrases; then solo=1; solo_why="tiny-scope phrase match";
-elif [ "$single_file_match" = "1" ]; then solo=1; solo_why="single named file in message";
-fi
-
-# Rung 2: small-scope + single-side + no discovery language
-side="none"
-if [ -x "$DETECT" ] || [ -f "$DETECT" ]; then
-  side="$(bash "$DETECT" detect-side "$MSG" 2>/dev/null || echo none)"
-fi
-single_agent=0
-single_agent_why=""
-if [ "$solo" = "0" ]; then
-  if contains_any "$lc" small_scope_verbs \
-     && contains_any "$lc" small_scope_nouns \
-     && { [ "$side" = "be-only" ] || [ "$side" = "fe-only" ]; } \
-     && ! contains_any "$lc" discovery_keywords; then
-    single_agent=1
-    single_agent_why="small-scope verb+noun + single-side ($side) + no discovery language"
-  fi
-fi
-
-# Rung 3: team (default)
-verb_count=0
-# Cheap multi-verb heuristic: count occurrences of " and " between action words.
-verb_count="$(printf '%s' "$lc" | { grep -oE '[[:space:]]and[[:space:]]' || true; } | wc -l | tr -d ' ')"
-long_message=0
-if [ "$length" -gt 200 ]; then long_message=1; fi
-
-team=0
-team_why=""
-if [ "$solo" = "0" ] && [ "$single_agent" = "0" ]; then
-  team=1
-  if [ "$side" = "mixed" ]; then team_why="multi-side signal (BE+FE)";
-  elif contains_any "$lc" discovery_keywords; then team_why="discovery language match";
-  elif [ "$verb_count" -ge 1 ]; then team_why="multi-verb message ($verb_count 'and' joiners)";
-  elif [ "$long_message" = "1" ]; then team_why="long message (>200 chars)";
-  elif contains_any "$lc" team_request_keywords; then team_why="explicit team request";
-  else team_why="rung-1 and rung-2 did not match; defaulting to team";
-  fi
-fi
-
-# Resolve mode
-if [ "$solo" = "1" ]; then mode="solo"; reason="Rung 1 matched: $solo_why."
-elif [ "$single_agent" = "1" ]; then mode="single-agent"; reason="Rung 2 matched: $single_agent_why."
-else mode="team"; reason="Rung 3 matched: $team_why."
-fi
-
-# Size (team only)
-size=""
-size_why=""
-if [ "$mode" = "team" ]; then
-  domain=""
-  if [ -f "$ROOT/CLAUDE.md" ] && [ -f "$PARSE" ]; then
-    domain="$(bash "$PARSE" get security.domain "$ROOT/CLAUDE.md" 2>/dev/null || true)"
-  fi
-  if [ "$domain" = "payments" ] || [ "$domain" = "healthcare" ]; then
-    size="full"; size_why="security.domain=$domain"
-  elif contains_any "$lc" regulated_keywords; then
-    size="full"; size_why="regulated keyword match"
-  elif contains_any "$lc" low_stakes_keywords; then
-    size="minimal"; size_why="low-stakes keyword match"
-  else
-    size="standard"; size_why="default"
-  fi
-fi
-
-# Shape: prefer CLAUDE.md, fall back to mixed.
-shape=""
-if [ -f "$ROOT/CLAUDE.md" ] && [ -f "$PARSE" ]; then
-  shape="$(bash "$PARSE" shape "$ROOT/CLAUDE.md" 2>/dev/null || true)"
-fi
-if [ -z "$shape" ] || [ "$shape" = "none" ]; then
-  # Fall back to side detection: mixed → full-stack; be-only / fe-only as-is.
-  case "$side" in
-    mixed) shape="full-stack" ;;
-    be-only) shape="be-only" ;;
-    fe-only) shape="fe-only" ;;
-    *) shape="full-stack" ;;
-  esac
-fi
-
-# Emit
-printf 'mode: %s\n' "$mode"
-if [ "$mode" = "team" ]; then
-  printf 'size: %s\n' "$size"
-fi
-printf 'shape: %s\n' "$shape"
-printf 'mode_reasoning: |\n'
-printf '  %s\n' "$reason"
-if [ "$mode" = "team" ]; then
-  printf '  Size: %s — %s.\n' "$size" "$size_why"
-fi
-printf '  side_signal: %s; verb_joiners: %d; length: %d chars.\n' "$side" "$verb_count" "$length"
-
-exit 0