shipwright-cli 1.7.1 → 1.9.0

package/claude-code/CLAUDE.md.shipwright

@@ -20,6 +20,12 @@ This project uses [Shipwright](https://github.com/sethdford/shipwright) for auto
 | `shipwright cost budget set <amount>` | Set daily budget limit |
 | `shipwright cost remaining-budget` | Check remaining daily budget (used by auto-scaler) |
 | `shipwright memory list` | View captured failure patterns |
+| `shipwright dashboard` | Real-time web dashboard (requires Bun) |
+| `shipwright dashboard start` | Start dashboard in background |
+| `shipwright heartbeat list` | Show agent heartbeat status |
+| `shipwright checkpoint list` | Show saved pipeline checkpoints |
+| `shipwright remote list` | Show registered machines |
+| `shipwright remote add <name> --host <h>` | Register a remote worker machine |
 
 ## Pipeline Stages
 
@@ -123,3 +129,51 @@ Generate with `shipwright daemon init`, then edit `.claude/daemon-config.json`:
 | `auto_template` | `false` | Pick pipeline template by issue complexity |
 | `max_retries` | `2` | Retry failed pipelines with escalation |
 | `priority_lane` | `false` | Reserve a slot for urgent/hotfix issues |
+
+## Failure Recovery
+
+### When Tests Fail
+
+1. Read the full test output — don't guess at the failure
+2. Identify the failing test and the assertion that broke
+3. Fix the code (not the test, unless the test is wrong)
+4. Re-run the specific failing test first, then the full suite
+5. If the fix touches shared code, check for regressions in related tests
+6. Document what caused the failure in your task update
+
+### When Merge Conflicts Arise
+
+1. Run `git status` to see all conflicted files
+2. Resolve one file at a time — read both versions before choosing
+3. Check `.claude/CLAUDE.md` for project conventions that may affect resolution
+4. After resolving, run the test suite to verify nothing broke
+5. If unsure about a resolution, ask the team lead before committing
+
+### When Context Window Gets Tight
+
+1. The PreCompact hook automatically saves context before compaction
+2. Summarize your progress and next steps before context is lost
+3. Break remaining work into smaller, self-contained tasks
+4. Use `shipwright memory show` to review captured learnings
+5. Focus on completing the current task rather than starting new ones
+
+### When a Pipeline Fails
+
+1. Check the pipeline state: `cat .claude/pipeline-state.md`
+2. Review logs for the failed stage
+3. Fix the issue, then resume: `shipwright pipeline resume`
+4. If the failure is infrastructure-related, use `--worktree` for isolation
+5. Use `shipwright memory show` — previous failures may have relevant fixes
+
+### Recovery Commands
+
+| Command | Purpose |
+|---------|---------|
+| `shipwright pipeline resume` | Resume from last completed stage |
+| `shipwright memory show` | View captured failure patterns |
+| `shipwright doctor` | Diagnose setup issues |
+| `shipwright status` | Check team and agent status |
+| `shipwright cleanup --force` | Kill orphaned sessions |
+| `shipwright worktree create <branch>` | Isolate work in a git worktree |
+| `git stash` | Temporarily save uncommitted changes |
+| `git diff --name-only HEAD~1` | See files changed in last commit |

package/claude-code/hooks/notify-idle.sh

@@ -27,9 +27,9 @@
 set -euo pipefail
 
 if [[ "$(uname)" == "Darwin" ]]; then
-  osascript -e 'display notification "An agent needs your attention" with title "Claude Code Teams" sound name "Ping"'
+  osascript -e 'display notification "An agent needs your attention" with title "Shipwright" sound name "Ping"'
 elif command -v notify-send &>/dev/null; then
-  notify-send "Claude Code Teams" "An agent needs your attention" --urgency=normal
+  notify-send "Shipwright" "An agent needs your attention" --urgency=normal
 fi
 
 exit 0

package/claude-code/hooks/session-start.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# SessionStart hook — inject Shipwright project context at session start
+# Timeout: 5s | Exit: always 0 (never blocks)
+set -euo pipefail
+
+# Only activate in Shipwright-managed projects
+CLAUDE_DIR=".claude"
+[[ -f "$CLAUDE_DIR/pipeline-state.md" || -f "$CLAUDE_DIR/CLAUDE.md" ]] || exit 0
+
+echo "Shipwright project detected."
+
+# Show last pipeline status if available
+if [[ -f "$CLAUDE_DIR/pipeline-state.md" ]]; then
+    echo "Last pipeline status:"
+    head -5 "$CLAUDE_DIR/pipeline-state.md" 2>/dev/null || true
+    echo ""
+fi
+
+# Remind about project conventions
+if [[ -f "$CLAUDE_DIR/CLAUDE.md" ]]; then
+    echo "Project conventions available in .claude/CLAUDE.md"
+fi
+
+exit 0

package/claude-code/hooks/task-completed.sh

@@ -131,8 +131,12 @@ while IFS= read -r file; do
 done <<< "$CHANGED_FILES"
 
 if [[ ${#TEST_FILES[@]} -gt 0 ]]; then
-  # Deduplicate
-  readarray -t TEST_FILES < <(printf '%s\n' "${TEST_FILES[@]}" | sort -u)
+  # Deduplicate (bash 3.2 compatible — no readarray)
+  _deduped=()
+  while IFS= read -r _f; do
+    [[ -n "$_f" ]] && _deduped+=("$_f")
+  done < <(printf '%s\n' "${TEST_FILES[@]}" | sort -u)
+  TEST_FILES=("${_deduped[@]}")
 
   echo "Running ${#TEST_FILES[@]} related test file(s)..."
 

package/claude-code/settings.json.template

@@ -99,6 +99,18 @@
           }
         ]
       }
+    ],
+    // Project context injection at session start
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/session-start.sh",
+            "timeout": 5
+          }
+        ]
+      }
     ]
   },