@nocoo/pew 0.8.0 → 1.1.1

package/dist/storage/base-cursor-store.js

@@ -0,0 +1,33 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+/**
+ * Generic base class for persisting cursor state to disk as JSON.
+ *
+ * Both `CursorStore` (token cursors) and `SessionCursorStore` (session cursors)
+ * share identical load/save logic — only the filename and empty-state factory differ.
+ */
+export class BaseCursorStore {
+    filePath;
+    emptyState;
+    constructor(filePath, emptyState) {
+        this.filePath = filePath;
+        this.emptyState = emptyState;
+    }
+    /** Load cursor state from disk. Returns empty state if file doesn't exist or is corrupted. */
+    async load() {
+        try {
+            const raw = await readFile(this.filePath, "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return this.emptyState();
+        }
+    }
+    /** Save cursor state to disk, creating the directory if needed. */
+    async save(state) {
+        const dir = dirname(this.filePath);
+        await mkdir(dir, { recursive: true });
+        await writeFile(this.filePath, JSON.stringify(state, null, 2) + "\n");
+    }
+}
+//# sourceMappingURL=base-cursor-store.js.map

package/dist/storage/base-cursor-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-cursor-store.js","sourceRoot":"","sources":["../../src/storage/base-cursor-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACjB,QAAQ,CAAS;IACT,UAAU,CAAU;IAErC,YAAY,QAAgB,EAAE,UAAmB;QAC/C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,8FAA8F;IAC9F,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,IAAI,CAAC,KAAQ;QACjB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/storage/cursor-store.d.ts

@@ -1,14 +1,10 @@
 import type { CursorState } from "@pew/core";
+import { BaseCursorStore } from "./base-cursor-store.js";
 /**
  * Persists incremental parsing cursors to disk.
  * Stored at ~/.config/pew/cursors.json
  */
-export declare class CursorStore {
-    readonly filePath: string;
+export declare class CursorStore extends BaseCursorStore<CursorState> {
     constructor(storeDir: string);
-    /** Load cursor state from disk. Returns empty state if file doesn't exist or is corrupted. */
-    load(): Promise<CursorState>;
-    /** Save cursor state to disk, creating the directory if needed. */
-    save(state: CursorState): Promise<void>;
 }
 //# sourceMappingURL=cursor-store.d.ts.map

package/dist/storage/cursor-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-store.d.ts","sourceRoot":"","sources":["../../src/storage/cursor-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAS7C;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM;IAI5B,8FAA8F;IACxF,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IASlC,mEAAmE;IAC7D,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9C"}
+{"version":3,"file":"cursor-store.d.ts","sourceRoot":"","sources":["../../src/storage/cursor-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD;;;GAGG;AACH,qBAAa,WAAY,SAAQ,eAAe,CAAC,WAAW,CAAC;gBAC/C,QAAQ,EAAE,MAAM;CAM7B"}

package/dist/storage/cursor-store.js

@@ -1,34 +1,13 @@
-import { readFile, writeFile, mkdir } from "node:fs/promises";
-import { join, dirname } from "node:path";
+import { join } from "node:path";
+import { BaseCursorStore } from "./base-cursor-store.js";
 const CURSORS_FILE = "cursors.json";
-/** Creates a fresh empty cursor state */
-function emptyCursorState() {
-    return { version: 1, files: {}, updatedAt: null };
-}
 /**
  * Persists incremental parsing cursors to disk.
  * Stored at ~/.config/pew/cursors.json
  */
-export class CursorStore {
-    filePath;
+export class CursorStore extends BaseCursorStore {
     constructor(storeDir) {
-        this.filePath = join(storeDir, CURSORS_FILE);
-    }
-    /** Load cursor state from disk. Returns empty state if file doesn't exist or is corrupted. */
-    async load() {
-        try {
-            const raw = await readFile(this.filePath, "utf-8");
-            return JSON.parse(raw);
-        }
-        catch {
-            return emptyCursorState();
-        }
-    }
-    /** Save cursor state to disk, creating the directory if needed. */
-    async save(state) {
-        const dir = dirname(this.filePath);
-        await mkdir(dir, { recursive: true });
-        await writeFile(this.filePath, JSON.stringify(state, null, 2) + "\n");
+        super(join(storeDir, CURSORS_FILE), () => ({ version: 1, files: {}, updatedAt: null }));
     }
 }
 //# sourceMappingURL=cursor-store.js.map

package/dist/storage/cursor-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-store.js","sourceRoot":"","sources":["../../src/storage/cursor-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,yCAAyC;AACzC,SAAS,gBAAgB;IACvB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,WAAW;IACb,QAAQ,CAAS;IAE1B,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED,8FAA8F;IAC9F,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,gBAAgB,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,IAAI,CAAC,KAAkB;QAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACxE,CAAC;CACF"}
+{"version":3,"file":"cursor-store.js","sourceRoot":"","sources":["../../src/storage/cursor-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,eAA4B;IAC3D,YAAY,QAAgB;QAC1B,KAAK,CACH,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EAC5B,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CACnD,CAAC;IACJ,CAAC;CACF"}

package/dist/storage/session-cursor-store.d.ts

@@ -1,14 +1,10 @@
 import type { SessionCursorState } from "@pew/core";
+import { BaseCursorStore } from "./base-cursor-store.js";
 /**
  * Persists session file cursors (mtime + size dual-check) to disk.
  * Stored at ~/.config/pew/session-cursors.json
  */
-export declare class SessionCursorStore {
-    readonly filePath: string;
+export declare class SessionCursorStore extends BaseCursorStore<SessionCursorState> {
     constructor(storeDir: string);
-    /** Load cursor state from disk. Returns empty state if file doesn't exist or is corrupted. */
-    load(): Promise<SessionCursorState>;
-    /** Save cursor state to disk, creating the directory if needed. */
-    save(state: SessionCursorState): Promise<void>;
 }
 //# sourceMappingURL=session-cursor-store.d.ts.map

package/dist/storage/session-cursor-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-cursor-store.d.ts","sourceRoot":"","sources":["../../src/storage/session-cursor-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AASpD;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM;IAI5B,8FAA8F;IACxF,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IASzC,mEAAmE;IAC7D,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAKrD"}
+{"version":3,"file":"session-cursor-store.d.ts","sourceRoot":"","sources":["../../src/storage/session-cursor-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,eAAe,CAAC,kBAAkB,CAAC;gBAC7D,QAAQ,EAAE,MAAM;CAM7B"}

package/dist/storage/session-cursor-store.js

@@ -1,34 +1,13 @@
-import { readFile, writeFile, mkdir } from "node:fs/promises";
-import { join, dirname } from "node:path";
+import { join } from "node:path";
+import { BaseCursorStore } from "./base-cursor-store.js";
 const CURSORS_FILE = "session-cursors.json";
-/** Creates a fresh empty session cursor state */
-function emptyCursorState() {
-    return { version: 1, files: {}, updatedAt: null };
-}
 /**
  * Persists session file cursors (mtime + size dual-check) to disk.
  * Stored at ~/.config/pew/session-cursors.json
  */
-export class SessionCursorStore {
-    filePath;
+export class SessionCursorStore extends BaseCursorStore {
     constructor(storeDir) {
-        this.filePath = join(storeDir, CURSORS_FILE);
-    }
-    /** Load cursor state from disk. Returns empty state if file doesn't exist or is corrupted. */
-    async load() {
-        try {
-            const raw = await readFile(this.filePath, "utf-8");
-            return JSON.parse(raw);
-        }
-        catch {
-            return emptyCursorState();
-        }
-    }
-    /** Save cursor state to disk, creating the directory if needed. */
-    async save(state) {
-        const dir = dirname(this.filePath);
-        await mkdir(dir, { recursive: true });
-        await writeFile(this.filePath, JSON.stringify(state, null, 2) + "\n");
+        super(join(storeDir, CURSORS_FILE), () => ({ version: 1, files: {}, updatedAt: null }));
     }
 }
 //# sourceMappingURL=session-cursor-store.js.map

package/dist/storage/session-cursor-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-cursor-store.js","sourceRoot":"","sources":["../../src/storage/session-cursor-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAE5C,iDAAiD;AACjD,SAAS,gBAAgB;IACvB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACpB,QAAQ,CAAS;IAE1B,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED,8FAA8F;IAC9F,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,gBAAgB,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,IAAI,CAAC,KAAyB;QAClC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACxE,CAAC;CACF"}
+{"version":3,"file":"session-cursor-store.js","sourceRoot":"","sources":["../../src/storage/session-cursor-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAE5C;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,eAAmC;IACzE,YAAY,QAAgB;QAC1B,KAAK,CACH,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EAC5B,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CACnD,CAAC;IACJ,CAAC;CACF"}

package/dist/utils/file-changed.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Fast-skip change detection for file-based cursors.
+ *
+ * Compares inode + mtimeMs + size to detect whether a file has changed
+ * since the last cursor was written. All three must match for the file
+ * to be considered unchanged.
+ *
+ * This replaces the scattered inline checks across sync.ts and the
+ * session-sync.ts `fileChanged()` helper.
+ */
+/** Minimal fingerprint needed for change detection */
+export interface FileFingerprint {
+    inode: number;
+    mtimeMs: number;
+    size: number;
+}
+/**
+ * Returns true if the file has NOT changed since the cursor was written.
+ *
+ * A file is unchanged when all three fields match:
+ * - inode (same physical file — detects rotation/replacement)
+ * - mtimeMs (no writes since last scan)
+ * - size (paranoia — catches in-place overwrites with same mtime)
+ *
+ * Returns false (= file changed) when:
+ * - prev is undefined (first scan, no cursor yet)
+ * - prev is missing mtimeMs/size (old cursor format, gradual migration)
+ * - any of the three fields differ
+ */
+export declare function fileUnchanged(prev: {
+    inode: number;
+    mtimeMs?: number;
+    size?: number;
+} | undefined, curr: FileFingerprint): boolean;
+//# sourceMappingURL=file-changed.d.ts.map

package/dist/utils/file-changed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-changed.d.ts","sourceRoot":"","sources":["../../src/utils/file-changed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EACpE,IAAI,EAAE,eAAe,GACpB,OAAO,CAST"}

package/dist/utils/file-changed.js

@@ -0,0 +1,34 @@
+/**
+ * Fast-skip change detection for file-based cursors.
+ *
+ * Compares inode + mtimeMs + size to detect whether a file has changed
+ * since the last cursor was written. All three must match for the file
+ * to be considered unchanged.
+ *
+ * This replaces the scattered inline checks across sync.ts and the
+ * session-sync.ts `fileChanged()` helper.
+ */
+/**
+ * Returns true if the file has NOT changed since the cursor was written.
+ *
+ * A file is unchanged when all three fields match:
+ * - inode (same physical file — detects rotation/replacement)
+ * - mtimeMs (no writes since last scan)
+ * - size (paranoia — catches in-place overwrites with same mtime)
+ *
+ * Returns false (= file changed) when:
+ * - prev is undefined (first scan, no cursor yet)
+ * - prev is missing mtimeMs/size (old cursor format, gradual migration)
+ * - any of the three fields differ
+ */
+export function fileUnchanged(prev, curr) {
+    if (!prev)
+        return false;
+    // Old cursors may lack mtimeMs/size — treat as changed for gradual migration
+    if (prev.mtimeMs === undefined || prev.size === undefined)
+        return false;
+    return (prev.inode === curr.inode &&
+        prev.mtimeMs === curr.mtimeMs &&
+        prev.size === curr.size);
+}
+//# sourceMappingURL=file-changed.js.map

package/dist/utils/file-changed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-changed.js","sourceRoot":"","sources":["../../src/utils/file-changed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAoE,EACpE,IAAqB;IAErB,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,6EAA6E;IAC7E,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxE,OAAO,CACL,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;QACzB,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;QAC7B,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CACxB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nocoo/pew",
-  "version": "0.8.0",
-  "description": "Track token usage from your local AI coding tools",
+  "version": "1.1.1",
+  "description": "The contribution graph for AI-native developers",
   "type": "module",
   "bin": {
     "pew": "dist/bin.js"