gsd-pi 2.34.0 → 2.35.0-dev.cd3b7ea

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

@@ -0,0 +1,162 @@
+/**
+ * GSD Changelog — Fetch and display categorized release notes from GitHub
+ *
+ * Fetches releases from the gsd-build/gsd-2 GitHub repository,
+ * prompts the user for a version filter, and sends raw release notes
+ * into the conversation for the LLM to summarize.
+ *
+ * Entry point: handleChangelog() called from commands.ts
+ */
+// ─── Semver comparison ────────────────────────────────────────────────────────
+function compareSemver(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const va = pa[i] || 0;
+        const vb = pb[i] || 0;
+        if (va > vb)
+            return 1;
+        if (va < vb)
+            return -1;
+    }
+    return 0;
+}
+function stripV(tag) {
+    return tag.startsWith("v") ? tag.slice(1) : tag;
+}
+function parseReleaseBody(body) {
+    if (!body)
+        return [];
+    const sections = [];
+    const lines = body.split("\n");
+    let currentHeading = null;
+    let currentLines = [];
+    for (const line of lines) {
+        if (line.startsWith("### ")) {
+            if (currentHeading !== null) {
+                const content = currentLines.join("\n").trim();
+                if (content) {
+                    sections.push({ heading: currentHeading, content });
+                }
+            }
+            currentHeading = line.slice(4).trim();
+            currentLines = [];
+        }
+        else if (currentHeading !== null) {
+            currentLines.push(line);
+        }
+    }
+    if (currentHeading !== null) {
+        const content = currentLines.join("\n").trim();
+        if (content) {
+            sections.push({ heading: currentHeading, content });
+        }
+    }
+    return sections;
+}
+// ─── Display formatting ──────────────────────────────────────────────────────
+function formatRelease(release) {
+    const version = stripV(release.tag_name);
+    const title = release.name || `v${version}`;
+    const sections = parseReleaseBody(release.body);
+    const parts = [`## ${title}`];
+    if (sections.length === 0) {
+        if (release.body?.trim()) {
+            parts.push(release.body.trim());
+        }
+        else {
+            parts.push("_No release notes._");
+        }
+    }
+    else {
+        for (const section of sections) {
+            parts.push(`### ${section.heading}`);
+            parts.push(section.content);
+        }
+    }
+    return parts.join("\n\n");
+}
+// ─── Entry Point ──────────────────────────────────────────────────────────────
+const RELEASES_URL = "https://api.github.com/repos/gsd-build/gsd-2/releases?per_page=100";
+export async function handleChangelog(args, ctx, pi) {
+    // ── Fetch releases ──────────────────────────────────────────────────────
+    let releases;
+    try {
+        const response = await fetch(RELEASES_URL, {
+            headers: { "User-Agent": "gsd-changelog" },
+        });
+        if (!response.ok) {
+            ctx.ui.notify(`Failed to fetch changelog: GitHub API returned ${response.status} ${response.statusText}`, "error");
+            return;
+        }
+        releases = (await response.json());
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        ctx.ui.notify(`Failed to fetch changelog: ${message}`, "error");
+        return;
+    }
+    if (!releases.length) {
+        ctx.ui.notify("No releases found in the repository.", "warning");
+        return;
+    }
+    // ── Determine version filter ────────────────────────────────────────────
+    const currentVersion = process.env.GSD_VERSION || "";
+    let sinceVersion;
+    let showCurrentOnly = false;
+    if (args.trim()) {
+        sinceVersion = stripV(args.trim());
+    }
+    else {
+        const input = await ctx.ui.input("Show changes since version:", currentVersion || "latest");
+        if (input === undefined) {
+            return;
+        }
+        if (input.trim() === "") {
+            showCurrentOnly = true;
+        }
+        else {
+            sinceVersion = stripV(input.trim());
+        }
+    }
+    // ── Filter releases ─────────────────────────────────────────────────────
+    let matched;
+    if (showCurrentOnly) {
+        if (!currentVersion) {
+            ctx.ui.notify("GSD_VERSION is not set — cannot determine current release. Provide a version instead.", "warning");
+            return;
+        }
+        const found = releases.find((r) => stripV(r.tag_name) === currentVersion);
+        if (!found) {
+            ctx.ui.notify(`No release found matching current version v${currentVersion}`, "warning");
+            return;
+        }
+        matched = [found];
+    }
+    else if (sinceVersion) {
+        matched = releases
+            .filter((r) => compareSemver(stripV(r.tag_name), sinceVersion) > 0)
+            .sort((a, b) => compareSemver(stripV(b.tag_name), stripV(a.tag_name)));
+        if (!matched.length) {
+            ctx.ui.notify(`No releases found since v${sinceVersion}`, "warning");
+            return;
+        }
+    }
+    else {
+        matched = [releases[0]];
+    }
+    // ── Send to LLM for summarization ───────────────────────────────────────
+    const rawOutput = matched.map(formatRelease).join("\n\n---\n\n");
+    const versionRange = sinceVersion
+        ? `since v${sinceVersion} (${matched.length} release${matched.length === 1 ? "" : "s"})`
+        : `for current release ${matched[0].name || matched[0].tag_name}`;
+    const prompt = [
+        `Here are the raw GSD changelog entries ${versionRange}.`,
+        "Summarize the most important changes — group by category (Added, Changed, Fixed, etc.),",
+        "keep only the most impactful items (max 5 per category), skip trivial changes,",
+        "and include the version where each item appeared. Keep it concise and scannable.",
+        "",
+        rawOutput,
+    ].join("\n");
+    pi.sendMessage({ customType: "gsd-changelog", content: prompt, display: true }, { triggerTurn: true });
+}

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

@@ -11,6 +11,7 @@ const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "quick", desc: "Execute a quick task without full planning overhead" },
     { cmd: "discuss", desc: "Discuss architecture and decisions" },
     { cmd: "capture", desc: "Fire-and-forget thought capture" },
+    { cmd: "changelog", desc: "Show categorized release notes" },
     { cmd: "triage", desc: "Manually trigger triage of pending captures" },
     { cmd: "dispatch", desc: "Dispatch a specific phase directly" },
     { cmd: "history", desc: "View execution history" },

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

@@ -624,10 +624,14 @@ export function serializePreferencesToFrontmatter(prefs) {
     const orderedKeys = [
         "version", "mode", "always_use_skills", "prefer_skills", "avoid_skills",
         "skill_rules", "custom_instructions", "models", "skill_discovery",
-        "auto_supervisor", "uat_dispatch", "unique_milestone_ids",
+        "skill_staleness_days", "auto_supervisor", "uat_dispatch", "unique_milestone_ids",
         "budget_ceiling", "budget_enforcement", "context_pause_threshold",
         "notifications", "remote_questions", "git",
         "post_unit_hooks", "pre_dispatch_hooks",
+        "dynamic_routing", "token_profile", "phases", "parallel",
+        "auto_visualize", "auto_report",
+        "verification_commands", "verification_auto_fix", "verification_max_retries",
+        "search_provider", "compression_strategy", "context_selection",
     ];
     const seen = new Set();
     for (const key of orderedKeys) {

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

@@ -56,7 +56,7 @@ export function projectRoot() {
 }
 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|migrate|remote|steer|knowledge|new-milestone|parallel|update",
+        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|update",
         getArgumentCompletions: (prefix) => {
             const subcommands = [
                 { cmd: "help", desc: "Categorized command reference with descriptions" },
@@ -70,6 +70,7 @@ export function registerGSDCommand(pi) {
                 { cmd: "quick", desc: "Execute a quick task without full planning overhead" },
                 { cmd: "discuss", desc: "Discuss architecture and decisions" },
                 { cmd: "capture", desc: "Fire-and-forget thought capture" },
+                { cmd: "changelog", desc: "Show categorized release notes" },
                 { cmd: "triage", desc: "Manually trigger triage of pending captures" },
                 { cmd: "dispatch", desc: "Dispatch a specific phase directly" },
                 { cmd: "history", desc: "View execution history" },
@@ -448,6 +449,11 @@ export async function handleGSDCommand(args, ctx, pi) {
         await handleForensics(trimmed.replace(/^forensics\s*/, "").trim(), ctx, pi);
         return;
     }
+    if (trimmed === "changelog" || trimmed.startsWith("changelog ")) {
+        const { handleChangelog } = await import("./changelog.js");
+        await handleChangelog(trimmed.replace(/^changelog\s*/, "").trim(), ctx, pi);
+        return;
+    }
     if (trimmed === "next" || trimmed.startsWith("next ")) {
         if (trimmed.includes("--dry-run")) {
             await handleDryRun(ctx, projectRoot());
@@ -833,6 +839,7 @@ function showHelp(ctx) {
         "  /gsd visualize      Interactive 10-tab TUI (progress, timeline, deps, metrics, health, agent, changes, knowledge, captures, export)",
         "  /gsd queue          Show queued/dispatched units and execution order",
         "  /gsd history        View execution history  [--cost] [--phase] [--model] [N]",
+        "  /gsd changelog      Show categorized release notes  [version]",
         "",
         "COURSE CORRECTION",
         "  /gsd steer <desc>   Apply user override to active work",

package/dist/resources/extensions/gsd/docs/preferences-reference.md

@@ -134,6 +134,10 @@ Setting `prefer_skills: []` does **not** disable skill discovery — it just mea
   - `isolation`: `"worktree"`, `"branch"`, or `"none"` — controls auto-mode git isolation strategy. `"worktree"` creates a milestone worktree for isolated work; `"branch"` works directly in the project root but creates a milestone branch (useful for submodule-heavy repos); `"none"` works directly on the current branch with no worktree or milestone branch (ideal for step-mode with hot reloads). Default: `"worktree"`.
   - `manage_gitignore`: boolean — when `false`, GSD will not touch `.gitignore` at all. Useful when your project has a strictly managed `.gitignore` and you don't want GSD adding entries. Default: `true`.
   - `worktree_post_create`: string — script to run after a worktree is created (both auto-mode and manual `/worktree`). Receives `SOURCE_DIR` and `WORKTREE_DIR` as environment variables. Can be absolute or relative to project root. Runs with 30-second timeout. Failure is non-fatal (logged as warning). Default: none.
+  - `auto_pr`: boolean — automatically create a GitHub pull request after a milestone branch is merged. Requires `gh` CLI to be installed. Default: `false`.
+  - `pr_target_branch`: string — branch to target when `auto_pr` is enabled. Defaults to `main_branch` when omitted.
+  - **Deprecated:** `commit_docs` — no longer valid; `.gsd/` is always gitignored. Remove this setting.
+  - **Deprecated:** `merge_to_main` — no longer valid; milestone-level merge is always used. Remove this setting.
 
 - `unique_milestone_ids`: boolean — when `true`, generates milestone IDs in `M{seq}-{rand6}` format (e.g. `M001-eh88as`) instead of plain sequential `M001`. Prevents ID collisions in team workflows where multiple contributors create milestones concurrently. Both formats coexist — existing `M001`-style milestones remain valid. Default: `false`.
 
@@ -181,6 +185,12 @@ Setting `prefer_skills: []` does **not** disable skill discovery — it just mea
 
 - `auto_report`: boolean — generate an HTML report snapshot after each milestone completion. Default: `true`.
 
+- `search_provider`: `"brave"`, `"tavily"`, `"ollama"`, `"native"`, or `"auto"` — selects the search backend for research phases. `"native"` forces Anthropic's built-in web search only; provider values force that backend and disable native search; `"auto"` uses the default heuristic. Default: `"auto"`.
+
+- `compression_strategy`: `"truncate"` or `"compress"` — controls how context that exceeds the budget is reduced. `"truncate"` (default) drops sections from the end. `"compress"` applies heuristic compression before truncating, preserving more content at the cost of some fidelity. Default: `"truncate"`.
+
+- `context_selection`: `"full"` or `"smart"` — controls how files are inlined into context. `"full"` inlines entire files; `"smart"` uses semantic chunking to include only the most relevant sections. Default is derived from `token_profile`.
+
 - `parallel`: configures parallel orchestration for running multiple slices concurrently. Keys:
   - `enabled`: boolean — enable parallel execution. Default: `false`.
   - `max_workers`: number — maximum concurrent workers (1-4). Default: `2`.

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

@@ -1,13 +1,13 @@
-import { existsSync, lstatSync, readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
-import { join, sep } from "node:path";
+import { existsSync, lstatSync, readdirSync, readFileSync, realpathSync, rmSync, statSync } from "node:fs";
+import { basename, dirname, join, sep } from "node:path";
 import { loadFile, parseRoadmap } from "./files.js";
 import { resolveMilestoneFile, milestonesDir, gsdRoot, resolveGsdRootFile } from "./paths.js";
 import { deriveState, isMilestoneComplete } from "./state.js";
 import { saveFile } from "./files.js";
-import { listWorktrees, resolveGitDir } from "./worktree-manager.js";
+import { listWorktrees, resolveGitDir, worktreesDir } from "./worktree-manager.js";
 import { abortAndReset } from "./git-self-heal.js";
-import { RUNTIME_EXCLUSION_PATHS } from "./git-service.js";
-import { nativeIsRepo, nativeWorktreeRemove, nativeBranchList, nativeBranchDelete, nativeLsFiles, nativeRmCached } from "./native-git-bridge.js";
+import { RUNTIME_EXCLUSION_PATHS, readIntegrationBranch } from "./git-service.js";
+import { nativeIsRepo, nativeBranchExists, nativeWorktreeList, nativeWorktreeRemove, nativeBranchList, nativeBranchDelete, nativeLsFiles, nativeRmCached } from "./native-git-bridge.js";
 import { readCrashLock, isLockProcessAlive, clearLock } from "./crash-recovery.js";
 import { ensureGitignore } from "./gitignore.js";
 import { readAllSessionStatuses, isSessionStale, removeSessionStatus } from "./session-status-io.js";
@@ -200,6 +200,75 @@ export async function checkGitHealth(basePath, issues, fixesApplied, shouldFix,
     catch {
         // git branch list failed — skip
     }
+    // ── Integration branch existence ──────────────────────────────────────
+    // For each active (non-complete) milestone, verify the stored integration
+    // branch still exists in git. A missing integration branch blocks merge-back
+    // and causes the next merge operation to fail silently.
+    try {
+        const state = await deriveState(basePath);
+        for (const milestone of state.registry) {
+            if (milestone.status === "complete")
+                continue;
+            const integrationBranch = readIntegrationBranch(basePath, milestone.id);
+            if (!integrationBranch)
+                continue; // No stored branch — skip (not yet set)
+            if (!nativeBranchExists(basePath, integrationBranch)) {
+                issues.push({
+                    severity: "error",
+                    code: "integration_branch_missing",
+                    scope: "milestone",
+                    unitId: milestone.id,
+                    message: `Milestone ${milestone.id} recorded integration branch "${integrationBranch}" but that branch no longer exists in git. Merge-back will fail.`,
+                    fixable: false,
+                });
+            }
+        }
+    }
+    catch {
+        // Non-fatal — integration branch check failed
+    }
+    // ── Orphaned worktree directories ────────────────────────────────────
+    // Worktree removal can fail after a branch delete, leaving a directory
+    // that is no longer registered with git. These orphaned dirs cause
+    // "already exists" errors when re-creating the same worktree name.
+    try {
+        const wtDir = worktreesDir(basePath);
+        if (existsSync(wtDir)) {
+            const registeredPaths = new Set(nativeWorktreeList(basePath).map(entry => entry.path));
+            for (const entry of readdirSync(wtDir)) {
+                const fullPath = join(wtDir, entry);
+                try {
+                    if (!statSync(fullPath).isDirectory())
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+                if (!registeredPaths.has(fullPath)) {
+                    issues.push({
+                        severity: "warning",
+                        code: "worktree_directory_orphaned",
+                        scope: "project",
+                        unitId: entry,
+                        message: `Worktree directory ${fullPath} exists on disk but is not registered with git. Run "git worktree prune" or doctor --fix to remove it.`,
+                        fixable: true,
+                    });
+                    if (shouldFix("worktree_directory_orphaned")) {
+                        try {
+                            rmSync(fullPath, { recursive: true, force: true });
+                            fixesApplied.push(`removed orphaned worktree directory ${fullPath}`);
+                        }
+                        catch {
+                            fixesApplied.push(`failed to remove orphaned worktree directory ${fullPath}`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // Non-fatal — orphaned worktree directory check failed
+    }
 }
 // ── Runtime Health Checks ──────────────────────────────────────────────────
 // Checks for stale crash locks, orphaned completed-units, stale hook state,
@@ -231,6 +300,45 @@ export async function checkRuntimeHealth(basePath, issues, fixesApplied, shouldF
     catch {
         // Non-fatal — crash lock check failed
     }
+    // ── Stranded lock directory ────────────────────────────────────────────
+    // proper-lockfile creates a `.gsd.lock/` directory as the OS-level lock
+    // mechanism. If the process was SIGKILLed or crashed hard, this directory
+    // can remain on disk without any live process holding it. The next session
+    // fails to acquire the lock until the directory is removed (#1245).
+    try {
+        const lockDir = join(dirname(root), `${basename(root)}.lock`);
+        if (existsSync(lockDir)) {
+            const statRes = statSync(lockDir);
+            if (statRes.isDirectory()) {
+                // Check if any live process actually holds this lock
+                const lock = readCrashLock(basePath);
+                const lockHolderAlive = lock ? isLockProcessAlive(lock) : false;
+                if (!lockHolderAlive) {
+                    issues.push({
+                        severity: "error",
+                        code: "stranded_lock_directory",
+                        scope: "project",
+                        unitId: "project",
+                        message: `Stranded lock directory "${lockDir}" exists but no live process holds the session lock. This blocks new auto-mode sessions from starting.`,
+                        file: lockDir,
+                        fixable: true,
+                    });
+                    if (shouldFix("stranded_lock_directory")) {
+                        try {
+                            rmSync(lockDir, { recursive: true, force: true });
+                            fixesApplied.push(`removed stranded lock directory ${lockDir}`);
+                        }
+                        catch {
+                            fixesApplied.push(`failed to remove stranded lock directory ${lockDir}`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // Non-fatal — stranded lock directory check failed
+    }
     // ── Stale parallel sessions ────────────────────────────────────────────
     try {
         const parallelStatuses = readAllSessionStatuses(basePath);

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

@@ -19,6 +19,9 @@ import { gsdRoot, resolveGsdRootFile } from "./paths.js";
 import { readCrashLock, isLockProcessAlive, clearLock } from "./crash-recovery.js";
 import { abortAndReset } from "./git-self-heal.js";
 import { rebuildState } from "./doctor.js";
+import { deriveState } from "./state.js";
+import { readIntegrationBranch } from "./git-service.js";
+import { nativeBranchExists, nativeIsRepo } from "./native-git-bridge.js";
 /** In-memory health history for the current auto-mode session. */
 let healthHistory = [];
 /** Count of consecutive units with unresolved errors. */
@@ -156,6 +159,25 @@ export async function preDispatchHealthGate(basePath) {
     catch {
         // Non-fatal — dispatch continues without STATE.md if rebuild fails
     }
+    // ── Integration branch existence check ──
+    // If the active milestone's recorded integration branch no longer exists in
+    // git, the merge-back at the end of the milestone will fail. Block dispatch
+    // now to surface this before work is lost.
+    try {
+        if (nativeIsRepo(basePath)) {
+            const state = await deriveState(basePath);
+            if (state.activeMilestone) {
+                const integrationBranch = readIntegrationBranch(basePath, state.activeMilestone.id);
+                if (integrationBranch && !nativeBranchExists(basePath, integrationBranch)) {
+                    issues.push(`Integration branch "${integrationBranch}" for milestone ${state.activeMilestone.id} no longer exists in git. ` +
+                        `Restore the branch or update the integration branch before dispatching. Run /gsd doctor for details.`);
+                }
+            }
+        }
+    }
+    catch {
+        // Non-fatal — dispatch continues if state/branch check fails
+    }
     // If we had critical issues that couldn't be auto-healed, block dispatch
     if (issues.length > 0) {
         return {

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

@@ -8,6 +8,7 @@ import { loadEffectiveGSDPreferences } from "./preferences.js";
 import { COMPLETION_TRANSITION_CODES } from "./doctor-types.js";
 import { checkGitHealth, checkRuntimeHealth } from "./doctor-checks.js";
 import { checkEnvironmentHealth } from "./doctor-environment.js";
+import { runProviderChecks } from "./doctor-providers.js";
 export { summarizeDoctorIssues, filterDoctorIssues, formatDoctorReport, formatDoctorIssuesForPrompt } from "./doctor-format.js";
 export { runEnvironmentChecks, runFullEnvironmentChecks, formatEnvironmentReport } from "./doctor-environment.js";
 export { computeProgressScore, computeProgressScoreWithContext, formatProgressLine, formatProgressReport } from "./progress-score.js";
@@ -373,6 +374,41 @@ export async function runGSDDoctor(basePath, options) {
     const requirementsContent = await loadFile(requirementsPath);
     issues.push(...auditRequirements(requirementsContent));
     const state = await deriveState(basePath);
+    // Provider / auth health checks — only relevant when there is active work to dispatch.
+    // Skipped for idle projects (no active milestone) to avoid noise in environments
+    // where CI/test runners have no API key configured.
+    if (state.activeMilestone) {
+        try {
+            const providerResults = runProviderChecks();
+            for (const result of providerResults) {
+                if (!result.required)
+                    continue;
+                if (result.status === "error") {
+                    issues.push({
+                        severity: "warning",
+                        code: "provider_key_missing",
+                        scope: "project",
+                        unitId: "project",
+                        message: result.message + (result.detail ? ` — ${result.detail}` : ""),
+                        fixable: false,
+                    });
+                }
+                else if (result.status === "warning") {
+                    issues.push({
+                        severity: "warning",
+                        code: "provider_key_backedoff",
+                        scope: "project",
+                        unitId: "project",
+                        message: result.message + (result.detail ? ` — ${result.detail}` : ""),
+                        fixable: false,
+                    });
+                }
+            }
+        }
+        catch {
+            // Non-fatal — provider check failure should not block other checks
+        }
+    }
     for (const milestone of state.registry) {
         const milestoneId = milestone.id;
         const milestonePath = resolveMilestonePath(basePath, milestoneId);

package/dist/resources/extensions/gsd/guided-flow.js

@@ -661,9 +661,11 @@ export async function showSmartEntry(ctx, pi, basePath, options) {
     untrackRuntimeFiles(basePath);
     // ── Self-heal stale runtime records from crashed auto-mode sessions ──
     selfHealRuntimeRecords(basePath, ctx);
-    // Check for crash from previous auto-mode session
+    // Check for crash from previous auto-mode session.
+    // Skip if the lock was written by the current process — acquireSessionLock()
+    // writes to the same file, so we'd always false-positive (#1398).
     const crashLock = readCrashLock(basePath);
-    if (crashLock) {
+    if (crashLock && crashLock.pid !== process.pid) {
         clearLock(basePath);
         // Bootstrap crash with zero completed units = no work was lost.
         // Auto-discard instead of prompting the user — this commonly happens

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

@@ -603,5 +603,43 @@ export function validatePreferences(preferences) {
             validated.git = git;
         }
     }
+    // ─── Auto Visualize ─────────────────────────────────────────────────
+    if (preferences.auto_visualize !== undefined) {
+        if (typeof preferences.auto_visualize === "boolean") {
+            validated.auto_visualize = preferences.auto_visualize;
+        }
+        else {
+            errors.push("auto_visualize must be a boolean");
+        }
+    }
+    // ─── Auto Report ────────────────────────────────────────────────────
+    if (preferences.auto_report !== undefined) {
+        if (typeof preferences.auto_report === "boolean") {
+            validated.auto_report = preferences.auto_report;
+        }
+        else {
+            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"]);
+        if (typeof preferences.context_selection === "string" && validModes.has(preferences.context_selection)) {
+            validated.context_selection = preferences.context_selection;
+        }
+        else {
+            errors.push(`context_selection must be one of: full, smart`);
+        }
+    }
     return { preferences: validated, errors, warnings };
 }

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

@@ -186,6 +186,8 @@ function mergePreferences(base, override) {
         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,
     };
 }
 function mergeStringLists(base, override) {

package/dist/resources/extensions/mcp-client/index.js

@@ -280,7 +280,8 @@ export default function (pi) {
             tool: Type.String({
                 description: "Tool name on that server, e.g. 'railway_list_projects'",
             }),
-            args: Type.Optional(Type.Record(Type.String(), Type.Unknown(), {
+            args: Type.Optional(Type.Object({}, {
+                additionalProperties: true,
                 description: "Tool arguments as key-value pairs matching the tool's input schema",
             })),
         }),

package/dist/resources/skills/create-gsd-extension/references/events-reference.md

@@ -61,10 +61,10 @@ pi.on("tool_call", async (event, ctx) => {
 
 **tool_result** — Fired after tool executes. Can modify result. Handlers chain like middleware.
 ```typescript
-import { isBashToolResult } from "@mariozechner/pi-coding-agent";
+import { isToolResultEventType } from "@mariozechner/pi-coding-agent";
 
 pi.on("tool_result", async (event, ctx) => {
-  if (isBashToolResult(event)) {
+  if (isToolResultEventType("bash", event)) {
     // event.details is typed as BashToolDetails
   }
   // Return partial patch: { content, details, isError }
@@ -105,7 +105,7 @@ pi.on("model_select", async (event, ctx) => {
 Built-in type guards for tool events:
 
 ```typescript
-import { isToolCallEventType, isBashToolResult } from "@mariozechner/pi-coding-agent";
+import { isToolCallEventType, isToolResultEventType } from "@mariozechner/pi-coding-agent";
 
 // Tool calls — narrows event.input type
 if (isToolCallEventType("bash", event)) { /* event.input: { command, timeout? } */ }
@@ -114,7 +114,7 @@ if (isToolCallEventType("write", event)) { /* event.input: { path, content } */
 if (isToolCallEventType("edit", event)) { /* event.input: { path, oldText, newText } */ }
 
 // Tool results — narrows event.details type
-if (isBashToolResult(event)) { /* event.details: BashToolDetails */ }
+if (isToolResultEventType("bash", event)) { /* event.details: BashToolDetails */ }
 ```
 
 For custom tools, export your input type and use explicit type params:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-pi",
-  "version": "2.34.0",
+  "version": "2.35.0-dev.cd3b7ea",
   "description": "GSD — Get Shit Done coding agent",
   "license": "MIT",
   "repository": {

package/packages/native/dist/native.d.ts

@@ -55,5 +55,3 @@ export declare const native: {
     parseStreamingJson: (text: string) => unknown;
     xxHash32: (input: string, seed: number) => number;
 };
-/** True when the native addon loaded successfully. False on unsupported platforms. */
-export declare const nativeAvailable = false;

package/packages/native/dist/native.js

@@ -74,5 +74,3 @@ function loadNative() {
     });
 }
 export const native = loadNative();
-/** True when the native addon loaded successfully. False on unsupported platforms. */
-export const nativeAvailable = _loadedSuccessfully;

package/packages/native/src/native.ts

@@ -151,6 +151,3 @@ export const native = loadNative() as {
   parseStreamingJson: (text: string) => unknown;
   xxHash32: (input: string, seed: number) => number;
 };
-
-/** True when the native addon loaded successfully. False on unsupported platforms. */
-export const nativeAvailable = _loadedSuccessfully;

package/packages/pi-agent-core/dist/agent-loop.d.ts

@@ -4,6 +4,20 @@
  */
 import { EventStream } from "@gsd/pi-ai";
 import type { AgentContext, AgentEvent, AgentLoopConfig, AgentMessage, StreamFn } from "./types.js";
+export declare const ZERO_USAGE: {
+    readonly input: 0;
+    readonly output: 0;
+    readonly cacheRead: 0;
+    readonly cacheWrite: 0;
+    readonly totalTokens: 0;
+    readonly cost: {
+        readonly input: 0;
+        readonly output: 0;
+        readonly cacheRead: 0;
+        readonly cacheWrite: 0;
+        readonly total: 0;
+    };
+};
 /**
  * Start an agent loop with a new prompt message.
  * The prompt is added to the context and events are emitted for it.