gsd-pi 2.37.1 → 2.38.0-dev.e40f839

package/dist/resources/extensions/gsd/auto-worktree-sync.js

@@ -13,6 +13,7 @@ import { existsSync, readFileSync, unlinkSync, readdirSync, } from "node:fs";
 import { join, sep as pathSep } from "node:path";
 import { homedir } from "node:os";
 import { safeCopy, safeCopyRecursive } from "./safe-fs.js";
+const gsdHome = process.env.GSD_HOME || join(homedir(), ".gsd");
 // ─── Project Root → Worktree Sync ─────────────────────────────────────────
 /**
  * Sync milestone artifacts from project root INTO worktree before deriveState.
@@ -75,7 +76,7 @@ export function syncStateToProjectRoot(worktreePath, projectRoot, milestoneId) {
  * doesn't falsely trigger staleness (#804).
  */
 export function readResourceVersion() {
-    const agentDir = process.env.GSD_CODING_AGENT_DIR || join(homedir(), ".gsd", "agent");
+    const agentDir = process.env.GSD_CODING_AGENT_DIR || join(gsdHome, "agent");
     const manifestPath = join(agentDir, "managed-resources.json");
     try {
         const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
@@ -115,10 +116,17 @@ export function checkResourcesStale(versionOnStart) {
  * Returns the corrected base path.
  */
 export function escapeStaleWorktree(base) {
-    const marker = `${pathSep}.gsd${pathSep}worktrees${pathSep}`;
-    const idx = base.indexOf(marker);
-    if (idx === -1)
-        return base;
+    // Direct layout: /.gsd/worktrees/
+    const directMarker = `${pathSep}.gsd${pathSep}worktrees${pathSep}`;
+    let idx = base.indexOf(directMarker);
+    if (idx === -1) {
+        // Symlink-resolved layout: /.gsd/projects/<hash>/worktrees/
+        const symlinkRe = new RegExp(`\\${pathSep}\\.gsd\\${pathSep}projects\\${pathSep}[a-f0-9]+\\${pathSep}worktrees\\${pathSep}`);
+        const match = base.match(symlinkRe);
+        if (!match || match.index === undefined)
+            return base;
+        idx = match.index;
+    }
     // base is inside .gsd/worktrees/<something> — extract the project root
     const projectRoot = base.slice(0, idx);
     try {

package/dist/resources/extensions/gsd/captures.js

@@ -30,8 +30,16 @@ const VALID_CLASSIFICATIONS = [
  */
 export function resolveCapturesPath(basePath) {
     const resolved = resolve(basePath);
+    // Direct layout: /.gsd/worktrees/
     const worktreeMarker = `${sep}.gsd${sep}worktrees${sep}`;
-    const idx = resolved.indexOf(worktreeMarker);
+    let idx = resolved.indexOf(worktreeMarker);
+    if (idx === -1) {
+        // Symlink-resolved layout: /.gsd/projects/<hash>/worktrees/
+        const symlinkRe = new RegExp(`\\${sep}\\.gsd\\${sep}projects\\${sep}[a-f0-9]+\\${sep}worktrees\\${sep}`);
+        const match = resolved.match(symlinkRe);
+        if (match && match.index !== undefined)
+            idx = match.index;
+    }
     if (idx !== -1) {
         // basePath is inside a worktree — resolve to project root
         const projectRoot = resolved.slice(0, idx);

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

@@ -8,12 +8,13 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { homedir } from "node:os";
+const gsdHome = process.env.GSD_HOME || join(homedir(), ".gsd");
 // ─── Registry I/O ───────────────────────────────────────────────────────────
 function getRegistryPath() {
-    return join(homedir(), ".gsd", "extensions", "registry.json");
+    return join(gsdHome, "extensions", "registry.json");
 }
 function getAgentExtensionsDir() {
-    return join(homedir(), ".gsd", "agent", "extensions");
+    return join(gsdHome, "agent", "extensions");
 }
 function loadRegistry() {
     const filePath = getRegistryPath();

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

@@ -10,7 +10,7 @@ import { deriveState } from "./state.js";
 import { gsdRoot } from "./paths.js";
 import { appendCapture, hasPendingCaptures, loadPendingCaptures } from "./captures.js";
 import { appendOverride, appendKnowledge } from "./files.js";
-import { formatDoctorIssuesForPrompt, formatDoctorReport, runGSDDoctor, selectDoctorScope, filterDoctorIssues, } from "./doctor.js";
+import { formatDoctorIssuesForPrompt, formatDoctorReport, formatDoctorReportJson, runGSDDoctor, selectDoctorScope, filterDoctorIssues, } from "./doctor.js";
 import { isAutoActive } from "./auto.js";
 import { projectRoot } from "./commands.js";
 import { loadPrompt } from "./prompt-loader.js";
@@ -28,15 +28,28 @@ export function dispatchDoctorHeal(pi, scope, reportText, structuredIssues) {
 }
 export async function handleDoctor(args, ctx, pi) {
     const trimmed = args.trim();
-    const parts = trimmed ? trimmed.split(/\s+/) : [];
+    // Extract flags before positional parsing
+    const jsonMode = trimmed.includes("--json");
+    const dryRun = trimmed.includes("--dry-run");
+    const includeBuild = trimmed.includes("--build");
+    const includeTests = trimmed.includes("--test");
+    const stripped = trimmed.replace(/--json|--dry-run|--build|--test/g, "").trim();
+    const parts = stripped ? stripped.split(/\s+/) : [];
     const mode = parts[0] === "fix" || parts[0] === "heal" || parts[0] === "audit" ? parts[0] : "doctor";
     const requestedScope = mode === "doctor" ? parts[0] : parts[1];
     const scope = await selectDoctorScope(projectRoot(), requestedScope);
     const effectiveScope = mode === "audit" ? requestedScope : scope;
     const report = await runGSDDoctor(projectRoot(), {
-        fix: mode === "fix" || mode === "heal",
+        fix: mode === "fix" || mode === "heal" || dryRun,
+        dryRun,
         scope: effectiveScope,
+        includeBuild,
+        includeTests,
     });
+    if (jsonMode) {
+        ctx.ui.notify(formatDoctorReportJson(report), "info");
+        return;
+    }
     const reportText = formatDoctorReport(report, {
         scope: effectiveScope,
         includeWarnings: mode === "audit",

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

@@ -7,6 +7,7 @@ import { existsSync, readFileSync, readdirSync, unlinkSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { gsdRoot } from "./paths.js";
+const gsdHome = process.env.GSD_HOME || join(homedir(), ".gsd");
 import { enableDebug } from "./debug-logger.js";
 import { deriveState } from "./state.js";
 import { GSDDashboardOverlay } from "./dashboard-overlay.js";
@@ -135,7 +136,7 @@ async function guardRemoteSession(ctx, pi) {
 }
 export function registerGSDCommand(pi) {
     pi.registerCommand("gsd", {
-        description: "GSD — Get Shit Done: /gsd help|start|templates|next|auto|stop|pause|status|visualize|queue|quick|capture|triage|dispatch|history|undo|skip|export|cleanup|mode|prefs|config|keys|hooks|run-hook|skill-health|doctor|forensics|changelog|migrate|remote|steer|knowledge|new-milestone|parallel|cmux|update",
+        description: "GSD — Get Shit Done: /gsd help|start|templates|next|auto|stop|pause|status|widget|visualize|queue|quick|capture|triage|dispatch|history|undo|rate|skip|export|cleanup|mode|prefs|config|keys|hooks|run-hook|skill-health|doctor|logs|forensics|changelog|migrate|remote|steer|knowledge|new-milestone|parallel|cmux|park|unpark|init|setup|inspect|extensions|update",
         getArgumentCompletions: (prefix) => {
             const subcommands = [
                 { cmd: "help", desc: "Categorized command reference with descriptions" },
@@ -186,7 +187,11 @@ export function registerGSDCommand(pi) {
                 { cmd: "templates", desc: "List available workflow templates" },
                 { cmd: "extensions", desc: "Manage extensions (list, enable, disable, info)" },
             ];
+            const hasTrailingSpace = prefix.endsWith(" ");
             const parts = prefix.trim().split(/\s+/);
+            if (hasTrailingSpace && parts.length >= 1) {
+                parts.push("");
+            }
             if (parts.length <= 1) {
                 return subcommands
                     .filter((item) => item.cmd.startsWith(parts[0] ?? ""))
@@ -433,7 +438,7 @@ export function registerGSDCommand(pi) {
                 if (parts.length === 3 && ["enable", "disable", "info"].includes(parts[1])) {
                     const idPrefix = parts[2] ?? "";
                     try {
-                        const extDir = join(homedir(), ".gsd", "agent", "extensions");
+                        const extDir = join(gsdHome, "agent", "extensions");
                         const ids = [];
                         for (const entry of readdirSync(extDir, { withFileTypes: true })) {
                             if (!entry.isDirectory())
@@ -468,6 +473,10 @@ export function registerGSDCommand(pi) {
                     { cmd: "fix", desc: "Auto-fix detected issues" },
                     { cmd: "heal", desc: "AI-driven deep healing" },
                     { cmd: "audit", desc: "Run health audit without fixing" },
+                    { cmd: "--dry-run", desc: "Show what --fix would change without applying" },
+                    { cmd: "--json", desc: "Output report as JSON (CI/tooling friendly)" },
+                    { cmd: "--build", desc: "Include slow build health check (npm run build)" },
+                    { cmd: "--test", desc: "Include slow test health check (npm test)" },
                 ];
                 if (parts.length <= 2) {
                     return modes
@@ -491,6 +500,17 @@ export function registerGSDCommand(pi) {
                     .filter((p) => p.cmd.startsWith(phasePrefix))
                     .map((p) => ({ value: `dispatch ${p.cmd}`, label: p.cmd, description: p.desc }));
             }
+            if (parts[0] === "rate" && parts.length <= 2) {
+                const tierPrefix = parts[1] ?? "";
+                const tiers = [
+                    { cmd: "over", desc: "Model was overqualified for this task" },
+                    { cmd: "ok", desc: "Model was appropriate for this task" },
+                    { cmd: "under", desc: "Model was underqualified for this task" },
+                ];
+                return tiers
+                    .filter((t) => t.cmd.startsWith(tierPrefix))
+                    .map((t) => ({ value: `rate ${t.cmd}`, label: t.cmd, description: t.desc }));
+            }
             return [];
         },
         async handler(args, ctx) {

package/dist/resources/extensions/gsd/detection.js

@@ -9,6 +9,7 @@ import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
 import { gsdRoot } from "./paths.js";
+const gsdHome = process.env.GSD_HOME || join(homedir(), ".gsd");
 // ─── Project File Markers ───────────────────────────────────────────────────────
 const PROJECT_FILES = [
     "package.json",
@@ -309,7 +310,6 @@ function detectVerificationCommands(basePath, detectedFiles, packageManager) {
  * Check if global GSD setup exists (has ~/.gsd/ with preferences).
  */
 export function hasGlobalSetup() {
-    const gsdHome = join(homedir(), ".gsd");
     return (existsSync(join(gsdHome, "preferences.md")) ||
         existsSync(join(gsdHome, "PREFERENCES.md")));
 }
@@ -318,7 +318,6 @@ export function hasGlobalSetup() {
  * Returns true if ~/.gsd/ doesn't exist or has no preferences or auth.
  */
 export function isFirstEverLaunch() {
-    const gsdHome = join(homedir(), ".gsd");
     if (!existsSync(gsdHome))
         return true;
     // If we have preferences, not first launch

package/dist/resources/extensions/gsd/doctor-checks.js

@@ -618,6 +618,88 @@ export async function checkRuntimeHealth(basePath, issues, fixesApplied, shouldF
     catch {
         // Non-fatal — external state check failed
     }
+    // ── Metrics ledger integrity ───────────────────────────────────────────
+    try {
+        const metricsPath = join(root, "metrics.json");
+        if (existsSync(metricsPath)) {
+            try {
+                const raw = readFileSync(metricsPath, "utf-8");
+                const ledger = JSON.parse(raw);
+                if (ledger.version !== 1 || !Array.isArray(ledger.units)) {
+                    issues.push({
+                        severity: "warning",
+                        code: "metrics_ledger_corrupt",
+                        scope: "project",
+                        unitId: "project",
+                        message: "metrics.json has an unexpected structure (version !== 1 or units is not an array) — metrics data may be unreliable",
+                        file: ".gsd/metrics.json",
+                        fixable: false,
+                    });
+                }
+            }
+            catch {
+                issues.push({
+                    severity: "warning",
+                    code: "metrics_ledger_corrupt",
+                    scope: "project",
+                    unitId: "project",
+                    message: "metrics.json is not valid JSON — metrics data may be corrupt",
+                    file: ".gsd/metrics.json",
+                    fixable: false,
+                });
+            }
+        }
+    }
+    catch {
+        // Non-fatal — metrics check failed
+    }
+    // ── Large planning file detection ──────────────────────────────────────
+    // Files over 100KB can cause LLM context pressure. Report the worst offenders.
+    try {
+        const MAX_FILE_BYTES = 100 * 1024; // 100KB
+        const milestonesPath = milestonesDir(basePath);
+        if (existsSync(milestonesPath)) {
+            const largeFiles = [];
+            function scanForLargeFiles(dir, depth = 0) {
+                if (depth > 6)
+                    return;
+                try {
+                    for (const entry of readdirSync(dir)) {
+                        const full = join(dir, entry);
+                        try {
+                            const s = statSync(full);
+                            if (s.isDirectory()) {
+                                scanForLargeFiles(full, depth + 1);
+                                continue;
+                            }
+                            if (entry.endsWith(".md") && s.size > MAX_FILE_BYTES) {
+                                largeFiles.push({ path: full.replace(basePath + "/", ""), sizeKB: Math.round(s.size / 1024) });
+                            }
+                        }
+                        catch { /* skip entry */ }
+                    }
+                }
+                catch { /* skip dir */ }
+            }
+            scanForLargeFiles(milestonesPath);
+            if (largeFiles.length > 0) {
+                largeFiles.sort((a, b) => b.sizeKB - a.sizeKB);
+                const worst = largeFiles[0];
+                issues.push({
+                    severity: "warning",
+                    code: "large_planning_file",
+                    scope: "project",
+                    unitId: "project",
+                    message: `${largeFiles.length} planning file(s) exceed 100KB — largest: ${worst.path} (${worst.sizeKB}KB). Large files cause LLM context pressure.`,
+                    file: worst.path,
+                    fixable: false,
+                });
+            }
+        }
+    }
+    catch {
+        // Non-fatal — large file scan failed
+    }
 }
 /**
  * Build STATE.md markdown content from derived state.

package/dist/resources/extensions/gsd/doctor-environment.js

@@ -355,6 +355,63 @@ function checkGitRemote(basePath) {
     }
     return { name: "git_remote", status: "ok", message: "Git remote reachable" };
 }
+/**
+ * Check if the project build passes (opt-in slow check, use --build flag).
+ * Runs npm run build and reports failure as env_build.
+ */
+function checkBuildHealth(basePath) {
+    const pkgPath = join(basePath, "package.json");
+    if (!existsSync(pkgPath))
+        return null;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        const buildScript = pkg.scripts?.build;
+        if (!buildScript)
+            return null;
+        const result = tryExec("npm run build 2>&1", basePath);
+        if (result === null) {
+            return {
+                name: "build",
+                status: "error",
+                message: "Build failed — npm run build exited non-zero",
+                detail: "Fix build errors before dispatching work",
+            };
+        }
+        return { name: "build", status: "ok", message: "Build passes" };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if tests pass (opt-in slow check, use --test flag).
+ * Runs npm test and reports failures as env_test.
+ */
+function checkTestHealth(basePath) {
+    const pkgPath = join(basePath, "package.json");
+    if (!existsSync(pkgPath))
+        return null;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        const testScript = pkg.scripts?.test;
+        // Skip if no test script or the default placeholder
+        if (!testScript || testScript.includes("no test specified"))
+            return null;
+        const result = tryExec("npm test 2>&1", basePath);
+        if (result === null) {
+            return {
+                name: "test",
+                status: "warning",
+                message: "Tests failing — npm test exited non-zero",
+                detail: "Fix failing tests before shipping",
+            };
+        }
+        return { name: "test", status: "ok", message: "Tests pass" };
+    }
+    catch {
+        return null;
+    }
+}
 // ── Public API ─────────────────────────────────────────────────────────────
 /**
  * Run all environment health checks. Returns structured results for
@@ -394,6 +451,24 @@ export function runFullEnvironmentChecks(basePath) {
         results.push(remoteCheck);
     return results;
 }
+/**
+ * Run slow opt-in checks (build and/or test).
+ * These are never run on the pre-dispatch gate — only on explicit /gsd doctor --build/--test.
+ */
+export function runSlowEnvironmentChecks(basePath, options) {
+    const results = [];
+    if (options?.includeBuild) {
+        const buildCheck = checkBuildHealth(basePath);
+        if (buildCheck)
+            results.push(buildCheck);
+    }
+    if (options?.includeTests) {
+        const testCheck = checkTestHealth(basePath);
+        if (testCheck)
+            results.push(testCheck);
+    }
+    return results;
+}
 /**
  * Convert environment check results to DoctorIssue format for the doctor pipeline.
  */
@@ -417,6 +492,9 @@ export async function checkEnvironmentHealth(basePath, issues, options) {
     const results = options?.includeRemote
         ? runFullEnvironmentChecks(basePath)
         : runEnvironmentChecks(basePath);
+    if (options?.includeBuild || options?.includeTests) {
+        results.push(...runSlowEnvironmentChecks(basePath, options));
+    }
     issues.push(...environmentResultsToDoctorIssues(results));
 }
 /**

package/dist/resources/extensions/gsd/doctor-format.js

@@ -69,3 +69,18 @@ export function formatDoctorIssuesForPrompt(issues) {
         return `- [${prefix}] ${issue.unitId} | ${issue.code} | ${issue.message}${issue.file ? ` | file: ${issue.file}` : ""} | fixable: ${issue.fixable ? "yes" : "no"}`;
     }).join("\n");
 }
+/**
+ * Serialize a doctor report to JSON — suitable for CI/tooling integration.
+ * Usage: /gsd doctor --json
+ */
+export function formatDoctorReportJson(report) {
+    return JSON.stringify({
+        ok: report.ok,
+        basePath: report.basePath,
+        generatedAt: new Date().toISOString(),
+        summary: summarizeDoctorIssues(report.issues),
+        issues: report.issues,
+        fixesApplied: report.fixesApplied,
+        ...(report.timing ? { timing: report.timing } : {}),
+    }, null, 2);
+}

package/dist/resources/extensions/gsd/doctor-providers.js

@@ -12,6 +12,7 @@
  */
 import { existsSync } from "node:fs";
 import { AuthStorage } from "@gsd/pi-coding-agent";
+import { getEnvApiKey } from "@gsd/pi-ai";
 import { loadEffectiveGSDPreferences } from "./preferences.js";
 import { getAuthPath, PROVIDER_REGISTRY } from "./key-manager.js";
 // ── Model → Provider ID mapping ───────────────────────────────────────────────
@@ -33,6 +34,7 @@ function modelToProviderId(model) {
             google: "google",
             anthropic: "anthropic",
             openai: "openai",
+            "github-copilot": "github-copilot",
         };
         if (prefixMap[prefix])
             return prefixMap[prefix];
@@ -108,13 +110,29 @@ function resolveKey(providerId) {
             // auth.json malformed — fall through to env check
         }
     }
-    // Check environment variable
+    // Check environment variable using the authoritative env var resolution
+    // (handles multi-var lookups like ANTHROPIC_OAUTH_TOKEN || ANTHROPIC_API_KEY,
+    //  COPILOT_GITHUB_TOKEN || GH_TOKEN || GITHUB_TOKEN, Vertex ADC, Bedrock, etc.)
+    if (getEnvApiKey(providerId)) {
+        return { found: true, source: "env", backedOff: false };
+    }
+    // Fall back to PROVIDER_REGISTRY env var for providers not covered by getEnvApiKey
+    // (e.g., search providers like Brave, Tavily; tool providers like Jina, Context7)
     if (info?.envVar && process.env[info.envVar]) {
         return { found: true, source: "env", backedOff: false };
     }
     return { found: false, source: "none", backedOff: false };
 }
 // ── Individual check groups ────────────────────────────────────────────────────
+/**
+ * Providers that can serve models normally associated with another provider.
+ * Key = the provider whose models can be served, Value = alternative providers to check.
+ * e.g. GitHub Copilot subscriptions can access Claude and GPT models.
+ */
+const PROVIDER_ROUTES = {
+    anthropic: ["github-copilot"],
+    openai: ["github-copilot"],
+};
 function checkLlmProviders() {
     const required = collectConfiguredModelProviders();
     const results = [];
@@ -123,6 +141,22 @@ function checkLlmProviders() {
         const label = info?.label ?? providerId;
         const lookup = resolveKey(providerId);
         if (!lookup.found) {
+            // Check if a cross-provider can serve this provider's models
+            const routes = PROVIDER_ROUTES[providerId];
+            const routeProvider = routes?.find(routeId => resolveKey(routeId).found);
+            if (routeProvider) {
+                const routeInfo = PROVIDER_REGISTRY.find(p => p.id === routeProvider);
+                const routeLabel = routeInfo?.label ?? routeProvider;
+                results.push({
+                    name: providerId,
+                    label,
+                    category: "llm",
+                    status: "ok",
+                    message: `${label} — available via ${routeLabel}`,
+                    required: true,
+                });
+                continue;
+            }
             const envVar = info?.envVar ?? `${providerId.toUpperCase()}_API_KEY`;
             results.push({
                 name: providerId,