gsd-pi 2.38.0-dev.add4f78 → 2.38.0-dev.d533afb

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

@@ -0,0 +1,93 @@
+/**
+ * GitHub Sync extension for GSD.
+ *
+ * Opt-in extension that syncs GSD lifecycle events to GitHub:
+ * milestones → GH Milestones + tracking issues, slices → draft PRs,
+ * tasks → sub-issues with auto-close on commit.
+ *
+ * Integration happens via a single dynamic import in auto-post-unit.ts.
+ * This index registers a `/github-sync` command for manual bootstrap
+ * and status display.
+ */
+
+import type { ExtensionAPI } from "@gsd/pi-coding-agent";
+import { bootstrapSync } from "./sync.js";
+import { loadSyncMapping } from "./mapping.js";
+import { ghIsAvailable } from "./cli.js";
+
+export default function (pi: ExtensionAPI) {
+  pi.registerCommand("github-sync", {
+    description: "Bootstrap GitHub sync or show sync status",
+    handler: async (args: string, ctx) => {
+      const subcommand = args.trim().toLowerCase();
+
+      if (subcommand === "status") {
+        await showStatus(ctx);
+        return;
+      }
+
+      if (subcommand === "bootstrap" || subcommand === "") {
+        await runBootstrap(ctx);
+        return;
+      }
+
+      ctx.ui.notify(
+        "Usage: /github-sync [bootstrap|status]",
+        "info",
+      );
+    },
+  });
+}
+
+async function showStatus(ctx: import("@gsd/pi-coding-agent").ExtensionCommandContext) {
+  if (!ghIsAvailable()) {
+    ctx.ui.notify("GitHub sync: `gh` CLI not installed or not authenticated.", "warning");
+    return;
+  }
+
+  const mapping = loadSyncMapping(ctx.cwd);
+  if (!mapping) {
+    ctx.ui.notify("GitHub sync: No sync mapping found. Run `/github-sync bootstrap` to initialize.", "info");
+    return;
+  }
+
+  const milestoneCount = Object.keys(mapping.milestones).length;
+  const sliceCount = Object.keys(mapping.slices).length;
+  const taskCount = Object.keys(mapping.tasks).length;
+  const openMilestones = Object.values(mapping.milestones).filter(m => m.state === "open").length;
+  const openSlices = Object.values(mapping.slices).filter(s => s.state === "open").length;
+  const openTasks = Object.values(mapping.tasks).filter(t => t.state === "open").length;
+
+  ctx.ui.notify(
+    [
+      `GitHub sync: repo=${mapping.repo}`,
+      `  Milestones: ${milestoneCount} (${openMilestones} open)`,
+      `  Slices: ${sliceCount} (${openSlices} open)`,
+      `  Tasks: ${taskCount} (${openTasks} open)`,
+    ].join("\n"),
+    "info",
+  );
+}
+
+async function runBootstrap(ctx: import("@gsd/pi-coding-agent").ExtensionCommandContext) {
+  if (!ghIsAvailable()) {
+    ctx.ui.notify("GitHub sync: `gh` CLI not installed or not authenticated.", "warning");
+    return;
+  }
+
+  ctx.ui.notify("GitHub sync: bootstrapping...", "info");
+
+  try {
+    const counts = await bootstrapSync(ctx.cwd);
+    if (counts.milestones === 0 && counts.slices === 0 && counts.tasks === 0) {
+      ctx.ui.notify("GitHub sync: everything already synced (or no milestones found).", "info");
+    } else {
+      ctx.ui.notify(
+        `GitHub sync: created ${counts.milestones} milestone(s), ${counts.slices} slice(s), ${counts.tasks} task(s).`,
+        "info",
+      );
+    }
+  } catch (err) {
+    ctx.ui.notify(`GitHub sync bootstrap failed: ${err}`, "error");
+  }
+}

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

@@ -0,0 +1,81 @@
+/**
+ * Persistence layer for the GitHub sync mapping.
+ *
+ * The mapping lives at `.gsd/github-sync.json` and tracks which GSD
+ * entities have been synced to which GitHub entities (issues, PRs,
+ * milestones) along with their numbers and sync timestamps.
+ */
+
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { atomicWriteSync } from "../gsd/atomic-write.js";
+import type { SyncMapping, MilestoneSyncRecord, SliceSyncRecord, SyncEntityRecord } from "./types.js";
+
+const MAPPING_FILENAME = "github-sync.json";
+
+function mappingPath(basePath: string): string {
+  return join(basePath, ".gsd", MAPPING_FILENAME);
+}
+
+// ─── Load / Save ────────────────────────────────────────────────────────────
+
+export function loadSyncMapping(basePath: string): SyncMapping | null {
+  const path = mappingPath(basePath);
+  if (!existsSync(path)) return null;
+  try {
+    const raw = readFileSync(path, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed?.version !== 1) return null;
+    return parsed as SyncMapping;
+  } catch {
+    return null;
+  }
+}
+
+export function saveSyncMapping(basePath: string, mapping: SyncMapping): void {
+  const path = mappingPath(basePath);
+  atomicWriteSync(path, JSON.stringify(mapping, null, 2) + "\n");
+}
+
+export function createEmptyMapping(repo: string): SyncMapping {
+  return {
+    version: 1,
+    repo,
+    milestones: {},
+    slices: {},
+    tasks: {},
+  };
+}
+
+// ─── Accessors ──────────────────────────────────────────────────────────────
+
+export function getMilestoneRecord(mapping: SyncMapping, mid: string): MilestoneSyncRecord | null {
+  return mapping.milestones[mid] ?? null;
+}
+
+export function getSliceRecord(mapping: SyncMapping, mid: string, sid: string): SliceSyncRecord | null {
+  return mapping.slices[`${mid}/${sid}`] ?? null;
+}
+
+export function getTaskRecord(mapping: SyncMapping, mid: string, sid: string, tid: string): SyncEntityRecord | null {
+  return mapping.tasks[`${mid}/${sid}/${tid}`] ?? null;
+}
+
+export function getTaskIssueNumber(mapping: SyncMapping, mid: string, sid: string, tid: string): number | null {
+  const record = getTaskRecord(mapping, mid, sid, tid);
+  return record?.issueNumber ?? null;
+}
+
+// ─── Mutators ───────────────────────────────────────────────────────────────
+
+export function setMilestoneRecord(mapping: SyncMapping, mid: string, record: MilestoneSyncRecord): void {
+  mapping.milestones[mid] = record;
+}
+
+export function setSliceRecord(mapping: SyncMapping, mid: string, sid: string, record: SliceSyncRecord): void {
+  mapping.slices[`${mid}/${sid}`] = record;
+}
+
+export function setTaskRecord(mapping: SyncMapping, mid: string, sid: string, tid: string, record: SyncEntityRecord): void {
+  mapping.tasks[`${mid}/${sid}/${tid}`] = record;
+}