shipwright-cli 1.7.1 → 1.10.0

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
+}

package/tmux/templates/refactor.json

@@ -1,6 +1,7 @@
 {
   "name": "refactor",
   "description": "Refactoring with one agent for changes and one for consumers/tests",
+  "keywords": ["refactor", "cleanup", "simplify", "reorganize", "optimize"],
   "agents": [
     {
       "name": "refactor",

package/tmux/templates/release.json

@@ -0,0 +1,35 @@
+{
+  "name": "release",
+  "description": "Release management with preparation, validation, and announcement agents",
+  "keywords": [
+    "release",
+    "version",
+    "publish",
+    "changelog",
+    "tag",
+    "package",
+    "ship",
+    "launch",
+    "npm publish"
+  ],
+  "agents": [
+    {
+      "name": "preparer",
+      "role": "Changelog generation, version bumps, dependency audit, license check, breaking change detection",
+      "focus": "package.json, CHANGELOG.md, Cargo.toml, go.mod, *.lock, version.*"
+    },
+    {
+      "name": "validator",
+      "role": "Full test suite, smoke tests, canary checks, rollback verification, binary/package size check",
+      "focus": "*.test.*, scripts/, e2e/, *.spec.*"
+    },
+    {
+      "name": "announcer",
+      "role": "Release notes, migration guide, deprecation notices, upgrade instructions, API diff summary",
+      "focus": "docs/, *.md, CHANGELOG.md, MIGRATION.md, UPGRADING.md"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/security-audit.json

@@ -1,6 +1,14 @@
 {
   "name": "security-audit",
   "description": "Security audit with code analysis, dependency scanning, and config review agents",
+  "keywords": [
+    "security",
+    "vulnerability",
+    "xss",
+    "injection",
+    "auth",
+    "patch"
+  ],
   "agents": [
     {
       "name": "code-analysis",

package/tmux/templates/spike.json

@@ -0,0 +1,34 @@
+{
+  "name": "spike",
+  "description": "Proof of concept and technical spike with researcher, prototyper, and evaluator agents",
+  "keywords": [
+    "spike",
+    "poc",
+    "proof of concept",
+    "prototype",
+    "experiment",
+    "evaluate",
+    "feasibility",
+    "compare"
+  ],
+  "agents": [
+    {
+      "name": "researcher",
+      "role": "Evaluate libraries, APIs, and approaches. Compare trade-offs, licensing, maintenance status, community support.",
+      "focus": "docs/, package.json, go.mod, Cargo.toml, requirements.txt"
+    },
+    {
+      "name": "prototyper",
+      "role": "Build minimal working prototype. Throwaway code is fine — optimize for speed of learning, not production quality.",
+      "focus": "spike/, prototype/, src/"
+    },
+    {
+      "name": "evaluator",
+      "role": "Write decision document with recommendation, risks, migration path, and effort estimate. Zero attachment to the prototype.",
+      "focus": "docs/, *.md, spike/"
+    }
+  ],
+  "layout": "tiled",
+  "layout_style": "main-horizontal",
+  "main_pane_percent": 65
+}

package/tmux/templates/testing.json

@@ -1,6 +1,7 @@
 {
   "name": "testing",
   "description": "Comprehensive testing with unit, integration, and e2e agents",
+  "keywords": ["test", "coverage", "unit", "integration", "e2e", "spec"],
   "agents": [
     {
       "name": "unit-tests",

package/tmux/tmux.conf

@@ -1,6 +1,6 @@
 # ╔═══════════════════════════════════════════════════════════════════════════╗
 # ║                           TMUX CONFIGURATION                               ║
-# ║                        Premium Developer Theme                             ║
+# ║                     Shipwright — Optimized for Claude Code                 ║
 # ╚═══════════════════════════════════════════════════════════════════════════╝
 
 # ═══════════════════════════════════════════════════════════════════════════
@@ -8,16 +8,63 @@
 # ═══════════════════════════════════════════════════════════════════════════
 
 set -g default-terminal "tmux-256color"
+
+# ─── Terminal-specific overrides ────────────────────────────────────────
+# True color + italics for modern terminals
 set -ag terminal-overrides ",xterm-256color:RGB"
+set -ag terminal-overrides ",xterm-256color:Tc"
+set -ag terminal-overrides ",iTerm2*:RGB:Tc"
+# Ghostty, kitty, WezTerm, Alacritty true color
+set -ag terminal-overrides ",xterm-ghostty:RGB:Tc"
+set -ag terminal-overrides ",xterm-kitty:RGB:Tc"
+set -ag terminal-overrides ",wezterm:RGB:Tc"
+set -ag terminal-overrides ",alacritty:RGB:Tc"
+# Styled underline (curly, dotted, dashed)
+set -ag terminal-overrides ",*:Smulx=\\E[4::%p1%dm"
+set -ag terminal-overrides ",*:Setulc=\\E[58::2::%p1%{65536}%/%d::%p1%{256}%/%{255}%&%d::%p1%{255}%&%d%;m"
+# Terminal.app: 256 color only, basic mouse
+set -ag terminal-overrides ",Apple_Terminal*:colors=256"
+
+# ─── Claude Code TUI Compatibility ────────────────────────────────────
+# Passthrough: enables DEC 2026 synchronized output (eliminates flicker),
+# OSC 52 clipboard, OSC notifications, and image protocols.
+# Critical for Claude Code's rapid TUI updates inside tmux.
+set -g allow-passthrough on
+
+# Extended keys: lets TUI apps (Claude Code, vim, etc.) receive modifier
+# key combos that plain terminals would swallow (Ctrl+Shift+key, etc.)
+set -g extended-keys on
+set -as terminal-features 'xterm*:extkeys'
+
+# ─── Mouse ──────────────────────────────────────────────────────────────
 set -g mouse on
+# Fix: tmux 3.4+ defaults MouseDown1Status to switch-client (sessions),
+# but we want select-window so clicking status bar windows actually works
+bind -T root MouseDown1Status select-window -t =
+# Double-click on status bar word to rename window
+bind -T root DoubleClick1Status command-prompt -I "#W" "rename-window -- '%%'"
+
+# ─── Core Behavior ─────────────────────────────────────────────────────
 set -g base-index 1
 setw -g pane-base-index 1
 set -g renumber-windows on
-set -g history-limit 50000
 set -sg escape-time 0
 set -g focus-events on
 setw -g monitor-activity on
 set -g visual-activity off
+# Display messages for 3 seconds (default 750ms is too fast)
+set -g display-time 3000
+# Display pane indicators for 2 seconds
+set -g display-panes-time 2000
+# Smoother repeated key operations (600ms window)
+set -g repeat-time 600
+# Clipboard: native OSC 52 — copies work across SSH + tmux nesting
+set -g set-clipboard on
+
+# ─── History ───────────────────────────────────────────────────────────
+# Claude Code generates 4,000-6,700 scroll events/sec during streaming.
+# 250k lines prevents buffer exhaustion during long agent runs.
+set -g history-limit 250000
 
 # ═══════════════════════════════════════════════════════════════════════════
 # STATUS BAR CONFIGURATION
@@ -35,14 +82,12 @@ set -g status-left "#[fg=#1e1e32,bg=#00d4ff,bold]  #S #[fg=#00d4ff,bg=#0066ff]#[
 
 setw -g window-status-separator " "
 # Inactive windows; team windows (claude-*) get a λ icon
-# NOTE: use separate #[fg=]#[bg=] blocks — commas inside #{?} branches break parsing
 setw -g window-status-format "#{?#{m:claude-*,#W},#[fg=#7c3aed]#[bg=#252538] λ #I:#W ,#[fg=#71717a]#[bg=#252538] #I:#W }#[fg=#252538]#[bg=#1a1a2e]"
 # Active window; team windows get λ icon in cyan
 setw -g window-status-current-format "#{?#{m:claude-*,#W},#[fg=#1e1e32]#[bg=#00d4ff]#[bold] λ #I:#W ,#[fg=#1e1e32]#[bg=#00d4ff]#[bold] #I:#W }#[fg=#00d4ff]#[bg=#1a1a2e]"
 
-# Right side: normal info OR key hints when prefix is active
-# NOTE: use separate #[fg=]#[bg=] blocks — commas inside #{?} branches break parsing
-set -g status-right "#{?client_prefix,#[fg=#1e1e32]#[bg=#0066ff]#[bold] T team  | split  - split  hjkl nav  G zoom  S sync  x kill #[fg=#1e1e32]#[bg=#00d4ff]#[bold] ^a ,#[fg=#71717a]#[bg=#252538] #(whoami)@#h #[fg=#1e1e32]#[bg=#7c3aed]#[bold]  %H:%M #[fg=#e4e4e7]#[bg=#0066ff]#[bold]  %b %d #[fg=#1e1e32]#[bg=#00d4ff]#[bold]  %a }"
+# Right side: key hints when prefix is active, otherwise clock + date
+set -g status-right "#{?client_prefix,#[fg=#1e1e32]#[bg=#0066ff]#[bold] T team  | split  - split  hjkl nav  G zoom  S sync  x kill  F fzf #[fg=#1e1e32]#[bg=#00d4ff]#[bold] ^a ,#[fg=#71717a]#[bg=#252538] #(whoami)@#h #[fg=#1e1e32]#[bg=#7c3aed]#[bold]  %H:%M #[fg=#e4e4e7]#[bg=#0066ff]#[bold]  %b %d #[fg=#1e1e32]#[bg=#00d4ff]#[bold]  %a }"
 
 # ═══════════════════════════════════════════════════════════════════════════
 # PANE STYLING
@@ -52,9 +97,16 @@ set -g window-style 'bg=#1a1a2e,fg=#e4e4e7'
 set -g window-active-style 'bg=#1a1a2e,fg=#e4e4e7'
 set -g pane-border-style "fg=#333355,bg=#1a1a2e"
 set -g pane-active-border-style "fg=#00d4ff,bg=#1a1a2e"
+# Heavy pane border lines for better visibility (tmux 3.2+)
+set -g pane-border-lines heavy
 set -g display-panes-colour "#333355"
 set -g display-panes-active-colour "#00d4ff"
 
+# ─── Popup Styling (tmux 3.3+) ─────────────────────────────────────────
+set -gq popup-style 'bg=#252538'
+set -gq popup-border-style 'fg=#00d4ff'
+set -gq popup-border-lines rounded
+
 # ═══════════════════════════════════════════════════════════════════════════
 # MESSAGE STYLING
 # ═══════════════════════════════════════════════════════════════════════════
@@ -139,23 +191,54 @@ bind s choose-tree -sZ -O name
 bind N new-session
 
 # ═══════════════════════════════════════════════════════════════════════════
-# PLUGINS (via TPM - optional)
+# FLOATING POPUP TERMINALS (tmux 3.2+)
+# ═══════════════════════════════════════════════════════════════════════════
+
+# prefix + F → floating popup terminal in current directory
+bind F display-popup -E -w 80% -h 75% -d "#{pane_current_path}"
+
+# prefix + C-f → FZF session/window switcher in a popup
+bind C-f display-popup -E -w 60% -h 50% "\
+  tmux list-sessions -F '#{session_name}' | \
+  fzf --reverse --header='Switch session' | \
+  xargs -I{} tmux switch-client -t {}"
+
+# ═══════════════════════════════════════════════════════════════════════════
+# PLUGINS (via TPM)
 # ═══════════════════════════════════════════════════════════════════════════
 
 set -g @plugin 'tmux-plugins/tpm'
 set -g @plugin 'tmux-plugins/tmux-sensible'
 set -g @plugin 'tmux-plugins/tmux-resurrect'
 set -g @plugin 'tmux-plugins/tmux-continuum'
+set -g @plugin 'tmux-plugins/tmux-yank'
+set -g @plugin 'sainnhe/tmux-fzf'
+
+# ─── Plugin Configuration ──────────────────────────────────────────────
 
+# Resurrect: persist full pane content + programs
 set -g @resurrect-capture-pane-contents 'on'
+set -g @resurrect-strategy-nvim 'session'
+
+# Continuum: auto-save every 15 min, auto-restore on tmux start
 set -g @continuum-restore 'on'
+set -g @continuum-save-interval '15'
+
+# Yank: use system clipboard, stay in copy mode after yanking
+set -g @yank_selection_mouse 'clipboard'
+set -g @yank_action 'copy-pipe'
+
+# FZF: use popup window (tmux 3.2+), Shipwright color scheme
+set -g @tmux-fzf-launch-key 'C-f'
+TMUX_FZF_OPTIONS="-p -w 60% -h 50%"
+TMUX_FZF_PREVIEW=0
 
 # ═══════════════════════════════════════════════════════════════════════════
-# CLAUDE CODE TEAMS INTEGRATION
+# SHIPWRIGHT INTEGRATION
 # ═══════════════════════════════════════════════════════════════════════════
 
 # Source teams overlay (agent pane styling, keybindings)
-source-file -q ~/.tmux/claude-teams-overlay.conf
+source-file -q ~/.tmux/shipwright-overlay.conf
 
 # Quick launch: prefix + T → start a Claude team session
 bind T run-shell "shipwright session"
@@ -163,5 +246,11 @@ bind T run-shell "shipwright session"
 # Quick status: prefix + C-t → show team dashboard in floating popup
 bind C-t display-popup -w 80% -h 70% -E "shipwright status; echo ''; echo 'Press ENTER to close'; read"
 
+# Quick logs: prefix + C-l → tail agent logs in popup
+bind M-L display-popup -w 85% -h 80% -E "shipwright logs --follow 2>/dev/null || echo 'No active logs'; echo ''; echo 'Press ENTER to close'; read"
+
+# Quick cost: prefix + C-c → cost dashboard in popup
+bind M-C display-popup -w 70% -h 60% -E "shipwright cost show 2>/dev/null || echo 'Cost tracking not configured'; echo ''; echo 'Press ENTER to close'; read"
+
 # Initialize TPM (keep at very bottom)
 run-shell '~/.tmux/plugins/tpm/tpm'