gsd-pi 2.33.1 → 2.34.0-dev.6769913

package/dist/resources/extensions/shared/next-action-ui.js

@@ -0,0 +1,168 @@
+/**
+ * Shared next-action prompt for GSD extensions.
+ *
+ * Renders a consistent "step complete" UI at the end of every GSD stage:
+ *
+ *   ─────────────────────────────────────────
+ *   ✓  Phase 1 research complete
+ *
+ *      [caller summary lines]
+ *
+ *      [optional extra content block]
+ *
+ *   Files written:
+ *      .gsd/phases/01-foo/01-RESEARCH.md
+ *
+ *   › 1. Plan phase 1           ← recommended, pre-selected
+ *        Create PLAN.md files for execution
+ *
+ *     2. Not yet
+ *        Run /gsd-plan-phase 1 when ready.
+ *   ─────────────────────────────────────────
+ *
+ * Usage:
+ *
+ *   const choice = await showNextAction(ctx, {
+ *     title: "Phase 1 research complete",
+ *     summary: ["6 libraries evaluated", "Stack: Phaser 3 + TypeScript"],
+ *     files: ["/abs/path/to/01-RESEARCH.md"],
+ *     extra: ["Wave 1: 01-01, 01-02  (parallel)", "Wave 2: 01-03"],
+ *     actions: [
+ *       { id: "plan",  label: "Plan phase 1",   description: "Create PLAN.md files for execution", recommended: true },
+ *       { id: "later", label: "Discuss first",  description: "Capture constraints before planning" },
+ *     ],
+ *     notYetMessage: "Run /gsd-plan-phase 1 when ready.",
+ *   });
+ *
+ *   // choice is one of the action ids, or "not_yet"
+ *   if (choice === "plan") { ... }
+ *
+ * "Not yet" is always appended automatically as the last option.
+ * Pressing Escape also resolves as "not_yet".
+ */
+import { Key, matchesKey } from "@gsd/pi-tui";
+import { makeUI } from "./ui.js";
+/**
+ * Show the next-action prompt and return the chosen action id, or "not_yet".
+ */
+export async function showNextAction(ctx, opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const notYetMessage = opts.notYetMessage ?? "Continue when ready.";
+    const allActions = [
+        ...opts.actions,
+        { id: "not_yet", label: "Not yet", description: notYetMessage },
+    ];
+    const recommendedIdx = allActions.findIndex((a) => a.recommended);
+    const defaultIdx = recommendedIdx >= 0 ? recommendedIdx : 0;
+    const relativeFiles = (opts.files ?? []).map((f) => {
+        try {
+            const rel = f.startsWith(cwd) ? f.slice(cwd.length).replace(/^\//, "") : f;
+            return rel || f;
+        }
+        catch {
+            return f;
+        }
+    });
+    const result = await ctx.ui.custom((_tui, theme, _kb, done) => {
+        let cursorIdx = defaultIdx;
+        let cachedLines;
+        function refresh() { cachedLines = undefined; _tui.requestRender(); }
+        function handleInput(data) {
+            if (matchesKey(data, Key.up)) {
+                cursorIdx = Math.max(0, cursorIdx - 1);
+                refresh();
+                return;
+            }
+            if (matchesKey(data, Key.down)) {
+                cursorIdx = Math.min(allActions.length - 1, cursorIdx + 1);
+                refresh();
+                return;
+            }
+            const num = parseInt(data, 10);
+            if (!isNaN(num) && num >= 1 && num <= allActions.length) {
+                done(allActions[num - 1].id);
+                return;
+            }
+            if (matchesKey(data, Key.enter) || matchesKey(data, Key.space)) {
+                done(allActions[cursorIdx].id);
+                return;
+            }
+            if (matchesKey(data, Key.escape)) {
+                done("not_yet");
+                return;
+            }
+        }
+        function render(width) {
+            if (cachedLines)
+                return cachedLines;
+            const ui = makeUI(theme, width);
+            const lines = [];
+            const push = (...rows) => { for (const r of rows)
+                lines.push(...r); };
+            // ── Header — uses success colour to signal completion ────────────
+            // Note: next-action intentionally uses "success" for its bar/title
+            // to distinguish it from regular accent-coloured screens.
+            push(ui.bar());
+            push(ui.blank());
+            push(ui.header(`  ✓  ${opts.title}`));
+            // ── Summary ──────────────────────────────────────────────────────
+            if (opts.summary && opts.summary.length > 0) {
+                push(ui.blank());
+                for (const line of opts.summary)
+                    push(ui.subtitle(`     ${line}`));
+            }
+            // ── Files written ─────────────────────────────────────────────────
+            if (relativeFiles.length > 0) {
+                push(ui.blank());
+                push(ui.meta("  Files written:"));
+                for (const f of relativeFiles)
+                    push(ui.meta(`     ${f}`));
+            }
+            // ── Extra content ─────────────────────────────────────────────────
+            if (opts.extra && opts.extra.length > 0) {
+                push(ui.blank());
+                for (const line of opts.extra)
+                    push(ui.subtitle(`  ${line}`));
+            }
+            // ── Actions ───────────────────────────────────────────────────────
+            push(ui.blank());
+            for (let i = 0; i < allActions.length; i++) {
+                const action = allActions[i];
+                const isSelected = i === cursorIdx;
+                const isNotYet = action.id === "not_yet";
+                const tag = action.recommended ? "(recommended)" : undefined;
+                if (isSelected) {
+                    push(ui.actionSelected(i + 1, action.label, action.description, tag));
+                }
+                else if (isNotYet) {
+                    push(ui.actionDim(i + 1, action.label, action.description));
+                }
+                else {
+                    push(ui.actionUnselected(i + 1, action.label, action.description, tag));
+                }
+                push(ui.blank());
+            }
+            // ── Footer ────────────────────────────────────────────────────────
+            const numHint = allActions.map((_, i) => `${i + 1}`).join("/");
+            push(ui.hints([`↑/↓ to choose`, `${numHint} to quick-select`, `enter to confirm`]));
+            push(ui.bar());
+            cachedLines = lines;
+            return lines;
+        }
+        return { render, invalidate: () => { cachedLines = undefined; }, handleInput };
+    });
+    // Fallback for RPC mode where ctx.ui.custom() returns undefined (#447).
+    // Fall back to ctx.ui.select() which IS implemented in RPC mode.
+    if (result === undefined || result === null) {
+        const labels = allActions.map(a => {
+            const tag = a.recommended ? " (recommended)" : "";
+            return `${a.label}${tag}: ${a.description}`;
+        });
+        const selected = await ctx.ui.select(opts.title, labels);
+        if (selected === undefined || selected === null)
+            return "not_yet";
+        const idx = labels.indexOf(selected);
+        return idx >= 0 ? allActions[idx].id : "not_yet";
+    }
+    return result;
+}

package/dist/resources/extensions/shared/{path-display.ts → path-display.js}

@@ -9,11 +9,10 @@
  * Filesystem operations (fs.readFile, path.join, spawn cwd) handle native
  * separators correctly and should NOT be normalized.
  */
-
 /**
  * Convert a filesystem path to forward-slash form for display in LLM text.
  * No-op on Unix. On Windows converts `C:\Users\name` to `C:/Users/name`.
  */
-export function toPosixPath(fsPath: string): string {
-  return fsPath.replaceAll("\\", "/");
+export function toPosixPath(fsPath) {
+    return fsPath.replaceAll("\\", "/");
 }

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

@@ -0,0 +1,17 @@
+/**
+ * Sanitize error messages by redacting token-like strings before surfacing.
+ */
+const TOKEN_PATTERNS = [
+    /xoxb-[A-Za-z0-9\-]+/g, // Slack bot tokens
+    /xoxp-[A-Za-z0-9\-]+/g, // Slack user tokens
+    /xoxa-[A-Za-z0-9\-]+/g, // Slack app tokens
+    /\d{8,10}:[A-Za-z0-9_-]{35}/g, // Telegram bot tokens
+    /[A-Za-z0-9_\-.]{20,}/g, // Long opaque secrets (Discord tokens, etc.)
+];
+export function sanitizeError(msg) {
+    let sanitized = msg;
+    for (const pattern of TOKEN_PATTERNS) {
+        sanitized = sanitized.replace(pattern, "[REDACTED]");
+    }
+    return sanitized;
+}

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

@@ -0,0 +1,21 @@
+/**
+ * Terminal capability detection for keyboard shortcut support.
+ *
+ * Ctrl+Alt shortcuts require the Kitty keyboard protocol or modifyOtherKeys.
+ * Terminals that lack this support silently swallow the key combos.
+ */
+const UNSUPPORTED_TERMS = ["apple_terminal", "warpterm"];
+export function supportsCtrlAltShortcuts() {
+    const term = (process.env.TERM_PROGRAM || "").toLowerCase();
+    const jetbrains = (process.env.TERMINAL_EMULATOR || "").toLowerCase().includes("jetbrains");
+    return !UNSUPPORTED_TERMS.some((t) => term.includes(t)) && !jetbrains;
+}
+/**
+ * Returns a shortcut description that includes a slash-command fallback hint
+ * when the current terminal likely can't fire Ctrl+Alt combos.
+ */
+export function shortcutDesc(base, fallbackCmd) {
+    if (supportsCtrlAltShortcuts())
+        return base;
+    return `${base} — shortcut may not work in this terminal, use ${fallbackCmd}`;
+}

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

@@ -0,0 +1,245 @@
+/**
+ * Shared UI design system for GSD/interview TUI components.
+ *
+ * Centralises all colours, glyphs, spacing, and layout helpers so every
+ * screen looks consistent and can be restyled from one place.
+ *
+ * Usage:
+ *
+ *   import { makeUI } from "./shared/ui.js";
+ *
+ *   // Inside ctx.ui.custom((tui, theme, _kb, done) => { ... }):
+ *   const ui = makeUI(theme, width);
+ *
+ *   // Then in render(width):
+ *   const ui = makeUI(theme, width);
+ *   lines.push(...ui.bar());
+ *   lines.push(...ui.header("New Project"));
+ *   lines.push(...ui.blank());
+ *   lines.push(...ui.question("What do you want to build?"));
+ *   lines.push(...ui.optionSelected(1, "Describe it now", "Type what you want."));
+ *   lines.push(...ui.optionUnselected(2, "Provide a file", "Point to an existing doc."));
+ *   lines.push(...ui.blank());
+ *   lines.push(...ui.hints(["↑/↓ to move", "enter to select"]));
+ *   lines.push(...ui.bar());
+ *
+ * Every method returns string[] (one or more lines) so you can spread
+ * directly into your lines array. Width is passed once to makeUI so
+ * individual methods don't need it.
+ */
+import { truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@gsd/pi-tui";
+// ─── Glyphs ───────────────────────────────────────────────────────────────────
+// Change these to restyle every cursor, checkbox, and indicator at once.
+export const GLYPH = {
+    cursor: "›",
+    check: "✓",
+    checkedBox: "[x]",
+    uncheckedBox: "[ ]",
+    dotActive: "●",
+    dotDone: "●",
+    squareFilled: "■",
+    squareEmpty: "□",
+    separator: "─",
+    statusPending: "○",
+    statusActive: "●",
+    statusDone: "✓",
+    statusFailed: "✗",
+    statusPaused: "⏸",
+    statusWarning: "⚠",
+    statusSkipped: "–",
+};
+export const STATUS_COLOR = {
+    pending: "dim",
+    active: "accent",
+    done: "success",
+    failed: "error",
+    paused: "warning",
+    warning: "warning",
+    skipped: "dim",
+};
+export const STATUS_GLYPH = {
+    pending: GLYPH.statusPending,
+    active: GLYPH.statusActive,
+    done: GLYPH.statusDone,
+    failed: GLYPH.statusFailed,
+    paused: GLYPH.statusPaused,
+    warning: GLYPH.statusWarning,
+    skipped: GLYPH.statusSkipped,
+};
+// ─── Spacing ──────────────────────────────────────────────────────────────────
+// All indentation constants in one place.
+export const INDENT = {
+    /** Standard left margin for all content lines */
+    base: "  ",
+    /** Option label indent (same as base, kept separate for clarity) */
+    option: "  ",
+    /** Description line below an option label */
+    description: "     ",
+    /** Note line below a review answer */
+    note: "      ",
+    /** Cursor + space (replaces base when cursor is shown) */
+    cursor: "› ",
+};
+/**
+ * Create a UI helper bound to the current theme and render width.
+ * Call once per render() invocation (width may change between renders).
+ */
+export function makeUI(theme, width) {
+    // ── Internal helpers ───────────────────────────────────────────────────────
+    const add = (s) => truncateToWidth(s, width);
+    const wrap = (s) => wrapTextWithAnsi(s, width);
+    function wrapIndented(s, indent) {
+        const indentWidth = visibleWidth(indent);
+        const wrapped = wrapTextWithAnsi(s, width - indentWidth);
+        for (let i = 1; i < wrapped.length; i++)
+            wrapped[i] = indent + wrapped[i];
+        return wrapped;
+    }
+    const bar = theme.fg("accent", GLYPH.separator.repeat(width));
+    // ── EditorTheme ────────────────────────────────────────────────────────────
+    const editorTheme = {
+        borderColor: (s) => theme.fg("accent", s),
+        selectList: {
+            selectedPrefix: (t) => theme.fg("accent", t),
+            selectedText: (t) => theme.fg("accent", t),
+            description: (t) => theme.fg("muted", t),
+            scrollInfo: (t) => theme.fg("dim", t),
+            noMatch: (t) => theme.fg("warning", t),
+        },
+    };
+    // ── UI implementation ──────────────────────────────────────────────────────
+    return {
+        editorTheme,
+        // ── Layout ──────────────────────────────────────────────────────────────
+        bar: () => [bar],
+        blank: () => [""],
+        // ── Text elements ────────────────────────────────────────────────────────
+        header: (text) => [add(theme.fg("accent", theme.bold(text)))],
+        question: (text) => wrap(theme.fg("text", text)),
+        subtitle: (text) => wrap(theme.fg("text", text)),
+        meta: (text) => [add(theme.fg("dim", text))],
+        hints: (parts) => [add(theme.fg("dim", ` ${parts.join("  |  ")}`))],
+        note: (text) => [add(theme.fg("dim", text))],
+        answer: (text) => [add(theme.fg("success", text))],
+        // ── Single-select options ────────────────────────────────────────────────
+        optionSelected: (num, label, description, isCommitted = false) => {
+            const marker = isCommitted ? theme.fg("success", ` ${GLYPH.check}`) : "";
+            const prefix = `${INDENT.option}${theme.fg("accent", INDENT.cursor)}`;
+            return [
+                ...wrap(`${prefix}${theme.fg("accent", `${num}. ${label}`)}${marker}`),
+                ...wrapIndented(`${INDENT.description}${theme.fg("muted", description)}`, INDENT.description),
+            ];
+        },
+        optionUnselected: (num, label, description, opts = {}) => {
+            const { isCommitted = false, isFocusDimmed = false } = opts;
+            const marker = isCommitted ? theme.fg("success", ` ${GLYPH.check}`) : "";
+            const labelColor = isFocusDimmed ? (isCommitted ? "text" : "dim") : "text";
+            const descColor = isFocusDimmed ? (isCommitted ? "muted" : "dim") : "muted";
+            return [
+                ...wrap(`${INDENT.option}  ${theme.fg(labelColor, `${num}. ${label}`)}${marker}`),
+                ...wrapIndented(`${INDENT.description}${theme.fg(descColor, description)}`, INDENT.description),
+            ];
+        },
+        // ── Multi-select options ─────────────────────────────────────────────────
+        checkboxSelected: (label, description, isChecked) => {
+            const box = isChecked ? theme.fg("success", GLYPH.checkedBox) : theme.fg("dim", GLYPH.uncheckedBox);
+            return [
+                add(`${INDENT.option}${theme.fg("accent", GLYPH.cursor)} ${box} ${theme.fg("accent", label)}`),
+                ...wrapIndented(`${INDENT.description}${theme.fg("muted", description)}`, INDENT.description),
+            ];
+        },
+        checkboxUnselected: (label, description, isChecked, isFocusDimmed = false) => {
+            const box = isChecked ? theme.fg("success", GLYPH.checkedBox) : theme.fg("dim", GLYPH.uncheckedBox);
+            const labelColor = isFocusDimmed ? (isChecked ? "text" : "dim") : "text";
+            const descColor = isFocusDimmed ? (isChecked ? "muted" : "dim") : "muted";
+            return [
+                add(`${INDENT.option}  ${box} ${theme.fg(labelColor, label)}`),
+                ...wrapIndented(`${INDENT.description}${theme.fg(descColor, description)}`, INDENT.description),
+            ];
+        },
+        // ── Special slots ────────────────────────────────────────────────────────
+        slotSelected: (label, description, isCommitted = false) => {
+            const marker = isCommitted ? theme.fg("success", ` ${GLYPH.check}`) : "";
+            return [
+                ...wrap(`${INDENT.option}${theme.fg("accent", `${GLYPH.cursor}${label}`)}${marker}`),
+                ...wrapIndented(`${INDENT.description}${theme.fg("muted", description)}`, INDENT.description),
+            ];
+        },
+        slotUnselected: (label, description, opts = {}) => {
+            const { isCommitted = false, isFocusDimmed = false } = opts;
+            const marker = isCommitted ? theme.fg("success", ` ${GLYPH.check}`) : "";
+            const labelColor = isFocusDimmed ? "dim" : "text";
+            const descColor = isFocusDimmed ? "dim" : "muted";
+            return [
+                ...wrap(`${INDENT.option}  ${theme.fg(labelColor, label)}${marker}`),
+                ...wrapIndented(`${INDENT.description}${theme.fg(descColor, description)}`, INDENT.description),
+            ];
+        },
+        doneSelected: () => [
+            add(`${INDENT.option}${theme.fg("accent", INDENT.cursor)}${theme.bold(theme.fg("accent", "Done"))}`),
+        ],
+        doneUnselected: () => [
+            add(theme.fg("dim", `${INDENT.option}  Done`)),
+        ],
+        // ── Action items ─────────────────────────────────────────────────────────
+        actionSelected: (num, label, description, tag) => {
+            const tagStr = tag ? theme.fg("dim", `  ${tag}`) : "";
+            const lines = [add(`${INDENT.option}${theme.fg("accent", GLYPH.cursor)} ${theme.fg("accent", `${num}. ${label}`)}${tagStr}`)];
+            if (description)
+                lines.push(...wrap(`${INDENT.description}${theme.fg("muted", description)}`));
+            return lines;
+        },
+        actionUnselected: (num, label, description, tag) => {
+            const tagStr = tag ? theme.fg("dim", `  ${tag}`) : "";
+            const lines = [add(`${INDENT.option}     ${theme.fg("text", `${num}. ${label}`)}${tagStr}`)];
+            if (description)
+                lines.push(...wrap(`${INDENT.description}${theme.fg("dim", description)}`));
+            return lines;
+        },
+        actionDim: (num, label, description) => {
+            const lines = [add(`${INDENT.option}     ${theme.fg("dim", `${num}. ${label}`)}`)];
+            if (description)
+                lines.push(...wrap(`${INDENT.description}${theme.fg("dim", description)}`));
+            return lines;
+        },
+        // ── Progress indicators ───────────────────────────────────────────────────
+        pageDots: (total, currentIndex) => {
+            const dots = Array.from({ length: total }, (_, i) => i === currentIndex
+                ? theme.fg("accent", GLYPH.dotActive)
+                : i < currentIndex
+                    ? theme.fg("success", GLYPH.dotDone)
+                    : theme.fg("dim", GLYPH.dotActive)).join(theme.fg("dim", " → "));
+            return [add(`${INDENT.base}${dots}`)];
+        },
+        questionTabs: (headers, currentIndex, answeredIndices) => {
+            const parts = headers.map((header, i) => {
+                const isCurrent = i === currentIndex;
+                const isAnswered = answeredIndices.has(i);
+                const label = ` ${isAnswered ? GLYPH.squareFilled : GLYPH.squareEmpty} ${header} `;
+                return isCurrent
+                    ? theme.bg("selectedBg", theme.fg("text", label))
+                    : theme.fg(isAnswered ? "success" : "muted", label);
+            });
+            return [add(` ← ${parts.join(" ")} →`)];
+        },
+        // ── Status primitives ──────────────────────────────────────────────────────
+        statusGlyph: (status) => theme.fg(STATUS_COLOR[status], STATUS_GLYPH[status]),
+        statusBadge: (text, status) => {
+            const color = STATUS_COLOR[status];
+            return [add(`${INDENT.base}${theme.fg(color, theme.bold(text))}`)];
+        },
+        progressItem: (label, status, opts = {}) => {
+            const glyph = theme.fg(STATUS_COLOR[status], STATUS_GLYPH[status]);
+            const labelColor = status === "done" ? "muted" : status === "pending" || status === "skipped" ? "dim" : "text";
+            const labelText = opts.emphasized ? theme.bold(theme.fg(labelColor, label)) : theme.fg(labelColor, label);
+            const detailText = opts.detail ? `  ${theme.fg("dim", opts.detail)}` : "";
+            return [add(`${INDENT.base}${glyph} ${labelText}${detailText}`)];
+        },
+        progressAnnotation: (text) => [add(`${INDENT.description}${theme.fg("dim", text)}`)],
+        // ── Notes area ────────────────────────────────────────────────────────────
+        notesLabel: (focused) => [
+            add(focused ? theme.fg("accent", " Notes:") : theme.fg("muted", " Notes:")),
+        ],
+        notesText: (text) => wrapIndented(` ${theme.fg("dim", text)}`, " "),
+    };
+}