gsd-pi 2.75.0 → 2.76.0

package/dist/resources/extensions/shared/interview-ui.js

@@ -24,11 +24,20 @@
  *   Enter / →    submit all answers
  *   Esc          exit confirmation
  */
-import { Editor, Key, matchesKey, truncateToWidth, } from "@gsd/pi-tui";
+import { getMarkdownTheme } from "@gsd/pi-coding-agent";
+import { Editor, Key, Markdown, matchesKey, truncateToWidth, } from "@gsd/pi-tui";
+import { mergeSideBySide } from "./layout-utils.js";
 import { makeUI, INDENT } from "./ui.js";
 // ─── Constants ────────────────────────────────────────────────────────────────
 const OTHER_OPTION_LABEL = "None of the above";
 const OTHER_OPTION_DESCRIPTION = "Select to type your own answer.";
+// Preview layout constants
+const MIN_PREVIEW_WIDTH = 30;
+const MIN_OPTIONS_WIDTH = 30;
+const PREVIEW_RATIO = 0.60; // preview gets the majority of the width
+const DIVIDER_CHARS = " │ ";
+const DIVIDER_WIDTH = 3;
+const PREVIEW_MAX_LINES = 20; // hard cap — keeps total ≤ 24 rows for single-question
 // ─── Wrap-up screen ───────────────────────────────────────────────────────────
 export async function showWrapUpScreen(opts, ctx) {
     return ctx.ui.custom((tui, theme, _kb, done) => {
@@ -461,6 +470,98 @@ export async function showInterviewRound(questions, opts, ctx) {
             push(ui.blank(), ui.hints(["↑/↓ to choose", "1/2 to quick-select", "enter to confirm"]), ui.bar());
             return lines;
         }
+        // ── Preview helpers ──────────────────────────────────────────────
+        let mdThemeCache = null;
+        let previewCache = null;
+        function questionHasAnyPreview() {
+            return questions[currentIdx].options.some((o) => o.preview != null && o.preview.trim().length > 0);
+        }
+        function getCurrentPreview() {
+            const q = questions[currentIdx];
+            const idx = states[currentIdx].cursorIndex;
+            if (idx < q.options.length) {
+                const preview = q.options[idx].preview;
+                return preview && preview.trim().length > 0 ? preview : null;
+            }
+            return null;
+        }
+        function renderOptionsColumn(optWidth) {
+            const ui = makeUI(theme, optWidth);
+            const col = [];
+            const push = (...rows) => { for (const r of rows)
+                col.push(...r); };
+            const q = questions[currentIdx];
+            const st = states[currentIdx];
+            const multiSel = isMultiSelect(currentIdx);
+            push(ui.question(` ${q.question}`));
+            if (multiSel)
+                push(ui.meta("  (Select all that apply)"));
+            push(ui.blank());
+            for (let i = 0; i < q.options.length; i++) {
+                const opt = q.options[i];
+                const isCursor = i === st.cursorIndex;
+                if (multiSel) {
+                    const isChecked = st.checkedIndices.has(i);
+                    if (isCursor && !focusNotes)
+                        push(ui.checkboxSelected(opt.label, opt.description, isChecked));
+                    else
+                        push(ui.checkboxUnselected(opt.label, opt.description, isChecked, focusNotes));
+                }
+                else {
+                    const isCommitted = i === st.committedIndex;
+                    if (isCursor && !focusNotes) {
+                        push(ui.optionSelected(i + 1, opt.label, opt.description, isCommitted));
+                    }
+                    else {
+                        push(ui.optionUnselected(i + 1, opt.label, opt.description, { isCommitted, isFocusDimmed: focusNotes }));
+                    }
+                }
+            }
+            const ndIdx = noneOrDoneIdx(currentIdx);
+            const ndCursor = ndIdx === st.cursorIndex;
+            if (multiSel) {
+                push(ui.blank());
+                if (ndCursor && !focusNotes)
+                    push(ui.doneSelected());
+                else
+                    push(ui.doneUnselected());
+            }
+            else {
+                const ndCommitted = ndIdx === st.committedIndex;
+                if (ndCursor && !focusNotes) {
+                    push(ui.slotSelected(OTHER_OPTION_LABEL, OTHER_OPTION_DESCRIPTION, ndCommitted));
+                }
+                else {
+                    push(ui.slotUnselected(OTHER_OPTION_LABEL, OTHER_OPTION_DESCRIPTION, { isCommitted: ndCommitted, isFocusDimmed: focusNotes }));
+                }
+            }
+            if (st.notesVisible || focusNotes) {
+                push(ui.blank(), ui.notesLabel(focusNotes));
+                if (focusNotes) {
+                    for (const line of getEditor().render(optWidth - 2))
+                        col.push(truncateToWidth(` ${line}`, optWidth));
+                }
+                else if (st.notes) {
+                    push(ui.notesText(st.notes));
+                }
+            }
+            return col;
+        }
+        function renderPreviewColumn(markdown, previewWidth) {
+            if (previewCache && previewCache.markdown === markdown && previewCache.width === previewWidth) {
+                return previewCache.lines;
+            }
+            if (!mdThemeCache)
+                mdThemeCache = getMarkdownTheme();
+            const header = [
+                truncateToWidth(theme.fg("accent", theme.bold(" Preview")), previewWidth),
+                truncateToWidth(theme.fg("dim", " " + "─".repeat(Math.max(0, previewWidth - 2))), previewWidth),
+            ];
+            const md = new Markdown(markdown, 1, 0, mdThemeCache);
+            const lines = [...header, ...md.render(previewWidth)];
+            previewCache = { markdown, width: previewWidth, lines };
+            return lines;
+        }
         // ── Main render ──────────────────────────────────────────────────
         function render(width) {
             if (cachedLines)
@@ -473,6 +574,93 @@ export async function showInterviewRound(questions, opts, ctx) {
                 cachedLines = renderReviewScreen(width);
                 return cachedLines;
             }
+            const useSideBySide = questionHasAnyPreview()
+                && width >= (MIN_OPTIONS_WIDTH + MIN_PREVIEW_WIDTH + DIVIDER_WIDTH);
+            if (useSideBySide) {
+                // ── Preview path ──────────────────────────────────────
+                const ui = makeUI(theme, width);
+                const lines = [];
+                const push = (...rows) => { for (const r of rows)
+                    lines.push(...r); };
+                push(ui.bar());
+                if (isMultiQuestion) {
+                    const unanswered = questions.filter((_, i) => !isQuestionAnswered(i)).length;
+                    const answeredSet = new Set(questions.map((_, i) => i).filter(i => isQuestionAnswered(i)));
+                    push(ui.questionTabs(questions.map(q => q.header), currentIdx, answeredSet));
+                    push(ui.blank());
+                    const progressParts = [
+                        opts.progress,
+                        `Question ${currentIdx + 1}/${questions.length}`,
+                        unanswered > 0 ? `${unanswered} unanswered` : null,
+                    ].filter(Boolean).join("  •  ");
+                    if (progressParts)
+                        push(ui.meta(`  ${progressParts}`));
+                    push(ui.blank());
+                }
+                else {
+                    if (opts.progress)
+                        push(ui.meta(`  ${opts.progress}`), ui.blank());
+                }
+                // Side-by-side body — fixed height per render, capped to terminal.
+                // tuiChrome accounts for elements rendered outside the interview
+                // component: spinner/loader (1-2), status line (1), tool header (1),
+                // plus a safety margin for future additions.
+                const termRows = (typeof process !== "undefined" && process.stdout?.rows) || 24;
+                const footerLines = 3; // blank + hints + bar
+                const tuiChrome = 5;
+                const maxBody = Math.min(PREVIEW_MAX_LINES, Math.max(6, termRows - lines.length - footerLines - tuiChrome));
+                const previewWidth = Math.max(MIN_PREVIEW_WIDTH, Math.floor(width * PREVIEW_RATIO));
+                const leftWidth = Math.max(MIN_OPTIONS_WIDTH, width - previewWidth - DIVIDER_WIDTH);
+                const fullLeft = renderOptionsColumn(leftWidth);
+                const leftLines = fullLeft.slice(0, maxBody);
+                if (fullLeft.length > maxBody) {
+                    const n = fullLeft.length - maxBody + 1;
+                    const lbl = `+${n} lines hidden`;
+                    const d = "─".repeat(Math.max(0, Math.floor((leftWidth - lbl.length - 2) / 2)));
+                    leftLines[maxBody - 1] = truncateToWidth(theme.fg("dim", ` ${d} ${lbl} ${d}`), leftWidth);
+                }
+                const preview = getCurrentPreview();
+                const fullRight = preview ? renderPreviewColumn(preview, previewWidth) : [];
+                const rightLines = fullRight.slice(0, maxBody);
+                if (fullRight.length > maxBody) {
+                    const n = fullRight.length - maxBody + 1;
+                    const lbl = `+${n} lines hidden`;
+                    const d = "─".repeat(Math.max(0, Math.floor((previewWidth - lbl.length - 2) / 2)));
+                    rightLines[maxBody - 1] = truncateToWidth(theme.fg("dim", ` ${d} ${lbl} ${d}`), previewWidth);
+                }
+                while (leftLines.length < maxBody)
+                    leftLines.push("");
+                while (rightLines.length < maxBody)
+                    rightLines.push("");
+                const divider = theme.fg("dim", DIVIDER_CHARS);
+                lines.push(...mergeSideBySide(leftLines, rightLines, leftWidth, divider, width));
+                // Footer
+                push(ui.blank());
+                const isLast = !isMultiQuestion || currentIdx === questions.length - 1;
+                const hints = [];
+                if (focusNotes) {
+                    hints.push("enter to confirm");
+                    hints.push("tab or esc to close notes");
+                }
+                else if (isMultiSelect(currentIdx)) {
+                    hints.push("space to toggle");
+                    if (isMultiQuestion)
+                        hints.push("←/→ navigate questions");
+                    hints.push("tab to add notes");
+                    hints.push(isLast && allAnswered() ? "enter to review" : "enter to next");
+                }
+                else {
+                    hints.push("tab to add notes");
+                    if (isMultiQuestion)
+                        hints.push("←/→ navigate");
+                    hints.push(isLast && allAnswered() ? "enter to review" : "enter to next");
+                }
+                hints.push("esc to exit");
+                push(ui.hints(hints), ui.bar());
+                cachedLines = lines;
+                return lines;
+            }
+            // ── Original path — no preview, untouched ────────────────
             const ui = makeUI(theme, width);
             const lines = [];
             const push = (...rows) => { for (const r of rows)

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

@@ -44,3 +44,20 @@ export function fitColumns(parts, width, separator = "  ") {
     }
     return truncateToWidth(result, width);
 }
+/**
+ * Merge two sets of lines into a side-by-side layout with a vertical divider.
+ *
+ * Each left line is padded to `leftWidth`, then joined with a styled divider
+ * and the corresponding right line. Output lines are truncated to `totalWidth`.
+ */
+export function mergeSideBySide(leftLines, rightLines, leftWidth, divider, totalWidth) {
+    const maxLen = Math.max(leftLines.length, rightLines.length);
+    const merged = [];
+    for (let i = 0; i < maxLen; i++) {
+        const left = i < leftLines.length ? leftLines[i] : "";
+        const right = i < rightLines.length ? rightLines[i] : "";
+        const paddedLeft = padRight(left, leftWidth);
+        merged.push(truncateToWidth(paddedLeft + divider + right, totalWidth));
+    }
+    return merged;
+}

package/dist/resources/extensions/shared/rtk-shared.js

@@ -0,0 +1,47 @@
+import { existsSync } from "node:fs";
+import { homedir as osHomedir } from "node:os";
+import { delimiter, join } from "node:path";
+export const GSD_RTK_DISABLED_ENV = "GSD_RTK_DISABLED";
+export const GSD_RTK_PATH_ENV = "GSD_RTK_PATH";
+export const RTK_TELEMETRY_DISABLED_ENV = "RTK_TELEMETRY_DISABLED";
+export function isTruthy(value) {
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes";
+}
+export function isRtkEnabled(env = process.env) {
+    return !isTruthy(env[GSD_RTK_DISABLED_ENV]);
+}
+export function getManagedRtkDir(env = process.env) {
+    return join(env.GSD_HOME || join(osHomedir(), ".gsd"), "agent", "bin");
+}
+export function getRtkBinaryName(platform = process.platform) {
+    return platform === "win32" ? "rtk.exe" : "rtk";
+}
+export function getPathValue(env) {
+    const pathKey = Object.keys(env).find((key) => key.toLowerCase() === "path");
+    return pathKey ? env[pathKey] : env.PATH;
+}
+export function resolvePathCandidates(pathValue) {
+    if (!pathValue)
+        return [];
+    return pathValue
+        .split(delimiter)
+        .map((part) => part.trim())
+        .filter(Boolean);
+}
+export function resolveSystemRtkPath(pathValue, platform = process.platform) {
+    const candidates = platform === "win32"
+        ? ["rtk.exe", "rtk.cmd", "rtk.bat", "rtk"]
+        : ["rtk"];
+    for (const dir of resolvePathCandidates(pathValue)) {
+        for (const candidate of candidates) {
+            const fullPath = join(dir, candidate);
+            if (existsSync(fullPath)) {
+                return fullPath;
+            }
+        }
+    }
+    return null;
+}

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

@@ -1,18 +1,10 @@
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
-import { homedir } from "node:os";
-import { delimiter, join } from "node:path";
-const GSD_RTK_PATH_ENV = "GSD_RTK_PATH";
-const GSD_RTK_DISABLED_ENV = "GSD_RTK_DISABLED";
+import { join } from "node:path";
+import { GSD_RTK_PATH_ENV, RTK_TELEMETRY_DISABLED_ENV, getManagedRtkDir, getPathValue, getRtkBinaryName, isRtkEnabled, resolveSystemRtkPath, } from "./rtk-shared.js";
 const GSD_RTK_REWRITE_TIMEOUT_MS_ENV = "GSD_RTK_REWRITE_TIMEOUT_MS";
-const RTK_TELEMETRY_DISABLED_ENV = "RTK_TELEMETRY_DISABLED";
 const RTK_REWRITE_TIMEOUT_MS = 5_000;
-function isTruthy(value) {
-    if (!value)
-        return false;
-    const normalized = value.trim().toLowerCase();
-    return normalized === "1" || normalized === "true" || normalized === "yes";
-}
+export { isRtkEnabled };
 function getRewriteTimeoutMs(env = process.env) {
     const configured = Number.parseInt(env[GSD_RTK_REWRITE_TIMEOUT_MS_ENV] ?? "", 10);
     if (Number.isFinite(configured) && configured > 0) {
@@ -20,47 +12,12 @@ function getRewriteTimeoutMs(env = process.env) {
     }
     return RTK_REWRITE_TIMEOUT_MS;
 }
-export function isRtkEnabled(env = process.env) {
-    return !isTruthy(env[GSD_RTK_DISABLED_ENV]);
-}
 export function buildRtkEnv(env = process.env) {
     return {
         ...env,
         [RTK_TELEMETRY_DISABLED_ENV]: "1",
     };
 }
-function getManagedRtkDir(env = process.env) {
-    return join(env.GSD_HOME || join(homedir(), ".gsd"), "agent", "bin");
-}
-function getRtkBinaryName(platform = process.platform) {
-    return platform === "win32" ? "rtk.exe" : "rtk";
-}
-function getPathValue(env) {
-    const pathKey = Object.keys(env).find((key) => key.toLowerCase() === "path");
-    return pathKey ? env[pathKey] : env.PATH;
-}
-function resolvePathCandidates(pathValue) {
-    if (!pathValue)
-        return [];
-    return pathValue
-        .split(delimiter)
-        .map((part) => part.trim())
-        .filter(Boolean);
-}
-function resolveSystemRtkPath(pathValue, platform = process.platform) {
-    const candidates = platform === "win32"
-        ? ["rtk.exe", "rtk.cmd", "rtk.bat", "rtk"]
-        : ["rtk"];
-    for (const dir of resolvePathCandidates(pathValue)) {
-        for (const candidate of candidates) {
-            const fullPath = join(dir, candidate);
-            if (existsSync(fullPath)) {
-                return fullPath;
-            }
-        }
-    }
-    return null;
-}
 export function resolveRtkBinaryPath(options = {}) {
     const env = options.env ?? process.env;
     const platform = options.platform ?? process.platform;

package/dist/resources/skills/create-workflow/SKILL.md

@@ -46,8 +46,32 @@ You are a workflow definition author. You help users create valid V1 YAML workfl
 
 **Output Location:**
 
-- Finished definitions go in `.gsd/workflow-defs/<name>.yaml`.
-- After writing, tell the user to validate with `/gsd workflow validate <name>`.
+- Project plugins: `.gsd/workflows/<name>.yaml` (preferred — checked into repo).
+- Global plugins: `~/.gsd/workflows/<name>.yaml` (private to the machine). Use
+  this when the user says "global" or "--global".
+- Legacy location `.gsd/workflow-defs/<name>.yaml` still works but is being
+  phased out — only write there if the user explicitly asks.
+- After writing, tell the user to validate with `/gsd workflow validate <name>`
+  and run with `/gsd workflow <name>`.
+
+**Execution mode:**
+
+Workflow plugins declare a `mode:` field in their top-level YAML (or
+`<template_meta>` block for markdown) that controls runtime behavior:
+
+- `oneshot` — prompt-only, no state, no artifact dir. For one-pass tasks
+  like reviews, reports, or one-off scripts. Default for YAML with a single
+  step when iteration isn't needed.
+- `yaml-step` — full engine with GRAPH.yaml, iterate, and verify. **Default
+  for YAML.** Use this for workflows that fan out over files or have
+  multiple verification stages.
+- `markdown-phase` — phased markdown-driven workflows with STATE.json and
+  phase-approval gates. For multi-session projects. Markdown-only.
+- `auto-milestone` — hooks into the full `/gsd auto` pipeline. Reserved
+  for the bundled `full-project` template; not normally authored by users.
+
+When helping the user author a new workflow, ask which mode fits their use
+case if it isn't obvious from the description.
 </essential_principles>
 
 <routing>
@@ -96,8 +120,11 @@ When assembling the final YAML:
 1. Use 2-space indentation consistently.
 2. Quote string values that contain special YAML characters (`:`, `{`, `}`, `[`, `]`, `#`).
 3. Always include `version: 1` as the first field.
-4. Order top-level fields: `version`, `name`, `description`, `params`, `steps`.
-5. Order step fields: `id`, `name`, `prompt`, `requires`, `produces`, `context_from`, `verify`, `iterate`.
-6. Write the file to `.gsd/workflow-defs/<name>.yaml`.
-7. After writing, tell the user: "Run `/gsd workflow validate <name>` to check the definition."
+4. Order top-level fields: `version`, `name`, `mode`, `description`, `params`, `steps`.
+5. Include a `mode:` field (`oneshot` or `yaml-step`). Default to `yaml-step`.
+6. Order step fields: `id`, `name`, `prompt`, `requires`, `produces`, `context_from`, `verify`, `iterate`.
+7. Write to `.gsd/workflows/<name>.yaml` by default, or `~/.gsd/workflows/<name>.yaml`
+   when the user says "global" or passes `--global`.
+8. After writing, tell the user: "Run `/gsd workflow validate <name>` to check the
+   definition, then `/gsd workflow <name>` to run it."
 </output_conventions>

package/dist/rtk-shared.d.ts

@@ -0,0 +1,10 @@
+export declare const GSD_RTK_DISABLED_ENV = "GSD_RTK_DISABLED";
+export declare const GSD_RTK_PATH_ENV = "GSD_RTK_PATH";
+export declare const RTK_TELEMETRY_DISABLED_ENV = "RTK_TELEMETRY_DISABLED";
+export declare function isTruthy(value: string | undefined): boolean;
+export declare function isRtkEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function getManagedRtkDir(env?: NodeJS.ProcessEnv): string;
+export declare function getRtkBinaryName(platform?: NodeJS.Platform): string;
+export declare function getPathValue(env: NodeJS.ProcessEnv): string | undefined;
+export declare function resolvePathCandidates(pathValue: string | undefined): string[];
+export declare function resolveSystemRtkPath(pathValue: string | undefined, platform?: NodeJS.Platform): string | null;

package/dist/rtk-shared.js

@@ -0,0 +1,47 @@
+import { existsSync } from "node:fs";
+import { homedir as osHomedir } from "node:os";
+import { delimiter, join } from "node:path";
+export const GSD_RTK_DISABLED_ENV = "GSD_RTK_DISABLED";
+export const GSD_RTK_PATH_ENV = "GSD_RTK_PATH";
+export const RTK_TELEMETRY_DISABLED_ENV = "RTK_TELEMETRY_DISABLED";
+export function isTruthy(value) {
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes";
+}
+export function isRtkEnabled(env = process.env) {
+    return !isTruthy(env[GSD_RTK_DISABLED_ENV]);
+}
+export function getManagedRtkDir(env = process.env) {
+    return join(env.GSD_HOME || join(osHomedir(), ".gsd"), "agent", "bin");
+}
+export function getRtkBinaryName(platform = process.platform) {
+    return platform === "win32" ? "rtk.exe" : "rtk";
+}
+export function getPathValue(env) {
+    const pathKey = Object.keys(env).find((key) => key.toLowerCase() === "path");
+    return pathKey ? env[pathKey] : env.PATH;
+}
+export function resolvePathCandidates(pathValue) {
+    if (!pathValue)
+        return [];
+    return pathValue
+        .split(delimiter)
+        .map((part) => part.trim())
+        .filter(Boolean);
+}
+export function resolveSystemRtkPath(pathValue, platform = process.platform) {
+    const candidates = platform === "win32"
+        ? ["rtk.exe", "rtk.cmd", "rtk.bat", "rtk"]
+        : ["rtk"];
+    for (const dir of resolvePathCandidates(pathValue)) {
+        for (const candidate of candidates) {
+            const fullPath = join(dir, candidate);
+            if (existsSync(fullPath)) {
+                return fullPath;
+            }
+        }
+    }
+    return null;
+}

package/dist/rtk.d.ts

@@ -1,9 +1,8 @@
 import { spawnSync } from "node:child_process";
+import { GSD_RTK_DISABLED_ENV, GSD_RTK_PATH_ENV, RTK_TELEMETRY_DISABLED_ENV, getManagedRtkDir, getRtkBinaryName, isRtkEnabled } from "./rtk-shared.js";
 export declare const RTK_VERSION = "0.33.1";
-export declare const GSD_RTK_DISABLED_ENV = "GSD_RTK_DISABLED";
 export declare const GSD_SKIP_RTK_INSTALL_ENV = "GSD_SKIP_RTK_INSTALL";
-export declare const GSD_RTK_PATH_ENV = "GSD_RTK_PATH";
-export declare const RTK_TELEMETRY_DISABLED_ENV = "RTK_TELEMETRY_DISABLED";
+export { GSD_RTK_DISABLED_ENV, GSD_RTK_PATH_ENV, RTK_TELEMETRY_DISABLED_ENV, getManagedRtkDir, getRtkBinaryName, isRtkEnabled, };
 export interface EnsureRtkOptions {
     targetDir?: string;
     allowDownload?: boolean;
@@ -20,9 +19,6 @@ export interface EnsureRtkResult {
     binaryPath?: string;
     reason?: string;
 }
-export declare function isRtkEnabled(env?: NodeJS.ProcessEnv): boolean;
-export declare function getManagedRtkDir(env?: NodeJS.ProcessEnv): string;
-export declare function getRtkBinaryName(platform?: NodeJS.Platform): string;
 export declare function getManagedRtkPath(platform?: NodeJS.Platform, targetDir?: string): string;
 export declare function prependPathEntry(env: NodeJS.ProcessEnv, entry: string): NodeJS.ProcessEnv;
 export declare function applyRtkProcessEnv(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;

package/dist/rtk.js

@@ -2,36 +2,17 @@ import { createHash, randomUUID } from "node:crypto";
 import { spawnSync } from "node:child_process";
 import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, chmodSync, readdirSync } from "node:fs";
 import { createWriteStream } from "node:fs";
-import { arch as osArch, homedir as osHomedir } from "node:os";
+import { arch as osArch } from "node:os";
 import { delimiter, join } from "node:path";
 import { Readable } from "node:stream";
 import { finished } from "node:stream/promises";
 import extractZip from "extract-zip";
+import { GSD_RTK_DISABLED_ENV, GSD_RTK_PATH_ENV, RTK_TELEMETRY_DISABLED_ENV, getManagedRtkDir, getPathValue, getRtkBinaryName, isTruthy, isRtkEnabled, resolveSystemRtkPath, } from "./rtk-shared.js";
 export const RTK_VERSION = "0.33.1";
-export const GSD_RTK_DISABLED_ENV = "GSD_RTK_DISABLED";
 export const GSD_SKIP_RTK_INSTALL_ENV = "GSD_SKIP_RTK_INSTALL";
-export const GSD_RTK_PATH_ENV = "GSD_RTK_PATH";
-export const RTK_TELEMETRY_DISABLED_ENV = "RTK_TELEMETRY_DISABLED";
+export { GSD_RTK_DISABLED_ENV, GSD_RTK_PATH_ENV, RTK_TELEMETRY_DISABLED_ENV, getManagedRtkDir, getRtkBinaryName, isRtkEnabled, };
 const RTK_REPO = "rtk-ai/rtk";
 const RTK_REWRITE_TIMEOUT_MS = 5_000;
-function isTruthy(value) {
-    if (!value)
-        return false;
-    const normalized = value.trim().toLowerCase();
-    return normalized === "1" || normalized === "true" || normalized === "yes";
-}
-export function isRtkEnabled(env = process.env) {
-    return !isTruthy(env[GSD_RTK_DISABLED_ENV]);
-}
-function resolveAppRoot(env = process.env) {
-    return env.GSD_HOME || join(osHomedir(), ".gsd");
-}
-export function getManagedRtkDir(env = process.env) {
-    return join(resolveAppRoot(env), "agent", "bin");
-}
-export function getRtkBinaryName(platform = process.platform) {
-    return platform === "win32" ? "rtk.exe" : "rtk";
-}
 export function getManagedRtkPath(platform = process.platform, targetDir = getManagedRtkDir()) {
     return join(targetDir, getRtkBinaryName(platform));
 }
@@ -49,10 +30,6 @@ export function applyRtkProcessEnv(env = process.env) {
     env[RTK_TELEMETRY_DISABLED_ENV] = "1";
     return env;
 }
-function getPathValue(env) {
-    const pathKey = Object.keys(env).find((key) => key.toLowerCase() === "path");
-    return pathKey ? env[pathKey] : env.PATH;
-}
 export function buildRtkEnv(env = process.env) {
     return applyRtkProcessEnv({ ...env });
 }
@@ -150,28 +127,6 @@ async function extractArchiveAsync(assetName, archivePath, extractDir) {
     }
     extractArchive(assetName, archivePath, extractDir);
 }
-function resolvePathCandidates(pathValue) {
-    if (!pathValue)
-        return [];
-    return pathValue
-        .split(delimiter)
-        .map((part) => part.trim())
-        .filter(Boolean);
-}
-function resolveSystemRtkPath(pathValue, platform = process.platform) {
-    const candidates = platform === "win32"
-        ? ["rtk.exe", "rtk.cmd", "rtk.bat", "rtk"]
-        : ["rtk"];
-    for (const dir of resolvePathCandidates(pathValue)) {
-        for (const candidate of candidates) {
-            const fullPath = join(dir, candidate);
-            if (existsSync(fullPath)) {
-                return fullPath;
-            }
-        }
-    }
-    return null;
-}
 export function resolveRtkBinaryPath(options = {}) {
     const env = options.env ?? process.env;
     const platform = options.platform ?? process.platform;

package/dist/shared/workspace-types.d.ts

@@ -0,0 +1,52 @@
+export type RiskLevel = "low" | "medium" | "high";
+export interface WorkspaceTaskTarget {
+    id: string;
+    title: string;
+    done: boolean;
+    planPath?: string;
+    summaryPath?: string;
+}
+export interface WorkspaceSliceTarget {
+    id: string;
+    title: string;
+    done: boolean;
+    planPath?: string;
+    summaryPath?: string;
+    uatPath?: string;
+    tasksDir?: string;
+    branch?: string;
+    risk?: RiskLevel;
+    depends?: string[];
+    demo?: string;
+    tasks: WorkspaceTaskTarget[];
+}
+export interface WorkspaceMilestoneTarget {
+    id: string;
+    title: string;
+    roadmapPath?: string;
+    /** Authoritative milestone lifecycle status from the GSD state registry. */
+    status?: "complete" | "active" | "pending" | "parked";
+    /** Milestone validation verdict, when validation has been performed. */
+    validationVerdict?: "pass" | "needs-attention" | "needs-remediation";
+    slices: WorkspaceSliceTarget[];
+}
+export interface WorkspaceScopeTarget {
+    scope: string;
+    label: string;
+    kind: "project" | "milestone" | "slice" | "task";
+}
+export interface WorkspaceValidationIssue {
+    message?: string;
+    [key: string]: unknown;
+}
+export interface WorkspaceIndex {
+    milestones: WorkspaceMilestoneTarget[];
+    active: {
+        milestoneId?: string;
+        sliceId?: string;
+        taskId?: string;
+        phase: string;
+    };
+    scopes: WorkspaceScopeTarget[];
+    validationIssues: WorkspaceValidationIssue[];
+}

package/dist/shared/workspace-types.js

@@ -0,0 +1 @@
+export {};