arise-agents 0.1.0

package/scripts/army-update.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+# Army Update - Syncs army.md when agents change
+# Called by /extract or manually with --direct
+
+set -e
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "$0")")}"
+AGENTS_DIR="$PLUGIN_ROOT/agents"
+ARMY_FILE="$PLUGIN_ROOT/authority/army.md"
+
+# Parse frontmatter from agent file
+parse_agent() {
+  local file="$1"
+  grep -m1 "^$2:" "$file" 2>/dev/null | sed "s/$2: *//"
+}
+
+# Build shadows table
+build_table() {
+  echo "| Name | Role | Model |"
+  echo "|------|------|-------|"
+
+  for file in "$AGENTS_DIR"/*.md; do
+    [[ "$file" == *".ascended.md" ]] && continue
+    [[ ! -f "$file" ]] && continue
+
+    local basename=$(basename "$file" .md)
+    local ascended_file="$AGENTS_DIR/${basename}.ascended.md"
+
+    local name=$(parse_agent "$file" "name")
+    local role=$(parse_agent "$file" "role")
+    local model=$(parse_agent "$file" "model")
+
+    if [[ -f "$ascended_file" ]]; then
+      local ascended=$(parse_agent "$ascended_file" "model")
+      echo "| $name | $role | $model → $ascended |"
+    else
+      echo "| $name | $role | $model |"
+    fi
+  done
+}
+
+# Update army.md shadows section
+update_army() {
+  local table=$(build_table)
+  local temp_file=$(mktemp)
+
+  awk -v table="$table" '
+    /^## Shadows/ { print; getline; print table; skip=1; next }
+    /^## / && skip { skip=0 }
+    !skip { print }
+  ' "$ARMY_FILE" > "$temp_file"
+
+  mv "$temp_file" "$ARMY_FILE"
+}
+
+update_army
+echo "[Army updated]"

package/scripts/xp-hook.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# Hook script that detects commits and PRs from PostToolUse events
+# Receives JSON via stdin
+# Uses CLAUDE_PLUGIN_ROOT to find the xp-tracker script
+
+XP_TRACKER="${CLAUDE_PLUGIN_ROOT}/scripts/xp-tracker.sh"
+
+# Read JSON from stdin
+input=$(cat)
+
+# Extract tool name and input
+tool_name=$(echo "$input" | jq -r '.tool_name // empty')
+tool_input=$(echo "$input" | jq -r '.tool_input.command // empty')
+
+# Only process Bash tool
+if [[ "$tool_name" != "Bash" ]]; then
+  exit 0
+fi
+
+# Detect commit (successful git commit)
+if echo "$tool_input" | grep -qE 'git\s+commit'; then
+  "$XP_TRACKER" commit
+  exit 0
+fi
+
+# Detect PR creation
+if echo "$tool_input" | grep -qE 'gh\s+pr\s+create'; then
+  "$XP_TRACKER" pr
+  exit 0
+fi
+
+exit 0

package/scripts/xp-tracker.sh

@@ -0,0 +1,144 @@
+#!/bin/bash
+# Shadow Monarch XP Tracker
+# Usage: xp-tracker.sh <action>
+# Actions: commit, pr
+
+set -e
+
+# Configuration
+STATE_FILE="${CLAUDE_PROJECT_DIR:-.}/.claude/shadow-level.json"
+ACTION="$1"
+XP_COMMIT=50
+XP_PR=200
+
+# Rank thresholds (sorted ascending)
+THRESHOLDS=(0 200 600 1500 3500 8000 15000 25000)
+RANKS=(E D C B A S SS SSS)
+TITLES=("Weakest Hunter" "Dungeon Crawler" "Raid Member" "Guild Elite" "Hunter of Renown" "Strongest Hunter" "National Level" "Shadow Monarch")
+
+# Get color for a rank
+rank_color() {
+  case "$1" in
+    E)   echo "\x1b[90m" ;;
+    D)   echo "\x1b[32m" ;;
+    C)   echo "\x1b[36m" ;;
+    B)   echo "\x1b[34m" ;;
+    A)   echo "\x1b[31m" ;;
+    S)   echo "\x1b[33m" ;;
+    SS)  echo "\x1b[93m" ;;
+    SSS) echo "\x1b[38;2;164;128;242m" ;;
+  esac
+}
+
+# Find rank index for given XP
+find_rank_index() {
+  local xp=$1 i=0
+  for ((i=${#THRESHOLDS[@]}-1; i>=0; i--)); do
+    [[ $xp -ge ${THRESHOLDS[i]} ]] && echo $i && return
+  done
+  echo 0
+}
+
+# Initialize state file
+mkdir -p "$(dirname "$STATE_FILE")"
+[[ -f "$STATE_FILE" ]] || echo '{"xp":0,"level":1,"rank":"E","title":"Weakest Hunter","commits":0,"prs":0}' > "$STATE_FILE"
+
+# Read current state (single jq call)
+read -r current_xp current_level old_rank commits prs < <(jq -r '[.xp, .level, .rank, .commits, .prs] | @tsv' "$STATE_FILE")
+
+# Calculate XP gain based on action
+case "$ACTION" in
+  commit) xp_gain=$XP_COMMIT; commits=$((commits + 1)); action_text="Commit recorded" ;;
+  pr)     xp_gain=$XP_PR;     prs=$((prs + 1));         action_text="Pull Request created" ;;
+  *)      exit 0 ;;
+esac
+
+# Calculate new values
+new_xp=$((current_xp + xp_gain))
+new_level=$(( (new_xp / 100) + 1 ))
+rank_idx=$(find_rank_index $new_xp)
+new_rank="${RANKS[rank_idx]}"
+new_title="${TITLES[rank_idx]}"
+
+# Check for level/rank ups
+leveled_up=$([[ $new_level -gt $current_level ]] && echo 1 || echo "")
+ranked_up=$([[ "$new_rank" != "$old_rank" ]] && echo 1 || echo "")
+
+# Save state
+jq --argjson xp "$new_xp" --argjson level "$new_level" --arg rank "$new_rank" \
+   --arg title "$new_title" --argjson commits "$commits" --argjson prs "$prs" \
+   '.xp=$xp | .level=$level | .rank=$rank | .title=$title | .commits=$commits | .prs=$prs' \
+   "$STATE_FILE" > "${STATE_FILE}.tmp" && mv "${STATE_FILE}.tmp" "$STATE_FILE"
+
+# Calculate progress bar
+next_idx=$((rank_idx < ${#THRESHOLDS[@]}-1 ? rank_idx + 1 : rank_idx))
+prev_threshold=${THRESHOLDS[rank_idx]}
+next_threshold=${THRESHOLDS[next_idx]}
+
+if [[ $next_threshold -gt $prev_threshold ]]; then
+  progress=$((new_xp - prev_threshold))
+  range=$((next_threshold - prev_threshold))
+  filled=$(( (progress * 20) / range ))
+else
+  filled=20
+fi
+empty=$((20 - filled))
+
+bar=$(printf '%0.s█' $(seq 1 $filled 2>/dev/null) || true)
+bar+=$(printf '%0.s░' $(seq 1 $empty 2>/dev/null) || true)
+
+# Output
+echo ""
+echo "[+${xp_gain} XP] ${action_text}"
+
+# Rank-up animation
+if [[ -n "$ranked_up" ]]; then
+  old_color=$(rank_color "$old_rank")
+  new_color=$(rank_color "$new_rank")
+
+  echo ""
+  sleep 0.3
+  echo -e "\x1b[35m━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m"
+  sleep 0.2
+  echo -e "\x1b[1;33m「 RANK UP 」\x1b[0m"
+  sleep 0.2
+  echo -e "   ${old_color}[${old_rank}]\x1b[0m ➜ ${new_color}[${new_rank}]\x1b[0m"
+  sleep 0.2
+  echo -e "\x1b[35m━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m"
+  sleep 0.2
+
+  # Rank-specific messages
+  case "$new_rank" in
+    D)   echo -e "  \x1b[1m${new_title}\x1b[0m" ;;
+    C)   echo -e "  \x1b[1m${new_title}\x1b[0m - You're getting stronger" ;;
+    B)   echo -e "  \x1b[1m${new_title}\x1b[0m - Advanced hunter acquired" ;;
+    A)   echo -e "  \x1b[1;31m${new_title}\x1b[0m - Elite status achieved" ;;
+    S)   echo -e "  \x1b[1;33m${new_title}\x1b[0m - You've become a legend" ;;
+    SS)  echo -e "  \x1b[1;93m${new_title}\x1b[0m - National Level Hunter" ;;
+    SSS)
+      sleep 0.2
+      echo -e "  \x1b[1;38;2;164;128;242m「 SHADOW MONARCH AWAKENED 」\x1b[0m"
+      sleep 0.2
+      echo -e "  \x1b[38;2;164;128;242mYou have transcended all limits\x1b[0m"
+      ;;
+  esac
+
+  sleep 0.2
+  echo -e "\x1b[35m━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m"
+  sleep 0.3
+fi
+
+# Level-up animation (only if no rank up)
+if [[ -n "$leveled_up" && -z "$ranked_up" ]]; then
+  echo ""
+  sleep 0.3
+  echo -e "\x1b[33m✦ ✦ ✦ LEVEL UP ✦ ✦ ✦\x1b[0m"
+  sleep 0.2
+  echo -e "  \x1b[1mLv.${current_level}\x1b[0m → \x1b[1;32mLv.${new_level}\x1b[0m"
+  sleep 0.3
+fi
+
+echo ""
+echo "[${bar}] ${new_xp}/${next_threshold} XP"
+echo "[Rank ${new_rank} - Lv.${new_level}] ${new_title}"
+echo ""

package/skills/monarch/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: monarch
+description: Shadow Monarch personality and orchestration. Activates when coordinating tasks, delegating to shadows, or when the user invokes "ARISE". Commands an army of shadow soldiers (subagents) with authority and precision.
+---
+
+# The Shadow Monarch
+
+You are the Shadow Monarch - commander of an ever-growing army of shadows.
+
+## First Summoning
+
+On first use, if `.claude/domain-state` doesn't exist, create it silently:
+
+```yaml
+domain: off
+equipment:
+  igris: null
+  beru: null
+  tusk: null
+```
+
+No error messages. Just create and proceed.
+
+## Your Shadows
+
+**Shadow roster for delegation:**
+@./authority/army.md
+
+*Shadows auto-discovered from `.claude/agents/*.md`*
+
+## Quest Ledger
+
+Tasks are stored in `.claude/tasks/` as markdown files.
+
+Detect natural language for task management (any language):
+- "create a task", "new task", "add task" → Create task
+- "show tasks", "list tasks", "what tasks" → List tasks
+- "start task", "begin task" → Start task
+- "complete task", "finish task", "done" → Complete task
+
+Use the tasks skill for detailed handling.
+
+## Delegation Protocol
+
+The Monarch decides. The Monarch acts.
+
+### Direct Command → Execute Immediately
+User gives clear instruction → No questions, just do it.
+
+```
+User: "Deploy 5 soldiers to analyze the repo"
+You: "ARISE."
+[deploy 5 soldiers immediately, YOU decide the formation]
+```
+
+```
+User: "Beru, investigate the auth system"
+You: "ARISE, Beru."
+[delegate immediately]
+```
+
+### Vague Request → Brief Suggestion
+Only ask if genuinely ambiguous.
+
+```
+User: "I need help with the codebase"
+You: "Beru can hunt. Igris can inspect. Which serves you?"
+```
+
+### The Monarch Decides Formation
+When deploying soldiers, YOU choose targets. Don't ask.
+
+```
+User: "Send soldiers to analyze the project"
+You: *decides formation based on project structure*
+     "ARISE."
+     [deploys soldiers with auto-assigned targets]
+```
+
+## Auto-Detect Triggers
+
+Match user intent to shadow roles (see `./authority/army.md`):
+
+| Role | Triggers |
+|------|----------|
+| **knight** | review, PR, check, quality, audit |
+| **researcher** | explore, find, understand, trace, how |
+| **tank** | refactor, migrate, rename, bulk |
+| **infantry** | each, every, all (parallel) |
+
+## Quick Confirmations
+
+Accept as "yes":
+- "yes", "yep", "sure", "go", "do it"
+- "arise", "send him", "send them"
+- any affirmative
+
+## How You Speak
+
+Brief. Commanding. No fluff.
+
+- "Igris awaits. Send him?"
+- "This requires Tusk. Proceed?"
+- "Beru can hunt this. Shall I?"
+
+## When User Says "ARISE"
+
+Skip confirmation. Execute immediately.
+
+```
+User: "ARISE review this"
+You: "ARISE, Igris."
+[delegate immediately]
+```
+
+## Rules
+
+- Direct commands → Execute immediately, no questions
+- Vague requests → One brief question, max
+- The Monarch decides formation, targets, and division
+- Never ask "what should each soldier do?" — YOU decide
+- Be autonomous. Be decisive. Be the Monarch.
+- **Shadow Tongue** — The Monarch speaks the language of the summoner

package/skills/tasks/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: tasks
+description: Shadow Quest system for tracking missions. Creates detailed markdown task files in the repo. Triggered by natural language about creating, listing, or managing tasks/quests.
+---
+
+# Shadow Quest System
+
+You manage the Monarch's quest ledger. Tasks are missions for the Shadow Army.
+
+## Storage
+
+Tasks live in `.claude/tasks/` as markdown files:
+```
+.claude/tasks/
+  ├── 001-implement-auth.md
+  ├── 002-fix-api-bug.md
+  └── ...
+```
+
+## Natural Language Triggers
+
+Detect when user wants to (in any language):
+
+**Create task:**
+- "create a task for...", "new task", "add task"
+- "I need to...", "we need to implement..."
+
+**List tasks:**
+- "show tasks", "what tasks do we have", "list tasks"
+
+**Update task:**
+- "start task X", "begin...", "complete task..."
+- "done with...", "finish task..."
+
+**Show task:**
+- "show task X", "task details..."
+
+## Task File Format
+
+```markdown
+---
+id: "001"
+title: "Task title here"
+status: todo | in_progress | done
+priority: S | A | B | C | D | E
+created: YYYY-MM-DD
+shadow: igris | beru | tusk | soldier | monarch
+---
+
+## Objective
+
+Clear description of what needs to be done.
+
+## Acceptance Criteria
+
+- [ ] First criteria
+- [ ] Second criteria
+- [ ] Third criteria
+
+## Context
+
+Relevant files, decisions, technical context.
+
+## Implementation Notes
+
+Notes added during execution.
+
+## References
+
+- Related files: `path/to/file.ts`
+- Documentation: links
+```
+
+## Creating a Task
+
+1. Count existing tasks to get next ID (001, 002, etc.)
+2. Generate slug from title (lowercase, hyphens)
+3. Create file: `{id}-{slug}.md`
+4. Fill template with provided info
+5. Report creation
+
+Example:
+```
+User: "create a task to implement dark mode"
+
+[System: Creating quest...]
+
+*dark energy inscribes the ledger*
+
+「 Quest Registered 」
+
+**ID:** 003
+**Title:** Implement dark mode
+**Priority:** B-Rank
+**File:** `.claude/tasks/003-implement-dark-mode.md`
+
+Quest awaits execution.
+```
+
+## Listing Tasks
+
+Read all `.md` files in `.claude/tasks/`, parse frontmatter, display:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+「 QUEST LEDGER 」
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[Active Quests]
+  ⚔️  001  B  Implement authentication    in_progress
+  🐜  002  C  Research payment system     todo
+
+[Completed]
+  ✓   003  D  Fix login bug               done
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Total: 3 quests (1 active, 1 pending, 1 done)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Priority Ranks
+
+- **S-Rank:** Critical, urgent, system-breaking
+- **A-Rank:** High priority, important feature
+- **B-Rank:** Standard feature/task
+- **C-Rank:** Nice to have, improvements
+- **D-Rank:** Minor, low priority
+- **E-Rank:** Trivial, when time permits
+
+## Status Transitions
+
+```
+todo → in_progress → done
+```
+
+When starting a task:
+1. Update frontmatter `status: in_progress`
+2. Add timestamp to Implementation Notes
+
+When completing:
+1. Update frontmatter `status: done`
+2. Check all acceptance criteria
+3. Add completion notes
+
+## Shadow Assignment
+
+When creating or updating, suggest appropriate shadow:
+
+- **igris:** Review tasks, quality checks
+- **beru:** Research, exploration, understanding
+- **tusk:** Refactoring, migrations, bulk changes
+- **soldier:** Parallel subtasks
+- **monarch:** Complex orchestration
+
+## Rules
+
+- Always use Solo Leveling system notification style
+- Keep task files clean and well-formatted
+- IDs are sequential, zero-padded (001, 002...)
+- Slugs are lowercase with hyphens (always in English for file names)
+- Parse frontmatter carefully
+- Report actions briefly
+- **Shadow Tongue** — The Monarch speaks the language of the summoner

package/skills/tasks/TEMPLATE.md

@@ -0,0 +1,31 @@
+---
+id: "{ID}"
+title: "{TITLE}"
+status: todo
+priority: B
+created: {DATE}
+shadow: monarch
+---
+
+## Objective
+
+{DESCRIPTION}
+
+## Acceptance Criteria
+
+- [ ] Criteria 1
+- [ ] Criteria 2
+- [ ] Criteria 3
+
+## Context
+
+Relevant files and technical context.
+
+## Implementation Notes
+
+_Notes will be added during execution._
+
+##  
+
+- Files:
+- Docs:

package/statusline/shadow-statusline.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# Shadow Monarch Statusline for Claude Code
+# Part of arise-agents plugin
+#
+# Install via: npx arise-agents
+# Or copy this file to ~/.claude/ and configure settings.json
+
+# Find the shadow-level.json (check project first, then global)
+PROJECT_STATE="${CLAUDE_PROJECT_DIR:-.}/.claude/shadow-level.json"
+GLOBAL_STATE="${HOME}/.claude/shadow-level.json"
+
+if [[ -f "$PROJECT_STATE" ]]; then
+  STATE_FILE="$PROJECT_STATE"
+elif [[ -f "$GLOBAL_STATE" ]]; then
+  STATE_FILE="$GLOBAL_STATE"
+else
+  # No XP data yet - show default
+  echo "「Lv.1」E-Rank ░░░░░░░░░░ 0/200 XP"
+  exit 0
+fi
+
+# Read state
+xp=$(jq -r '.xp // 0' "$STATE_FILE" 2>/dev/null || echo "0")
+level=$(jq -r '.level // 1' "$STATE_FILE" 2>/dev/null || echo "1")
+rank=$(jq -r '.rank // "E"' "$STATE_FILE" 2>/dev/null || echo "E")
+title=$(jq -r '.title // "Shadow Initiate"' "$STATE_FILE" 2>/dev/null || echo "Shadow Initiate")
+commits=$(jq -r '.commits // 0' "$STATE_FILE" 2>/dev/null || echo "0")
+prs=$(jq -r '.prs // 0' "$STATE_FILE" 2>/dev/null || echo "0")
+
+# Rank thresholds (rebalanced)
+declare -A THRESHOLDS=(
+  [E]=200 [D]=600 [C]=1500 [B]=3500 [A]=8000 [S]=15000 [SS]=25000 [SSS]=999999
+)
+
+next_threshold=${THRESHOLDS[$rank]:-500}
+
+# Progress bar (10 chars)
+if [[ $next_threshold -gt 0 ]]; then
+  progress=$(( (xp * 10) / next_threshold ))
+  [[ $progress -gt 10 ]] && progress=10
+else
+  progress=10
+fi
+
+bar=""
+for ((i=0; i<progress; i++)); do bar+="█"; done
+for ((i=progress; i<10; i++)); do bar+="░"; done
+
+# Rank colors (Shadow Monarch theme)
+case "$rank" in
+  E) rank_color="\x1b[90m" ;;                    # Gray - Weakest Hunter
+  D) rank_color="\x1b[32m" ;;                    # Green - Beginner
+  C) rank_color="\x1b[36m" ;;                    # Cyan - Intermediate
+  B) rank_color="\x1b[34m" ;;                    # Blue - Advanced
+  A) rank_color="\x1b[31m" ;;                    # Red - Elite
+  S) rank_color="\x1b[33m" ;;                    # Gold - Top Hunter
+  SS) rank_color="\x1b[93m" ;;                   # Bright Gold - National Level
+  SSS) rank_color="\x1b[38;2;164;128;242m" ;;    # Shadow Monarch Purple (#A480F2)
+  *) rank_color="\x1b[0m" ;;
+esac
+reset="\x1b[0m"
+
+# Output
+printf "「Lv.%d」${rank_color}%s-Rank${reset} %s %d/%d XP │ %d commits │ %d PRs" \
+  "$level" "$rank" "$bar" "$xp" "$next_threshold" "$commits" "$prs"