sisyphi 1.0.7 → 1.0.8

package/dist/templates/agent-plugin/hooks/CLAUDE.md

@@ -0,0 +1,57 @@
+# templates/agent-plugin/hooks/
+
+Lifecycle hooks for agent plugin workflows. Enable specialized prompt generation and context handling during agent spawning.
+
+## hooks.json
+
+Schema: `{ "phaseKey": { "hookName": "script-name.sh" } }`
+
+Example:
+```json
+{
+  "plan": {
+    "userPrompt": "plan-user-prompt.sh",
+    "systemPrompt": "plan-system-prompt.sh"
+  }
+}
+```
+
+- **Keys**: Phase names (e.g., `plan`, `spec`, `implement`) — must correspond to phase modes in agent spawn workflow
+- **Values**: Object mapping hook types to shell script names
+- **Hook types**: `userPrompt`, `systemPrompt` (extensible for future hooks)
+
+## Shell Scripts
+
+Each script receives environment variables and outputs text to stdout.
+
+```bash
+# Receives: $SISYPHUS_SESSION_ID, $SISYPHUS_AGENT_ID, $INSTRUCTION, $AGENT_TYPE, context files
+# Outputs: Full user or system prompt text
+```
+
+**Convention**: `{phase}-{hook-type}.sh`
+
+**Inputs**:
+- `$SISYPHUS_SESSION_ID` — Session UUID
+- `$SISYPHUS_AGENT_ID` — Agent ID (e.g., `agent-001`)
+- `$INSTRUCTION` — Task instruction from spawn command
+- `$AGENT_TYPE` — Agent type (e.g., `plan`, `spec`, `implement`)
+- Context files at `.sisyphus/sessions/$SISYPHUS_SESSION_ID/context/`
+
+**Output**: Must write complete prompt text to stdout (no errors to stderr)
+
+## Invocation
+
+Hooks are executed during agent spawn when:
+1. Agent type matches a plugin agent type (e.g., `--agent-type sisyphus:plan`)
+2. Phase has hooks configured in hooks.json
+3. Daemon renders prompts before passing to Claude
+
+Output becomes the `--append-system-prompt` or user message content.
+
+## Key Patterns
+
+- **No placeholders in shell scripts** — unlike `.md` templates, scripts perform logic and generate final text
+- **Context access**: Scripts can read session state from `$SISYPHUS_SESSION_ID` directory
+- **Error handling**: Exit non-zero to fail agent spawn; errors logged to daemon.log
+- **Stdout only**: Scripts must output complete prompt to stdout; nothing to stderr

package/dist/templates/agent-plugin/hooks/hooks.json

@@ -3,18 +3,22 @@
     "PreToolUse": [
       {
         "matcher": "SendMessage",
-        "hook": {
-          "type": "command",
-          "command": "bash hooks/intercept-send-message.sh"
-        }
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/intercept-send-message.sh"
+          }
+        ]
       }
     ],
     "Stop": [
       {
-        "hook": {
-          "type": "command",
-          "command": "bash hooks/require-submit.sh"
-        }
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/require-submit.sh"
+          }
+        ]
       }
     ]
   }

package/dist/templates/agent-plugin/hooks/plan-user-prompt.sh

@@ -2,10 +2,7 @@
 # UserPromptSubmit hook: remind plan agent to delegate for large tasks.
 if [ -z "$SISYPHUS_SESSION_ID" ]; then exit 0; fi
 
-python3 -c "
-import json, sys
-print(json.dumps({'additionalContext': sys.stdin.read()}))
-" <<'HINT'
+cat <<'HINT'
 <planning-reminder>
 For particularly large or multi-domain tasks, delegate sub-plans to specialist agents rather than planning everything solo:
 

package/dist/templates/agent-plugin/hooks/spec-user-prompt.sh

@@ -2,10 +2,7 @@
 # UserPromptSubmit hook: remind spec agent to iterate with the user.
 if [ -z "$SISYPHUS_SESSION_ID" ]; then exit 0; fi
 
-python3 -c "
-import json, sys
-print(json.dumps({'additionalContext': sys.stdin.read()}))
-" <<'HINT'
+cat <<'HINT'
 <spec-reminder>
 Iterate with the user — include them in the process before writing anything to disk:
 

package/dist/templates/companion-plugin/hooks/hooks.json

@@ -2,10 +2,12 @@
   "hooks": {
     "UserPromptSubmit": [
       {
-        "hook": {
-          "type": "command",
-          "command": "bash hooks/user-prompt-context.sh"
-        }
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-context.sh"
+          }
+        ]
       }
     ]
   }

package/package.json

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

package/templates/agent-plugin/hooks/CLAUDE.md

@@ -0,0 +1,57 @@
+# templates/agent-plugin/hooks/
+
+Lifecycle hooks for agent plugin workflows. Enable specialized prompt generation and context handling during agent spawning.
+
+## hooks.json
+
+Schema: `{ "phaseKey": { "hookName": "script-name.sh" } }`
+
+Example:
+```json
+{
+  "plan": {
+    "userPrompt": "plan-user-prompt.sh",
+    "systemPrompt": "plan-system-prompt.sh"
+  }
+}
+```
+
+- **Keys**: Phase names (e.g., `plan`, `spec`, `implement`) — must correspond to phase modes in agent spawn workflow
+- **Values**: Object mapping hook types to shell script names
+- **Hook types**: `userPrompt`, `systemPrompt` (extensible for future hooks)
+
+## Shell Scripts
+
+Each script receives environment variables and outputs text to stdout.
+
+```bash
+# Receives: $SISYPHUS_SESSION_ID, $SISYPHUS_AGENT_ID, $INSTRUCTION, $AGENT_TYPE, context files
+# Outputs: Full user or system prompt text
+```
+
+**Convention**: `{phase}-{hook-type}.sh`
+
+**Inputs**:
+- `$SISYPHUS_SESSION_ID` — Session UUID
+- `$SISYPHUS_AGENT_ID` — Agent ID (e.g., `agent-001`)
+- `$INSTRUCTION` — Task instruction from spawn command
+- `$AGENT_TYPE` — Agent type (e.g., `plan`, `spec`, `implement`)
+- Context files at `.sisyphus/sessions/$SISYPHUS_SESSION_ID/context/`
+
+**Output**: Must write complete prompt text to stdout (no errors to stderr)
+
+## Invocation
+
+Hooks are executed during agent spawn when:
+1. Agent type matches a plugin agent type (e.g., `--agent-type sisyphus:plan`)
+2. Phase has hooks configured in hooks.json
+3. Daemon renders prompts before passing to Claude
+
+Output becomes the `--append-system-prompt` or user message content.
+
+## Key Patterns
+
+- **No placeholders in shell scripts** — unlike `.md` templates, scripts perform logic and generate final text
+- **Context access**: Scripts can read session state from `$SISYPHUS_SESSION_ID` directory
+- **Error handling**: Exit non-zero to fail agent spawn; errors logged to daemon.log
+- **Stdout only**: Scripts must output complete prompt to stdout; nothing to stderr

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

@@ -3,18 +3,22 @@
     "PreToolUse": [
       {
         "matcher": "SendMessage",
-        "hook": {
-          "type": "command",
-          "command": "bash hooks/intercept-send-message.sh"
-        }
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/intercept-send-message.sh"
+          }
+        ]
       }
     ],
     "Stop": [
       {
-        "hook": {
-          "type": "command",
-          "command": "bash hooks/require-submit.sh"
-        }
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/require-submit.sh"
+          }
+        ]
       }
     ]
   }

package/templates/agent-plugin/hooks/plan-user-prompt.sh

@@ -2,10 +2,7 @@
 # UserPromptSubmit hook: remind plan agent to delegate for large tasks.
 if [ -z "$SISYPHUS_SESSION_ID" ]; then exit 0; fi
 
-python3 -c "
-import json, sys
-print(json.dumps({'additionalContext': sys.stdin.read()}))
-" <<'HINT'
+cat <<'HINT'
 <planning-reminder>
 For particularly large or multi-domain tasks, delegate sub-plans to specialist agents rather than planning everything solo:
 

package/templates/agent-plugin/hooks/spec-user-prompt.sh

@@ -2,10 +2,7 @@
 # UserPromptSubmit hook: remind spec agent to iterate with the user.
 if [ -z "$SISYPHUS_SESSION_ID" ]; then exit 0; fi
 
-python3 -c "
-import json, sys
-print(json.dumps({'additionalContext': sys.stdin.read()}))
-" <<'HINT'
+cat <<'HINT'
 <spec-reminder>
 Iterate with the user — include them in the process before writing anything to disk:
 

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

@@ -2,10 +2,12 @@
   "hooks": {
     "UserPromptSubmit": [
       {
-        "hook": {
-          "type": "command",
-          "command": "bash hooks/user-prompt-context.sh"
-        }
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-context.sh"
+          }
+        ]
       }
     ]
   }