pneuma-skills 0.2.1 → 0.5.0

package/README.md

@@ -126,7 +126,7 @@ pneuma-skills/
 │       ├── StreamingText.tsx  # Streaming response display
 │       ├── ActivityIndicator.tsx # Thinking/tool progress indicator
 │       ├── PermissionBanner.tsx  # Tool permission approval UI
-│       └── StatusBar.tsx      # Connection status + session info
+│       └── TopBar.tsx         # Tab navigation + connection status
 ├── skill/
 │   └── doc/SKILL.md           # Doc Mode skill prompt for Claude Code
 ├── docs/adr/                  # Architecture Decision Records

package/bin/pneuma.ts

@@ -7,7 +7,7 @@
  */
 
 import { resolve, dirname, join } from "node:path";
-import { existsSync, copyFileSync, mkdirSync, readFileSync } from "node:fs";
+import { existsSync, copyFileSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import * as readline from "node:readline";
 import { startServer } from "../server/index.js";
 import { CliLauncher } from "../server/cli-launcher.js";
@@ -16,6 +16,49 @@ import { startFileWatcher } from "../server/file-watcher.js";
 
 const PROJECT_ROOT = resolve(dirname(import.meta.path), "..");
 
+// ── Session persistence ──────────────────────────────────────────────────────
+
+interface PersistedSession {
+  sessionId: string;
+  cliSessionId?: string;
+  mode: string;
+  createdAt: number;
+}
+
+function loadSession(workspace: string): PersistedSession | null {
+  const filePath = join(workspace, ".pneuma", "session.json");
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+function saveSession(workspace: string, session: PersistedSession): void {
+  const dir = join(workspace, ".pneuma");
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, "session.json"), JSON.stringify(session, null, 2));
+}
+
+function loadHistory(workspace: string): unknown[] {
+  try {
+    const content = readFileSync(join(workspace, ".pneuma", "history.json"), "utf-8");
+    const data = JSON.parse(content);
+    return Array.isArray(data) ? data : [];
+  } catch {
+    return [];
+  }
+}
+
+function saveHistory(workspace: string, history: unknown[]): void {
+  const dir = join(workspace, ".pneuma");
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, "history.json"), JSON.stringify(history));
+}
+
+// ── CLI arg parsing ──────────────────────────────────────────────────────────
+
 function parseArgs(argv: string[]) {
   const args = argv.slice(2); // skip bun + script path
   let mode = "";
@@ -49,7 +92,31 @@ function ask(question: string): Promise<string> {
   });
 }
 
+// ── Main ─────────────────────────────────────────────────────────────────────
+
+function checkBunVersion() {
+  const MIN_BUN = "1.3.5"; // Required for Bun.spawn terminal (PTY) support
+  const current = typeof Bun !== "undefined" ? Bun.version : null;
+  if (!current) {
+    console.warn("[pneuma] Warning: Not running under Bun. Pneuma requires Bun >= " + MIN_BUN);
+    return;
+  }
+  const [curMajor, curMinor, curPatch] = current.split(".").map(Number);
+  const [minMajor, minMinor, minPatch] = MIN_BUN.split(".").map(Number);
+  const ok =
+    curMajor > minMajor ||
+    (curMajor === minMajor && curMinor > minMinor) ||
+    (curMajor === minMajor && curMinor === minMinor && curPatch >= minPatch);
+  if (!ok) {
+    console.warn(
+      `[pneuma] Warning: Bun ${current} detected, but >= ${MIN_BUN} is required.` +
+      ` Terminal features may not work. Run \`bun upgrade\` to update.`
+    );
+  }
+}
+
 async function main() {
+  checkBunVersion();
   const { mode, workspace, port, noOpen } = parseArgs(process.argv);
 
   if (!mode || mode !== "doc") {
@@ -113,21 +180,100 @@ async function main() {
     ...(isDev ? {} : { distDir }),
   });
 
-  // 4. Launch CLI
+  // 4. Launch CLI (with session resume if available)
   const launcher = new CliLauncher(actualPort);
 
-  // When the CLI reports its internal session_id, store it
+  // When the CLI reports its internal session_id, persist it
   wsBridge.onCLISessionIdReceived((sessionId, cliSessionId) => {
     launcher.setCLISessionId(sessionId, cliSessionId);
+    // Persist to .pneuma/session.json
+    const persisted = loadSession(workspace);
+    if (persisted && persisted.sessionId === sessionId) {
+      persisted.cliSessionId = cliSessionId;
+      saveSession(workspace, persisted);
+      console.log(`[pneuma] Saved cliSessionId for resume: ${cliSessionId}`);
+    }
   });
 
+  // Check for existing session to resume
+  const existing = loadSession(workspace);
+  let resuming = false;
+
   const session = launcher.launch({
     cwd: workspace,
     permissionMode: "bypassPermissions",
+    // Reuse sessionId for stable WS routing
+    ...(existing?.cliSessionId ? {
+      sessionId: existing.sessionId,
+      resumeSessionId: existing.cliSessionId,
+    } : {}),
+  });
+
+  if (existing?.cliSessionId) {
+    resuming = true;
+    console.log(`[pneuma] Resuming session: ${existing.cliSessionId}`);
+  }
+
+  // Persist session info
+  saveSession(workspace, {
+    sessionId: session.sessionId,
+    cliSessionId: existing?.cliSessionId,
+    mode,
+    createdAt: existing?.createdAt || Date.now(),
   });
 
   console.log(`[pneuma] CLI session started: ${session.sessionId}`);
 
+  // Auto-greeting for fresh sessions — sends a hidden prompt so Claude greets the user
+  if (!resuming) {
+    const greeting = "The user just opened the Pneuma document editor workspace. Briefly greet them and let them know you're ready to help edit and create documents. Keep it to 1-2 sentences.";
+    wsBridge.injectGreeting(session.sessionId, greeting);
+    console.log("[pneuma] Sent auto-greeting for fresh session");
+  }
+
+  // Load persisted message history into WsBridge
+  const savedHistory = loadHistory(workspace);
+  if (savedHistory.length > 0) {
+    wsBridge.loadMessageHistory(session.sessionId, savedHistory as any);
+    console.log(`[pneuma] Restored ${savedHistory.length} messages from history`);
+  }
+
+  // Periodically persist message history (debounced — every 5s)
+  const historyInterval = setInterval(() => {
+    const history = wsBridge.getMessageHistory(session.sessionId);
+    if (history.length > 0) {
+      saveHistory(workspace, history);
+    }
+  }, 5_000);
+
+  // Handle CLI exit: surface errors + clear stale resume state
+  launcher.onSessionExited((exitedId, exitCode) => {
+    // Broadcast CLI errors to browser
+    if (exitCode !== 0 && exitCode !== 143 /* SIGTERM = normal shutdown */) {
+      let errorMsg: string;
+      if (exitCode === 127) {
+        errorMsg = "Claude Code CLI not found. Please install it: https://docs.anthropic.com/claude-code";
+      } else {
+        errorMsg = `Claude Code exited unexpectedly (code ${exitCode}). Check CLI installation and subscription status.`;
+      }
+      wsBridge.broadcastToSession(exitedId, { type: "error", message: errorMsg });
+    }
+
+    // If resume fails (CLI exits quickly), clear cliSessionId from persistence
+    if (exitedId === session.sessionId && resuming) {
+      const info = launcher.getSession(exitedId);
+      if (info && !info.cliSessionId) {
+        // Resume failed, cliSessionId was cleared by launcher
+        const persisted = loadSession(workspace);
+        if (persisted) {
+          persisted.cliSessionId = undefined;
+          saveSession(workspace, persisted);
+          console.log("[pneuma] Resume failed, cleared cliSessionId. Restart for fresh session.");
+        }
+      }
+    }
+  });
+
   // 5. Start file watcher
   startFileWatcher(workspace, (files) => {
     wsBridge.broadcastToSession(session.sessionId, {
@@ -187,6 +333,13 @@ async function main() {
   // Graceful shutdown
   const shutdown = async () => {
     console.log("\n[pneuma] Shutting down...");
+    clearInterval(historyInterval);
+    // Final history save
+    const history = wsBridge.getMessageHistory(session.sessionId);
+    if (history.length > 0) {
+      saveHistory(workspace, history);
+      console.log(`[pneuma] Saved ${history.length} messages to history`);
+    }
     viteProc?.kill();
     await launcher.killAll();
     server.stop(true);