pneuma-skills 0.3.0 → 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

@@ -41,6 +41,22 @@ function saveSession(workspace: string, session: PersistedSession): void {
   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[]) {
@@ -78,7 +94,29 @@ 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") {
@@ -186,8 +224,42 @@ async function main() {
 
   console.log(`[pneuma] CLI session started: ${session.sessionId}`);
 
-  // If resume fails (CLI exits quickly), clear cliSessionId from persistence
+  // 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) {
@@ -261,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);