gsd-pi 2.76.0-dev.fe143342a → 2.77.0-dev.1d17f366c

package/src/resources/extensions/cmux/index.ts

@@ -2,8 +2,12 @@ import { execFileSync, spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import type { GSDPreferences } from "../gsd/preferences.js";
-import type { GSDState, Phase } from "../gsd/types.js";
+import { CMUX_CHANNELS, type CmuxSidebarEvent, type CmuxLogEvent, type CmuxPreferencesInput, type CmuxStateInput } from "../shared/cmux-events.js";
+import type { EventBus } from "@gsd/pi-coding-agent";
+
+type CmuxPreferences = CmuxPreferencesInput;
+type CmuxState = CmuxStateInput;
+type Phase = string;
 const DEFAULT_SOCKET_PATH = "/tmp/cmux.sock";
 const STATUS_KEY = "gsd";
 const lastSidebarSnapshots = new Map<string, string>();
@@ -52,7 +56,7 @@ export function detectCmuxEnvironment(
 }
 
 export function resolveCmuxConfig(
-  preferences: GSDPreferences | undefined,
+  preferences: CmuxPreferences | undefined,
   env: NodeJS.ProcessEnv = process.env,
   socketExists: (path: string) => boolean = existsSync,
   cliAvailable: () => boolean = isCmuxCliAvailable,
@@ -71,7 +75,7 @@ export function resolveCmuxConfig(
 }
 
 export function shouldPromptToEnableCmux(
-  preferences: GSDPreferences | undefined,
+  preferences: CmuxPreferences | undefined,
   env: NodeJS.ProcessEnv = process.env,
   socketExists: (path: string) => boolean = existsSync,
   cliAvailable: () => boolean = isCmuxCliAvailable,
@@ -113,7 +117,7 @@ export function emitOsc777Notification(title: string, body: string): void {
   process.stdout.write(`\x1b]777;notify;${safeTitle};${safeBody}\x07`);
 }
 
-export function buildCmuxStatusLabel(state: GSDState): string {
+export function buildCmuxStatusLabel(state: CmuxState): string {
   const parts: string[] = [];
   if (state.activeMilestone) parts.push(state.activeMilestone.id);
   if (state.activeSlice) parts.push(state.activeSlice.id);
@@ -125,7 +129,7 @@ export function buildCmuxStatusLabel(state: GSDState): string {
   return `${parts.join(" ")} · ${state.phase}`;
 }
 
-export function buildCmuxProgress(state: GSDState): CmuxSidebarProgress | null {
+export function buildCmuxProgress(state: CmuxState): CmuxSidebarProgress | null {
   const progress = state.progress;
   if (!progress) return null;
 
@@ -171,7 +175,7 @@ export class CmuxClient {
     this.config = config;
   }
 
-  static fromPreferences(preferences: GSDPreferences | undefined): CmuxClient {
+  static fromPreferences(preferences: CmuxPreferences | undefined): CmuxClient {
     return new CmuxClient(resolveCmuxConfig(preferences));
   }
 
@@ -372,7 +376,7 @@ export class CmuxClient {
   }
 }
 
-export function syncCmuxSidebar(preferences: GSDPreferences | undefined, state: GSDState): void {
+export function syncCmuxSidebar(preferences: CmuxPreferences | undefined, state: CmuxState): void {
   const client = CmuxClient.fromPreferences(preferences);
   const config = client.getConfig();
   if (!config.sidebar) return;
@@ -388,7 +392,7 @@ export function syncCmuxSidebar(preferences: GSDPreferences | undefined, state:
   lastSidebarSnapshots.set(key, snapshot);
 }
 
-export function clearCmuxSidebar(preferences: GSDPreferences | undefined): void {
+export function clearCmuxSidebar(preferences: CmuxPreferences | undefined): void {
   const config = resolveCmuxConfig(preferences);
   if (!config.available || !config.cliAvailable) return;
   const client = new CmuxClient({ ...config, enabled: true, sidebar: true });
@@ -399,7 +403,7 @@ export function clearCmuxSidebar(preferences: GSDPreferences | undefined): void
 }
 
 export function logCmuxEvent(
-  preferences: GSDPreferences | undefined,
+  preferences: CmuxPreferences | undefined,
   message: string,
   level: CmuxLogLevel = "info",
 ): void {
@@ -446,3 +450,24 @@ function extractSurfaceIds(value: unknown): string[] {
   visit(value);
   return Array.from(found);
 }
+
+/**
+ * Wire event subscriptions so cmux reacts to gsd events.
+ * Called by the gsd extension during registration, passing pi.events.
+ */
+export function initCmuxEventListeners(events: EventBus): void {
+  events.on(CMUX_CHANNELS.SIDEBAR, (data) => {
+    const event = data as CmuxSidebarEvent;
+    if (event.action === "sync" && event.state) {
+      syncCmuxSidebar(event.preferences as CmuxPreferences | undefined, event.state as CmuxState);
+    }
+    if (event.action === "clear") {
+      clearCmuxSidebar(event.preferences as CmuxPreferences | undefined);
+    }
+  });
+
+  events.on(CMUX_CHANNELS.LOG, (data) => {
+    const event = data as CmuxLogEvent;
+    logCmuxEvent(event.preferences as CmuxPreferences | undefined, event.message, event.level);
+  });
+}

package/src/resources/extensions/github-sync/templates.ts

@@ -181,3 +181,154 @@ export function formatSummaryComment(data: SummaryData): string {
 
   return lines.join("\n");
 }
+
+// ─── Swarm Delivery Routines ───────────────────────────────────────────────
+
+export type SwarmLaneId = "workflow" | "state" | "writer" | "uok" | "github";
+
+export interface SwarmLaneData {
+  id: SwarmLaneId;
+  branch: string;
+  owner?: string;
+  latestCommit?: string;
+  summary?: string;
+  changedContracts?: string[];
+  testEvidence?: string[];
+  blockers?: string[];
+}
+
+export interface SwarmLanePRData {
+  lane: SwarmLaneData;
+  impactArea: string;
+  transitionRisks: string[];
+  rollbackPlan: string[];
+  linkedIssue?: number;
+}
+
+export interface SwarmReleaseChecklistData {
+  integrationBranch: string;
+  lanes: SwarmLaneData[];
+  parityReport?: string;
+  rollbackDrill?: string;
+  requiredChecks?: string[];
+  openRisks?: string[];
+}
+
+export const SWARM_LANE_LABELS: Record<SwarmLaneId, string> = {
+  workflow: "lane/workflow",
+  state: "lane/state",
+  writer: "lane/writer",
+  uok: "lane/uok",
+  github: "lane/github",
+};
+
+function checkedList(items: string[] | undefined, emptyLabel: string): string[] {
+  if (!items?.length) return [`- [ ] ${emptyLabel}`];
+  return items.map((item) => `- [ ] ${item}`);
+}
+
+export function formatSwarmLanePRBody(data: SwarmLanePRData): string {
+  const lines: string[] = [];
+  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: SwarmReleaseChecklistData): string {
+  const lines: string[] = [];
+
+  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/src/resources/extensions/github-sync/tests/templates.test.ts

@@ -5,6 +5,9 @@ import {
   formatSlicePRBody,
   formatTaskIssueBody,
   formatSummaryComment,
+  formatSwarmLanePRBody,
+  formatSwarmReleaseChecklistBody,
+  SWARM_LANE_LABELS,
 } from "../templates.ts";
 
 describe("templates", () => {
@@ -107,4 +110,60 @@ describe("templates", () => {
       assert.equal(typeof comment, "string");
     });
   });
+
+  describe("swarm delivery routines", () => {
+    it("formats lane PR bodies with impact, risks, rollback, and evidence", () => {
+      const body = formatSwarmLanePRBody({
+        lane: {
+          id: "writer",
+          branch: "lane/single-writer",
+          owner: "@owner",
+          latestCommit: "abc1234",
+          changedContracts: ["WriterToken"],
+          testEvidence: ["npm run typecheck:extensions"],
+        },
+        impactArea: "Single-writer UOK metadata.",
+        transitionRisks: ["Writer token lifecycle regression"],
+        rollbackPlan: ["Disable writer sequence enrichment"],
+        linkedIssue: 123,
+      });
+
+      assert.ok(body.includes("`lane/writer`"));
+      assert.ok(body.includes("Single-writer UOK metadata."));
+      assert.ok(body.includes("- [ ] Writer token lifecycle regression"));
+      assert.ok(body.includes("- [ ] Disable writer sequence enrichment"));
+      assert.ok(body.includes("- [ ] npm run typecheck:extensions"));
+      assert.ok(body.includes("Closes #123"));
+    });
+
+    it("formats release checklist bodies from lane state", () => {
+      const body = formatSwarmReleaseChecklistBody({
+        integrationBranch: "integration/uok-swarm",
+        lanes: [
+          { id: "workflow", branch: "lane/workflow-engine", owner: "@a", latestCommit: "1111111" },
+          { id: "state", branch: "lane/state-machine", blockers: ["matrix gap"] },
+        ],
+        parityReport: "No critical mismatches.",
+        rollbackDrill: "Passed fallback drill.",
+        requiredChecks: ["unit", "integration"],
+      });
+
+      assert.ok(body.includes("`integration/uok-swarm`"));
+      assert.ok(body.includes("| `lane/workflow` | `lane/workflow-engine` | @a | `1111111` | ready |"));
+      assert.ok(body.includes("| `lane/state` | `lane/state-machine` |  |  | blocked |"));
+      assert.ok(body.includes("- [ ] UOK parity report attached or linked"));
+      assert.ok(body.includes("- [ ] unit"));
+      assert.ok(body.includes("Passed fallback drill."));
+    });
+
+    it("declares expected swarm lane labels for generated GitHub routines", () => {
+      assert.deepEqual(Object.values(SWARM_LANE_LABELS), [
+        "lane/workflow",
+        "lane/state",
+        "lane/writer",
+        "lane/uok",
+        "lane/github",
+      ]);
+    });
+  });
 });

package/src/resources/extensions/google-search/extension-manifest.json

@@ -1,12 +1,13 @@
 {
   "id": "google-search",
-  "name": "Google Search",
+  "name": "Google Search (deprecated stub)",
   "version": "1.0.0",
-  "description": "Web search via Google with AI-synthesized answers and source citations",
+  "description": "Deprecation stub. The google_search tool moved to @gsd-extensions/google-search. Install with: gsd extensions install @gsd-extensions/google-search",
   "tier": "bundled",
+  "deprecated": true,
   "requires": { "platform": ">=2.29.0" },
   "provides": {
-    "tools": ["google_search"],
-    "hooks": ["session_start", "session_shutdown"]
+    "tools": [],
+    "hooks": ["session_start"]
   }
 }