granttap-mcp 0.8.50 → 0.8.52

package/apps/bridge/src/monitor/support/runtime.ts

@@ -18,7 +18,8 @@ import { confirmPendingController } from "../../pairing/controllers";
 import { recordControllerName } from "../../pairing/presence";
 import { startPublishLoop } from "./publish-loop";
 import { singleFlightPublisher } from "./single-flight";
-import { publishedCatalog, rememberPublishedCatalog, resumePublishedChats } from "../../session-catalog";
+import { publishedCatalog, rememberPublishedCatalog, resumePublishedChats,
+  publishCatalogHeads, stopCatalogHeads } from "../../session-catalog";
 import { createMachineLoadPublisher } from "../../machine-load";
 import { startMachineLoadLoop } from "../../machine-load/host/loop";
 import { scanCapabilityUsage, scanSessionHistory, scanSessions, scopeCapabilityUsageToRoom, TOKEN_WINDOW_HOURS } from "../../sessions";
@@ -135,9 +136,7 @@ async function publishMonitorTick(input: {
   if (includeHistory || initial) lastHistoryPublishedAt = Date.now();
   loadLoop.updateStatus(status);
   void refreshMcpLoad(status.sessions).catch(() => {});
-  for (const sessionId of subscriptions) {
-    await publishSessionEvents(client, sessionId, status).catch(() => false);
-  }
+  publishCatalogHeads(client, status, subscriptions, publishSessionEvents);
   await client.send(approvalsStatus(), "phone", { ttlMs: INTERVAL_MS * 3, reliable: false });
   if (loadRuntimeConfig().meshEnabled) publishMonitorMeshes(client, status);
   if (Date.now() - lastCapabilityPublishedAt >= 30_000) {
@@ -226,6 +225,7 @@ export function startSessionMonitor(client: RelayClient): SessionMonitor {
     publish: () => publish(false),
     close: () => {
       stopCatalog();
+      stopCatalogHeads(client);
       stopMonitorMeshes(client);
       stopHeartbeat();
       loadLoop.stop();

package/apps/bridge/src/session-catalog/README.md

@@ -17,3 +17,7 @@ as fresh. The phone continues its durable historical backfill independently.
 Tests live in `tests/`. This runtime module uses the repository MIT License.
 
 Engine binding recovery waits for the first connected catalog publication before projecting repository graphs. A cold Engine cannot hold the initial relay handshake behind restored Mesh analysis.
+
+Codex discovery shares repeated checkout verification only within one synchronous scan. The next scan verifies repository identity again; no long-lived checkout cache can cross a repository change. This keeps startup catalog delivery ahead of repeated Git subprocesses.
+
+Subscribed transcript heads use a separate, single-flight transfer loop. A stalled head never occupies the current catalog publication slot; stopping the monitor cancels further queued reads. The iPhone keeps its historical backfill independent of both loops.

package/apps/bridge/src/session-catalog/index.ts

@@ -6,6 +6,7 @@ import { SessionsStatus, type SessionInfo } from "../../../../packages/protocol/
 import { configDir, writePrivateFile } from "../config";
 import { nativeTranscriptRoots, nativeTranscriptSource, restoreNativeTranscriptSource } from "../sessions";
 export { recoverCatalogBindings } from "./startup-recovery";
+export { publishCatalogHeads, stopCatalogHeads } from "./publish-heads";
 
 const catalogs = new WeakMap<RelayClient, SessionsStatus | undefined>();
 const cachePath = () => join(configDir(), "session-catalog-cache.json");

package/apps/bridge/src/session-catalog/publish-heads.ts

@@ -0,0 +1,27 @@
+import type { RelayClient } from "../../../../packages/core/relay-client";
+import type { SessionsStatus } from "../../../../packages/protocol/schema";
+
+type HeadRun = { running: boolean; closed: boolean };
+const runs = new WeakMap<RelayClient, HeadRun>();
+
+/** Transcript transfers must never occupy the fresh catalog's publication slot. */
+export function publishCatalogHeads(client: RelayClient, status: SessionsStatus,
+  subscriptions: ReadonlySet<string>,
+  publish: (client: RelayClient, sessionId: string, status: SessionsStatus) => Promise<unknown>): void {
+  const state = runs.get(client) ?? { running: false, closed: false };
+  runs.set(client, state);
+  if (state.running || state.closed || subscriptions.size === 0) return;
+  state.running = true;
+  void (async () => {
+    for (const sessionId of [...subscriptions]) {
+      await new Promise<void>(resolve => setImmediate(resolve));
+      if (state.closed || !client.isConnected) break;
+      await publish(client, sessionId, status).catch(() => {});
+    }
+  })().finally(() => { state.running = false; });
+}
+
+export function stopCatalogHeads(client: RelayClient): void {
+  const state = runs.get(client);
+  if (state) state.closed = true;
+}

package/apps/bridge/src/sessions/scan/codex/scan.ts

@@ -8,8 +8,13 @@ import {
 import { parseCodexFile } from "./parse";
 import { assembleCodexScan } from "./assemble";
 import { recentLogs, codexSessionsRoot, MAX_FILES, type Scan } from "../../support/common";
+import { withCheckoutObservationCache } from "../../support/repository-checkout";
 
 export function scanCodex(maxFiles = MAX_FILES): Scan {
+  return withCheckoutObservationCache(() => scanCodexCatalog(maxFiles));
+}
+
+function scanCodexCatalog(maxFiles: number): Scan {
   const root = codexSessionsRoot();
   const listed = recentLogs(root, 5, maxFiles + 1);
   const files = listed.slice(0, maxFiles);

package/apps/bridge/src/sessions/support/repository-checkout/index.ts

@@ -2,11 +2,25 @@ import { execFileSync } from "node:child_process";
 import { realpathSync } from "node:fs";
 import { isAbsolute } from "node:path";
 
+let scanRoots: Map<string, string | undefined> | undefined;
+
+/** Share verified lookups only during this synchronous catalog pass. */
+export function withCheckoutObservationCache<T>(scan: () => T): T {
+  if (scanRoots) return scan();
+  scanRoots = new Map();
+  try { return scan(); }
+  finally { scanRoots = undefined; }
+}
+
 function gitRoot(path: string): string | undefined {
+  if (scanRoots?.has(path)) return scanRoots.get(path);
+  let root: string | undefined;
   try {
-    return execFileSync("git", ["--no-optional-locks", "-C", path, "rev-parse", "--show-toplevel"],
+    root = execFileSync("git", ["--no-optional-locks", "-C", path, "rev-parse", "--show-toplevel"],
       {encoding:"utf8", stdio:["ignore","pipe","ignore"], timeout:2_000}).trim() || undefined;
-  } catch { return undefined; }
+  } catch { root = undefined; }
+  scanRoots?.set(path, root);
+  return root;
 }
 
 /** Recognize only a literal initial shell directory change, without evaluating shell code. */

package/cursor-plugin/README.md

@@ -10,7 +10,7 @@ keeps each phone response tied to the exact originating chat and prompt.
 Install the supported CLI on this computer, then run:
 
 ```bash
-npm install -g granttap-mcp@0.8.50
+npm install -g granttap-mcp@0.8.52
 granttap setup
 granttap status
 ```

package/cursor-plugin/mcp.json

@@ -4,7 +4,7 @@
       "command": "node",
       "args": [
         "-e",
-        "\"use strict\";\n\n// Cursor may start this MCP from any cwd. Execute JavaScript entry points with\n// Node itself: Windows batch shims require shell quoting that differs by host.\nconst { spawn } = require(\"node:child_process\");\nconst { existsSync } = require(\"node:fs\");\nconst { delimiter, dirname, join } = require(\"node:path\");\n\nconst PACKAGE = \"granttap-mcp@0.8.50\";\nconst dryRun = process.env.GRANTTAP_BOOTSTRAP_DRY_RUN === \"1\";\nconst platform = dryRun && process.env.GRANTTAP_BOOTSTRAP_PLATFORM\n  ? process.env.GRANTTAP_BOOTSTRAP_PLATFORM : process.platform;\nconst nodeRoot = dryRun && process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT\n  ? process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT : dirname(process.execPath);\nconst pathRoots = (process.env.PATH || \"\").split(delimiter).filter(Boolean);\nconst appData = process.env.APPDATA;\nconst roots = [nodeRoot, ...pathRoots, ...(appData ? [join(appData, \"npm\")] : [])];\nconst first = (paths) => paths.find((path) => existsSync(path));\n\nfunction launch() {\n  if (platform !== \"win32\") {\n    const installed = first(roots.map((root) => join(root, \"granttap-mcp\")));\n    if (installed) return { command: installed, args: [] };\n    const npx = first(roots.map((root) => join(root, \"npx\"))) || \"npx\";\n    return { command: npx, args: [\"-y\", PACKAGE] };\n  }\n  const installed = first(roots.map((root) =>\n    join(root, \"node_modules\", \"granttap-mcp\", \"bin\", \"granttap-mcp.mjs\")));\n  if (installed) return { command: process.execPath, args: [installed] };\n  const npx = first(roots.map((root) =>\n    join(root, \"node_modules\", \"npm\", \"bin\", \"npx-cli.js\")));\n  if (npx) return { command: process.execPath, args: [npx, \"-y\", PACKAGE] };\n  throw new Error(\"Node.js/npm 20+ is required on this Windows device. Install npm and retry GrantTap.\");\n}\n\nlet target;\ntry { target = launch(); }\ncatch (error) {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n}\n\nif (dryRun) {\n  process.stdout.write(JSON.stringify(target));\n  process.exit(0);\n}\n\nconst child = spawn(target.command, target.args, { stdio: \"inherit\", windowsHide: true });\nchild.on(\"error\", (error) => {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n});\nchild.on(\"exit\", (code, signal) => {\n  if (signal && platform !== \"win32\") {\n    try { process.kill(process.pid, signal); } catch { process.exit(code ?? 1); }\n    return;\n  }\n  process.exit(code ?? 1);\n});\n"
+        "\"use strict\";\n\n// Cursor may start this MCP from any cwd. Execute JavaScript entry points with\n// Node itself: Windows batch shims require shell quoting that differs by host.\nconst { spawn } = require(\"node:child_process\");\nconst { existsSync } = require(\"node:fs\");\nconst { delimiter, dirname, join } = require(\"node:path\");\n\nconst PACKAGE = \"granttap-mcp@0.8.52\";\nconst dryRun = process.env.GRANTTAP_BOOTSTRAP_DRY_RUN === \"1\";\nconst platform = dryRun && process.env.GRANTTAP_BOOTSTRAP_PLATFORM\n  ? process.env.GRANTTAP_BOOTSTRAP_PLATFORM : process.platform;\nconst nodeRoot = dryRun && process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT\n  ? process.env.GRANTTAP_BOOTSTRAP_NODE_ROOT : dirname(process.execPath);\nconst pathRoots = (process.env.PATH || \"\").split(delimiter).filter(Boolean);\nconst appData = process.env.APPDATA;\nconst roots = [nodeRoot, ...pathRoots, ...(appData ? [join(appData, \"npm\")] : [])];\nconst first = (paths) => paths.find((path) => existsSync(path));\n\nfunction launch() {\n  if (platform !== \"win32\") {\n    const installed = first(roots.map((root) => join(root, \"granttap-mcp\")));\n    if (installed) return { command: installed, args: [] };\n    const npx = first(roots.map((root) => join(root, \"npx\"))) || \"npx\";\n    return { command: npx, args: [\"-y\", PACKAGE] };\n  }\n  const installed = first(roots.map((root) =>\n    join(root, \"node_modules\", \"granttap-mcp\", \"bin\", \"granttap-mcp.mjs\")));\n  if (installed) return { command: process.execPath, args: [installed] };\n  const npx = first(roots.map((root) =>\n    join(root, \"node_modules\", \"npm\", \"bin\", \"npx-cli.js\")));\n  if (npx) return { command: process.execPath, args: [npx, \"-y\", PACKAGE] };\n  throw new Error(\"Node.js/npm 20+ is required on this Windows device. Install npm and retry GrantTap.\");\n}\n\nlet target;\ntry { target = launch(); }\ncatch (error) {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n}\n\nif (dryRun) {\n  process.stdout.write(JSON.stringify(target));\n  process.exit(0);\n}\n\nconst child = spawn(target.command, target.args, { stdio: \"inherit\", windowsHide: true });\nchild.on(\"error\", (error) => {\n  process.stderr.write(`[granttap] ${error.message}\\n`);\n  process.exit(1);\n});\nchild.on(\"exit\", (code, signal) => {\n  if (signal && platform !== \"win32\") {\n    try { process.kill(process.pid, signal); } catch { process.exit(code ?? 1); }\n    return;\n  }\n  process.exit(code ?? 1);\n});\n"
       ]
     }
   }

package/cursor-plugin/stdio-bootstrap.cjs

@@ -7,7 +7,7 @@ const { spawn } = require("node:child_process");
 const { existsSync } = require("node:fs");
 const { delimiter, dirname, join } = require("node:path");
 
-const PACKAGE = "granttap-mcp@0.8.50";
+const PACKAGE = "granttap-mcp@0.8.52";
 const dryRun = process.env.GRANTTAP_BOOTSTRAP_DRY_RUN === "1";
 const platform = dryRun && process.env.GRANTTAP_BOOTSTRAP_PLATFORM
   ? process.env.GRANTTAP_BOOTSTRAP_PLATFORM : process.platform;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "granttap-mcp",
-  "version": "0.8.50",
+  "version": "0.8.52",
   "description": "Personal live control center runtime for local coding agents on iPhone and Apple Watch.",
   "type": "module",
   "bin": {