gsd-pi 2.78.1-dev.eccf86e27 → 2.79.0-dev.579e14e9b

package/dist/resources/extensions/gsd/bootstrap/register-hooks.js

@@ -51,6 +51,34 @@ async function applyDisabledModelProviderPolicy(ctx) {
         // Non-fatal: keep default provider visibility if preferences cannot be loaded.
     }
 }
+async function writeContextModeCompactionSnapshot(basePath) {
+    try {
+        const { loadEffectiveGSDPreferences } = await import("../preferences.js");
+        const { isContextModeEnabled } = await import("../preferences-types.js");
+        const prefs = loadEffectiveGSDPreferences(basePath);
+        if (!isContextModeEnabled(prefs?.preferences))
+            return;
+        const { writeCompactionSnapshot } = await import("../compaction-snapshot.js");
+        const { ensureDbOpen } = await import("./dynamic-tools.js");
+        await ensureDbOpen(basePath);
+        let activeContext = null;
+        try {
+            const state = await deriveGsdState(basePath);
+            if (state.activeMilestone && state.activeSlice && state.activeTask) {
+                activeContext =
+                    `Active: ${state.activeMilestone.id} / ${state.activeSlice.id} / ${state.activeTask.id}` +
+                        (state.activeTask.title ? ` - ${state.activeTask.title}` : "");
+            }
+        }
+        catch {
+            /* non-fatal */
+        }
+        writeCompactionSnapshot(basePath, { activeContext });
+    }
+    catch (err) {
+        safetyLogWarning("context-mode", `failed to write compaction snapshot: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
 export function registerHooks(pi, ecosystemHandlers) {
     pi.on("session_start", async (_event, ctx) => {
         initNotificationStore(process.cwd());
@@ -204,15 +232,18 @@ export function registerHooks(pi, ecosystemHandlers) {
         }
     });
     pi.on("session_before_compact", async () => {
+        const basePath = process.cwd();
+        // Context Mode is default-on. Write the resumable snapshot before any
+        // active-auto cancel return so auto sessions still leave re-entry context.
+        await writeContextModeCompactionSnapshot(basePath);
         // Only cancel compaction while auto-mode is actively running.
         // Paused auto-mode should allow compaction — the user may be doing
         // interactive work (#3165).
         if (isAutoActive()) {
             return { cancel: true };
         }
-        const basePath = process.cwd();
         const { ensureDbOpen } = await import("./dynamic-tools.js");
-        await ensureDbOpen();
+        await ensureDbOpen(basePath);
         const state = await deriveGsdState(basePath);
         if (!state.activeMilestone || !state.activeSlice)
             return;
@@ -256,41 +287,6 @@ export function registerHooks(pi, ecosystemHandlers) {
                 : `Resume ${phaseLabel} work for slice ${state.activeSlice.id}.`,
         }));
     });
-    // Context-mode snapshot: write .gsd/last-snapshot.md before compaction so
-    // agents can call gsd_resume (or Read the file) to re-orient. Opt-in via
-    // preferences.context_mode.enabled. Runs after the auto-cancel handler
-    // above — if that one returned cancel:true, pi still fires us but the
-    // compaction won't actually happen; the snapshot is still useful then,
-    // since auto may pause and resume later.
-    pi.on("session_before_compact", async () => {
-        try {
-            const { loadEffectiveGSDPreferences } = await import("../preferences.js");
-            const { isContextModeEnabled } = await import("../preferences-types.js");
-            const prefs = loadEffectiveGSDPreferences();
-            if (!isContextModeEnabled(prefs?.preferences))
-                return;
-            const { writeCompactionSnapshot } = await import("../compaction-snapshot.js");
-            const { ensureDbOpen } = await import("./dynamic-tools.js");
-            await ensureDbOpen();
-            const basePath = process.cwd();
-            let activeContext = null;
-            try {
-                const state = await deriveGsdState(basePath);
-                if (state.activeMilestone && state.activeSlice && state.activeTask) {
-                    activeContext =
-                        `Active: ${state.activeMilestone.id} / ${state.activeSlice.id} / ${state.activeTask.id}` +
-                            (state.activeTask.title ? ` — ${state.activeTask.title}` : "");
-                }
-            }
-            catch {
-                /* non-fatal */
-            }
-            writeCompactionSnapshot(basePath, { activeContext });
-        }
-        catch (err) {
-            safetyLogWarning("context-mode", `failed to write compaction snapshot: ${err instanceof Error ? err.message : String(err)}`);
-        }
-    });
     pi.on("message_update", async (event, ctx) => {
         if (approvalQuestionAbortInFlight)
             return;

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

@@ -57,7 +57,7 @@ export function currentDirectoryRoot() {
             cwd = process.cwd();
         }
         catch {
-            cwd = process.env.HOME ?? "/";
+            cwd = homedir();
         }
     }
     const result = validateDirectory(cwd);

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

@@ -100,8 +100,26 @@ export const KNOWN_PREFERENCE_KEYS = new Set([
     "context_mode",
     "planning_depth",
 ]);
-/** Canonical list of all dispatch unit types. */
-export const KNOWN_UNIT_TYPES = [
+/**
+ * Broad union of every recognized unit-type *label* used across the codebase.
+ *
+ * This intentionally covers more than the manifest-tracked dispatch units in
+ * `unit-context-manifest.ts:KNOWN_UNIT_TYPES`. Examples that live here but not
+ * in the manifest:
+ * - `discuss-slice` — dispatched by `guided-flow.ts` rather than auto-mode;
+ *   composer falls through to default behavior via `resolveManifest()` null path.
+ * - `worktree-merge` — used as a model-routing case, prompt-template name, and
+ *   commit-message label, not as an LLM-dispatched unit.
+ *
+ * Used by `preferences-validation.ts` to validate user-provided unit-type
+ * references in preferences (model overrides, skill rules, etc.) — preferences
+ * may legitimately reference any label, including non-dispatched ones.
+ *
+ * The manifest-strict subset lives in `unit-context-manifest.ts:KNOWN_UNIT_TYPES`
+ * and is enforced 1:1 against `UNIT_MANIFESTS` by the parity test in
+ * `tests/unit-context-manifest.test.ts`.
+ */
+export const KNOWN_UNIT_LABELS = [
     "research-milestone", "plan-milestone", "research-slice", "plan-slice", "refine-slice",
     "execute-task", "reactive-execute", "gate-evaluate", "complete-slice", "replan-slice", "reassess-roadmap",
     "run-uat", "complete-milestone", "validate-milestone", "rewrite-docs",

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

@@ -7,7 +7,7 @@
  */
 import { VALID_BRANCH_NAME } from "./git-service.js";
 import { normalizeStringArray } from "../shared/format-utils.js";
-import { KNOWN_PREFERENCE_KEYS, KNOWN_UNIT_TYPES, SKILL_ACTIONS, } from "./preferences-types.js";
+import { KNOWN_PREFERENCE_KEYS, KNOWN_UNIT_LABELS, SKILL_ACTIONS, } from "./preferences-types.js";
 const VALID_TOKEN_PROFILES = new Set(["budget", "balanced", "quality", "burn-max"]);
 const VALID_UOK_TURN_ACTIONS = new Set([
     "commit",
@@ -432,7 +432,7 @@ export function validatePreferences(preferences) {
     if (preferences.post_unit_hooks && Array.isArray(preferences.post_unit_hooks)) {
         const validHooks = [];
         const seenNames = new Set();
-        const knownUnitTypes = new Set(KNOWN_UNIT_TYPES);
+        const knownUnitTypes = new Set(KNOWN_UNIT_LABELS);
         for (const hook of preferences.post_unit_hooks) {
             if (!hook || typeof hook !== "object") {
                 errors.push("post_unit_hooks entry must be an object");
@@ -493,7 +493,7 @@ export function validatePreferences(preferences) {
     if (preferences.pre_dispatch_hooks && Array.isArray(preferences.pre_dispatch_hooks)) {
         const validPreHooks = [];
         const seenPreNames = new Set();
-        const knownUnitTypes = new Set(KNOWN_UNIT_TYPES);
+        const knownUnitTypes = new Set(KNOWN_UNIT_LABELS);
         const validActions = new Set(["modify", "skip", "replace"]);
         for (const hook of preferences.pre_dispatch_hooks) {
             if (!hook || typeof hook !== "object") {

package/dist/resources/extensions/gsd/tools/workflow-tool-executors.js

@@ -1,7 +1,7 @@
 import { ensureDbOpen } from "../bootstrap/dynamic-tools.js";
 import { sanitizeCompleteMilestoneParams } from "../bootstrap/sanitize-complete-milestone.js";
 import { loadWriteGateSnapshot, shouldBlockContextArtifactSaveInSnapshot, shouldBlockRootArtifactSaveInSnapshot } from "../bootstrap/write-gate.js";
-import { getActiveRequirements, getMilestone, getSliceStatusSummary, getSliceTaskCounts, readTransaction, saveGateResult, } from "../gsd-db.js";
+import { getActiveRequirements, insertMilestone, getMilestone, getSliceStatusSummary, getSliceTaskCounts, readTransaction, saveGateResult, } from "../gsd-db.js";
 import { GATE_REGISTRY } from "../gate-registry.js";
 import { generateRequirementsMd, saveArtifactToDb } from "../db-writer.js";
 import { resolveMilestoneFile, resolveSliceFile } from "../paths.js";
@@ -17,6 +17,7 @@ import { handleValidateMilestone } from "./validate-milestone.js";
 import { logError, logWarning } from "../workflow-logger.js";
 import { invalidateStateCache } from "../state.js";
 import { loadEffectiveGSDPreferences } from "../preferences.js";
+import { parseProject } from "../schemas/parsers.js";
 export const SUPPORTED_SUMMARY_ARTIFACT_TYPES = [
     "SUMMARY",
     "RESEARCH",
@@ -37,6 +38,19 @@ function isRootSummaryArtifactType(artifactType) {
         artifactType === "REQUIREMENTS" ||
         artifactType === "REQUIREMENTS-DRAFT";
 }
+function registerProjectMilestoneSequence(content) {
+    const parsed = parseProject(content);
+    const registered = [];
+    for (const milestone of parsed.milestones) {
+        insertMilestone({
+            id: milestone.id,
+            title: milestone.title,
+            status: milestone.done ? "complete" : "queued",
+        });
+        registered.push(milestone.id);
+    }
+    return registered;
+}
 export async function executeSummarySave(params, basePath = process.cwd()) {
     const dbAvailable = await ensureDbOpen(basePath);
     if (!dbAvailable) {
@@ -126,6 +140,24 @@ export async function executeSummarySave(params, basePath = process.cwd()) {
             slice_id: isRootArtifact ? undefined : params.slice_id,
             task_id: isRootArtifact ? undefined : params.task_id,
         }, basePath);
+        let registeredMilestones = [];
+        let registrationWarning;
+        if (params.artifact_type === "PROJECT") {
+            try {
+                registeredMilestones = registerProjectMilestoneSequence(contentToSave);
+                if (registeredMilestones.length > 0)
+                    invalidateStateCache();
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                registrationWarning = `PROJECT artifact saved, but milestone registration failed: ${msg}`;
+                logWarning("tool", registrationWarning, {
+                    tool: "gsd_summary_save",
+                    error: String(err),
+                    stack: err instanceof Error ? err.stack ?? "" : "",
+                });
+            }
+        }
         if (params.artifact_type === "CONTEXT" && !params.task_id) {
             try {
                 const draftFile = params.slice_id
@@ -140,7 +172,14 @@ export async function executeSummarySave(params, basePath = process.cwd()) {
         }
         return {
             content: [{ type: "text", text: `Saved ${params.artifact_type} artifact to ${relativePath}` }],
-            details: { operation: "save_summary", path: relativePath, artifact_type: params.artifact_type, content_source: contentSource },
+            details: {
+                operation: "save_summary",
+                path: relativePath,
+                artifact_type: params.artifact_type,
+                content_source: contentSource,
+                ...(registeredMilestones.length > 0 ? { registeredMilestones } : {}),
+                ...(registrationWarning ? { warning: registrationWarning } : {}),
+            },
         };
     }
     catch (err) {

package/dist/resources/extensions/gsd/unit-context-composer.js

@@ -71,6 +71,38 @@ export function manifestBudgetChars(unitType) {
     const manifest = resolveManifest(unitType);
     return manifest ? manifest.maxSystemPromptChars : null;
 }
+const CONTEXT_MODE_LANE_LABELS = {
+    interview: "interview",
+    research: "research",
+    planning: "planning",
+    execution: "execution",
+    verification: "verification",
+    orchestration: "orchestration",
+    docs: "documentation",
+};
+const CONTEXT_MODE_GUIDANCE = "Use `gsd_exec` for noisy scans, builds, and tests so full output stays out of prompt context; call `gsd_exec_search` before repeating prior runs; call `gsd_resume` after compaction or resume to recover stored execution context.";
+/**
+ * Render the Context Mode instruction lane for a unit type. Unknown unit
+ * types, disabled config, and explicit `contextMode: "none"` all omit the
+ * block so callers can prefix this safely without extra branching.
+ */
+export function composeContextModeInstructions(unitType, opts) {
+    if (!opts.enabled)
+        return "";
+    const manifest = resolveManifest(unitType);
+    if (!manifest || manifest.contextMode === "none")
+        return "";
+    const lane = CONTEXT_MODE_LANE_LABELS[manifest.contextMode];
+    if (opts.renderMode === "nested") {
+        return `Context Mode (${lane} lane): ${CONTEXT_MODE_GUIDANCE}`;
+    }
+    return [
+        "## Context Mode",
+        "",
+        `Lane: **${lane} lane**.`,
+        CONTEXT_MODE_GUIDANCE,
+    ].join("\n");
+}
 const SECTION_SEPARATOR = "\n\n---\n\n";
 /**
  * Compose all manifest-declared context for a unit type using the v2

package/dist/resources/extensions/gsd/unit-context-manifest.js

@@ -137,6 +137,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "research",
         tools: TOOLS_PLANNING,
         artifacts: {
             // Phase 3 migration (#4782): matches today's actual
@@ -153,6 +154,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "planning",
         tools: TOOLS_PLANNING,
         artifacts: {
             inline: ["project", "requirements", "decisions", "milestone-research", "templates"],
@@ -167,6 +169,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "interview",
         tools: TOOLS_PLANNING,
         artifacts: {
             inline: ["project", "requirements", "decisions", "milestone-context", "templates"],
@@ -181,6 +184,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: false,
         preferences: "active-only",
+        contextMode: "verification",
         // planning-dispatch: validation is a verification-fan-out unit. It reads
         // the milestone surface and dispatches reviewer/security/tester subagents
         // to report findings without touching user source. Mirrors
@@ -199,6 +203,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: false,
         preferences: "active-only",
+        contextMode: "verification",
         // planning-dispatch: completion is a high-leverage place to fan out to
         // reviewer / security / tester subagents. They read the diff and report
         // findings; they do not write user source. Write isolation to .gsd/ is
@@ -221,6 +226,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "research",
         tools: TOOLS_PLANNING,
         artifacts: {
             inline: ["roadmap", "milestone-research", "dependency-summaries", "templates"],
@@ -235,6 +241,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "planning",
         // planning-dispatch: allows subagent dispatch so the planner can fan out
         // to scout for codebase recon and to planner/decompose-style specialists
         // for sub-decomposition. Write-isolation to .gsd/ is preserved.
@@ -252,6 +259,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "planning",
         // See plan-slice — same rationale: dispatch to scout/planner-style
         // specialists during refinement is materially better than re-doing recon
         // inline.
@@ -269,6 +277,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "planning",
         tools: TOOLS_PLANNING,
         artifacts: {
             inline: ["slice-plan", "slice-research", "dependency-summaries", "prior-task-summaries", "templates"],
@@ -283,6 +292,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: false,
         preferences: "active-only",
+        contextMode: "verification",
         // See complete-milestone — same rationale: dispatch to reviewer / security /
         // tester subagents to fan out review work without bloating this unit's
         // context.
@@ -304,6 +314,7 @@ export const UNIT_MANIFESTS = {
         memory: "critical-only",
         codebaseMap: false,
         preferences: "none",
+        contextMode: "planning",
         tools: TOOLS_PLANNING,
         artifacts: {
             // Phase 2 pilot (#4782): manifest now matches today's actual
@@ -322,6 +333,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "execution",
         tools: TOOLS_ALL,
         artifacts: {
             inline: ["task-plan", "slice-plan", "prior-task-summaries", "templates"],
@@ -336,6 +348,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "execution",
         tools: TOOLS_ALL,
         artifacts: {
             inline: ["slice-plan", "prior-task-summaries", "templates"],
@@ -351,6 +364,7 @@ export const UNIT_MANIFESTS = {
         memory: "critical-only",
         codebaseMap: false,
         preferences: "active-only",
+        contextMode: "verification",
         tools: TOOLS_PLANNING,
         artifacts: {
             // Phase 3 migration (#4782): manifest matches today's actual
@@ -369,6 +383,7 @@ export const UNIT_MANIFESTS = {
         memory: "critical-only",
         codebaseMap: false,
         preferences: "active-only",
+        contextMode: "verification",
         tools: TOOLS_PLANNING,
         artifacts: {
             inline: ["slice-plan", "prior-task-summaries"],
@@ -383,6 +398,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "docs",
         tools: TOOLS_DOCS,
         artifacts: {
             inline: ["project", "requirements", "decisions", "templates"],
@@ -401,6 +417,7 @@ export const UNIT_MANIFESTS = {
         memory: "none",
         codebaseMap: false,
         preferences: "none",
+        contextMode: "none",
         tools: TOOLS_PLANNING,
         artifacts: {
             inline: [],
@@ -418,6 +435,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "interview",
         tools: TOOLS_PLANNING,
         artifacts: {
             inline: ["templates"],
@@ -434,6 +452,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "interview",
         tools: TOOLS_PLANNING,
         artifacts: {
             inline: ["project", "templates"],
@@ -450,6 +469,7 @@ export const UNIT_MANIFESTS = {
         memory: "none",
         codebaseMap: false,
         preferences: "none",
+        contextMode: "none",
         tools: TOOLS_PLANNING,
         artifacts: {
             inline: [],
@@ -468,6 +488,7 @@ export const UNIT_MANIFESTS = {
         memory: "prompt-relevant",
         codebaseMap: true,
         preferences: "active-only",
+        contextMode: "research",
         tools: { mode: "planning-dispatch", allowedSubagents: ["scout"] },
         artifacts: {
             inline: ["project", "requirements", "templates"],