@drunkcoding/agents-and-skills 0.0.18 → 0.0.23

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

@@ -0,0 +1,194 @@
+#!/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

package/plugins/team-superpower/scripts/detect-stack.sh

@@ -22,6 +22,45 @@
 
 set -euo pipefail
 
+# ---- subcommand: detect-side ---------------------------------------------
+# Usage:
+#   bash detect-stack.sh detect-side "<launch message>"
+# Outputs one of: be-only | fe-only | mixed | none
+# Used by scripts/assess-complexity.sh for the rung-2 single-side signal.
+if [ "${1:-}" = "detect-side" ]; then
+  shift
+  text="${1:-}"
+  # Normalize to lowercase for case-insensitive matching.
+  lc="$(printf '%s' "$text" | tr '[:upper:]' '[:lower:]')"
+
+  be_keywords=(
+    "endpoint" "api" "/api" "/auth" "/health" "route" "controller" "service"
+    "repository" "schema" "migration" "database" "column" "table"
+    "queue" "worker" "cron" "webhook" "grpc" "rpc"
+  )
+  fe_keywords=(
+    "component" "page" "form" "button" "modal" "input" "field"
+    "ui" "layout" "css" "tailwind" "tsx" "jsx" "react" "vue"
+    "svelte" "stylesheet" "wireframe" "design system" "screen"
+  )
+
+  has_be=0
+  has_fe=0
+  for kw in "${be_keywords[@]}"; do
+    case "$lc" in *"$kw"*) has_be=1; break ;; esac
+  done
+  for kw in "${fe_keywords[@]}"; do
+    case "$lc" in *"$kw"*) has_fe=1; break ;; esac
+  done
+
+  if [ "$has_be" -eq 1 ] && [ "$has_fe" -eq 1 ]; then echo "mixed"
+  elif [ "$has_be" -eq 1 ]; then echo "be-only"
+  elif [ "$has_fe" -eq 1 ]; then echo "fe-only"
+  else echo "none"
+  fi
+  exit 0
+fi
+
 ROOT="${1:-$PWD}"
 cd "$ROOT"
 

package/plugins/team-superpower/scripts/team-state.sh

@@ -1,25 +1,36 @@
 #!/usr/bin/env bash
-# team-state.sh — inspect and clean up team-superpower team state.
+# team-state.sh — inspect and clean up team-superpower v5 team state.
 #
 # Subcommands:
 #   scan                     List every known superpower-* team on this machine.
 #   scan <slug>              Inspect a single slug; print state for the lead/owner.
+#   members <slug>           Read team config.json and list current members + roles.
 #   cleanup <slug>           Dry-run cleanup; print what would be removed (exit 1).
-#   cleanup <slug> --force   Remove team config, task list, tmux session.
+#   cleanup <slug> --force   Remove team config, task list, .team-superpower/ artefacts.
 #
 # Flags (cleanup only):
 #   --force                  Apply the cleanup (otherwise dry-run).
 #   --ignore-heartbeat       Skip the "lead may still be alive" refusal.
 #                            Required when the heartbeat file is < 10 min old.
 #
+# v5 changes (delta from v4):
+#   - Removed: tmux session handling (Agent Teams runs in-process, not in tmux).
+#   - Added: `members` subcommand reads ~/.claude/teams/superpower-<slug>/config.json
+#     and lists current teammates + roles (single-team lifecycle visibility).
+#   - Added: cleanup now removes .team-superpower/ work artefacts (spawn-briefs,
+#     static-check logs, handover artefacts the lead created).
+#   - Added: scan shows cycle_restart_count from docs/superpowers/sessions/<slug>.cycle
+#     if present (for v5's restart-on-stuck telemetry).
+#
 # What this script preserves (always):
-#   - docs/superpowers/{specs,plans,reviews}      durable artefacts
-#   - the project-side checkpoint markdown        kept; appended with a Cleanup record
+#   - docs/superpowers/{specs,plans,reviews,handovers}   durable artefacts
+#   - the project-side checkpoint markdown               kept; appended with a Cleanup record
 #
 # What it removes (with --force):
-#   - ~/.claude/teams/superpower-<slug>/          team config
-#   - ~/.claude/tasks/superpower-<slug>/          shared task list
-#   - tmux session "claude-superpower-<slug>"     best-effort
+#   - ~/.claude/teams/superpower-<slug>/                team config
+#   - ~/.claude/tasks/superpower-<slug>/                shared task list
+#   - .team-superpower/spawn-briefs/                    wave brief files
+#   - .team-superpower/static-check-*.log               per-task static-check logs
 #
 # Idempotent: re-running is safe.
 #
@@ -37,6 +48,7 @@ TEAMS_DIR="$CLAUDE_HOME/teams"
 TASKS_DIR="$CLAUDE_HOME/tasks"
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
 SESSIONS_DIR="$PROJECT_DIR/docs/superpowers/sessions"
+ARTEFACTS_DIR="$PROJECT_DIR/.team-superpower"
 HEARTBEAT_TTL_SECONDS=600  # 10 min
 
 print_usage() {
@@ -44,13 +56,17 @@ print_usage() {
 }
 
 team_name_for_slug() { printf 'superpower-%s' "$1"; }
-tmux_name_for_slug() { printf 'claude-superpower-%s' "$1"; }
 
 heartbeat_file_for_slug() {
   local slug="$1"
   printf '%s/%s.heartbeat' "$SESSIONS_DIR" "$slug"
 }
 
+cycle_file_for_slug() {
+  local slug="$1"
+  printf '%s/%s.cycle' "$SESSIONS_DIR" "$slug"
+}
+
 checkpoint_for_slug() {
   local slug="$1"
   if [ ! -d "$SESSIONS_DIR" ]; then return; fi
@@ -87,9 +103,7 @@ cmd_scan() {
     echo "team-superpower teams on this machine:"
     while IFS= read -r s; do
       [ -z "$s" ] && continue
-      local team team_dir hb age
-      team="$(team_name_for_slug "$s")"
-      team_dir="$TEAMS_DIR/$team"
+      local hb age
       hb="$(heartbeat_file_for_slug "$s")"
       age="$(heartbeat_age_seconds "$hb")"
       if [ "$age" -lt 0 ]; then
@@ -101,39 +115,73 @@ cmd_scan() {
     return 0
   fi
 
-  local team team_dir task_dir hb age ckpt tmux_name
+  local team team_dir task_dir hb age ckpt cycle_file restart_count
   team="$(team_name_for_slug "$slug")"
   team_dir="$TEAMS_DIR/$team"
   task_dir="$TASKS_DIR/$team"
   hb="$(heartbeat_file_for_slug "$slug")"
   age="$(heartbeat_age_seconds "$hb")"
   ckpt="$(checkpoint_for_slug "$slug")"
-  tmux_name="$(tmux_name_for_slug "$slug")"
-
-  printf 'slug:              %s\n' "$slug"
-  printf 'team_name:         %s\n' "$team"
-  printf 'team_config:       %s\n' "$team_dir"
-  if [ -d "$team_dir" ]; then printf 'team_config_state: present\n'; else printf 'team_config_state: absent\n'; fi
-  printf 'task_list:         %s\n' "$task_dir"
-  if [ -d "$task_dir" ]; then printf 'task_list_state:   present\n'; else printf 'task_list_state:   absent\n'; fi
-  printf 'checkpoint:        %s\n' "${ckpt:-<none>}"
+  cycle_file="$(cycle_file_for_slug "$slug")"
+  restart_count=0
+  if [ -f "$cycle_file" ]; then
+    restart_count="$(head -n1 "$cycle_file" | tr -d '[:space:]')"
+  fi
+
+  printf 'slug:                  %s\n' "$slug"
+  printf 'team_name:             %s\n' "$team"
+  printf 'team_config:           %s\n' "$team_dir"
+  if [ -d "$team_dir" ]; then printf 'team_config_state:     present\n'; else printf 'team_config_state:     absent\n'; fi
+  printf 'task_list:             %s\n' "$task_dir"
+  if [ -d "$task_dir" ]; then printf 'task_list_state:       present\n'; else printf 'task_list_state:       absent\n'; fi
+  printf 'checkpoint:            %s\n' "${ckpt:-<none>}"
+  printf 'cycle_restart_count:   %s\n' "${restart_count:-0}"
   if [ "$age" -lt 0 ]; then
-    printf 'heartbeat:         <none>\n'
-    printf 'liveness:          unknown (no heartbeat — treat as stale)\n'
+    printf 'heartbeat:             <none>\n'
+    printf 'liveness:              unknown (no heartbeat — treat as stale)\n'
   else
-    printf 'heartbeat:         %s (%ds ago)\n' "$hb" "$age"
+    printf 'heartbeat:             %s (%ds ago)\n' "$hb" "$age"
     if [ "$age" -lt "$HEARTBEAT_TTL_SECONDS" ]; then
-      printf 'liveness:          LIKELY ALIVE (heartbeat < %ds)\n' "$HEARTBEAT_TTL_SECONDS"
+      printf 'liveness:              LIKELY ALIVE (heartbeat < %ds)\n' "$HEARTBEAT_TTL_SECONDS"
     else
-      printf 'liveness:          stale\n'
+      printf 'liveness:              stale\n'
     fi
   fi
-  printf 'tmux_session:      %s\n' "$tmux_name"
-  if command -v tmux >/dev/null 2>&1 && tmux has-session -t "$tmux_name" 2>/dev/null; then
-    printf 'tmux_state:        present\n'
+  if [ -d "$ARTEFACTS_DIR" ]; then
+    local brief_count log_count
+    brief_count="$(find "$ARTEFACTS_DIR/spawn-briefs" -maxdepth 1 -type f -name '*.md' 2>/dev/null | wc -l | tr -d ' ')"
+    log_count="$(find "$ARTEFACTS_DIR" -maxdepth 1 -type f -name 'static-check-*.log' 2>/dev/null | wc -l | tr -d ' ')"
+    printf 'spawn_briefs:          %s file(s)\n' "${brief_count:-0}"
+    printf 'static_check_logs:     %s file(s)\n' "${log_count:-0}"
   else
-    printf 'tmux_state:        absent\n'
+    printf 'artefacts_dir:         absent\n'
+  fi
+}
+
+cmd_members() {
+  local slug="${1:-}"
+  if [ -z "$slug" ]; then
+    echo "usage: team-state.sh members <slug>" >&2
+    return 2
+  fi
+  local team team_dir config
+  team="$(team_name_for_slug "$slug")"
+  team_dir="$TEAMS_DIR/$team"
+  config="$team_dir/config.json"
+  if [ ! -f "$config" ]; then
+    echo "team config not found: $config" >&2
+    return 4
   fi
+  if ! command -v jq >/dev/null 2>&1; then
+    echo "jq not installed; raw config follows:" >&2
+    cat "$config"
+    return 0
+  fi
+  printf 'team:    %s\n' "$team"
+  printf 'config:  %s\n' "$config"
+  printf 'members:\n'
+  jq -r '.members[]? | "  - " + (.role // "<no-role>") + "  (id: " + (.id // "<no-id>") + ", status: " + (.status // "unknown") + ")"' "$config" 2>/dev/null \
+    || jq -r '. | tostring' "$config"
 }
 
 cmd_cleanup() {
@@ -153,21 +201,27 @@ cmd_cleanup() {
     return 2
   fi
 
-  local team team_dir task_dir hb age ckpt tmux_name
+  local team team_dir task_dir hb age ckpt
   team="$(team_name_for_slug "$slug")"
   team_dir="$TEAMS_DIR/$team"
   task_dir="$TASKS_DIR/$team"
   hb="$(heartbeat_file_for_slug "$slug")"
   age="$(heartbeat_age_seconds "$hb")"
   ckpt="$(checkpoint_for_slug "$slug")"
-  tmux_name="$(tmux_name_for_slug "$slug")"
 
   # Build the work list.
   local items=()
   [ -d "$team_dir" ] && items+=("team_config:$team_dir")
   [ -d "$task_dir" ] && items+=("task_list:$task_dir")
-  if command -v tmux >/dev/null 2>&1 && tmux has-session -t "$tmux_name" 2>/dev/null; then
-    items+=("tmux_session:$tmux_name")
+  if [ -d "$ARTEFACTS_DIR/spawn-briefs" ]; then
+    local n
+    n="$(find "$ARTEFACTS_DIR/spawn-briefs" -maxdepth 1 -type f -name '*.md' 2>/dev/null | wc -l | tr -d ' ')"
+    [ "${n:-0}" -gt 0 ] && items+=("spawn_briefs:$ARTEFACTS_DIR/spawn-briefs (${n} files)")
+  fi
+  if [ -d "$ARTEFACTS_DIR" ]; then
+    local n
+    n="$(find "$ARTEFACTS_DIR" -maxdepth 1 -type f -name 'static-check-*.log' 2>/dev/null | wc -l | tr -d ' ')"
+    [ "${n:-0}" -gt 0 ] && items+=("static_check_logs:$ARTEFACTS_DIR/static-check-*.log (${n} files)")
   fi
 
   if [ ${#items[@]} -eq 0 ]; then
@@ -202,10 +256,24 @@ cmd_cleanup() {
     echo "removed: $task_dir"
     removed=$((removed+1))
   fi
-  if command -v tmux >/dev/null 2>&1 && tmux has-session -t "$tmux_name" 2>/dev/null; then
-    tmux kill-session -t "$tmux_name" && echo "killed tmux session: $tmux_name"
+  if [ -d "$ARTEFACTS_DIR/spawn-briefs" ]; then
+    rm -rf -- "$ARTEFACTS_DIR/spawn-briefs"
+    echo "removed: $ARTEFACTS_DIR/spawn-briefs"
     removed=$((removed+1))
   fi
+  if [ -d "$ARTEFACTS_DIR" ]; then
+    local cleared
+    cleared="$(find "$ARTEFACTS_DIR" -maxdepth 1 -type f -name 'static-check-*.log' 2>/dev/null | wc -l | tr -d ' ')"
+    if [ "${cleared:-0}" -gt 0 ]; then
+      find "$ARTEFACTS_DIR" -maxdepth 1 -type f -name 'static-check-*.log' -delete 2>/dev/null || true
+      echo "removed: ${cleared} static-check log(s) under $ARTEFACTS_DIR"
+      removed=$((removed+1))
+    fi
+    # If .team-superpower/ is now empty, drop it too.
+    if [ -z "$(ls -A "$ARTEFACTS_DIR" 2>/dev/null)" ]; then
+      rmdir "$ARTEFACTS_DIR" 2>/dev/null || true
+    fi
+  fi
   # Heartbeat is informational; remove it so future scans don't see a stale "alive" signal.
   if [ -f "$hb" ]; then
     rm -f -- "$hb"
@@ -219,7 +287,7 @@ cmd_cleanup() {
       {
         printf '\n## Cleanup\n'
         printf -- '- cleaned at: %s\n' "$ts"
-        printf -- '- removed: %d resource(s) (team_config, task_list, tmux_session as applicable)\n' "$removed"
+        printf -- '- removed: %d resource(s) (team_config, task_list, spawn_briefs, static_check_logs as applicable)\n' "$removed"
         printf -- '- status: cleaned\n'
       } >> "$ckpt"
       echo "appended cleanup record to: $ckpt"
@@ -235,6 +303,7 @@ main() {
   shift || true
   case "$sub" in
     scan)    cmd_scan "$@" ;;
+    members) cmd_members "$@" ;;
     cleanup) cmd_cleanup "$@" ;;
     -h|--help|help|"") print_usage; [ -z "$sub" ] && return 2 || return 0 ;;
     *) echo "unknown subcommand: $sub" >&2; print_usage; return 2 ;;

package/plugins/team-superpower/scripts/wave-collision-check.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# wave-collision-check.sh — detect file-scope collisions inside a wave.
+#
+# Input (stdin): one task per line, space-separated:
+#   <task-id> <file1> [<file2> ...]
+# Files are normalized (lowercase, leading ./ stripped, slashes preserved).
+#
+# Exit codes:
+#   0 — no collision
+#   1 — at least one pair of tasks share a normalized file
+#
+# Stdout on collision: one line per colliding pair:
+#   COLLISION <task-i> <task-j> <file>
+
+set -euo pipefail
+
+normalize() {
+  # lowercase + strip leading ./
+  printf '%s' "$1" | tr '[:upper:]' '[:lower:]' | sed -E 's|^\./||'
+}
+
+tasks=()
+files_list=()
+
+while IFS= read -r line || [ -n "$line" ]; do
+  [ -z "$line" ] && continue
+  # shellcheck disable=SC2206
+  parts=($line)
+  task="${parts[0]}"
+  files=()
+  for ((i=1; i<${#parts[@]}; i++)); do
+    files+=("$(normalize "${parts[$i]}")")
+  done
+  tasks+=("$task")
+  files_list+=("${files[*]}")
+done
+
+collisions=0
+n=${#tasks[@]}
+for ((i=0; i<n; i++)); do
+  for ((j=i+1; j<n; j++)); do
+    # shellcheck disable=SC2206
+    fi=(${files_list[$i]})
+    # shellcheck disable=SC2206
+    fj=(${files_list[$j]})
+    for f1 in "${fi[@]}"; do
+      [ -z "$f1" ] && continue
+      for f2 in "${fj[@]}"; do
+        [ -z "$f2" ] && continue
+        if [ "$f1" = "$f2" ]; then
+          printf 'COLLISION %s %s %s\n' "${tasks[$i]}" "${tasks[$j]}" "$f1"
+          collisions=$((collisions+1))
+        fi
+      done
+    done
+  done
+done
+
+if [ "$collisions" -gt 0 ]; then exit 1; fi
+exit 0

package/plugins/tech-graph/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tech-graph",
-  "version": "0.0.18",
+  "version": "0.0.23",
   "description": "Step-by-step wizard for generating technical diagrams as SVG+PNG.",
   "author": {
     "name": "steven"

package/plugins/html-effectiveness/tests/_tmp.test.js

@@ -1,58 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { existsSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { getTmpDir, cleanup, withTmp, ROOT } from '../scripts/_tmp.js';
-
-test('getTmpDir creates a fresh dir under .tmp/html-effectiveness/', () => {
-  const dir = getTmpDir('unit-a');
-  assert.ok(dir.endsWith('/.tmp/html-effectiveness/unit-a'));
-  assert.ok(existsSync(dir));
-  cleanup('unit-a');
-});
-
-test('getTmpDir wipes existing dir contents', () => {
-  const dir = getTmpDir('unit-b');
-  writeFileSync(join(dir, 'old.txt'), 'stale');
-  const dir2 = getTmpDir('unit-b');
-  assert.equal(dir, dir2);
-  assert.equal(existsSync(join(dir2, 'old.txt')), false);
-  cleanup('unit-b');
-});
-
-test('cleanup removes dir', () => {
-  const dir = getTmpDir('unit-c');
-  cleanup('unit-c');
-  assert.equal(existsSync(dir), false);
-});
-
-test('cleanup is idempotent on missing dir', () => {
-  cleanup('unit-never-created');
-  assert.ok(true);
-});
-
-test('withTmp runs callback and cleans up on success', () => {
-  let observed;
-  const result = withTmp('unit-d', (dir) => {
-    observed = dir;
-    writeFileSync(join(dir, 'x'), 'y');
-    return 'done';
-  });
-  assert.equal(result, 'done');
-  assert.equal(existsSync(observed), false);
-});
-
-test('withTmp cleans up even when callback throws', () => {
-  let observed;
-  assert.throws(() => {
-    withTmp('unit-e', (dir) => {
-      observed = dir;
-      throw new Error('boom');
-    });
-  }, /boom/);
-  assert.equal(existsSync(observed), false);
-});
-
-test('ROOT is anchored at repo .tmp/html-effectiveness', () => {
-  assert.ok(ROOT.endsWith('/.tmp/html-effectiveness'));
-});

package/plugins/html-effectiveness/tests/fixtures/01-exploration-code-approaches.data.json

@@ -1,3 +0,0 @@
-{
-  "title": "Code-Approaches Exploration"
-}

package/plugins/html-effectiveness/tests/fixtures/02-exploration-visual-designs.data.json

@@ -1,3 +0,0 @@
-{
-  "title": "Visual Design Exploration"
-}

package/plugins/html-effectiveness/tests/fixtures/03-code-review-pr.data.json

@@ -1,3 +0,0 @@
-{
-  "title": "PR Code Review Board"
-}

package/plugins/html-effectiveness/tests/fixtures/04-code-understanding.data.json

@@ -1,3 +0,0 @@
-{
-  "title": "Code Walkthrough"
-}

package/plugins/html-effectiveness/tests/fixtures/05-design-system.data.json

@@ -1,3 +0,0 @@
-{
-  "title": "Design System Sheet"
-}

package/plugins/html-effectiveness/tests/fixtures/06-component-variants.data.json

@@ -1,3 +0,0 @@
-{
-  "title": "Component Variant Matrix"
-}

package/plugins/html-effectiveness/tests/fixtures/07-prototype-animation.data.json

@@ -1,3 +0,0 @@
-{
-  "title": "Animation Prototype"
-}

package/plugins/html-effectiveness/tests/fixtures/08-prototype-interaction.data.json

@@ -1,3 +0,0 @@
-{
-  "title": "Interaction Prototype"
-}

package/plugins/html-effectiveness/tests/fixtures/09-slide-deck.data.json

@@ -1,3 +0,0 @@
-{
-  "title": "Slide Deck"
-}

package/plugins/html-effectiveness/tests/fixtures/10-svg-illustrations.data.json

@@ -1,3 +0,0 @@
-{
-  "title": "SVG Illustration Gallery"
-}