@jhizzard/termdeck 1.0.14 → 1.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhizzard/termdeck",
-  "version": "1.0.14",
+  "version": "1.1.1",
   "description": "Browser-based terminal multiplexer with metadata overlays, panel flashback memory recall, and AI-aware session management",
   "bin": {
     "termdeck": "./packages/cli/src/index.js"

package/packages/cli/src/init-mnestra.js

@@ -332,23 +332,63 @@ async function promptSecretWithValidation(validator) {
   throw new Error('Too many invalid attempts — cancelling.');
 }
 
+// Sprint 61 T2 — collapsed fresh-install / upgrade paths. Pre-Sprint-61, the
+// wizard re-applied every bundled mnestra migration on every invocation,
+// relying on per-file IF NOT EXISTS / CREATE OR REPLACE idempotency. That
+// works for fresh installs but doesn't tell the wizard which migrations the
+// live database has actually received — so a user running
+// `npm install -g @latest` against an existing project lands in Class A
+// (schema drift on package upgrade): the npm package files upgrade, the
+// database stays at first-kickstart state. Brad reported this 2026-05-02.
+//
+// applyPendingMigrations (migrations.js) replaces the loop with a tracker-
+// aware diff: SELECT applied filenames from public.mnestra_migrations, run
+// only the bundled-but-unapplied ones, INSERT a tracker row per apply.
+// Pre-020 installs trigger a one-time backfill probe pass that seeds the
+// tracker for migrations whose schema artifacts are already present.
 async function applyMigrations(client, dryRun) {
   const files = migrations.listMnestraMigrations();
   if (files.length === 0) {
     throw new Error('No Mnestra migrations found. TermDeck install looks corrupted.');
   }
 
-  for (const file of files) {
-    const base = path.basename(file);
-    step(`Applying migration ${base}...`);
-    if (dryRun) { ok('(dry-run)'); continue; }
-    const result = await pgRunner.applyFile(client, file);
-    if (result.ok) {
-      ok(`(${result.elapsedMs}ms)`);
-    } else {
-      fail(result.error);
-      throw new Error(`Migration failed: ${base}`);
+  if (dryRun) {
+    // Preserve the per-file dry-run banner so the user sees the planned
+    // sequence without touching the database.
+    for (const file of files) {
+      const base = path.basename(file);
+      step(`Applying migration ${base}...`);
+      ok('(dry-run)');
     }
+    return;
+  }
+
+  step('Running tracker-aware diff-and-apply (skips already-applied migrations)...');
+  const summary = await migrations.applyPendingMigrations(client);
+
+  if (summary.errored) {
+    fail(`${summary.errored.file}: ${summary.errored.error}`);
+    throw new Error(`Migration failed: ${summary.errored.file}`);
+  }
+
+  ok(
+    `(applied ${summary.applied.length}, backfilled ${summary.backfilled.length}, ` +
+    `skipped ${summary.skipped.length})`
+  );
+
+  for (const f of summary.applied) {
+    process.stdout.write(`    ✓ applied ${f}\n`);
+  }
+  for (const f of summary.backfilled) {
+    process.stdout.write(`    ◇ backfilled ${f} (schema already present, recorded in tracker)\n`);
+  }
+  for (const w of summary.warnings) {
+    const tracked = (w.trackedChecksum || '').slice(0, 12) || '<empty>';
+    const bundled = (w.bundledChecksum || '').slice(0, 12) || '<empty>';
+    process.stdout.write(
+      `    ! checksum drift on ${w.file}: tracked=${tracked}, bundled=${bundled} ` +
+      `(no auto-overwrite — investigate before re-running)\n`
+    );
   }
 }
 

package/packages/client/public/app.js

@@ -129,6 +129,12 @@
       // Sprint 37 T1: orchestrator Guide right-rail. Lazy — fetches the doc
       // on first expand to keep page load light.
       setupGuideRail();
+
+      // 2026-05-08 hotfix: document-level capture-phase image-paste handler.
+      // Intercepts Cmd+V image data before xterm-helper-textarea consumes it
+      // (xterm reads only text/plain, drops images silently). See comment on
+      // setupGlobalImagePaste() near uploadFilesAndType() for details.
+      setupGlobalImagePaste();
     }
 
     // ===== Drag/drop reorder of PTY panels (Sprint 42 T4) =====
@@ -275,6 +281,57 @@
       }
     }
 
+    // Document-level capture-phase image paste handler.
+    //
+    // The Sprint 59 per-panel `paste` listener at line 218 is bubble-phase, but
+    // xterm.js@5.5.0's hidden helper-textarea has its own `paste` handler that
+    // reads only `clipboardData.getData('text/plain')`. Image data lives in
+    // `clipboardData.items` with `kind: 'file'` and never reaches xterm's
+    // text path — and the panel-level bubble-phase handler runs after xterm's,
+    // by which point xterm has already returned (silently dropping the image).
+    // Net: pre-fix, Cmd+V'ing a screenshot into a focused TermDeck panel did
+    // nothing. Joshua reported this on 2026-05-08 (post-v1.1.0 upgrade).
+    //
+    // Fix: document-level listener with `{capture: true}` runs in capture
+    // phase BEFORE the event reaches xterm-helper-textarea. If the event
+    // target is inside a `.term-panel` AND the clipboard contains image
+    // files, we preventDefault + stopPropagation (so xterm + the bubble-phase
+    // panel handler don't see it) and route through `uploadFilesAndType`.
+    // For text paste (no image files) we let the event continue normally.
+    //
+    // Idempotent: setupGlobalImagePaste() is called once from init().
+    let _globalImagePasteSetup = false;
+    function setupGlobalImagePaste() {
+      if (_globalImagePasteSetup) return;
+      _globalImagePasteSetup = true;
+      document.addEventListener('paste', (e) => {
+        const target = e.target;
+        if (!(target instanceof Element)) return;
+        const panel = target.closest('.term-panel');
+        if (!panel) return;
+        const items = (e.clipboardData && e.clipboardData.items) || [];
+        const blobs = [];
+        for (const item of items) {
+          if (item.kind === 'file' && item.type && item.type.startsWith('image/')) {
+            const blob = item.getAsFile();
+            if (blob) blobs.push(blob);
+          }
+        }
+        if (blobs.length === 0) return;
+        e.preventDefault();
+        e.stopPropagation();
+        const ts = new Date().toISOString().replace(/[:.]/g, '-');
+        const named = blobs.map((b, i) => {
+          const ext = (b.type.split('/')[1] || 'png').replace(/[^a-z0-9]/gi, '');
+          const name = b.name && b.name.length > 0
+            ? b.name
+            : `pasted-${ts}${blobs.length > 1 ? '-' + i : ''}.${ext}`;
+          return new File([b], name, { type: b.type });
+        });
+        uploadFilesAndType(panel, named);
+      }, { capture: true });
+    }
+
     // ===== Create Terminal Panel =====
     function createTerminalPanel(sessionData) {
       const id = sessionData.id;

package/packages/server/src/index.js

@@ -16,7 +16,25 @@ const { createCachedLookup, createFailureLogger } = require('./rumen-pool-resili
 // Conditional imports (graceful fallback if not installed yet)
 let pty, Database, pg;
 try { pty = require('@homebridge/node-pty-prebuilt-multiarch'); } catch { pty = null; }
-try { Database = require('better-sqlite3'); } catch { Database = null; }
+try {
+  Database = require('better-sqlite3');
+} catch (err) {
+  // Brad Heath 2026-05-11: distinguish a native-ABI mismatch (Node upgraded
+  // after install) from "package not installed yet." ABI mismatch leaves
+  // Database=null and cascades into a null-handle storm downstream that
+  // masquerades as "Mnestra unreachable / DB timeout" in health probes.
+  // Fail fast with the actionable rebuild hint instead.
+  const msg = err && err.message ? String(err.message) : '';
+  if (err && err.code === 'ERR_DLOPEN_FAILED' && /NODE_MODULE_VERSION/.test(msg)) {
+    console.error('[db] better-sqlite3 native ABI mismatch (Node was upgraded after install).');
+    console.error('[db] TermDeck cannot serve memory features without a working SQLite.');
+    console.error('[db] Fix:');
+    console.error('       cd "$(npm root -g)/@jhizzard/termdeck" && npm rebuild better-sqlite3');
+    console.error('[db] Then restart TermDeck. Aborting.');
+    process.exit(1);
+  }
+  Database = null;
+}
 try { pg = require('pg'); } catch { pg = null; }
 
 // Module-level singleton Postgres pool for rumen_insights (petvetbid DB).