gsd-pi 2.73.1 → 2.74.0-dev.0306a2e

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

@@ -25,6 +25,61 @@ const WORKFLOW_USAGE = [
     "  pause             — Pause custom workflow auto-mode",
     "  resume            — Resume paused custom workflow auto-mode",
 ].join("\n");
+function splitWorkflowRunArgs(input) {
+    const tokens = [];
+    let current = "";
+    let quote = null;
+    let escapeNext = false;
+    for (const ch of input) {
+        if (escapeNext) {
+            current += ch;
+            escapeNext = false;
+            continue;
+        }
+        if (ch === "\\") {
+            escapeNext = true;
+            continue;
+        }
+        if (quote) {
+            if (ch === quote) {
+                quote = null;
+            }
+            else {
+                current += ch;
+            }
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            continue;
+        }
+        if (/\s/.test(ch)) {
+            if (current) {
+                tokens.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += ch;
+    }
+    if (escapeNext)
+        current += "\\";
+    if (current)
+        tokens.push(current);
+    return tokens;
+}
+export function parseWorkflowRunArgs(args) {
+    const parts = splitWorkflowRunArgs(args);
+    const defName = parts[0] ?? "";
+    const overrides = {};
+    for (let i = 1; i < parts.length; i++) {
+        const eqIdx = parts[i].indexOf("=");
+        if (eqIdx > 0) {
+            overrides[parts[i].slice(0, eqIdx)] = parts[i].slice(eqIdx + 1);
+        }
+    }
+    return { defName, overrides };
+}
 async function handleCustomWorkflow(sub, ctx, pi) {
     // Bare `/gsd workflow` — show usage
     if (!sub) {
@@ -43,15 +98,7 @@ async function handleCustomWorkflow(sub, ctx, pi) {
             ctx.ui.notify("Usage: /gsd workflow run <name> [param=value ...]", "warning");
             return true;
         }
-        const parts = args.split(/\s+/);
-        const defName = parts[0];
-        const overrides = {};
-        for (let i = 1; i < parts.length; i++) {
-            const eqIdx = parts[i].indexOf("=");
-            if (eqIdx > 0) {
-                overrides[parts[i].slice(0, eqIdx)] = parts[i].slice(eqIdx + 1);
-            }
-        }
+        const { defName, overrides } = parseWorkflowRunArgs(args);
         try {
             const base = projectRoot();
             const runDir = createRun(base, defName, Object.keys(overrides).length > 0 ? overrides : undefined);
@@ -146,6 +193,18 @@ async function handleCustomWorkflow(sub, ctx, pi) {
     return true;
 }
 export async function handleWorkflowCommand(trimmed, ctx, pi) {
+    // ── /gsd do — natural language routing (must be early to route to other commands) ──
+    if (trimmed === "do" || trimmed.startsWith("do ")) {
+        const { handleDo } = await import("../../commands-do.js");
+        await handleDo(trimmed.replace(/^do\s*/, "").trim(), ctx, pi);
+        return true;
+    }
+    // ── Backlog management ──
+    if (trimmed === "backlog" || trimmed.startsWith("backlog ")) {
+        const { handleBacklog } = await import("../../commands-backlog.js");
+        await handleBacklog(trimmed.replace(/^backlog\s*/, "").trim(), ctx, pi);
+        return true;
+    }
     // ── Custom workflow commands (`/gsd workflow ...`) ──
     if (trimmed === "workflow" || trimmed.startsWith("workflow ")) {
         const sub = trimmed.slice("workflow".length).trim();

package/dist/resources/extensions/gsd/commands-add-tests.js

@@ -0,0 +1,111 @@
+/**
+ * GSD Command — /gsd add-tests
+ *
+ * Generates tests for a completed slice by dispatching an LLM prompt
+ * with implementation context (summaries, changed files, test patterns).
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { deriveState } from "./state.js";
+import { gsdRoot, resolveSliceFile } from "./paths.js";
+import { loadPrompt } from "./prompt-loader.js";
+function findLastCompletedSlice(basePath, milestoneId) {
+    // Scan disk for slices that have a SUMMARY.md (indicating completion)
+    const slicesDir = join(gsdRoot(basePath), "milestones", milestoneId, "slices");
+    if (!existsSync(slicesDir))
+        return null;
+    try {
+        const entries = readdirSync(slicesDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory() && /^S\d+$/.test(e.name))
+            .sort((a, b) => b.name.localeCompare(a.name)); // reverse order — latest first
+        for (const entry of entries) {
+            const summaryPath = join(slicesDir, entry.name, `${entry.name}-SUMMARY.md`);
+            if (existsSync(summaryPath))
+                return entry.name;
+        }
+    }
+    catch {
+        // non-fatal
+    }
+    return null;
+}
+function readSliceSummary(basePath, milestoneId, sliceId) {
+    const summaryPath = resolveSliceFile(basePath, milestoneId, sliceId, "SUMMARY");
+    if (summaryPath && existsSync(summaryPath)) {
+        const content = readFileSync(summaryPath, "utf-8");
+        const titleMatch = content.match(/^#\s+(.+)/m);
+        return { title: titleMatch?.[1] ?? sliceId, content };
+    }
+    return { title: sliceId, content: "(no summary available)" };
+}
+function detectTestPatterns(basePath) {
+    const patterns = [];
+    // Check for common test configs
+    const checks = [
+        { file: "jest.config.ts", name: "Jest" },
+        { file: "jest.config.js", name: "Jest" },
+        { file: "vitest.config.ts", name: "Vitest" },
+        { file: "vitest.config.js", name: "Vitest" },
+        { file: ".mocharc.yml", name: "Mocha" },
+    ];
+    for (const check of checks) {
+        if (existsSync(join(basePath, check.file))) {
+            patterns.push(`Framework: ${check.name} (${check.file})`);
+        }
+    }
+    // Look for existing test files to infer patterns
+    const testDirs = ["tests", "test", "src/__tests__", "__tests__"];
+    for (const dir of testDirs) {
+        const fullDir = join(basePath, dir);
+        if (existsSync(fullDir)) {
+            try {
+                const files = readdirSync(fullDir).filter((f) => f.endsWith(".test.ts") || f.endsWith(".spec.ts") || f.endsWith(".test.js"));
+                if (files.length > 0) {
+                    patterns.push(`Test directory: ${dir}/ (${files.length} test files)`);
+                    // Read first test file for patterns
+                    const samplePath = join(fullDir, files[0]);
+                    const sample = readFileSync(samplePath, "utf-8").slice(0, 500);
+                    patterns.push(`Sample pattern from ${files[0]}:\n${sample}`);
+                    break;
+                }
+            }
+            catch {
+                // non-fatal
+            }
+        }
+    }
+    return patterns.length > 0 ? patterns.join("\n") : "No test framework detected. Use Node.js built-in test runner.";
+}
+export async function handleAddTests(args, ctx, pi) {
+    const basePath = process.cwd();
+    const state = await deriveState(basePath);
+    if (!state.activeMilestone) {
+        ctx.ui.notify("No active milestone.", "warning");
+        return;
+    }
+    const milestoneId = state.activeMilestone.id;
+    // Determine target
+    const targetId = args.trim() || findLastCompletedSlice(basePath, milestoneId);
+    if (!targetId) {
+        ctx.ui.notify("No completed slices found. Specify a slice ID: /gsd add-tests S03", "warning");
+        return;
+    }
+    // Gather context
+    const summary = readSliceSummary(basePath, milestoneId, targetId);
+    const testPatterns = detectTestPatterns(basePath);
+    ctx.ui.notify(`Generating tests for ${targetId}: "${summary.title}"...`, "info");
+    try {
+        const prompt = loadPrompt("add-tests", {
+            sliceId: targetId,
+            sliceTitle: summary.title,
+            sliceSummary: summary.content,
+            existingTestPatterns: testPatterns,
+            workingDirectory: basePath,
+        });
+        pi.sendMessage({ customType: "gsd-add-tests", content: prompt, display: false }, { triggerTurn: true });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        ctx.ui.notify(`Failed to dispatch test generation: ${msg}`, "error");
+    }
+}

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

@@ -0,0 +1,140 @@
+/**
+ * GSD Command — /gsd backlog
+ *
+ * Structured backlog management with 999.x numbering.
+ * Items stored in .gsd/BACKLOG.md as markdown checklist.
+ * Items can be promoted to active slices via add-slice.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { gsdRoot } from "./paths.js";
+function backlogPath(basePath) {
+    return join(gsdRoot(basePath), "BACKLOG.md");
+}
+function parseBacklog(basePath) {
+    const filePath = backlogPath(basePath);
+    if (!existsSync(filePath))
+        return [];
+    const content = readFileSync(filePath, "utf-8");
+    const items = [];
+    for (const line of content.split("\n")) {
+        const match = line.match(/^- \[([ x])\] (999\.\d+) — (.+?)(?:\s*\((.+)\))?$/);
+        if (match) {
+            items.push({
+                id: match[2],
+                title: match[3].trim(),
+                done: match[1] === "x",
+                note: match[4] ?? "",
+            });
+        }
+    }
+    return items;
+}
+function writeBacklog(basePath, items) {
+    const filePath = backlogPath(basePath);
+    mkdirSync(dirname(filePath), { recursive: true });
+    const lines = ["# Backlog\n"];
+    for (const item of items) {
+        const check = item.done ? "x" : " ";
+        const note = item.note ? ` (${item.note})` : "";
+        lines.push(`- [${check}] ${item.id} — ${item.title}${note}`);
+    }
+    lines.push(""); // trailing newline
+    writeFileSync(filePath, lines.join("\n"), "utf-8");
+}
+function nextBacklogId(items) {
+    let maxNum = 0;
+    for (const item of items) {
+        const match = item.id.match(/^999\.(\d+)$/);
+        if (match) {
+            const num = parseInt(match[1], 10);
+            if (num > maxNum)
+                maxNum = num;
+        }
+    }
+    return `999.${maxNum + 1}`;
+}
+async function listBacklog(basePath, ctx) {
+    const items = parseBacklog(basePath);
+    if (items.length === 0) {
+        ctx.ui.notify("Backlog is empty. Add items with /gsd backlog add <title>", "info");
+        return;
+    }
+    const lines = ["Backlog:\n"];
+    for (const item of items) {
+        const status = item.done ? "✓" : "○";
+        const note = item.note ? ` (${item.note})` : "";
+        lines.push(`  ${status} ${item.id} — ${item.title}${note}`);
+    }
+    const pending = items.filter((i) => !i.done).length;
+    lines.push(`\n${pending} pending, ${items.length - pending} promoted/done`);
+    ctx.ui.notify(lines.join("\n"), "info");
+}
+async function addBacklogItem(basePath, title, ctx) {
+    if (!title) {
+        ctx.ui.notify("Usage: /gsd backlog add <title>", "warning");
+        return;
+    }
+    const items = parseBacklog(basePath);
+    const id = nextBacklogId(items);
+    const date = new Date().toISOString().slice(0, 10);
+    items.push({ id, title: title.replace(/^['"]|['"]$/g, ""), done: false, note: `added ${date}` });
+    writeBacklog(basePath, items);
+    ctx.ui.notify(`Added ${id}: "${title}"`, "success");
+}
+async function promoteBacklogItem(basePath, itemId, ctx, pi) {
+    if (!itemId) {
+        ctx.ui.notify("Usage: /gsd backlog promote <id>\nExample: /gsd backlog promote 999.1", "warning");
+        return;
+    }
+    const items = parseBacklog(basePath);
+    const item = items.find((i) => i.id === itemId);
+    if (!item) {
+        ctx.ui.notify(`Backlog item ${itemId} not found.`, "warning");
+        return;
+    }
+    if (item.done) {
+        ctx.ui.notify(`${itemId} is already promoted/done.`, "info");
+        return;
+    }
+    // Promote — currently requires single-writer engine (not yet available)
+    // Mark as promoted in backlog for now; slice creation will be available with the engine.
+    item.done = true;
+    item.note = `promoted ${new Date().toISOString().slice(0, 10)}`;
+    writeBacklog(basePath, items);
+    ctx.ui.notify(`Promoted ${itemId}: "${item.title}" — add it to the roadmap manually or wait for engine slice commands.`, "info");
+}
+async function removeBacklogItem(basePath, itemId, ctx) {
+    if (!itemId) {
+        ctx.ui.notify("Usage: /gsd backlog remove <id>", "warning");
+        return;
+    }
+    const items = parseBacklog(basePath);
+    const idx = items.findIndex((i) => i.id === itemId);
+    if (idx === -1) {
+        ctx.ui.notify(`Backlog item ${itemId} not found.`, "warning");
+        return;
+    }
+    const removed = items.splice(idx, 1)[0];
+    writeBacklog(basePath, items);
+    ctx.ui.notify(`Removed ${removed.id}: "${removed.title}"`, "success");
+}
+export async function handleBacklog(args, ctx, pi) {
+    const basePath = process.cwd();
+    const parts = args.trim().split(/\s+/);
+    const sub = parts[0] ?? "";
+    const rest = parts.slice(1).join(" ");
+    switch (sub) {
+        case "":
+            return listBacklog(basePath, ctx);
+        case "add":
+            return addBacklogItem(basePath, rest, ctx);
+        case "promote":
+            return promoteBacklogItem(basePath, rest.trim(), ctx, pi);
+        case "remove":
+            return removeBacklogItem(basePath, rest.trim(), ctx);
+        default:
+            // Treat as implicit add
+            return addBacklogItem(basePath, args, ctx);
+    }
+}

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

@@ -0,0 +1,79 @@
+/**
+ * GSD Command — /gsd do
+ *
+ * Routes freeform natural language to the correct /gsd subcommand
+ * using keyword matching. Falls back to /gsd quick for task-like input.
+ */
+const ROUTES = [
+    { keywords: ["progress", "status", "dashboard", "how far", "where are we"], command: "status" },
+    { keywords: ["auto", "autonomous", "run all", "keep going", "start auto"], command: "auto" },
+    { keywords: ["stop", "halt", "abort"], command: "stop" },
+    { keywords: ["pause", "break", "take a break"], command: "pause" },
+    { keywords: ["history", "past", "what happened", "previous"], command: "history" },
+    { keywords: ["doctor", "health", "diagnose", "check health"], command: "doctor" },
+    { keywords: ["clean up", "cleanup", "remove old", "prune", "tidy"], command: "cleanup" },
+    { keywords: ["export", "report", "share results"], command: "export" },
+    { keywords: ["ship", "pull request", "create pr", "open pr", "merge"], command: "ship" },
+    { keywords: ["discuss", "talk about", "architecture", "design"], command: "discuss" },
+    { keywords: ["undo", "revert", "rollback", "take back"], command: "undo" },
+    { keywords: ["skip", "skip task", "skip this"], command: "skip" },
+    { keywords: ["queue", "reorder", "milestone order", "order milestones"], command: "queue" },
+    { keywords: ["visualize", "viz", "graph", "chart", "show graph"], command: "visualize" },
+    { keywords: ["capture", "note", "idea", "thought", "remember"], command: "capture" },
+    { keywords: ["inspect", "database", "sqlite", "db state"], command: "inspect" },
+    { keywords: ["knowledge", "rule", "pattern", "lesson"], command: "knowledge" },
+    { keywords: ["session report", "session summary", "cost summary", "how much"], command: "session-report" },
+    { keywords: ["backlog", "parking lot", "later", "someday"], command: "backlog" },
+    { keywords: ["pr branch", "clean branch", "filter commits"], command: "pr-branch" },
+    { keywords: ["add tests", "write tests", "generate tests", "test coverage"], command: "add-tests" },
+    { keywords: ["next", "step", "next step", "what's next"], command: "next" },
+    { keywords: ["migrate", "migration", "convert", "upgrade"], command: "migrate" },
+    { keywords: ["steer", "change direction", "pivot", "redirect"], command: "steer" },
+    { keywords: ["park", "shelve", "set aside"], command: "park" },
+    { keywords: ["widget", "toggle widget"], command: "widget" },
+    { keywords: ["logs", "debug logs", "log files"], command: "logs" },
+];
+function matchRoute(input) {
+    const lower = input.toLowerCase();
+    let bestMatch = null;
+    for (const route of ROUTES) {
+        for (const keyword of route.keywords) {
+            if (lower.includes(keyword)) {
+                const score = keyword.length; // Longer match = higher confidence
+                if (!bestMatch || score > bestMatch.score) {
+                    // Strip the matched keyword from input to get remaining args
+                    const idx = lower.indexOf(keyword);
+                    const remaining = (input.slice(0, idx) + input.slice(idx + keyword.length)).trim();
+                    bestMatch = { command: route.command, remainingArgs: remaining, score };
+                }
+            }
+        }
+    }
+    return bestMatch;
+}
+export async function handleDo(args, ctx, pi) {
+    if (!args.trim()) {
+        ctx.ui.notify("Usage: /gsd do <what you want to do>\n\n" +
+            "Examples:\n" +
+            "  /gsd do show me progress\n" +
+            "  /gsd do run autonomously\n" +
+            "  /gsd do clean up old branches\n" +
+            "  /gsd do fix the login bug", "warning");
+        return;
+    }
+    const match = matchRoute(args);
+    if (match) {
+        const fullCommand = match.remainingArgs
+            ? `${match.command} ${match.remainingArgs}`
+            : match.command;
+        ctx.ui.notify(`→ /gsd ${fullCommand}`, "info");
+        // Re-dispatch through the main dispatcher
+        const { handleGSDCommand } = await import("./commands/dispatcher.js");
+        await handleGSDCommand(fullCommand, ctx, pi);
+        return;
+    }
+    // No keyword match → treat as quick task
+    ctx.ui.notify(`→ /gsd quick ${args}`, "info");
+    const { handleQuick } = await import("./quick.js");
+    await handleQuick(args, ctx, pi);
+}

package/dist/resources/extensions/gsd/commands-extract-learnings.js

@@ -0,0 +1,225 @@
+/**
+ * GSD Command — /gsd extract-learnings
+ *
+ * Analyses completed milestone artefacts and dispatches an LLM turn that
+ * extracts structured knowledge into 4 categories:
+ *   Decisions · Lessons · Patterns · Surprises
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join, basename } from "node:path";
+import { gsdRoot, resolveMilestonePath } from "./paths.js";
+import { projectRoot } from "./commands/context.js";
+// ─── Pure functions ───────────────────────────────────────────────────────────
+export function parseExtractLearningsArgs(args) {
+    const trimmed = args.trim();
+    return { milestoneId: trimmed || null };
+}
+export function buildLearningsOutputPath(milestoneDir, milestoneId) {
+    return join(milestoneDir, `${milestoneId}-LEARNINGS.md`);
+}
+export function resolvePhaseArtifacts(milestoneDir, milestoneId) {
+    const missingRequired = [];
+    const planFile = `${milestoneId}-PLAN.md`;
+    const summaryFile = `${milestoneId}-SUMMARY.md`;
+    const verificationFile = `${milestoneId}-VERIFICATION.md`;
+    const uatFile = `${milestoneId}-UAT.md`;
+    const planPath = join(milestoneDir, planFile);
+    const summaryPath = join(milestoneDir, summaryFile);
+    const verificationPath = join(milestoneDir, verificationFile);
+    const uatPath = join(milestoneDir, uatFile);
+    const plan = existsSync(planPath) ? planPath : null;
+    const summary = existsSync(summaryPath) ? summaryPath : null;
+    const verification = existsSync(verificationPath) ? verificationPath : null;
+    const uat = existsSync(uatPath) ? uatPath : null;
+    if (!plan)
+        missingRequired.push(planFile);
+    if (!summary)
+        missingRequired.push(summaryFile);
+    return { plan, summary, verification, uat, missingRequired };
+}
+export function buildExtractLearningsPrompt(ctx) {
+    const optionalSections = [];
+    if (ctx.verificationContent) {
+        optionalSections.push(`## Verification Report\n\n${ctx.verificationContent}`);
+    }
+    if (ctx.uatContent) {
+        optionalSections.push(`## UAT Report\n\n${ctx.uatContent}`);
+    }
+    const missingNote = ctx.missingArtifacts.length > 0
+        ? `\nNote: The following optional artefacts were not available: ${ctx.missingArtifacts.join(", ")}\n`
+        : "";
+    return `# Extract Learnings — ${ctx.milestoneId}: ${ctx.milestoneName}
+
+**Project:** ${ctx.projectName}
+**Output file:** ${ctx.outputPath}
+
+## Your Task
+
+Analyse the artefacts below and extract structured knowledge from milestone **${ctx.milestoneId}**.
+
+Write a LEARNINGS document to \`${ctx.outputPath}\` with the following 4 sections:
+
+### Decisions
+Key architectural and design decisions made during this milestone, including the rationale and alternatives considered.
+
+### Lessons
+What the team learned — technical discoveries, process insights, and knowledge gaps that were filled.
+
+### Patterns
+Reusable patterns, approaches, or solutions that emerged and should be applied in future work.
+
+### Surprises
+Unexpected challenges, discoveries, or outcomes — things that deviated from assumptions.
+
+### Source Attribution (REQUIRED)
+
+Every extracted item MUST include a \`Source:\` line immediately after the item text.
+Format: \`Source: {artifact-filename}/{section}\`
+Example: \`Source: M001-PLAN.md/Architecture Decisions\`
+
+Items without a Source attribution are invalid and must not be included in the output.
+
+---
+
+## Artefacts
+
+### Plan
+
+${ctx.planContent}
+
+---
+
+### Summary
+
+${ctx.summaryContent}
+
+${optionalSections.join("\n\n---\n\n")}
+${missingNote}
+---
+
+## Output Format
+
+Write the LEARNINGS file to \`${ctx.relativeOutputPath}\` with YAML frontmatter followed by the 4 sections above.
+Each section should contain concise, actionable bullet points.
+Every bullet point MUST be followed by a source line, for example:
+
+\`\`\`
+### Decisions
+- Chose PostgreSQL over SQLite for concurrent write support.
+  Source: M001-PLAN.md/Architecture Decisions
+\`\`\`
+
+Items without a \`Source:\` line are invalid.
+
+---
+
+## Optional: Capture Individual Learnings
+
+If the \`capture_thought\` tool is available, call it once for each extracted item with:
+- category: "decision" | "lesson" | "pattern" | "surprise"
+- phase: "${ctx.milestoneId}"
+- content: {the learning text}
+- source: {artifact filename}
+
+If \`capture_thought\` is not available, skip this step silently — do not report an error.
+
+---
+
+## Rebuild Knowledge Graph
+
+After writing LEARNINGS.md, call the \`gsd_graph\` tool with \`{ "mode": "build" }\` to rebuild the knowledge graph so the new learnings are immediately queryable by future milestone prompts.
+
+If the \`gsd_graph\` tool is not available, skip this step silently.
+`;
+}
+export function buildFrontmatter(ctx) {
+    const missingList = ctx.missingArtifacts.length > 0
+        ? ctx.missingArtifacts.map((a) => `  - ${a}`).join("\n")
+        : "  []";
+    const missingValue = ctx.missingArtifacts.length > 0
+        ? `\n${missingList}`
+        : " []";
+    return `---
+phase: ${ctx.milestoneId}
+phase_name: ${ctx.milestoneName}
+project: ${ctx.projectName}
+generated: ${ctx.generatedAt}
+counts:
+  decisions: ${ctx.counts.decisions}
+  lessons: ${ctx.counts.lessons}
+  patterns: ${ctx.counts.patterns}
+  surprises: ${ctx.counts.surprises}
+missing_artifacts:${missingValue}
+---`;
+}
+export function extractProjectName(basePath) {
+    const projectMdPath = join(gsdRoot(basePath), "PROJECT.md");
+    if (existsSync(projectMdPath)) {
+        try {
+            const content = readFileSync(projectMdPath, "utf-8");
+            const match = content.match(/^name:\s*(.+)$/m);
+            if (match)
+                return match[1].trim();
+        }
+        catch {
+            // non-fatal
+        }
+    }
+    return basename(basePath);
+}
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handleExtractLearnings(args, ctx, pi) {
+    const { milestoneId } = parseExtractLearningsArgs(args);
+    if (!milestoneId) {
+        ctx.ui.notify("Usage: /gsd extract-learnings <milestoneId>  (e.g. M001)", "warning");
+        return;
+    }
+    // projectRoot() throws GSDNoProjectError if no project found — intentional, handled by dispatcher
+    const basePath = projectRoot();
+    const milestoneDir = resolveMilestonePath(basePath, milestoneId);
+    if (!milestoneDir) {
+        ctx.ui.notify(`Milestone not found: ${milestoneId}`, "error");
+        return;
+    }
+    const artifacts = resolvePhaseArtifacts(milestoneDir, milestoneId);
+    if (artifacts.missingRequired.length > 0) {
+        ctx.ui.notify(`Cannot extract learnings — required artefacts missing: ${artifacts.missingRequired.join(", ")}`, "error");
+        return;
+    }
+    // Read required artefacts
+    const planContent = readFileSync(artifacts.plan, "utf-8");
+    const summaryContent = readFileSync(artifacts.summary, "utf-8");
+    // Read optional artefacts
+    const verificationContent = artifacts.verification
+        ? readFileSync(artifacts.verification, "utf-8")
+        : null;
+    const uatContent = artifacts.uat
+        ? readFileSync(artifacts.uat, "utf-8")
+        : null;
+    // Determine missing optional artefacts for context
+    const missingArtifacts = [];
+    if (!artifacts.verification)
+        missingArtifacts.push(`${milestoneId}-VERIFICATION.md`);
+    if (!artifacts.uat)
+        missingArtifacts.push(`${milestoneId}-UAT.md`);
+    // Extract milestone name from Plan H1 or fall back to milestoneId
+    const h1Match = planContent.match(/^#\s+(.+)$/m);
+    const milestoneName = h1Match?.[1]?.trim() ?? milestoneId;
+    const projectName = extractProjectName(basePath);
+    const outputPath = buildLearningsOutputPath(milestoneDir, milestoneId);
+    const relativeOutputPath = outputPath.replace(basePath + "/", "");
+    const prompt = buildExtractLearningsPrompt({
+        milestoneId,
+        milestoneName,
+        outputPath,
+        relativeOutputPath,
+        planContent,
+        summaryContent,
+        verificationContent,
+        uatContent,
+        missingArtifacts,
+        projectName,
+    });
+    ctx.ui.notify(`Extracting learnings for ${milestoneId}: "${milestoneName}"...`, "info");
+    pi.sendMessage({ customType: "gsd-extract-learnings", content: prompt, display: false }, { triggerTurn: true });
+}

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

@@ -17,6 +17,11 @@ import { projectRoot } from "./commands/context.js";
 import { loadPrompt } from "./prompt-loader.js";
 const UPDATE_REGISTRY_URL = "https://registry.npmjs.org/gsd-pi/latest";
 const UPDATE_FETCH_TIMEOUT_MS = 5000;
+function resolveInstallCommand(pkg) {
+    if ('bun' in process.versions)
+        return `bun add -g ${pkg}`;
+    return `npm install -g ${pkg}`;
+}
 async function fetchLatestVersionForCommand() {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), UPDATE_FETCH_TIMEOUT_MS);
@@ -344,13 +349,14 @@ export async function handleUpdate(ctx) {
         return;
     }
     ctx.ui.notify(`Updating: v${current} → v${latest}...`, "info");
+    const installCmd = resolveInstallCommand(`${NPM_PACKAGE}@latest`);
     try {
-        execSync(`npm install -g ${NPM_PACKAGE}@latest`, {
+        execSync(installCmd, {
             stdio: ["ignore", "pipe", "ignore"],
         });
         ctx.ui.notify(`Updated to v${latest}. Restart your GSD session to use the new version.`, "info");
     }
     catch {
-        ctx.ui.notify(`Update failed. Try manually: npm install -g ${NPM_PACKAGE}@latest`, "error");
+        ctx.ui.notify(`Update failed. Try manually: ${installCmd}`, "error");
     }
 }