gsd-pi 2.38.0-dev.eeb3520 → 2.39.0-dev.64cd3ed

package/dist/resources/extensions/gsd/health-widget-core.js

@@ -4,65 +4,18 @@
  * Separates project-state detection and line rendering from the widget's
  * runtime integrations so the regressions can be tested directly.
  */
-import { existsSync, readdirSync } from "node:fs";
+import { existsSync } from "node:fs";
+import { detectProjectState } from "./detection.js";
 import { gsdRoot } from "./paths.js";
-import { join } from "node:path";
 export function detectHealthWidgetProjectState(basePath) {
-    const root = gsdRoot(basePath);
-    if (!existsSync(root))
+    if (!existsSync(gsdRoot(basePath)))
         return "none";
-    // Lightweight milestone count — avoids the full detectProjectState() scan
-    // (CI markers, Makefile targets, etc.) that is unnecessary on the 60s refresh.
-    try {
-        const milestonesDir = join(root, "milestones");
-        if (existsSync(milestonesDir)) {
-            const entries = readdirSync(milestonesDir, { withFileTypes: true });
-            if (entries.some(e => e.isDirectory()))
-                return "active";
-        }
-    }
-    catch { /* non-fatal */ }
-    return "initialized";
+    const { state } = detectProjectState(basePath);
+    return state === "v2-gsd" ? "active" : "initialized";
 }
 function formatCost(n) {
     return n >= 1 ? `$${n.toFixed(2)}` : `${(n * 100).toFixed(1)}¢`;
 }
-function formatProgress(progress) {
-    if (!progress)
-        return null;
-    const parts = [];
-    parts.push(`M ${progress.milestones.done}/${progress.milestones.total}`);
-    if (progress.slices)
-        parts.push(`S ${progress.slices.done}/${progress.slices.total}`);
-    if (progress.tasks)
-        parts.push(`T ${progress.tasks.done}/${progress.tasks.total}`);
-    return parts.length > 0 ? `Progress: ${parts.join(" · ")}` : null;
-}
-function formatEnvironmentSummary(errorCount, warningCount) {
-    if (errorCount <= 0 && warningCount <= 0)
-        return null;
-    const parts = [];
-    if (errorCount > 0)
-        parts.push(`${errorCount} error${errorCount > 1 ? "s" : ""}`);
-    if (warningCount > 0)
-        parts.push(`${warningCount} warning${warningCount > 1 ? "s" : ""}`);
-    return `Env: ${parts.join(", ")}`;
-}
-function formatBudgetSummary(data) {
-    if (data.budgetCeiling !== undefined && data.budgetCeiling > 0) {
-        const pct = Math.min(100, (data.budgetSpent / data.budgetCeiling) * 100);
-        return `Budget: ${formatCost(data.budgetSpent)}/${formatCost(data.budgetCeiling)} (${pct.toFixed(0)}%)`;
-    }
-    if (data.budgetSpent > 0) {
-        return `Spent: ${formatCost(data.budgetSpent)}`;
-    }
-    return null;
-}
-function buildExecutionHeadline(data) {
-    const status = data.executionStatus ?? "Active project";
-    const target = data.executionTarget ?? data.blocker ?? "loading status…";
-    return `  GSD  ${status}${target ? ` - ${target}` : ""}`;
-}
 /**
  * Build compact health lines for the widget.
  * Returns a string array suitable for setWidget().
@@ -74,23 +27,32 @@ export function buildHealthLines(data) {
     if (data.projectState === "initialized") {
         return ["  GSD  Project initialized — run /gsd to continue setup"];
     }
-    const lines = [buildExecutionHeadline(data)];
-    const details = [];
-    const progress = formatProgress(data.progress);
-    if (progress)
-        details.push(progress);
-    if (data.providerIssue)
-        details.push(data.providerIssue);
-    const environment = formatEnvironmentSummary(data.environmentErrorCount, data.environmentWarningCount);
-    if (environment)
-        details.push(environment);
-    const budget = formatBudgetSummary(data);
-    if (budget)
-        details.push(budget);
-    if (data.eta)
-        details.push(data.eta);
-    if (details.length > 0) {
-        lines.push(`  ${details.join("  │  ")}`);
+    const parts = [];
+    const totalIssues = data.environmentErrorCount + data.environmentWarningCount + (data.providerIssue ? 1 : 0);
+    if (totalIssues === 0) {
+        parts.push("● System OK");
+    }
+    else if (data.environmentErrorCount > 0 || data.providerIssue?.includes("✗")) {
+        parts.push(`✗ ${totalIssues} issue${totalIssues > 1 ? "s" : ""}`);
+    }
+    else {
+        parts.push(`⚠ ${totalIssues} warning${totalIssues > 1 ? "s" : ""}`);
+    }
+    if (data.budgetCeiling !== undefined && data.budgetCeiling > 0) {
+        const pct = Math.min(100, (data.budgetSpent / data.budgetCeiling) * 100);
+        parts.push(`Budget: ${formatCost(data.budgetSpent)}/${formatCost(data.budgetCeiling)} (${pct.toFixed(0)}%)`);
+    }
+    else if (data.budgetSpent > 0) {
+        parts.push(`Spent: ${formatCost(data.budgetSpent)}`);
+    }
+    if (data.providerIssue) {
+        parts.push(data.providerIssue);
+    }
+    if (data.environmentErrorCount > 0) {
+        parts.push(`Env: ${data.environmentErrorCount} error${data.environmentErrorCount > 1 ? "s" : ""}`);
+    }
+    else if (data.environmentWarningCount > 0) {
+        parts.push(`Env: ${data.environmentWarningCount} warning${data.environmentWarningCount > 1 ? "s" : ""}`);
     }
-    return lines;
+    return [`  ${parts.join("  │  ")}`];
 }

package/dist/resources/extensions/gsd/health-widget.js

@@ -11,12 +11,10 @@ import { runProviderChecks, summariseProviderIssues } from "./doctor-providers.j
 import { runEnvironmentChecks } from "./doctor-environment.js";
 import { loadEffectiveGSDPreferences } from "./preferences.js";
 import { loadLedgerFromDisk, getProjectTotals } from "./metrics.js";
-import { describeNextUnit, estimateTimeRemaining, updateSliceProgressCache } from "./auto-dashboard.js";
 import { projectRoot } from "./commands.js";
-import { deriveState, invalidateStateCache } from "./state.js";
 import { buildHealthLines, detectHealthWidgetProjectState, } from "./health-widget-core.js";
 // ── Data loader ────────────────────────────────────────────────────────────────
-function loadBaseHealthWidgetData(basePath) {
+function loadHealthWidgetData(basePath) {
     let budgetCeiling;
     let budgetSpent = 0;
     let providerIssue = null;
@@ -58,86 +56,6 @@ function loadBaseHealthWidgetData(basePath) {
         lastRefreshed: Date.now(),
     };
 }
-function compactText(text, max = 64) {
-    const trimmed = text.replace(/\s+/g, " ").trim();
-    if (trimmed.length <= max)
-        return trimmed;
-    return `${trimmed.slice(0, max - 1).trimEnd()}…`;
-}
-function summarizeExecutionStatus(state) {
-    switch (state.phase) {
-        case "blocked": return "Blocked";
-        case "paused": return "Paused";
-        case "complete": return "Complete";
-        case "executing": return "Executing";
-        case "planning": return "Planning";
-        case "pre-planning": return "Pre-planning";
-        case "summarizing": return "Summarizing";
-        case "validating-milestone": return "Validating";
-        case "completing-milestone": return "Completing";
-        case "needs-discussion": return "Needs discussion";
-        case "replanning-slice": return "Replanning";
-        default: return "Active";
-    }
-}
-function summarizeExecutionTarget(state) {
-    switch (state.phase) {
-        case "needs-discussion":
-            return state.activeMilestone ? `Discuss ${state.activeMilestone.id}` : "Discuss milestone draft";
-        case "pre-planning":
-            return state.activeMilestone ? `Plan ${state.activeMilestone.id}` : "Research & plan milestone";
-        case "planning":
-            return state.activeSlice ? `Plan ${state.activeSlice.id}` : "Plan next slice";
-        case "executing":
-            return state.activeTask ? `Execute ${state.activeTask.id}` : "Execute next task";
-        case "summarizing":
-            return state.activeSlice ? `Complete ${state.activeSlice.id}` : "Complete current slice";
-        case "validating-milestone":
-            return state.activeMilestone ? `Validate ${state.activeMilestone.id}` : "Validate milestone";
-        case "completing-milestone":
-            return state.activeMilestone ? `Complete ${state.activeMilestone.id}` : "Complete milestone";
-        case "replanning-slice":
-            return state.activeSlice ? `Replan ${state.activeSlice.id}` : "Replan current slice";
-        case "blocked":
-            return `waiting on ${compactText(state.blockers[0] ?? state.nextAction, 56)}`;
-        case "paused":
-            return compactText(state.nextAction || "waiting to resume", 56);
-        case "complete":
-            return "All milestones complete";
-        default:
-            return compactText(describeNextUnit(state).label, 56);
-    }
-}
-async function enrichHealthWidgetData(basePath, baseData) {
-    if (baseData.projectState !== "active")
-        return baseData;
-    try {
-        invalidateStateCache();
-        const state = await deriveState(basePath);
-        if (state.activeMilestone) {
-            // Warm the slice-progress cache so estimateTimeRemaining() has data
-            updateSliceProgressCache(basePath, state.activeMilestone.id, state.activeSlice?.id);
-        }
-        return {
-            ...baseData,
-            executionPhase: state.phase,
-            executionStatus: summarizeExecutionStatus(state),
-            executionTarget: summarizeExecutionTarget(state),
-            nextAction: state.nextAction,
-            blocker: state.blockers[0] ?? null,
-            activeMilestoneId: state.activeMilestone?.id,
-            activeSliceId: state.activeSlice?.id,
-            activeTaskId: state.activeTask?.id,
-            progress: state.progress,
-            eta: state.phase === "blocked" || state.phase === "paused" || state.phase === "complete"
-                ? null
-                : estimateTimeRemaining(),
-        };
-    }
-    catch {
-        return baseData;
-    }
-}
 // ── Widget init ────────────────────────────────────────────────────────────────
 const REFRESH_INTERVAL_MS = 60_000;
 /**
@@ -149,7 +67,7 @@ export function initHealthWidget(ctx) {
         return;
     const basePath = projectRoot();
     // String-array fallback — used in RPC mode (factory is a no-op there)
-    const initialData = loadBaseHealthWidgetData(basePath);
+    const initialData = loadHealthWidgetData(basePath);
     ctx.ui.setWidget("gsd-health", buildHealthLines(initialData), { placement: "belowEditor" });
     // Factory-based widget for TUI mode — replaces the string-array above
     ctx.ui.setWidget("gsd-health", (_tui, _theme) => {
@@ -161,8 +79,7 @@ export function initHealthWidget(ctx) {
                 return;
             refreshInFlight = true;
             try {
-                const baseData = loadBaseHealthWidgetData(basePath);
-                data = await enrichHealthWidgetData(basePath, baseData);
+                data = loadHealthWidgetData(basePath);
                 cachedLines = undefined;
                 _tui.requestRender();
             }

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

@@ -41,6 +41,7 @@ import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { shortcutDesc } from "../shared/mod.js";
+const gsdHome = process.env.GSD_HOME || join(homedir(), ".gsd");
 import { Text } from "@gsd/pi-tui";
 import { pauseAutoForProviderError, classifyProviderError } from "./provider-error-pause.js";
 import { toPosixPath } from "../shared/mod.js";
@@ -52,7 +53,7 @@ import { markCmuxPromptShown, shouldPromptToEnableCmux } from "../cmux/index.js"
 // Pi core natively supports AGENTS.md (with CLAUDE.md fallback) per directory.
 function warnDeprecatedAgentInstructions() {
     const paths = [
-        join(homedir(), ".gsd", "agent-instructions.md"),
+        join(gsdHome, "agent-instructions.md"),
         join(process.cwd(), ".gsd", "agent-instructions.md"),
     ];
     for (const p of paths) {
@@ -65,6 +66,24 @@ function warnDeprecatedAgentInstructions() {
 }
 // ── Depth verification state ──────────────────────────────────────────────
 let depthVerificationDone = false;
+// ── DB lazy-open helper ───────────────────────────────────────────────────
+// In manual sessions (no auto-mode), the DB is never opened by bootstrapAutoSession.
+// This helper ensures the DB is lazily opened on first tool call that needs it.
+async function ensureDbOpen() {
+    try {
+        const db = await import("./gsd-db.js");
+        if (db.isDbAvailable())
+            return true;
+        const dbPath = join(process.cwd(), ".gsd", "gsd.db");
+        if (existsSync(dbPath)) {
+            return db.openDatabase(dbPath);
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
 // ── Queue phase tracking ──────────────────────────────────────────────────
 // When true, the LLM is in a queue flow writing CONTEXT.md files.
 // The write-gate applies during queue flows just like discussion flows.
@@ -227,13 +246,8 @@ export default function (pi) {
             when_context: Type.Optional(Type.String({ description: "When/context for the decision (e.g. milestone ID)" })),
         }),
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
-            // Check DB availability
-            let dbAvailable = false;
-            try {
-                const db = await import("./gsd-db.js");
-                dbAvailable = db.isDbAvailable();
-            }
-            catch { /* dynamic import failed */ }
+            // Ensure DB is open (lazy-open on first tool call in manual sessions)
+            const dbAvailable = await ensureDbOpen();
             if (!dbAvailable) {
                 return {
                     content: [{ type: "text", text: "Error: GSD database is not available. Cannot save decision." }],
@@ -289,12 +303,7 @@ export default function (pi) {
             supporting_slices: Type.Optional(Type.String({ description: "Supporting slices" })),
         }),
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
-            let dbAvailable = false;
-            try {
-                const db = await import("./gsd-db.js");
-                dbAvailable = db.isDbAvailable();
-            }
-            catch { /* dynamic import failed */ }
+            const dbAvailable = await ensureDbOpen();
             if (!dbAvailable) {
                 return {
                     content: [{ type: "text", text: "Error: GSD database is not available. Cannot update requirement." }],
@@ -364,12 +373,7 @@ export default function (pi) {
             content: Type.String({ description: "The full markdown content of the artifact" }),
         }),
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
-            let dbAvailable = false;
-            try {
-                const db = await import("./gsd-db.js");
-                dbAvailable = db.isDbAvailable();
-            }
-            catch { /* dynamic import failed */ }
+            const dbAvailable = await ensureDbOpen();
             if (!dbAvailable) {
                 return {
                     content: [{ type: "text", text: "Error: GSD database is not available. Cannot save artifact." }],

package/dist/resources/extensions/gsd/migrate/parsers.js

@@ -2,7 +2,7 @@
 // Pure functions that take file content (string) and return typed data.
 // Zero Pi dependencies — uses only exported helpers from files.ts.
 import { splitFrontmatter, parseFrontmatterMap, extractBoldField } from '../files.js';
-import { normalizeStringArray } from '../../shared/mod.js';
+import { normalizeStringArray } from '../../shared/format-utils.js';
 // Re-export PlanningProjectMeta — not in types.ts yet, use string for project field
 // Actually PlanningProjectMeta isn't in types.ts — project is stored as string | null.
 // We'll keep parseOldProject returning a simple shape.

package/dist/resources/extensions/gsd/migrate-external.js

@@ -5,11 +5,13 @@
  * `~/.gsd/projects/<hash>/` state directory. After migration, a
  * symlink replaces the original directory so all paths remain valid.
  */
+import { execFileSync } from "node:child_process";
 import { existsSync, lstatSync, mkdirSync, readdirSync, realpathSync, renameSync, cpSync, rmSync, symlinkSync } from "node:fs";
 import { join } from "node:path";
 import { externalGsdRoot } from "./repo-identity.js";
 import { getErrorMessage } from "./error-utils.js";
 import { hasGitTrackedGsdFiles } from "./gitignore.js";
+import { GIT_NO_PROMPT_ENV } from "./git-constants.js";
 /**
  * Migrate a legacy in-project `.gsd/` directory to external storage.
  *
@@ -142,7 +144,22 @@ export function migrateToExternalState(basePath) {
             catch { /* best-effort restore */ }
             return { migrated: false, error: `Migration verification failed: ${getErrorMessage(verifyErr)}` };
         }
-        // Remove .gsd.migrating only after symlink is verified
+        // Clean the git index — any .gsd/* files tracked before migration now
+        // sit behind the symlink and git can't follow it, causing them to show
+        // as deleted. Remove them from the index so the working tree stays clean.
+        // --ignore-unmatch makes this a no-op on fresh projects with no tracked .gsd/.
+        try {
+            execFileSync("git", ["rm", "-r", "--cached", "--ignore-unmatch", ".gsd"], {
+                cwd: basePath,
+                stdio: ["ignore", "pipe", "ignore"],
+                env: GIT_NO_PROMPT_ENV,
+                timeout: 10_000,
+            });
+        }
+        catch {
+            // Non-fatal — git may be unavailable or nothing was tracked
+        }
+        // Remove .gsd.migrating only after symlink is verified and index is clean
         rmSync(migratingPath, { recursive: true, force: true });
         return { migrated: true };
     }

package/dist/resources/extensions/gsd/native-git-bridge.js

@@ -518,6 +518,43 @@ export function nativeAddAll(basePath) {
     }
     gitFileExec(basePath, ["add", "-A"]);
 }
+/**
+ * Stage all files with pathspec exclusions (git add -A -- ':!pattern' ...).
+ * Excluded paths are never hashed by git, preventing hangs on large
+ * untracked artifact trees (57GB+, 11K+ files). See #1605.
+ *
+ * Falls back to plain `git add -A` when no exclusions are provided.
+ * Always uses the CLI path (not libgit2) because libgit2's add_all
+ * does not support pathspec exclusion syntax.
+ *
+ * When excluded paths are already covered by .gitignore, git may exit
+ * with code 1 and an "ignored by .gitignore" warning. This is harmless
+ * (the staging succeeds for all non-ignored files) and is suppressed.
+ */
+export function nativeAddAllWithExclusions(basePath, exclusions) {
+    if (exclusions.length === 0) {
+        nativeAddAll(basePath);
+        return;
+    }
+    const pathspecs = exclusions.map(e => `:!${e}`);
+    try {
+        execFileSync("git", ["add", "-A", "--", ...pathspecs], {
+            cwd: basePath,
+            stdio: ["ignore", "pipe", "pipe"],
+            encoding: "utf-8",
+            env: GIT_NO_PROMPT_ENV,
+        });
+    }
+    catch (err) {
+        // git exits 1 when pathspec exclusions reference paths already covered
+        // by .gitignore. The staging itself succeeds — only suppress that case.
+        const stderr = err?.stderr ?? "";
+        if (stderr.includes("ignored by one of your .gitignore files")) {
+            return;
+        }
+        throw new GSDError(GSD_GIT_ERROR, `git add -A with exclusions failed in ${basePath}: ${getErrorMessage(err)}`);
+    }
+}
 /**
  * Stage specific files.
  * Native: libgit2 index add.

package/dist/resources/extensions/gsd/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "pi": {
     "extensions": [
-      "./index.ts"
+      "./index.js"
     ]
   }
 }

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

@@ -343,6 +343,9 @@ function probeGsdRoot(rawBasePath) {
 export function milestonesDir(basePath) {
     return join(gsdRoot(basePath), "milestones");
 }
+export function resolveRuntimeFile(basePath) {
+    return join(gsdRoot(basePath), "RUNTIME.md");
+}
 export function resolveGsdRootFile(basePath, key) {
     const root = gsdRoot(basePath);
     const canonical = join(root, GSD_ROOT_FILES[key]);

package/dist/resources/extensions/gsd/preferences-models.js

@@ -260,18 +260,6 @@ export function resolveInlineLevel() {
         case "quality": return "full";
     }
 }
-/**
- * Resolve the compression strategy from the active token profile.
- * budget/balanced -> "compress", quality -> "truncate".
- * Explicit preference always wins.
- */
-export function resolveCompressionStrategy() {
-    const prefs = loadEffectiveGSDPreferences();
-    if (prefs?.preferences.compression_strategy)
-        return prefs.preferences.compression_strategy;
-    const profile = resolveEffectiveProfile();
-    return profile === "quality" ? "truncate" : "compress";
-}
 /**
  * Resolve the context selection mode from the active token profile.
  * budget -> "smart", balanced/quality -> "full".

package/dist/resources/extensions/gsd/preferences-types.js

@@ -62,10 +62,10 @@ export const KNOWN_PREFERENCE_KEYS = new Set([
     "verification_auto_fix",
     "verification_max_retries",
     "search_provider",
-    "compression_strategy",
     "context_selection",
     "widget_mode",
     "reactive_execution",
+    "github",
 ]);
 /** Canonical list of all dispatch unit types. */
 export const KNOWN_UNIT_TYPES = [

package/dist/resources/extensions/gsd/preferences-validation.js

@@ -6,7 +6,7 @@
  * together with any errors and warnings.
  */
 import { VALID_BRANCH_NAME } from "./git-service.js";
-import { normalizeStringArray } from "../shared/mod.js";
+import { normalizeStringArray } from "../shared/format-utils.js";
 import { KNOWN_PREFERENCE_KEYS, KNOWN_UNIT_TYPES, SKILL_ACTIONS, } from "./preferences-types.js";
 const VALID_TOKEN_PROFILES = new Set(["budget", "balanced", "quality"]);
 export function validatePreferences(preferences) {
@@ -707,16 +707,6 @@ export function validatePreferences(preferences) {
             errors.push("auto_report must be a boolean");
         }
     }
-    // ─── Compression Strategy ───────────────────────────────────────────
-    if (preferences.compression_strategy !== undefined) {
-        const validStrategies = new Set(["truncate", "compress"]);
-        if (typeof preferences.compression_strategy === "string" && validStrategies.has(preferences.compression_strategy)) {
-            validated.compression_strategy = preferences.compression_strategy;
-        }
-        else {
-            errors.push(`compression_strategy must be one of: truncate, compress`);
-        }
-    }
     // ─── Context Selection ──────────────────────────────────────────────
     if (preferences.context_selection !== undefined) {
         const validModes = new Set(["full", "smart"]);
@@ -727,5 +717,63 @@ export function validatePreferences(preferences) {
             errors.push(`context_selection must be one of: full, smart`);
         }
     }
+    // ─── GitHub Sync ────────────────────────────────────────────────────────
+    if (preferences.github !== undefined) {
+        if (typeof preferences.github === "object" && preferences.github !== null) {
+            const gh = preferences.github;
+            const validGh = {};
+            if (gh.enabled !== undefined) {
+                if (typeof gh.enabled === "boolean")
+                    validGh.enabled = gh.enabled;
+                else
+                    errors.push("github.enabled must be a boolean");
+            }
+            if (gh.repo !== undefined) {
+                if (typeof gh.repo === "string" && gh.repo.includes("/"))
+                    validGh.repo = gh.repo;
+                else
+                    errors.push('github.repo must be a string in "owner/repo" format');
+            }
+            if (gh.project !== undefined) {
+                const p = typeof gh.project === "number" ? gh.project : Number(gh.project);
+                if (Number.isFinite(p) && p > 0)
+                    validGh.project = Math.floor(p);
+                else
+                    errors.push("github.project must be a positive number");
+            }
+            if (gh.labels !== undefined) {
+                if (Array.isArray(gh.labels) && gh.labels.every((l) => typeof l === "string")) {
+                    validGh.labels = gh.labels;
+                }
+                else {
+                    errors.push("github.labels must be an array of strings");
+                }
+            }
+            if (gh.auto_link_commits !== undefined) {
+                if (typeof gh.auto_link_commits === "boolean")
+                    validGh.auto_link_commits = gh.auto_link_commits;
+                else
+                    errors.push("github.auto_link_commits must be a boolean");
+            }
+            if (gh.slice_prs !== undefined) {
+                if (typeof gh.slice_prs === "boolean")
+                    validGh.slice_prs = gh.slice_prs;
+                else
+                    errors.push("github.slice_prs must be a boolean");
+            }
+            const knownGhKeys = new Set(["enabled", "repo", "project", "labels", "auto_link_commits", "slice_prs"]);
+            for (const key of Object.keys(gh)) {
+                if (!knownGhKeys.has(key)) {
+                    warnings.push(`unknown github key "${key}" — ignored`);
+                }
+            }
+            if (Object.keys(validGh).length > 0) {
+                validated.github = validGh;
+            }
+        }
+        else {
+            errors.push("github must be an object");
+        }
+    }
     return { preferences: validated, errors, warnings };
 }

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

@@ -14,7 +14,7 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { gsdRoot } from "./paths.js";
 import { parse as parseYaml } from "yaml";
-import { normalizeStringArray } from "../shared/mod.js";
+import { normalizeStringArray } from "../shared/format-utils.js";
 import { resolveProfileDefaults as _resolveProfileDefaults } from "./preferences-models.js";
 import { MODE_DEFAULTS, } from "./preferences-types.js";
 import { validatePreferences } from "./preferences-validation.js";
@@ -24,33 +24,42 @@ export { validatePreferences } from "./preferences-validation.js";
 // ─── Re-exports: skills ─────────────────────────────────────────────────────
 export { resolveAllSkillReferences, resolveSkillDiscoveryMode, resolveSkillStalenessDays, } from "./preferences-skills.js";
 // ─── Re-exports: models ─────────────────────────────────────────────────────
-export { resolveModelForUnit, resolveModelWithFallbacksForUnit, getNextFallbackModel, isTransientNetworkError, validateModelId, updatePreferencesModels, resolveDynamicRoutingConfig, resolveAutoSupervisorConfig, resolveProfileDefaults, resolveEffectiveProfile, resolveInlineLevel, resolveCompressionStrategy, resolveContextSelection, resolveSearchProviderFromPreferences, } from "./preferences-models.js";
+export { resolveModelForUnit, resolveModelWithFallbacksForUnit, getNextFallbackModel, isTransientNetworkError, validateModelId, updatePreferencesModels, resolveDynamicRoutingConfig, resolveAutoSupervisorConfig, resolveProfileDefaults, resolveEffectiveProfile, resolveInlineLevel, resolveContextSelection, resolveSearchProviderFromPreferences, } from "./preferences-models.js";
 // ─── Path Constants & Getters ───────────────────────────────────────────────
-const GLOBAL_PREFERENCES_PATH = join(homedir(), ".gsd", "preferences.md");
-const LEGACY_GLOBAL_PREFERENCES_PATH = join(homedir(), ".pi", "agent", "gsd-preferences.md");
+function gsdHome() {
+    return process.env.GSD_HOME || join(homedir(), ".gsd");
+}
+function globalPreferencesPath() {
+    return join(gsdHome(), "preferences.md");
+}
+function legacyGlobalPreferencesPath() {
+    return join(homedir(), ".pi", "agent", "gsd-preferences.md");
+}
 function projectPreferencesPath() {
     return join(gsdRoot(process.cwd()), "preferences.md");
 }
 // Bootstrap in gitignore.ts historically created PREFERENCES.md (uppercase) by mistake.
 // Check uppercase as a fallback so those files aren't silently ignored.
-const GLOBAL_PREFERENCES_PATH_UPPERCASE = join(homedir(), ".gsd", "PREFERENCES.md");
+function globalPreferencesPathUppercase() {
+    return join(gsdHome(), "PREFERENCES.md");
+}
 function projectPreferencesPathUppercase() {
     return join(gsdRoot(process.cwd()), "PREFERENCES.md");
 }
 export function getGlobalGSDPreferencesPath() {
-    return GLOBAL_PREFERENCES_PATH;
+    return globalPreferencesPath();
 }
 export function getLegacyGlobalGSDPreferencesPath() {
-    return LEGACY_GLOBAL_PREFERENCES_PATH;
+    return legacyGlobalPreferencesPath();
 }
 export function getProjectGSDPreferencesPath() {
     return projectPreferencesPath();
 }
 // ─── Loading ────────────────────────────────────────────────────────────────
 export function loadGlobalGSDPreferences() {
-    return loadPreferencesFile(GLOBAL_PREFERENCES_PATH, "global")
-        ?? loadPreferencesFile(GLOBAL_PREFERENCES_PATH_UPPERCASE, "global")
-        ?? loadPreferencesFile(LEGACY_GLOBAL_PREFERENCES_PATH, "global");
+    return loadPreferencesFile(globalPreferencesPath(), "global")
+        ?? loadPreferencesFile(globalPreferencesPathUppercase(), "global")
+        ?? loadPreferencesFile(legacyGlobalPreferencesPath(), "global");
 }
 export function loadProjectGSDPreferences() {
     return loadPreferencesFile(projectPreferencesPath(), "project")
@@ -199,10 +208,12 @@ function mergePreferences(base, override) {
         verification_auto_fix: override.verification_auto_fix ?? base.verification_auto_fix,
         verification_max_retries: override.verification_max_retries ?? base.verification_max_retries,
         search_provider: override.search_provider ?? base.search_provider,
-        compression_strategy: override.compression_strategy ?? base.compression_strategy,
         context_selection: override.context_selection ?? base.context_selection,
         auto_visualize: override.auto_visualize ?? base.auto_visualize,
         auto_report: override.auto_report ?? base.auto_report,
+        github: (base.github || override.github)
+            ? { ...(base.github ?? {}), ...(override.github ?? {}) }
+            : undefined,
     };
 }
 function mergeStringLists(base, override) {