gsd-pi 2.37.0 → 2.37.1-dev.7352347

package/README.md

@@ -16,7 +16,7 @@ This version is different. GSD is now a standalone CLI built on the [Pi SDK](htt
 
 One command. Walk away. Come back to a built project with clean git history.
 
-<pre><code>npm install -g gsd-pi</code></pre>
+<pre><code>npm install -g gsd-pi@latest</code></pre>
 
 > **📋 NOTICE: New to Node on Mac?** If you installed Node.js via Homebrew, you may be running a development release instead of LTS. **[Read this guide](./docs/node-lts-macos.md)** to pin Node 24 LTS and avoid compatibility issues.
 
@@ -24,19 +24,19 @@ One command. Walk away. Come back to a built project with clean git history.
 
 ---
 
-## What's New in v2.33
+## What's New in v2.37
 
-- **Dispatch loop hardening** — defensive guards, reentrancy protection, and 125 new regression tests covering the full `deriveState → resolveDispatch` chain without an LLM
-- **Live regression test harness** — post-build pipeline validation that catches dispatch, parser, and lock lifecycle regressions before promotion
-- **Unified error handling** — `getErrorMessage()` helper replaces 65 inline duplicates across the codebase
-- **Centralized unit ID parsing** — `parseUnitId()` eliminates fragile regex patterns scattered across dispatch, recovery, and metrics code
-- **Milestone merge consolidation** — `tryMergeMilestone()` replaces 4 duplicate merge paths in the auto-mode loop
-- **Lock alignment fix** — retry lock path now matches primary lock settings, preventing `ECOMPROMISED` errors on resume
-- **NixOS/nix-darwin support** — symlinks in `.gsd/` are skipped during `makeTreeWritable` to prevent `EPERM` failures
-- **Windows EPERM fallback** — `.gsd/` migration uses copy+delete when NTFS blocks direct rename
-- **Worktree identity fix** — stable project hash resolved from main repo root, not worktree path
-- **Quick-task branch cleanup** — `/gsd quick` branches auto-merge back to the original branch after completion
-- **Crash recovery guidance** — actionable next-step messages based on what was interrupted and what state survived
+- **cmux integration** — sidebar status, progress bars, and notifications for [cmux](https://cmux.com) terminal multiplexer users
+- **Redesigned dashboard** — two-column layout with redesigned widget
+- **Search budget enforcement** — session-level search budget prevents unbounded native web search
+- **AGENTS.md support** — deprecated `agent-instructions.md` in favor of standard `AGENTS.md` / `CLAUDE.md`
+- **AI-powered triage** — automated issue and PR triage via Claude Haiku
+- **Auto-generated OpenRouter registry** — model registry built from OpenRouter API for always-current model support
+- **Extension manifest system** — user-managed enable/disable for bundled extensions
+- **Pipeline simplification (ADR-003)** — merged research into planning, mechanical completion
+- **Workflow templates** — right-sized workflows for every task type
+- **Health widget** — always-on environment health checks with progress scoring
+- **`/gsd changelog`** — LLM-summarized release notes for any version
 
 See the full [Changelog](./CHANGELOG.md) for details.
 
@@ -49,7 +49,7 @@ Full documentation is available in the [`docs/`](./docs/) directory:
 - **[Getting Started](./docs/getting-started.md)** — install, first run, basic usage
 - **[Auto Mode](./docs/auto-mode.md)** — autonomous execution deep-dive
 - **[Configuration](./docs/configuration.md)** — all preferences, models, git, and hooks
-- **[Token Optimization](./docs/token-optimization.md)** — profiles, context compression, complexity routing (v2.17)
+- **[Token Optimization](./docs/token-optimization.md)** — profiles, context compression, complexity routing
 - **[Cost Management](./docs/cost-management.md)** — budgets, tracking, projections
 - **[Git Strategy](./docs/git-strategy.md)** — worktree isolation, branching, merge behavior
 - **[Parallel Orchestration](./docs/parallel-orchestration.md)** — run multiple milestones simultaneously
@@ -463,9 +463,9 @@ Place an `AGENTS.md` file in any directory to provide persistent behavioral guid
 
 Start GSD with `gsd --debug` to enable structured JSONL diagnostic logging. Debug logs capture dispatch decisions, state transitions, and timing data for troubleshooting auto-mode issues.
 
-### Token Optimization (v2.17)
+### Token Optimization
 
-GSD 2.17 introduced a coordinated token optimization system that reduces usage by 40-60% on cost-sensitive workloads. Set a single preference to coordinate model selection, phase skipping, and context compression:
+GSD includes a coordinated token optimization system that reduces usage by 40-60% on cost-sensitive workloads. Set a single preference to coordinate model selection, phase skipping, and context compression:
 
 ```yaml
 token_profile: budget      # or balanced (default), quality
@@ -485,7 +485,7 @@ See the full [Token Optimization Guide](./docs/token-optimization.md) for detail
 
 ### Bundled Tools
 
-GSD ships with 18 extensions, all loaded automatically:
+GSD ships with 19 extensions, all loaded automatically:
 
 | Extension              | What it provides                                                                                                       |
 | ---------------------- | ---------------------------------------------------------------------------------------------------------------------- |
@@ -495,12 +495,13 @@ GSD ships with 18 extensions, all loaded automatically:
 | **Google Search**      | Gemini-powered web search with AI-synthesized answers                                                                  |
 | **Context7**           | Up-to-date library/framework documentation                                                                             |
 | **Background Shell**   | Long-running process management with readiness detection                                                               |
+| **Async Jobs**         | Background bash commands with job tracking and cancellation                                                            |
 | **Subagent**           | Delegated tasks with isolated context windows                                                                          |
+| **GitHub**             | Full-suite GitHub issues and PR management via `/gh` command                                                           |
 | **Mac Tools**          | macOS native app automation via Accessibility APIs                                                                     |
 | **MCP Client**         | Native MCP server integration via @modelcontextprotocol/sdk                                                            |
 | **Voice**              | Real-time speech-to-text transcription (macOS, Linux — Ubuntu 22.04+)                                                  |
 | **Slash Commands**     | Custom command creation                                                                                                |
-| **LSP**                | Language Server Protocol integration — diagnostics, go-to-definition, references, hover, symbols, rename, code actions |
 | **Ask User Questions** | Structured user input with single/multi-select                                                                         |
 | **Secure Env Collect** | Masked secret collection without manual .env editing                                                                   |
 | **Remote Questions**   | Route decisions to Slack/Discord when human input is needed in headless/CI mode                                         |
@@ -591,7 +592,7 @@ gsd (CLI binary)
           ├─ resource-loader.ts  Syncs bundled extensions + agents to ~/.gsd/agent/
           └─ src/resources/
               ├─ extensions/gsd/    Core GSD extension (auto, state, commands, ...)
-              ├─ extensions/...     12 supporting extensions
+              ├─ extensions/...     18 supporting extensions
               ├─ agents/            scout, researcher, worker
               ├─ AGENTS.md          Agent routing instructions
               └─ GSD-WORKFLOW.md    Manual bootstrap protocol
@@ -628,7 +629,7 @@ GSD isn't locked to one provider. It runs on the [Pi SDK](https://github.com/bad
 
 ### Built-in Providers
 
-Anthropic, OpenAI, Google (Gemini), OpenRouter, GitHub Copilot, Amazon Bedrock, Azure OpenAI, Google Vertex, Groq, Cerebras, Mistral, xAI, HuggingFace, Vercel AI Gateway, and more.
+Anthropic, Anthropic (Vertex AI), OpenAI, Google (Gemini), OpenRouter, GitHub Copilot, Amazon Bedrock, Azure OpenAI, Google Vertex, Groq, Cerebras, Mistral, xAI, HuggingFace, Vercel AI Gateway, and more.
 
 ### OAuth / Max Plans
 

package/dist/onboarding.js

@@ -38,6 +38,7 @@ const TOOL_KEYS = [
 /** Known LLM provider IDs that, if authed, mean the user doesn't need onboarding */
 const LLM_PROVIDER_IDS = [
     'anthropic',
+    'anthropic-vertex',
     'openai',
     'github-copilot',
     'openai-codex',

package/dist/resources/extensions/cmux/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@gsd/cmux",
+  "private": true,
+  "type": "module",
+  "description": "cmux integration library — used by other extensions, not an extension itself",
+  "pi": {}
+}

package/dist/resources/extensions/gsd/auto-loop.js

@@ -218,10 +218,24 @@ export async function autoLoop(ctx, pi, s, deps) {
         }
         try {
             // ── Blanket try/catch: one bad iteration must not kill the session
-            if (deps.lockBase() && !deps.validateSessionLock(deps.lockBase())) {
-                deps.handleLostSessionLock(ctx);
-                debugLog("autoLoop", { phase: "exit", reason: "session-lock-lost" });
-                break;
+            const sessionLockBase = deps.lockBase();
+            if (sessionLockBase) {
+                const lockStatus = deps.validateSessionLock(sessionLockBase);
+                if (!lockStatus.valid) {
+                    debugLog("autoLoop", {
+                        phase: "session-lock-invalid",
+                        reason: lockStatus.failureReason ?? "unknown",
+                        existingPid: lockStatus.existingPid,
+                        expectedPid: lockStatus.expectedPid,
+                    });
+                    deps.handleLostSessionLock(ctx, lockStatus);
+                    debugLog("autoLoop", {
+                        phase: "exit",
+                        reason: "session-lock-lost",
+                        detail: lockStatus.failureReason ?? "unknown",
+                    });
+                    break;
+                }
             }
             // ── Phase 1: Pre-dispatch ───────────────────────────────────────────
             // Resource version guard

package/dist/resources/extensions/gsd/auto.js

@@ -18,7 +18,7 @@ import { invalidateAllCaches } from "./cache.js";
 import { clearActivityLogState } from "./activity-log.js";
 import { synthesizeCrashRecovery, getDeepDiagnostic, } from "./session-forensics.js";
 import { writeLock, clearLock, readCrashLock, isLockProcessAlive, } from "./crash-recovery.js";
-import { acquireSessionLock, validateSessionLock, releaseSessionLock, updateSessionLock, } from "./session-lock.js";
+import { acquireSessionLock, getSessionLockStatus, releaseSessionLock, updateSessionLock, } from "./session-lock.js";
 import { clearUnitRuntimeRecord, readUnitRuntimeRecord, writeUnitRuntimeRecord, } from "./unit-runtime.js";
 import { resolveAutoSupervisorConfig, loadEffectiveGSDPreferences, getIsolationMode, } from "./preferences.js";
 import { sendDesktopNotification } from "./notifications.js";
@@ -209,6 +209,29 @@ export function stopAutoRemote(projectRoot) {
         return { found: false, error: err.message };
     }
 }
+/**
+ * Check if a remote auto-mode session is running (from a different process).
+ * Reads the crash lock, checks PID liveness, and returns session details.
+ * Used by the guard in commands.ts to prevent bare /gsd, /gsd next, and
+ * /gsd auto from stealing the session lock.
+ */
+export function checkRemoteAutoSession(projectRoot) {
+    const lock = readCrashLock(projectRoot);
+    if (!lock)
+        return { running: false };
+    if (!isLockProcessAlive(lock)) {
+        // Stale lock from a dead process — not a live remote session
+        return { running: false };
+    }
+    return {
+        running: true,
+        pid: lock.pid,
+        unitType: lock.unitType,
+        unitId: lock.unitId,
+        startedAt: lock.startedAt,
+        completedUnits: lock.completedUnits,
+    };
+}
 export function isStepMode() {
     return s.stepMode;
 }
@@ -243,14 +266,28 @@ function buildSnapshotOpts(unitType, unitId) {
         ...(runtime?.continueHereFired ? { continueHereFired: true } : {}),
     };
 }
-function handleLostSessionLock(ctx) {
-    debugLog("session-lock-lost", { lockBase: lockBase() });
+function handleLostSessionLock(ctx, lockStatus) {
+    debugLog("session-lock-lost", {
+        lockBase: lockBase(),
+        reason: lockStatus?.failureReason,
+        existingPid: lockStatus?.existingPid,
+        expectedPid: lockStatus?.expectedPid,
+    });
     s.active = false;
     s.paused = false;
     clearUnitTimeout();
     deregisterSigtermHandler();
     clearCmuxSidebar(loadEffectiveGSDPreferences()?.preferences);
-    ctx?.ui.notify("Session lock lost — another GSD process appears to have taken over. Stopping gracefully.", "error");
+    const message = lockStatus?.failureReason === "pid-mismatch"
+        ? lockStatus.existingPid
+            ? `Session lock moved to PID ${lockStatus.existingPid} — another GSD process appears to have taken over. Stopping gracefully.`
+            : "Session lock moved to a different process — another GSD process appears to have taken over. Stopping gracefully."
+        : lockStatus?.failureReason === "missing-metadata"
+            ? "Session lock metadata disappeared, so ownership could not be confirmed. Stopping gracefully."
+            : lockStatus?.failureReason === "compromised"
+                ? "Session lock was compromised or invalidated during heartbeat checks; takeover was not confirmed. Stopping gracefully."
+                : "Session lock lost. Stopping gracefully.";
+    ctx?.ui.notify(message, "error");
     ctx?.ui.setStatus("gsd-auto", undefined);
     ctx?.ui.setWidget("gsd-progress", undefined);
     ctx?.ui.setFooter(undefined);
@@ -473,7 +510,7 @@ function buildLoopDeps() {
         // Resource version guard
         checkResourcesStale,
         // Session lock
-        validateSessionLock,
+        validateSessionLock: getSessionLockStatus,
         updateSessionLock,
         handleLostSessionLock,
         // Milestone transition

package/dist/resources/extensions/gsd/commands.js

@@ -12,7 +12,7 @@ import { deriveState } from "./state.js";
 import { GSDDashboardOverlay } from "./dashboard-overlay.js";
 import { GSDVisualizerOverlay } from "./visualizer-overlay.js";
 import { showQueue, showDiscuss, showHeadlessMilestoneCreation } from "./guided-flow.js";
-import { startAuto, stopAuto, pauseAuto, isAutoActive, isAutoPaused, stopAutoRemote } from "./auto.js";
+import { startAuto, stopAuto, pauseAuto, isAutoActive, isAutoPaused, stopAutoRemote, checkRemoteAutoSession } from "./auto.js";
 import { dispatchDirectPhase } from "./auto-direct-dispatch.js";
 import { resolveProjectRoot } from "./worktree.js";
 import { assertSafeDirectory } from "./validate-directory.js";
@@ -36,8 +36,8 @@ import { computeProgressScore, formatProgressLine } from "./progress-score.js";
 import { runEnvironmentChecks } from "./doctor-environment.js";
 import { handleLogs } from "./commands-logs.js";
 import { handleStart, handleTemplates, getTemplateCompletions } from "./commands-workflow-templates.js";
-import { readSessionLockData, isSessionLockProcessAlive } from "./session-lock.js";
 import { handleCmux } from "./commands-cmux.js";
+import { showNextAction } from "../shared/mod.js";
 /** Resolve the effective project root, accounting for worktree paths. */
 export function projectRoot() {
     const cwd = process.cwd();
@@ -57,36 +57,81 @@ export function projectRoot() {
     return root;
 }
 /**
- * Check if another process holds the auto-mode session lock.
- * Returns the lock data if a remote session is alive, null otherwise.
+ * Guard against starting auto-mode when a remote session is already running.
+ * Returns true if the caller should proceed with startAuto, false if handled.
  */
-function getRemoteAutoSession(basePath) {
-    const lockData = readSessionLockData(basePath);
-    if (!lockData)
-        return null;
-    if (lockData.pid === process.pid)
-        return null;
-    if (!isSessionLockProcessAlive(lockData))
-        return null;
-    return { pid: lockData.pid };
-}
-/**
- * Show a steering menu when auto-mode is running in another process.
- * Returns true if a remote session was detected (caller should return early).
- */
-function notifyRemoteAutoActive(ctx, basePath) {
-    const remote = getRemoteAutoSession(basePath);
-    if (!remote)
+async function guardRemoteSession(ctx, pi) {
+    // Local session already active — proceed (startAuto handles re-entrant calls)
+    if (isAutoActive() || isAutoPaused())
+        return true;
+    const remote = checkRemoteAutoSession(projectRoot());
+    if (!remote.running || !remote.pid)
+        return true;
+    const unitLabel = remote.unitType && remote.unitId
+        ? `${remote.unitType} (${remote.unitId})`
+        : "unknown unit";
+    const unitsMsg = remote.completedUnits != null
+        ? `${remote.completedUnits} units completed`
+        : "";
+    const choice = await showNextAction(ctx, {
+        title: `Auto-mode is running in another terminal (PID ${remote.pid})`,
+        summary: [
+            `Currently executing: ${unitLabel}`,
+            ...(unitsMsg ? [unitsMsg] : []),
+            ...(remote.startedAt ? [`Started: ${remote.startedAt}`] : []),
+        ],
+        actions: [
+            {
+                id: "status",
+                label: "View status",
+                description: "Show the current GSD progress dashboard.",
+                recommended: true,
+            },
+            {
+                id: "steer",
+                label: "Steer the session",
+                description: "Use /gsd steer <instruction> to redirect the running session.",
+            },
+            {
+                id: "stop",
+                label: "Stop remote session",
+                description: `Send SIGTERM to PID ${remote.pid} to stop it gracefully.`,
+            },
+            {
+                id: "force",
+                label: "Force start (steal lock)",
+                description: "Start a new session, terminating the existing one.",
+            },
+        ],
+        notYetMessage: "Run /gsd when ready.",
+    });
+    if (choice === "status") {
+        await handleStatus(ctx);
+        return false;
+    }
+    if (choice === "steer") {
+        ctx.ui.notify("Use /gsd steer <instruction> to redirect the running auto-mode session.\n" +
+            "Example: /gsd steer Use Postgres instead of SQLite", "info");
+        return false;
+    }
+    if (choice === "stop") {
+        const result = stopAutoRemote(projectRoot());
+        if (result.found) {
+            ctx.ui.notify(`Sent stop signal to auto-mode session (PID ${result.pid}). It will shut down gracefully.`, "info");
+        }
+        else if (result.error) {
+            ctx.ui.notify(`Failed to stop remote auto-mode: ${result.error}`, "error");
+        }
+        else {
+            ctx.ui.notify("Remote session is no longer running.", "info");
+        }
         return false;
-    ctx.ui.notify(`Auto-mode is running in another process (PID ${remote.pid}).\n` +
-        `Use these commands to interact with it:\n` +
-        `  /gsd status   — check progress\n` +
-        `  /gsd discuss  — discuss architecture decisions\n` +
-        `  /gsd queue    — queue the next milestone\n` +
-        `  /gsd steer    — apply an override to active work\n` +
-        `  /gsd capture  — fire-and-forget thought\n` +
-        `  /gsd stop     — stop auto-mode`, "warning");
-    return true;
+    }
+    if (choice === "force") {
+        return true; // Proceed — startAuto will steal the lock
+    }
+    // "not_yet" or escape
+    return false;
 }
 export function registerGSDCommand(pi) {
     pi.registerCommand("gsd", {
@@ -542,12 +587,12 @@ export async function handleGSDCommand(args, ctx, pi) {
             await handleDryRun(ctx, projectRoot());
             return;
         }
-        if (notifyRemoteAutoActive(ctx, projectRoot()))
-            return;
         const verboseMode = trimmed.includes("--verbose");
         const debugMode = trimmed.includes("--debug");
         if (debugMode)
             enableDebug(projectRoot());
+        if (!(await guardRemoteSession(ctx, pi)))
+            return;
         await startAuto(ctx, pi, projectRoot(), verboseMode, { step: true });
         return;
     }
@@ -556,6 +601,8 @@ export async function handleGSDCommand(args, ctx, pi) {
         const debugMode = trimmed.includes("--debug");
         if (debugMode)
             enableDebug(projectRoot());
+        if (!(await guardRemoteSession(ctx, pi)))
+            return;
         await startAuto(ctx, pi, projectRoot(), verboseMode);
         return;
     }
@@ -899,7 +946,7 @@ Examples:
         return;
     }
     if (trimmed === "") {
-        if (notifyRemoteAutoActive(ctx, projectRoot()))
+        if (!(await guardRemoteSession(ctx, pi)))
             return;
         await startAuto(ctx, pi, projectRoot(), false, { step: true });
         return;

package/dist/resources/extensions/gsd/git-service.js

@@ -349,10 +349,18 @@ export class GitServiceImpl {
         }
         const wtName = detectWorktreeName(this.basePath);
         if (wtName) {
+            // Auto-mode worktrees use milestone/<MID> branches (wtName = milestone ID)
+            const milestoneBranch = `milestone/${wtName}`;
+            const currentBranch = nativeGetCurrentBranch(this.basePath);
+            // If we're on a milestone/<MID> branch, use it (auto-mode case)
+            if (currentBranch.startsWith("milestone/")) {
+                return currentBranch;
+            }
+            // Otherwise check for manual worktree branch (worktree/<name>)
             const wtBranch = `worktree/${wtName}`;
             if (nativeBranchExists(this.basePath, wtBranch))
                 return wtBranch;
-            return nativeGetCurrentBranch(this.basePath);
+            return currentBranch;
         }
         // Repo-level default detection: origin/HEAD → main → master → current branch.
         // Native path uses libgit2 (single call), fallback spawns multiple git processes.

package/dist/resources/extensions/gsd/history.js

@@ -1,6 +1,7 @@
 // GSD Extension — Session History View
 // Human-readable display of past auto-mode unit executions.
-import { formatDuration, padRight, truncateWithEllipsis } from "../shared/format-utils.js";
+import { formatDuration, truncateWithEllipsis } from "../shared/format-utils.js";
+import { padRight } from "../shared/layout-utils.js";
 import { getLedger, getProjectTotals, formatCost, formatTokenCount, aggregateBySlice, aggregateByPhase, aggregateByModel, loadLedgerFromDisk, } from "./metrics.js";
 /**
  * Show recent unit execution history with cost, tokens, and duration.

package/dist/resources/extensions/gsd/metrics.js

@@ -17,8 +17,10 @@ import { gsdRoot } from "./paths.js";
 import { getAndClearSkills } from "./skill-telemetry.js";
 import { loadJsonFile, loadJsonFileOrNull, saveJsonFile } from "./json-persistence.js";
 import { parseUnitId } from "./unit-id.js";
-// Re-export from shared — canonical implementation lives in format-utils.
-export { formatTokenCount } from "../shared/mod.js";
+// Re-export from shared — import directly from format-utils to avoid pulling
+// in the full barrel (mod.js → ui.js → @gsd/pi-tui) which breaks when loaded
+// outside jiti's alias resolution (e.g. dynamic import in auto-loop reports).
+export { formatTokenCount } from "../shared/format-utils.js";
 export function classifyUnitPhase(unitType) {
     switch (unitType) {
         case "research-milestone":

package/dist/resources/extensions/gsd/session-lock.js

@@ -320,7 +320,7 @@ export function updateSessionLock(basePath, unitType, unitId, completedUnits, se
  *
  * This is called periodically during the dispatch loop.
  */
-export function validateSessionLock(basePath) {
+export function getSessionLockStatus(basePath) {
     // Lock was compromised by proper-lockfile (mtime drift from sleep, stall, etc.)
     if (_lockCompromised) {
         // Recovery gate (#1512): Before declaring the lock lost, check if the lock
@@ -335,27 +335,47 @@ export function validateSessionLock(basePath) {
                 const result = acquireSessionLock(basePath);
                 if (result.acquired) {
                     process.stderr.write(`[gsd] Lock recovered after onCompromised — lock file PID matched, re-acquired.\n`);
-                    return true;
+                    return { valid: true, recovered: true };
                 }
             }
             catch {
                 // Re-acquisition failed — fall through to return false
             }
         }
-        return false;
+        return {
+            valid: false,
+            failureReason: "compromised",
+            existingPid: existing?.pid,
+            expectedPid: process.pid,
+        };
     }
     // If we have an OS-level lock, we're still the owner
     if (_releaseFunction && _lockedPath === basePath) {
-        return true;
+        return { valid: true };
     }
     // Fallback: check the lock file PID
     const lp = lockPath(basePath);
     const existing = readExistingLockData(lp);
     if (!existing) {
         // Lock file was deleted — we lost ownership
-        return false;
+        return {
+            valid: false,
+            failureReason: "missing-metadata",
+            expectedPid: process.pid,
+        };
+    }
+    if (existing.pid !== process.pid) {
+        return {
+            valid: false,
+            failureReason: "pid-mismatch",
+            existingPid: existing.pid,
+            expectedPid: process.pid,
+        };
     }
-    return existing.pid === process.pid;
+    return { valid: true };
+}
+export function validateSessionLock(basePath) {
+    return getSessionLockStatus(basePath).valid;
 }
 /**
  * Release the session lock. Called on clean stop/pause.

package/dist/resources/extensions/shared/format-utils.js

@@ -1,10 +1,11 @@
 /**
- * Shared formatting and layout utilities for TUI dashboard components.
+ * Shared pure formatting utilities — no @gsd/pi-tui dependency.
  *
- * Consolidates helpers that were previously duplicated across
- * auto-dashboard.ts, dashboard-overlay.ts, and visualizer-views.ts.
+ * ANSI-aware layout helpers (padRight, joinColumns, centerLine, fitColumns)
+ * live in layout-utils.ts to avoid pulling @gsd/pi-tui into modules that
+ * run outside jiti's alias resolution (e.g. HTML report generation via
+ * dynamic import in auto-loop).
  */
-import { truncateToWidth, visibleWidth } from "@gsd/pi-tui";
 // ─── Duration Formatting ──────────────────────────────────────────────────────
 /** Format a millisecond duration as a compact human-readable string. */
 export function formatDuration(ms) {
@@ -30,43 +31,6 @@ export function formatTokenCount(count) {
         return `${(count / 1000).toFixed(1)}k`;
     return `${(count / 1_000_000).toFixed(2)}M`;
 }
-// ─── Layout Helpers ───────────────────────────────────────────────────────────
-/** Pad a string with trailing spaces to fill `width` (ANSI-aware). */
-export function padRight(content, width) {
-    const vis = visibleWidth(content);
-    return content + " ".repeat(Math.max(0, width - vis));
-}
-/** Build a line with left-aligned and right-aligned content. */
-export function joinColumns(left, right, width) {
-    const leftW = visibleWidth(left);
-    const rightW = visibleWidth(right);
-    if (leftW + rightW + 2 > width) {
-        return truncateToWidth(`${left}  ${right}`, width);
-    }
-    return left + " ".repeat(width - leftW - rightW) + right;
-}
-/** Center content within `width` (ANSI-aware). */
-export function centerLine(content, width) {
-    const vis = visibleWidth(content);
-    if (vis >= width)
-        return truncateToWidth(content, width);
-    const leftPad = Math.floor((width - vis) / 2);
-    return " ".repeat(leftPad) + content;
-}
-/** Join as many parts as fit within `width`, separated by `separator`. */
-export function fitColumns(parts, width, separator = "  ") {
-    const filtered = parts.filter(Boolean);
-    if (filtered.length === 0)
-        return "";
-    let result = filtered[0];
-    for (let i = 1; i < filtered.length; i++) {
-        const candidate = `${result}${separator}${filtered[i]}`;
-        if (visibleWidth(candidate) > width)
-            break;
-        result = candidate;
-    }
-    return truncateToWidth(result, width);
-}
 // ─── Text Truncation ─────────────────────────────────────────────────────────
 /** Truncate a string to `maxLength` characters, replacing the last character with an ellipsis if needed. */
 export function truncateWithEllipsis(text, maxLength) {

package/dist/resources/extensions/shared/layout-utils.js

@@ -0,0 +1,46 @@
+/**
+ * ANSI-aware TUI layout utilities that depend on @gsd/pi-tui.
+ *
+ * Separated from format-utils.ts so that modules needing only pure
+ * formatting (e.g. HTML report generation) can import format-utils
+ * without pulling in the @gsd/pi-tui dependency — which fails when
+ * loaded outside jiti's alias resolution context.
+ */
+import { truncateToWidth, visibleWidth } from "@gsd/pi-tui";
+// ─── Layout Helpers ───────────────────────────────────────────────────────────
+/** Pad a string with trailing spaces to fill `width` (ANSI-aware). */
+export function padRight(content, width) {
+    const vis = visibleWidth(content);
+    return content + " ".repeat(Math.max(0, width - vis));
+}
+/** Build a line with left-aligned and right-aligned content. */
+export function joinColumns(left, right, width) {
+    const leftW = visibleWidth(left);
+    const rightW = visibleWidth(right);
+    if (leftW + rightW + 2 > width) {
+        return truncateToWidth(`${left}  ${right}`, width);
+    }
+    return left + " ".repeat(width - leftW - rightW) + right;
+}
+/** Center content within `width` (ANSI-aware). */
+export function centerLine(content, width) {
+    const vis = visibleWidth(content);
+    if (vis >= width)
+        return truncateToWidth(content, width);
+    const leftPad = Math.floor((width - vis) / 2);
+    return " ".repeat(leftPad) + content;
+}
+/** Join as many parts as fit within `width`, separated by `separator`. */
+export function fitColumns(parts, width, separator = "  ") {
+    const filtered = parts.filter(Boolean);
+    if (filtered.length === 0)
+        return "";
+    let result = filtered[0];
+    for (let i = 1; i < filtered.length; i++) {
+        const candidate = `${result}${separator}${filtered[i]}`;
+        if (visibleWidth(candidate) > width)
+            break;
+        result = candidate;
+    }
+    return truncateToWidth(result, width);
+}

package/dist/resources/extensions/shared/mod.js

@@ -1,6 +1,7 @@
 // Barrel file — re-exports consumed by external modules
 export { makeUI, GLYPH, INDENT, STATUS_GLYPH, STATUS_COLOR, } from "./ui.js";
-export { stripAnsi, formatTokenCount, formatDuration, padRight, joinColumns, centerLine, fitColumns, sparkline, normalizeStringArray, fileLink, } from "./format-utils.js";
+export { stripAnsi, formatTokenCount, formatDuration, sparkline, normalizeStringArray, fileLink, } from "./format-utils.js";
+export { padRight, joinColumns, centerLine, fitColumns, } from "./layout-utils.js";
 export { shortcutDesc } from "./terminal.js";
 export { toPosixPath } from "./path-display.js";
 export { showInterviewRound } from "./interview-ui.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-pi",
-  "version": "2.37.0",
+  "version": "2.37.1-dev.7352347",
   "description": "GSD — Get Shit Done coding agent",
   "license": "MIT",
   "repository": {
@@ -84,6 +84,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.73.0",
+    "@anthropic-ai/vertex-sdk": "^0.14.4",
     "@aws-sdk/client-bedrock-runtime": "^3.983.0",
     "@clack/prompts": "^1.1.0",
     "@google/genai": "^1.40.0",