granttap-mcp 0.8.113 → 0.8.115

package/apps/bridge/src/engine/README.md

@@ -48,8 +48,12 @@ explicitly unavailable.
 
 `invocation-ingest.ts` reads bounded complete transcript lines and exact-call
 hook denial metadata without forwarding tool arguments, output, or reason text.
-Cursor decisions without a native call ID stay unattributed. Events are replayed
-with stable IDs after an IPC failure. `invocation-query.ts` returns bounded
+Cursor decisions without a native call ID stay unattributed. Unconfirmed events retain their exact IDs and timestamps across IPC retries;
+confirmed prefixes are not resent. Transient failures back off up to one minute,
+while journal-capacity refusals wait five minutes. Source cursors advance only
+after the retained batch is confirmed; pending sources are bounded and deferred
+source files remain unread. This neither clears history nor increases the Engine
+journal limit. `invocation-query.ts` returns bounded
 Engine history to the phone under the Project key, while
 `invocation-scope.ts` exposes one Task slice through the caller's existing
 opaque Mesh capability. The Engine, not this bridge or Usage telemetry, owns

package/apps/bridge/src/engine/distribution/artifacts.ts

@@ -8,8 +8,8 @@ export type EngineArtifact = {
 
 /** Release hashes are part of the reviewed MCP, never supplied by a remote manifest. */
 export const ENGINE_ARTIFACTS: readonly EngineArtifact[] = [
-  { version: "0.1.5", platform: "darwin", arch: "arm64",
-    sha256: "bd16babf11fd3d7e65b9713797b977deba1670ba41230a0e6607ce938b847455", bytes: 12202080 },
+  { version: "0.1.6", platform: "darwin", arch: "arm64",
+    sha256: "71819584e4a5edb064bcc23173edfc13ed3dcd61aa4487ba3febc9eb10708bb8", bytes: 12201872 },
   { version: "0.1.2", platform: "darwin", arch: "x64",
     sha256: "b3235a15936a77ec323d5ecbc54a0bc19994fe6e5a36044da964b68524b4c1dd", bytes: 13944984 },
   { version: "0.1.2", platform: "linux", arch: "x64",

package/apps/bridge/src/engine/invocation/delivery/README.md

@@ -0,0 +1,11 @@
+# Invocation delivery recovery
+
+Public entry: `index.ts`. Retains the unconfirmed suffix of a bounded transcript
+batch across IPC failures, preserving exact event identity and source cursors.
+Transient errors use exponential backoff; a full journal waits five minutes.
+No durable history is deleted or silently replaced to recover capacity.
+
+Behavior is exercised through the ingestor by
+`tests/invocation/recovery/ingest.test.ts`.
+
+License: GrantTap Commercial Source License in the repository-root `LICENSE`.

package/apps/bridge/src/engine/invocation/delivery/index.ts

@@ -0,0 +1,53 @@
+import { EngineRemoteError, type EngineOperation, type EngineResult } from '../../protocol/engine-protocol';
+import type { InvocationEvent } from '../../protocol/engine-invocation-protocol';
+import type { InvocationLogCursor } from '../log-reader';
+import type { InvocationParseState } from '../parse';
+
+export type InvocationBatch = {
+  events: InvocationEvent[];
+  nextEvent: number;
+  next: InvocationLogCursor;
+  parse?: InvocationParseState;
+};
+
+const MAX_PENDING_SOURCES = 32;
+const CAPACITY_RETRY_MS = 5 * 60_000;
+type Client = { request(operation: EngineOperation): Promise<EngineResult> };
+
+/** Retain uncertain evidence, not a replay of every successfully committed event. */
+export class InvocationDelivery {
+  private pending = new Map<string, InvocationBatch>();
+  private retryAt = 0;
+  private failures = 0;
+
+  constructor(private client: Client, private now: () => number = Date.now) {}
+
+  ready(): boolean { return this.now() >= this.retryAt; }
+
+  async advance(key: string, prepare: () => InvocationBatch) {
+    if (!this.pending.has(key) && this.pending.size >= MAX_PENDING_SOURCES) return undefined;
+    let batch = this.pending.get(key);
+    if (!batch) {
+      try { batch = prepare(); }
+      catch { return undefined; } // An unavailable source is not a committed cursor.
+    }
+    let accepted = 0;
+    for (; batch.nextEvent < batch.events.length; batch.nextEvent++) {
+      try {
+        await this.client.request({ operation: 'invocation.observe', input: batch.events[batch.nextEvent]! });
+        accepted++;
+      } catch (error) {
+        this.pending.set(key, batch);
+        this.failures++;
+        const capacity = error instanceof EngineRemoteError && (error.code === 'INVOCATION_CAPACITY'
+          || (error.code === 'INVOCATION_STATE_WRITE_FAILED' && /size limit/i.test(error.message)));
+        this.retryAt = this.now() + (capacity ? CAPACITY_RETRY_MS
+          : Math.min(60_000, 1_000 * 2 ** Math.min(this.failures - 1, 6)));
+        return { batch, accepted, complete: false };
+      }
+    }
+    this.pending.delete(key);
+    if (accepted) { this.failures = 0; this.retryAt = 0; }
+    return { batch, accepted, complete: true };
+  }
+}

package/apps/bridge/src/engine/invocation/ingest.ts

@@ -17,6 +17,7 @@ import {
 } from "./parse";
 import type { InvocationEvent } from "../protocol/engine-invocation-protocol";
 import { parseInvocationDecision } from "./decision-parse";
+import { InvocationDelivery, type InvocationBatch } from './delivery';
 
 type Provider = "claude" | "codex" | "cursor";
 type SourceState = { cursor: InvocationLogCursor; parse: InvocationParseState };
@@ -29,6 +30,7 @@ export type InvocationIngestOptions = {
   paths: (session: SessionInfo) => string[];
   inspect: (cwd: string) => RepositoryFacts;
   decisionPath?: (session: SessionInfo) => string;
+  now?: () => number;
 };
 
 function transcriptPaths(session: SessionInfo): string[] {
@@ -41,9 +43,10 @@ function transcriptPaths(session: SessionInfo): string[] {
 export function createInvocationIngestor(options: InvocationIngestOptions) {
   const states = new Map<string, SourceState>();
   const decisionStates = new Map<string, InvocationLogCursor>();
+  const delivery = new InvocationDelivery(options.client, options.now);
   return {
     async ingest(sessions: readonly SessionInfo[]): Promise<number> {
-      if (!options.enabled()) return 0;
+      if (!options.enabled() || !delivery.ready()) return 0;
       const candidates = sessions.filter((session) => session.projectId && session.taskId
         && ["claude", "codex", "cursor"].includes(session.agent));
       if (candidates.length === 0) return 0;
@@ -54,68 +57,28 @@ export function createInvocationIngestor(options: InvocationIngestOptions) {
         const provider = session.agent as Provider;
         const facts = session.cwd ? options.inspect(session.cwd) : undefined;
         for (const path of options.paths(session)) {
-          const key = `${provider}\0${session.sessionId}\0${path}`;
+          const key = `transcript\0${provider}\0${session.sessionId}\0${path}`;
           const known = states.get(key);
-          let batch;
-          try { batch = readInvocationBatch(path, known?.cursor); }
-          catch { continue; }
-          const parse: InvocationParseState = {
-            pending: new Map(known?.parse.pending ?? []),
-          };
-          const records = [
-            ...batch.gaps.map((offset) => ({ offset, gap: true as const })),
-            ...batch.lines.map((row) => ({ ...row, gap: false as const })),
-          ].sort((a, b) => a.offset - b.offset || Number(b.gap) - Number(a.gap));
           const thread = hash([path]);
-          const events: InvocationEvent[] = [];
-          for (const record of records) {
-            if (record.gap) parse.pending.clear();
-            const observed = record.gap
-              ? [sourceGapFact(record.offset)]
-              : parseInvocationLine(provider, record.line, parse, record.offset);
-            for (const fact of observed) {
-              events.push(eventFor({
-                session, provider, computer: options.computer(), thread,
-                offset: record.offset, fact, repository: facts,
-              }));
-            }
-          }
-          try {
-            for (const event of events) {
-              await options.client.request({ operation: "invocation.observe", input: event });
-              accepted += 1;
-            }
-          } catch {
-            // No cursor advance: the next pass replays this batch under stable
-            // event IDs. Engine deduplicates already committed evidence.
-            return accepted;
-          }
-          states.set(key, { cursor: batch.next, parse });
+          const result = await delivery.advance(key, () => transcriptBatch(path, known, provider,
+            (fact, offset) => eventFor({ session, provider, computer: options.computer(), thread,
+              offset, fact, repository: facts })));
+          if (!result) continue;
+          accepted += result.accepted;
+          if (!result.complete) return accepted;
+          states.set(key, { cursor: result.batch.next, parse: result.batch.parse! });
         }
         const decisionPath = options.decisionPath?.(session);
         if (decisionPath) {
-          const key = `${provider}\0${session.sessionId}\0${decisionPath}`;
-          let batch;
-          try { batch = readInvocationBatch(decisionPath, decisionStates.get(key)); }
-          catch { continue; }
+          const key = `decision\0${provider}\0${session.sessionId}\0${decisionPath}`;
           const thread = hash([decisionPath]);
-          const events = [
-            ...batch.gaps.map((offset) => ({ offset, gap: true as const })),
-            ...batch.lines.map((row) => ({ ...row, gap: false as const })),
-          ].sort((a, b) => a.offset - b.offset).flatMap((record) =>
-            (record.gap ? [sourceGapFact(record.offset)]
-              : parseInvocationDecision(record.line, provider, record.offset))
-              .map((fact) => eventFor({
-                session, provider, computer: options.computer(), thread,
-                offset: record.offset, fact, repository: facts,
-              })));
-          try {
-            for (const event of events) {
-              await options.client.request({ operation: "invocation.observe", input: event });
-              accepted += 1;
-            }
-          } catch { return accepted; }
-          decisionStates.set(key, batch.next);
+          const result = await delivery.advance(key, () => decisionBatch(decisionPath, decisionStates.get(key), provider,
+            (fact, offset) => eventFor({ session, provider, computer: options.computer(), thread,
+              offset, fact, repository: facts })));
+          if (!result) continue;
+          accepted += result.accepted;
+          if (!result.complete) return accepted;
+          decisionStates.set(key, result.batch.next);
         }
       }
       return accepted;
@@ -123,6 +86,36 @@ export function createInvocationIngestor(options: InvocationIngestOptions) {
   };
 }
 
+type EventBuilder = (fact: InvocationFact, offset: number) => InvocationEvent;
+
+function transcriptBatch(path: string, known: SourceState | undefined, provider: Provider, event: EventBuilder): InvocationBatch {
+  const batch = readInvocationBatch(path, known?.cursor);
+  const parse: InvocationParseState = { pending: new Map(known?.parse.pending ?? []) };
+  const records = [
+    ...batch.gaps.map(offset => ({ offset, gap: true as const })),
+    ...batch.lines.map(row => ({ ...row, gap: false as const })),
+  ].sort((a, b) => a.offset - b.offset || Number(b.gap) - Number(a.gap));
+  const events: InvocationEvent[] = [];
+  for (const record of records) {
+    if (record.gap) parse.pending.clear();
+    const observed = record.gap ? [sourceGapFact(record.offset)]
+      : parseInvocationLine(provider, record.line, parse, record.offset);
+    for (const fact of observed) events.push(event(fact, record.offset));
+  }
+  return { events, nextEvent: 0, next: batch.next, parse };
+}
+
+function decisionBatch(path: string, cursor: InvocationLogCursor | undefined, provider: Provider, event: EventBuilder): InvocationBatch {
+  const batch = readInvocationBatch(path, cursor);
+  const records = [
+    ...batch.gaps.map(offset => ({ offset, gap: true as const })),
+    ...batch.lines.map(row => ({ ...row, gap: false as const })),
+  ].sort((a, b) => a.offset - b.offset);
+  const events = records.flatMap(record => (record.gap ? [sourceGapFact(record.offset)]
+    : parseInvocationDecision(record.line, provider, record.offset)).map(fact => event(fact, record.offset)));
+  return { events, nextEvent: 0, next: batch.next };
+}
+
 function eventFor(input: {
   session: SessionInfo;
   provider: Provider;

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.113
+npm install -g granttap-mcp@0.8.115
 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.113\";\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 22.13.0+ 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.115\";\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 22.13.0+ 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.113";
+const PACKAGE = "granttap-mcp@0.8.115";
 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.113",
+  "version": "0.8.115",
   "description": "Commercial computer runtime connecting local coding agents to GrantTap on Mac, iPhone, iPad and Apple Watch.",
   "type": "module",
   "bin": {