gsd-pi 2.36.0-dev.d612764 → 2.36.0-dev.f887f4e

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

@@ -1,384 +0,0 @@
-import { execFile, execFileSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { promisify } from "node:util";
-import type { GSDPreferences } from "../gsd/preferences.js";
-import type { GSDState, Phase } from "../gsd/types.js";
-
-const execFileAsync = promisify(execFile);
-const DEFAULT_SOCKET_PATH = "/tmp/cmux.sock";
-const STATUS_KEY = "gsd";
-const lastSidebarSnapshots = new Map<string, string>();
-let cmuxPromptedThisSession = false;
-let cachedCliAvailability: boolean | null = null;
-
-export interface CmuxEnvironment {
-  available: boolean;
-  cliAvailable: boolean;
-  socketPath: string;
-  workspaceId?: string;
-  surfaceId?: string;
-}
-
-export interface ResolvedCmuxConfig extends CmuxEnvironment {
-  enabled: boolean;
-  notifications: boolean;
-  sidebar: boolean;
-  splits: boolean;
-  browser: boolean;
-}
-
-export interface CmuxSidebarProgress {
-  value: number;
-  label: string;
-}
-
-export type CmuxLogLevel = "info" | "progress" | "success" | "warning" | "error";
-
-export function detectCmuxEnvironment(
-  env: NodeJS.ProcessEnv = process.env,
-  socketExists: (path: string) => boolean = existsSync,
-  cliAvailable: () => boolean = isCmuxCliAvailable,
-): CmuxEnvironment {
-  const socketPath = env.CMUX_SOCKET_PATH ?? DEFAULT_SOCKET_PATH;
-  const workspaceId = env.CMUX_WORKSPACE_ID?.trim() || undefined;
-  const surfaceId = env.CMUX_SURFACE_ID?.trim() || undefined;
-  const available = Boolean(workspaceId && surfaceId && socketExists(socketPath));
-  return {
-    available,
-    cliAvailable: cliAvailable(),
-    socketPath,
-    workspaceId,
-    surfaceId,
-  };
-}
-
-export function resolveCmuxConfig(
-  preferences: GSDPreferences | undefined,
-  env: NodeJS.ProcessEnv = process.env,
-  socketExists: (path: string) => boolean = existsSync,
-  cliAvailable: () => boolean = isCmuxCliAvailable,
-): ResolvedCmuxConfig {
-  const detected = detectCmuxEnvironment(env, socketExists, cliAvailable);
-  const cmux = preferences?.cmux ?? {};
-  const enabled = detected.available && cmux.enabled === true;
-  return {
-    ...detected,
-    enabled,
-    notifications: enabled && cmux.notifications !== false,
-    sidebar: enabled && cmux.sidebar !== false,
-    splits: enabled && cmux.splits === true,
-    browser: enabled && cmux.browser === true,
-  };
-}
-
-export function shouldPromptToEnableCmux(
-  preferences: GSDPreferences | undefined,
-  env: NodeJS.ProcessEnv = process.env,
-  socketExists: (path: string) => boolean = existsSync,
-  cliAvailable: () => boolean = isCmuxCliAvailable,
-): boolean {
-  if (cmuxPromptedThisSession) return false;
-  const detected = detectCmuxEnvironment(env, socketExists, cliAvailable);
-  if (!detected.available) return false;
-  return preferences?.cmux?.enabled === undefined;
-}
-
-export function markCmuxPromptShown(): void {
-  cmuxPromptedThisSession = true;
-}
-
-export function resetCmuxPromptState(): void {
-  cmuxPromptedThisSession = false;
-}
-
-export function isCmuxCliAvailable(): boolean {
-  if (cachedCliAvailability !== null) return cachedCliAvailability;
-  try {
-    execFileSync("cmux", ["--help"], { stdio: "ignore", timeout: 1000 });
-    cachedCliAvailability = true;
-  } catch {
-    cachedCliAvailability = false;
-  }
-  return cachedCliAvailability;
-}
-
-export function supportsOsc777Notifications(env: NodeJS.ProcessEnv = process.env): boolean {
-  const termProgram = env.TERM_PROGRAM?.toLowerCase() ?? "";
-  return termProgram === "ghostty" || termProgram === "wezterm" || termProgram === "iterm.app";
-}
-
-export function emitOsc777Notification(title: string, body: string): void {
-  if (!supportsOsc777Notifications()) return;
-  const safeTitle = normalizeNotificationText(title).replace(/;/g, ",");
-  const safeBody = normalizeNotificationText(body).replace(/;/g, ",");
-  process.stdout.write(`\x1b]777;notify;${safeTitle};${safeBody}\x07`);
-}
-
-export function buildCmuxStatusLabel(state: GSDState): string {
-  const parts: string[] = [];
-  if (state.activeMilestone) parts.push(state.activeMilestone.id);
-  if (state.activeSlice) parts.push(state.activeSlice.id);
-  if (state.activeTask) {
-    const prev = parts.pop();
-    parts.push(prev ? `${prev}/${state.activeTask.id}` : state.activeTask.id);
-  }
-  if (parts.length === 0) return state.phase;
-  return `${parts.join(" ")} · ${state.phase}`;
-}
-
-export function buildCmuxProgress(state: GSDState): CmuxSidebarProgress | null {
-  const progress = state.progress;
-  if (!progress) return null;
-
-  const choose = (done: number, total: number, label: string): CmuxSidebarProgress | null => {
-    if (total <= 0) return null;
-    return { value: Math.max(0, Math.min(1, done / total)), label: `${done}/${total} ${label}` };
-  };
-
-  return choose(progress.tasks?.done ?? 0, progress.tasks?.total ?? 0, "tasks")
-    ?? choose(progress.slices?.done ?? 0, progress.slices?.total ?? 0, "slices")
-    ?? choose(progress.milestones.done, progress.milestones.total, "milestones");
-}
-
-function phaseVisuals(phase: Phase): { icon: string; color: string } {
-  switch (phase) {
-    case "blocked":
-      return { icon: "triangle-alert", color: "#ef4444" };
-    case "paused":
-      return { icon: "pause", color: "#f59e0b" };
-    case "complete":
-    case "completing-milestone":
-      return { icon: "check", color: "#22c55e" };
-    case "planning":
-    case "researching":
-    case "replanning-slice":
-      return { icon: "compass", color: "#3b82f6" };
-    case "validating-milestone":
-    case "verifying":
-      return { icon: "shield-check", color: "#06b6d4" };
-    default:
-      return { icon: "rocket", color: "#4ade80" };
-  }
-}
-
-function sidebarSnapshotKey(config: ResolvedCmuxConfig): string {
-  return config.workspaceId ?? "default";
-}
-
-export class CmuxClient {
-  private readonly config: ResolvedCmuxConfig;
-
-  constructor(config: ResolvedCmuxConfig) {
-    this.config = config;
-  }
-
-  static fromPreferences(preferences: GSDPreferences | undefined): CmuxClient {
-    return new CmuxClient(resolveCmuxConfig(preferences));
-  }
-
-  getConfig(): ResolvedCmuxConfig {
-    return this.config;
-  }
-
-  private canRun(): boolean {
-    return this.config.available && this.config.cliAvailable;
-  }
-
-  private appendWorkspace(args: string[]): string[] {
-    return this.config.workspaceId ? [...args, "--workspace", this.config.workspaceId] : args;
-  }
-
-  private appendSurface(args: string[], surfaceId?: string): string[] {
-    return surfaceId ? [...args, "--surface", surfaceId] : args;
-  }
-
-  private runSync(args: string[]): string | null {
-    if (!this.canRun()) return null;
-    try {
-      return execFileSync("cmux", args, {
-        encoding: "utf-8",
-        timeout: 3000,
-        env: process.env,
-      });
-    } catch {
-      return null;
-    }
-  }
-
-  private async runAsync(args: string[]): Promise<string | null> {
-    if (!this.canRun()) return null;
-    try {
-      const result = await execFileAsync("cmux", args, {
-        encoding: "utf-8",
-        timeout: 5000,
-        env: process.env,
-      });
-      return result.stdout;
-    } catch {
-      return null;
-    }
-  }
-
-  getCapabilities(): unknown | null {
-    const stdout = this.runSync(["capabilities", "--json"]);
-    return stdout ? parseJson(stdout) : null;
-  }
-
-  identify(): unknown | null {
-    const stdout = this.runSync(["identify", "--json"]);
-    return stdout ? parseJson(stdout) : null;
-  }
-
-  setStatus(label: string, phase: Phase): void {
-    if (!this.config.sidebar) return;
-    const visuals = phaseVisuals(phase);
-    this.runSync(this.appendWorkspace([
-      "set-status",
-      STATUS_KEY,
-      label,
-      "--icon",
-      visuals.icon,
-      "--color",
-      visuals.color,
-    ]));
-  }
-
-  clearStatus(): void {
-    if (!this.config.sidebar) return;
-    this.runSync(this.appendWorkspace(["clear-status", STATUS_KEY]));
-  }
-
-  setProgress(progress: CmuxSidebarProgress | null): void {
-    if (!this.config.sidebar) return;
-    if (!progress) {
-      this.runSync(this.appendWorkspace(["clear-progress"]));
-      return;
-    }
-    this.runSync(this.appendWorkspace([
-      "set-progress",
-      progress.value.toFixed(3),
-      "--label",
-      progress.label,
-    ]));
-  }
-
-  log(message: string, level: CmuxLogLevel = "info", source = "gsd"): void {
-    if (!this.config.sidebar) return;
-    this.runSync(this.appendWorkspace([
-      "log",
-      "--level",
-      level,
-      "--source",
-      source,
-      "--",
-      message,
-    ]));
-  }
-
-  notify(title: string, body: string, subtitle?: string): boolean {
-    if (!this.config.notifications) return false;
-    const args = ["notify", "--title", title, "--body", body];
-    if (subtitle) args.push("--subtitle", subtitle);
-    return this.runSync(args) !== null;
-  }
-
-  async listSurfaceIds(): Promise<string[]> {
-    const stdout = await this.runAsync(this.appendWorkspace(["list-surfaces", "--json", "--id-format", "both"]));
-    const parsed = stdout ? parseJson(stdout) : null;
-    return extractSurfaceIds(parsed);
-  }
-
-  async createSplit(direction: "right" | "down" | "left" | "up"): Promise<string | null> {
-    if (!this.config.splits) return null;
-    const before = new Set(await this.listSurfaceIds());
-    const args = ["new-split", direction];
-    const scopedArgs = this.appendSurface(this.appendWorkspace(args), this.config.surfaceId);
-    await this.runAsync(scopedArgs);
-    const after = await this.listSurfaceIds();
-    for (const id of after) {
-      if (!before.has(id)) return id;
-    }
-    return null;
-  }
-
-  async sendSurface(surfaceId: string, text: string): Promise<boolean> {
-    const payload = text.endsWith("\n") ? text : `${text}\n`;
-    const stdout = await this.runAsync(["send-surface", "--surface", surfaceId, payload]);
-    return stdout !== null;
-  }
-}
-
-export function syncCmuxSidebar(preferences: GSDPreferences | undefined, state: GSDState): void {
-  const client = CmuxClient.fromPreferences(preferences);
-  const config = client.getConfig();
-  if (!config.sidebar) return;
-
-  const label = buildCmuxStatusLabel(state);
-  const progress = buildCmuxProgress(state);
-  const snapshot = JSON.stringify({ label, progress, phase: state.phase });
-  const key = sidebarSnapshotKey(config);
-  if (lastSidebarSnapshots.get(key) === snapshot) return;
-
-  client.setStatus(label, state.phase);
-  client.setProgress(progress);
-  lastSidebarSnapshots.set(key, snapshot);
-}
-
-export function clearCmuxSidebar(preferences: GSDPreferences | undefined): void {
-  const config = resolveCmuxConfig(preferences);
-  if (!config.available || !config.cliAvailable) return;
-  const client = new CmuxClient({ ...config, enabled: true, sidebar: true });
-  const key = sidebarSnapshotKey(config);
-  client.clearStatus();
-  client.setProgress(null);
-  lastSidebarSnapshots.delete(key);
-}
-
-export function logCmuxEvent(
-  preferences: GSDPreferences | undefined,
-  message: string,
-  level: CmuxLogLevel = "info",
-): void {
-  CmuxClient.fromPreferences(preferences).log(message, level);
-}
-
-export function shellEscape(value: string): string {
-  return `'${value.replace(/'/g, `'\\''`)}'`;
-}
-
-function normalizeNotificationText(value: string): string {
-  return value.replace(/\r?\n/g, " ").trim();
-}
-
-function parseJson(text: string): unknown {
-  try {
-    return JSON.parse(text);
-  } catch {
-    return null;
-  }
-}
-
-function extractSurfaceIds(value: unknown): string[] {
-  const found = new Set<string>();
-
-  const visit = (node: unknown): void => {
-    if (Array.isArray(node)) {
-      for (const item of node) visit(item);
-      return;
-    }
-    if (!node || typeof node !== "object") return;
-
-    for (const [key, child] of Object.entries(node as Record<string, unknown>)) {
-      if (
-        typeof child === "string"
-        && (key === "surface_id" || key === "surface" || (key === "id" && child.includes("surface")))
-      ) {
-        found.add(child);
-      }
-      visit(child);
-    }
-  };
-
-  visit(value);
-  return Array.from(found);
-}

package/src/resources/extensions/gsd/commands-cmux.ts

@@ -1,143 +0,0 @@
-import type { ExtensionCommandContext } from "@gsd/pi-coding-agent";
-import { existsSync, readFileSync } from "node:fs";
-import { clearCmuxSidebar, CmuxClient, detectCmuxEnvironment, resolveCmuxConfig } from "../cmux/index.js";
-import { saveFile } from "./files.js";
-import {
-  getProjectGSDPreferencesPath,
-  loadEffectiveGSDPreferences,
-  loadProjectGSDPreferences,
-} from "./preferences.js";
-import { ensurePreferencesFile, serializePreferencesToFrontmatter } from "./commands-prefs-wizard.js";
-
-function extractBodyAfterFrontmatter(content: string): string | null {
-  const start = content.startsWith("---\n") ? 4 : content.startsWith("---\r\n") ? 5 : -1;
-  if (start === -1) return null;
-  const closingIdx = content.indexOf("\n---", start);
-  if (closingIdx === -1) return null;
-  const after = content.slice(closingIdx + 4);
-  return after.trim() ? after : null;
-}
-
-async function writeProjectCmuxPreferences(
-  ctx: ExtensionCommandContext,
-  updater: (prefs: Record<string, unknown>) => void,
-): Promise<void> {
-  const path = getProjectGSDPreferencesPath();
-  await ensurePreferencesFile(path, ctx, "project");
-
-  const existing = loadProjectGSDPreferences();
-  const prefs: Record<string, unknown> = existing?.preferences ? { ...existing.preferences } : { version: 1 };
-  updater(prefs);
-  prefs.version = prefs.version || 1;
-
-  const frontmatter = serializePreferencesToFrontmatter(prefs);
-  let body = "\n# GSD Skill Preferences\n\nSee `~/.gsd/agent/extensions/gsd/docs/preferences-reference.md` for full field documentation and examples.\n";
-  if (existsSync(path)) {
-    const preserved = extractBodyAfterFrontmatter(readFileSync(path, "utf-8"));
-    if (preserved) body = preserved;
-  }
-
-  await saveFile(path, `---\n${frontmatter}---${body}`);
-  await ctx.waitForIdle();
-  await ctx.reload();
-}
-
-function formatCmuxStatus(): string {
-  const loaded = loadEffectiveGSDPreferences();
-  const detected = detectCmuxEnvironment();
-  const resolved = resolveCmuxConfig(loaded?.preferences);
-  const capabilities = new CmuxClient(resolved).getCapabilities() as Record<string, unknown> | null;
-  const accessMode = typeof capabilities?.mode === "string"
-    ? capabilities.mode
-    : typeof capabilities?.access_mode === "string"
-      ? capabilities.access_mode
-      : "unknown";
-  const methods = Array.isArray(capabilities?.methods) ? capabilities.methods.length : 0;
-
-  return [
-    "cmux status",
-    "",
-    `Detected: ${detected.available ? "yes" : "no"}`,
-    `Enabled: ${resolved.enabled ? "yes" : "no"}`,
-    `CLI available: ${detected.cliAvailable ? "yes" : "no"}`,
-    `Socket: ${detected.socketPath}`,
-    `Workspace: ${detected.workspaceId ?? "(none)"}`,
-    `Surface: ${detected.surfaceId ?? "(none)"}`,
-    `Features: notifications=${resolved.notifications ? "on" : "off"}, sidebar=${resolved.sidebar ? "on" : "off"}, splits=${resolved.splits ? "on" : "off"}, browser=${resolved.browser ? "on" : "off"}`,
-    `Capabilities: access=${accessMode}, methods=${methods}`,
-  ].join("\n");
-}
-
-function ensureCmuxAvailableForEnable(ctx: ExtensionCommandContext): boolean {
-  const detected = detectCmuxEnvironment();
-  if (detected.available) return true;
-  ctx.ui.notify(
-    "cmux not detected. Install it from https://cmux.com and run gsd inside a cmux terminal.",
-    "warning",
-  );
-  return false;
-}
-
-export async function handleCmux(args: string, ctx: ExtensionCommandContext): Promise<void> {
-  const trimmed = args.trim();
-  if (!trimmed || trimmed === "status") {
-    ctx.ui.notify(formatCmuxStatus(), "info");
-    return;
-  }
-
-  if (trimmed === "on") {
-    if (!ensureCmuxAvailableForEnable(ctx)) return;
-    await writeProjectCmuxPreferences(ctx, (prefs) => {
-      prefs.cmux = {
-        enabled: true,
-        notifications: true,
-        sidebar: true,
-        splits: false,
-        browser: false,
-        ...((prefs.cmux as Record<string, unknown> | undefined) ?? {}),
-      };
-      (prefs.cmux as Record<string, unknown>).enabled = true;
-    });
-    ctx.ui.notify("cmux integration enabled in project preferences.", "info");
-    return;
-  }
-
-  if (trimmed === "off") {
-    const effective = loadEffectiveGSDPreferences()?.preferences;
-    await writeProjectCmuxPreferences(ctx, (prefs) => {
-      prefs.cmux = { ...((prefs.cmux as Record<string, unknown> | undefined) ?? {}), enabled: false };
-    });
-    clearCmuxSidebar(effective);
-    ctx.ui.notify("cmux integration disabled in project preferences.", "info");
-    return;
-  }
-
-  const parts = trimmed.split(/\s+/);
-  if (parts.length === 2 && ["notifications", "sidebar", "splits", "browser"].includes(parts[0]) && ["on", "off"].includes(parts[1])) {
-    const feature = parts[0] as "notifications" | "sidebar" | "splits" | "browser";
-    const enabled = parts[1] === "on";
-    if (enabled && !ensureCmuxAvailableForEnable(ctx)) return;
-
-    await writeProjectCmuxPreferences(ctx, (prefs) => {
-      const next = { ...((prefs.cmux as Record<string, unknown> | undefined) ?? {}) };
-      next[feature] = enabled;
-      if (enabled) next.enabled = true;
-      prefs.cmux = next;
-    });
-
-    if (!enabled && feature === "sidebar") {
-      clearCmuxSidebar(loadEffectiveGSDPreferences()?.preferences);
-    }
-
-    const note = feature === "browser" && enabled
-      ? " Browser surfaces are still a follow-up path."
-      : "";
-    ctx.ui.notify(`cmux ${feature} ${enabled ? "enabled" : "disabled"}.${note}`, "info");
-    return;
-  }
-
-  ctx.ui.notify(
-    "Usage: /gsd cmux <status|on|off|notifications on|notifications off|sidebar on|sidebar off|splits on|splits off|browser on|browser off>",
-    "info",
-  );
-}

package/src/resources/extensions/gsd/tests/cmux.test.ts

@@ -1,98 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import {
-  buildCmuxProgress,
-  buildCmuxStatusLabel,
-  detectCmuxEnvironment,
-  markCmuxPromptShown,
-  resetCmuxPromptState,
-  resolveCmuxConfig,
-  shouldPromptToEnableCmux,
-} from "../../cmux/index.ts";
-import type { GSDState } from "../types.ts";
-
-test("detectCmuxEnvironment requires workspace, surface, and socket", () => {
-  const detected = detectCmuxEnvironment(
-    {
-      CMUX_WORKSPACE_ID: "workspace:1",
-      CMUX_SURFACE_ID: "surface:2",
-      CMUX_SOCKET_PATH: "/tmp/cmux.sock",
-    },
-    (path) => path === "/tmp/cmux.sock",
-    () => true,
-  );
-  assert.equal(detected.available, true);
-  assert.equal(detected.cliAvailable, true);
-});
-
-test("resolveCmuxConfig enables only when preference and environment are both active", () => {
-  const config = resolveCmuxConfig(
-    { cmux: { enabled: true, notifications: true, sidebar: true, splits: true } },
-    {
-      CMUX_WORKSPACE_ID: "workspace:1",
-      CMUX_SURFACE_ID: "surface:2",
-      CMUX_SOCKET_PATH: "/tmp/cmux.sock",
-    },
-    () => true,
-    () => true,
-  );
-  assert.equal(config.enabled, true);
-  assert.equal(config.notifications, true);
-  assert.equal(config.sidebar, true);
-  assert.equal(config.splits, true);
-});
-
-test("shouldPromptToEnableCmux only prompts once per session", () => {
-  resetCmuxPromptState();
-  assert.equal(shouldPromptToEnableCmux({}, {}, () => false, () => true), false);
-
-  assert.equal(
-    shouldPromptToEnableCmux(
-      {},
-      {
-        CMUX_WORKSPACE_ID: "workspace:1",
-        CMUX_SURFACE_ID: "surface:2",
-        CMUX_SOCKET_PATH: "/tmp/cmux.sock",
-      },
-      () => true,
-      () => true,
-    ),
-    true,
-  );
-  markCmuxPromptShown();
-  assert.equal(
-    shouldPromptToEnableCmux(
-      {},
-      {
-        CMUX_WORKSPACE_ID: "workspace:1",
-        CMUX_SURFACE_ID: "surface:2",
-        CMUX_SOCKET_PATH: "/tmp/cmux.sock",
-      },
-      () => true,
-      () => true,
-    ),
-    false,
-  );
-  resetCmuxPromptState();
-});
-
-test("buildCmuxStatusLabel and progress prefer deepest active unit", () => {
-  const state: GSDState = {
-    activeMilestone: { id: "M001", title: "Milestone" },
-    activeSlice: { id: "S02", title: "Slice" },
-    activeTask: { id: "T03", title: "Task" },
-    phase: "executing",
-    recentDecisions: [],
-    blockers: [],
-    nextAction: "Keep going",
-    registry: [],
-    progress: {
-      milestones: { done: 0, total: 1 },
-      slices: { done: 1, total: 3 },
-      tasks: { done: 2, total: 5 },
-    },
-  };
-
-  assert.equal(buildCmuxStatusLabel(state), "M001 S02/T03 · executing");
-  assert.deepEqual(buildCmuxProgress(state), { value: 0.4, label: "2/5 tasks" });
-});