@pi-ohm/handoff 0.3.0

package/README.md

@@ -0,0 +1,7 @@
+# @pi-ohm/handoff
+
+Install only handoff + handoff visualizer support for Pi.
+
+```bash
+pi install npm:@pi-ohm/handoff
+```

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@pi-ohm/handoff",
+  "version": "0.3.0",
+  "type": "module",
+  "main": "src/extension.ts",
+  "types": "src/extension.ts",
+  "files": [
+    "src/",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./src/extension.ts"
+    ]
+  },
+  "dependencies": {
+    "@mariozechner/pi-coding-agent": "^0.52.0",
+    "@pi-ohm/config": "^0.3.0"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/src/extension.ts

@@ -0,0 +1,66 @@
+import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { loadOhmRuntimeConfig, registerOhmSettings } from "@pi-ohm/config";
+
+function renderHandoffMapWidget(ctx: ExtensionContext, visible: boolean): void {
+  if (!ctx.hasUI) return;
+
+  if (!visible) {
+    ctx.ui.setWidget("ohm-handoff-map", undefined, { placement: "belowEditor" });
+    return;
+  }
+
+  const lines = [
+    "ohm handoff visualizer (scaffold)",
+    `session: ${ctx.sessionManager.getSessionFile() ?? "ephemeral"}`,
+    "next: wire this into /resume tree + handoff links",
+  ];
+  ctx.ui.setWidget("ohm-handoff-map", lines, { placement: "belowEditor" });
+}
+
+async function refreshStatus(ctx: ExtensionContext): Promise<void> {
+  const { config } = await loadOhmRuntimeConfig(ctx.cwd);
+  const enabled = config.features.handoff ? "on" : "off";
+  const viz = config.features.handoffVisualizer ? "on" : "off";
+
+  if (ctx.hasUI) {
+    ctx.ui.setStatus("ohm-handoff", `handoff:${enabled} · visualizer:${viz}`);
+  }
+
+  renderHandoffMapWidget(ctx, config.features.handoff && config.features.handoffVisualizer);
+}
+
+export default function registerHandoffExtension(pi: ExtensionAPI): void {
+  registerOhmSettings(pi);
+
+  pi.on("session_start", async (_event, ctx) => {
+    await refreshStatus(ctx);
+  });
+
+  pi.on("session_switch", async (_event, ctx) => {
+    await refreshStatus(ctx);
+  });
+
+  pi.registerCommand("ohm-handoff", {
+    description: "Show handoff + visualizer config and status",
+    handler: async (_args, ctx) => {
+      const loaded = await loadOhmRuntimeConfig(ctx.cwd);
+      const text = [
+        "Pi OHM: handoff",
+        "",
+        `enabled: ${loaded.config.features.handoff ? "yes" : "no"}`,
+        `visualizer: ${loaded.config.features.handoffVisualizer ? "yes" : "no"}`,
+        `subagent backend: ${loaded.config.subagentBackend}`,
+        "",
+        `configDir: ${loaded.paths.configDir}`,
+        `loadedFrom: ${loaded.loadedFrom.length > 0 ? loaded.loadedFrom.join(", ") : "defaults + extension settings"}`,
+      ].join("\n");
+
+      if (!ctx.hasUI) {
+        console.log(text);
+        return;
+      }
+
+      await ctx.ui.editor("pi-ohm handoff", text);
+    },
+  });
+}