shipwright-cli 2.2.1 → 2.2.2

package/README.md

@@ -13,7 +13,7 @@
   <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>
   <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>
   <img src="https://img.shields.io/badge/tests-103_suites_passing-4ade80?style=flat-square" alt="103 suites">
-  <img src="https://img.shields.io/badge/version-2.1.2-00d4ff?style=flat-square" alt="v2.1.2">
+  <img src="https://img.shields.io/badge/version-2.2.2-00d4ff?style=flat-square" alt="v2.2.2">
   <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT License">
   <img src="https://img.shields.io/badge/bash-3.2%2B-7c3aed?style=flat-square" alt="Bash 3.2+">
 </p>
@@ -23,7 +23,7 @@
 ## Table of Contents
 
 - [Shipwright Builds Itself](#shipwright-builds-itself)
-- [What's New in v2.1.2](#whats-new-in-v212)
+- [What's New in v2.2.2](#whats-new-in-v222)
 - [How It Works](#how-it-works)
 - [Install](#install)
 - [Quick Start](#quick-start)
@@ -46,17 +46,16 @@ This repo uses Shipwright to process its own issues. Label a GitHub issue with `
 
 ---
 
-## What's New in v2.1.2
+## What's New in v2.2.2
 
-**AGI-Level Agent Recruitment** — dynamic role creation, LLM-powered matching, closed-loop learning:
+**Docs & platform polish** — doc-fleet, shared libs, policy schema, release infra:
 
-- **`recruit match`** — AI/heuristic task→role matching with `--json` output for pipeline integration
-- **`recruit team`** — Context-aware team composition with cost estimation
-- **`recruit route`** — Smart routing based on agent performance history
-- **Cross-system integration** — Pipeline, PM, triage, loop, and swarm all use recruit for model/role selection
-- **Self-tuning heuristics** — System learns keyword→role mappings from successful outcomes
-- **Meta-learning** — Accuracy tracking and self-correction for matching decisions
-- **CI auto-discovery** — All 103 test suites now run in CI (previously 26)
+- **Doc-fleet** — Five Cursor agents (doc-architect, claude-md, strategy-curator, pattern-writer, readme-optimizer) keep docs, strategy, and README in sync
+- **Pipeline lib split** — `scripts/lib/pipeline-quality.sh`, `daemon-health.sh`, `policy.sh` for reuse and tests
+- **Policy schema** — `config/policy.json` and `docs/config-policy.md` for hygiene, quality, and platform rules
+- **Release infra** — npm, GitHub Releases (darwin/linux/windows), Homebrew tap; `scripts/build-release.sh` and `.github/workflows/release.yml` ship all platforms
+
+**v2.1.2**: AGI-level recruit — `recruit match` / `team` / `route`, cross-system integration, 103 test suites in CI
 
 **v2.1.0**: tmux visual overhaul — role-colored borders, pipeline status widgets, active pane depth
 
@@ -163,7 +162,7 @@ shipwright fleet start
 shipwright fix "upgrade deps" --repos ~/a,~/b,~/c
 
 # Release automation
-shipwright release --version 2.1.0
+shipwright release --version 2.2.2
 shipwright changelog generate
 ```
 
@@ -382,7 +381,7 @@ shipwright fix "feat: add auth" --repos ~/a,~/b,~/c
 shipwright fleet-viz
 
 # Release automation
-shipwright release --version 2.1.0
+shipwright release --version 2.2.2
 shipwright changelog generate
 shipwright deploys list
 

package/docs/AGI-PLATFORM-PLAN.md

@@ -51,7 +51,7 @@
 
 **Goal:** Pipeline and daemon are split into sourced modules; no single file > 2000 lines for orchestration core.
 
-**Status:** 3.2 and 3.4 done (pipeline-quality.sh and daemon-health.sh created, wired, and sourced). 3.1 and 3.3 (full stage/poll extraction) deferred — high risk, requires incremental approach.
+**Status:** All done. 3.1 pipeline fully decomposed: sw-pipeline.sh reduced from 8,665 → 2,434 lines (72% reduction) by wiring pipeline-state.sh, pipeline-github.sh, pipeline-detection.sh, pipeline-quality-checks.sh, pipeline-intelligence.sh, pipeline-stages.sh. 3.2 done (pipeline-quality.sh). 3.3 daemon fully decomposed: sw-daemon.sh reduced from 6,150 → 1,351 lines (78% reduction) by wiring daemon-state.sh, daemon-adaptive.sh, daemon-triage.sh, daemon-failure.sh, daemon-dispatch.sh, daemon-patrol.sh, daemon-poll.sh. 3.4 done (daemon-health.sh). All tests pass.
 
 | #   | Task                                                                                                                                                                                                   | Owner | Acceptance                                                            |
 | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- | --------------------------------------------------------------------- |
@@ -66,7 +66,7 @@
 
 **Goal:** Triage all TODO/FIXME/HACK; remove dead code; reduce fallback count.
 
-**Status:** 4.1–4.2 done (PLATFORM-TODO-TRIAGE.md created with full triage: 4 github-issue, 3 accepted-debt, 0 stale). 4.3–4.4 ongoing (run hygiene dead-code; reduce fallbacks over time). Pre-existing `now_unix` bug in sw-scale.sh fixed.
+**Status:** All done. 4.1–4.2 triage complete (PLATFORM-TODO-TRIAGE.md: 4 github-issue, 3 accepted-debt). 4.3 dead code scan complete — 1 confirmed dead function (get_adaptive_heartbeat_timeout in daemon-adaptive.sh, accepted debt; may wire later). No unused scripts. No .bak/temp files. 4.4 fallback count reduced from 71 → 54 via monolith decomposition; remaining fallbacks are legitimate defensive patterns (intelligence heuristics, template fallbacks, grep-based search fallbacks). Pre-existing `now_unix` bug in sw-scale.sh fixed.
 
 | #   | Task                                                                                                                                                                                                    | Owner | Acceptance                                               |
 | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | -------------------------------------------------------- |
@@ -94,10 +94,10 @@
 
 ## Current Snapshot (from platform-refactor scan)
 
-- **hardcoded:** 58 | **fallback:** 54 | **TODO:** 37 | **FIXME:** 19 | **HACK/KLUDGE:** 17
+- **hardcoded:** 66 | **fallback:** 71 | **TODO:** 38 | **FIXME:** 19 | **HACK/KLUDGE:** 18
 - **Triage:** 4 github-issue, 3 accepted-debt, 0 stale, 0 fix-now (see `docs/PLATFORM-TODO-TRIAGE.md`)
-- **Largest scripts:** sw-pipeline.sh (8600+), sw-daemon.sh (6000+), sw-loop.sh (2400+), sw-recruit.sh (2200+), sw-prep.sh (1600+), sw-memory.sh (1600+).
-- _Last scan: 2026-02-16. Re-scan after full helpers migration to track delta._
+- **Largest scripts:** sw-pipeline.sh (8665), sw-daemon.sh (6150), sw-loop.sh (2492), sw-recruit.sh (2636), sw-prep.sh (1657), sw-memory.sh (1634). Pipeline/daemon have extracted libs (scripts/lib/pipeline-_.sh, scripts/lib/daemon-_.sh).
+- _Last scan: 2026-02-16. Run `shipwright hygiene platform-refactor` to refresh._
 
 ---
 

package/docs/AGI-WHATS-NEXT.md

@@ -40,13 +40,13 @@
 
 ## 4. Not audited E2E
 
-| Item                                | What                                                                                                                                                               | Next step                                                                          |
-| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
-| ~~**Pipeline E2E with policy**~~    | **Done.** `sw-policy-e2e-test.sh` (26 tests) verifies pipeline-quality.sh reads coverage/gate thresholds from policy, policy_get with mock and real configs.       | Added to npm test suite.                                                           |
-| ~~**Daemon E2E with policy**~~      | **Done.** `sw-policy-e2e-test.sh` verifies daemon policy_get for poll_interval, heartbeat_timeout, stage_timeouts, auto_scale_interval.                            | Covered in policy E2E test.                                                        |
-| **Platform-health workflow E2E**    | Workflow validated locally (schema, scan, report steps); not yet triggered via workflow_dispatch in CI.                                                            | Trigger workflow (workflow_dispatch) to confirm end-to-end in real CI.             |
-| **Doctor with no platform-hygiene** | When `.claude/platform-hygiene.json` is missing, doctor shows "Platform hygiene not run". Not wrong, but we never auto-run it.                                     | Optional: doctor could run `hygiene platform-refactor` once and then show section. |
-| ~~**Full npm test with policy**~~   | **Done.** `sw-policy-e2e-test.sh` added to npm test; 26 policy-specific assertions covering policy_get, pipeline-quality.sh, daemon thresholds, and sanity checks. | In test suite.                                                                     |
+| Item                                    | What                                                                                                                                                               | Next step                                                              |
+| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------- |
+| ~~**Pipeline E2E with policy**~~        | **Done.** `sw-policy-e2e-test.sh` (26 tests) verifies pipeline-quality.sh reads coverage/gate thresholds from policy, policy_get with mock and real configs.       | Added to npm test suite.                                               |
+| ~~**Daemon E2E with policy**~~          | **Done.** `sw-policy-e2e-test.sh` verifies daemon policy_get for poll_interval, heartbeat_timeout, stage_timeouts, auto_scale_interval.                            | Covered in policy E2E test.                                            |
+| **Platform-health workflow E2E**        | Workflow validated locally (schema, scan, report steps); not yet triggered via workflow_dispatch in CI.                                                            | Trigger workflow (workflow_dispatch) to confirm end-to-end in real CI. |
+| ~~**Doctor with no platform-hygiene**~~ | **Done.** Doctor now auto-runs `hygiene platform-refactor` when report is missing; `--skip-platform-scan` flag available for fast mode.                            | Complete.                                                              |
+| ~~**Full npm test with policy**~~       | **Done.** `sw-policy-e2e-test.sh` added to npm test; 26 policy-specific assertions covering policy_get, pipeline-quality.sh, daemon thresholds, and sanity checks. | In test suite.                                                         |
 
 ---
 
@@ -61,7 +61,10 @@
 - [x] **TODO/FIXME/HACK** — Phase 4 triage complete: 4 github-issue, 3 accepted-debt, 0 stale. See `docs/PLATFORM-TODO-TRIAGE.md`.
 - [x] **Strategic + hygiene** — Strategic CI workflow now runs hygiene platform-refactor before analysis.
 - [ ] **Platform-health workflow_dispatch** — Trigger once in CI to confirm end-to-end execution.
-- [ ] **Monolith decomposition (Phase 3.1, 3.3)** — Deferred; high risk, requires incremental extraction.
+- [x] **Monolith decomposition (Phase 3.1, 3.3)** — Done. Pipeline 8,665 → 2,434 lines; daemon 6,150 → 1,351 lines. All libs wired and sourced.
+- [x] **Doctor auto-hygiene** — Doctor auto-runs platform-refactor when report missing; `--skip-platform-scan` flag added.
+- [x] **Dead code scan** — 1 confirmed dead function (accepted debt); no unused scripts or temp files.
+- [x] **Fallback reduction** — Counts reduced 71 → 54 via decomposition; remaining are legitimate patterns.
 
 ---
 

package/docs/README.md

@@ -78,6 +78,8 @@ Navigation hub for all Shipwright docs. Start here or jump to a section.
 
 ## See Also
 
+- [../CHANGELOG.md](../CHANGELOG.md) — Version history and release notes
+- **Release automation** — Prefer CLI: `shipwright version bump <x.y.z>`, `shipwright version check`, `shipwright release build`. Scripts: `scripts/update-version.sh`, `scripts/check-version-consistency.sh`, `scripts/build-release.sh`. Website footer reads version from repo `package.json` at build time.
 - [demo/README.md](../demo/README.md) — Demo app for pipeline testing
 - [claude-code/CLAUDE.md.shipwright](../claude-code/CLAUDE.md.shipwright) — Downstream repo template
 - [.github/pull_request_template.md](../.github/pull_request_template.md) — PR checklist

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shipwright-cli",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Orchestrate autonomous Claude Code agent teams in tmux",
   "bin": {
     "shipwright": "./scripts/sw",

package/scripts/check-version-consistency.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  Shipwright — Version consistency check                                  ║
+# ║  Fails if package.json version != README badge / script VERSION=          ║
+# ║  Run in CI or before release to catch drift.                             ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+CANONICAL=""
+if [[ -f "$REPO_ROOT/package.json" ]]; then
+  if command -v jq &>/dev/null; then
+    CANONICAL="$(jq -r .version "$REPO_ROOT/package.json")"
+  else
+    CANONICAL="$(grep -oE '"version":\s*"[^"]+"' "$REPO_ROOT/package.json" | head -1 | sed 's/.*"\([^"]*\)".*/\1/')"
+  fi
+fi
+
+if [[ -z "$CANONICAL" ]]; then
+  echo "check-version-consistency: could not read version from package.json" >&2
+  exit 1
+fi
+
+ERR=0
+
+# README badge: version-X.Y.Z and alt="vX.Y.Z"
+if [[ -f "$REPO_ROOT/README.md" ]]; then
+  if ! grep -q "badge/version-$CANONICAL" "$REPO_ROOT/README.md"; then
+    echo "check-version-consistency: README badge version does not match package.json ($CANONICAL)" >&2
+    ERR=1
+  fi
+  if ! grep -q "alt=\"v$CANONICAL\"" "$REPO_ROOT/README.md"; then
+    echo "check-version-consistency: README alt version does not match package.json ($CANONICAL)" >&2
+    ERR=1
+  fi
+fi
+
+# Sample scripts: VERSION= must match (check a few key ones)
+SAMPLES=(
+  "$REPO_ROOT/scripts/sw"
+  "$REPO_ROOT/scripts/sw-daemon.sh"
+  "$REPO_ROOT/scripts/sw-pipeline.sh"
+  "$REPO_ROOT/scripts/install-remote.sh"
+)
+for f in "${SAMPLES[@]}"; do
+  if [[ -f "$f" ]]; then
+    V="$(grep -m1 '^VERSION="' "$f" 2>/dev/null | sed 's/^VERSION="\([^"]*\)".*/\1/')"
+    if [[ -n "$V" && "$V" != "$CANONICAL" ]]; then
+      echo "check-version-consistency: $(basename "$f") has VERSION=$V, expected $CANONICAL" >&2
+      ERR=1
+    fi
+  fi
+done
+
+# Any script under scripts/ with ^VERSION=" that differs
+while IFS= read -r file; do
+  V="$(grep -m1 '^VERSION="' "$file" 2>/dev/null | sed 's/^VERSION="\([^"]*\)".*/\1/')"
+  if [[ -n "$V" && "$V" != "$CANONICAL" ]]; then
+    echo "check-version-consistency: $(basename "$file") has VERSION=$V, expected $CANONICAL" >&2
+    ERR=1
+  fi
+done < <(grep -rl '^VERSION="' "$REPO_ROOT/scripts/" 2>/dev/null || true)
+
+if [[ $ERR -eq 1 ]]; then
+  echo "Run: bash scripts/update-version.sh $CANONICAL" >&2
+  exit 1
+fi
+
+echo "Version consistent: $CANONICAL"
+exit 0