gsd-pi 2.33.1-dev.235d83a → 2.33.1-dev.29a8268

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

@@ -1,168 +0,0 @@
-/**
- * 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/sanitize.js

@@ -1,17 +0,0 @@
-/**
- * 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

@@ -1,21 +0,0 @@
-/**
- * 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

@@ -1,245 +0,0 @@
-/**
- * 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)}`, " "),
-    };
-}