gsd-pi 2.77.0-dev.eaa4973bc → 2.78.0

package/dist/resources/extensions/claude-code-cli/stream-adapter.js

@@ -9,6 +9,10 @@
  */
 import { EventStream } from "@gsd/pi-ai";
 import { execSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
 import { PartialMessageBuilder, ZERO_USAGE, mapUsage } from "./partial-builder.js";
 import { buildWorkflowMcpServers } from "../gsd/workflow-mcp.js";
 import { showInterviewRound } from "../shared/tui.js";
@@ -45,32 +49,81 @@ export function getResultErrorMessage(result) {
 // ---------------------------------------------------------------------------
 // Claude binary resolution
 // ---------------------------------------------------------------------------
-/** Cached result of the `which`/`where claude` lookup so the shell is only spawned once per process. */
+/** Cached result of the Claude executable/script resolution so lookup runs once per process. */
 let cachedClaudePath = null;
+const requireFromHere = createRequire(import.meta.url);
 /** Return the shell command used to locate the `claude` binary on the given platform. */
 export function getClaudeLookupCommand(platform = process.platform) {
     return platform === "win32" ? "where claude" : "which claude";
 }
-/** Extract the first line of `which`/`where` output as the resolved binary path. */
-export function parseClaudeLookupOutput(output) {
-    return output
+/**
+ * Pick the most suitable path from `which`/`where` output.
+ *
+ * On Windows, `where claude` can return shim entries first (for example
+ * `...\\npm\\claude` / `...\\npm\\claude.cmd`) that the Claude Agent SDK treats
+ * as a native executable path and then fails to spawn. Prefer a native
+ * `.exe` candidate when present.
+ */
+export function parseClaudeLookupOutput(output, platform = process.platform) {
+    const lines = output
         .toString()
-        .trim()
-        .split(/\r?\n/)[0] ?? "";
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (lines.length === 0)
+        return "";
+    if (platform !== "win32")
+        return lines[0] ?? "";
+    const exeCandidate = lines.find((line) => /\.exe$/i.test(line));
+    if (exeCandidate)
+        return exeCandidate;
+    const cmdCandidate = lines.find((line) => /\.cmd$/i.test(line));
+    if (cmdCandidate)
+        return cmdCandidate;
+    return lines[0] ?? "";
+}
+/** Resolve the SDK-bundled cli.js path if available. */
+export function resolveBundledClaudeCliPath() {
+    try {
+        const sdkEntry = requireFromHere.resolve("@anthropic-ai/claude-agent-sdk");
+        const cliPath = join(dirname(sdkEntry), "cli.js");
+        return existsSync(cliPath) ? cliPath : null;
+    }
+    catch {
+        return null;
+    }
 }
 /**
- * Resolve the path to the system-installed `claude` binary.
- * The SDK defaults to a bundled cli.js which doesn't exist when
- * installed as a library — we need to point it at the real CLI.
+ * Normalize a discovered path for Claude Agent SDK consumption.
+ *
+ * On Windows, the SDK treats non-`.js` paths as native binaries. NPM shims
+ * like `claude`/`claude.cmd` are not native binaries and can fail with
+ * `ENOENT`/`EINVAL` in that mode. When no `.exe` is available, prefer the
+ * SDK-bundled `cli.js` so the SDK runs via Node.
  */
+export function normalizeClaudePathForSdk(resolvedPath, platform = process.platform, bundledCliPath = resolveBundledClaudeCliPath()) {
+    if (platform !== "win32")
+        return resolvedPath;
+    if (/\.exe$/i.test(resolvedPath))
+        return resolvedPath;
+    if (bundledCliPath)
+        return bundledCliPath;
+    return resolvedPath;
+}
+/** Resolve the path passed to `pathToClaudeCodeExecutable`. */
 function getClaudePath() {
     if (cachedClaudePath)
         return cachedClaudePath;
+    const fallback = process.platform === "win32"
+        ? (resolveBundledClaudeCliPath() ?? "claude.cmd")
+        : "claude";
     try {
-        cachedClaudePath = parseClaudeLookupOutput(execSync(getClaudeLookupCommand(), { timeout: 5_000, stdio: "pipe" }));
+        const lookupOutput = execSync(getClaudeLookupCommand(), { timeout: 5_000, stdio: "pipe" });
+        const parsed = parseClaudeLookupOutput(lookupOutput, process.platform);
+        cachedClaudePath = normalizeClaudePathForSdk(parsed || fallback, process.platform);
     }
     catch {
-        cachedClaudePath = "claude"; // fall back to PATH resolution
+        cachedClaudePath = fallback;
     }
     return cachedClaudePath;
 }
@@ -433,6 +486,408 @@ async function promptTextInputElicitation(request, fields, ui, signal) {
     }
     return { action: "accept", content };
 }
+/**
+ * Known CLI tools where the subcommand verb changes the risk profile.
+ * Value = number of subcommand tokens (beyond the executable) to capture
+ * in the "Always Allow" permission pattern.
+ *
+ * `git push` and `git log` are very different → depth 1 → `Bash(git push:*)`
+ * `gh pr create` and `gh pr list` differ at depth 2 → `Bash(gh pr create:*)`
+ * `ping` is always safe → not listed → `Bash(ping:*)`
+ */
+const SUBCOMMAND_DEPTH = {
+    git: 1,
+    gh: 2,
+    npm: 1,
+    npx: 1,
+    yarn: 1,
+    pnpm: 1,
+    docker: 1,
+    kubectl: 1,
+    aws: 2,
+    az: 2,
+    gcloud: 2,
+    cargo: 1,
+    pip: 1,
+    pip3: 1,
+    brew: 1,
+    terraform: 1,
+    helm: 1,
+    dotnet: 1,
+};
+/** Command wrappers to skip when extracting the base executable. */
+const CMD_PASSTHROUGH = new Set(["sudo", "env", "command"]);
+/**
+ * Build a smart permission pattern for Bash "Always Allow".
+ *
+ * Simple commands → `Bash(ping:*)` (any args are fine)
+ * Subcommand-sensitive CLIs → `Bash(git push:*)` (verb is captured, args wildcarded)
+ */
+export function buildBashPermissionPattern(command) {
+    // When the command is a chain like "cd /foo && gh pr list", extract the
+    // last segment — `cd` is just setup, the meaningful operation is what follows.
+    const segments = command.split(/\s*(?:&&|\|\||;)\s*/);
+    // Skip leading `cd` (directory setup) and trailing error suppressors
+    // like `|| true`, `|| :`, `|| echo ...`.  The meaningful command is
+    // the first segment that is *neither* of those.
+    const SETUP_RE = /^\s*cd\s/;
+    const SUPPRESSOR_RE = /^\s*(?:true|:|echo\b)/;
+    let meaningful;
+    if (segments.length > 1) {
+        // Strip suppressors, then strip cd prefixes; take the *last* remaining
+        // segment — that's the meaningful command.
+        const trimmed = segments.filter(s => !SUPPRESSOR_RE.test(s));
+        const core = trimmed.filter(s => !SETUP_RE.test(s));
+        meaningful = core.length > 0 ? core[core.length - 1] : trimmed[trimmed.length - 1];
+    }
+    meaningful = meaningful || segments[0] || command;
+    const rawTokens = meaningful.trim().split(/\s+/);
+    // Skip sudo/env wrappers and leading VAR=val assignments
+    let idx = 0;
+    while (idx < rawTokens.length) {
+        if (CMD_PASSTHROUGH.has(rawTokens[idx])) {
+            idx++;
+            continue;
+        }
+        if (/^[A-Za-z_]\w*=/.test(rawTokens[idx])) {
+            idx++;
+            continue;
+        }
+        break;
+    }
+    const tokens = rawTokens.slice(idx).filter(Boolean);
+    if (tokens.length === 0)
+        return "Bash(*)";
+    // Strip path and .exe from executable name
+    const base = tokens[0].replace(/^.*[\\/]/, "").replace(/\.exe$/i, "");
+    const depth = SUBCOMMAND_DEPTH[base];
+    if (depth !== undefined) {
+        // Capture base + N subcommand tokens: "gh pr list" → Bash(gh pr list:*)
+        const significant = [base, ...tokens.slice(1, 1 + depth)].join(" ");
+        return `Bash(${significant}:*)`;
+    }
+    // Simple command — any args are fine: "ping" → Bash(ping:*)
+    return `Bash(${base}:*)`;
+}
+/**
+ * Build the list of granularity options presented after a user chooses
+ * "Always Allow" for a Bash command.
+ *
+ * Rather than assuming the user wants the default smart pattern, the UI
+ * shows every meaningful prefix so the user explicitly picks the scope:
+ *
+ *   "gh pr list --limit 5" → [
+ *     "Bash(gh:*)",         // allow any gh command
+ *     "Bash(gh pr:*)",      // allow any gh pr subcommand
+ *     "Bash(gh pr list:*)", // allow just this verb
+ *   ]
+ *
+ * Flags (tokens starting with `-`) terminate the subcommand chain — they
+ * are call-site arguments, not stable verbs. Subcommand depth is capped
+ * at 3 to keep the menu short (max 4 options).
+ *
+ * Returns a single-entry list when there is no meaningful subcommand to
+ * choose from (e.g. `ls -la`). Callers can skip the second dialog in
+ * that case.
+ */
+export function buildBashPermissionPatternOptions(command) {
+    const segments = command.split(/\s*(?:&&|\|\||;)\s*/);
+    const SETUP_RE = /^\s*cd\s/;
+    const SUPPRESSOR_RE = /^\s*(?:true|:|echo\b)/;
+    let meaningful;
+    if (segments.length > 1) {
+        const trimmed = segments.filter(s => !SUPPRESSOR_RE.test(s));
+        const core = trimmed.filter(s => !SETUP_RE.test(s));
+        meaningful = core.length > 0 ? core[core.length - 1] : trimmed[trimmed.length - 1];
+    }
+    meaningful = meaningful || segments[0] || command;
+    const rawTokens = meaningful.trim().split(/\s+/);
+    let idx = 0;
+    while (idx < rawTokens.length) {
+        if (CMD_PASSTHROUGH.has(rawTokens[idx])) {
+            idx++;
+            continue;
+        }
+        if (/^[A-Za-z_]\w*=/.test(rawTokens[idx])) {
+            idx++;
+            continue;
+        }
+        break;
+    }
+    const tokens = rawTokens.slice(idx).filter(Boolean);
+    if (tokens.length === 0)
+        return ["Bash(*)"];
+    const base = tokens[0].replace(/^.*[\\/]/, "").replace(/\.exe$/i, "");
+    // Collect up to 3 subcommand tokens, stopping at the first flag.
+    const subTokens = [];
+    for (let i = 1; i < tokens.length; i++) {
+        const t = tokens[i];
+        if (t.startsWith("-"))
+            break;
+        subTokens.push(t);
+        if (subTokens.length >= 3)
+            break;
+    }
+    const patterns = [`Bash(${base}:*)`];
+    for (let i = 1; i <= subTokens.length; i++) {
+        patterns.push(`Bash(${[base, ...subTokens.slice(0, i)].join(" ")}:*)`);
+    }
+    return patterns;
+}
+/**
+ * Read Bash allow-rule patterns from project and user settings files.
+ *
+ * Returns the ruleContent portion (e.g. `"gh pr list:*"`) for each
+ * `Bash(...)` entry found in `permissions.allow`.
+ */
+function readBashAllowRulesFromSettings() {
+    const rules = [];
+    const paths = [
+        join(process.cwd(), ".claude", "settings.local.json"),
+        join(process.cwd(), ".claude", "settings.json"),
+    ];
+    try {
+        paths.push(join(homedir(), ".claude", "settings.json"));
+    }
+    catch {
+        // homedir() can throw on some platforms
+    }
+    for (const settingsPath of paths) {
+        try {
+            if (!existsSync(settingsPath))
+                continue;
+            const raw = JSON.parse(readFileSync(settingsPath, "utf8"));
+            const allow = raw?.permissions?.allow;
+            if (!Array.isArray(allow))
+                continue;
+            for (const entry of allow) {
+                if (typeof entry !== "string")
+                    continue;
+                const m = /^Bash\((.+)\)$/.exec(entry);
+                if (m)
+                    rules.push(m[1]);
+            }
+        }
+        catch {
+            // Ignore malformed settings files
+        }
+    }
+    return rules;
+}
+/**
+ * Check if a Bash compound command matches saved allow rules after
+ * extracting the meaningful segment.
+ *
+ * The SDK's built-in matcher refuses to match prefix rules against
+ * compound commands (e.g. `cd /path && gh pr list`). Claude Code
+ * routinely prepends `cd <cwd> &&` to commands, causing saved rules
+ * to never match on re-invocation. This function strips safe leading
+ * segments (only `cd` commands) and checks the remaining operation
+ * against saved rules.
+ *
+ * For compound commands, returns true only when all leading segments
+ * are `cd` commands and the final segment matches a saved rule.
+ * For simple (single-segment) commands, checks directly against saved
+ * rules — this covers the case where a rule was added mid-session and
+ * the SDK's in-memory cache is stale.
+ */
+export function bashCommandMatchesSavedRules(command) {
+    const segments = command.split(/\s*(?:&&|\|\||;)\s*/).filter(Boolean);
+    if (segments.length === 0)
+        return false;
+    let meaningful;
+    if (segments.length === 1) {
+        meaningful = segments[0].trim();
+    }
+    else {
+        // Strip trailing error suppressors (|| true, || :, || echo ...)
+        // and leading cd segments.  The first remaining segment is the
+        // meaningful command.  All other non-cd, non-suppressor segments
+        // must be absent — otherwise we can't safely auto-approve.
+        const SETUP_RE = /^cd\s/;
+        const SUPPRESSOR_RE = /^\s*(?:true|:|echo\b)/;
+        const trimmed = segments.filter(s => !SUPPRESSOR_RE.test(s.trim()));
+        const core = trimmed.filter(s => !SETUP_RE.test(s.trim()));
+        if (core.length !== 1)
+            return false; // ambiguous — multiple real commands
+        meaningful = core[0].trim();
+    }
+    if (!meaningful)
+        return false;
+    const rules = readBashAllowRulesFromSettings();
+    if (rules.length === 0)
+        return false;
+    for (const rule of rules) {
+        const prefixMatch = /^(.+):\*$/.exec(rule);
+        if (prefixMatch) {
+            const prefix = prefixMatch[1];
+            if (meaningful === prefix || meaningful.startsWith(prefix + " ")) {
+                return true;
+            }
+            continue;
+        }
+        // Exact match
+        if (meaningful === rule)
+            return true;
+    }
+    return false;
+}
+/** Format the tool input into a human-readable summary for the permission prompt. */
+function formatToolInput(toolName, input) {
+    // Bash — show the command
+    if (input.command && typeof input.command === "string") {
+        const cmd = input.command.length > 300 ? input.command.slice(0, 300) + "…" : input.command;
+        return cmd;
+    }
+    // File-oriented tools — show path
+    if (input.file_path && typeof input.file_path === "string") {
+        return `${toolName}: ${input.file_path}`;
+    }
+    // Generic fallback — compact JSON, truncated
+    const json = JSON.stringify(input);
+    if (json.length <= 200)
+        return json;
+    return json.slice(0, 200) + "…";
+}
+/**
+ * Create a canUseTool handler that routes SDK permission requests through the
+ * extension UI's select dialog, or auto-approves when no UI is available.
+ *
+ * Presents three options:
+ * - **Allow** — approve this one invocation
+ * - **Always Allow** — approve and pass `suggestions` back as `updatedPermissions`
+ *   so the SDK remembers the choice for the rest of the session
+ * - **Deny** — reject the invocation
+ *
+ * Follows the same pattern as {@link createClaudeCodeElicitationHandler}:
+ * takes an optional UI context and returns the callback or undefined.
+ *
+ * When UI is unavailable (headless / auto-mode sub-agents), returns a handler
+ * that always approves — replacing the old GSD_AUTO_MODE → bypassPermissions
+ * workaround.
+ */
+export function createClaudeCodeCanUseToolHandler(ui) {
+    if (!ui)
+        return undefined;
+    return async (toolName, _input, options) => {
+        // Abort early if the signal is already fired
+        if (options.signal.aborted) {
+            return { behavior: "deny", message: "Aborted", toolUseID: options.toolUseID };
+        }
+        // For Bash compound commands (e.g. "cd /path && gh pr list"),
+        // check if the meaningful operation matches a saved allow rule.
+        // The SDK's built-in matcher rejects prefix rules for compound
+        // commands, but cd-prefixed commands are routine and the actual
+        // operation is already approved.
+        if (toolName === "Bash" && typeof _input.command === "string") {
+            if (bashCommandMatchesSavedRules(_input.command)) {
+                return { behavior: "allow", updatedInput: _input, toolUseID: options.toolUseID };
+            }
+        }
+        const inputSummary = formatToolInput(toolName, _input);
+        const title = options.title || `Allow Claude Code to use: ${toolName}?`;
+        const body = [
+            options.description,
+            inputSummary,
+        ].filter(Boolean).join("\n");
+        // The 2nd menu (level picker) lets the user choose the exact pattern,
+        // so the 1st menu just shows "Always Allow" without a command suffix.
+        const alwaysAllowLabel = "Always Allow";
+        try {
+            const choice = await ui.select(`${title}\n${body}`, ["Allow", alwaysAllowLabel, "Deny"], { signal: options.signal });
+            if (options.signal.aborted) {
+                return { behavior: "deny", message: "Aborted", toolUseID: options.toolUseID };
+            }
+            if (choice === alwaysAllowLabel) {
+                // Pass the SDK's own suggestions back as updatedPermissions so
+                // it knows how to persist them (PermissionUpdate[] shape).
+                // For Bash, patch the ruleContent with the user-chosen
+                // granularity pattern (e.g. "gh", "gh pr", "gh pr list") so
+                // the saved rule matches the scope the user actually wants.
+                let perms = options.suggestions;
+                let notifyLabel;
+                if (toolName === "Bash" && typeof _input.command === "string") {
+                    // Present every meaningful prefix so the user picks the
+                    // scope explicitly rather than getting a blanket match.
+                    const patternOptions = buildBashPermissionPatternOptions(_input.command);
+                    let chosenPattern;
+                    if (patternOptions.length <= 1) {
+                        // No subcommand choice to make (e.g. "ls -la") — use
+                        // the single available pattern directly.
+                        chosenPattern = patternOptions[0] ?? buildBashPermissionPattern(_input.command);
+                    }
+                    else {
+                        const levelChoiceRaw = await ui.select("Save permission at which level?", patternOptions, { signal: options.signal });
+                        if (options.signal.aborted) {
+                            return { behavior: "deny", message: "Aborted", toolUseID: options.toolUseID };
+                        }
+                        const levelChoice = Array.isArray(levelChoiceRaw) ? levelChoiceRaw[0] : levelChoiceRaw;
+                        if (!levelChoice || !patternOptions.includes(levelChoice)) {
+                            // User dismissed the level picker — cancel the
+                            // tool use. Falling back to a one-time allow
+                            // here would leave the spawned agent running
+                            // with no clear signal that the user bailed.
+                            return {
+                                behavior: "deny",
+                                message: "User cancelled permission selection",
+                                toolUseID: options.toolUseID,
+                            };
+                        }
+                        chosenPattern = levelChoice;
+                    }
+                    notifyLabel = chosenPattern;
+                    // Extract the ruleContent portion from "Bash(gh pr list:*)" → "gh pr list:*"
+                    const ruleContent = chosenPattern.replace(/^Bash\(/, "").replace(/\)$/, "");
+                    if (perms && Array.isArray(perms) && perms.length > 0) {
+                        // Clone suggestions and patch ruleContent on any Bash addRules entry
+                        perms = perms.map((s) => {
+                            if (s.type === "addRules" && Array.isArray(s.rules)) {
+                                return {
+                                    ...s,
+                                    rules: s.rules.map((r) => r.toolName === "Bash" ? { ...r, ruleContent } : r),
+                                };
+                            }
+                            return s;
+                        });
+                    }
+                    else {
+                        // No suggestions from SDK — build a proper PermissionUpdate
+                        perms = [{
+                                type: "addRules",
+                                rules: [{ toolName: "Bash", ruleContent }],
+                                behavior: "allow",
+                                destination: "localSettings",
+                            }];
+                    }
+                }
+                // Notify with the resolved pattern (label already previewed it)
+                if (notifyLabel) {
+                    ui.notify(`Saved: ${notifyLabel}`, "info");
+                }
+                return {
+                    behavior: "allow",
+                    updatedInput: _input,
+                    toolUseID: options.toolUseID,
+                    ...(perms ? { updatedPermissions: perms } : {}),
+                };
+            }
+            if (choice === "Allow") {
+                return {
+                    behavior: "allow",
+                    updatedInput: _input,
+                    toolUseID: options.toolUseID,
+                };
+            }
+            return { behavior: "deny", message: "User denied", toolUseID: options.toolUseID };
+        }
+        catch {
+            return { behavior: "deny", message: "Aborted", toolUseID: options.toolUseID };
+        }
+    };
+}
+// ---------------------------------------------------------------------------
+// Elicitation handler
+// ---------------------------------------------------------------------------
 /** Create an SDK elicitation handler that routes requests through the extension UI dialogs, or undefined if no UI is available. */
 export function createClaudeCodeElicitationHandler(ui) {
     if (!ui)
@@ -862,12 +1317,21 @@ async function pumpSdkMessages(model, context, options, stream) {
         const prompt = buildPromptFromContext(context);
         const queryPrompt = buildSdkQueryPrompt(context, prompt);
         const permissionMode = await resolveClaudePermissionMode();
-        const sdkOpts = buildSdkOptions(modelId, prompt, { permissionMode }, typeof options?.extensionUIContext === "object"
-            ? {
-                reasoning: options?.reasoning,
-                onElicitation: createClaudeCodeElicitationHandler(options?.extensionUIContext),
-            }
-            : { reasoning: options?.reasoning });
+        const uiContext = options?.extensionUIContext;
+        const canUseToolHandler = createClaudeCodeCanUseToolHandler(uiContext);
+        // When no UI is available (headless / auto-mode), auto-approve all
+        // tool requests. This replaces the old bypassPermissions workaround.
+        const canUseToolFallback = canUseToolHandler
+            ?? (async (_toolName, _input, opts) => ({ behavior: "allow", toolUseID: opts.toolUseID }));
+        const sdkOpts = buildSdkOptions(modelId, prompt, { permissionMode }, {
+            reasoning: options?.reasoning,
+            canUseTool: canUseToolFallback,
+            ...(uiContext
+                ? {
+                    onElicitation: createClaudeCodeElicitationHandler(uiContext),
+                }
+                : {}),
+        });
         const queryResult = sdk.query({
             prompt: queryPrompt,
             options: {

package/dist/resources/extensions/github-sync/templates.js

@@ -116,3 +116,106 @@ export function formatSummaryComment(data) {
     }
     return lines.join("\n");
 }
+export const SWARM_LANE_LABELS = {
+    workflow: "lane/workflow",
+    state: "lane/state",
+    writer: "lane/writer",
+    uok: "lane/uok",
+    github: "lane/github",
+};
+function checkedList(items, emptyLabel) {
+    if (!items?.length)
+        return [`- [ ] ${emptyLabel}`];
+    return items.map((item) => `- [ ] ${item}`);
+}
+export function formatSwarmLanePRBody(data) {
+    const lines = [];
+    const laneLabel = SWARM_LANE_LABELS[data.lane.id];
+    lines.push("## Swarm lane");
+    lines.push("");
+    lines.push(`**Lane:** \`${laneLabel}\``);
+    lines.push(`**Branch:** \`${data.lane.branch}\``);
+    if (data.lane.owner)
+        lines.push(`**Owner:** ${data.lane.owner}`);
+    if (data.lane.latestCommit)
+        lines.push(`**Latest commit:** \`${data.lane.latestCommit}\``);
+    lines.push("");
+    lines.push("## Impact area");
+    lines.push("");
+    lines.push(data.impactArea);
+    lines.push("");
+    lines.push("## Changed contracts");
+    lines.push(...checkedList(data.lane.changedContracts, "No shared contracts changed"));
+    lines.push("");
+    lines.push("## Transition risks");
+    lines.push(...checkedList(data.transitionRisks, "No transition risks identified"));
+    lines.push("");
+    lines.push("## Rollback plan");
+    lines.push(...checkedList(data.rollbackPlan, "Revert this lane PR"));
+    lines.push("");
+    lines.push("## Test evidence");
+    lines.push(...checkedList(data.lane.testEvidence, "Test evidence pending"));
+    lines.push("");
+    if (data.lane.blockers?.length) {
+        lines.push("## Blockers");
+        for (const blocker of data.lane.blockers)
+            lines.push(`- ${blocker}`);
+        lines.push("");
+    }
+    if (data.linkedIssue) {
+        lines.push(`Closes #${data.linkedIssue}`);
+        lines.push("");
+    }
+    lines.push("---");
+    lines.push("*Auto-generated by GSD GitHub Sync swarm routines*");
+    return lines.join("\n");
+}
+export function formatSwarmReleaseChecklistBody(data) {
+    const lines = [];
+    lines.push(`# UOK Swarm Release Checklist`);
+    lines.push("");
+    lines.push(`**Integration branch:** \`${data.integrationBranch}\``);
+    lines.push("");
+    lines.push("## Lane summary");
+    lines.push("");
+    lines.push("| Lane | Branch | Owner | Commit | Status |");
+    lines.push("|------|--------|-------|--------|--------|");
+    for (const lane of data.lanes) {
+        const owner = lane.owner ?? "";
+        const commit = lane.latestCommit ? `\`${lane.latestCommit}\`` : "";
+        const status = lane.blockers?.length ? "blocked" : "ready";
+        lines.push(`| \`${SWARM_LANE_LABELS[lane.id]}\` | \`${lane.branch}\` | ${owner} | ${commit} | ${status} |`);
+    }
+    lines.push("");
+    lines.push("## Required evidence");
+    lines.push("- [ ] Changed contracts summarized");
+    lines.push("- [ ] Transition matrix diff attached or linked");
+    lines.push("- [ ] Writer sequence proof attached or linked");
+    lines.push("- [ ] UOK parity report attached or linked");
+    lines.push("- [ ] Rollback drill evidence attached or linked");
+    lines.push("");
+    if (data.requiredChecks?.length) {
+        lines.push("## Required checks");
+        for (const check of data.requiredChecks)
+            lines.push(`- [ ] ${check}`);
+        lines.push("");
+    }
+    lines.push("## Parity report");
+    lines.push(data.parityReport ?? "Pending.");
+    lines.push("");
+    lines.push("## Rollback drill");
+    lines.push(data.rollbackDrill ?? "Pending.");
+    lines.push("");
+    lines.push("## Open risks");
+    if (data.openRisks?.length) {
+        for (const risk of data.openRisks)
+            lines.push(`- ${risk}`);
+    }
+    else {
+        lines.push("None.");
+    }
+    lines.push("");
+    lines.push("---");
+    lines.push("*Auto-generated by GSD GitHub Sync swarm routines*");
+    return lines.join("\n");
+}

package/dist/resources/extensions/google-search/index.js

@@ -1,6 +1,7 @@
 export default function (pi) {
     pi.on("session_start", async (_event, ctx) => {
-        ctx.ui.notify("google_search has moved to @gsd-extensions/google-search. " +
-            "Install: gsd extensions install @gsd-extensions/google-search", "warning");
+        ctx.ui.notify("google_search is being extracted to @gsd-extensions/google-search " +
+            "(not yet published to npm). This stub will be replaced once the " +
+            "package is available. No action needed for now.", "warning");
     });
 }