gsd-pi 2.38.0-dev.63ad7e5 → 2.38.0-dev.7209774

package/dist/resources/extensions/gsd/auto-post-unit.js

@@ -72,11 +72,21 @@ export async function postUnitPreVerification(pctx, opts) {
                             const summaryContent = await loadFile(summaryPath);
                             if (summaryContent) {
                                 const summary = parseSummary(summaryContent);
+                                // Look up GitHub issue number for commit linking
+                                let ghIssueNumber;
+                                try {
+                                    const { getTaskIssueNumberForCommit } = await import("../github-sync/sync.js");
+                                    ghIssueNumber = getTaskIssueNumberForCommit(s.basePath, mid, sid, tid) ?? undefined;
+                                }
+                                catch {
+                                    // GitHub sync not available — skip
+                                }
                                 taskContext = {
                                     taskId: `${sid}/${tid}`,
                                     taskTitle: summary.title?.replace(/^T\d+:\s*/, "") || tid,
                                     oneLiner: summary.oneLiner || undefined,
                                     keyFiles: summary.frontmatter.key_files?.filter(f => !f.includes("{{")) || undefined,
+                                    issueNumber: ghIssueNumber,
                                 };
                             }
                         }
@@ -94,6 +104,14 @@ export async function postUnitPreVerification(pctx, opts) {
         catch (e) {
             debugLog("postUnit", { phase: "auto-commit", error: String(e) });
         }
+        // GitHub sync (non-blocking, opt-in)
+        try {
+            const { runGitHubSync } = await import("../github-sync/sync.js");
+            await runGitHubSync(s.basePath, s.currentUnit.type, s.currentUnit.id);
+        }
+        catch (e) {
+            debugLog("postUnit", { phase: "github-sync", error: String(e) });
+        }
         // Doctor: fix mechanical bookkeeping (skipped for lightweight sidecars)
         if (!opts?.skipDoctor)
             try {
@@ -105,12 +123,18 @@ export async function postUnitPreVerification(pctx, opts) {
                 if (report.fixesApplied.length > 0) {
                     ctx.ui.notify(`Post-hook: applied ${report.fixesApplied.length} fix(es).`, "info");
                 }
-                // Proactive health tracking
-                const summary = summarizeDoctorIssues(report.issues);
+                // Proactive health tracking — filter to current milestone to avoid
+                // cross-milestone stale errors inflating the escalation counter
+                const currentMilestoneId = s.currentUnit.id.split("/")[0];
+                const milestoneIssues = currentMilestoneId
+                    ? report.issues.filter(i => i.unitId === currentMilestoneId ||
+                        i.unitId.startsWith(`${currentMilestoneId}/`))
+                    : report.issues;
+                const summary = summarizeDoctorIssues(milestoneIssues);
                 recordHealthSnapshot(summary.errors, summary.warnings, report.fixesApplied.length);
                 // Check if we should escalate to LLM-assisted heal
                 if (summary.errors > 0) {
-                    const unresolvedErrors = report.issues
+                    const unresolvedErrors = milestoneIssues
                         .filter(i => i.severity === "error" && !i.fixable)
                         .map(i => ({ code: i.code, message: i.message, unitId: i.unitId }));
                     const escalation = checkHealEscalation(summary.errors, unresolvedErrors);
@@ -123,6 +147,7 @@ export async function postUnitPreVerification(pctx, opts) {
                             const reportText = formatDoctorReport(report, { scope: doctorScope, includeWarnings: true });
                             const structuredIssues = formatDoctorIssuesForPrompt(actionable);
                             dispatchDoctorHeal(pi, doctorScope, reportText, structuredIssues);
+                            return "dispatched";
                         }
                         catch (e) {
                             debugLog("postUnit", { phase: "doctor-heal-dispatch", error: String(e) });

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

@@ -7,12 +7,19 @@
  */
 import { loadFile, parseContinue, parsePlan, parseRoadmap, parseSummary, extractUatType, loadActiveOverrides, formatOverridesSection } from "./files.js";
 import { loadPrompt, inlineTemplate } from "./prompt-loader.js";
-import { resolveMilestoneFile, resolveSliceFile, resolveSlicePath, resolveTasksDir, resolveTaskFiles, resolveTaskFile, relMilestoneFile, relSliceFile, relSlicePath, relMilestonePath, resolveGsdRootFile, relGsdRootFile, } from "./paths.js";
+import { resolveMilestoneFile, resolveSliceFile, resolveSlicePath, resolveTasksDir, resolveTaskFiles, resolveTaskFile, relMilestoneFile, relSliceFile, relSlicePath, relMilestonePath, resolveGsdRootFile, relGsdRootFile, resolveRuntimeFile, } from "./paths.js";
 import { resolveSkillDiscoveryMode, resolveInlineLevel, loadEffectiveGSDPreferences } from "./preferences.js";
 import { join } from "node:path";
 import { existsSync } from "node:fs";
-import { computeBudgets, resolveExecutorContextWindow } from "./context-budget.js";
+import { computeBudgets, resolveExecutorContextWindow, truncateAtSectionBoundary } from "./context-budget.js";
 import { formatDecisionsCompact, formatRequirementsCompact } from "./structured-data-formatter.js";
+// ─── Preamble Cap ─────────────────────────────────────────────────────────────
+const MAX_PREAMBLE_CHARS = 30_000;
+function capPreamble(preamble) {
+    if (preamble.length <= MAX_PREAMBLE_CHARS)
+        return preamble;
+    return truncateAtSectionBoundary(preamble, MAX_PREAMBLE_CHARS).content;
+}
 // ─── Executor Constraints ─────────────────────────────────────────────────────
 /**
  * Format executor context constraints for injection into the plan-slice prompt.
@@ -124,7 +131,6 @@ export async function inlineFileSmart(absPath, relPath, label, query, threshold
         return `### ${label}\nSource: \`${relPath}\`\n\n${content.trim()}`;
     }
     // For large files, truncate at section boundary
-    const { truncateAtSectionBoundary } = await import("./context-budget.js");
     const truncated = truncateAtSectionBoundary(content, threshold).content;
     return `### ${label}\nSource: \`${relPath}\`\n\n${truncated}`;
 }
@@ -158,7 +164,6 @@ export async function inlineDependencySummaries(mid, sid, base, budgetChars) {
     }
     const result = sections.join("\n\n");
     if (budgetChars !== undefined && result.length > budgetChars) {
-        const { truncateAtSectionBoundary } = await import("./context-budget.js");
         return truncateAtSectionBoundary(result, budgetChars).content;
     }
     return result;
@@ -525,7 +530,7 @@ export async function buildResearchMilestonePrompt(mid, midTitle, base) {
     if (knowledgeInlineRM)
         inlined.push(knowledgeInlineRM);
     inlined.push(inlineTemplate("research", "Research"));
-    const inlinedContext = `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`;
+    const inlinedContext = capPreamble(`## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`);
     const outputRelPath = relMilestoneFile(base, mid, "RESEARCH");
     return loadPrompt("research-milestone", {
         workingDirectory: base,
@@ -578,7 +583,7 @@ export async function buildPlanMilestonePrompt(mid, midTitle, base, level) {
         inlined.push(inlineTemplate("plan", "Slice Plan"));
         inlined.push(inlineTemplate("task-plan", "Task Plan"));
     }
-    const inlinedContext = `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`;
+    const inlinedContext = capPreamble(`## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`);
     const outputRelPath = relMilestoneFile(base, mid, "ROADMAP");
     const researchOutputPath = join(base, relMilestoneFile(base, mid, "RESEARCH"));
     const secretsOutputPath = join(base, relMilestoneFile(base, mid, "SECRETS"));
@@ -626,7 +631,7 @@ export async function buildResearchSlicePrompt(mid, _midTitle, sid, sTitle, base
     const overridesInline = formatOverridesSection(activeOverrides);
     if (overridesInline)
         inlined.unshift(overridesInline);
-    const inlinedContext = `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`;
+    const inlinedContext = capPreamble(`## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`);
     const outputRelPath = relSliceFile(base, mid, sid, "RESEARCH");
     return loadPrompt("research-slice", {
         workingDirectory: base,
@@ -672,7 +677,7 @@ export async function buildPlanSlicePrompt(mid, _midTitle, sid, sTitle, base, le
     const planOverridesInline = formatOverridesSection(planActiveOverrides);
     if (planOverridesInline)
         inlined.unshift(planOverridesInline);
-    const inlinedContext = `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`;
+    const inlinedContext = capPreamble(`## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`);
     // Build executor context constraints from the budget engine
     const executorContextConstraints = formatExecutorConstraints();
     const outputRelPath = relSliceFile(base, mid, sid, "PLAN");
@@ -760,11 +765,17 @@ export async function buildExecuteTaskPrompt(mid, sid, sTitle, tid, tTitle, base
     const carryForwardBudget = Math.floor(budgets.inlineContextBudgetChars * 0.4);
     let finalCarryForward = carryForwardSection;
     if (carryForwardSection.length > carryForwardBudget) {
-        const { truncateAtSectionBoundary } = await import("./context-budget.js");
         finalCarryForward = truncateAtSectionBoundary(carryForwardSection, carryForwardBudget).content;
     }
+    // Inline RUNTIME.md if present
+    const runtimePath = resolveRuntimeFile(base);
+    const runtimeContent = existsSync(runtimePath) ? await loadFile(runtimePath) : null;
+    const runtimeContext = runtimeContent
+        ? `### Runtime Context\nSource: \`.gsd/RUNTIME.md\`\n\n${runtimeContent.trim()}`
+        : "";
     return loadPrompt("execute-task", {
         overridesSection,
+        runtimeContext,
         workingDirectory: base,
         milestoneId: mid, sliceId: sid, sliceTitle: sTitle, taskId: tid, taskTitle: tTitle,
         planPath: join(base, relSliceFile(base, mid, sid, "PLAN")),
@@ -819,7 +830,7 @@ export async function buildCompleteSlicePrompt(mid, _midTitle, sid, sTitle, base
     const completeOverridesInline = formatOverridesSection(completeActiveOverrides);
     if (completeOverridesInline)
         inlined.unshift(completeOverridesInline);
-    const inlinedContext = `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`;
+    const inlinedContext = capPreamble(`## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`);
     const sliceRel = relSlicePath(base, mid, sid);
     const sliceSummaryPath = join(base, `${sliceRel}/${sid}-SUMMARY.md`);
     const sliceUatPath = join(base, `${sliceRel}/${sid}-UAT.md`);
@@ -875,7 +886,7 @@ export async function buildCompleteMilestonePrompt(mid, midTitle, base, level) {
     if (contextInline)
         inlined.push(contextInline);
     inlined.push(inlineTemplate("milestone-summary", "Milestone Summary"));
-    const inlinedContext = `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`;
+    const inlinedContext = capPreamble(`## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`);
     const milestoneSummaryPath = join(base, `${relMilestonePath(base, mid)}/${mid}-SUMMARY.md`);
     return loadPrompt("complete-milestone", {
         workingDirectory: base,
@@ -942,7 +953,7 @@ export async function buildValidateMilestonePrompt(mid, midTitle, base, level) {
     const contextInline = await inlineFileOptional(contextPath, contextRel, "Milestone Context");
     if (contextInline)
         inlined.push(contextInline);
-    const inlinedContext = `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`;
+    const inlinedContext = capPreamble(`## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`);
     const validationOutputPath = join(base, `${relMilestonePath(base, mid)}/${mid}-VALIDATION.md`);
     const roadmapOutputPath = `${relMilestonePath(base, mid)}/${mid}-ROADMAP.md`;
     return loadPrompt("validate-milestone", {
@@ -990,7 +1001,7 @@ export async function buildReplanSlicePrompt(mid, midTitle, sid, sTitle, base) {
     const replanOverridesInline = formatOverridesSection(replanActiveOverrides);
     if (replanOverridesInline)
         inlined.unshift(replanOverridesInline);
-    const inlinedContext = `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`;
+    const inlinedContext = capPreamble(`## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`);
     const replanPath = join(base, `${relSlicePath(base, mid, sid)}/${sid}-REPLAN.md`);
     // Build capture context for replan prompt (captures that triggered this replan)
     let captureContext = "(none)";
@@ -1030,7 +1041,7 @@ export async function buildRunUatPrompt(mid, sliceId, uatPath, uatContent, base)
     const projectInline = await inlineProjectFromDb(base);
     if (projectInline)
         inlined.push(projectInline);
-    const inlinedContext = `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`;
+    const inlinedContext = capPreamble(`## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`);
     const uatResultPath = join(base, relSliceFile(base, mid, sliceId, "UAT-RESULT"));
     const uatType = extractUatType(uatContent) ?? "human-experience";
     return loadPrompt("run-uat", {
@@ -1066,7 +1077,7 @@ export async function buildReassessRoadmapPrompt(mid, midTitle, completedSliceId
     const knowledgeInlineRA = await inlineGsdRootFile(base, "knowledge.md", "Project Knowledge");
     if (knowledgeInlineRA)
         inlined.push(knowledgeInlineRA);
-    const inlinedContext = `## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`;
+    const inlinedContext = capPreamble(`## Inlined Context (preloaded — do not re-read these files)\n\n${inlined.join("\n\n---\n\n")}`);
     const assessmentPath = join(base, relSliceFile(base, mid, completedSliceId, "ASSESSMENT"));
     // Build deferred captures context for reassess prompt
     let deferredCaptures = "(none)";

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

@@ -15,10 +15,10 @@ import { safeCopy, safeCopyRecursive } from "./safe-fs.js";
 import { gsdRoot } from "./paths.js";
 import { createWorktree, removeWorktree, worktreePath, } from "./worktree-manager.js";
 import { detectWorktreeName, nudgeGitBranchCache, } from "./worktree.js";
-import { MergeConflictError, readIntegrationBranch } from "./git-service.js";
+import { MergeConflictError, readIntegrationBranch, RUNTIME_EXCLUSION_PATHS } from "./git-service.js";
 import { parseRoadmap } from "./files.js";
 import { loadEffectiveGSDPreferences } from "./preferences.js";
-import { nativeGetCurrentBranch, nativeWorkingTreeStatus, nativeAddAll, nativeCommit, nativeCheckoutBranch, nativeMergeSquash, nativeConflictFiles, nativeCheckoutTheirs, nativeAddPaths, nativeRmForce, nativeBranchDelete, nativeBranchExists, } from "./native-git-bridge.js";
+import { nativeGetCurrentBranch, nativeWorkingTreeStatus, nativeAddAllWithExclusions, nativeCommit, nativeCheckoutBranch, nativeMergeSquash, nativeConflictFiles, nativeCheckoutTheirs, nativeAddPaths, nativeRmForce, nativeBranchDelete, nativeBranchExists, } from "./native-git-bridge.js";
 // ─── Module State ──────────────────────────────────────────────────────────
 /** Original project root before chdir into auto-worktree. */
 let originalBase = null;
@@ -656,7 +656,7 @@ function autoCommitDirtyState(cwd) {
         const status = nativeWorkingTreeStatus(cwd);
         if (!status)
             return false;
-        nativeAddAll(cwd);
+        nativeAddAllWithExclusions(cwd, RUNTIME_EXCLUSION_PATHS);
         const result = nativeCommit(cwd, "chore: auto-commit before milestone merge");
         return result !== null;
     }

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

@@ -3,6 +3,7 @@
  *
  * One command, one wizard. Routes to smart entry or status.
  */
+import { importExtensionModule } from "@gsd/pi-coding-agent";
 import { existsSync, readFileSync, readdirSync, unlinkSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
@@ -529,7 +530,7 @@ export async function handleGSDCommand(args, ctx, pi) {
         return;
     }
     if (trimmed === "widget" || trimmed.startsWith("widget ")) {
-        const { cycleWidgetMode, setWidgetMode, getWidgetMode } = await import("./auto-dashboard.js");
+        const { cycleWidgetMode, setWidgetMode, getWidgetMode } = await importExtensionModule(import.meta.url, "./auto-dashboard.js");
         const arg = trimmed.replace(/^widget\s*/, "").trim();
         if (arg === "full" || arg === "small" || arg === "min" || arg === "off") {
             setWidgetMode(arg);

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

@@ -257,10 +257,23 @@ async function markSliceDoneInRoadmap(basePath, milestoneId, sliceId, fixesAppli
         fixesApplied.push(`marked ${sliceId} done in ${roadmapPath}`);
     }
 }
+async function markSliceUndoneInRoadmap(basePath, milestoneId, sliceId, fixesApplied) {
+    const roadmapPath = resolveMilestoneFile(basePath, milestoneId, "ROADMAP");
+    if (!roadmapPath)
+        return;
+    const content = await loadFile(roadmapPath);
+    if (!content)
+        return;
+    const updated = content.replace(new RegExp(`^(\\s*-\\s+)\\[x\\]\\s+\\*\\*${sliceId}:`, "m"), `$1[ ] **${sliceId}:`);
+    if (updated !== content) {
+        await saveFile(roadmapPath, updated);
+        fixesApplied.push(`unmarked ${sliceId} in ${roadmapPath} (premature completion)`);
+    }
+}
 function matchesScope(unitId, scope) {
     if (!scope)
         return true;
-    return unitId === scope || unitId.startsWith(`${scope}/`) || unitId.startsWith(`${scope}`);
+    return unitId === scope || unitId.startsWith(`${scope}/`);
 }
 function auditRequirements(content) {
     if (!content)
@@ -828,6 +841,12 @@ export async function runGSDDoctor(basePath, options) {
                     file: relSliceFile(basePath, milestoneId, slice.id, "SUMMARY"),
                     fixable: true,
                 });
+                if (!allTasksDone) {
+                    dryRunCanFix("slice_checked_missing_summary", `uncheck ${slice.id} in roadmap (tasks incomplete)`);
+                    if (shouldFix("slice_checked_missing_summary")) {
+                        await markSliceUndoneInRoadmap(basePath, milestoneId, slice.id, fixesApplied);
+                    }
+                }
             }
             if (slice.done && !hasSliceUat) {
                 issues.push({

package/dist/resources/extensions/gsd/exit-command.js

@@ -1,9 +1,10 @@
+import { importExtensionModule } from "@gsd/pi-coding-agent";
 export function registerExitCommand(pi, deps = {}) {
     pi.registerCommand("exit", {
         description: "Exit GSD gracefully",
         handler: async (_args, ctx) => {
             // Stop auto-mode first so locks and activity state are cleaned up before shutdown.
-            const stopAuto = deps.stopAuto ?? (await import("./auto.js")).stopAuto;
+            const stopAuto = deps.stopAuto ?? (await importExtensionModule(import.meta.url, "./auto.js")).stopAuto;
             await stopAuto(ctx, pi, "Graceful exit");
             ctx.shutdown();
         },

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

@@ -692,6 +692,10 @@ export function extractUatType(content) {
     const rawValue = modeBullet.slice('UAT mode:'.length).trim().toLowerCase();
     if (rawValue.startsWith('artifact-driven'))
         return 'artifact-driven';
+    if (rawValue.startsWith('browser-executable'))
+        return 'browser-executable';
+    if (rawValue.startsWith('runtime-executable'))
+        return 'runtime-executable';
     if (rawValue.startsWith('live-runtime'))
         return 'live-runtime';
     if (rawValue.startsWith('human-experience'))

package/dist/resources/extensions/gsd/git-service.js

@@ -14,7 +14,7 @@ import { gsdRoot } from "./paths.js";
 import { GIT_NO_PROMPT_ENV } from "./git-constants.js";
 import { loadEffectiveGSDPreferences } from "./preferences.js";
 import { detectWorktreeName, SLICE_BRANCH_RE, } from "./worktree.js";
-import { nativeGetCurrentBranch, nativeDetectMainBranch, nativeBranchExists, nativeHasChanges, nativeAddAll, nativeResetPaths, nativeHasStagedChanges, nativeCommit, nativeRmCached, nativeUpdateRef, } from "./native-git-bridge.js";
+import { nativeGetCurrentBranch, nativeDetectMainBranch, nativeBranchExists, nativeHasChanges, nativeAddAllWithExclusions, nativeHasStagedChanges, nativeCommit, nativeRmCached, nativeUpdateRef, } from "./native-git-bridge.js";
 import { GSDError, GSD_MERGE_CONFLICT, GSD_GIT_ERROR } from "./errors.js";
 import { getErrorMessage } from "./error-utils.js";
 export const VALID_BRANCH_NAME = /^[a-zA-Z0-9_\-\/.]+$/;
@@ -36,12 +36,19 @@ export function buildTaskCommitMessage(ctx) {
         : description;
     const subject = `${type}(${scope}): ${truncated}`;
     // Build body with key files if available
+    const bodyParts = [];
     if (ctx.keyFiles && ctx.keyFiles.length > 0) {
         const fileLines = ctx.keyFiles
             .slice(0, 8) // cap at 8 files to keep commit concise
             .map(f => `- ${f}`)
             .join("\n");
-        return `${subject}\n\n${fileLines}`;
+        bodyParts.push(fileLines);
+    }
+    if (ctx.issueNumber) {
+        bodyParts.push(`Resolves #${ctx.issueNumber}`);
+    }
+    if (bodyParts.length > 0) {
+        return `${subject}\n\n${bodyParts.join("\n\n")}`;
     }
     return subject;
 }
@@ -254,7 +261,9 @@ export class GitServiceImpl {
             }
             this._runtimeFilesCleanedUp = true;
         }
-        // Stage everything, then unstage excluded paths.
+        // Stage everything using pathspec exclusions so excluded paths are never
+        // hashed by git. The old approach of `git add -A` followed by unstaging
+        // hangs indefinitely on repos with large untracked artifact trees (#1605).
         //
         // Exclude only RUNTIME paths from staging — not the entire .gsd/ directory.
         // When .gsd/milestones/ files are already tracked in the index (projects
@@ -264,15 +273,9 @@ export class GitServiceImpl {
         // the second half of a milestone's artifacts are never committed (#1326).
         //
         // If .gsd/ IS in .gitignore (the default for external state projects),
-        // git add -A already skips it and the reset is a harmless no-op.
-        nativeAddAll(this.basePath);
-        const runtimeExclusions = [...RUNTIME_EXCLUSION_PATHS, ...extraExclusions];
-        for (const exclusion of runtimeExclusions) {
-            try {
-                nativeResetPaths(this.basePath, [exclusion]);
-            }
-            catch { /* path not staged — ignore */ }
-        }
+        // git add -A already skips it and the exclusions are harmless no-ops.
+        const allExclusions = [...RUNTIME_EXCLUSION_PATHS, ...extraExclusions];
+        nativeAddAllWithExclusions(this.basePath, allExclusions);
     }
     /** Tracks whether runtime file cleanup has run this session. */
     _runtimeFilesCleanedUp = false;
@@ -433,6 +436,21 @@ export class GitServiceImpl {
         }
     }
 }
+// ─── Draft PR Creation ─────────────────────────────────────────────────────
+/**
+ * Create a draft pull request for a completed milestone using `gh pr create`.
+ * Returns the PR URL on success, or null on failure.
+ * Non-fatal: callers should treat failure as best-effort.
+ */
+export function createDraftPR(basePath, milestoneId, title, body) {
+    try {
+        const result = execSync(`gh pr create --draft --title ${JSON.stringify(title)} --body ${JSON.stringify(body)}`, { cwd: basePath, encoding: "utf8", timeout: 30000, env: GIT_NO_PROMPT_ENV });
+        return result.trim();
+    }
+    catch {
+        return null;
+    }
+}
 // ─── Factory ───────────────────────────────────────────────────────────────
 /** Create a GitServiceImpl with the current effective git preferences. */
 export function createGitService(basePath) {