gsd-pi 2.80.0-dev.3065f7bfa → 2.80.0-dev.488219eb6

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

@@ -3,7 +3,7 @@
 import { Type } from "@sinclair/typebox";
 import { Text } from "@gsd/pi-tui";
 import { loadEffectiveGSDPreferences } from "../preferences.js";
-import { ensureDbOpen } from "./dynamic-tools.js";
+import { ensureDbOpen, resolveCtxCwd } from "./dynamic-tools.js";
 import { loadWriteGateSnapshot, shouldBlockRootArtifactSaveInSnapshot } from "./write-gate.js";
 import { StringEnum } from "@gsd/pi-ai";
 import { logError } from "../workflow-logger.js";
@@ -11,12 +11,6 @@ import { incrementLegacyTelemetry } from "../legacy-telemetry.js";
 async function loadWorkflowExecutors() {
     return import("../tools/workflow-tool-executors.js");
 }
-function toolWorkspaceRoot(ctx) {
-    if (ctx && typeof ctx === "object" && typeof ctx.cwd === "string") {
-        return ctx.cwd;
-    }
-    return process.cwd();
-}
 /**
  * Register an alias tool that shares the same execute function as its canonical counterpart.
  * The alias description and promptGuidelines direct the LLM to prefer the canonical name.
@@ -62,7 +56,7 @@ function readDetails(result) {
 export function registerDbTools(pi) {
     // ─── gsd_decision_save (formerly gsd_save_decision) ─────────────────────
     const decisionSaveExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
-        const basePath = toolWorkspaceRoot(_ctx);
+        const basePath = resolveCtxCwd(_ctx);
         const dbAvailable = await ensureDbOpen(basePath);
         if (!dbAvailable) {
             return {
@@ -147,7 +141,7 @@ export function registerDbTools(pi) {
     registerAlias(pi, decisionSaveTool, "gsd_save_decision", "gsd_decision_save");
     // ─── gsd_requirement_update (formerly gsd_update_requirement) ───────────
     const requirementUpdateExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
-        const basePath = toolWorkspaceRoot(_ctx);
+        const basePath = resolveCtxCwd(_ctx);
         const gateBlock = requirementRootWriteGuard("update_requirement", basePath);
         if (gateBlock)
             return gateBlock;
@@ -233,7 +227,7 @@ export function registerDbTools(pi) {
     registerAlias(pi, requirementUpdateTool, "gsd_update_requirement", "gsd_requirement_update");
     // ─── gsd_requirement_save ─────────────────────────────────────────────
     const requirementSaveExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
-        const basePath = toolWorkspaceRoot(_ctx);
+        const basePath = resolveCtxCwd(_ctx);
         const gateBlock = requirementRootWriteGuard("save_requirement", basePath);
         if (gateBlock)
             return gateBlock;
@@ -333,7 +327,7 @@ export function registerDbTools(pi) {
     // ─── gsd_summary_save (formerly gsd_save_summary) ──────────────────────
     const summarySaveExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
         const { executeSummarySave } = await loadWorkflowExecutors();
-        return executeSummarySave(params, toolWorkspaceRoot(_ctx));
+        return executeSummarySave(params, resolveCtxCwd(_ctx));
     };
     const summarySaveTool = {
         name: "gsd_summary_save",
@@ -382,7 +376,7 @@ export function registerDbTools(pi) {
     // ─── gsd_milestone_generate_id (formerly gsd_generate_milestone_id) ────
     const milestoneGenerateIdExecute = async (_toolCallId, _params, _signal, _onUpdate, _ctx) => {
         try {
-            const basePath = toolWorkspaceRoot(_ctx);
+            const basePath = resolveCtxCwd(_ctx);
             // Claim a reserved ID if the guided-flow already previewed one to the user.
             // This guarantees the ID shown in the UI matches the one materialised on disk.
             const { claimReservedId, findMilestoneIds, getReservedMilestoneIds, nextMilestoneId } = await import("../guided-flow.js");
@@ -464,7 +458,7 @@ export function registerDbTools(pi) {
     // ─── gsd_plan_milestone (gsd_milestone_plan alias) ─────────────────────
     const planMilestoneExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
         const { executePlanMilestone } = await loadWorkflowExecutors();
-        return executePlanMilestone(params, toolWorkspaceRoot(_ctx));
+        return executePlanMilestone(params, resolveCtxCwd(_ctx));
     };
     const planMilestoneTool = {
         name: "gsd_plan_milestone",
@@ -529,7 +523,7 @@ export function registerDbTools(pi) {
     // ─── gsd_plan_slice (gsd_slice_plan alias) ─────────────────────────────
     const planSliceExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
         const { executePlanSlice } = await loadWorkflowExecutors();
-        return executePlanSlice(params, toolWorkspaceRoot(_ctx));
+        return executePlanSlice(params, resolveCtxCwd(_ctx));
     };
     const planSliceTool = {
         name: "gsd_plan_slice",
@@ -573,7 +567,7 @@ export function registerDbTools(pi) {
     registerAlias(pi, planSliceTool, "gsd_slice_plan", "gsd_plan_slice");
     // ─── gsd_plan_task (gsd_task_plan alias) ───────────────────────────────
     const planTaskExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
-        const basePath = toolWorkspaceRoot(_ctx);
+        const basePath = resolveCtxCwd(_ctx);
         const dbAvailable = await ensureDbOpen(basePath);
         if (!dbAvailable) {
             return {
@@ -644,7 +638,7 @@ export function registerDbTools(pi) {
     // ─── gsd_task_complete (gsd_complete_task alias) ────────────────────────
     const taskCompleteExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
         const { executeTaskComplete } = await loadWorkflowExecutors();
-        return executeTaskComplete(params, toolWorkspaceRoot(_ctx));
+        return executeTaskComplete(params, resolveCtxCwd(_ctx));
     };
     const taskCompleteTool = {
         name: "gsd_task_complete",
@@ -707,7 +701,7 @@ export function registerDbTools(pi) {
     // ─── gsd_slice_complete (gsd_complete_slice alias) ─────────────────────
     const sliceCompleteExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
         const { executeSliceComplete } = await loadWorkflowExecutors();
-        return executeSliceComplete(params, toolWorkspaceRoot(_ctx));
+        return executeSliceComplete(params, resolveCtxCwd(_ctx));
     };
     const sliceCompleteTool = {
         name: "gsd_slice_complete",
@@ -787,7 +781,7 @@ export function registerDbTools(pi) {
     registerAlias(pi, sliceCompleteTool, "gsd_complete_slice", "gsd_slice_complete");
     // ─── gsd_skip_slice (#3477 / #3487) ───────────────────────────────────
     const skipSliceExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
-        const basePath = toolWorkspaceRoot(_ctx);
+        const basePath = resolveCtxCwd(_ctx);
         const dbAvailable = await ensureDbOpen(basePath);
         if (!dbAvailable) {
             return {
@@ -872,7 +866,7 @@ export function registerDbTools(pi) {
     // ─── gsd_complete_milestone ────────────────────────────────────────────
     const milestoneCompleteExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
         const { executeCompleteMilestone } = await loadWorkflowExecutors();
-        return executeCompleteMilestone(params, toolWorkspaceRoot(_ctx));
+        return executeCompleteMilestone(params, resolveCtxCwd(_ctx));
     };
     const milestoneCompleteTool = {
         name: "gsd_complete_milestone",
@@ -913,7 +907,7 @@ export function registerDbTools(pi) {
     // ─── gsd_validate_milestone (gsd_milestone_validate alias) ─────────────
     const milestoneValidateExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
         const { executeValidateMilestone } = await loadWorkflowExecutors();
-        return executeValidateMilestone(params, toolWorkspaceRoot(_ctx));
+        return executeValidateMilestone(params, resolveCtxCwd(_ctx));
     };
     const milestoneValidateTool = {
         name: "gsd_validate_milestone",
@@ -946,7 +940,7 @@ export function registerDbTools(pi) {
     // ─── gsd_replan_slice (gsd_slice_replan alias) ─────────────────────────
     const replanSliceExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
         const { executeReplanSlice } = await loadWorkflowExecutors();
-        return executeReplanSlice(params, toolWorkspaceRoot(_ctx));
+        return executeReplanSlice(params, resolveCtxCwd(_ctx));
     };
     const replanSliceTool = {
         name: "gsd_replan_slice",
@@ -989,7 +983,7 @@ export function registerDbTools(pi) {
     // ─── gsd_reassess_roadmap (gsd_roadmap_reassess alias) ─────────────────
     const reassessRoadmapExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
         const { executeReassessRoadmap } = await loadWorkflowExecutors();
-        return executeReassessRoadmap(params, toolWorkspaceRoot(_ctx));
+        return executeReassessRoadmap(params, resolveCtxCwd(_ctx));
     };
     const reassessRoadmapTool = {
         name: "gsd_reassess_roadmap",
@@ -1037,7 +1031,7 @@ export function registerDbTools(pi) {
     // ─── gsd_task_reopen (gsd_reopen_task alias) ───────────────────────────
     // Single-writer v3, Stream 3: reversibility tools for closed units.
     const reopenTaskExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
-        const basePath = toolWorkspaceRoot(_ctx);
+        const basePath = resolveCtxCwd(_ctx);
         const dbAvailable = await ensureDbOpen(basePath);
         if (!dbAvailable) {
             return {
@@ -1100,7 +1094,7 @@ export function registerDbTools(pi) {
     registerAlias(pi, reopenTaskTool, "gsd_reopen_task", "gsd_task_reopen");
     // ─── gsd_slice_reopen (gsd_reopen_slice alias) ─────────────────────────
     const reopenSliceExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
-        const basePath = toolWorkspaceRoot(_ctx);
+        const basePath = resolveCtxCwd(_ctx);
         const dbAvailable = await ensureDbOpen(basePath);
         if (!dbAvailable) {
             return {
@@ -1163,7 +1157,7 @@ export function registerDbTools(pi) {
     registerAlias(pi, reopenSliceTool, "gsd_reopen_slice", "gsd_slice_reopen");
     // ─── gsd_milestone_reopen (gsd_reopen_milestone alias) ─────────────────
     const reopenMilestoneExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
-        const basePath = toolWorkspaceRoot(_ctx);
+        const basePath = resolveCtxCwd(_ctx);
         const dbAvailable = await ensureDbOpen(basePath);
         if (!dbAvailable) {
             return {
@@ -1225,7 +1219,7 @@ export function registerDbTools(pi) {
     // ─── gsd_save_gate_result ──────────────────────────────────────────────
     const saveGateResultExecute = async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
         const { executeSaveGateResult } = await loadWorkflowExecutors();
-        return executeSaveGateResult(params, toolWorkspaceRoot(_ctx));
+        return executeSaveGateResult(params, resolveCtxCwd(_ctx));
     };
     const saveGateResultTool = {
         name: "gsd_save_gate_result",

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

@@ -1,14 +1,30 @@
+// Project/App: GSD-2
+// File Purpose: Registers workspace-aware dynamic filesystem and shell tools.
 import { existsSync } from "node:fs";
+import { homedir } from "node:os";
 import { dirname } from "node:path";
 import { createBashTool, createEditTool, createReadTool, createWriteTool } from "@gsd/pi-coding-agent";
 import { DEFAULT_BASH_TIMEOUT_SECS } from "../constants.js";
 import { setLogBasePath, logWarning } from "../workflow-logger.js";
 import { resolveGsdPathContract } from "../paths.js";
-function resolveToolWorkspaceRoot(ctx) {
+export function safeWorkspaceCwd() {
+    try {
+        return process.cwd();
+    }
+    catch {
+        const projectRoot = process.env.GSD_PROJECT_ROOT;
+        if (projectRoot && existsSync(projectRoot))
+            return projectRoot;
+        return homedir();
+    }
+}
+export function resolveCtxCwd(ctx) {
     if (ctx && typeof ctx === "object" && typeof ctx.cwd === "string") {
-        return ctx.cwd;
+        const cwd = ctx.cwd;
+        if (existsSync(cwd))
+            return cwd;
     }
-    return process.cwd();
+    return safeWorkspaceCwd();
 }
 /**
  * Resolve the correct DB path for the current working directory.
@@ -19,7 +35,7 @@ function resolveToolWorkspaceRoot(ctx) {
 export function resolveProjectRootDbPath(basePath) {
     return resolveGsdPathContract(basePath).projectDb;
 }
-export async function ensureDbOpen(basePath = process.cwd()) {
+export async function ensureDbOpen(basePath = safeWorkspaceCwd()) {
     try {
         const db = await import("../gsd-db.js");
         const contract = resolveGsdPathContract(basePath);
@@ -50,13 +66,14 @@ export async function ensureDbOpen(basePath = process.cwd()) {
     }
 }
 export function registerDynamicTools(pi) {
-    const baseBash = createBashTool(process.cwd(), {
+    const fallbackRoot = safeWorkspaceCwd();
+    const baseBash = createBashTool(fallbackRoot, {
         spawnHook: (ctx) => ctx,
     });
     const dynamicBash = {
         ...baseBash,
         execute: async (toolCallId, params, signal, onUpdate, ctx) => {
-            const basePath = resolveToolWorkspaceRoot(ctx);
+            const basePath = resolveCtxCwd(ctx);
             const fresh = createBashTool(basePath, {
                 spawnHook: (spawnCtx) => ({ ...spawnCtx, cwd: basePath }),
             });
@@ -68,27 +85,27 @@ export function registerDynamicTools(pi) {
         },
     };
     pi.registerTool(dynamicBash);
-    const baseWrite = createWriteTool(process.cwd());
+    const baseWrite = createWriteTool(fallbackRoot);
     pi.registerTool({
         ...baseWrite,
         execute: async (toolCallId, params, signal, onUpdate, ctx) => {
-            const fresh = createWriteTool(resolveToolWorkspaceRoot(ctx));
+            const fresh = createWriteTool(resolveCtxCwd(ctx));
             return fresh.execute(toolCallId, params, signal, onUpdate, ctx);
         },
     });
-    const baseRead = createReadTool(process.cwd());
+    const baseRead = createReadTool(fallbackRoot);
     pi.registerTool({
         ...baseRead,
         execute: async (toolCallId, params, signal, onUpdate, ctx) => {
-            const fresh = createReadTool(resolveToolWorkspaceRoot(ctx));
+            const fresh = createReadTool(resolveCtxCwd(ctx));
             return fresh.execute(toolCallId, params, signal, onUpdate, ctx);
         },
     });
-    const baseEdit = createEditTool(process.cwd());
+    const baseEdit = createEditTool(fallbackRoot);
     pi.registerTool({
         ...baseEdit,
         execute: async (toolCallId, params, signal, onUpdate, ctx) => {
-            const fresh = createEditTool(resolveToolWorkspaceRoot(ctx));
+            const fresh = createEditTool(resolveCtxCwd(ctx));
             return fresh.execute(toolCallId, params, signal, onUpdate, ctx);
         },
     });

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

@@ -1,14 +1,11 @@
+// Project/App: GSD-2
+// File Purpose: Registers Context Mode execution tools.
 // GSD2 — Exec (context-mode) tool registration.
 //
 // Exposes the Context Mode runtime tools in-process. Default-on; opt out with
 // `context_mode.enabled: false` in preferences.
 import { Type } from "@sinclair/typebox";
-function toolWorkspaceRoot(ctx) {
-    if (ctx && typeof ctx === "object" && typeof ctx.cwd === "string") {
-        return ctx.cwd;
-    }
-    return process.cwd();
-}
+import { resolveCtxCwd } from "./dynamic-tools.js";
 async function loadContextModePreferences(baseDir) {
     const [{ loadEffectiveGSDPreferences }, { logWarning }] = await Promise.all([
         import("../preferences.js"),
@@ -50,7 +47,7 @@ export function registerExecTools(pi) {
         }),
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
             const { executeGsdExec } = await import("../tools/exec-tool.js");
-            const baseDir = toolWorkspaceRoot(_ctx);
+            const baseDir = resolveCtxCwd(_ctx);
             return executeGsdExec(params, {
                 baseDir,
                 preferences: await loadContextModePreferences(baseDir),
@@ -77,7 +74,7 @@ export function registerExecTools(pi) {
         }),
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
             const { executeExecSearch } = await import("../tools/exec-search-tool.js");
-            const baseDir = toolWorkspaceRoot(_ctx);
+            const baseDir = resolveCtxCwd(_ctx);
             return executeExecSearch(params, {
                 baseDir,
                 preferences: await loadContextModePreferences(baseDir),
@@ -98,7 +95,7 @@ export function registerExecTools(pi) {
         parameters: Type.Object({}),
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
             const { executeResume } = await import("../tools/resume-tool.js");
-            const baseDir = toolWorkspaceRoot(_ctx);
+            const baseDir = resolveCtxCwd(_ctx);
             return executeResume(params, {
                 baseDir,
                 preferences: await loadContextModePreferences(baseDir),

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

@@ -1,12 +1,9 @@
+// Project/App: GSD-2
+// File Purpose: Registers journal query tools.
 import { Type } from "@sinclair/typebox";
 import { queryJournal } from "../journal.js";
 import { logWarning } from "../workflow-logger.js";
-function toolWorkspaceRoot(ctx) {
-    if (ctx && typeof ctx === "object" && typeof ctx.cwd === "string") {
-        return ctx.cwd;
-    }
-    return process.cwd();
-}
+import { resolveCtxCwd } from "./dynamic-tools.js";
 export function registerJournalTools(pi) {
     pi.registerTool({
         name: "gsd_journal_query",
@@ -43,7 +40,7 @@ export function registerJournalTools(pi) {
                     filters.after = params.after;
                 if (params.before !== undefined)
                     filters.before = params.before;
-                const entries = queryJournal(toolWorkspaceRoot(_ctx), filters);
+                const entries = queryJournal(resolveCtxCwd(_ctx), filters);
                 const limited = entries.slice(0, params.limit ?? 100);
                 if (limited.length === 0) {
                     return {

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

@@ -1,17 +1,13 @@
+// Project/App: GSD-2
+// File Purpose: Registers memory-layer tools.
 // GSD2 — 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
 // is unavailable.
 import { Type } from "@sinclair/typebox";
-import { ensureDbOpen } from "./dynamic-tools.js";
+import { ensureDbOpen, resolveCtxCwd } from "./dynamic-tools.js";
 import { executeGsdGraph, executeMemoryCapture, executeMemoryQuery, } from "../tools/memory-tools.js";
-function toolWorkspaceRoot(ctx) {
-    if (ctx && typeof ctx === "object" && typeof ctx.cwd === "string") {
-        return ctx.cwd;
-    }
-    return process.cwd();
-}
 export function registerMemoryTools(pi) {
     // ─── capture_thought ────────────────────────────────────────────────────
     pi.registerTool({
@@ -45,7 +41,7 @@ export function registerMemoryTools(pi) {
             })),
         }),
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
-            const ok = await ensureDbOpen(toolWorkspaceRoot(_ctx));
+            const ok = await ensureDbOpen(resolveCtxCwd(_ctx));
             if (!ok) {
                 return {
                     content: [{ type: "text", text: "Error: GSD database is not available. Cannot capture memory." }],
@@ -85,7 +81,7 @@ export function registerMemoryTools(pi) {
             reinforce_hits: Type.Optional(Type.Boolean({ description: "Increment hit_count on returned memories (default false)" })),
         }),
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
-            const ok = await ensureDbOpen(toolWorkspaceRoot(_ctx));
+            const ok = await ensureDbOpen(resolveCtxCwd(_ctx));
             if (!ok) {
                 return {
                     content: [{ type: "text", text: "Error: GSD database is not available. Cannot query memory." }],
@@ -123,7 +119,7 @@ export function registerMemoryTools(pi) {
             ], { description: "Only include edges with this relation type" })),
         }),
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
-            const ok = await ensureDbOpen(toolWorkspaceRoot(_ctx));
+            const ok = await ensureDbOpen(resolveCtxCwd(_ctx));
             if (!ok) {
                 return {
                     content: [{ type: "text", text: "Error: GSD database is not available." }],

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

@@ -1,12 +1,8 @@
+// Project/App: GSD-2
+// File Purpose: Registers read-only DB query tools.
 // GSD2 — Read-only query tools exposing DB state to the LLM via the WAL connection
 import { Type } from "@sinclair/typebox";
-import { ensureDbOpen } from "./dynamic-tools.js";
-function toolWorkspaceRoot(ctx) {
-    if (ctx && typeof ctx === "object" && typeof ctx.cwd === "string") {
-        return ctx.cwd;
-    }
-    return process.cwd();
-}
+import { ensureDbOpen, resolveCtxCwd } from "./dynamic-tools.js";
 export function registerQueryTools(pi) {
     pi.registerTool({
         name: "gsd_milestone_status",
@@ -22,7 +18,7 @@ export function registerQueryTools(pi) {
             milestoneId: Type.String({ description: "Milestone ID to query (e.g. M001)" }),
         }),
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
-            const dbAvailable = await ensureDbOpen(toolWorkspaceRoot(_ctx));
+            const dbAvailable = await ensureDbOpen(resolveCtxCwd(_ctx));
             if (!dbAvailable) {
                 return {
                     content: [{ type: "text", text: "Error: GSD database is not available. Cannot read milestone status." }],
@@ -47,7 +43,7 @@ export function registerQueryTools(pi) {
         ],
         parameters: Type.Object({}),
         async execute(_toolCallId, _params, _signal, _onUpdate, _ctx) {
-            const dbAvailable = await ensureDbOpen(toolWorkspaceRoot(_ctx));
+            const dbAvailable = await ensureDbOpen(resolveCtxCwd(_ctx));
             if (!dbAvailable) {
                 return {
                     content: [{ type: "text", text: "Error: GSD database is not available. Cannot checkpoint." }],

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

@@ -36,7 +36,7 @@ export function handleRecoverableExtensionProcessError(err) {
     }
     return false;
 }
-function installEpipeGuard() {
+export function installEpipeGuard() {
     if (!process.listeners("uncaughtException").some((listener) => listener.name === "_gsdEpipeGuard")) {
         const _gsdEpipeGuard = (err) => {
             if (handleRecoverableExtensionProcessError(err))

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

@@ -1,6 +1,8 @@
 // Project/App: GSD-2
 // File Purpose: Registers GSD extension runtime hooks and token-saving tool policies.
-import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { pathToFileURL } from "node:url";
 import { isToolCallEventType } from "@gsd/pi-coding-agent";
 import { updateSnapshot } from "../ecosystem/gsd-extension-api.js";
 import { buildMilestoneFileName, resolveMilestonePath, resolveSliceFile, resolveSlicePath } from "../paths.js";
@@ -22,10 +24,63 @@ import { resolveWorktreeProjectRoot } from "../worktree-root.js";
 import { extractSubagentAgentClasses } from "./subagent-input.js";
 import { approvalGateIdForUnit, isExplicitApprovalResponse, shouldPauseForUserApprovalQuestion } from "../user-input-boundary.js";
 import { resolveSkillManifest } from "../skill-manifest.js";
-// Skip the welcome screen on the very first session_start — cli.ts already
-// printed it before the TUI launched. Only re-print on /clear (subsequent sessions).
-let isFirstSession = true;
 let approvalQuestionAbortInFlight = false;
+async function loadWelcomeScreenModule() {
+    const candidates = [];
+    const gsdBinPath = process.env.GSD_BIN_PATH;
+    if (gsdBinPath) {
+        candidates.push(join(dirname(gsdBinPath), "welcome-screen.js"));
+    }
+    const packageRoot = process.env.GSD_PKG_ROOT;
+    if (packageRoot) {
+        candidates.push(join(packageRoot, "dist", "welcome-screen.js"));
+        candidates.push(join(packageRoot, "src", "welcome-screen.ts"));
+    }
+    for (const candidate of candidates) {
+        try {
+            if (!existsSync(candidate))
+                continue;
+            const mod = await import(pathToFileURL(candidate).href);
+            if (typeof mod.buildWelcomeScreenLines === "function") {
+                return mod;
+            }
+        }
+        catch {
+            // Try the next package layout.
+        }
+    }
+    return undefined;
+}
+async function installWelcomeHeader(ctx) {
+    if (!ctx.hasUI || typeof ctx.ui?.setHeader !== "function")
+        return;
+    try {
+        const welcome = await loadWelcomeScreenModule();
+        if (!welcome)
+            return;
+        let remoteChannel;
+        try {
+            const { resolveRemoteConfig } = await import("../../remote-questions/config.js");
+            const rc = resolveRemoteConfig();
+            if (rc)
+                remoteChannel = rc.channel;
+        }
+        catch { /* non-fatal */ }
+        ctx.ui.setHeader(() => ({
+            render(width) {
+                return welcome.buildWelcomeScreenLines({
+                    version: process.env.GSD_VERSION || "0.0.0",
+                    remoteChannel,
+                    width,
+                });
+            },
+            invalidate() { },
+        }));
+    }
+    catch {
+        /* non-fatal */
+    }
+}
 let deferredApprovalGate = null;
 export const MINIMAL_GSD_TOOL_NAMES = [
     "gsd_exec",
@@ -317,28 +372,7 @@ export function registerHooks(pi, ecosystemHandlers) {
             process.env.GSD_SHOW_TOKEN_COST = prefs?.preferences.show_token_cost ? "1" : "";
         }
         catch { /* non-fatal */ }
-        if (isFirstSession) {
-            isFirstSession = false;
-        }
-        else {
-            try {
-                const gsdBinPath = process.env.GSD_BIN_PATH;
-                if (gsdBinPath) {
-                    const { dirname } = await import("node:path");
-                    const { printWelcomeScreen } = await import(join(dirname(gsdBinPath), "welcome-screen.js"));
-                    let remoteChannel;
-                    try {
-                        const { resolveRemoteConfig } = await import("../../remote-questions/config.js");
-                        const rc = resolveRemoteConfig();
-                        if (rc)
-                            remoteChannel = rc.channel;
-                    }
-                    catch { /* non-fatal */ }
-                    printWelcomeScreen({ version: process.env.GSD_VERSION || "0.0.0", remoteChannel });
-                }
-            }
-            catch { /* non-fatal */ }
-        }
+        await installWelcomeHeader(ctx);
         await loadToolApiKeysForSession();
         if (isAutoActive()) {
             ctx.ui.setWidget("gsd-health", undefined);

package/dist/resources/extensions/gsd/bootstrap/sanitize-complete-milestone.js

@@ -36,6 +36,8 @@ function toStrArray(v) {
  * CompleteMilestoneParams, tolerating type mismatches from LLM JSON quirks.
  */
 export function sanitizeCompleteMilestoneParams(raw) {
+    const actorName = toStr(raw.actorName);
+    const triggerReason = toStr(raw.triggerReason);
     return {
         milestoneId: toStr(raw.milestoneId),
         title: toStr(raw.title),
@@ -50,5 +52,7 @@ export function sanitizeCompleteMilestoneParams(raw) {
         followUps: toStr(raw.followUps),
         deviations: toStr(raw.deviations),
         verificationPassed: raw.verificationPassed === true || raw.verificationPassed === "true",
+        ...(actorName ? { actorName } : {}),
+        ...(triggerReason ? { triggerReason } : {}),
     };
 }

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

@@ -12,7 +12,7 @@ import { handleRemote } from "../../../remote-questions/mod.js";
 import { handleShip } from "../../commands-ship.js";
 import { handleSessionReport } from "../../commands-session-report.js";
 import { handlePrBranch } from "../../commands-pr-branch.js";
-import { projectRoot } from "../context.js";
+import { currentDirectoryRoot, projectRoot } from "../context.js";
 export async function handleOpsCommand(trimmed, ctx, pi) {
     if (trimmed === "init") {
         const { detectProjectState } = await import("../../detection.js");
@@ -114,7 +114,7 @@ export async function handleOpsCommand(trimmed, ctx, pi) {
         return true;
     }
     if (trimmed === "triage") {
-        await handleTriage(ctx, pi, process.cwd());
+        await handleTriage(ctx, pi, currentDirectoryRoot());
         return true;
     }
     if (trimmed === "config") {

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

@@ -19,7 +19,7 @@ export const TOOL_KEYS = [
     { id: "jina", env: "JINA_API_KEY", label: "Jina Page Extract", hint: "jina.ai/api" },
     { id: "groq", env: "GROQ_API_KEY", label: "Groq Voice", hint: "console.groq.com" },
 ];
-function getStoredToolKey(auth, providerId) {
+export function getStoredToolKey(auth, providerId) {
     const creds = auth.getCredentialsForProvider(providerId);
     const cred = creds.find((c) => c.type === "api_key" && c.key);
     return cred?.type === "api_key" ? cred.key : undefined;

package/dist/resources/extensions/gsd/commands-eval-review.js

@@ -23,7 +23,7 @@
  *   6. Silent flag stripping — token-level argument parser; unknown
  *      `--*` tokens raise an explicit error.
  */
-import { existsSync } from "node:fs";
+import { existsSync, realpathSync } from "node:fs";
 import { open, readFile } from "node:fs/promises";
 import { join, relative } from "node:path";
 import { buildSliceFileName, resolveMilestonePath, resolveSliceFile, resolveSlicePath, } from "./paths.js";
@@ -194,7 +194,7 @@ export async function buildEvalReviewContext(state, milestoneId, now = () => new
         }
     }
     const truncated = summaryRead.truncated || specTruncated;
-    const outputPath = evalReviewWritePath(state.sliceDir, state.sliceId);
+    const outputPath = evalReviewWritePath(realpathSync(state.sliceDir), state.sliceId);
     const basePath = projectRoot();
     const relativeOutputPath = relative(basePath, outputPath);
     return {

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

@@ -21,7 +21,7 @@ import { estimateTimeRemaining } from "./auto-dashboard.js";
 import { computeProgressScore } from "./progress-score.js";
 import { runEnvironmentChecks } from "./doctor-environment.js";
 import { formattedShortcutPair } from "./shortcut-defs.js";
-function unitLabel(type) {
+export function unitLabel(type) {
     switch (type) {
         case "discuss-milestone":
         case "discuss-slice": return "Discuss";