gsd-pi 2.41.0-dev.cac69f9 → 2.42.0-dev.1df898f

package/README.md

@@ -24,6 +24,29 @@ One command. Walk away. Come back to a built project with clean git history.
 
 ---
 
+## What's New in v2.42.0
+
+### New Features
+
+- **Declarative workflow engine** — define YAML workflows that execute through auto-loop, enabling repeatable multi-step automations without code. (#2024)
+- **Unified rule registry & event journal** — centralized rule registry, event journal with query tool, and standardized tool naming convention. (#1928)
+- **PR risk checker** — CI classifies changed files by system area and surfaces risk level on pull requests. (#1930)
+- **`/gsd fast`** — toggle service tier for supported models, enabling prioritized API routing for faster responses. (#1862)
+- **Web mode CLI flags** — `--host`, `--port`, and `--allowed-origins` flags give full control over the web server bind address and CORS policy. (#1873)
+- **ADR attribution** — architecture decision records now distinguish human, agent, and collaborative authorship. (#1830)
+
+### Key Fixes
+
+- **Node v24 web boot** — resolved `ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING` that prevented `gsd --web` from starting on Node v24. (#1864)
+- **Worktree health check for all ecosystems** — broadened from JS-only to 17+ ecosystems (Rust, Go, Python, Java, etc.). (#1860)
+- **Doctor roadmap atomicity** — roadmap checkbox gating now checks summary on disk, not issue detection, preventing false unchecks. (#1915)
+- **Windows path handling** — 8.3 short path resolution, backslash normalization in bash commands, PowerShell browser launch, and parenthesis escaping. (#1960, #1863, #1870, #1872)
+- **Auth token persistence** — web UI auth token survives page refreshes via sessionStorage. (#1877)
+- **German/non-English locale git errors** — git commands now force `LC_ALL=C` to prevent locale-dependent parse failures.
+- **Orphan web server process** — stale web server processes on port 3000 are now cleaned up automatically.
+
+---
+
 ## What's New in v2.41.0
 
 ### New Features

package/dist/cli.js

@@ -14,6 +14,14 @@ import { parseCliArgs as parseWebCliArgs, runWebCliBranch, migrateLegacyFlatSess
 import { stopWebMode } from './web-mode.js';
 import { getProjectSessionsDir } from './project-sessions.js';
 import { markStartup, printStartupTimings } from './startup-timings.js';
+// ---------------------------------------------------------------------------
+// V8 compile cache — Node 22+ can cache compiled bytecode across runs,
+// eliminating repeated parse/compile overhead for unchanged modules.
+// Must be set early so dynamic imports (extensions, lazy subcommands) benefit.
+// ---------------------------------------------------------------------------
+if (parseInt(process.versions.node) >= 22) {
+    process.env.NODE_COMPILE_CACHE ??= join(agentDir, '.compile-cache');
+}
 function exitIfManagedResourcesAreNewer(currentAgentDir) {
     const currentVersion = process.env.GSD_VERSION || '0.0.0';
     const managedVersion = getNewerManagedResourceVersion(currentAgentDir, currentVersion);
@@ -461,8 +469,14 @@ const sessionManager = cliFlags._selectedSessionPath
 exitIfManagedResourcesAreNewer(agentDir);
 initResources(agentDir);
 markStartup('initResources');
+// Overlap resource loading with session manager setup — both are independent.
+// resourceLoader.reload() is the most expensive step (jiti compilation), so
+// starting it early shaves ~50-200ms off interactive startup.
 const resourceLoader = buildResourceLoader(agentDir);
-await resourceLoader.reload();
+const resourceLoadPromise = resourceLoader.reload();
+// While resources load, let session manager finish any async I/O it needs.
+// Then await the resource promise before creating the agent session.
+await resourceLoadPromise;
 markStartup('resourceLoader.reload');
 const { session, extensionsResult } = await createAgentSession({
     authStorage,
@@ -530,8 +544,9 @@ if (!process.stdin.isTTY) {
     process.stderr.write('[gsd]   gsd --mode text "message"      Text output mode\n');
     process.exit(1);
 }
-// Welcome screen — shown on every fresh interactive session before TUI takes over
-{
+// Welcome screen — shown on every fresh interactive session before TUI takes over.
+// Skip when the first-run banner was already printed in loader.ts (prevents double banner).
+if (!process.env.GSD_FIRST_RUN_BANNER) {
     const { printWelcomeScreen } = await import('./welcome-screen.js');
     printWelcomeScreen({
         version: process.env.GSD_VERSION || '0.0.0',

package/dist/loader.js

@@ -42,7 +42,8 @@ const pkgDir = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'pkg');
 process.env.PI_PACKAGE_DIR = pkgDir;
 process.env.PI_SKIP_VERSION_CHECK = '1'; // GSD runs its own update check in cli.ts — suppress pi's
 process.title = 'gsd';
-// Print branded banner on first launch (before ~/.gsd/ exists)
+// Print branded banner on first launch (before ~/.gsd/ exists).
+// Set GSD_FIRST_RUN_BANNER so cli.ts skips the duplicate welcome screen.
 if (!existsSync(appRoot)) {
     const cyan = '\x1b[36m';
     const green = '\x1b[32m';
@@ -53,6 +54,7 @@ if (!existsSync(appRoot)) {
         '\n' +
         `  Get Shit Done ${dim}v${gsdVersion}${reset}\n` +
         `  ${green}Welcome.${reset} Setting up your environment...\n\n`);
+    process.env.GSD_FIRST_RUN_BANNER = '1';
 }
 // GSD_CODING_AGENT_DIR — tells pi's getAgentDir() to return ~/.gsd/agent/ instead of ~/.gsd/agent/
 process.env.GSD_CODING_AGENT_DIR = agentDir;

package/dist/resource-loader.js

@@ -48,14 +48,25 @@ function getBundledGsdVersion() {
     }
 }
 function writeManagedResourceManifest(agentDir) {
-    // Record root-level files currently in the bundled extensions source so that
-    // future upgrades can detect and prune any that get removed or moved.
+    // Record root-level files and subdirectory extension names currently in the
+    // bundled extensions source so that future upgrades can detect and prune any
+    // that get removed or moved.
     let installedExtensionRootFiles = [];
+    let installedExtensionDirs = [];
     try {
         if (existsSync(bundledExtensionsDir)) {
-            installedExtensionRootFiles = readdirSync(bundledExtensionsDir, { withFileTypes: true })
+            const entries = readdirSync(bundledExtensionsDir, { withFileTypes: true });
+            installedExtensionRootFiles = entries
                 .filter(e => e.isFile())
                 .map(e => e.name);
+            installedExtensionDirs = entries
+                .filter(e => e.isDirectory())
+                .filter(e => {
+                // Only track directories that are actual extensions (contain index.js or index.ts)
+                const dirPath = join(bundledExtensionsDir, e.name);
+                return existsSync(join(dirPath, 'index.js')) || existsSync(join(dirPath, 'index.ts'));
+            })
+                .map(e => e.name);
         }
     }
     catch { /* non-fatal */ }
@@ -64,6 +75,7 @@ function writeManagedResourceManifest(agentDir) {
         syncedAt: Date.now(),
         contentHash: computeResourceFingerprint(),
         installedExtensionRootFiles,
+        installedExtensionDirs,
     };
     writeFileSync(getManagedResourceManifestPath(agentDir), JSON.stringify(manifest));
 }
@@ -284,16 +296,20 @@ function pruneRemovedBundledExtensions(manifest, agentDir) {
         return;
     // Current bundled root-level files (what the new version provides)
     const currentSourceFiles = new Set();
+    // Current bundled subdirectory extensions
+    const currentSourceDirs = new Set();
     try {
         if (existsSync(bundledExtensionsDir)) {
             for (const e of readdirSync(bundledExtensionsDir, { withFileTypes: true })) {
                 if (e.isFile())
                     currentSourceFiles.add(e.name);
+                if (e.isDirectory())
+                    currentSourceDirs.add(e.name);
             }
         }
     }
     catch { /* non-fatal */ }
-    const removeIfStale = (fileName) => {
+    const removeFileIfStale = (fileName) => {
         if (currentSourceFiles.has(fileName))
             return; // still in bundle, not stale
         const stale = join(extensionsDir, fileName);
@@ -303,17 +319,33 @@ function pruneRemovedBundledExtensions(manifest, agentDir) {
         }
         catch { /* non-fatal */ }
     };
+    const removeDirIfStale = (dirName) => {
+        if (currentSourceDirs.has(dirName))
+            return; // still in bundle, not stale
+        const stale = join(extensionsDir, dirName);
+        try {
+            if (existsSync(stale))
+                rmSync(stale, { recursive: true, force: true });
+        }
+        catch { /* non-fatal */ }
+    };
     if (manifest?.installedExtensionRootFiles) {
         // Manifest-based: remove previously-installed root files that are no longer bundled
         for (const prevFile of manifest.installedExtensionRootFiles) {
-            removeIfStale(prevFile);
+            removeFileIfStale(prevFile);
+        }
+    }
+    if (manifest?.installedExtensionDirs) {
+        // Manifest-based: remove previously-installed subdirectory extensions that are no longer bundled
+        for (const prevDir of manifest.installedExtensionDirs) {
+            removeDirIfStale(prevDir);
         }
     }
     // Always remove known stale files regardless of manifest state.
     // These were installed by pre-manifest versions so they may not appear in
     // installedExtensionRootFiles even when a manifest exists.
     // env-utils.js was moved from extensions/ root → gsd/ in v2.39.x (#1634)
-    removeIfStale('env-utils.js');
+    removeFileIfStale('env-utils.js');
 }
 /**
  * Syncs all bundled resources to agentDir (~/.gsd/agent/) on every launch.
@@ -416,5 +448,6 @@ export function buildResourceLoader(agentDir) {
     return new DefaultResourceLoader({
         agentDir,
         additionalExtensionPaths: piExtensionPaths,
+        bundledExtensionNames: bundledKeys,
     });
 }

package/dist/resources/extensions/async-jobs/async-bash-tool.js

@@ -83,6 +83,15 @@ export function createAsyncBashTool(getManager, getCwd) {
  */
 function executeBashInBackground(command, cwd, signal, timeout) {
     return new Promise((resolve, reject) => {
+        let settled = false;
+        const safeResolve = (value) => { if (!settled) {
+            settled = true;
+            resolve(value);
+        } };
+        const safeReject = (err) => { if (!settled) {
+            settled = true;
+            reject(err);
+        } };
         const { shell, args } = getShellConfig();
         const resolvedCommand = sanitizeCommand(command);
         const child = spawn(shell, [...args, resolvedCommand], {
@@ -93,11 +102,42 @@ function executeBashInBackground(command, cwd, signal, timeout) {
         });
         let timedOut = false;
         let timeoutHandle;
+        let sigkillHandle;
+        let hardDeadlineHandle;
+        /** Grace period (ms) between SIGTERM and SIGKILL. */
+        const SIGKILL_GRACE_MS = 5_000;
+        /** Hard deadline (ms) after SIGKILL to force-resolve the promise. */
+        const HARD_DEADLINE_MS = 3_000;
         if (timeout !== undefined && timeout > 0) {
             timeoutHandle = setTimeout(() => {
                 timedOut = true;
                 if (child.pid)
                     killTree(child.pid);
+                // If the process ignores SIGTERM, escalate to SIGKILL
+                sigkillHandle = setTimeout(() => {
+                    if (child.pid) {
+                        try {
+                            process.kill(-child.pid, "SIGKILL");
+                        }
+                        catch { /* ignore */ }
+                        try {
+                            process.kill(child.pid, "SIGKILL");
+                        }
+                        catch { /* ignore */ }
+                    }
+                    // Hard deadline: if even SIGKILL doesn't trigger 'close',
+                    // force-resolve so the job doesn't hang forever (#2186).
+                    hardDeadlineHandle = setTimeout(() => {
+                        const output = Buffer.concat(chunks).toString("utf-8");
+                        safeResolve(output
+                            ? `${output}\n\nCommand timed out after ${timeout} seconds (force-killed)`
+                            : `Command timed out after ${timeout} seconds (force-killed)`);
+                    }, HARD_DEADLINE_MS);
+                    if (typeof hardDeadlineHandle === "object" && "unref" in hardDeadlineHandle)
+                        hardDeadlineHandle.unref();
+                }, SIGKILL_GRACE_MS);
+                if (typeof sigkillHandle === "object" && "unref" in sigkillHandle)
+                    sigkillHandle.unref();
             }, timeout * 1000);
         }
         const chunks = [];
@@ -139,23 +179,31 @@ function executeBashInBackground(command, cwd, signal, timeout) {
         child.on("error", (err) => {
             if (timeoutHandle)
                 clearTimeout(timeoutHandle);
+            if (sigkillHandle)
+                clearTimeout(sigkillHandle);
+            if (hardDeadlineHandle)
+                clearTimeout(hardDeadlineHandle);
             signal.removeEventListener("abort", onAbort);
-            reject(err);
+            safeReject(err);
         });
         child.on("close", (code) => {
             if (timeoutHandle)
                 clearTimeout(timeoutHandle);
+            if (sigkillHandle)
+                clearTimeout(sigkillHandle);
+            if (hardDeadlineHandle)
+                clearTimeout(hardDeadlineHandle);
             signal.removeEventListener("abort", onAbort);
             if (spillStream)
                 spillStream.end();
             if (signal.aborted) {
                 const output = Buffer.concat(chunks).toString("utf-8");
-                resolve(output ? `${output}\n\nCommand aborted` : "Command aborted");
+                safeResolve(output ? `${output}\n\nCommand aborted` : "Command aborted");
                 return;
             }
             if (timedOut) {
                 const output = Buffer.concat(chunks).toString("utf-8");
-                resolve(output ? `${output}\n\nCommand timed out after ${timeout} seconds` : `Command timed out after ${timeout} seconds`);
+                safeResolve(output ? `${output}\n\nCommand timed out after ${timeout} seconds` : `Command timed out after ${timeout} seconds`);
                 return;
             }
             const fullOutput = Buffer.concat(chunks).toString("utf-8");
@@ -176,7 +224,7 @@ function executeBashInBackground(command, cwd, signal, timeout) {
             if (code !== 0 && code !== null) {
                 text += `\n\nCommand exited with code ${code}`;
             }
-            resolve(text);
+            safeResolve(text);
         });
     });
 }

package/dist/resources/extensions/async-jobs/await-tool.js

@@ -54,6 +54,11 @@ export function createAwaitTool(getManager) {
                     };
                 }
             }
+            // Mark all watched jobs as awaited upfront so the onJobComplete
+            // callback (which fires synchronously in the promise .then()) knows
+            // to suppress the follow-up message.
+            for (const j of watched)
+                j.awaited = true;
             // If all watched jobs are already done, return immediately
             const running = watched.filter((j) => j.status === "running");
             if (running.length === 0) {

package/dist/resources/extensions/async-jobs/index.js

@@ -34,6 +34,8 @@ export default function AsyncJobs(pi) {
         latestCwd = ctx.cwd;
         manager = new AsyncJobManager({
             onJobComplete: (job) => {
+                if (job.awaited)
+                    return;
                 const statusEmoji = job.status === "completed" ? "done" : "error";
                 const elapsed = ((Date.now() - job.startTime) / 1000).toFixed(1);
                 const output = job.status === "completed"

package/dist/resources/extensions/gsd/auto/loop.js

@@ -12,6 +12,7 @@ import { _clearCurrentResolve } from "./resolve.js";
 import { runPreDispatch, runDispatch, runGuards, runUnitPhase, runFinalize, } from "./phases.js";
 import { debugLog } from "../debug-logger.js";
 import { isInfrastructureError } from "./infra-errors.js";
+import { resolveEngine } from "../engine-resolver.js";
 /**
  * Main auto-mode execution loop. Iterates: derive → dispatch → guards →
  * runUnit → finalize → repeat. Exits when s.active becomes false or a
@@ -82,6 +83,85 @@ export async function autoLoop(ctx, pi, s, deps) {
             const ic = { ctx, pi, s, deps, prefs, iteration, flowId, nextSeq };
             deps.emitJournalEvent({ ts: new Date().toISOString(), flowId, seq: nextSeq(), eventType: "iteration-start", data: { iteration } });
             let iterData;
+            // ── Custom engine path ──────────────────────────────────────────────
+            // When activeEngineId is a non-dev value, bypass runPreDispatch and
+            // runDispatch entirely — the custom engine drives its own state via
+            // GRAPH.yaml. Shares runGuards and runUnitPhase with the dev path.
+            // After unit execution, verifies then reconciles via the engine layer.
+            //
+            // GSD_ENGINE_BYPASS=1 skips the engine layer entirely — falls through
+            // to the dev path below.
+            if (s.activeEngineId != null && s.activeEngineId !== "dev" && !sidecarItem && process.env.GSD_ENGINE_BYPASS !== "1") {
+                debugLog("autoLoop", { phase: "custom-engine-derive", iteration, engineId: s.activeEngineId });
+                const { engine, policy } = resolveEngine({
+                    activeEngineId: s.activeEngineId,
+                    activeRunDir: s.activeRunDir,
+                });
+                const engineState = await engine.deriveState(s.basePath);
+                if (engineState.isComplete) {
+                    await deps.stopAuto(ctx, pi, "Workflow complete");
+                    break;
+                }
+                debugLog("autoLoop", { phase: "custom-engine-dispatch", iteration });
+                const dispatch = await engine.resolveDispatch(engineState, { basePath: s.basePath });
+                if (dispatch.action === "stop") {
+                    await deps.stopAuto(ctx, pi, dispatch.reason ?? "Engine stopped");
+                    break;
+                }
+                if (dispatch.action === "skip") {
+                    continue;
+                }
+                // dispatch.action === "dispatch"
+                const step = dispatch.step;
+                const gsdState = await deps.deriveState(s.basePath);
+                iterData = {
+                    unitType: step.unitType,
+                    unitId: step.unitId,
+                    prompt: step.prompt,
+                    finalPrompt: step.prompt,
+                    pauseAfterUatDispatch: false,
+                    observabilityIssues: [],
+                    state: gsdState,
+                    mid: s.currentMilestoneId ?? "workflow",
+                    midTitle: "Workflow",
+                    isRetry: false,
+                    previousTier: undefined,
+                };
+                // ── Progress widget (mirrors dev path in runDispatch) ──
+                deps.updateProgressWidget(ctx, iterData.unitType, iterData.unitId, iterData.state);
+                // ── Guards (shared with dev path) ──
+                const guardsResult = await runGuards(ic, s.currentMilestoneId ?? "workflow");
+                if (guardsResult.action === "break")
+                    break;
+                // ── Unit execution (shared with dev path) ──
+                const unitPhaseResult = await runUnitPhase(ic, iterData, loopState);
+                if (unitPhaseResult.action === "break")
+                    break;
+                // ── Verify first, then reconcile (only mark complete on pass) ──
+                debugLog("autoLoop", { phase: "custom-engine-verify", iteration, unitId: iterData.unitId });
+                const verifyResult = await policy.verify(iterData.unitType, iterData.unitId, { basePath: s.basePath });
+                if (verifyResult === "pause") {
+                    await deps.pauseAuto(ctx, pi);
+                    break;
+                }
+                if (verifyResult === "retry") {
+                    debugLog("autoLoop", { phase: "custom-engine-verify-retry", iteration, unitId: iterData.unitId });
+                    continue;
+                }
+                // Verification passed — mark step complete
+                debugLog("autoLoop", { phase: "custom-engine-reconcile", iteration, unitId: iterData.unitId });
+                await engine.reconcile(engineState, {
+                    unitType: iterData.unitType,
+                    unitId: iterData.unitId,
+                    startedAt: s.currentUnit?.startedAt ?? Date.now(),
+                    finishedAt: Date.now(),
+                });
+                deps.clearUnitTimeout();
+                consecutiveErrors = 0;
+                deps.emitJournalEvent({ ts: new Date().toISOString(), flowId, seq: nextSeq(), eventType: "iteration-end", data: { iteration } });
+                debugLog("autoLoop", { phase: "iteration-complete", iteration });
+                continue;
+            }
             if (!sidecarItem) {
                 // ── Phase 1: Pre-dispatch ─────────────────────────────────────────
                 const preDispatchResult = await runPreDispatch(ic, loopState);

package/dist/resources/extensions/gsd/auto/phases.js

@@ -165,9 +165,7 @@ export async function runPreDispatch(ic, loopState) {
         midTitle = state.activeMilestone?.title;
         if (mid) {
             if (deps.getIsolationMode() !== "none") {
-                deps.captureIntegrationBranch(s.basePath, mid, {
-                    commitDocs: prefs?.git?.commit_docs,
-                });
+                deps.captureIntegrationBranch(s.basePath, mid);
             }
             deps.resolver.enterMilestone(mid, ctx.ui);
         }
@@ -776,8 +774,8 @@ export async function runUnitPhase(ic, iterData, loopState, sidecarItem) {
     if (s.currentUnitRouting) {
         deps.recordOutcome(unitType, s.currentUnitRouting.tier, true);
     }
-    const isHookUnit = unitType.startsWith("hook/");
-    const artifactVerified = isHookUnit ||
+    const skipArtifactVerification = unitType.startsWith("hook/") || unitType === "custom-step";
+    const artifactVerified = skipArtifactVerification ||
         deps.verifyExpectedArtifact(unitType, unitId, s.basePath);
     if (artifactVerified) {
         s.completedUnits.push({

package/dist/resources/extensions/gsd/auto/session.js

@@ -27,6 +27,8 @@ export class AutoSession {
     paused = false;
     stepMode = false;
     verbose = false;
+    activeEngineId = null;
+    activeRunDir = null;
     cmdCtx = null;
     // ── Paths ────────────────────────────────────────────────────────────────
     basePath = "";
@@ -113,6 +115,8 @@ export class AutoSession {
         this.paused = false;
         this.stepMode = false;
         this.verbose = false;
+        this.activeEngineId = null;
+        this.activeRunDir = null;
         this.cmdCtx = null;
         // Paths
         this.basePath = "";
@@ -156,6 +160,8 @@ export class AutoSession {
             paused: this.paused,
             stepMode: this.stepMode,
             basePath: this.basePath,
+            activeEngineId: this.activeEngineId,
+            activeRunDir: this.activeRunDir,
             currentMilestoneId: this.currentMilestoneId,
             currentUnit: this.currentUnit,
             completedUnits: this.completedUnits.length,

package/dist/resources/extensions/gsd/auto-dashboard.js

@@ -46,6 +46,7 @@ export function unitVerb(unitType) {
         case "rewrite-docs": return "rewriting";
         case "reassess-roadmap": return "reassessing";
         case "run-uat": return "running UAT";
+        case "custom-step": return "executing workflow step";
         default: return unitType;
     }
 }
@@ -64,6 +65,7 @@ export function unitPhaseLabel(unitType) {
         case "rewrite-docs": return "REWRITE";
         case "reassess-roadmap": return "REASSESS";
         case "run-uat": return "UAT";
+        case "custom-step": return "WORKFLOW";
         default: return unitType.toUpperCase();
     }
 }

package/dist/resources/extensions/gsd/auto-prompts.js

@@ -337,7 +337,7 @@ function formatSkillActivationBlock(skillNames) {
 }
 export function buildSkillActivationBlock(params) {
     const prefs = params.preferences ?? loadEffectiveGSDPreferences()?.preferences;
-    const contextTokens = tokenizeSkillContext(params.milestoneId, params.milestoneTitle, params.sliceId, params.sliceTitle, params.taskId, params.taskTitle, ...(params.extraContext ?? []), params.taskPlanContent ?? undefined);
+    const contextTokens = tokenizeSkillContext(params.milestoneId, params.milestoneTitle, params.sliceId, params.sliceTitle, params.taskId, params.taskTitle);
     const visibleSkills = (typeof getLoadedSkills === 'function' ? getLoadedSkills() : []).filter(skill => !skill.disableModelInvocation);
     const installedNames = new Set(visibleSkills.map(skill => normalizeSkillReference(skill.name)));
     const avoided = new Set(resolvePreferenceSkillNames(prefs?.avoid_skills ?? [], params.base));
@@ -364,11 +364,6 @@ export function buildSkillActivationBlock(params) {
             // Non-fatal — malformed task plan should not break prompt construction
         }
     }
-    for (const skill of visibleSkills) {
-        if (skillMatchesContext(skill, contextTokens)) {
-            matched.add(normalizeSkillReference(skill.name));
-        }
-    }
     const ordered = [...matched]
         .filter(name => installedNames.has(name) && !avoided.has(name))
         .sort();
@@ -846,11 +841,7 @@ export async function buildPlanSlicePrompt(mid, _midTitle, sid, sTitle, base, le
     // Build executor context constraints from the budget engine
     const executorContextConstraints = formatExecutorConstraints();
     const outputRelPath = relSliceFile(base, mid, sid, "PLAN");
-    const prefs = loadEffectiveGSDPreferences();
-    const commitDocsEnabled = prefs?.preferences?.git?.commit_docs !== false;
-    const commitInstruction = commitDocsEnabled
-        ? `Commit the plan files only: \`git add ${relSlicePath(base, mid, sid)}/ .gsd/DECISIONS.md .gitignore && git commit -m "docs(${sid}): add slice plan"\`. Do not stage .gsd/STATE.md or other runtime files — the system manages those.`
-        : "Do not commit — planning docs are not tracked in git for this project.";
+    const commitInstruction = "Do not commit — .gsd/ planning docs are managed externally and not tracked in git.";
     return loadPrompt("plan-slice", {
         workingDirectory: base,
         milestoneId: mid, sliceId: sid, sliceTitle: sTitle,
@@ -1281,11 +1272,7 @@ export async function buildReassessRoadmapPrompt(mid, midTitle, completedSliceId
     catch {
         // Non-fatal — captures module may not be available
     }
-    const reassessPrefs = loadEffectiveGSDPreferences();
-    const reassessCommitDocsEnabled = reassessPrefs?.preferences?.git?.commit_docs !== false;
-    const reassessCommitInstruction = reassessCommitDocsEnabled
-        ? `Commit: \`docs(${mid}): reassess roadmap after ${completedSliceId}\`. Stage only the .gsd/milestones/ files you changed — do not stage .gsd/STATE.md or other runtime files.`
-        : "Do not commit — planning docs are not tracked in git for this project.";
+    const reassessCommitInstruction = "Do not commit — .gsd/ planning docs are managed externally and not tracked in git.";
     return loadPrompt("reassess-roadmap", {
         workingDirectory: base,
         milestoneId: mid,

package/dist/resources/extensions/gsd/auto-start.js

@@ -93,23 +93,20 @@ export async function bootstrapAutoSession(s, ctx, pi, base, verboseMode, reques
         // ensureGitignore checks for git-tracked .gsd/ files and skips the
         // ".gsd" pattern if the project intentionally tracks .gsd/ in git.
         const gitPrefs = loadEffectiveGSDPreferences()?.preferences?.git;
-        const commitDocs = gitPrefs?.commit_docs;
         const manageGitignore = gitPrefs?.manage_gitignore;
-        ensureGitignore(base, { commitDocs, manageGitignore });
+        ensureGitignore(base, { manageGitignore });
         if (manageGitignore !== false)
             untrackRuntimeFiles(base);
         // Bootstrap .gsd/ if it doesn't exist
         const gsdDir = join(base, ".gsd");
         if (!existsSync(gsdDir)) {
             mkdirSync(join(gsdDir, "milestones"), { recursive: true });
-            if (commitDocs !== false) {
-                try {
-                    nativeAddAll(base);
-                    nativeCommit(base, "chore: init gsd");
-                }
-                catch {
-                    /* nothing to commit */
-                }
+            try {
+                nativeAddAll(base);
+                nativeCommit(base, "chore: init gsd");
+            }
+            catch {
+                /* nothing to commit */
             }
         }
         // Initialize GitServiceImpl
@@ -347,7 +344,7 @@ export async function bootstrapAutoSession(s, ctx, pi, base, verboseMode, reques
         // Capture integration branch
         if (s.currentMilestoneId) {
             if (getIsolationMode() !== "none") {
-                captureIntegrationBranch(base, s.currentMilestoneId, { commitDocs });
+                captureIntegrationBranch(base, s.currentMilestoneId);
             }
             setActiveMilestoneId(base, s.currentMilestoneId);
         }

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

@@ -161,6 +161,18 @@ export function isAutoActive() {
 export function isAutoPaused() {
     return s.paused;
 }
+export function setActiveEngineId(id) {
+    s.activeEngineId = id;
+}
+export function getActiveEngineId() {
+    return s.activeEngineId;
+}
+export function setActiveRunDir(runDir) {
+    s.activeRunDir = runDir;
+}
+export function getActiveRunDir() {
+    return s.activeRunDir;
+}
 /**
  * Return the model captured at auto-mode start for this session.
  * Used by error-recovery to fall back to the session's own model
@@ -531,6 +543,8 @@ export async function pauseAuto(ctx, _pi) {
             stepMode: s.stepMode,
             pausedAt: new Date().toISOString(),
             sessionFile: s.pausedSessionFile,
+            activeEngineId: s.activeEngineId,
+            activeRunDir: s.activeRunDir,
         };
         const runtimeDir = join(gsdRoot(s.originalBasePath || s.basePath), "runtime");
         mkdirSync(runtimeDir, { recursive: true });
@@ -725,7 +739,20 @@ export async function startAuto(ctx, pi, base, verboseMode, options) {
             const pausedPath = join(gsdRoot(base), "runtime", "paused-session.json");
             if (existsSync(pausedPath)) {
                 const meta = JSON.parse(readFileSync(pausedPath, "utf-8"));
-                if (meta.milestoneId) {
+                if (meta.activeEngineId && meta.activeEngineId !== "dev") {
+                    // Custom workflow resume — restore engine state
+                    s.activeEngineId = meta.activeEngineId;
+                    s.activeRunDir = meta.activeRunDir ?? null;
+                    s.originalBasePath = meta.originalBasePath || base;
+                    s.stepMode = meta.stepMode ?? requestedStepMode;
+                    s.paused = true;
+                    try {
+                        unlinkSync(pausedPath);
+                    }
+                    catch { /* non-fatal */ }
+                    ctx.ui.notify(`Resuming paused custom workflow${meta.activeRunDir ? ` (${meta.activeRunDir})` : ""}.`, "info");
+                }
+                else if (meta.milestoneId) {
                     // Validate the milestone still exists and isn't already complete (#1664).
                     const mDir = resolveMilestonePath(base, meta.milestoneId);
                     const summaryFile = resolveMilestoneFile(base, meta.milestoneId, "SUMMARY");