shipwright-cli 2.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (113) hide show
  1. package/README.md +160 -72
  2. package/completions/_shipwright +59 -7
  3. package/completions/shipwright.bash +24 -4
  4. package/completions/shipwright.fish +80 -2
  5. package/dashboard/server.ts +208 -0
  6. package/docs/tmux-research/TMUX-ARCHITECTURE.md +567 -0
  7. package/docs/tmux-research/TMUX-AUDIT.md +925 -0
  8. package/docs/tmux-research/TMUX-BEST-PRACTICES-2025-2026.md +829 -0
  9. package/docs/tmux-research/TMUX-QUICK-REFERENCE.md +543 -0
  10. package/docs/tmux-research/TMUX-RESEARCH-INDEX.md +438 -0
  11. package/package.json +2 -2
  12. package/scripts/lib/helpers.sh +7 -0
  13. package/scripts/sw +116 -2
  14. package/scripts/sw-activity.sh +1 -1
  15. package/scripts/sw-adaptive.sh +1 -1
  16. package/scripts/sw-adversarial.sh +1 -1
  17. package/scripts/sw-architecture-enforcer.sh +1 -1
  18. package/scripts/sw-auth.sh +1 -1
  19. package/scripts/sw-autonomous.sh +128 -38
  20. package/scripts/sw-changelog.sh +1 -1
  21. package/scripts/sw-checkpoint.sh +1 -1
  22. package/scripts/sw-ci.sh +1 -1
  23. package/scripts/sw-cleanup.sh +1 -1
  24. package/scripts/sw-code-review.sh +62 -1
  25. package/scripts/sw-connect.sh +1 -1
  26. package/scripts/sw-context.sh +1 -1
  27. package/scripts/sw-cost.sh +44 -3
  28. package/scripts/sw-daemon.sh +155 -27
  29. package/scripts/sw-dashboard.sh +1 -1
  30. package/scripts/sw-db.sh +958 -118
  31. package/scripts/sw-decompose.sh +1 -1
  32. package/scripts/sw-deps.sh +1 -1
  33. package/scripts/sw-developer-simulation.sh +1 -1
  34. package/scripts/sw-discovery.sh +1 -1
  35. package/scripts/sw-docs-agent.sh +1 -1
  36. package/scripts/sw-docs.sh +1 -1
  37. package/scripts/sw-doctor.sh +49 -1
  38. package/scripts/sw-dora.sh +1 -1
  39. package/scripts/sw-durable.sh +1 -1
  40. package/scripts/sw-e2e-orchestrator.sh +1 -1
  41. package/scripts/sw-eventbus.sh +1 -1
  42. package/scripts/sw-feedback.sh +23 -15
  43. package/scripts/sw-fix.sh +1 -1
  44. package/scripts/sw-fleet-discover.sh +1 -1
  45. package/scripts/sw-fleet-viz.sh +1 -1
  46. package/scripts/sw-fleet.sh +1 -1
  47. package/scripts/sw-github-app.sh +1 -1
  48. package/scripts/sw-github-checks.sh +4 -4
  49. package/scripts/sw-github-deploy.sh +1 -1
  50. package/scripts/sw-github-graphql.sh +1 -1
  51. package/scripts/sw-guild.sh +1 -1
  52. package/scripts/sw-heartbeat.sh +1 -1
  53. package/scripts/sw-hygiene.sh +1 -1
  54. package/scripts/sw-incident.sh +45 -6
  55. package/scripts/sw-init.sh +150 -24
  56. package/scripts/sw-instrument.sh +1 -1
  57. package/scripts/sw-intelligence.sh +1 -1
  58. package/scripts/sw-jira.sh +1 -1
  59. package/scripts/sw-launchd.sh +1 -1
  60. package/scripts/sw-linear.sh +1 -1
  61. package/scripts/sw-logs.sh +1 -1
  62. package/scripts/sw-loop.sh +204 -19
  63. package/scripts/sw-memory.sh +18 -1
  64. package/scripts/sw-mission-control.sh +1 -1
  65. package/scripts/sw-model-router.sh +1 -1
  66. package/scripts/sw-otel.sh +1 -1
  67. package/scripts/sw-oversight.sh +76 -1
  68. package/scripts/sw-pipeline-composer.sh +1 -1
  69. package/scripts/sw-pipeline-vitals.sh +1 -1
  70. package/scripts/sw-pipeline.sh +261 -12
  71. package/scripts/sw-pm.sh +70 -5
  72. package/scripts/sw-pr-lifecycle.sh +1 -1
  73. package/scripts/sw-predictive.sh +8 -1
  74. package/scripts/sw-prep.sh +1 -1
  75. package/scripts/sw-ps.sh +1 -1
  76. package/scripts/sw-public-dashboard.sh +1 -1
  77. package/scripts/sw-quality.sh +1 -1
  78. package/scripts/sw-reaper.sh +1 -1
  79. package/scripts/sw-recruit.sh +1853 -178
  80. package/scripts/sw-regression.sh +1 -1
  81. package/scripts/sw-release-manager.sh +1 -1
  82. package/scripts/sw-release.sh +1 -1
  83. package/scripts/sw-remote.sh +1 -1
  84. package/scripts/sw-replay.sh +1 -1
  85. package/scripts/sw-retro.sh +1 -1
  86. package/scripts/sw-scale.sh +1 -1
  87. package/scripts/sw-security-audit.sh +1 -1
  88. package/scripts/sw-self-optimize.sh +1 -1
  89. package/scripts/sw-session.sh +1 -1
  90. package/scripts/sw-setup.sh +263 -127
  91. package/scripts/sw-standup.sh +1 -1
  92. package/scripts/sw-status.sh +44 -2
  93. package/scripts/sw-strategic.sh +189 -41
  94. package/scripts/sw-stream.sh +1 -1
  95. package/scripts/sw-swarm.sh +42 -5
  96. package/scripts/sw-team-stages.sh +1 -1
  97. package/scripts/sw-templates.sh +4 -4
  98. package/scripts/sw-testgen.sh +66 -15
  99. package/scripts/sw-tmux-pipeline.sh +1 -1
  100. package/scripts/sw-tmux-role-color.sh +58 -0
  101. package/scripts/sw-tmux-status.sh +128 -0
  102. package/scripts/sw-tmux.sh +1 -1
  103. package/scripts/sw-trace.sh +1 -1
  104. package/scripts/sw-tracker.sh +1 -1
  105. package/scripts/sw-triage.sh +61 -37
  106. package/scripts/sw-upgrade.sh +1 -1
  107. package/scripts/sw-ux.sh +1 -1
  108. package/scripts/sw-webhook.sh +1 -1
  109. package/scripts/sw-widgets.sh +1 -1
  110. package/scripts/sw-worktree.sh +1 -1
  111. package/templates/pipelines/autonomous.json +2 -2
  112. package/tmux/shipwright-overlay.conf +35 -17
  113. package/tmux/tmux.conf +23 -21
package/README.md CHANGED
@@ -6,14 +6,14 @@
6
6
 
7
7
  <p align="center">
8
8
  <strong>The Autonomous Delivery Platform</strong><br>
9
- From labeled GitHub issue to merged PR — zero human intervention.
9
+ From labeled GitHub issue to merged PR — with 18 new autonomous agents orchestrating every step.
10
10
  </p>
11
11
 
12
12
  <p align="center">
13
13
  <a href="https://github.com/sethdford/shipwright/actions/workflows/test.yml"><img src="https://github.com/sethdford/shipwright/actions/workflows/test.yml/badge.svg" alt="Tests"></a>
14
14
  <a href="https://github.com/sethdford/shipwright/actions/workflows/shipwright-pipeline.yml"><img src="https://github.com/sethdford/shipwright/actions/workflows/shipwright-pipeline.yml/badge.svg" alt="Pipeline"></a>
15
- <img src="https://img.shields.io/badge/tests-450%2B_passing-4ade80?style=flat-square" alt="450+ tests">
16
- <img src="https://img.shields.io/badge/version-1.12.0-00d4ff?style=flat-square" alt="v1.12.0">
15
+ <img src="https://img.shields.io/badge/tests-500%2B_passing-4ade80?style=flat-square" alt="500+ tests">
16
+ <img src="https://img.shields.io/badge/version-2.1.0-00d4ff?style=flat-square" alt="v2.1.0">
17
17
  <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT License">
18
18
  <img src="https://img.shields.io/badge/bash-3.2%2B-7c3aed?style=flat-square" alt="Bash 3.2+">
19
19
  </p>
@@ -28,17 +28,19 @@ This repo uses Shipwright to process its own issues. Label a GitHub issue with `
28
28
 
29
29
  ---
30
30
 
31
- ## What's New
31
+ ## What's New in v2.1.0
32
32
 
33
- **v1.13.0** brings faster feedback loops and lower operational overhead:
33
+ **tmux visual overhaul** role-colored borders, pipeline status widgets, and active pane depth:
34
34
 
35
- - **Webhook receiver** — Zero-latency issue processing (no more polling)
36
- - **PR lifecycle automation** — Auto-review, merge, cleanup reduces manual toil
37
- - **Fleet auto-discovery** — Populate fleet config from GitHub org in one command
38
- - **SQLite persistence** — ACID-safe state, crash recovery, transactional safety
39
- - **Issue decomposition**AI-split complex features into manageable subtasks
40
- - **systemd support** — Cross-platform process supervision (Linux + macOS)
41
- - **Context engine** — Rich context injection for smarter pipeline decisions
35
+ - **Role-Colored Pane Borders** — Border color reflects agent role (builder=blue, reviewer=orange, tester=yellow)
36
+ - **Pipeline Stage Badge** — Live `⚙ BUILD` / `⚡ TEST` / `↑ PR` widget in status bar with stage-colored badges
37
+ - **Active Pane Lift** — Subtle background depth effect between active and inactive panes
38
+ - **Agent Count Widget** — `λN` heartbeat-based agent counter in status bar
39
+ - **`shipwright init --repair`** Force clean reinstall after OS upgrades
40
+ - **Color Palette Overhaul** — Warm grays replace harsh near-white text across all tmux chrome
41
+ - **7 tmux Bug Fixes** — Pane indexing, capture bindings, reload, clipboard, and more
42
+
43
+ **v2.0.0 highlights**: 18 autonomous agents, 100+ CLI commands, intelligence layer, multi-repo fleet, local mode
42
44
 
43
45
  ---
44
46
 
@@ -115,23 +117,65 @@ shipwright doctor
115
117
  # One-command setup
116
118
  shipwright init
117
119
 
120
+ # See what's running
121
+ shipwright status
122
+
118
123
  # Process a GitHub issue end-to-end
119
124
  shipwright pipeline start --issue 42
120
125
 
121
- # Watch GitHub and build autonomously 24/7
126
+ # Run daemon 24/7 with agent orchestration
122
127
  shipwright daemon start --detach
123
128
 
124
- # Spin up a 3-agent team for manual work
129
+ # See live agent activity
130
+ shipwright activity
131
+
132
+ # Spin up agent team for manual work
125
133
  shipwright session my-feature -t feature-dev
126
134
 
135
+ # View DORA metrics and pipeline vitals
136
+ shipwright dora
137
+
127
138
  # Continuous build loop with test validation
128
139
  shipwright loop "Build auth module" --test-cmd "npm test"
140
+
141
+ # Multi-repo operations
142
+ shipwright fleet start
143
+ shipwright fix "upgrade deps" --repos ~/a,~/b,~/c
144
+
145
+ # Release automation
146
+ shipwright release --version 2.1.0
147
+ shipwright changelog generate
129
148
  ```
130
149
 
131
150
  ---
132
151
 
133
152
  ## Features
134
153
 
154
+ ### 18 Autonomous Agents
155
+
156
+ Wave 1 (Organizational):
157
+
158
+ - **Swarm Manager** — Orchestrates dynamic agent teams with specialization roles
159
+ - **Autonomous PM** — Team leadership, task scheduling, roadmap execution
160
+ - **Knowledge Guild** — Cross-team learning, pattern capture, mentorship
161
+ - **Recruitment System** — Talent acquisition and team composition
162
+ - **Standup Automaton** — Daily standups, progress tracking, blocker detection
163
+
164
+ Wave 2 (Operational Backbone):
165
+
166
+ - **Quality Oversight** — Intelligent audits, zero-defect gates, completeness verification
167
+ - **Strategic Agent** — Long-term planning, goal decomposition, roadmap intelligence
168
+ - **Code Reviewer** — Architecture analysis, clean code standards, best practices
169
+ - **Security Auditor** — Vulnerability detection, threat modeling, compliance
170
+ - **Test Generator** — Coverage analysis, scenario discovery, regression prevention
171
+ - **Incident Commander** — Autonomous triage, root cause analysis, resolution
172
+ - **Dependency Manager** — Semantic versioning, update orchestration, compatibility checking
173
+ - **Release Manager** — Release planning, changelog generation, deployment orchestration
174
+ - **Adaptive Tuner** — DORA metrics analysis, self-optimization, performance tuning
175
+ - **Strategic Intelligence** — Predictive analysis, trend detection, proactive recommendations
176
+
177
+ Plus 10+ specialized agents for observability, UX, documentation, and more.
178
+
135
179
  ### 12-Stage Delivery Pipeline
136
180
 
137
181
  ```
@@ -286,47 +330,52 @@ Rich context injection for pipeline stages. Pulls together: contributor history,
286
330
 
287
331
  ## Commands
288
332
 
289
- | Command | Purpose |
290
- | ----------------------------------------- | ---------------------------------- |
291
- | `shipwright init` | One-command tmux setup |
292
- | `shipwright setup` | Guided setup wizard |
293
- | `shipwright pipeline start --issue N` | Full delivery pipeline for issue |
294
- | `shipwright pipeline start --goal "..."` | Pipeline from goal description |
295
- | `shipwright pipeline resume` | Resume from last checkpoint |
296
- | `shipwright daemon start` | Watch GitHub for labeled issues |
297
- | `shipwright daemon start --detach` | Background daemon in tmux |
298
- | `shipwright daemon metrics` | DORA/DX metrics dashboard |
299
- | `shipwright fleet start` | Multi-repo daemon orchestration |
300
- | `shipwright fix "goal" --repos ~/a,~/b` | Apply same fix across repos |
301
- | `shipwright loop "goal" --test-cmd "..."` | Continuous autonomous loop |
302
- | `shipwright session name -t template` | Create team session with agents |
303
- | `shipwright memory show` | View persistent memory |
304
- | `shipwright cost show` | Token usage and spending |
305
- | `shipwright cost budget set 50` | Set daily budget limit |
306
- | `shipwright prep` | Analyze repo, generate configs |
307
- | `shipwright doctor` | Validate setup, diagnose issues |
308
- | `shipwright status` | Team dashboard |
309
- | `shipwright ps` | Running agent processes |
310
- | `shipwright logs team --follow` | Tail agent logs |
311
- | `shipwright github context` | Show repo GitHub context |
312
- | `shipwright github security` | CodeQL + Dependabot alerts |
313
- | `shipwright checks list` | GitHub Check runs |
314
- | `shipwright deploys list` | Deployment history |
315
- | `shipwright intelligence` | Run intelligence analysis |
316
- | `shipwright predict` | Risk assessment |
317
- | `shipwright optimize` | Self-optimization pass |
318
- | `shipwright dashboard` | Start web dashboard |
319
- | `shipwright webhook listen` | Receive GitHub webhook events |
320
- | `shipwright webhook register` | Register webhook in GitHub repo |
321
- | `shipwright pr auto-review` | Auto-review PRs by risk + coverage |
322
- | `shipwright pr merge` | Intelligent PR auto-merge |
323
- | `shipwright pr cleanup` | Clean up stale branches |
324
- | `shipwright fleet discover --org <org>` | Auto-discover repos in GitHub org |
325
- | `shipwright decompose --issue N` | Split complex issue into subtasks |
326
- | `shipwright context gather` | Assemble rich context for stages |
327
- | `shipwright db <cmd>` | SQLite persistence management |
328
- | `shipwright cleanup --force` | Kill orphaned sessions |
329
- | `shipwright upgrade --apply` | Pull latest updates |
333
+ Over 100 commands. Key workflows:
334
+
335
+ ```bash
336
+ # Autonomous delivery
337
+ shipwright pipeline start --issue 42
338
+ shipwright daemon start --detach
339
+
340
+ # Agent teams
341
+ shipwright swarm list
342
+ shipwright recruit --roles builder,tester
343
+ shipwright standup
344
+ shipwright guild members
345
+
346
+ # Quality gates
347
+ shipwright code-review
348
+ shipwright security-audit
349
+ shipwright testgen
350
+ shipwright quality check
351
+
352
+ # Observability
353
+ shipwright vitals
354
+ shipwright dora
355
+ shipwright stream
356
+ shipwright activity
357
+
358
+ # Multi-repo operations
359
+ shipwright fleet start
360
+ shipwright fix "feat: add auth" --repos ~/a,~/b,~/c
361
+ shipwright fleet-viz
362
+
363
+ # Release automation
364
+ shipwright release --version 2.1.0
365
+ shipwright changelog generate
366
+ shipwright deploys list
367
+
368
+ # Setup & maintenance
369
+ shipwright init
370
+ shipwright prep
371
+ shipwright doctor
372
+ shipwright upgrade --apply
373
+
374
+ # See all commands
375
+ shipwright --help
376
+ ```
377
+
378
+ See `.claude/CLAUDE.md` for the complete 100+ command reference organized by workflow.
330
379
 
331
380
  ## Pipeline Templates for Teams
332
381
 
@@ -362,29 +411,68 @@ shipwright templates list
362
411
 
363
412
  ## Architecture
364
413
 
365
- 48 bash scripts (~51K lines), 24 test suites (450+ tests), plus a Bun TypeScript dashboard server. Bash 3.2 compatible — runs on macOS out of the box.
414
+ 95+ bash scripts (~100K lines), 27 test suites (500+ tests), plus a TypeScript dashboard server. Bash 3.2 compatible — runs on macOS and Linux out of the box.
415
+
416
+ **Core Layers:**
366
417
 
367
418
  ```
368
- scripts/
369
- sw # CLI router
370
- sw-pipeline.sh # 12-stage delivery pipeline
371
- sw-daemon.sh # Autonomous issue watcher
372
- sw-loop.sh # Continuous build loop
419
+ Pipeline Layer
420
+ sw-pipeline.sh # 12-stage delivery orchestration
421
+ sw-daemon.sh # Autonomous GitHub issue watcher
422
+ sw-loop.sh # Continuous multi-iteration build loop
423
+
424
+ Agent Layer (18 agents)
425
+ sw-swarm.sh # Dynamic agent team orchestration
426
+ sw-pm.sh # Autonomous PM coordination
427
+ sw-recruit.sh # Agent recruitment system
428
+ sw-standup.sh # Daily team standups
429
+ sw-guild.sh # Knowledge guilds
430
+ sw-oversight.sh # Quality oversight board
431
+ sw-strategic.sh # Strategic intelligence
432
+ sw-scale.sh # Dynamic team scaling
433
+ ... 10 more agent scripts
434
+
435
+ Intelligence Layer
373
436
  sw-intelligence.sh # AI analysis engine
374
437
  sw-predictive.sh # Risk scoring + anomaly detection
375
- sw-adversarial.sh # Red-team code review
376
- sw-self-optimize.sh # DORA-driven self-tuning
377
- sw-pipeline-composer.sh # Dynamic pipeline generation
378
- sw-github-graphql.sh # GitHub GraphQL client
379
- sw-github-checks.sh # Native CI check runs
380
- sw-github-deploy.sh # Deployment tracking
438
+ sw-adaptive.sh # Data-driven pipeline tuning
439
+ sw-security-audit.sh # Security analysis
440
+ sw-code-review.sh # Code quality analysis
441
+ sw-testgen.sh # Test generation
442
+ sw-architecture.sh # Architecture enforcement
443
+
444
+ Operational Layer
381
445
  sw-fleet.sh # Multi-repo orchestration
382
- sw-memory.sh # Persistent learning
446
+ sw-ci.sh # CI/CD orchestration
447
+ sw-webhook.sh # GitHub webhooks
448
+ sw-incident.sh # Incident response
449
+ sw-release-manager.sh # Release automation
450
+ ... 20+ operational scripts
451
+
452
+ Observability Layer
453
+ sw-vitals.sh # Pipeline health scoring
454
+ sw-dora.sh # DORA metrics dashboard
455
+ sw-activity.sh # Live activity streams
456
+ sw-replay.sh # Pipeline playback
457
+ sw-trace.sh # E2E traceability
458
+ sw-otel.sh # OpenTelemetry integration
459
+ ... observability services
460
+
461
+ Infrastructure
462
+ sw-github-graphql.sh # GitHub GraphQL API client
463
+ sw-github-checks.sh # Native GitHub check runs
464
+ sw-github-deploy.sh # Deployment tracking
465
+ sw-memory.sh # Persistent learning system
383
466
  sw-cost.sh # Cost intelligence
384
- ... # 33 more scripts
385
- dashboard/
386
- server.ts # Bun WebSocket dashboard (4300+ lines)
387
- public/ # Dashboard frontend
467
+ sw-db.sh # SQLite persistence
468
+ sw-eventbus.sh # Async event bus
469
+
470
+ Tools & UX
471
+ dashboard/server.ts # Real-time dashboard
472
+ sw-session.sh # tmux agent sessions
473
+ sw-status.sh # Team dashboard
474
+ sw-docs.sh # Documentation sync
475
+ sw-tmux.sh # tmux health management
388
476
  ```
389
477
 
390
478
  ## Contributing
@@ -7,6 +7,11 @@
7
7
  _shipwright() {
8
8
  local -a commands
9
9
  commands=(
10
+ 'agent:Agent management (recruit, swarm, standup, guild, oversight)'
11
+ 'quality:Quality & review (code-review, security-audit, testgen, hygiene)'
12
+ 'observe:Observability (vitals, dora, retro, stream, activity, replay)'
13
+ 'release:Release & deploy (release, release-manager, changelog, deploy)'
14
+ 'intel:Intelligence (predict, intelligence, strategic, optimize)'
10
15
  'init:Quick tmux setup — one command, no prompts'
11
16
  'setup:Guided setup — prerequisites, init, doctor'
12
17
  'session:Create a new tmux window for a Claude team'
@@ -39,13 +44,6 @@ _shipwright() {
39
44
  'connect:Team connect — sync local state'
40
45
  'remote:Remote machines — manage distributed workers'
41
46
  'launchd:Process supervision — auto-start on boot'
42
- 'intelligence:Intelligence engine analysis'
43
- 'optimize:Self-optimization based on DORA'
44
- 'predict:Predictive risk assessment'
45
- 'adversarial:Adversarial Agent Code Review'
46
- 'simulate:Developer simulation workflow'
47
- 'architecture:Architecture Model & Enforcer'
48
- 'vitals:Pipeline vitals — real-time scoring'
49
47
  'docs:Documentation keeper — auto-sync docs'
50
48
  'tmux:tmux health — doctor, install, fix'
51
49
  'github:GitHub context — repo metadata'
@@ -62,7 +60,42 @@ _shipwright() {
62
60
  local -a checkpoint_cmds connect_cmds remote_cmds launchd_cmds
63
61
  local -a dashboard_cmds github_cmds checks_cmds deploys_cmds docs_cmds
64
62
  local -a tmux_cmds decompose_cmds pr_cmds
63
+ local -a agent_cmds quality_cmds observe_cmds release_cmds intel_cmds
65
64
 
65
+ agent_cmds=(
66
+ 'recruit:Agent recruitment & talent management'
67
+ 'swarm:Dynamic agent swarm management'
68
+ 'standup:Automated daily standups'
69
+ 'guild:Knowledge guilds & cross-team learning'
70
+ 'oversight:Quality oversight board'
71
+ )
72
+ quality_cmds=(
73
+ 'code-review:Clean code & architecture analysis'
74
+ 'security-audit:Comprehensive security auditing'
75
+ 'testgen:Autonomous test generation'
76
+ 'hygiene:Repository organization & cleanup'
77
+ )
78
+ observe_cmds=(
79
+ 'vitals:Pipeline vitals — real-time scoring'
80
+ 'dora:DORA metrics dashboard'
81
+ 'retro:Sprint retrospective engine'
82
+ 'stream:Live terminal output streaming'
83
+ 'activity:Live agent activity stream'
84
+ 'replay:Pipeline DVR — view past runs'
85
+ 'status:Team status dashboard'
86
+ )
87
+ release_cmds=(
88
+ 'release:Release train automation'
89
+ 'release-manager:Autonomous release pipeline'
90
+ 'changelog:Automated release notes'
91
+ 'deploy:Deployments — deployment history'
92
+ )
93
+ intel_cmds=(
94
+ 'predict:Predictive risk assessment'
95
+ 'intelligence:Intelligence engine analysis'
96
+ 'strategic:Strategic intelligence agent'
97
+ 'optimize:Self-optimization based on DORA'
98
+ )
66
99
  pipeline_cmds=(
67
100
  'start:Start a new pipeline run'
68
101
  'resume:Resume from last stage'
@@ -193,6 +226,21 @@ _shipwright() {
193
226
  ;;
194
227
  args)
195
228
  case "${words[1]}" in
229
+ agent)
230
+ _describe -t agent-cmds 'agent command' agent_cmds
231
+ ;;
232
+ quality)
233
+ _describe -t quality-cmds 'quality command' quality_cmds
234
+ ;;
235
+ observe)
236
+ _describe -t observe-cmds 'observe command' observe_cmds
237
+ ;;
238
+ release)
239
+ _describe -t release-cmds 'release command' release_cmds
240
+ ;;
241
+ intel)
242
+ _describe -t intel-cmds 'intel command' intel_cmds
243
+ ;;
196
244
  pipeline)
197
245
  _describe -t pipeline-cmds 'pipeline command' pipeline_cmds
198
246
  _arguments '*:options:_pipeline_options'
@@ -268,6 +316,8 @@ _shipwright() {
268
316
  loop)
269
317
  _arguments \
270
318
  '1:goal:' \
319
+ '--repo[Directory path]:directory:_directories' \
320
+ '--local[Local-only mode (no GitHub)]' \
271
321
  '--test-cmd[Test command]:command:' \
272
322
  '--max-iterations[Max iterations]:count:' \
273
323
  '--model[Model to use]:model:(opus sonnet haiku)' \
@@ -312,6 +362,8 @@ _pipeline_options() {
312
362
  _arguments \
313
363
  '--issue[GitHub issue number]:issue:' \
314
364
  '--goal[Goal description]:goal:' \
365
+ '--repo[Directory path]:directory:_directories' \
366
+ '--local[Local-only mode (no GitHub)]' \
315
367
  '--worktree[Use isolated worktree]' \
316
368
  '--template[Pipeline template]:file:_files' \
317
369
  '--skip-gates[Auto-proceed all gates]'
@@ -9,14 +9,34 @@ _shipwright_completions() {
9
9
  cur="${COMP_WORDS[COMP_CWORD]}"
10
10
  prev="${COMP_WORDS[COMP_CWORD-1]}"
11
11
 
12
- # Top-level commands
13
- local commands="init setup session status ps logs templates doctor cleanup reaper upgrade loop pipeline worktree prep daemon fleet memory cost db fix dashboard jira linear tracker heartbeat checkpoint webhook decompose connect remote launchd intelligence optimize predict adversarial simulate architecture vitals docs tmux github checks deploys pr context help version"
12
+ # Top-level commands (includes groups and flat commands)
13
+ local commands="agent quality observe release intel init setup session status ps logs templates doctor cleanup reaper upgrade loop pipeline worktree prep daemon fleet memory cost db fix dashboard jira linear tracker heartbeat checkpoint webhook decompose connect remote launchd intelligence optimize predict adversarial simulate architecture vitals docs tmux github checks deploys pr context help version"
14
14
 
15
15
  case "$prev" in
16
16
  shipwright|sw|cct)
17
17
  COMPREPLY=( $(compgen -W "$commands" -- "$cur") )
18
18
  return 0
19
19
  ;;
20
+ agent)
21
+ COMPREPLY=( $(compgen -W "recruit swarm standup guild oversight" -- "$cur") )
22
+ return 0
23
+ ;;
24
+ quality)
25
+ COMPREPLY=( $(compgen -W "code-review security-audit testgen hygiene" -- "$cur") )
26
+ return 0
27
+ ;;
28
+ observe)
29
+ COMPREPLY=( $(compgen -W "vitals dora retro stream activity replay status" -- "$cur") )
30
+ return 0
31
+ ;;
32
+ release)
33
+ COMPREPLY=( $(compgen -W "release release-manager changelog deploy" -- "$cur") )
34
+ return 0
35
+ ;;
36
+ intel)
37
+ COMPREPLY=( $(compgen -W "predict intelligence strategic optimize" -- "$cur") )
38
+ return 0
39
+ ;;
20
40
  pipeline)
21
41
  COMPREPLY=( $(compgen -W "start resume status test" -- "$cur") )
22
42
  return 0
@@ -111,13 +131,13 @@ _shipwright_completions() {
111
131
  if [[ "$cur" == -* ]]; then
112
132
  case "${COMP_WORDS[1]}" in
113
133
  pipeline)
114
- COMPREPLY=( $(compgen -W "--issue --goal --worktree --template --skip-gates" -- "$cur") )
134
+ COMPREPLY=( $(compgen -W "--issue --goal --repo --local --worktree --template --skip-gates --test-cmd --model --agents --base --reviewers --labels --no-github --no-github-label --ci --ignore-budget --dry-run --slack-webhook --self-heal --max-iterations --max-restarts --fast-test-cmd --completed-stages" -- "$cur") )
115
135
  ;;
116
136
  prep)
117
137
  COMPREPLY=( $(compgen -W "--check --with-claude --verbose" -- "$cur") )
118
138
  ;;
119
139
  loop)
120
- COMPREPLY=( $(compgen -W "--test-cmd --max-iterations --model --agents --audit --audit-agent --quality-gates --definition-of-done --resume --skip-permissions" -- "$cur") )
140
+ COMPREPLY=( $(compgen -W "--repo --local --test-cmd --fast-test-cmd --fast-test-interval --max-iterations --model --agents --roles --worktree --skip-permissions --max-turns --resume --max-restarts --verbose --audit --audit-agent --quality-gates --definition-of-done --no-auto-extend --extension-size --max-extensions" -- "$cur") )
121
141
  ;;
122
142
  fix)
123
143
  COMPREPLY=( $(compgen -W "--repos" -- "$cur") )
@@ -7,8 +7,13 @@
7
7
  for cmd in shipwright sw cct
8
8
  complete -c $cmd -f
9
9
 
10
- # Top-level commands
11
- set -l all_cmds session status ps logs templates doctor cleanup reaper upgrade loop pipeline worktree prep daemon memory cost init help version
10
+ # Top-level commands (includes groups and flat commands)
11
+ set -l all_cmds agent quality observe release intel session status ps logs templates doctor cleanup reaper upgrade loop pipeline worktree prep daemon memory cost init help version
12
+ complete -c $cmd -n "not __fish_seen_subcommand_from $all_cmds" -a "agent" -d "Agent management (recruit, swarm, standup, guild, oversight)"
13
+ complete -c $cmd -n "not __fish_seen_subcommand_from $all_cmds" -a "quality" -d "Quality & review (code-review, security-audit, testgen, hygiene)"
14
+ complete -c $cmd -n "not __fish_seen_subcommand_from $all_cmds" -a "observe" -d "Observability (vitals, dora, retro, stream, activity, replay)"
15
+ complete -c $cmd -n "not __fish_seen_subcommand_from $all_cmds" -a "release" -d "Release & deploy (release, release-manager, changelog, deploy)"
16
+ complete -c $cmd -n "not __fish_seen_subcommand_from $all_cmds" -a "intel" -d "Intelligence (predict, intelligence, strategic, optimize)"
12
17
  complete -c $cmd -n "not __fish_seen_subcommand_from $all_cmds" -a "session" -d "Create a new tmux window for a Claude team"
13
18
  complete -c $cmd -n "not __fish_seen_subcommand_from $all_cmds" -a "status" -d "Show dashboard of running teams and agents"
14
19
  complete -c $cmd -n "not __fish_seen_subcommand_from $all_cmds" -a "ps" -d "Show running agent processes and status"
@@ -29,6 +34,40 @@ for cmd in shipwright sw cct
29
34
  complete -c $cmd -n "not __fish_seen_subcommand_from $all_cmds" -a "help" -d "Show help message"
30
35
  complete -c $cmd -n "not __fish_seen_subcommand_from $all_cmds" -a "version" -d "Show version"
31
36
 
37
+ # agent subcommands
38
+ complete -c $cmd -n "__fish_seen_subcommand_from agent" -a "recruit" -d "Agent recruitment & talent management"
39
+ complete -c $cmd -n "__fish_seen_subcommand_from agent" -a "swarm" -d "Dynamic agent swarm management"
40
+ complete -c $cmd -n "__fish_seen_subcommand_from agent" -a "standup" -d "Automated daily standups"
41
+ complete -c $cmd -n "__fish_seen_subcommand_from agent" -a "guild" -d "Knowledge guilds & cross-team learning"
42
+ complete -c $cmd -n "__fish_seen_subcommand_from agent" -a "oversight" -d "Quality oversight board"
43
+
44
+ # quality subcommands
45
+ complete -c $cmd -n "__fish_seen_subcommand_from quality" -a "code-review" -d "Clean code & architecture analysis"
46
+ complete -c $cmd -n "__fish_seen_subcommand_from quality" -a "security-audit" -d "Comprehensive security auditing"
47
+ complete -c $cmd -n "__fish_seen_subcommand_from quality" -a "testgen" -d "Autonomous test generation"
48
+ complete -c $cmd -n "__fish_seen_subcommand_from quality" -a "hygiene" -d "Repository organization & cleanup"
49
+
50
+ # observe subcommands
51
+ complete -c $cmd -n "__fish_seen_subcommand_from observe" -a "vitals" -d "Pipeline vitals — real-time scoring"
52
+ complete -c $cmd -n "__fish_seen_subcommand_from observe" -a "dora" -d "DORA metrics dashboard"
53
+ complete -c $cmd -n "__fish_seen_subcommand_from observe" -a "retro" -d "Sprint retrospective engine"
54
+ complete -c $cmd -n "__fish_seen_subcommand_from observe" -a "stream" -d "Live terminal output streaming"
55
+ complete -c $cmd -n "__fish_seen_subcommand_from observe" -a "activity" -d "Live agent activity stream"
56
+ complete -c $cmd -n "__fish_seen_subcommand_from observe" -a "replay" -d "Pipeline DVR — view past runs"
57
+ complete -c $cmd -n "__fish_seen_subcommand_from observe" -a "status" -d "Team status dashboard"
58
+
59
+ # release subcommands
60
+ complete -c $cmd -n "__fish_seen_subcommand_from release" -a "release" -d "Release train automation"
61
+ complete -c $cmd -n "__fish_seen_subcommand_from release" -a "release-manager" -d "Autonomous release pipeline"
62
+ complete -c $cmd -n "__fish_seen_subcommand_from release" -a "changelog" -d "Automated release notes"
63
+ complete -c $cmd -n "__fish_seen_subcommand_from release" -a "deploy" -d "Deployments — deployment history"
64
+
65
+ # intel subcommands
66
+ complete -c $cmd -n "__fish_seen_subcommand_from intel" -a "predict" -d "Predictive risk assessment"
67
+ complete -c $cmd -n "__fish_seen_subcommand_from intel" -a "intelligence" -d "Intelligence engine analysis"
68
+ complete -c $cmd -n "__fish_seen_subcommand_from intel" -a "strategic" -d "Strategic intelligence agent"
69
+ complete -c $cmd -n "__fish_seen_subcommand_from intel" -a "optimize" -d "Self-optimization based on DORA"
70
+
32
71
  # pipeline subcommands
33
72
  complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -a "start" -d "Start a new pipeline run"
34
73
  complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -a "resume" -d "Resume from last stage"
@@ -81,16 +120,28 @@ for cmd in shipwright sw cct
81
120
  complete -c $cmd -n "__fish_seen_subcommand_from prep" -l verbose -d "Verbose output"
82
121
 
83
122
  # loop flags
123
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l repo -d "Change to directory before running" -r
124
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l local -d "Local-only mode (no GitHub)"
84
125
  complete -c $cmd -n "__fish_seen_subcommand_from loop" -l test-cmd -d "Test command to verify each iteration" -r
126
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l fast-test-cmd -d "Fast/subset test command" -r
127
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l fast-test-interval -d "Run full tests every N iterations" -r
85
128
  complete -c $cmd -n "__fish_seen_subcommand_from loop" -l max-iterations -d "Maximum loop iterations" -r
86
129
  complete -c $cmd -n "__fish_seen_subcommand_from loop" -l model -d "Claude model to use" -ra "opus sonnet haiku"
87
130
  complete -c $cmd -n "__fish_seen_subcommand_from loop" -l agents -d "Number of agents" -r
131
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l roles -d "Role per agent" -r
132
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l worktree -d "Use git worktrees for isolation"
88
133
  complete -c $cmd -n "__fish_seen_subcommand_from loop" -l audit -d "Enable self-reflection each iteration"
89
134
  complete -c $cmd -n "__fish_seen_subcommand_from loop" -l audit-agent -d "Use separate auditor agent"
90
135
  complete -c $cmd -n "__fish_seen_subcommand_from loop" -l quality-gates -d "Enable automated quality checks"
91
136
  complete -c $cmd -n "__fish_seen_subcommand_from loop" -l definition-of-done -d "Custom completion checklist" -rF
137
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l no-auto-extend -d "Disable auto-extension"
138
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l extension-size -d "Additional iterations per extension" -r
139
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l max-extensions -d "Max number of auto-extensions" -r
92
140
  complete -c $cmd -n "__fish_seen_subcommand_from loop" -l resume -d "Resume interrupted loop"
141
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l max-restarts -d "Max session restarts" -r
142
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l max-turns -d "Max API turns per session" -r
93
143
  complete -c $cmd -n "__fish_seen_subcommand_from loop" -l skip-permissions -d "Skip permission prompts"
144
+ complete -c $cmd -n "__fish_seen_subcommand_from loop" -l verbose -d "Show full Claude output"
94
145
 
95
146
  # logs flags
96
147
  complete -c $cmd -n "__fish_seen_subcommand_from logs" -l follow -d "Tail logs in real time"
@@ -104,4 +155,31 @@ for cmd in shipwright sw cct
104
155
 
105
156
  # reaper flags
106
157
  complete -c $cmd -n "__fish_seen_subcommand_from reaper" -l watch -d "Continuous watch mode"
158
+
159
+ # pipeline flags
160
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l issue -d "GitHub issue number" -r
161
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l goal -d "Goal description" -r
162
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l repo -d "Change to directory before running" -r
163
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l local -d "Local-only mode (no GitHub)"
164
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l pipeline -d "Pipeline template" -r
165
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l template -d "Pipeline template" -r
166
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l test-cmd -d "Test command to run" -r
167
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l model -d "AI model to use" -ra "opus sonnet haiku"
168
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l agents -d "Number of agents" -r
169
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l skip-gates -d "Auto-approve all gates"
170
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l base -d "Base branch for PR" -r
171
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l reviewers -d "PR reviewers" -r
172
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l labels -d "PR labels" -r
173
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l no-github -d "Disable GitHub integration"
174
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l no-github-label -d "Don't modify issue labels"
175
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l ci -d "CI mode (non-interactive)"
176
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l ignore-budget -d "Skip budget enforcement"
177
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l worktree -d "Run in isolated worktree"
178
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l dry-run -d "Show what would happen"
179
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l slack-webhook -d "Slack webhook URL" -r
180
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l self-heal -d "Build retry cycles" -r
181
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l max-iterations -d "Max build loop iterations" -r
182
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l max-restarts -d "Max session restarts" -r
183
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l fast-test-cmd -d "Fast/subset test command" -r
184
+ complete -c $cmd -n "__fish_seen_subcommand_from pipeline" -l completed-stages -d "Skip these stages" -r
107
185
  end