@opengsd/gsd-pi 1.0.1-dev.bf2899e → 1.0.2-dev.0ee79e5

package/README.md

@@ -2,6 +2,13 @@
 
 # GSD Pi
 
+[![npm version](https://img.shields.io/npm/v/@opengsd/gsd-pi?label=npm&logo=npm)](https://www.npmjs.com/package/@opengsd/gsd-pi)
+[![npm downloads](https://img.shields.io/npm/dm/@opengsd/gsd-pi?label=downloads&logo=npm&color=red)](https://www.npmjs.com/package/@opengsd/gsd-pi)
+[![CI](https://img.shields.io/github/actions/workflow/status/open-gsd/gsd-pi/ci.yml?branch=main&label=tests&logo=github)](https://github.com/open-gsd/gsd-pi/actions/workflows/ci.yml)
+[![Discord](https://img.shields.io/badge/discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/8NnkKuepmQ)
+[![GitHub stars](https://img.shields.io/github/stars/open-gsd/gsd-pi?label=stars&logo=github)](https://github.com/open-gsd/gsd-pi/stargazers)
+[![License: MIT](https://img.shields.io/github/license/open-gsd/gsd-pi?label=license)](https://github.com/open-gsd/gsd-pi/blob/main/LICENSE)
+
 GSD Pi is a local-first coding agent for planning, implementing, verifying, and tracking project work from the command line.
 
 It combines a terminal agent, project workflow tools, worktree-aware Git automation, and optional UI integrations so a project can move from idea to reviewed implementation with less manual coordination.
@@ -53,7 +60,7 @@ After migration, routine upgrades use:
 gsd upgrade
 ```
 
-You can also run `npx @opengsd/gsd-pi@latest` to launch the installer from the new package. For deeper recovery steps, see [Upgrade GSD Pi](./docs/user-docs/getting-started.md#upgrade-gsd-pi) and [Upgrade from older GSD-2 installs](./docs/user-docs/troubleshooting.md#upgrade-from-older-gsd-2-installs).
+You can also run `npx @opengsd/gsd-pi@latest` to launch the installer from the new package. For deeper recovery steps, see [Upgrade GSD Pi](./docs/user-docs/getting-started.md#upgrade-gsd-pi) and [Upgrade from older gsd-pi installs](./docs/user-docs/troubleshooting.md#upgrade-from-older-gsd-pi-installs).
 
 ## Quick Start
 
@@ -63,7 +70,7 @@ gsd
 
 Run the setup flow, choose your preferred model provider, and open a project directory. GSD stores project planning and runtime state in `.gsd/`.
 
-For a full first-run walkthrough, see [Getting Started With GSD2](./docs/user-docs/getting-started.md).
+For a full first-run walkthrough, see [Getting Started With gsd-pi](./docs/user-docs/getting-started.md).
 
 ## Common Session Commands
 
@@ -127,7 +134,7 @@ Historical tags and archived refs may exist for traceability, but active release
 
 ## Community
 
-Join the [GSD Discord community](https://discord.com/invite/nKXTsAcmbT).
+Join the [GSD Discord community](https://discord.gg/8NnkKuepmQ).
 
 ## Star History
 

package/dist/claude-cli-check.js

@@ -1,4 +1,4 @@
-// GSD2 — Claude CLI binary detection for onboarding
+// gsd-pi — Claude CLI binary detection for onboarding
 // Lightweight check used at onboarding time (before extensions load).
 // The full readiness check with caching lives in the claude-code-cli extension.
 //

package/dist/extension-sort.js

@@ -1,4 +1,4 @@
-// GSD-2 — Extension Sort: Topological dependency ordering
+// gsd-pi — Extension Sort: Topological dependency ordering
 // Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
 import { readManifestFromEntryPath } from './extension-registry.js';
 /**

package/dist/extension-validator.js

@@ -1,4 +1,4 @@
-// GSD-2 — Extension Package Format Validator
+// gsd-pi — Extension Package Format Validator
 // Copyright (c) 2026 Jeremy McSpadden <jeremy@fluxlabs.net>
 // ─── Individual Check Functions ───────────────────────────────────────────────
 /**

package/dist/loader-entrypoint.js

@@ -1,4 +1,4 @@
-// GSD-2 - Loader child-process entrypoint resolution helpers.
+// gsd-pi - Loader child-process entrypoint resolution helpers.
 import { existsSync as defaultExistsSync } from "node:fs";
 import { join, resolve } from "node:path";
 export function resolveLoaderCliEntrypoint({ gsdRoot, invokedBinPath, env = process.env, existsSync = defaultExistsSync, }) {

package/dist/resource-loader.d.ts

@@ -48,12 +48,9 @@ export declare function mergedFingerprint(hoisted: string, internal: string): st
  *
  * - extensions/ → ~/.gsd/agent/extensions/   (overwrite when version changes)
  * - agents/     → ~/.gsd/agent/agents/        (overwrite when version changes)
+ * - skills/     → ~/.gsd/agent/skills/        (overwrite when version changes)
  * - GSD-WORKFLOW.md → ~/.gsd/agent/GSD-WORKFLOW.md (fallback for env var miss)
  *
- * Skills are NOT synced here. They are installed by the user via the
- * skills.sh CLI (`npx skills add <repo>`) into ~/.agents/skills/ — the
- * industry-standard Agent Skills ecosystem directory.
- *
  * Skips the copy when the managed-resources.json version matches the current
  * GSD version, avoiding ~128ms of synchronous cpSync on every startup.
  * After `npm update -g @glittercowboy/gsd`, versions will differ and the

package/dist/resource-loader.js

@@ -1,6 +1,6 @@
 import { createHash } from 'node:crypto';
 import { homedir } from 'node:os';
-import { chmodSync, copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, openSync, closeSync, readFileSync, readlinkSync, readdirSync, rmSync, statSync, symlinkSync, unlinkSync, writeFileSync } from 'node:fs';
+import { chmodSync, copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, readdirSync, rmSync, symlinkSync, unlinkSync, writeFileSync } from 'node:fs';
 import { basename, dirname, join, relative, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { compareSemver } from './update-check.js';
@@ -14,7 +14,7 @@ function loadPiCodingAgentModule() {
 // Resolve resources directory — prefer dist/resources/ (stable, set at build time)
 // over src/resources/ (live working tree, changes with git branch).
 //
-// Why this matters: with `npm link`, src/resources/ points into the gsd-2 repo's
+// Why this matters: with `npm link`, src/resources/ points into the gsd-pi repo's
 // working tree. Switching branches there changes src/resources/ for ALL projects
 // that use gsd — causing stale/broken extensions to be synced to ~/.gsd/agent/.
 // dist/resources/ is populated by the build step (`npm run copy-resources`) and
@@ -548,12 +548,9 @@ function pruneRemovedBundledExtensions(manifest, agentDir) {
  *
  * - extensions/ → ~/.gsd/agent/extensions/   (overwrite when version changes)
  * - agents/     → ~/.gsd/agent/agents/        (overwrite when version changes)
+ * - skills/     → ~/.gsd/agent/skills/        (overwrite when version changes)
  * - GSD-WORKFLOW.md → ~/.gsd/agent/GSD-WORKFLOW.md (fallback for env var miss)
  *
- * Skills are NOT synced here. They are installed by the user via the
- * skills.sh CLI (`npx skills add <repo>`) into ~/.agents/skills/ — the
- * industry-standard Agent Skills ecosystem directory.
- *
  * Skips the copy when the managed-resources.json version matches the current
  * GSD version, avoiding ~128ms of synchronous cpSync on every startup.
  * After `npm update -g @glittercowboy/gsd`, versions will differ and the
@@ -561,11 +558,12 @@ function pruneRemovedBundledExtensions(manifest, agentDir) {
  *
  * Inspectable: `ls ~/.gsd/agent/extensions/`
  */
-export function initResources(agentDir, skillsDir = join(homedir(), '.agents', 'skills')) {
+export function initResources(agentDir, skillsDir = join(agentDir, 'skills')) {
     mkdirSync(agentDir, { recursive: true });
     const currentVersion = getBundledGsdVersion();
     const manifest = readManagedResourceManifest(agentDir);
     const extensionsDir = join(agentDir, 'extensions');
+    const usingManagedSkillsDir = resolve(skillsDir) === resolve(join(agentDir, 'skills'));
     // Always prune root-level extension files that were removed from the bundle.
     // This is cheap (a few existence checks + at most one rmSync) and must run
     // unconditionally so that stale files left by a previous version are cleaned
@@ -576,9 +574,12 @@ export function initResources(agentDir, skillsDir = join(homedir(), '.agents', '
     // launch, not just during resource syncs. A stale/broken symlink makes ALL
     // extensions fail to resolve @gsd/* packages, rendering GSD non-functional.
     ensureNodeModulesSymlink(agentDir);
-    // Migrate legacy skills on every launch (not gated by manifest) so that
-    // partial-failure retries don't wait for a version bump.
-    migrateSkillsToEcosystemDir(agentDir);
+    // Reclaim exact bundled skill copies from ~/.agents/skills/ on every launch
+    // so existing installs are cleaned up even when the managed-resource manifest
+    // is current. Ambiguous/user-modified copies are left untouched.
+    if (usingManagedSkillsDir) {
+        cleanupBundledSkillsFromEcosystemDir();
+    }
     // Skip the full copy when both version AND content fingerprint match.
     // Version-only checks miss same-version content changes (npm link dev workflow,
     // hotfixes within a release). The content hash catches those at ~1ms cost.
@@ -609,128 +610,55 @@ export function initResources(agentDir, skillsDir = join(homedir(), '.agents', '
     writeManagedResourceManifest(agentDir);
     ensureRegistryEntries(join(agentDir, 'extensions'));
 }
-// ─── Legacy Skill Migration ──────────────────────────────────────────────────────
-/**
- * One-time migration: copy user-customized skills from the old
- * ~/.gsd/agent/skills/ directory into ~/.agents/skills/.
- *
- * The migration is conservative:
- *  - Only skill directories containing a SKILL.md are considered.
- *  - Copies, does not move — the old directory stays intact so downgrading
- *    to a pre-migration GSD version still works.
- *  - Collision-safe — if a skill name already exists in the target, the
- *    existing ecosystem skill wins (user may have already installed a newer
- *    version via skills.sh).
- *  - Writes a `.migrated-to-agents` marker inside the legacy directory so
- *    the migration runs at most once.
- */
-function migrateSkillsToEcosystemDir(agentDir) {
-    const legacyDir = join(agentDir, 'skills');
-    const markerPath = join(legacyDir, '.migrated-to-agents');
-    // Already migrated or no legacy dir — nothing to do
-    if (!existsSync(legacyDir))
+// ─── Bundled Skill Ecosystem Cleanup ─────────────────────────────────────────────
+function cleanupBundledSkillsFromEcosystemDir() {
+    const bundledSkillsDir = join(resourcesDir, 'skills');
+    const ecosystemDir = join(homedir(), '.agents', 'skills');
+    if (!existsSync(bundledSkillsDir) || !existsSync(ecosystemDir))
         return;
-    // Atomic marker check — 'wx' fails if file already exists, preventing races
-    // when two GSD processes start simultaneously.
-    let markerFd;
-    try {
-        markerFd = openSync(markerPath, 'wx');
-    }
-    catch {
-        return; // marker already exists (another process won the race, or already migrated)
-    }
-    try {
-        const ecosystemDir = join(homedir(), '.agents', 'skills');
-        mkdirSync(ecosystemDir, { recursive: true });
-        const entries = readdirSync(legacyDir, { withFileTypes: true });
-        let migrated = 0;
-        let candidates = 0;
-        for (const entry of entries) {
-            // Handle both real directories and symlinks pointing to directories
-            const isDir = entry.isDirectory();
-            const isSymlink = entry.isSymbolicLink();
-            if (!isDir && !isSymlink)
-                continue;
-            const sourcePath = join(legacyDir, entry.name);
-            // For symlinks, verify the target is a directory
-            if (isSymlink) {
-                try {
-                    const stat = statSync(sourcePath);
-                    if (!stat.isDirectory())
-                        continue;
-                }
-                catch {
-                    continue; // broken symlink — skip
-                }
-            }
-            const skillMd = join(sourcePath, 'SKILL.md');
-            if (!existsSync(skillMd))
+    for (const entry of readdirSync(bundledSkillsDir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const sourcePath = join(bundledSkillsDir, entry.name);
+        const targetPath = join(ecosystemDir, entry.name);
+        if (!existsSync(targetPath))
+            continue;
+        try {
+            if (lstatSync(targetPath).isSymbolicLink())
                 continue;
-            const target = join(ecosystemDir, entry.name);
-            if (existsSync(target))
-                continue; // ecosystem version wins
-            candidates++;
-            try {
-                if (isSymlink) {
-                    // Recreate the symlink in the ecosystem directory using an absolute
-                    // target. Relative symlinks would resolve from the new parent dir
-                    // (~/.agents/skills/) instead of the original (~/.gsd/agent/skills/),
-                    // pointing to the wrong location.
-                    const rawTarget = readlinkSync(sourcePath);
-                    const absTarget = resolve(dirname(sourcePath), rawTarget);
-                    symlinkSync(absTarget, target);
-                }
-                else {
-                    cpSync(sourcePath, target, { recursive: true });
-                }
-                migrated++;
-            }
-            catch {
-                // non-fatal — skip this skill
-            }
-        }
-        // If any skills failed to copy, remove the marker so migration retries
-        // on the next launch.  This keeps the legacy dir as fallback until every
-        // skill has been successfully migrated.
-        if (migrated < candidates) {
-            try {
-                closeSync(markerFd);
-                markerFd = -1;
+            if (directoriesHaveExactFileContents(sourcePath, targetPath)) {
+                makeTreeWritable(targetPath);
+                rmSync(targetPath, { recursive: true, force: true });
             }
-            catch { /* non-fatal */ }
-            try {
-                unlinkSync(markerPath);
+            else {
+                console.warn(`[GSD] Leaving ambiguous skill collision in ${targetPath}; ` +
+                    `the bundled copy will be used from ~/.gsd/agent/skills/${entry.name}.`);
             }
-            catch { /* non-fatal */ }
-            return;
         }
-        // Write migration info to the marker
-        try {
-            writeFileSync(markerFd, `Migrated ${migrated} skill(s) to ${ecosystemDir} on ${new Date().toISOString()}\n`);
+        catch {
+            // Non-fatal: never let cleanup of the shared ecosystem dir block startup.
         }
-        catch { /* non-fatal */ }
     }
-    catch {
-        // can't create ecosystem dir or read legacy dir — close fd first (required on Windows
-        // where unlinkSync fails on open handles), then remove marker so we retry next launch
-        try {
-            closeSync(markerFd);
-            markerFd = -1;
-        }
-        catch { /* non-fatal */ }
+}
+function directoriesHaveExactFileContents(sourceDir, targetDir) {
+    const sourceFiles = collectRelativeFiles(sourceDir);
+    const targetFiles = collectRelativeFiles(targetDir);
+    if (sourceFiles.size !== targetFiles.size)
+        return false;
+    for (const relPath of sourceFiles) {
+        if (!targetFiles.has(relPath))
+            return false;
+        const sourcePath = join(sourceDir, relPath);
+        const targetPath = join(targetDir, relPath);
         try {
-            unlinkSync(markerPath);
+            if (!readFileSync(sourcePath).equals(readFileSync(targetPath)))
+                return false;
         }
-        catch { /* non-fatal */ }
-    }
-    finally {
-        if (markerFd !== -1) {
-            try {
-                closeSync(markerFd);
-            }
-            catch { /* non-fatal */ }
+        catch {
+            return false;
         }
     }
+    return true;
 }
 export function hasStaleCompiledExtensionSiblings(extensionsDir, sourceDir = bundledExtensionsDir) {
     if (!existsSync(extensionsDir))

package/dist/resources/.managed-resources-content-hash

@@ -1 +1 @@
-eda201f157ff69af
+8fff737a14c98238

package/dist/resources/extensions/claude-code-cli/stream-adapter.js

@@ -1,4 +1,4 @@
-// GSD2 - Claude Code CLI provider stream adapter
+// gsd-pi - Claude Code CLI provider stream adapter
 /**
  * Stream adapter: bridges the Claude Agent SDK into GSD's streamSimple contract.
  *

package/dist/resources/extensions/github-sync/templates.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Markdown formatters for GitHub sync issues, PR bodies, and comments.
 /**
  * Markdown formatters for GitHub issue bodies, PR descriptions,

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

@@ -1,3 +1,3 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto Orchestration module interfaces and ADR-015 invariant adapter contracts.
 export {};

package/dist/resources/extensions/gsd/auto/custom-verify-retry-store.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Persistence adapter for custom workflow verification retry counts.
 import { readFileSync, mkdirSync, unlinkSync } from "node:fs";
 import { join } from "node:path";

package/dist/resources/extensions/gsd/auto/lease-conflict-notice.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Formats user-facing auto-mode milestone lease conflict notices.
 const LEASE_HELD_RE = /^Milestone\s+(\S+)\s+is held by worker\s+(.+?)\s+until\s+(.+?)\.?$/;
 function formatRelativeDuration(ms) {

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Main auto-mode execution loop.
 /**
  * auto/loop.ts — Main auto-mode execution loop.
@@ -763,6 +763,11 @@ export async function autoLoop(ctx, pi, s, deps, options) {
                     phaseReporter.report("pre-dispatch", preDispatchResult.action);
                     if (preDispatchResult.action === "break") {
                         finishTurn("stopped", "manual-attention", "pre-dispatch-break");
+                        finishIncompleteIteration({
+                            status: "stopped",
+                            reason: "pre-dispatch-break",
+                            failureClass: "manual-attention",
+                        });
                         break;
                     }
                     if (preDispatchResult.action === "continue") {

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto Orchestration module implementation and ADR-015 invariant pipeline owner.
 function now() {
     return Date.now();

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto-loop pipeline phases, merge closeout, and finalize handling.
 /**
  * auto/phases.ts — Pipeline phases for the auto-loop.
@@ -53,6 +53,11 @@ import { getConsecutiveDispatchBlocker } from "../dispatch-guard.js";
 import { captureRootDirtySnapshot, detectRootWriteLeak, formatRootWriteLeakMessage, } from "../root-write-leak-guard.js";
 export const STUCK_WINDOW_SIZE = 6;
 const STUCK_RECOVERY_ATTEMPTS_KEY = "stuck_recovery_attempts";
+export function resolveDispatchRecoveryAttempts(unitRecoveryCount, unitType, unitId) {
+    return (unitRecoveryCount.get(`${unitType}/${unitId}`) ?? 0) > 0
+        ? 0
+        : undefined;
+}
 // ─── Path Comparison Helper ───────────────────────────────────────────────
 /** Compare two paths for physical identity, tolerating trailing slashes and symlinks. */
 function isSamePathLocal(a, b) {
@@ -1030,6 +1035,12 @@ export async function runPreDispatch(ic, loopState) {
     return { action: "next", data: { state, mid, midTitle } };
 }
 // ─── runDispatch ──────────────────────────────────────────────────────────────
+function isUnhandledPhaseWarning(dispatchResult) {
+    return dispatchResult.action === "stop" &&
+        dispatchResult.level === "warning" &&
+        dispatchResult.matchedRule === "<no-match>" &&
+        /^Unhandled phase "/.test(dispatchResult.reason);
+}
 /**
  * Phase 3: Dispatch resolution — resolve next unit, stuck detection, pre-dispatch hooks.
  * Returns break/continue to control the loop, or next with IterationData on success.
@@ -1053,7 +1064,7 @@ export async function runDispatch(ic, preData, loopState) {
             baseUrl: ctx.model?.baseUrl,
         }) ? "true" : "false";
     debugLog("autoLoop", { phase: "dispatch-resolve", iteration: ic.iteration });
-    const dispatchResult = await deps.resolveDispatch({
+    let dispatchResult = await deps.resolveDispatch({
         basePath: s.basePath,
         mid,
         midTitle,
@@ -1065,6 +1076,30 @@ export async function runDispatch(ic, preData, loopState) {
         sessionProvider: ctx.model?.provider,
         modelRegistry: ctx.modelRegistry,
     });
+    if (isUnhandledPhaseWarning(dispatchResult)) {
+        deps.invalidateAllCaches();
+        const freshState = await deps.deriveState(s.canonicalProjectRoot);
+        const freshMid = freshState.activeMilestone?.id ?? mid;
+        const freshMidTitle = freshState.activeMilestone?.title ?? freshMid ?? midTitle;
+        debugLog("autoLoop", {
+            phase: "dispatch-unhandled-phase-retry",
+            iteration: ic.iteration,
+            stalePhase: state.phase,
+            freshPhase: freshState.phase,
+        });
+        dispatchResult = await deps.resolveDispatch({
+            basePath: s.basePath,
+            mid: freshMid,
+            midTitle: freshMidTitle,
+            state: freshState,
+            prefs,
+            session: s,
+            structuredQuestionsAvailable,
+            sessionContextWindow: ctx.model?.contextWindow,
+            sessionProvider: ctx.model?.provider,
+            modelRegistry: ctx.modelRegistry,
+        });
+    }
     if (dispatchResult.action === "stop") {
         deps.emitJournalEvent({ ts: new Date().toISOString(), flowId: ic.flowId, seq: ic.nextSeq(), eventType: "dispatch-stop", rule: dispatchResult.matchedRule, data: { reason: dispatchResult.reason } });
         // Warning-level stops are recoverable human checkpoints (e.g. UAT verdict
@@ -1725,7 +1760,7 @@ export async function runUnitPhase(ic, iterData, loopState, sidecarItem) {
         lastProgressAt: unitStartedAt,
         progressCount: 0,
         lastProgressKind: "dispatch",
-        recoveryAttempts: 0, // Reset so re-dispatched units get full recovery budget (#2322)
+        recoveryAttempts: resolveDispatchRecoveryAttempts(s.unitRecoveryCount, unitType, unitId),
     });
     // Progress widget + preconditions — deferred to after model selection so the
     // widget's first render tick shows the correct model (#2899).

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

@@ -1,4 +1,4 @@
-// GSD-2 + src/resources/extensions/gsd/auto/run-unit.ts - Runs one GSD auto-mode unit from session creation through agent completion.
+// gsd-pi + src/resources/extensions/gsd/auto/run-unit.ts - Runs one GSD auto-mode unit from session creation through agent completion.
 import { NEW_SESSION_TIMEOUT_MS } from "./session.js";
 import { _clearCurrentResolve, _consumePendingSwitchCancellation, _markSessionSwitchAbortGraceWindow, _setCurrentResolve, _setSessionSwitchInFlight, } from "./resolve.js";
 import { getCurrentTurnGeneration, runWithTurnGeneration, } from "./turn-epoch.js";

package/dist/resources/extensions/gsd/auto/schedule-wakeup.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto-mode ScheduleWakeup state shared between the tool and runUnit.
 function wakeupKey(basePath, unitType, unitId) {
     return `${basePath}\0${unitType}\0${unitId}`;

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Mutable auto-mode session state container.
 /**
  * AutoSession — encapsulates all mutable auto-mode state into a single instance.

package/dist/resources/extensions/gsd/auto/unit-runner-events.js

@@ -1,4 +1,4 @@
-// GSD-2 + src/resources/extensions/gsd/auto/unit-runner-events.ts - Classifies agent lifecycle events before Unit settlement.
+// gsd-pi + src/resources/extensions/gsd/auto/unit-runner-events.ts - Classifies agent lifecycle events before Unit settlement.
 export function isInternalSessionTransitionAbortEvent(event) {
     return event.abortOrigin === "session-transition";
 }

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Central retry policy for auto-mode verification redispatches.
 import { createHash } from "node:crypto";
 export const VERIFICATION_RETRY_BASE_DELAY_MS = 2_000;

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Applies custom-engine dispatch decisions to auto-mode loop side effects.
 export async function handleCustomEngineDispatchOutcome(input) {
     if (input.decision.action === "stop") {

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

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

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

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Applies custom-engine reconcile outcomes to auto-mode loop side effects.
 export async function handleCustomEngineReconcileOutcome(input) {
     const details = {

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

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

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";