shipwright-cli 2.4.0 → 3.1.0

package/dashboard/src/views/team.test.ts

@@ -0,0 +1,253 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { store } from "../core/state";
+import type { FleetState, TeamData } from "../types/api";
+
+vi.mock("../core/api", () => ({
+  fetchTeam: vi
+    .fn()
+    .mockResolvedValue({
+      developers: [],
+      total_online: 0,
+      total_active_pipelines: 0,
+      total_queued: 0,
+    }),
+  fetchTeamActivity: vi.fn().mockResolvedValue([]),
+  createTeamInvite: vi
+    .fn()
+    .mockResolvedValue({ url: "https://invite.example.com/abc" }),
+  fetchLinearStatus: vi.fn().mockResolvedValue({ connected: false }),
+  fetchDbHealth: vi.fn().mockResolvedValue({ ok: true }),
+  fetchDbEvents: vi.fn().mockResolvedValue([]),
+  fetchDbJobs: vi.fn().mockResolvedValue([]),
+  fetchDbHeartbeats: vi.fn().mockResolvedValue([]),
+  fetchDbCostsToday: vi.fn().mockResolvedValue([]),
+  claimIssue: vi.fn().mockResolvedValue({ approved: true }),
+  releaseIssue: vi.fn().mockResolvedValue({}),
+}));
+
+function createTeamDOM(): void {
+  const grid = document.createElement("div");
+  grid.id = "team-grid";
+  document.body.appendChild(grid);
+
+  const statOnline = document.createElement("span");
+  statOnline.id = "team-stat-online";
+  document.body.appendChild(statOnline);
+
+  const statPipelines = document.createElement("span");
+  statPipelines.id = "team-stat-pipelines";
+  document.body.appendChild(statPipelines);
+
+  const statQueued = document.createElement("span");
+  statQueued.id = "team-stat-queued";
+  document.body.appendChild(statQueued);
+
+  const activity = document.createElement("div");
+  activity.id = "team-activity";
+  document.body.appendChild(activity);
+
+  const inviteResult = document.createElement("div");
+  inviteResult.id = "team-invite-result";
+  inviteResult.style.display = "none";
+  document.body.appendChild(inviteResult);
+
+  const btnInvite = document.createElement("button");
+  btnInvite.id = "btn-create-invite";
+  document.body.appendChild(btnInvite);
+
+  const integrations = document.createElement("div");
+  integrations.id = "integrations-status";
+  document.body.appendChild(integrations);
+
+  const adminOutput = document.createElement("div");
+  adminOutput.id = "admin-debug-output";
+  document.body.appendChild(adminOutput);
+
+  const claimResult = document.createElement("div");
+  claimResult.id = "claim-result";
+  document.body.appendChild(claimResult);
+
+  const claimIssue = document.createElement("input");
+  claimIssue.id = "claim-issue";
+  document.body.appendChild(claimIssue);
+
+  const claimMachine = document.createElement("input");
+  claimMachine.id = "claim-machine";
+  document.body.appendChild(claimMachine);
+
+  const btnClaim = document.createElement("button");
+  btnClaim.id = "btn-claim";
+  document.body.appendChild(btnClaim);
+
+  const btnRelease = document.createElement("button");
+  btnRelease.id = "btn-release";
+  document.body.appendChild(btnRelease);
+
+  [
+    "btn-db-health",
+    "btn-db-events",
+    "btn-db-jobs",
+    "btn-db-heartbeats",
+    "btn-db-costs",
+  ].forEach((id) => {
+    const btn = document.createElement("button");
+    btn.id = id;
+    document.body.appendChild(btn);
+  });
+}
+
+function cleanupTeamDOM(): void {
+  const ids = [
+    "team-grid",
+    "team-stat-online",
+    "team-stat-pipelines",
+    "team-stat-queued",
+    "team-activity",
+    "team-invite-result",
+    "btn-create-invite",
+    "integrations-status",
+    "admin-debug-output",
+    "claim-result",
+    "claim-issue",
+    "claim-machine",
+    "btn-claim",
+    "btn-release",
+    "btn-db-health",
+    "btn-db-events",
+    "btn-db-jobs",
+    "btn-db-heartbeats",
+    "btn-db-costs",
+  ];
+  ids.forEach((id) => document.getElementById(id)?.remove());
+}
+
+function emptyFleetState(): FleetState {
+  return {
+    timestamp: new Date().toISOString(),
+    daemon: {
+      running: false,
+      pid: null,
+      uptime_s: 0,
+      maxParallel: 0,
+      pollInterval: 5,
+    },
+    pipelines: [],
+    queue: [],
+    events: [],
+    scale: {},
+    metrics: {},
+    agents: [],
+    machines: [],
+    cost: { today_spent: 0, daily_budget: 0, pct_used: 0 },
+    dora: {} as any,
+  };
+}
+
+describe("TeamView", () => {
+  beforeEach(() => {
+    store.set("teamCache", null);
+    createTeamDOM();
+  });
+
+  afterEach(() => {
+    cleanupTeamDOM();
+    vi.clearAllMocks();
+  });
+
+  it("renders team members when data provided", async () => {
+    const { teamView } = await import("./team");
+    const teamData: TeamData = {
+      total_online: 2,
+      total_active_pipelines: 1,
+      total_queued: 0,
+      developers: [
+        {
+          developer_id: "alice",
+          machine_name: "macbook-pro",
+          daemon_running: true,
+          active_jobs: [{ issue: 42, title: "Fix bug", stage: "code" }],
+          queued: [],
+        },
+      ],
+    };
+    const data = emptyFleetState();
+    data.team = teamData;
+    teamView.render(data);
+    const grid = document.getElementById("team-grid");
+    expect(grid).toBeTruthy();
+    expect(grid!.innerHTML).toContain("alice");
+    expect(grid!.innerHTML).toContain("macbook-pro");
+    expect(grid!.innerHTML).toContain("#42");
+    expect(grid!.innerHTML).toContain("presence-dot");
+  });
+
+  it("handles empty team", async () => {
+    const { teamView } = await import("./team");
+    const data = emptyFleetState();
+    data.team = {
+      developers: [],
+      total_online: 0,
+      total_active_pipelines: 0,
+      total_queued: 0,
+    };
+    teamView.render(data);
+    const grid = document.getElementById("team-grid");
+    expect(grid).toBeTruthy();
+    expect(grid!.innerHTML).toContain("No developers connected");
+  });
+
+  it("shows activity indicators when team has active jobs", async () => {
+    const { teamView } = await import("./team");
+    const teamData: TeamData = {
+      developers: [
+        {
+          developer_id: "bob",
+          machine_name: "dev-machine",
+          daemon_running: true,
+          active_jobs: [
+            { issue: 10, stage: "plan" },
+            { issue: 20, stage: "code" },
+          ],
+          queued: [30],
+        },
+      ],
+    };
+    const data = emptyFleetState();
+    data.team = teamData;
+    teamView.render(data);
+    const grid = document.getElementById("team-grid");
+    expect(grid!.innerHTML).toContain("team-card-pipeline-item");
+    expect(grid!.innerHTML).toContain("#10");
+    expect(grid!.innerHTML).toContain("#20");
+  });
+
+  it("uses teamCache when data.team is absent", async () => {
+    const { teamView } = await import("./team");
+    const cachedTeam: TeamData = {
+      developers: [
+        {
+          developer_id: "cached",
+          machine_name: "cache-machine",
+          daemon_running: false,
+          active_jobs: [],
+          queued: [],
+        },
+      ],
+      total_online: 1,
+      total_active_pipelines: 0,
+      total_queued: 0,
+    };
+    store.set("teamCache", cachedTeam);
+    const data = emptyFleetState();
+    data.team = undefined;
+    teamView.render(data);
+    const grid = document.getElementById("team-grid");
+    expect(grid!.innerHTML).toContain("cached");
+  });
+
+  it("init and destroy do not throw", async () => {
+    const { teamView } = await import("./team");
+    expect(() => teamView.init()).not.toThrow();
+    expect(() => teamView.destroy()).not.toThrow();
+  });
+});

package/dashboard/vitest.config.ts

@@ -10,12 +10,21 @@ export default defineConfig({
       provider: "v8",
       reporter: ["text", "json-summary"],
       include: ["src/**/*.ts"],
-      exclude: ["src/**/*.test.ts", "src/types/**"],
+      exclude: [
+        "src/**/*.test.ts",
+        "src/types/**",
+        "src/views/**",
+        "src/canvas/**",
+        "src/components/header.ts",
+        "src/components/modal.ts",
+        "src/components/terminal.ts",
+        "src/main.ts",
+      ],
       thresholds: {
-        statements: 60,
-        branches: 50,
-        functions: 60,
-        lines: 60,
+        statements: 70,
+        branches: 60,
+        functions: 70,
+        lines: 70,
       },
     },
   },

package/docs/TIPS.md

@@ -131,7 +131,7 @@ This compacts the conversation when it hits 70% of the context window (default i
 
 ### Watch all agents at once
 
-Use `shipwright status` (alias: `sw`, `cct`) to see a dashboard of running team sessions:
+Use `shipwright status` (alias: `sw`) to see a dashboard of running team sessions:
 
 ```bash
 shipwright status

package/docs/patterns/README.md

@@ -85,7 +85,7 @@ Each agent writes its results to a markdown file in this directory. The team lea
 
 ## Quick Start
 
-Pick a pattern, then use `shipwright` (alias: `sw`, `cct`) to set up the team:
+Pick a pattern, then use `shipwright` (alias: `sw`) to set up the team:
 
 ```bash
 # Start a tmux session

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "shipwright-cli",
-  "version": "2.4.0",
+  "version": "3.1.0",
   "description": "Orchestrate autonomous Claude Code agent teams in tmux",
   "bin": {
-    "shipwright": "./scripts/sw",
-    "sw": "./scripts/sw",
-    "cct": "./scripts/sw"
+    "shipwright": "scripts/sw",
+    "sw": "scripts/sw",
+    "cct": "scripts/sw"
   },
   "files": [
     "config/",
@@ -36,9 +36,9 @@
     "dashboard:test": "vitest run --config dashboard/vitest.config.ts",
     "dashboard:test:watch": "vitest --config dashboard/vitest.config.ts",
     "dashboard:test:coverage": "vitest run --config dashboard/vitest.config.ts --coverage",
-    "test": "bash scripts/sw-agi-roadmap-test.sh && bash scripts/sw-activity-test.sh && bash scripts/sw-adaptive-test.sh && bash scripts/sw-adversarial-test.sh && bash scripts/sw-architecture-enforcer-test.sh && bash scripts/sw-auth-test.sh && bash scripts/sw-autonomous-test.sh && bash scripts/sw-changelog-test.sh && bash scripts/sw-checkpoint-test.sh && bash scripts/sw-ci-test.sh && bash scripts/sw-cleanup-test.sh && bash scripts/sw-code-review-test.sh && bash scripts/sw-connect-test.sh && bash scripts/sw-context-test.sh && bash scripts/sw-cost-test.sh && bash scripts/sw-daemon-test.sh && bash scripts/sw-dashboard-test.sh && bash scripts/sw-db-test.sh && bash scripts/sw-decompose-test.sh && bash scripts/sw-deps-test.sh && bash scripts/sw-developer-simulation-test.sh && bash scripts/sw-discovery-test.sh && bash scripts/sw-doc-fleet-test.sh && bash scripts/sw-docs-agent-test.sh && bash scripts/sw-docs-test.sh && bash scripts/sw-doctor-test.sh && bash scripts/sw-dora-test.sh && bash scripts/sw-durable-test.sh && bash scripts/sw-e2e-orchestrator-test.sh && bash scripts/sw-eventbus-test.sh && bash scripts/sw-feedback-test.sh && bash scripts/sw-fix-test.sh && bash scripts/sw-fleet-discover-test.sh && bash scripts/sw-fleet-test.sh && bash scripts/sw-fleet-viz-test.sh && bash scripts/sw-frontier-test.sh && bash scripts/sw-github-app-test.sh && bash scripts/sw-github-checks-test.sh && bash scripts/sw-github-deploy-test.sh && bash scripts/sw-github-graphql-test.sh && bash scripts/sw-guild-test.sh && bash scripts/sw-heartbeat-test.sh && bash scripts/sw-hygiene-test.sh && bash scripts/sw-incident-test.sh && bash scripts/sw-init-test.sh && bash scripts/sw-instrument-test.sh && bash scripts/sw-intelligence-test.sh && bash scripts/sw-jira-test.sh && bash scripts/sw-launchd-test.sh && bash scripts/sw-linear-test.sh && bash scripts/sw-logs-test.sh && bash scripts/sw-loop-test.sh && bash scripts/sw-memory-test.sh && bash scripts/sw-mission-control-test.sh && bash scripts/sw-model-router-test.sh && bash scripts/sw-otel-test.sh && bash scripts/sw-oversight-test.sh && bash scripts/sw-patrol-meta-test.sh && bash scripts/sw-pipeline-composer-test.sh && bash scripts/sw-pipeline-test.sh && bash scripts/sw-pipeline-vitals-test.sh && bash scripts/sw-pm-test.sh && bash scripts/sw-pr-lifecycle-test.sh && bash scripts/sw-predictive-test.sh && bash scripts/sw-prep-test.sh && bash scripts/sw-ps-test.sh && bash scripts/sw-public-dashboard-test.sh && bash scripts/sw-quality-test.sh && bash scripts/sw-reaper-test.sh && bash scripts/sw-recruit-test.sh && bash scripts/sw-regression-test.sh && bash scripts/sw-release-manager-test.sh && bash scripts/sw-release-test.sh && bash scripts/sw-remote-test.sh && bash scripts/sw-replay-test.sh && bash scripts/sw-retro-test.sh && bash scripts/sw-scale-test.sh && bash scripts/sw-security-audit-test.sh && bash scripts/sw-self-optimize-test.sh && bash scripts/sw-session-test.sh && bash scripts/sw-setup-test.sh && bash scripts/sw-standup-test.sh && bash scripts/sw-status-test.sh && bash scripts/sw-strategic-test.sh && bash scripts/sw-stream-test.sh && bash scripts/sw-swarm-test.sh && bash scripts/sw-team-stages-test.sh && bash scripts/sw-templates-test.sh && bash scripts/sw-testgen-test.sh && bash scripts/sw-tmux-pipeline-test.sh && bash scripts/sw-tmux-test.sh && bash scripts/sw-trace-test.sh && bash scripts/sw-tracker-test.sh && bash scripts/sw-triage-test.sh && bash scripts/sw-upgrade-test.sh && bash scripts/sw-ux-test.sh && bash scripts/sw-webhook-test.sh && bash scripts/sw-widgets-test.sh && bash scripts/sw-worktree-test.sh && bash scripts/sw-policy-e2e-test.sh && bash scripts/sw-e2e-smoke-test.sh && bash scripts/sw-dashboard-e2e-test.sh",
+    "test": "bash scripts/sw-agi-roadmap-test.sh && bash scripts/sw-activity-test.sh && bash scripts/sw-adaptive-test.sh && bash scripts/sw-adversarial-test.sh && bash scripts/sw-architecture-enforcer-test.sh && bash scripts/sw-auth-test.sh && bash scripts/sw-autonomous-test.sh && bash scripts/sw-changelog-test.sh && bash scripts/sw-checkpoint-test.sh && bash scripts/sw-ci-test.sh && bash scripts/sw-cleanup-test.sh && bash scripts/sw-code-review-test.sh && bash scripts/sw-connect-test.sh && bash scripts/sw-context-test.sh && bash scripts/sw-cost-test.sh && bash scripts/sw-daemon-test.sh && bash scripts/sw-dashboard-test.sh && bash scripts/sw-db-test.sh && bash scripts/sw-decompose-test.sh && bash scripts/sw-decide-test.sh && bash scripts/sw-deps-test.sh && bash scripts/sw-developer-simulation-test.sh && bash scripts/sw-discovery-test.sh && bash scripts/sw-doc-fleet-test.sh && bash scripts/sw-docs-agent-test.sh && bash scripts/sw-docs-test.sh && bash scripts/sw-doctor-test.sh && bash scripts/sw-dora-test.sh && bash scripts/sw-durable-test.sh && bash scripts/sw-e2e-orchestrator-test.sh && bash scripts/sw-eventbus-test.sh && bash scripts/sw-feedback-test.sh && bash scripts/sw-fix-test.sh && bash scripts/sw-fleet-discover-test.sh && bash scripts/sw-fleet-test.sh && bash scripts/sw-fleet-viz-test.sh && bash scripts/sw-frontier-test.sh && bash scripts/sw-github-app-test.sh && bash scripts/sw-github-checks-test.sh && bash scripts/sw-github-deploy-test.sh && bash scripts/sw-github-graphql-test.sh && bash scripts/sw-guild-test.sh && bash scripts/sw-heartbeat-test.sh && bash scripts/sw-hygiene-test.sh && bash scripts/sw-incident-test.sh && bash scripts/sw-init-test.sh && bash scripts/sw-instrument-test.sh && bash scripts/sw-intelligence-test.sh && bash scripts/sw-jira-test.sh && bash scripts/sw-launchd-test.sh && bash scripts/sw-linear-test.sh && bash scripts/sw-logs-test.sh && bash scripts/sw-loop-test.sh && bash scripts/sw-memory-test.sh && bash scripts/sw-mission-control-test.sh && bash scripts/sw-model-router-test.sh && bash scripts/sw-otel-test.sh && bash scripts/sw-oversight-test.sh && bash scripts/sw-patrol-meta-test.sh && bash scripts/sw-pipeline-composer-test.sh && bash scripts/sw-pipeline-test.sh && bash scripts/sw-pipeline-vitals-test.sh && bash scripts/sw-pm-test.sh && bash scripts/sw-pr-lifecycle-test.sh && bash scripts/sw-predictive-test.sh && bash scripts/sw-prep-test.sh && bash scripts/sw-ps-test.sh && bash scripts/sw-public-dashboard-test.sh && bash scripts/sw-quality-test.sh && bash scripts/sw-reaper-test.sh && bash scripts/sw-recruit-test.sh && bash scripts/sw-regression-test.sh && bash scripts/sw-release-manager-test.sh && bash scripts/sw-release-test.sh && bash scripts/sw-remote-test.sh && bash scripts/sw-replay-test.sh && bash scripts/sw-retro-test.sh && bash scripts/sw-scale-test.sh && bash scripts/sw-security-audit-test.sh && bash scripts/sw-self-optimize-test.sh && bash scripts/sw-session-test.sh && bash scripts/sw-setup-test.sh && bash scripts/sw-standup-test.sh && bash scripts/sw-status-test.sh && bash scripts/sw-strategic-test.sh && bash scripts/sw-stream-test.sh && bash scripts/sw-swarm-test.sh && bash scripts/sw-team-stages-test.sh && bash scripts/sw-templates-test.sh && bash scripts/sw-testgen-test.sh && bash scripts/sw-tmux-pipeline-test.sh && bash scripts/sw-tmux-test.sh && bash scripts/sw-trace-test.sh && bash scripts/sw-tracker-test.sh && bash scripts/sw-triage-test.sh && bash scripts/sw-upgrade-test.sh && bash scripts/sw-ux-test.sh && bash scripts/sw-webhook-test.sh && bash scripts/sw-widgets-test.sh && bash scripts/sw-worktree-test.sh && bash scripts/sw-lib-compat-test.sh && bash scripts/sw-lib-helpers-test.sh && bash scripts/sw-lib-daemon-dispatch-test.sh && bash scripts/sw-lib-daemon-failure-test.sh && bash scripts/sw-lib-daemon-poll-test.sh && bash scripts/sw-lib-daemon-state-test.sh && bash scripts/sw-lib-daemon-triage-test.sh && bash scripts/sw-lib-pipeline-detection-test.sh && bash scripts/sw-lib-pipeline-intelligence-test.sh && bash scripts/sw-lib-pipeline-quality-checks-test.sh && bash scripts/sw-lib-pipeline-stages-test.sh && bash scripts/sw-lib-pipeline-state-test.sh && bash scripts/sw-adapters-test.sh && bash scripts/sw-evidence-test.sh && bash scripts/sw-review-rerun-test.sh && bash scripts/sw-tracker-providers-test.sh && bash scripts/sw-budget-chaos-test.sh && bash scripts/sw-autonomous-e2e-test.sh && bash scripts/sw-memory-discovery-e2e-test.sh && bash scripts/sw-policy-e2e-test.sh && bash scripts/sw-e2e-smoke-test.sh && bash scripts/sw-dashboard-e2e-test.sh",
     "test:smoke": "bash scripts/sw-e2e-smoke-test.sh",
-    "test:integration": "bash scripts/sw-e2e-integration-test.sh",
+    "test:integration": "bash scripts/sw-e2e-integration-test.sh && bash scripts/sw-e2e-system-test.sh && bash scripts/sw-server-api-test.sh && bash scripts/sw-integration-claude-test.sh",
     "harness:evidence:capture": "bash scripts/sw-evidence.sh capture",
     "harness:evidence:verify": "bash scripts/sw-evidence.sh verify",
     "harness:evidence:pre-pr": "bash scripts/sw-evidence.sh pre-pr",
@@ -48,9 +48,7 @@
     "harness:evidence:capture:cli": "bash scripts/sw-evidence.sh capture cli",
     "harness:ui:capture-browser-evidence": "bash scripts/sw-evidence.sh capture browser",
     "harness:ui:verify-browser-evidence": "bash scripts/sw-evidence.sh verify",
-    "harness:ui:pre-pr": "bash scripts/sw-evidence.sh pre-pr browser",
-    "harness:risk-tier": "bash scripts/sw-pr-lifecycle.sh risk-tier",
-    "harness:policy-gate": "bash scripts/sw-pr-lifecycle.sh policy-gate"
+    "harness:ui:pre-pr": "bash scripts/sw-evidence.sh pre-pr browser"
   },
   "keywords": [
     "claude",

package/scripts/adapters/docker-deploy.sh

@@ -38,7 +38,7 @@ get_rollback_cmd() {
 }
 
 get_health_url() {
-    echo "http://localhost:3000/health"
+    echo "http://localhost:8767/health"
 }
 
 get_smoke_cmd() {

package/scripts/adapters/tmux-adapter.sh

@@ -14,9 +14,14 @@
 # Track spawned panes by agent name → pane ID (file-based for bash 3.2 compat)
 _TMUX_PANE_MAP="${TMPDIR:-/tmp}/shipwright-tmux-pane-map.$$"
 : > "$_TMUX_PANE_MAP"
-trap 'rm -f "$_TMUX_PANE_MAP"' EXIT
+trap '
+    if [[ -f "$_TMUX_PANE_MAP" ]] && [[ ! -s "$_TMUX_PANE_MAP" ]]; then
+        rm -f "$_TMUX_PANE_MAP"
+    fi
+' EXIT
 
 spawn_agent() {
+    [[ -z "${WINDOW_NAME:-}" ]] && { echo "ERROR: WINDOW_NAME not set" >&2; return 1; }
     local name="$1"
     local working_dir="${2:-#{pane_current_path}}"
     local command="${3:-}"
@@ -32,6 +37,11 @@ spawn_agent() {
         new_pane_id=$(tmux split-window -t "$WINDOW_NAME" -c "$working_dir" -P -F '#{pane_id}')
     fi
 
+    if [[ -z "$new_pane_id" ]]; then
+        echo "ERROR: Failed to create tmux pane for agent '$name'" >&2
+        return 1
+    fi
+
     # Record the mapping: name → pane_id
     echo "${name}=${new_pane_id}" >> "$_TMUX_PANE_MAP"
 

package/scripts/adapters/wezterm-adapter.sh

@@ -9,7 +9,7 @@
 # ╚═══════════════════════════════════════════════════════════════════════════╝
 
 # Verify wezterm CLI is available
-if ! command -v wezterm &>/dev/null; then
+if ! command -v wezterm >/dev/null 2>&1; then
     echo -e "\033[38;2;248;113;113m\033[1m✗\033[0m wezterm CLI not found. Install WezTerm first." >&2
     exit 1
 fi

package/scripts/check-version-consistency.sh

@@ -11,7 +11,7 @@ REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 
 CANONICAL=""
 if [[ -f "$REPO_ROOT/package.json" ]]; then
-  if command -v jq &>/dev/null; then
+  if command -v jq >/dev/null 2>&1; then
     CANONICAL="$(jq -r .version "$REPO_ROOT/package.json")"
   else
     CANONICAL="$(grep -oE '"version":\s*"[^"]+"' "$REPO_ROOT/package.json" | head -1 | sed 's/.*"\([^"]*\)".*/\1/')"

package/scripts/lib/architecture.sh

@@ -0,0 +1,127 @@
+# architecture.sh — Gather call-graph and dependency context for plan/design stages
+# Source from pipeline-stages. Requires compat (detect_primary_language).
+[[ -n "${_ARCHITECTURE_CONTEXT_LOADED:-}" ]] && return 0
+_ARCHITECTURE_CONTEXT_LOADED=1
+
+# Gather rich architecture context: structure, imports, modules, entry points, test map
+gather_architecture_context() {
+    local repo_root="${1:-.}"
+    local context=""
+
+    # 1. File structure
+    context="## Project Structure
+$(find "$repo_root" -type f \( -name '*.ts' -o -name '*.js' -o -name '*.py' -o -name '*.sh' -o -name '*.go' -o -name '*.rs' \) 2>/dev/null | grep -v node_modules | grep -v .git | head -100 | sort)
+
+"
+
+    # 2. Import/dependency graph (language-specific)
+    local lang=""
+    if type detect_primary_language >/dev/null 2>&1; then
+        lang=$(detect_primary_language "$repo_root" 2>/dev/null || echo "unknown")
+    else
+        lang="unknown"
+    fi
+
+    case "$lang" in
+        typescript|javascript|nodejs)
+            context="${context}## Import Graph (Top Dependencies)
+"
+            local imports=""
+            for dir in "$repo_root/src" "$repo_root/lib" "$repo_root/app"; do
+                [[ -d "$dir" ]] || continue
+                imports=$(grep -rh "^import .* from\|require(" "$dir" 2>/dev/null | \
+                    grep -oE "from ['\"]([^'\"]+)['\"]|require\\(['\"]([^'\"]+)['\"]\\)" | \
+                    sed "s/from ['\"]//;s/['\"]//g;s/require(//;s/)//g" | \
+                    sort | uniq -c | sort -rn | head -20)
+                [[ -n "$imports" ]] && context="${context}${imports}
+"
+            done
+            [[ -z "$imports" ]] && context="${context}(none detected)
+"
+
+            context="${context}## Module Export Counts
+"
+            local f
+            while IFS= read -r f; do
+                [[ -f "$f" ]] || continue
+                local exports=0
+                exports=$(grep -c "^export " "$f" 2>/dev/null || true)
+                exports="${exports:-0}"
+                [[ "$exports" -gt 2 ]] 2>/dev/null && context="${context}  $(basename "$f"): $exports exports
+"
+            done < <(find "$repo_root/src" "$repo_root/lib" -name "*.ts" -o -name "*.js" 2>/dev/null | head -30)
+            ;;
+
+        python)
+            context="${context}## Import Graph (Top Dependencies)
+"
+            local py_imports=""
+            py_imports=$(find "$repo_root" -name "*.py" -type f 2>/dev/null | \
+                xargs grep -h "^from \|^import " 2>/dev/null | \
+                grep -v __pycache__ | sort | uniq -c | sort -rn | head -20)
+            context="${context}${py_imports}
+"
+            ;;
+
+        bash|shell)
+            context="${context}## Source Dependencies
+"
+            local sh_imports=""
+            [[ -d "$repo_root/scripts" ]] && \
+                sh_imports=$(grep -rh "^source \|^\. " "$repo_root/scripts" --include="*.sh" 2>/dev/null | \
+                    sort | uniq -c | sort -rn | head -20)
+            context="${context}${sh_imports}
+"
+            ;;
+        *)
+            context="${context}## Dependencies
+(Language: $lang — no specific import analysis)
+"
+            ;;
+    esac
+
+    # 3. Module boundaries (directories with >2 files = modules)
+    context="${context}## Module Boundaries
+"
+    local dir
+    while IFS= read -r dir; do
+        [[ -d "$dir" ]] || continue
+        local count=0
+        count=$(find "$dir" -maxdepth 1 -type f \( -name "*.ts" -o -name "*.js" -o -name "*.py" -o -name "*.sh" \) 2>/dev/null | wc -l | tr -d ' ')
+        [[ "$count" -gt 2 ]] 2>/dev/null && context="${context}  $(basename "$dir")/: $count files
+"
+    done < <(find "$repo_root/src" "$repo_root/lib" "$repo_root/scripts" -maxdepth 2 -type d 2>/dev/null | head -30)
+
+    # 4. Entry points
+    context="${context}## Entry Points
+"
+    if [[ -f "$repo_root/package.json" ]] && command -v jq >/dev/null 2>&1; then
+        local main
+        main=$(jq -r '.main // .bin // "index.js" | if type == "object" then (. | keys[0]) else . end' "$repo_root/package.json" 2>/dev/null || echo "")
+        [[ -n "$main" && "$main" != "null" ]] && context="${context}  package.json: $main
+"
+    fi
+    if [[ -f "$repo_root/Makefile" ]]; then
+        local targets
+        targets=$(grep '^[a-zA-Z][a-zA-Z0-9_-]*:' "$repo_root/Makefile" 2>/dev/null | cut -d: -f1 | head -10 | tr '\n' ', ')
+        [[ -n "$targets" ]] && context="${context}  Makefile targets: $targets
+"
+    fi
+
+    # 5. Test-to-source mapping
+    context="${context}## Test Coverage Map
+"
+    local test_file
+    while IFS= read -r test_file; do
+        [[ -f "$test_file" ]] || continue
+        local base
+        base=$(basename "$test_file" | sed 's/[-.]test//;s/[-.]spec//;s/__tests__//;s/\..*$//' | head -c 50)
+        [[ -z "$base" ]] && continue
+        local source
+        source=$(find "$repo_root/src" "$repo_root/lib" "$repo_root/scripts" -name "${base}.*" -type f 2>/dev/null | head -1)
+        [[ -n "$source" ]] && context="${context}  $test_file -> $source
+"
+    done < <(find "$repo_root" -path "*node_modules" -prune -o -path "*/.git" -prune -o \( -name "*test*" -o -name "*spec*" \) -type f -print 2>/dev/null | head -20)
+
+    echo "$context"
+}

package/scripts/lib/bootstrap.sh

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  shipwright bootstrap — Cold-start initialization for optimization data  ║
+# ║  Creates sensible defaults when no historical data exists (new installs)  ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+
+# bootstrap_optimization — create default iteration model, template weights, model routing
+bootstrap_optimization() {
+    local opt_dir="$HOME/.shipwright/optimization"
+    mkdir -p "$opt_dir"
+
+    # Default iteration model based on common patterns
+    if [[ ! -f "$opt_dir/iteration-model.json" ]]; then
+        cat > "$opt_dir/iteration-model.json" << 'JSON'
+{
+    "low": {"mean": 5, "stddev": 2, "samples": 0, "source": "bootstrap"},
+    "medium": {"mean": 12, "stddev": 4, "samples": 0, "source": "bootstrap"},
+    "high": {"mean": 25, "stddev": 8, "samples": 0, "source": "bootstrap"}
+}
+JSON
+    fi
+
+    # Default template weights
+    if [[ ! -f "$opt_dir/template-weights.json" ]]; then
+        cat > "$opt_dir/template-weights.json" << 'JSON'
+{
+    "standard": 1.0,
+    "hotfix": 1.0,
+    "docs": 1.0,
+    "refactor": 1.0,
+    "source": "bootstrap"
+}
+JSON
+    fi
+
+    # Default model routing
+    if [[ ! -f "$opt_dir/model-routing.json" ]]; then
+        cat > "$opt_dir/model-routing.json" << 'JSON'
+{
+    "routes": {
+        "plan": {"recommended": "opus", "source": "bootstrap"},
+        "design": {"recommended": "opus", "source": "bootstrap"},
+        "build": {"recommended": "sonnet", "source": "bootstrap"},
+        "test": {"recommended": "sonnet", "source": "bootstrap"},
+        "review": {"recommended": "sonnet", "source": "bootstrap"}
+    },
+    "default": "sonnet",
+    "source": "bootstrap"
+}
+JSON
+    fi
+}
+
+# bootstrap_memory — create initial memory patterns based on project type
+bootstrap_memory() {
+    local mem_dir="$HOME/.shipwright/memory"
+    mkdir -p "$mem_dir"
+
+    if [[ ! -f "$mem_dir/patterns.json" ]]; then
+        # Detect project type and create initial patterns
+        local project_type="unknown"
+        [[ -f "package.json" ]] && project_type="nodejs"
+        [[ -f "requirements.txt" || -f "pyproject.toml" ]] && project_type="python"
+        [[ -f "Cargo.toml" ]] && project_type="rust"
+        [[ -f "go.mod" ]] && project_type="go"
+
+        cat > "$mem_dir/patterns.json" << JSON
+{
+    "project_type": "$project_type",
+    "detected_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+    "source": "bootstrap"
+}
+JSON
+    fi
+}