@jhizzard/termdeck 1.6.0 → 1.7.0

package/packages/server/src/agent-adapters/index.js

@@ -16,6 +16,9 @@ const claude = require('./claude');
 const codex = require('./codex');
 const gemini = require('./gemini');
 const grok = require('./grok');
+// Sprint 70 T1 — Antigravity CLI (`agy`). Registered under its canonical
+// adapter name `antigravity` (= source_agent); the binary it matches is `agy`.
+const antigravity = require('./agy');
 
 // Keyed by adapter name (NOT session.meta.type — adapters expose their own
 // `sessionType` field for that mapping). Order is iteration order for the
@@ -25,6 +28,10 @@ const AGENT_ADAPTERS = {
   codex,
   gemini,
   grok,
+  // Listed last: its idle `> ` prompt overlaps claude's, and claude (first)
+  // claims that string in the detect loop. agy panels are normally resolved by
+  // exact-binary direct-spawn, not output sniffing, so order is not load-bearing.
+  antigravity,
 };
 
 // Convenience accessor — returns the adapter whose `sessionType` matches the

package/packages/server/src/index.js

@@ -290,7 +290,13 @@ async function onPanelClose(session) {
       session_id: session.id,
       sessionType: adapter.sessionType,
       // Sprint 50 — T2 consumes this via the new memory_items.source_agent column.
-      source_agent: adapter.name,
+      // Sprint 70 T3 — prefer an explicit `adapter.sourceAgent` provenance tag
+      // when an adapter declares one (decouples the provenance string from the
+      // registry/binary-match `name`); existing adapters omit it and fall back
+      // to `name` (behavior unchanged). The antigravity (`agy`) adapter sets
+      // sourceAgent:'antigravity'; the session-end hook's normalizeSourceAgent
+      // also aliases the binary name `agy` → `antigravity` as a safety net.
+      source_agent: adapter.sourceAgent || adapter.name,
     };
 
     _spawnSessionEndHookImpl(hookPath, payload, {
@@ -355,7 +361,10 @@ async function onPanelPeriodicCapture(session) {
       cwd: session.meta.cwd,
       session_id: session.id,
       sessionType: adapter.sessionType,
-      source_agent: adapter.name,
+      // Sprint 70 T3 — same provenance contract as onPanelClose: an explicit
+      // adapter.sourceAgent wins, else fall back to adapter.name (unchanged for
+      // existing adapters). agy panels' periodic snapshots tag 'antigravity'.
+      source_agent: adapter.sourceAgent || adapter.name,
       // Mode discriminator the hook reads in resolveFiringContext —
       // distinguishes "TermDeck server periodic capture" from "Claude Code
       // PreCompact harness fire."
@@ -388,6 +397,50 @@ function _resolvePeriodicCaptureIntervalMs() {
   return n;
 }
 
+// Sprint 70 T1 — best-effort line-buffering wrap for stdout-capture adapters.
+//
+// The LOAD-BEARING capture mechanism is the PTY tee in spawnTerminalSession;
+// this wrap is a RESIDUAL buffering-defense, valuable only for line-buffered
+// C-stdio CLIs and timelier mid-session periodic checkpoints. It is inert for a
+// compiled binary like `agy` (libstdbuf only affects glibc stdio) and a no-op
+// on hosts without a stdbuf-family tool (stock macOS) — the tee captures
+// everything regardless. We PREFER `stdbuf`/`gstdbuf` (GNU coreutils) because
+// it exec()s the target IN PLACE: same controlling TTY, pid preserved, exit
+// code propagated. We deliberately do NOT use `unbuffer` (expect) — it
+// allocates its own pty, producing a double-pty that strips the interactive-TTY
+// context agent CLIs need (Sprint 64 T2 carve-out 2.4 rationale).
+let _stdbufToolCache;  // undefined = unprobed, string = tool name, null = none on PATH
+function _defaultLookStdbuf() {
+  if (_stdbufToolCache !== undefined) return _stdbufToolCache;
+  const { spawnSync } = require('child_process');
+  _stdbufToolCache = null;
+  for (const name of ['stdbuf', 'gstdbuf']) {
+    try {
+      const r = spawnSync('/bin/sh', ['-c', `command -v ${name}`], { encoding: 'utf8' });
+      if (r && r.status === 0 && typeof r.stdout === 'string' && r.stdout.trim()) {
+        _stdbufToolCache = name;
+        break;
+      }
+    } catch (_) { /* try next candidate */ }
+  }
+  return _stdbufToolCache;
+}
+
+// Returns the (possibly rewritten) { binary, args } to hand pty.spawn. No-op
+// unless the adapter declares `capture.mode==='stdout'` AND `capture.unbuffer`.
+// `lookPath` is dependency-injected so tests stay hermetic (no real stdbuf
+// dependence). Resets the memo via `_resetStdbufToolCacheForTesting`.
+function _resolveStdoutCaptureSpawn(binary, args, capture, lookPath = _defaultLookStdbuf) {
+  if (!capture || capture.mode !== 'stdout' || !capture.unbuffer) {
+    return { binary, args };
+  }
+  let tool = null;
+  try { tool = lookPath(); } catch (_) { tool = null; }
+  if (!tool) return { binary, args };  // graceful fallback — bare direct-spawn
+  return { binary: tool, args: ['-oL', '-eL', binary, ...args] };
+}
+function _resetStdbufToolCacheForTesting() { _stdbufToolCache = undefined; }
+
 // Sprint 37 T3 — lazy resolution of T2's CLI modules. The orchestration-preview
 // helper is decoupled from T2's templates.js / init-project.js; we resolve
 // them here and pass them into the helper. If a module is missing (e.g.
@@ -1361,6 +1414,18 @@ function createServer(config) {
         args = (cmdTrim && !isPlainShell) ? ['-c', cmdTrim] : [];
       }
 
+      // Sprint 70 T1 — stdout-capture adapters (agy) may opt into a best-effort
+      // line-buffering wrap of the direct-spawn. No-op for every other adapter
+      // (none declare `capture`) and for the shell-wrap path. Gated on
+      // directSpawnAdapter because a capture declaration only rides the
+      // exact-binary direct-spawn path. Falls back to the bare binary when no
+      // stdbuf-family tool is on PATH; the PTY tee below captures regardless.
+      if (directSpawnAdapter && directSpawnAdapter.capture) {
+        const wrapped = _resolveStdoutCaptureSpawn(spawnShell, args, directSpawnAdapter.capture);
+        spawnShell = wrapped.binary;
+        args = wrapped.args;
+      }
+
       try {
         // Sprint 48 T4: merge ~/.termdeck/secrets.env into the PTY env so
         // the bundled session-end memory hook (`memory-session-end.js`) sees
@@ -1472,10 +1537,43 @@ function createServer(config) {
           }
         } catch (_periodicErr) { /* fail-soft */ }
 
+        // Sprint 70 T1 — initialize the in-flight stdout capture buffer for
+        // adapters that opt in (agy). The tee in term.onData below appends to
+        // it; resolveTranscriptPath materializes it into a tempfile envelope at
+        // panel close + on the periodic-capture tick. Gated on the direct-spawn
+        // adapter's declaration so non-capture panels carry no buffer (zero
+        // overhead; their behavior is byte-for-byte unchanged).
+        if (directSpawnAdapter && directSpawnAdapter.capture
+            && directSpawnAdapter.capture.mode === 'stdout') {
+          const declaredMax = directSpawnAdapter.capture.maxBytes;
+          const maxBytes = (typeof declaredMax === 'number' && declaredMax > 0)
+            ? declaredMax
+            : 4 * 1024 * 1024;
+          session._stdoutCapture = { chunks: [], bytes: 0, maxBytes };
+        }
+
         // PTY output → analyze + broadcast to WebSocket + transcript archive
         term.onData((data) => {
           session.analyzeOutput(data);
 
+          // Sprint 70 T1 — tee PTY output into the in-flight capture buffer for
+          // stdout-capture adapters (agy). Tail-capped: when the buffer exceeds
+          // maxBytes we drop whole chunks from the FRONT, keeping the most
+          // recent conversation (TUI redraws inflate raw bytes far past the
+          // de-chromed content). Best-effort — a capture failure must never
+          // disrupt the load-bearing PTY data path below.
+          const cap = session._stdoutCapture;
+          if (cap) {
+            try {
+              cap.chunks.push(data);
+              cap.bytes += Buffer.byteLength(data, 'utf8');
+              while (cap.bytes > cap.maxBytes && cap.chunks.length > 1) {
+                const dropped = cap.chunks.shift();
+                cap.bytes -= Buffer.byteLength(dropped, 'utf8');
+              }
+            } catch (_capErr) { /* capture is best-effort */ }
+          }
+
           // Send to connected WebSocket
           if (session.ws && session.ws.readyState === 1) {
             session.ws.send(JSON.stringify({ type: 'output', data }));
@@ -3090,4 +3188,7 @@ module.exports = {
   onPanelPeriodicCapture,
   _setSpawnPeriodicCaptureHookImplForTesting,
   _resolvePeriodicCaptureIntervalMs,
+  // Sprint 70 T1 — stdout-capture spawn-wrap resolver (best-effort stdbuf).
+  _resolveStdoutCaptureSpawn,
+  _resetStdbufToolCacheForTesting,
 };

package/packages/server/src/setup/audit-upgrade.js

@@ -1,6 +1,6 @@
 // Sprint 51.5 T1 — schema-introspection audit-upgrade.
 //
-// Brad's 2026-05-02 jizzard-brain report (INSTALLER-PITFALLS.md ledger #13)
+// Brad's 2026-05-02 peer install report (INSTALLER-PITFALLS.md ledger #13)
 // surfaced Class A — schema drift. The user upgraded npm packages but the
 // database stayed frozen at first-kickstart: graph-inference Edge Function
 // never deployed, vault key never created, Mnestra migrations 009-015 + TD
@@ -124,7 +124,7 @@ const PROBES = Object.freeze([
     // the rich rag-system column set to memory_sessions; canonical engram
     // mig 001 only ships (id, project, summary, metadata, created_at).
     // Probe for memory_sessions.session_id (the most distinctive of the
-    // mig-017 columns) and apply mig 017 if absent. Idempotent on petvetbid
+    // mig-017 columns) and apply mig 017 if absent. Idempotent on the daily-driver project
     // where the columns are already present from hand-applied DDL.
     name: 'memory_sessions.session_id',
     kind: 'mnestra',
@@ -180,7 +180,7 @@ const PROBES = Object.freeze([
   // Sprint 51.6 T3 — Brad's Bug D: function-existence probes (cron schedule
   // checks for jobname presence) are not enough. The deployed Edge Function
   // SOURCE may be stale even when the cron job and function both exist.
-  // jizzard-brain on 2026-05-03: deployed rumen-tick was missing the
+  // peer install on 2026-05-03: deployed rumen-tick was missing the
   // SUPABASE_DB_URL fallback that Sprint 51.5 T1 added; cron probe said
   // "present", source was old. The marker check below detects that drift.
   //

package/packages/server/src/setup/rumen/functions/graph-inference/index.ts

@@ -135,7 +135,7 @@ async function fetchCandidatePairs(
   // m2 is the outer m1 (which IS recent). So filtering only m1 by `since`
   // is sufficient and saves ~99% of work in steady state.
   //
-  // EXPLAIN ANALYZE on petvetbid corpus (5,822 active rows, 2026-04-28):
+  // EXPLAIN ANALYZE on the daily-driver project corpus (5,822 active rows, 2026-04-28):
   // 13.5s cold start (since=NULL), HNSW correctly engaged, 718 raw
   // matches → 359 unique pairs at threshold 0.85.
   const result = await sql.unsafe(

package/packages/stack-installer/assets/hooks/memory-session-end.js

@@ -39,7 +39,7 @@
  *   9. (Sprint 51.6 T3) POSTs ONE row to Supabase /rest/v1/memory_sessions with
  *      Prefer: resolution=merge-duplicates so SessionEnd-fires-twice resolves
  *      to a single row. Requires Mnestra migration 017 on canonical installs;
- *      petvetbid already has the rich schema from rag-system bootstrap.
+ *      the daily-driver project already has the rich schema from rag-system bootstrap.
  *  10. Logs every step to ~/.claude/hooks/memory-hook.log.
  *
  * Version stamp (Sprint 51.6 T3 — hook upgrade gap fix):
@@ -61,7 +61,7 @@
  *       to bundled-v2 always passes the `installed >= bundled` short-circuit
  *       at init-mnestra.js:550 and reaches the refresh path.
  *
- * @termdeck/stack-installer-hook v2
+ * @termdeck/stack-installer-hook v3
  *
  * Required env vars (validated at entry, after the secrets.env fallback):
  *   - SUPABASE_URL              e.g. https://<project-ref>.supabase.co
@@ -305,35 +305,43 @@ function parseCodexJsonl(raw) {
 }
 
 function parseGeminiJson(raw) {
-  // Gemini CLI persists each session as a single JSON object (NOT JSONL):
-  //   { sessionId, projectHash, startTime, lastUpdated, kind,
-  //     messages: [{ id, timestamp, type: 'user'|'gemini', content }] }
-  // user content: [{ text }]; gemini content: string. Map type='gemini' →
-  // role='assistant' to match the rest of the dispatch shape.
+  // Sprint 70 T2/T3 cross-lane: handles BOTH transcript shapes —
+  // (A) legacy single JSON object {..., messages:[{type,content}]} (.json) +
+  // (B) modern JSONL — header line, `{ "$set": ... }` deltas, and message lines
+  //     {id,timestamp,type:'user'|'gemini'|'info',content} (.jsonl, ships today).
+  // Pre-Sprint-70 this did one whole-blob JSON.parse → threw on every modern
+  // .jsonl file → returned [] → captured nothing. user content = array of {text};
+  // gemini content = string; gemini → assistant.
+  // Keep in sync with packages/server/src/agent-adapters/gemini.js::parseTranscript.
   if (typeof raw !== 'string' || raw.length === 0) return [];
-  let obj;
-  try { obj = JSON.parse(raw); } catch (_) { return []; }
-  if (!obj || !Array.isArray(obj.messages)) return [];
-  const messages = [];
-  for (const msg of obj.messages) {
-    if (!msg || typeof msg !== 'object') continue;
+  const out = [];
+  const pushMsg = (msg) => {
+    if (!msg || typeof msg !== 'object') return;
     let role;
     if (msg.type === 'user') role = 'user';
     else if (msg.type === 'gemini' || msg.type === 'assistant') role = 'assistant';
-    else continue;
+    else return;
     const content = msg.content;
     let text = '';
-    if (typeof content === 'string') {
-      text = content;
-    } else if (Array.isArray(content)) {
-      text = content
-        .filter((c) => c && typeof c.text === 'string')
-        .map((c) => c.text)
-        .join(' ');
+    if (typeof content === 'string') text = content;
+    else if (Array.isArray(content)) {
+      text = content.filter((c) => c && typeof c.text === 'string').map((c) => c.text).join(' ');
     }
-    if (text) messages.push({ role, content: text.slice(0, 400) });
+    if (text) out.push({ role, content: text.slice(0, 400) });
+  };
+  const collect = (node) => {
+    if (!node || typeof node !== 'object') return;
+    if (Array.isArray(node.messages)) node.messages.forEach(pushMsg);
+    else pushMsg(node);
+  };
+  try { collect(JSON.parse(raw)); if (out.length) return out; } catch (_) { /* JSONL */ }
+  for (const line of raw.split(/\r?\n/)) {
+    const t = line.trim();
+    if (!t) continue;
+    let node; try { node = JSON.parse(t); } catch (_) { continue; }
+    collect(node);
   }
-  return messages;
+  return out;
 }
 
 // Sprint 50 T1 — Grok parser. Mirrors packages/server/src/agent-adapters/grok.js
@@ -469,7 +477,7 @@ function selectTranscriptParser(sessionType) {
 // per-message timestamps. The legacy rag-system writer
 // (~/Documents/Graciella/rag-system/src/scripts/process-session.ts) populated
 // those fields by parsing the transcript JSONL passed to it on stdin, and
-// petvetbid's 289 baseline rows carried the rich shape from that writer.
+// the daily-driver project's 289 baseline rows carried the rich shape from that writer.
 // v2 closes the gap in pure Node so the bundled hook reaches parity without
 // the rag-system dependency (Class E hidden-dependency rule).
 //
@@ -637,18 +645,31 @@ async function embedText(text, openaiKey) {
 // tag (memory_items.source_agent). Defaults to 'claude' for backwards
 // compat with Claude Code's existing SessionEnd payload, which doesn't
 // supply the field; TermDeck server's per-adapter onPanelClose
-// interceptor (Sprint 50 T1) sets it explicitly to 'codex'/'gemini'/'grok'
-// for non-Claude panels. The set is open-ended on the server side; this
-// constant gates only the spelling-mistake/empty-string case.
+// interceptor (Sprint 50 T1) sets it explicitly to 'codex'/'gemini'/'grok'/
+// 'antigravity' for non-Claude panels. The set is open-ended on the server
+// side; this constant gates only the spelling-mistake/empty-string case.
+//
+// Sprint 70 T3: Antigravity (`agy`) is a first-class source_agent. The CLI
+// binary is `agy` but the canonical provenance tag is `antigravity`, so the
+// alias map below folds `agy` → `antigravity` before the allowlist check —
+// an agy panel's memories must not be mis-tagged `claude`.
 const ALLOWED_SOURCE_AGENTS = new Set([
-  'claude', 'codex', 'gemini', 'grok', 'orchestrator',
+  'claude', 'codex', 'gemini', 'grok', 'orchestrator', 'antigravity',
 ]);
 
+// Alias → canonical source_agent. Keeps the binary name (`agy`) and any older
+// callers from being dropped to 'claude' by the allowlist gate. Applied (after
+// lowercasing) before the ALLOWED_SOURCE_AGENTS membership test.
+const SOURCE_AGENT_ALIASES = {
+  agy: 'antigravity',
+};
+
 function normalizeSourceAgent(raw) {
   if (typeof raw !== 'string') return 'claude';
   const v = raw.trim().toLowerCase();
   if (!v) return 'claude';
-  return ALLOWED_SOURCE_AGENTS.has(v) ? v : 'claude';
+  const canonical = SOURCE_AGENT_ALIASES[v] || v;
+  return ALLOWED_SOURCE_AGENTS.has(canonical) ? canonical : 'claude';
 }
 
 async function postMemoryItem({ supabaseUrl, supabaseKey, content, embedding, project, sessionId, sourceAgent }) {
@@ -694,10 +715,10 @@ async function postMemoryItem({ supabaseUrl, supabaseKey, content, embedding, pr
 // closes it.
 //
 // Schema target: Mnestra migration 017 brings canonical engram in line with
-// petvetbid's rag-system flavor (session_id, summary_embedding, started_at,
+// the daily-driver project's rag-system flavor (session_id, summary_embedding, started_at,
 // ended_at, duration_minutes, messages_count, transcript_path, etc). The
 // bundled hook writes the rich shape on every install — fresh-canonical
-// (post-mig-017) and petvetbid alike.
+// (post-mig-017) and the daily-driver project alike.
 //
 // Idempotency: Prefer: resolution=merge-duplicates relies on the
 // memory_sessions_session_id_key unique constraint. Mig 017 adds it where
@@ -804,7 +825,27 @@ async function processStdinPayload(input) {
   try { stat = statSync(transcriptPath); }
   catch (e) { log(`cannot-stat-transcript: ${transcriptPath} — ${e.message}`); return; }
 
-  if (stat.size < MIN_TRANSCRIPT_BYTES) {
+  // Sprint 70 T1 (A1 RED fix — ORCH 2026-06-07 19:21 ET). The raw-byte floor is
+  // calibrated for verbose on-disk JSONL (claude/codex/gemini/grok session files
+  // run 10s of KB even when short). Antigravity has no on-disk transcript — its
+  // capture is a synthesized COMPACT stdout-tee envelope (cleaned, de-chromed
+  // content only), so a genuinely-substantive short agy session is legitimately
+  // <5KB and the byte floor would wrongly drop it (false zero-row). Exempt
+  // sessionType==='antigravity' from the byte floor and gate on parsed CONTENT
+  // instead — require >= 1 assistant turn so an empty / no-model-output capture
+  // still no-ops. Do NOT lower the global floor; it correctly filters trivial
+  // verbose sessions for every other agent.
+  if (sessionType === 'antigravity') {
+    let agyRaw = '';
+    try { agyRaw = readFileSync(transcriptPath, 'utf8'); }
+    catch (e) { log(`cannot-read-transcript: ${transcriptPath} — ${e.message}`); return; }
+    const agyTurns = selectTranscriptParser(sessionType).parser(agyRaw);
+    const assistantTurns = agyTurns.filter((m) => m && m.role === 'assistant').length;
+    if (assistantTurns < 1) {
+      debug(`antigravity-no-assistant-turn: ${agyTurns.length} parsed, 0 assistant — skipping`);
+      return;
+    }
+  } else if (stat.size < MIN_TRANSCRIPT_BYTES) {
     debug(`small-transcript: ${stat.size} bytes < ${MIN_TRANSCRIPT_BYTES}, skipping`);
     return;
   }