@opengsd/gsd-pi 1.0.1 → 1.0.2

package/dist/resources/extensions/gsd/auto/workflow-custom-engine-retry.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Custom-engine verification retry adapter for auto-mode loop.
 import { decideCustomEngineRecovery, decideCustomEngineVerifyRetry, } from "./workflow-kernel.js";
 export async function handleCustomEngineVerifyRetry(input) {

package/dist/resources/extensions/gsd/auto/workflow-custom-engine-verify-outcome.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Applies custom-engine verification outcomes to auto-mode loop side effects.
 export async function handleCustomEngineVerifyPause(input) {
     await input.deps.pauseAuto();

package/dist/resources/extensions/gsd/auto/workflow-dispatch-claim.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Best-effort unit dispatch claim adapter for auto-mode loop.
 const VIRTUAL_MILESTONE_IDS = new Set(["PROJECT"]);
 /**

package/dist/resources/extensions/gsd/auto/workflow-dispatch-ledger.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Best-effort dispatch ledger write helpers for auto-mode loop adapters.
 export function settleDispatchFailed(dispatchId, errorSummary, deps) {
     if (dispatchId === null)

package/dist/resources/extensions/gsd/auto/workflow-iteration-completion.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Successful auto-mode iteration cleanup helper.
 export function completeWorkflowIteration(state, deps) {
     state.consecutiveErrors = 0;

package/dist/resources/extensions/gsd/auto/workflow-journal-reporter.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Thin adapter for auto-mode workflow journal event emission.
 export function createWorkflowJournalReporter(input) {
     const now = input.now ?? (() => new Date().toISOString());

package/dist/resources/extensions/gsd/auto/workflow-kernel.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Pure workflow-loop decisions for auto-mode before side-effect adapters run.
 export function decideWorkflowLoop(input) {
     if (!input.active) {

package/dist/resources/extensions/gsd/auto/workflow-memory-pressure.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Memory-pressure measurement adapter for auto-mode loop.
 import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);

package/dist/resources/extensions/gsd/auto/workflow-phase-reporter.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Thin adapter for auto-mode UOK phase-result reporting.
 export function createWorkflowPhaseReporter(input) {
     return {

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Session-lock validation adapter for auto-mode loop.
 import { decideWorkflowLoop, } from "./workflow-kernel.js";
 export function validateWorkflowSessionLock(input) {

package/dist/resources/extensions/gsd/auto/workflow-sidecar-iteration.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Sidecar iteration-data adapter for auto-mode loop.
 export async function buildSidecarIterationData(input) {
     const sidecarState = await input.deriveState(input.canonicalProjectRoot);

package/dist/resources/extensions/gsd/auto/workflow-sidecar-queue.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Sidecar queue scheduling and dequeue adapter for auto-mode loop.
 export async function dequeueSidecarItem(input) {
     if (input.queue.length === 0)

package/dist/resources/extensions/gsd/auto/workflow-turn-reporter.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Thin adapter for workflow turn observer reporting.
 export function createWorkflowTurnReporter(input) {
     let finished = false;

package/dist/resources/extensions/gsd/auto/workflow-unit-dispatch.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Unit dispatch contract adapter for auto-mode loop.
 import { ExecutionGraphScheduler } from "../uok/execution-graph.js";
 import { runUnitPhase } from "./phases.js";

package/dist/resources/extensions/gsd/auto/workflow-worker-heartbeat.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Best-effort worker heartbeat adapter for auto-mode loop.
 export function maintainWorkerHeartbeat(session, deps) {
     if (!session.workerId)

package/dist/resources/extensions/gsd/auto-artifact-paths.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Resolves expected auto-mode artifact paths across project and worktree projections.
 // GSD Auto-mode — Artifact Path Resolution
 //

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Pure budget and context guard decisions for GSD auto-mode.
 /**
  * Budget alert level tracking and enforcement for auto-mode.

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

@@ -1,4 +1,4 @@
-// GSD-2 + src/resources/extensions/gsd/auto-dashboard.ts - Auto-mode progress widget rendering and dashboard helpers.
+// gsd-pi + src/resources/extensions/gsd/auto-dashboard.ts - Auto-mode progress widget rendering and dashboard helpers.
 import { getActiveHook } from "./post-unit-hooks.js";
 import { getLedger } from "./metrics.js";
 import { getErrorMessage } from "./error-utils.js";

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Declarative auto-mode dispatch rules and dispatch resolver.
 import { loadFile, extractUatType, loadActiveOverrides } from "./files.js";
 import { isDbAvailable, getMilestoneSlices, getPendingGates, markAllGatesOmitted, getMilestone, insertAssessment, setSliceSketchFlag, transaction, getAssessment } from "./gsd-db.js";

package/dist/resources/extensions/gsd/auto-post-unit.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto-mode post-unit git, verification, projection, and hook processing.
 /**
  * Post-unit processing for auto-loop — auto-commit, doctor run,

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Builds GSD auto-mode unit prompts and pre-dispatch checks.
 /**
  * Auto-mode Prompt Builders — construct dispatch prompts for each unit type.
@@ -584,7 +584,7 @@ export async function buildSliceSummaryExcerpt(absPath, relPath, sid) {
             const more = s.frontmatter.key_files.length > files.length ? ` (+${s.frontmatter.key_files.length - files.length} more)` : "";
             lines.push(`**Key files:** ${files.join(", ")}${more}`);
         }
-        // Cap section bodies (coderabbit review on #4908): if any of these
+        // Cap section bodies (#4908): if any of these
         // narrative sections balloon, excerpt mode still inflates and
         // undermines the token-reduction goal. 800 chars (~200 tokens) is
         // enough to carry intent; the closer agent Reads the full file when

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Verifies auto-mode artifacts and manages recovery placeholders.
 /**
  * Auto-mode Recovery — artifact resolution, verification, blocker placeholders,

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto-mode bootstrap, worktree recovery, and fresh-start initialization.
 /**
  * Auto-mode bootstrap — fresh-start initialization path.

package/dist/resources/extensions/gsd/auto-status-message.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Compact connected status message formatting for GSD TUI notifications.
 const STATUS_INDENT = "    ";
 const STATUS_RULE = "────────────────────────────────────────";

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

@@ -75,7 +75,7 @@ export function startUnitSupervision(sctx) {
     // If the task has an est: annotation, use it to extend the hard and soft timeouts
     // so longer tasks don't get prematurely timed out.
     let taskEstimate = sctx.taskEstimate;
-    if (!taskEstimate && unitType === "task" && isDbAvailable()) {
+    if (!taskEstimate && unitType === "execute-task" && isDbAvailable()) {
         // Look up the task estimate from the DB (#2243).
         try {
             if (s.currentMilestoneId) {
@@ -136,6 +136,11 @@ export function startUnitSupervision(sctx) {
         try {
             if (!s.active || !s.currentUnit)
                 return;
+            const expectedCurrentUnit = {
+                type: s.currentUnit.type,
+                id: s.currentUnit.id,
+                startedAt: s.currentUnit.startedAt,
+            };
             const runtime = readUnitRuntimeRecord(s.basePath, unitType, unitId);
             if (!runtime)
                 return;
@@ -198,7 +203,7 @@ export function startUnitSupervision(sctx) {
                 phase: "paused",
             });
             ctx.ui.notify(`Unit ${unitType} ${unitId} made no meaningful progress for ${supervisor.idle_timeout_minutes}min. Pausing auto-mode.`, "warning");
-            await pauseAuto(ctx, pi);
+            await pauseAuto(ctx, pi, undefined, { expectedCurrentUnit });
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
@@ -219,6 +224,9 @@ export function startUnitSupervision(sctx) {
             s.unitTimeoutHandle = null;
             if (!s.active)
                 return;
+            const expectedCurrentUnit = s.currentUnit
+                ? { type: s.currentUnit.type, id: s.currentUnit.id, startedAt: s.currentUnit.startedAt }
+                : null;
             if (s.currentUnit) {
                 writeUnitRuntimeRecord(s.basePath, unitType, unitId, s.currentUnit.startedAt, {
                     phase: "timeout",
@@ -233,7 +241,7 @@ export function startUnitSupervision(sctx) {
             if (recovery === "recovered")
                 return;
             ctx.ui.notify(`Unit ${unitType} ${unitId} exceeded ${supervisor.hard_timeout_minutes}min hard timeout. Pausing auto-mode.`, "warning");
-            await pauseAuto(ctx, pi);
+            await pauseAuto(ctx, pi, undefined, { expectedCurrentUnit });
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);

package/dist/resources/extensions/gsd/auto-unit-closeout.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto-mode unit closeout metrics, activity capture, and ghost-run detection.
 import { snapshotUnitMetrics } from "./metrics.js";
 import { saveActivityLog } from "./activity-log.js";

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Post-unit verification gate for GSD auto-mode units.
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { gsdProjectionRoot, resolveSlicePath, resolveMilestoneFile } from "./paths.js";

package/dist/resources/extensions/gsd/auto-worktree-repair.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Helpers for safe auto-mode milestone worktree repair decisions.
 import { existsSync, lstatSync, readdirSync } from "node:fs";
 import { join } from "node:path";

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto-mode worktree lifecycle, merge, and cleanup management.
 /**
  * GSD Auto-Worktree -- lifecycle management for auto-mode worktrees.

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto-mode orchestration, session lifecycle, and stop handling.
 /**
  * GSD Auto Mode — Fresh Session Per Unit
@@ -677,6 +677,23 @@ function currentUnitLabel() {
         return null;
     return `${unitVerb(s.currentUnit.type)} ${s.currentUnit.id}`;
 }
+export function capturePauseAutoUnitIdentity() {
+    if (!s.currentUnit)
+        return null;
+    return {
+        type: s.currentUnit.type,
+        id: s.currentUnit.id,
+        startedAt: s.currentUnit.startedAt,
+    };
+}
+function pauseAutoUnitIdentityMatches(expected) {
+    if (!s.currentUnit)
+        return expected === null;
+    return expected !== null &&
+        s.currentUnit.type === expected.type &&
+        s.currentUnit.id === expected.id &&
+        s.currentUnit.startedAt === expected.startedAt;
+}
 function setLifecycleOutcome(ctx, input) {
     if (!ctx?.hasUI)
         return;
@@ -1288,7 +1305,7 @@ export async function stopAuto(ctx, pi, reason, options = {}) {
         // Drop the active-tool baseline so a subsequent /gsd auto run on the
         // same `pi` instance recaptures from the live tool set rather than
         // restoring this session's snapshot and silently undoing any tool
-        // changes the user made between sessions (#4959 / CodeRabbit).
+        // changes the user made between sessions (#4959).
         if (pi)
             clearToolBaseline(pi);
         try {
@@ -1319,9 +1336,17 @@ export function _selectStopAutoWorktreeExit(args) {
  * The user can interact with the agent, then `/gsd auto` resumes
  * from disk state. Called when the user presses Escape during auto-mode.
  */
-export async function pauseAuto(ctx, _pi, _errorContext) {
+export async function pauseAuto(ctx, _pi, _errorContext, options = {}) {
     if (!s.active)
         return;
+    if (Object.prototype.hasOwnProperty.call(options, "expectedCurrentUnit") &&
+        !pauseAutoUnitIdentityMatches(options.expectedCurrentUnit ?? null)) {
+        debugLog("pause-auto-stale-unit-guard", {
+            expectedCurrentUnit: options.expectedCurrentUnit ?? null,
+            currentUnit: s.currentUnit,
+        });
+        return;
+    }
     s.active = false;
     clearUnitTimeout();
     stopAutoCommandPolling();
@@ -1406,12 +1431,16 @@ export async function pauseAuto(ctx, _pi, _errorContext) {
     }
     if (s.workerId) {
         try {
+            if (s.currentMilestoneId && s.milestoneLeaseToken) {
+                releaseMilestoneLease(s.workerId, s.currentMilestoneId, s.milestoneLeaseToken);
+            }
             markWorkerStopping(s.workerId);
         }
         catch (err) {
             logWarning("engine", `pause worker cleanup failed: ${getErrorMessage(err)}`, { file: "auto.ts" });
         }
         s.workerId = null;
+        s.milestoneLeaseToken = null;
     }
     deregisterSigtermHandler();
     // Unblock pending unitPromise so autoLoop exits cleanly (#1799)
@@ -2013,7 +2042,7 @@ export async function startAuto(ctx, pi, base, verboseMode, options) {
     // leaves the last provider-trimmed active tools in place, so clearing here
     // would let the next selectAndApplyModel recapture that already-narrowed
     // set as the new baseline — exactly the cross-unit poisoning this PR is
-    // fixing (#4959 / CodeRabbit Major).  The pre-pause baseline survives in
+    // fixing (#4959).  The pre-pause baseline survives in
     // the WeakMap keyed by `pi`.
     if (!s.paused)
         clearToolBaseline(pi);

package/dist/resources/extensions/gsd/bootstrap/agent-end-recovery.js

@@ -1,4 +1,4 @@
-// GSD-2 + src/resources/extensions/gsd/bootstrap/agent-end-recovery.ts - Handles provider and agent-end recovery for GSD auto-mode.
+// gsd-pi + src/resources/extensions/gsd/bootstrap/agent-end-recovery.ts - Handles provider and agent-end recovery for GSD auto-mode.
 import { logWarning } from "../workflow-logger.js";
 import { checkDeepProjectSetupAfterTurn, checkAutoStartAfterDiscuss, maybeHandleReadyPhraseWithoutFiles, maybeHandleEmptyIntentTurn, resetEmptyTurnCounter, } from "../guided-flow.js";
 import { clearPathCache } from "../paths.js";
@@ -135,10 +135,9 @@ export function isBareClaudeCodeStreamAbortPlaceholder(lastMsg) {
  * "Auto-mode stopped — Unit aborted: Claude Code process aborted by user"
  * even though no user input occurred.
  *
- * Claude Code abort markers are intentionally ignored when the abort fires
- * while the session-switch is in flight: the abort is the expected side-effect
- * of the transition, not a user signal. Other branches (genuine `stopReason
- * === "aborted"` with explicit errorMessage) preserve the prior behavior.
+ * Abort markers are intentionally ignored when the abort fires while the
+ * session-switch is in flight: the abort belongs to the old turn being torn
+ * down by newSession(), not to the next unit.
  */
 export function _handleSessionSwitchAgentEnd(lastMsg, resolveCancelled) {
     if (!lastMsg || typeof lastMsg !== "object")
@@ -157,10 +156,7 @@ export function _handleSessionSwitchAgentEnd(lastMsg, resolveCancelled) {
         return;
     }
     if (m.stopReason === "aborted") {
-        const hasErrorMessage = !!m.errorMessage;
-        if (hasErrorMessage) {
-            resolveCancelled(_buildAbortedPauseContext(m));
-        }
+        return;
     }
 }
 export function resolveAgentEndErrorDisplay(rawErrorMsg, content) {

package/dist/resources/extensions/gsd/bootstrap/db-tools.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Registers DB-backed GSD workflow tools and compatibility aliases.
 import { Type } from "@sinclair/typebox";
 import { Text } from "@gsd/pi-tui";

package/dist/resources/extensions/gsd/bootstrap/dynamic-tools.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Registers workspace-aware dynamic filesystem and shell tools.
 import { existsSync } from "node:fs";
 import { homedir } from "node:os";

package/dist/resources/extensions/gsd/bootstrap/exec-tools.js

@@ -1,6 +1,6 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Registers Context Mode execution tools.
-// GSD2 — Exec (context-mode) tool registration.
+// gsd-pi — Exec (context-mode) tool registration.
 //
 // Exposes the Context Mode runtime tools in-process. Default-on; opt out with
 // `context_mode.enabled: false` in preferences.

package/dist/resources/extensions/gsd/bootstrap/journal-tools.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Registers journal query tools.
 import { Type } from "@sinclair/typebox";
 import { queryJournal } from "../journal.js";

package/dist/resources/extensions/gsd/bootstrap/memory-tools.js

@@ -1,6 +1,6 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Registers memory-layer tools.
-// GSD2 — Memory tool registration
+// gsd-pi — Memory tool registration
 //
 // Exposes the memory-layer tools (capture_thought, memory_query, gsd_graph)
 // to the LLM over MCP. All three degrade gracefully when the GSD database

package/dist/resources/extensions/gsd/bootstrap/query-tools.js

@@ -1,6 +1,6 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Registers read-only DB query tools.
-// GSD2 — Read-only query tools exposing DB state to the LLM via the WAL connection
+// gsd-pi — Read-only query tools exposing DB state to the LLM via the WAL connection
 import { Type } from "@sinclair/typebox";
 import { ensureDbOpen, resolveCtxCwd } from "./dynamic-tools.js";
 export function registerQueryTools(pi) {

package/dist/resources/extensions/gsd/bootstrap/register-extension.js

@@ -1,4 +1,4 @@
-// GSD2 — Extension registration: wires all GSD tools, commands, and hooks into pi
+// gsd-pi — Extension registration: wires all GSD tools, commands, and hooks into pi
 import { registerExitCommand } from "../exit-command.js";
 import { registerLazyWorktreeCommands } from "../worktree-command-bootstrap.js";
 import { registerDbTools } from "./db-tools.js";
@@ -7,6 +7,7 @@ import { registerExecTools } from "./exec-tools.js";
 import { registerJournalTools } from "./journal-tools.js";
 import { registerMemoryTools } from "./memory-tools.js";
 import { registerQueryTools } from "./query-tools.js";
+import { registerScheduleWakeupTool } from "./schedule-wakeup-tool.js";
 import { registerHooks } from "./register-hooks.js";
 import { registerShortcuts } from "./register-shortcuts.js";
 import { writeCrashLog } from "./crash-log.js";
@@ -107,6 +108,7 @@ export function registerGsdExtension(pi) {
         ["query-tools", () => registerQueryTools(pi)],
         ["memory-tools", () => registerMemoryTools(pi)],
         ["exec-tools", () => registerExecTools(pi)],
+        ["schedule-wakeup-tool", () => registerScheduleWakeupTool(pi)],
         ["shortcuts", () => registerShortcuts(pi)],
         // cmux is a library (no pi), so gsd sets up the event listeners on its
         // behalf using the shared event channel contract. Registration is

package/dist/resources/extensions/gsd/bootstrap/register-hooks.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Registers GSD extension runtime hooks and token-saving tool policies.
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -742,6 +742,8 @@ export function registerHooks(pi, ecosystemHandlers) {
         // subagent dispatch. Closes the b23 bug class where a discuss-milestone
         // turn used the host Edit tool to modify user source files.
         const dash = getAutoRuntimeSnapshot();
+        // ScheduleWakeup is registered by the GSD extension so auto-mode can
+        // continue the same unit session after long external waits.
         const guidedUnit = getGuidedUnitContext(discussionBasePath);
         const activeUnitType = dash.currentUnit?.type ?? guidedUnit?.unitType;
         if (activeUnitType) {

package/dist/resources/extensions/gsd/bootstrap/register-shortcuts.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Registers GSD keyboard shortcuts for dashboard, notifications, and parallel overlays.
 import { existsSync } from "node:fs";
 import { join } from "node:path";

package/dist/resources/extensions/gsd/bootstrap/schedule-wakeup-tool.js

@@ -0,0 +1,69 @@
+// Project/App: gsd-pi
+// File Purpose: Registers the auto-mode ScheduleWakeup continuation tool.
+import { Type } from "@sinclair/typebox";
+import { getAutoRuntimeSnapshot } from "../auto-runtime-state.js";
+import { scheduleAutoWakeup } from "../auto/schedule-wakeup.js";
+import { resolveCtxCwd } from "./dynamic-tools.js";
+const MAX_WAKEUP_DELAY_SECONDS = 24 * 60 * 60;
+export function registerScheduleWakeupTool(pi) {
+    pi.registerTool({
+        name: "ScheduleWakeup",
+        label: "Schedule Wakeup",
+        description: "In GSD auto-mode, pause the current unit and continue the same session after a delay. " +
+            "Use this for long external processes that need polling without ending the unit as no-artifact.",
+        promptSnippet: "Schedule a same-session auto-mode wakeup after a delay.",
+        promptGuidelines: [
+            "Use ScheduleWakeup at the end of an execute-task turn when waiting for a long external process.",
+            "Include a prompt that says exactly what external state to check next and what artifact to write when done.",
+            "Re-arm ScheduleWakeup on each polling turn if the external process is still running.",
+        ],
+        parameters: Type.Object({
+            delaySeconds: Type.Number({
+                minimum: 1,
+                maximum: MAX_WAKEUP_DELAY_SECONDS,
+                description: "How many seconds to wait before continuing the same auto-mode session.",
+            }),
+            prompt: Type.String({
+                minLength: 1,
+                description: "Prompt to send when the session wakes up.",
+            }),
+            reason: Type.Optional(Type.String({
+                description: "Why this delay is appropriate.",
+            })),
+        }),
+        async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+            const dash = getAutoRuntimeSnapshot();
+            const currentUnit = dash.currentUnit;
+            const basePath = dash.basePath || resolveCtxCwd(ctx);
+            if (!dash.active || !currentUnit) {
+                return {
+                    content: [{ type: "text", text: "ScheduleWakeup is only available during an active GSD auto-mode unit." }],
+                    details: { operation: "schedule_wakeup", error: "auto_mode_inactive" },
+                    isError: true,
+                };
+            }
+            const delaySeconds = Math.max(1, Math.min(MAX_WAKEUP_DELAY_SECONDS, Math.floor(params.delaySeconds)));
+            scheduleAutoWakeup({
+                basePath,
+                unitType: currentUnit.type,
+                unitId: currentUnit.id,
+                delayMs: delaySeconds * 1000,
+                prompt: params.prompt,
+                reason: params.reason ?? "",
+                createdAt: Date.now(),
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Wakeup scheduled for ${delaySeconds}s. Auto-mode will continue ${currentUnit.type} ${currentUnit.id} in the same session.`,
+                    }],
+                details: {
+                    operation: "schedule_wakeup",
+                    delaySeconds,
+                    unitType: currentUnit.type,
+                    unitId: currentUnit.id,
+                },
+            };
+        },
+    });
+}

package/dist/resources/extensions/gsd/bootstrap/system-context.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: System prompt and hidden context bootstrap for GSD sessions.
 import { existsSync, readFileSync, unlinkSync } from "node:fs";
 import { join } from "node:path";

package/dist/resources/extensions/gsd/bootstrap/write-gate.js

@@ -1,4 +1,4 @@
-// GSD2 - Write gate runtime persistence and policy guards.
+// gsd-pi - Write gate runtime persistence and policy guards.
 import { copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, realpathSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { isAbsolute, join, relative, resolve, sep } from "node:path";
 import { minimatch } from "minimatch";

package/dist/resources/extensions/gsd/browser-evidence.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Shared browser-observable UAT requirement and evidence detection.
 export const BROWSER_REQUIREMENT_RE = /\b(?:browser|file:\/\/|localhost|dom|localstorage|click(?:ing|ed)?|button|visible|screenshot|snapshot|reload(?:ed)?|page refresh|user-visible|strikethrough|search box)\b/i;
 export const NO_BROWSER_EVIDENCE_RE = /\b(?:no|without|not|wasn'?t|isn'?t)\s+(?:automated\s+)?(?:live\s+)?browser(?:\s+(?:session|test|uat))?|\bno\s+automated\s+browser\b|\bnot\s+conducted\b/i;

package/dist/resources/extensions/gsd/closeout-recovery.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Closeout git failure discovery, retry, and manual resolution helpers.
 import { execFileSync } from "node:child_process";
 import { existsSync, realpathSync } from "node:fs";

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

@@ -3,7 +3,7 @@ import { join, resolve } from "node:path";
 import { loadRegistry } from "../workflow-templates.js";
 import { gsdHome } from "../gsd-home.js";
 import { VISUAL_BRIEF_MODES } from "../../visual-brief/prompts.js";
-export const GSD_COMMAND_DESCRIPTION = "GSD — Get Shit Done: /gsd help|start|templates|next|auto|stop|pause|status|widget|visualize|brief|report|queue|quick|discuss|capture|triage|dispatch|verdict|history|undo|undo-task|reset-slice|rate|skip|export|cleanup|closeout|model|mode|prefs|config|keys|hooks|run-hook|skill-health|doctor|debug|logs|forensics|changelog|migrate|remote|steer|knowledge|new-milestone|new-project|parallel|cmux|park|unpark|init|setup|onboarding|inspect|extensions|update|fast|mcp|rethink|workflow|codebase|notifications|ship|do|session-report|backlog|pr-branch|add-tests|scan|language|worktree|eval-review";
+export const GSD_COMMAND_DESCRIPTION = "GSD — Get Shit Done: /gsd help|start|templates|next|auto|stop|pause|status|widget|visualize|brief|report|queue|quick|discuss|capture|triage|dispatch|verdict|history|undo|undo-task|reset-slice|rate|skip|export|cleanup|closeout|model|mode|prefs|config|keys|hooks|run-hook|skill-health|doctor|debug|logs|forensics|changelog|migrate|remote|steer|knowledge|new-milestone|new-project|parallel|cmux|park|unpark|init|setup|onboarding|inspect|extensions|update|upgrade|fast|mcp|rethink|workflow|codebase|notifications|ship|do|session-report|backlog|pr-branch|add-tests|scan|language|worktree|eval-review";
 export const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "help", desc: "Categorized command reference with descriptions" },
     { cmd: "next", desc: "Explicit step mode — run one unit, then pause" },
@@ -60,6 +60,7 @@ export const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "park", desc: "Park a milestone — skip without deleting" },
     { cmd: "unpark", desc: "Reactivate a parked milestone" },
     { cmd: "update", desc: "Update GSD to the latest version" },
+    { cmd: "upgrade", desc: "Alias for update; installs the latest @opengsd package" },
     { cmd: "start", desc: "Start a workflow template (bugfix, spike, feature, etc.)" },
     { cmd: "templates", desc: "List available workflow templates" },
     { cmd: "extensions", desc: "Manage extensions (list, enable, disable, info)" },

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Routes /gsd commands through global guards and command handlers.
 import { GSDNoProjectError, projectRoot, withCommandCwd } from "./context.js";
 import { handleAutoCommand } from "./handlers/auto.js";

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

@@ -141,6 +141,7 @@ export function showHelp(ctx, args = "") {
         "  /gsd remote         Control remote auto-mode  [slack|discord|status|disconnect]",
         "  /gsd inspect        Show SQLite DB diagnostics (schema, row counts, recent entries)",
         "  /gsd update         Update GSD to the latest version via npm",
+        "  /gsd upgrade        Alias for /gsd update",
         "  /gsd language       Set or clear the global response language  [off|clear|<language>]",
     ];
     const full = ["full", "--full", "all"].includes(args.trim().toLowerCase());

package/dist/resources/extensions/gsd/commands/handlers/notifications-handler.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Handles /gsd notifications commands and opens the notification history overlay.
 import { readNotifications, clearNotifications, getUnreadCount, suppressPersistence, unsuppressPersistence, } from "../../notification-store.js";
 import { GSDNotificationOverlay, notificationOverlayOptions } from "../../notification-overlay.js";