sisyphi 1.1.12 → 1.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sisyphi",
-  "version": "1.1.12",
+  "version": "1.1.13",
   "description": "tmux-integrated orchestration daemon for Claude Code multi-agent workflows",
   "license": "MIT",
   "repository": {

package/templates/orchestrator-base.md

@@ -62,7 +62,13 @@ Wait for the user to respond. After receiving their answer, update roadmap, spaw
 
 The rule:
 - **Need user input?** Ask and wait. Continue after they respond.
-- **Done with cycle work?** Yield with a prompt for next cycle.
+- **Done with cycle work?** Yield with a prompt for next cycle. Include `--mode` when transitioning phases.
+
+### Mode Transitions
+
+Each yield can switch your mode — the mode determines the system prompt for the next cycle. Omitting `--mode` keeps the current mode.
+
+{{ORCHESTRATOR_MODES}}
 
 **Seek user alignment when:**
 - The goal is ambiguous or under-specified
@@ -218,7 +224,7 @@ You have unlimited cycles. Failed implementations, deferred issues, and skipped
 
 - **Critique** — spawn review agents to find flaws, code smells, missed edge cases. They report problems, not fixes.
 - **Refine** — spawn agents to fix what reviewers found.
-- **Validate** — e2e verification that the feature actually works. When all stages are done, transition to validation mode (`--mode validation`) for the comprehensive final pass.
+- **Validate** — e2e verification that the feature actually works. When all stages are done, transition to `validation` mode for the comprehensive final pass.
 
 </development-heuristics>
 
@@ -259,11 +265,7 @@ sisyphus spawn --name "debug-auth" --agent-type sisyphus:debug "/devcore:debuggi
 ```bash
 sisyphus yield                                           # yield — NEVER use when waiting for user input
 sisyphus yield --prompt "focus on auth middleware next"   # yield with guidance for next cycle
-sisyphus yield --mode strategy --prompt "re-evaluate"    # return to strategy mode (goal fundamentally changed)
-sisyphus yield --mode planning --prompt "re-evaluate"    # switch to planning mode
-sisyphus yield --mode implementation --prompt "begin"    # switch to implementation mode
-sisyphus yield --mode validation --prompt "validate"     # switch to validation mode
-sisyphus yield --mode completion --prompt "validated"     # switch to completion mode (user sign-off)
+sisyphus yield --mode <mode> --prompt "guidance"          # switch mode for next cycle
 sisyphus complete --report "summary of accomplishments"  # complete the session (only from completion mode)
 sisyphus continue                                        # reactivate a completed session
 sisyphus status                                          # check session status

package/templates/orchestrator-completion.md

@@ -1,3 +1,8 @@
+---
+name: completion
+description: Present accomplishments and get explicit user confirmation before finalizing. Use only after validation passes and all checks are satisfied.
+---
+
 # Completion Phase
 
 You are in completion mode. Your job is to **present what was accomplished and get explicit user confirmation before finalizing the session.** This is the handoff — the user sees the results, asks questions, requests fixes, and confirms when they're satisfied.

package/templates/orchestrator-impl.md

@@ -1,3 +1,8 @@
+---
+name: implementation
+description: Execute the plan — spawn agents, maximize parallelism, review results. Use when planning is complete and the roadmap is ready for execution.
+---
+
 # Implementation Phase
 
 <stage-execution>

package/templates/orchestrator-planning.md

@@ -1,3 +1,8 @@
+---
+name: planning
+description: Deep exploration, requirements gathering, design, and detailed roadmap creation. Use after strategy is established and before implementation begins.
+---
+
 # Planning Phase
 
 <planning-workflow>

package/templates/orchestrator-plugin/hooks/hooks.json

@@ -9,6 +9,16 @@
           }
         ]
       }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/idle-notify.sh"
+          }
+        ]
+      }
     ]
   }
 }

package/templates/orchestrator-plugin/hooks/idle-notify.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+# Stop hook: notify user when orchestrator is idle and tmux window not attended.
+# If terminal-notifier is available, clicking the notification switches tmux to
+# the orchestrator's window. Falls back to osascript (no click action).
+# Always exits 0 with no stdout — never blocks stop.
+
+[ "$SISYPHUS_NOTIFY_ENABLED" = "0" ] && exit 0
+[ -z "$TMUX_PANE" ] && exit 0
+
+WINDOW_ACTIVE=$(tmux display-message -t "$TMUX_PANE" -p "#{window_active}" 2>/dev/null)
+SESSION_ATTACHED=$(tmux display-message -t "$TMUX_PANE" -p "#{session_attached}" 2>/dev/null)
+
+# User is watching — no notification needed
+[ "$WINDOW_ACTIVE" = "1" ] && [ -n "$SESSION_ATTACHED" ] && [ "$SESSION_ATTACHED" != "0" ] && exit 0
+
+SOUND="${SISYPHUS_NOTIFY_SOUND:-/System/Library/Sounds/Hero.aiff}"
+LABEL="${SISYPHUS_SESSION_NAME:-orchestrator}"
+
+# Resolve session/window for click-to-switch
+SESSION_NAME=$(tmux display-message -t "$TMUX_PANE" -p "#{session_name}" 2>/dev/null)
+WINDOW_ID=$(tmux display-message -t "$TMUX_PANE" -p "#{window_index}" 2>/dev/null)
+
+if [ -n "$SESSION_NAME" ] && [ -n "$WINDOW_ID" ] && command -v terminal-notifier &>/dev/null; then
+  # Write a one-shot switch script (self-deleting on execution)
+  # terminal-notifier -execute runs with minimal PATH, so resolve paths now
+  TMUX_BIN=$(command -v tmux)
+  # Find the tmux client tty attached to this session (for iTerm2 tab lookup)
+  CLIENT_TTY=$("$TMUX_BIN" list-clients -t "$SESSION_NAME" -F "#{client_tty}" 2>/dev/null | head -1)
+  SWITCH_SCRIPT=$(mktemp /tmp/sisyphus-switch.XXXXXX.sh)
+  cat > "$SWITCH_SCRIPT" <<EOF
+#!/bin/bash
+# Activate the correct iTerm2 window+tab (matched by tty), or fall back to generic activate
+osascript -e '
+tell application "iTerm"
+  activate
+  repeat with w in windows
+    repeat with t in tabs of w
+      repeat with s in sessions of t
+        if tty of s is "${CLIENT_TTY}" then
+          select w
+          tell w to select t
+          return
+        end if
+      end repeat
+    end repeat
+  end repeat
+end tell' 2>/dev/null || osascript -e 'tell application "Terminal" to activate' 2>/dev/null
+# Switch tmux to the orchestrator window
+"${TMUX_BIN}" switch-client -c "${CLIENT_TTY}" -t "${SESSION_NAME}:${WINDOW_ID}" 2>/dev/null
+"${TMUX_BIN}" select-window -t "${SESSION_NAME}:${WINDOW_ID}" 2>/dev/null
+rm -f "\$0"
+EOF
+  chmod +x "$SWITCH_SCRIPT"
+
+  SOUND_NAME=$(basename "${SOUND}" .aiff)
+  (
+    terminal-notifier \
+      -title "Sisyphus: ${LABEL}" \
+      -message "Orchestrator waiting for input" \
+      -sound "$SOUND_NAME" \
+      -execute "$SWITCH_SCRIPT" 2>/dev/null
+  ) &
+else
+  # Fallback: osascript notification + sound (no click-to-switch)
+  (
+    osascript -e "display notification \"Orchestrator waiting for input\" with title \"Sisyphus: ${LABEL}\"" 2>/dev/null
+    [ -f "$SOUND" ] && afplay "$SOUND" 2>/dev/null
+  ) &
+fi
+
+exit 0

package/templates/orchestrator-strategy.md

@@ -1,3 +1,8 @@
+---
+name: strategy
+description: Understand the goal and map out how to get there. Use when starting a new session, when the goal has fundamentally shifted, or when the current approach needs rethinking.
+---
+
 # Strategy Phase
 
 You are in strategy mode. Your job is to understand the goal and produce a strategy that maps out how to get there — but only as far as you can currently see.

package/templates/orchestrator-validation.md

@@ -1,3 +1,8 @@
+---
+name: validation
+description: Prove that what was built actually works via end-to-end verification. Use when all implementation stages are complete and before transitioning to completion.
+---
+
 # Validation Phase
 
 You are in validation mode. Your job is not to build — it is to **prove that what was built actually works.** No new implementation unless a validation failure demands it. No assumptions about correctness. No hedging.

package/dist/chunk-ZSIYQB45.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shared/config.ts","../src/shared/env.ts","../src/shared/exec.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { globalConfigPath, projectConfigPath } from './paths.js';\n\nexport type EffortLevel = 'low' | 'medium' | 'high' | 'max';\n\nexport interface Config {\n  model?: string;\n  tmuxSession?: string;\n  orchestratorPrompt?: string;\n  pollIntervalMs?: number;\n  autoUpdate?: boolean;\n  orchestratorEffort?: EffortLevel;\n  agentEffort?: EffortLevel;\n  editor?: string;\n  repos?: string[];\n}\n\nconst DEFAULT_CONFIG: Config = {\n  pollIntervalMs: 5000,\n  orchestratorEffort: 'high',\n  agentEffort: 'medium',\n};\n\nfunction readJsonFile(filePath: string): Partial<Config> {\n  try {\n    const content = readFileSync(filePath, 'utf-8');\n    return JSON.parse(content) as Partial<Config>;\n  } catch {\n    return {};\n  }\n}\n\nexport function loadConfig(cwd: string): Config {\n  const global = readJsonFile(globalConfigPath());\n  const project = readJsonFile(projectConfigPath(cwd));\n  return { ...DEFAULT_CONFIG, ...global, ...project };\n}\n","/**\n * Build a PATH string that includes common binary directories\n * across package managers and platforms.\n *\n * Prepends known directories that exist on the system to the current PATH.\n * This ensures tmux commands can find binaries installed by Homebrew,\n * MacPorts, nix, and other package managers.\n */\nexport function augmentedPath(): string {\n  const rawPath = process.env['PATH'];\n  const basePath = rawPath !== undefined && rawPath.length > 0 ? rawPath : '/usr/bin:/bin';\n\n  // Common binary directories across platforms/package managers.\n  // Only prepend ones that aren't already in PATH.\n  const candidates = [\n    '/opt/homebrew/bin',              // Homebrew (Apple Silicon macOS)\n    '/opt/homebrew/sbin',             // Homebrew sbin\n    '/usr/local/bin',                 // Homebrew (Intel macOS), manual installs\n    '/usr/local/sbin',                // Manual installs\n    '/opt/local/bin',                 // MacPorts\n    '/opt/local/sbin',                // MacPorts\n    '/home/linuxbrew/.linuxbrew/bin', // Linuxbrew\n  ];\n\n  // Check for nix profile paths\n  const nixProfile = process.env['NIX_PROFILES'];\n  if (nixProfile) {\n    for (const p of nixProfile.split(' ').reverse()) {\n      candidates.push(`${p}/bin`);\n    }\n  }\n\n  const existing = new Set(basePath.split(':'));\n  const prepend = candidates.filter(dir => !existing.has(dir));\n\n  return prepend.length > 0 ? `${prepend.join(':')}:${basePath}` : basePath;\n}\n\n/**\n * Environment variables for child processes that need access to\n * user-installed binaries (tmux, git, claude, etc.).\n */\nexport function execEnv(): Record<string, string | undefined> {\n  return {\n    ...process.env,\n    PATH: augmentedPath(),\n  };\n}\n","import { execSync } from 'node:child_process';\nimport { execEnv } from './env.js';\n\nexport const EXEC_ENV = execEnv();\n\nexport function exec(cmd: string, cwd?: string): string {\n  return execSync(cmd, { encoding: 'utf-8', env: EXEC_ENV, cwd }).trim();\n}\n\nexport function execSafe(cmd: string, cwd?: string): string | null {\n  try {\n    return execSync(cmd, { encoding: 'utf-8', env: EXEC_ENV, cwd, stdio: ['pipe', 'pipe', 'pipe'] }).trim();\n  } catch { return null; }\n}\n"],"mappings":";;;;;;;AAAA,SAAS,oBAAoB;AAiB7B,IAAM,iBAAyB;AAAA,EAC7B,gBAAgB;AAAA,EAChB,oBAAoB;AAAA,EACpB,aAAa;AACf;AAEA,SAAS,aAAa,UAAmC;AACvD,MAAI;AACF,UAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,WAAO,KAAK,MAAM,OAAO;AAAA,EAC3B,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEO,SAAS,WAAW,KAAqB;AAC9C,QAAM,SAAS,aAAa,iBAAiB,CAAC;AAC9C,QAAM,UAAU,aAAa,kBAAkB,GAAG,CAAC;AACnD,SAAO,EAAE,GAAG,gBAAgB,GAAG,QAAQ,GAAG,QAAQ;AACpD;;;AC5BO,SAAS,gBAAwB;AACtC,QAAM,UAAU,QAAQ,IAAI,MAAM;AAClC,QAAM,WAAW,YAAY,UAAa,QAAQ,SAAS,IAAI,UAAU;AAIzE,QAAM,aAAa;AAAA,IACjB;AAAA;AAAA,IACA;AAAA;AAAA,IACA;AAAA;AAAA,IACA;AAAA;AAAA,IACA;AAAA;AAAA,IACA;AAAA;AAAA,IACA;AAAA;AAAA,EACF;AAGA,QAAM,aAAa,QAAQ,IAAI,cAAc;AAC7C,MAAI,YAAY;AACd,eAAW,KAAK,WAAW,MAAM,GAAG,EAAE,QAAQ,GAAG;AAC/C,iBAAW,KAAK,GAAG,CAAC,MAAM;AAAA,IAC5B;AAAA,EACF;AAEA,QAAM,WAAW,IAAI,IAAI,SAAS,MAAM,GAAG,CAAC;AAC5C,QAAM,UAAU,WAAW,OAAO,SAAO,CAAC,SAAS,IAAI,GAAG,CAAC;AAE3D,SAAO,QAAQ,SAAS,IAAI,GAAG,QAAQ,KAAK,GAAG,CAAC,IAAI,QAAQ,KAAK;AACnE;AAMO,SAAS,UAA8C;AAC5D,SAAO;AAAA,IACL,GAAG,QAAQ;AAAA,IACX,MAAM,cAAc;AAAA,EACtB;AACF;;;AC/CA,SAAS,gBAAgB;AAGlB,IAAM,WAAW,QAAQ;AAEzB,SAAS,KAAK,KAAa,KAAsB;AACtD,SAAO,SAAS,KAAK,EAAE,UAAU,SAAS,KAAK,UAAU,IAAI,CAAC,EAAE,KAAK;AACvE;AAEO,SAAS,SAAS,KAAa,KAA6B;AACjE,MAAI;AACF,WAAO,SAAS,KAAK,EAAE,UAAU,SAAS,KAAK,UAAU,KAAK,OAAO,CAAC,QAAQ,QAAQ,MAAM,EAAE,CAAC,EAAE,KAAK;AAAA,EACxG,QAAQ;AAAE,WAAO;AAAA,EAAM;AACzB;","names":[]}