@lensmcp/core 1.23.2 → 1.23.4

package/lib/bus-rotation.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Cross-process rotation for the shared `events.jsonl` bus (issues/foodguard/13).
+ *
+ * Many processes append to one bus file — the gateway, every pod, each session's MCP server, the
+ * capture sidecar — and each used to run its OWN rename cascade (`unlink .N`, `.N-1→.N` … `file→.1`)
+ * off its OWN size check. Two writers that both saw the file over the cap before either renamed it
+ * both cascaded: the second shifted the first's just-rotated generation down a slot, overwrote the
+ * history behind it, and rotated a near-empty live file into `.1`. That is the missing-generation
+ * signature. Serialising the cascade behind an `O_EXCL` lock file, and RE-CHECKING the size once the
+ * lock is held, makes the second writer see a fresh file and stand down.
+ *
+ * Node-only and dependency-free: the caller injects the fs primitives so the fs-tap-safe pristine
+ * references in `node-instrumentation/emit.ts` keep working. Same arrangement as `./redact`.
+ */
+export interface BusFs {
+    statSync(path: string): {
+        size: number;
+        mtimeMs: number;
+    };
+    renameSync(from: string, to: string): void;
+    unlinkSync(path: string): void;
+    openSync(path: string, flags: string): number;
+    closeSync(fd: number): void;
+}
+export interface BusRotationOptions {
+    maxBytes: number;
+    maxFiles: number;
+    fs: BusFs;
+    /** A lock older than this belongs to a writer that died mid-cascade. Default 30 s. */
+    staleLockMs?: number;
+}
+export type BusRotationResult = 'rotated' | 'not-needed' | 'busy';
+/**
+ * Rotate `file` if it is over `maxBytes`. `busy` means another writer holds the cascade — it will do
+ * the work, so the caller just carries on. Never throws.
+ */
+export declare function rotateBusFile(file: string, opts: BusRotationOptions): BusRotationResult;

package/lib/bus-rotation.js

@@ -0,0 +1 @@
+"use strict";var u=Object.defineProperty;var y=(t,c)=>u(t,"name",{value:c,configurable:!0});var l=Object.defineProperty,f=y((t,c)=>l(t,"name",{value:c,configurable:!0}),"o");export function rotateBusFile(t,c){const{fs:e,maxBytes:i,maxFiles:o}=c,r=`${t}.rotate.lock`,s=c.staleLockMs??3e4;let a;for(let n=0;n<2&&a===void 0;n++)try{a=e.openSync(r,"wx")}catch{try{if(Date.now()-e.statSync(r).mtimeMs<=s)return"busy";e.unlinkSync(r)}catch{}}if(a===void 0)return"busy";try{try{if(e.statSync(t).size<=i)return"not-needed"}catch{return"not-needed"}try{e.unlinkSync(`${t}.${o}`)}catch{}for(let n=o-1;n>=1;n--)try{e.renameSync(`${t}.${n}`,`${t}.${n+1}`)}catch{}try{e.renameSync(t,`${t}.1`)}catch{}return"rotated"}finally{try{e.closeSync(a)}catch{}try{e.unlinkSync(r)}catch{}}}y(rotateBusFile,"rotateBusFile"),f(rotateBusFile,"rotateBusFile");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/core",
-  "version": "1.23.2",
+  "version": "1.23.4",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",
@@ -16,10 +16,15 @@
       "types": "./lib/redact.d.ts",
       "import": "./lib/redact.js",
       "default": "./lib/redact.js"
+    },
+    "./bus-rotation": {
+      "types": "./lib/bus-rotation.d.ts",
+      "import": "./lib/bus-rotation.js",
+      "default": "./lib/bus-rotation.js"
     }
   },
   "dependencies": {
-    "@lensmcp/protocol-types": "1.23.2",
+    "@lensmcp/protocol-types": "1.23.4",
     "tslib": "^2.3.0"
   },
   "license": "Apache-2.0",