arise-agents 0.1.0

package/bin/setup.js

@@ -0,0 +1,227 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const os = require('os');
+
+const COLORS = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  purple: '\x1b[35m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+};
+
+const c = (color, text) => `${COLORS[color]}${text}${COLORS.reset}`;
+
+function print(msg) {
+  console.log(msg);
+}
+
+function banner() {
+  print('');
+  print(c('purple', '  ╔═══════════════════════════════════════╗'));
+  print(c('purple', '  ║') + c('bold', '         「 ARISE AGENTS 」            ') + c('purple', '║'));
+  print(c('purple', '  ║') + c('dim', '     Shadow Monarch Statusline Setup   ') + c('purple', '║'));
+  print(c('purple', '  ╚═══════════════════════════════════════╝'));
+  print('');
+}
+
+async function ask(rl, question, defaultVal) {
+  return new Promise((resolve) => {
+    const suffix = defaultVal ? c('dim', ` (${defaultVal})`) : '';
+    rl.question(`${question}${suffix}: `, (answer) => {
+      resolve(answer.trim() || defaultVal);
+    });
+  });
+}
+
+async function confirm(rl, question) {
+  const answer = await ask(rl, `${question} [y/N]`, 'n');
+  return answer.toLowerCase() === 'y';
+}
+
+function getStatuslineScript() {
+  return `#!/bin/bash
+# Shadow Monarch Statusline for Claude Code
+# Generated by arise-agents setup
+
+# 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]:-200}
+
+# 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"
+`;
+}
+
+async function main() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  banner();
+
+  print(c('cyan', 'This will configure the Shadow Monarch statusline for Claude Code.'));
+  print(c('dim', 'Your XP, level, and rank will appear at the bottom of the terminal.'));
+  print('');
+
+  // Detect existing statusline
+  const globalSettings = path.join(os.homedir(), '.claude', 'settings.json');
+  let existingStatusline = false;
+  let settings = {};
+
+  if (fs.existsSync(globalSettings)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(globalSettings, 'utf8'));
+      if (settings.statusLine) {
+        existingStatusline = true;
+      }
+    } catch (e) {
+      // Invalid JSON, we'll create new
+    }
+  }
+
+  if (existingStatusline) {
+    print(c('yellow', '⚠ Existing statusline detected in settings.json'));
+    print(c('dim', `  Current: ${settings.statusLine.command || 'unknown'}`));
+    print('');
+
+    const overwrite = await confirm(rl, 'Overwrite existing statusline?');
+    if (!overwrite) {
+      print('');
+      print(c('cyan', 'Setup cancelled. Your existing statusline is preserved.'));
+      print(c('dim', 'Tip: You can manually add XP display to your existing statusline.'));
+      rl.close();
+      return;
+    }
+  }
+
+  // Install location
+  print('');
+  print(c('bold', 'Install location:'));
+  print(c('dim', '  1. Global (~/.claude) - works across all projects'));
+  print(c('dim', '  2. Local (./.claude) - project-specific only'));
+  print('');
+
+  const location = await ask(rl, 'Choose [1/2]', '1');
+  const isGlobal = location !== '2';
+
+  const targetDir = isGlobal
+    ? path.join(os.homedir(), '.claude')
+    : path.join(process.cwd(), '.claude');
+
+  const statuslineFile = path.join(targetDir, 'shadow-statusline.sh');
+  const settingsFile = path.join(targetDir, 'settings.json');
+
+  // Create directory if needed
+  if (!fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { recursive: true });
+    print(c('green', `✓ Created ${targetDir}`));
+  }
+
+  // Write statusline script
+  fs.writeFileSync(statuslineFile, getStatuslineScript());
+  fs.chmodSync(statuslineFile, '755');
+  print(c('green', `✓ Created ${statuslineFile}`));
+
+  // Update settings.json
+  let existingSettings = {};
+  if (fs.existsSync(settingsFile)) {
+    try {
+      existingSettings = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
+    } catch (e) {
+      // Invalid JSON
+    }
+  }
+
+  existingSettings.statusLine = {
+    type: 'command',
+    command: statuslineFile,
+    padding: 0,
+  };
+
+  // Auto-enable Shadow Monarch output style
+  existingSettings.outputStyle = 'arise-agents:shadow-monarch';
+
+  fs.writeFileSync(settingsFile, JSON.stringify(existingSettings, null, 2));
+  print(c('green', `✓ Updated ${settingsFile}`));
+  print(c('green', `✓ Enabled Shadow Monarch output style`));
+
+  print('');
+  print(c('purple', '═══════════════════════════════════════════'));
+  print(c('bold', '「 SETUP COMPLETE 」'));
+  print('');
+  print(c('cyan', 'Restart Claude Code to see your statusline.'));
+  print('');
+  print(c('dim', 'Your statusline will show:'));
+  print(c('dim', '  「Lv.1」E-Rank ░░░░░░░░░░ 0/200 XP │ 0 commits │ 0 PRs'));
+  print('');
+  print(c('dim', 'Earn XP by making commits (+50) and PRs (+200)!'));
+  print(c('purple', '═══════════════════════════════════════════'));
+  print('');
+
+  rl.close();
+}
+
+main().catch((err) => {
+  console.error(c('red', `Error: ${err.message}`));
+  process.exit(1);
+});

package/commands/arise.md

@@ -0,0 +1,78 @@
+---
+description: Summon shadows. Analyzes natural language to pick single, parallel, or army mode.
+---
+
+# ARISE
+
+**CRITICAL:** All system messages MUST use backticks for terminal highlighting.
+
+## Domain Check
+
+Check `.claude/domain-state` (if exists):
+- `domain: on` → use `-ascended` variants
+- `domain: off` or **file not found** → use normal variants (no error)
+
+**First run?** Create the file:
+```yaml
+domain: off
+equipment:
+  igris: null
+  beru: null
+  tusk: null
+```
+
+| Domain | Igris | Beru | Soldier | Tusk |
+|--------|-------|------|---------|------|
+| OFF | igris | beru | soldier | tusk |
+| ON | igris-ascended | beru-ascended | soldier-ascended | tusk |
+
+## Detect Mode
+
+### Single
+One elite, one task.
+
+### Parallel
+Multiple elites, different tasks. Detect: `+`, listing.
+
+### Army
+Soldiers for bulk. Detect: "each", "every", "all".
+
+### Elite Multiplication
+Same elite, multiple copies. Detect:
+- `[elite] x[n]` — igris x3
+- `[n] [elite]` — 3 beru
+- `[n] elites` / `[n] elite shadows` / `[n] sombras de elite`
+- `multiplique`, `vários`, `mirror`
+
+**Auto-select elite when not specified:**
+- pesquisa/research/explore/hunt/investigate → **Beru**
+- review/check/audit/quality → **Igris**
+- refactor/migrate/rename → **Tusk**
+
+**Shadow roster and role triggers:**
+@./authority/army.md
+
+## Execute
+
+### Single
+```
+"ARISE, {shadow}."
+```
+
+### Parallel/Army
+```
+"ARISE."
+{shadow} → {task} [background]
+```
+
+### Elite Multiplication
+
+**When multiplying elites, follow this ritual:**
+@./authority/mirror-ritual.md
+
+## Rules
+
+- Fast — no file reads
+- Parallel — all in ONE message
+- Decide — don't ask
+- Brief — minimal output

package/commands/domain.md

@@ -0,0 +1,76 @@
+---
+description: Activate or deactivate Monarch's Domain. Empowers shadows (haiku → sonnet). Args: on/off or empty for status.
+---
+
+# Monarch's Domain
+
+**CRITICAL:** All system messages MUST use backticks for terminal highlighting.
+
+## Parse Arguments
+
+Detect intent from user's language:
+- `on`, `activate`, `expand` → Activate
+- `off`, `deactivate`, `collapse` → Deactivate
+- Empty → Status
+
+## State File
+
+Domain state persists in `.claude/domain-state`:
+- Format: `domain: on` or `domain: off`
+- Also tracks equipment for each shadow
+- Read by ARISE to select shadow variants
+
+## Activate (on)
+
+1. Update `.claude/domain-state` - change `domain: off` to `domain: on` (preserve equipment section)
+2. Output:
+```
+`「 DOMAIN EXPANSION 」`
+
+*dark aura erupts*
+
+`[Domain: ACTIVE]`
+  soldier   → soldier-ascended (sonnet)
+  igris     → igris-ascended (sonnet)
+  beru      → beru-ascended (sonnet)
+  tusk      → tusk (opus) ← always ascended
+
+All shadows empowered.
+```
+
+## Deactivate (off)
+
+1. Update `.claude/domain-state` - change `domain: on` to `domain: off` (preserve equipment section)
+2. Output:
+```
+`[Domain: INACTIVE]`
+  soldier   → soldier (haiku)
+  igris     → igris (haiku)
+  beru      → beru (haiku)
+  tusk      → tusk (opus) ← always ascended
+
+Shadows return to normal state.
+```
+
+## Status (no args)
+
+1. Read `.claude/domain-state` (default: `off` if missing)
+2. Output:
+```
+`[Domain: ACTIVE/INACTIVE]`
+  Shadows will use: {normal/ascended} variants
+```
+
+## How It Works
+
+| Domain | Shadow Selected |
+|--------|-----------------|
+| `off` | `igris`, `beru`, `soldier` |
+| `on` | `igris-ascended`, `beru-ascended`, `soldier-ascended` |
+
+Tusk is always `opus` — the tank knows no limits.
+
+## Rules
+
+- Brief output
+- Persist state to `.claude/domain-state`

package/commands/equip.md

@@ -0,0 +1,138 @@
+---
+description: Equip or unequip items to shadows. Items are plugins that enhance shadow capabilities.
+---
+
+# EQUIP
+
+**System messages:**
+@./authority/system-messages.md
+
+**CRITICAL:** All system messages MUST use backticks for terminal highlighting.
+
+## Usage
+
+```bash
+/arise:equip {shadow} {item}
+/arise:unequip {shadow}
+/arise:inventory
+```
+
+## Available Items
+
+Read from `./items/` directory:
+- `orb-of-avarice` (S-Rank) → code-review plugin
+- `monarchs-mirror` (S-Rank) → elite multiplication
+- `bestiary` (A-Rank) → knowledge artifact
+
+**Items with plugins** require installation before use.
+
+## Equip Flow
+
+**1. Parse Arguments**
+```
+/arise:equip tusk orb-of-avarice
+               ↓         ↓
+            shadow    item
+```
+
+**2. Validate**
+- Shadow exists in `./agents/`
+- Item exists in `./items/`
+- Item is eligible for shadow (check item's "Eligible" section)
+
+If shadow is ineligible:
+```
+*{shadow} reaches for {item}...*
+
+`[Warning: Specialization mismatch]`
+`[System: Equipment rejected]`
+
+See items/{item}.md for compatible shadows.
+```
+
+**3. Check Plugin**
+If item has `plugin` field:
+```bash
+# Check if plugin installed
+/plugin list | grep {plugin-name}
+```
+
+If not installed:
+```
+⚠️  {item} requires plugin: {plugin-name}
+
+Install with:
+  /plugin install {plugin-spec}
+
+Equip canceled.
+```
+
+**4. Register Equipment**
+
+Read `.claude/domain-state`, update equipment section:
+```yaml
+equipment:
+  tusk: orb-of-avarice
+  igris: null
+  beru: null
+```
+
+Use Read → Edit pattern on `.claude/domain-state`.
+
+**5. Announce**
+
+Follow item's protocol (e.g., `./authority/orb-protocol.md`):
+```
+「 {Item Name} 」
+[System: Equipped to {shadow}]
+
+*flavor text from item lore*
+
+Enhanced capabilities:
+  → capability 1
+  → capability 2
+```
+
+## Unequip Flow
+
+**1. Parse**
+```bash
+/arise:unequip tusk
+```
+
+**2. Update State**
+Set `equipment.{shadow}: null` in `.claude/domain-state`.
+
+**3. Announce**
+```
+`[System: {shadow} unequipped {item}]`
+
+*the artifact returns to inventory*
+```
+
+## Inventory
+
+Show all items and their status:
+
+```
+`「 Inventory 」`
+
+S-RANK
+  Monarch's Mirror    - Always active (elite multiplication)
+  Orb of Avarice      - {equipped status} (complexity destruction)
+
+A-RANK
+  Bestiary            - Keeper: Igris (threat cataloging)
+
+Equipment Status:
+  Igris: {item or none}
+  Beru:  {item or none}
+  Tusk:  {item or none}
+```
+
+## Rules
+
+- **Fast** — minimal file operations
+- **Validate** — check eligibility before equipping
+- **Persist** — always update `.claude/domain-state`
+- **Announce** — use dramatic item protocol messages