shipwright-cli 1.7.1 → 1.9.0

package/templates/pipelines/autonomous.json

@@ -8,15 +8,30 @@
   },
   "stages": [
     { "id": "intake", "enabled": true, "gate": "auto", "config": {} },
-    { "id": "plan", "enabled": true, "gate": "auto", "config": { "model": "opus" } },
-    { "id": "design", "enabled": true, "gate": "auto", "config": { "model": "opus" } },
+    {
+      "id": "plan",
+      "enabled": true,
+      "gate": "auto",
+      "config": { "model": "opus" }
+    },
+    {
+      "id": "design",
+      "enabled": true,
+      "gate": "auto",
+      "config": { "model": "opus" }
+    },
     {
       "id": "build",
       "enabled": true,
       "gate": "auto",
       "config": { "max_iterations": 20, "audit": true, "quality_gates": true }
     },
-    { "id": "test", "enabled": true, "gate": "auto", "config": { "coverage_min": 80 } },
+    {
+      "id": "test",
+      "enabled": true,
+      "gate": "auto",
+      "config": { "coverage_min": 80 }
+    },
     { "id": "review", "enabled": true, "gate": "auto", "config": {} },
     {
       "id": "compound_quality",
@@ -30,7 +45,12 @@
         "max_cycles": 3
       }
     },
-    { "id": "pr", "enabled": true, "gate": "auto", "config": { "wait_ci": false } },
+    {
+      "id": "pr",
+      "enabled": true,
+      "gate": "auto",
+      "config": { "wait_ci": false }
+    },
     {
       "id": "merge",
       "enabled": true,
@@ -38,7 +58,9 @@
       "config": {
         "merge_method": "squash",
         "wait_ci_timeout_s": 600,
-        "auto_delete_branch": true
+        "auto_delete_branch": true,
+        "auto_merge": true,
+        "auto_approve": true
       }
     },
     {

package/templates/pipelines/full.json

@@ -66,6 +66,18 @@
       "gate": "approve",
       "config": { "wait_ci": true }
     },
+    {
+      "id": "merge",
+      "enabled": true,
+      "gate": "approve",
+      "config": {
+        "merge_method": "squash",
+        "wait_ci_timeout_s": 600,
+        "auto_delete_branch": true,
+        "auto_merge": false,
+        "auto_approve": false
+      }
+    },
     {
       "id": "deploy",
       "enabled": true,

package/templates/pipelines/standard.json

@@ -53,6 +53,18 @@
       "gate": "approve",
       "config": { "wait_ci": false }
     },
+    {
+      "id": "merge",
+      "enabled": true,
+      "gate": "approve",
+      "config": {
+        "merge_method": "squash",
+        "wait_ci_timeout_s": 600,
+        "auto_delete_branch": true,
+        "auto_merge": true,
+        "auto_approve": true
+      }
+    },
     {
       "id": "deploy",
       "enabled": false,

package/tmux/{claude-teams-overlay.conf → shipwright-overlay.conf}

@@ -1,25 +1,26 @@
 # ╔═══════════════════════════════════════════════════════════════════════════╗
-# ║              CLAUDE CODE TEAMS - TMUX OVERLAY CONFIGURATION                ║
+# ║              SHIPWRIGHT — TMUX OVERLAY CONFIGURATION                       ║
 # ║                                                                            ║
 # ║  This overlay adds agent-aware pane styling and team keybindings to        ║
 # ║  your existing tmux config. It is sourced automatically by tmux.conf       ║
 # ║  but can also be used independently:                                       ║
 # ║                                                                            ║
-# ║    tmux source-file ~/.tmux/claude-teams-overlay.conf                      ║
+# ║    tmux source-file ~/.tmux/shipwright-overlay.conf                        ║
 # ║                                                                            ║
 # ║  What this overlay does:                                                   ║
 # ║    - Shows agent names in pane borders (pane_title)                        ║
 # ║    - Enables aggressive resize for better multi-agent layouts              ║
 # ║    - Adds safety bindings to prevent accidentally killing agent panes      ║
 # ║    - Provides team-specific keybindings for navigation and management      ║
+# ║    - Fixes known Claude Code + tmux compatibility issues                   ║
 # ║                                                                            ║
 # ║  Convention: Each Claude agent pane should set its title on startup via:   ║
 # ║    printf '\033]2;agent-name\033\\'                                        ║
-# ║  The shipwright CLI does this automatically when spawning agent panes.      ║
+# ║  The shipwright CLI does this automatically when spawning agent panes.     ║
 # ╚═══════════════════════════════════════════════════════════════════════════╝
 
 # ═══════════════════════════════════════════════════════════════════════════
-# PANE TITLES - Show agent names in borders
+# PANE TITLES — Show agent names in borders
 # ═══════════════════════════════════════════════════════════════════════════
 
 # Display pane titles at the top of each pane border
@@ -27,10 +28,11 @@ set -g pane-border-status top
 
 # Format: pane index, agent name, running command, zoom indicator
 # Active pane gets cyan accent; inactive stays muted
+# Uses #{pane_title} which each agent sets via OSC 2 escape sequence
 set -g pane-border-format "#{?pane_active,#[fg=#00d4ff]#[bold],#[fg=#71717a]} #P │ #{pane_title} #[fg=#333355]│#[default] #{?pane_active,#[fg=#e4e4e7],#[fg=#52525b]}#{pane_current_command} #{?window_zoomed_flag,#[fg=#facc15]#[bold]🔍 ZOOMED ,}"
 
 # ═══════════════════════════════════════════════════════════════════════════
-# LAYOUT - Optimize for multi-agent pane layouts
+# LAYOUT — Optimize for multi-agent pane layouts
 # ═══════════════════════════════════════════════════════════════════════════
 
 # Aggressive resize: let panes resize independently per client
@@ -46,13 +48,14 @@ set -g window-style 'bg=#1a1a2e,fg=#e4e4e7'
 set -g window-active-style 'bg=#1a1a2e,fg=#e4e4e7'
 
 # Hooks provide belt-and-suspenders coverage: explicitly set per-pane
-# colors whenever a pane is created, preventing white flash on creation
+# colors whenever a pane is created, preventing white flash on creation.
+# Also re-enable allow-passthrough per-pane (some tmux versions reset it).
 set-hook -g after-split-window "select-pane -P 'bg=#1a1a2e,fg=#e4e4e7'"
 set-hook -g after-new-window   "select-pane -P 'bg=#1a1a2e,fg=#e4e4e7'"
 set-hook -g after-new-session  "select-pane -P 'bg=#1a1a2e,fg=#e4e4e7'"
 
 # ═══════════════════════════════════════════════════════════════════════════
-# SAFETY - Confirm before killing agent panes
+# SAFETY — Confirm before killing agent panes
 # ═══════════════════════════════════════════════════════════════════════════
 
 # Override default kill-pane to require confirmation in team windows
@@ -64,12 +67,15 @@ bind X confirm-before -p "Kill ALL panes in window #W? (y/n)" kill-window
 # TEAM NAVIGATION
 # ═══════════════════════════════════════════════════════════════════════════
 
-# prefix + g → select a pane by agent name (uses choose-tree for visual picking)
+# prefix + g → display pane numbers for 5 seconds (type number to select)
 bind g display-panes -d 5000
 
 # prefix + G → toggle zoom on current agent pane (focus on one agent's output)
 bind G resize-pane -Z
 
+# prefix + w → choose window/pane from a tree (visual picker)
+bind w choose-tree -Zw
+
 # ═══════════════════════════════════════════════════════════════════════════
 # TEAM MANAGEMENT
 # ═══════════════════════════════════════════════════════════════════════════
@@ -79,7 +85,6 @@ bind G resize-pane -Z
 bind M-t setw synchronize-panes \; display-message "Team sync #{?synchronize-panes,ON,OFF}"
 
 # prefix + M-l → rotate through even-horizontal, even-vertical, tiled layouts
-# Useful for reorganizing agent panes
 bind M-l next-layout
 
 # prefix + M-s → capture current pane's full scrollback to file
@@ -102,6 +107,19 @@ bind M-1 select-layout main-horizontal \; resize-pane -t 0 -x 65%
 bind M-2 select-layout main-vertical \; resize-pane -t 0 -y 60%
 bind M-3 select-layout tiled
 
+# ═══════════════════════════════════════════════════════════════════════════
+# SHIPWRIGHT POPUPS — Quick access to tools
+# ═══════════════════════════════════════════════════════════════════════════
+
+# prefix + M-d → Shipwright dashboard in floating popup
+bind M-d display-popup -w 85% -h 80% -E "shipwright status 2>/dev/null; echo ''; shipwright ps 2>/dev/null; echo ''; echo 'Press ENTER to close'; read"
+
+# prefix + M-m → Memory system in floating popup
+bind M-m display-popup -w 80% -h 70% -E "shipwright memory show 2>/dev/null || echo 'No memories found'; echo ''; echo 'Press ENTER to close'; read"
+
+# prefix + M-h → Heartbeat status in floating popup
+bind M-h display-popup -w 70% -h 50% -E "shipwright heartbeat list 2>/dev/null || echo 'No active heartbeats'; echo ''; echo 'Press ENTER to close'; read"
+
 # ═══════════════════════════════════════════════════════════════════════════
 # PANE REAPER — Quick cleanup of dead agent panes
 # ═══════════════════════════════════════════════════════════════════════════

package/tmux/templates/accessibility.json

@@ -0,0 +1,34 @@
+{
+  "name": "accessibility",
+  "description": "Accessibility audit and remediation with auditor, fixer, and verifier agents",
+  "keywords": [
+    "accessibility",
+    "a11y",
+    "wcag",
+    "aria",
+    "screen reader",
+    "keyboard",
+    "contrast",
+    "inclusive"
+  ],
+  "agents": [
+    {
+      "name": "auditor",
+      "role": "WCAG 2.1 compliance scanning, keyboard navigation audit, color contrast checks, missing ARIA labels",
+      "focus": "src/components/, apps/web/, *.tsx, *.jsx, *.html"
+    },
+    {
+      "name": "fixer",
+      "role": "Add ARIA labels, fix focus management, improve color contrast, add skip links, semantic HTML",
+      "focus": "src/components/, apps/web/, *.tsx, *.jsx, *.css"
+    },
+    {
+      "name": "verifier",
+      "role": "Accessibility regression tests, screen reader compatibility verification, keyboard-only flow testing",
+      "focus": "*.test.*, __tests__/, e2e/, cypress/"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/api-design.json

@@ -0,0 +1,35 @@
+{
+  "name": "api-design",
+  "description": "API design and implementation with designer, implementer, and consumer agents",
+  "keywords": [
+    "api",
+    "endpoint",
+    "rest",
+    "graphql",
+    "grpc",
+    "openapi",
+    "swagger",
+    "schema",
+    "contract"
+  ],
+  "agents": [
+    {
+      "name": "designer",
+      "role": "Schema design, OpenAPI/GraphQL spec, contract definition, versioning strategy",
+      "focus": "*.yaml, *.graphql, *.proto, docs/api/, openapi/"
+    },
+    {
+      "name": "implementer",
+      "role": "Routes, middleware, validation, serialization, error handling, rate limiting",
+      "focus": "src/api/, src/routes/, src/middleware/, src/controllers/"
+    },
+    {
+      "name": "consumer",
+      "role": "Client SDK, usage examples, integration tests, developer experience validation",
+      "focus": "src/client/, sdk/, examples/, *.test.*, __tests__/"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/architecture.json

@@ -1,6 +1,7 @@
 {
   "name": "architecture",
   "description": "Architecture planning with research and specification agents",
+  "keywords": ["architecture", "design", "structure", "system", "diagram"],
   "agents": [
     {
       "name": "researcher",

package/tmux/templates/bug-fix.json

@@ -1,6 +1,15 @@
 {
   "name": "bug-fix",
   "description": "Bug fix with reproducer, fixer, and verifier agents",
+  "keywords": [
+    "bug",
+    "fix",
+    "error",
+    "crash",
+    "broken",
+    "failing",
+    "regression"
+  ],
   "agents": [
     {
       "name": "reproducer",

package/tmux/templates/code-review.json

@@ -1,6 +1,7 @@
 {
   "name": "code-review",
   "description": "Code review with quality, security, and test coverage agents",
+  "keywords": ["review", "audit", "quality", "check", "pr"],
   "agents": [
     {
       "name": "code-quality",

package/tmux/templates/compliance.json

@@ -0,0 +1,36 @@
+{
+  "name": "compliance",
+  "description": "Regulatory and license compliance with scanning, remediation, and documentation agents",
+  "keywords": [
+    "compliance",
+    "license",
+    "sbom",
+    "gdpr",
+    "hipaa",
+    "sox",
+    "pci",
+    "regulation",
+    "audit",
+    "legal"
+  ],
+  "agents": [
+    {
+      "name": "scanner",
+      "role": "License audit, SBOM generation, dependency risk assessment, known vulnerability scanning, policy violation detection",
+      "focus": "package.json, go.mod, Cargo.toml, *.lock, requirements.txt, LICENSE"
+    },
+    {
+      "name": "remediator",
+      "role": "Replace problematic dependencies, add required license notices, fix policy violations, update to compliant versions",
+      "focus": "src/, lib/, package.json, go.mod, LICENSE, NOTICE"
+    },
+    {
+      "name": "documenter",
+      "role": "Compliance reports, audit trail documentation, data flow diagrams, privacy impact assessments, policy documentation",
+      "focus": "docs/, compliance/, *.md, SECURITY.md, PRIVACY.md"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/data-pipeline.json

@@ -0,0 +1,36 @@
+{
+  "name": "data-pipeline",
+  "description": "Data engineering with extract, transform, and load agents",
+  "keywords": [
+    "data",
+    "pipeline",
+    "etl",
+    "elt",
+    "ingestion",
+    "warehouse",
+    "lake",
+    "batch",
+    "stream",
+    "sql"
+  ],
+  "agents": [
+    {
+      "name": "extractor",
+      "role": "Source connectors, ingestion logic, schema mapping, incremental extraction, change data capture",
+      "focus": "src/extract/, src/connectors/, src/sources/, config/"
+    },
+    {
+      "name": "transformer",
+      "role": "Business logic, data cleaning, aggregation, validation rules, data quality checks",
+      "focus": "src/transform/, src/models/, src/validators/, sql/, dbt/"
+    },
+    {
+      "name": "loader",
+      "role": "Sink connectors, idempotent writes, partitioning, monitoring, schema evolution handling",
+      "focus": "src/load/, src/sinks/, src/destinations/, *.test.*"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/debt-paydown.json

@@ -0,0 +1,34 @@
+{
+  "name": "debt-paydown",
+  "description": "Technical debt reduction with analysis, refactoring, and verification agents",
+  "keywords": [
+    "debt",
+    "tech debt",
+    "technical debt",
+    "cleanup",
+    "legacy",
+    "modernize",
+    "deprecate",
+    "upgrade deps"
+  ],
+  "agents": [
+    {
+      "name": "analyzer",
+      "role": "Identify debt hotspots — cyclomatic complexity, code churn, tight coupling, outdated dependencies, dead code",
+      "focus": "src/, lib/, package.json, go.mod, *.lock"
+    },
+    {
+      "name": "refactorer",
+      "role": "Systematic cleanup while preserving test coverage. Upgrade dependencies, remove dead code, simplify abstractions.",
+      "focus": "src/, lib/, apps/"
+    },
+    {
+      "name": "reviewer",
+      "role": "Verify behavior preservation — no regressions, measurable complexity reduction, test coverage maintained or improved",
+      "focus": "*.test.*, __tests__/, *.spec.*"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/devops.json

@@ -1,6 +1,7 @@
 {
   "name": "devops",
   "description": "DevOps with CI/CD pipeline and infrastructure agents",
+  "keywords": ["devops", "deploy", "ci", "cd", "infrastructure", "docker"],
   "agents": [
     {
       "name": "pipeline",

package/tmux/templates/documentation.json

@@ -1,6 +1,7 @@
 {
   "name": "documentation",
   "description": "Documentation with API docs and user guide agents",
+  "keywords": ["doc", "readme", "guide", "tutorial", "api doc"],
   "agents": [
     {
       "name": "api-docs",

package/tmux/templates/exploration.json

@@ -1,6 +1,7 @@
 {
   "name": "exploration",
   "description": "Codebase exploration with one agent researching and one synthesizing",
+  "keywords": ["explore", "research", "investigate", "understand", "analyze"],
   "agents": [
     {
       "name": "explorer",

package/tmux/templates/feature-dev.json

@@ -1,6 +1,7 @@
 {
   "name": "feature-dev",
   "description": "Feature development with backend, frontend, and tests agents",
+  "keywords": ["feature", "implement", "build", "create", "add", "new"],
   "agents": [
     {
       "name": "backend",

package/tmux/templates/full-stack.json

@@ -1,6 +1,14 @@
 {
   "name": "full-stack",
   "description": "Full-stack development with API, database, and UI agents",
+  "keywords": [
+    "fullstack",
+    "full-stack",
+    "end-to-end",
+    "api",
+    "database",
+    "frontend"
+  ],
   "agents": [
     {
       "name": "api",

package/tmux/templates/i18n.json

@@ -0,0 +1,34 @@
+{
+  "name": "i18n",
+  "description": "Internationalization with extraction, translation setup, and verification agents",
+  "keywords": [
+    "i18n",
+    "internationalization",
+    "localization",
+    "l10n",
+    "translate",
+    "language",
+    "locale",
+    "rtl"
+  ],
+  "agents": [
+    {
+      "name": "extractor",
+      "role": "Find hardcoded strings, extract to resource bundles, set up i18n framework, create translation key conventions",
+      "focus": "src/components/, apps/, *.tsx, *.jsx, *.vue, *.html"
+    },
+    {
+      "name": "translator",
+      "role": "Generate translation keys, set up plural rules, handle date/number/currency formats, RTL layout considerations",
+      "focus": "src/locales/, src/i18n/, translations/, *.json, *.yaml"
+    },
+    {
+      "name": "verifier",
+      "role": "Check string truncation, layout breakage, format consistency, missing translations, pseudo-localization testing",
+      "focus": "*.test.*, __tests__/, src/components/, e2e/"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/incident-response.json

@@ -0,0 +1,36 @@
+{
+  "name": "incident-response",
+  "description": "Production incident response with investigation, fix, and postmortem agents",
+  "keywords": [
+    "incident",
+    "outage",
+    "down",
+    "production",
+    "hotfix",
+    "urgent",
+    "pager",
+    "alert",
+    "sev1",
+    "sev2"
+  ],
+  "agents": [
+    {
+      "name": "investigator",
+      "role": "Trace logs, metrics, and error paths to identify root cause. Narrow the blast radius.",
+      "focus": "src/, logs/, config/, *.log"
+    },
+    {
+      "name": "fixer",
+      "role": "Implement minimal hotfix with smallest possible blast radius. Prioritize speed and safety.",
+      "focus": "src/, lib/, apps/"
+    },
+    {
+      "name": "postmortem",
+      "role": "Write incident report, create follow-up issues, add monitoring and alerting to prevent recurrence",
+      "focus": "docs/, *.md, src/monitoring/, src/alerts/"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/migration.json

@@ -1,6 +1,7 @@
 {
   "name": "migration",
   "description": "Data/schema migration with schema, code adaptation, and rollback agents",
+  "keywords": ["migrate", "upgrade", "port", "convert", "move"],
   "agents": [
     {
       "name": "schema",

package/tmux/templates/observability.json

@@ -0,0 +1,35 @@
+{
+  "name": "observability",
+  "description": "Monitoring and observability setup with instrumentation, dashboards, and validation agents",
+  "keywords": [
+    "monitoring",
+    "observability",
+    "metrics",
+    "tracing",
+    "logging",
+    "alerting",
+    "grafana",
+    "datadog",
+    "slo"
+  ],
+  "agents": [
+    {
+      "name": "instrumenter",
+      "role": "Add metrics, distributed traces, structured logging, health checks, SLI definitions",
+      "focus": "src/, lib/, src/middleware/, src/instrumentation/"
+    },
+    {
+      "name": "dashboarder",
+      "role": "Dashboard definitions, alert rules, SLO configurations, runbook templates, on-call documentation",
+      "focus": "monitoring/, dashboards/, alerts/, docs/, config/"
+    },
+    {
+      "name": "validator",
+      "role": "Verify alerts fire correctly, test runbooks, validate metric cardinality, load test instrumentation",
+      "focus": "*.test.*, scripts/, monitoring/tests/"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/onboarding.json

@@ -0,0 +1,33 @@
+{
+  "name": "onboarding",
+  "description": "Developer experience and onboarding improvement with audit, fix, and verification agents",
+  "keywords": [
+    "onboarding",
+    "developer experience",
+    "dx",
+    "setup",
+    "getting started",
+    "contribute",
+    "new developer"
+  ],
+  "agents": [
+    {
+      "name": "auditor",
+      "role": "Try setup from scratch — clone, install, run, test. Identify friction, missing docs, confusing errors, time each step.",
+      "focus": "README.md, CONTRIBUTING.md, Makefile, docker-compose.yml, scripts/"
+    },
+    {
+      "name": "improver",
+      "role": "Fix setup scripts, add missing documentation, improve error messages, create quick-start guide",
+      "focus": "scripts/, docs/, README.md, CONTRIBUTING.md, Makefile, *.md"
+    },
+    {
+      "name": "tester",
+      "role": "Verify the improved flow works from a fresh environment. Test on different OS assumptions, check idempotency.",
+      "focus": "scripts/, Makefile, docker-compose.yml, *.test.*"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/performance.json

@@ -0,0 +1,35 @@
+{
+  "name": "performance",
+  "description": "Performance optimization with profiling, optimization, and validation agents",
+  "keywords": [
+    "performance",
+    "slow",
+    "optimize",
+    "benchmark",
+    "profile",
+    "latency",
+    "throughput",
+    "cache",
+    "speed"
+  ],
+  "agents": [
+    {
+      "name": "profiler",
+      "role": "Benchmark endpoints and functions, identify bottlenecks, generate flame graphs and timing data",
+      "focus": "*.bench.*, *.perf.*, scripts/"
+    },
+    {
+      "name": "optimizer",
+      "role": "Implement performance fixes — query optimization, caching, lazy loading, algorithm improvements",
+      "focus": "src/, lib/, apps/"
+    },
+    {
+      "name": "validator",
+      "role": "Before/after benchmarks, regression prevention tests, verify no behavior changes",
+      "focus": "*.test.*, *.bench.*, __tests__/"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}