@planckspace/cli 0.1.0 → 0.2.0

package/dist/daemon/daemon.js

@@ -0,0 +1,188 @@
+/**
+ * PlanckSpace background sync daemon.
+ *
+ * Invoked via `planck daemon run` by the OS on user login.
+ * Three-layer architecture:
+ *   Layer 1 — chokidar file watcher (sub-second latency on JSONL writes)
+ *   Layer 2 — periodic 60s full scan (completeness guarantee)
+ *   Layer 3 — persistent sync queue drain with exponential backoff
+ */
+import { initDb, getUnsyncedSessions } from "../db/store.js";
+import { scanClaudeCodeLogs } from "../scrapers/claudeCode.js";
+import { scanCursorLogs } from "../scrapers/cursor.js";
+import { scanWindsurfLogs } from "../scrapers/windsurf.js";
+import { scanJetBrainsLogs } from "../scrapers/jetbrains.js";
+import { correlateSessions } from "../correlate.js";
+import { readConfig, resolveApiUrl } from "../config.js";
+import { startWatcher, startGitRefWatcher } from "./watcher.js";
+import { SyncLoop } from "./syncLoop.js";
+import { writeLog } from "./logger.js";
+import { writeDaemonState, writePid, clearPid, readDaemonState, } from "./daemonState.js";
+const POLL_INTERVAL_MS = 60_000; // Layer 2: full scan every 60s
+const HEARTBEAT_MS = 1_000; // sleep/wake probe
+const SLEEP_THRESHOLD_MS = 5_000; // gap > 5s = process was suspended
+function getSyncDeps() {
+    const config = readConfig();
+    if (!config.token)
+        return null;
+    return {
+        apiUrl: resolveApiUrl(),
+        token: config.token,
+        workspaceId: config.workspaceId ?? "unknown",
+        workspaceSubscriptions: config.subscriptions ?? [],
+        budgets: config.budgets ?? [],
+    };
+}
+function patchState(patch) {
+    const base = readDaemonState() ?? {
+        pid: process.pid,
+        startedAt: new Date().toISOString(),
+        lastEventAt: null,
+        lastEventType: null,
+        lastSyncAt: null,
+        lastSyncCount: 0,
+        lastError: null,
+        lastErrorAt: null,
+        queueDepth: 0,
+    };
+    writeDaemonState({ ...base, ...patch });
+}
+function toolBillingMode(tool, subscriptions) {
+    const sub = subscriptions.find((s) => s.tool === tool);
+    return sub?.billingMode === "billed" ? "billed" : "imputed";
+}
+async function fullScan() {
+    // Read config fresh each poll so subscription changes take effect immediately.
+    const { subscriptions } = readConfig();
+    const cursorBilling = toolBillingMode("cursor", subscriptions);
+    const windsurfBilling = toolBillingMode("windsurf", subscriptions);
+    const [c, cu, w, jb] = await Promise.all([
+        scanClaudeCodeLogs(),
+        Promise.resolve().then(() => scanCursorLogs(undefined, cursorBilling)),
+        Promise.resolve().then(() => scanWindsurfLogs(undefined, windsurfBilling)),
+        Promise.resolve().then(() => scanJetBrainsLogs()),
+    ]);
+    const all = [...c, ...cu, ...w, ...jb];
+    if (all.length > 0) {
+        const { upsertSessions } = await import("../db/store.js");
+        upsertSessions(all);
+    }
+    await correlateSessions();
+    return all.length;
+}
+export async function runDaemon() {
+    initDb();
+    writePid(process.pid);
+    patchState({ pid: process.pid, startedAt: new Date().toISOString() });
+    writeLog({ event: "daemon_start", pid: process.pid, version: process.env.npm_package_version ?? "?" });
+    // ── Layer 3 declared early so the watcher can reference it ───────────────────
+    // (syncLoop.start() is called after doPoll completes below)
+    let syncLoopRef = null;
+    // ── Layer 4: git remote-ref watcher ───────────────────────────────────────
+    // Detects `git push` by watching .git/refs/remotes/ in every active repo.
+    // Re-correlates immediately so outcomes flip "unknown" → "shipped" in ~500ms
+    // instead of waiting up to 60s for the next periodic scan.
+    const gitRefWatcher = startGitRefWatcher(() => {
+        const queueDepth = getUnsyncedSessions().length;
+        patchState({ lastEventAt: new Date().toISOString(), lastEventType: "push", queueDepth });
+        writeLog({ event: "git_push_correlated", queueDepth });
+        syncLoopRef?.flush();
+    });
+    // ── Layer 1: file watcher ──────────────────────────────────────────────────
+    const watcher = startWatcher({
+        onScrape: (_fp, n) => {
+            const queueDepth = getUnsyncedSessions().length;
+            patchState({
+                lastEventAt: new Date().toISOString(),
+                lastEventType: "watch",
+                queueDepth,
+            });
+            writeLog({ event: "watch_scrape_done", count: n, queueDepth });
+            // Register any repo that just produced a new session.
+            gitRefWatcher.refreshFromDb();
+            // Flush the sync loop immediately — don't wait for the 30s cadence.
+            syncLoopRef?.flush();
+        },
+    });
+    // ── Layer 2: 60s periodic poll ─────────────────────────────────────────────
+    // Uses recursive setTimeout instead of setInterval so that:
+    //   a) sleep/wake cycles on Windows can't corrupt the timer (setInterval drifts
+    //      or stalls permanently after repeated wakes — confirmed in production logs)
+    //   b) a slow scan never queues a backlog of concurrent poll callbacks
+    const doPoll = async () => {
+        try {
+            const count = await fullScan();
+            const queueDepth = getUnsyncedSessions().length;
+            patchState({ lastEventAt: new Date().toISOString(), lastEventType: "scan", queueDepth });
+            writeLog({ event: "poll_scan", sessions: count, queueDepth });
+            // If correlateSessions re-queued any sessions (outcome changed → syncedAt reset),
+            // flush immediately instead of waiting up to 30s for the next sync cycle.
+            if (queueDepth > 0)
+                syncLoopRef?.flush();
+        }
+        catch (err) {
+            writeLog({ event: "poll_error", error: String(err) });
+        }
+    };
+    let nextPollTimer = null;
+    function schedulePoll(delayMs = POLL_INTERVAL_MS) {
+        if (nextPollTimer)
+            clearTimeout(nextPollTimer);
+        nextPollTimer = setTimeout(() => {
+            doPoll().finally(() => schedulePoll());
+        }, delayMs);
+    }
+    await doPoll(); // catch-up run at startup
+    schedulePoll();
+    // ── Layer 3: resilient sync queue ──────────────────────────────────────────
+    const syncLoop = syncLoopRef = new SyncLoop({
+        getDeps: getSyncDeps,
+        onSyncSuccess: (synced) => {
+            patchState({
+                lastSyncAt: new Date().toISOString(),
+                lastSyncCount: synced,
+                lastError: null,
+                lastErrorAt: null,
+                queueDepth: getUnsyncedSessions().length,
+            });
+        },
+        onSyncError: (err) => {
+            patchState({ lastError: err, lastErrorAt: new Date().toISOString() });
+        },
+        onAuthFailure: () => {
+            console.error("[daemon] Auth failure — sync paused. Run `planck login` to resume.");
+        },
+    });
+    syncLoop.start();
+    // ── Sleep/wake detection ───────────────────────────────────────────────────
+    let lastHeartbeat = Date.now();
+    const heartbeatTimer = setInterval(() => {
+        const now = Date.now();
+        const gap = now - lastHeartbeat;
+        if (gap > SLEEP_THRESHOLD_MS) {
+            writeLog({ event: "wake_detected", gapMs: gap });
+            syncLoop.flush();
+            // Sleep disrupts any pending poll timeout — immediately re-poll and reset
+            // the schedule so we don't silently skip scans after a wake.
+            schedulePoll(0);
+        }
+        lastHeartbeat = now;
+    }, HEARTBEAT_MS);
+    // ── Graceful shutdown ──────────────────────────────────────────────────────
+    const shutdown = (signal) => {
+        writeLog({ event: "daemon_stop", signal });
+        if (nextPollTimer)
+            clearTimeout(nextPollTimer);
+        clearInterval(heartbeatTimer);
+        syncLoop.stop();
+        watcher.close().catch(() => { });
+        gitRefWatcher.close().catch(() => { });
+        clearPid();
+        process.exit(0);
+    };
+    process.on("SIGTERM", () => shutdown("SIGTERM"));
+    process.on("SIGINT", () => shutdown("SIGINT"));
+    writeLog({ event: "daemon_ready" });
+    process.stdout.write(`[daemon] PlanckSpace sync running (PID ${process.pid})\n`);
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/daemon/daemon.ts"],"names":[],"mappings":"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"}

package/dist/daemon/daemonState.d.ts

@@ -0,0 +1,25 @@
+export declare const STATE_PATH: string;
+export declare const PID_PATH: string;
+export type DaemonState = {
+    pid: number;
+    startedAt: string;
+    lastEventAt: string | null;
+    lastEventType: "watch" | "scan" | "sync" | "start" | "push" | null;
+    lastSyncAt: string | null;
+    lastSyncCount: number;
+    lastError: string | null;
+    lastErrorAt: string | null;
+    queueDepth: number;
+};
+export declare function writeDaemonState(state: DaemonState): void;
+export declare function readDaemonState(): DaemonState | null;
+export declare function writePid(pid: number): void;
+export declare function readPid(): number | null;
+export declare function clearPid(): void;
+/** Returns true if the given PID is an active OS process. */
+export declare function isPidRunning(pid: number): boolean;
+/** Friendly elapsed-time string, e.g. "4h 23m" or "12s". */
+export declare function formatUptime(startedAt: string): string;
+/** Friendly "X ago" string from an ISO timestamp. */
+export declare function formatAgo(iso: string | null): string;
+//# sourceMappingURL=daemonState.d.ts.map

package/dist/daemon/daemonState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonState.d.ts","sourceRoot":"","sources":["../../src/daemon/daemonState.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,QAA4C,CAAC;AACpE,eAAO,MAAM,QAAQ,QAA2C,CAAC;AAEjE,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACnE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAKzD;AAED,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAMpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAK1C;AAED,wBAAgB,OAAO,IAAI,MAAM,GAAG,IAAI,CAOvC;AAED,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOjD;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CASpD"}

package/dist/daemon/daemonState.js

@@ -0,0 +1,82 @@
+import fs from "fs";
+import path from "path";
+import { PLANCKSPACE_DIR } from "../db/store.js";
+export const STATE_PATH = path.join(PLANCKSPACE_DIR, "daemon.json");
+export const PID_PATH = path.join(PLANCKSPACE_DIR, "daemon.pid");
+export function writeDaemonState(state) {
+    try {
+        fs.mkdirSync(path.dirname(STATE_PATH), { recursive: true });
+        fs.writeFileSync(STATE_PATH, JSON.stringify(state, null, 2), "utf-8");
+    }
+    catch { /* ignore — status is advisory */ }
+}
+export function readDaemonState() {
+    try {
+        return JSON.parse(fs.readFileSync(STATE_PATH, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function writePid(pid) {
+    try {
+        fs.mkdirSync(path.dirname(PID_PATH), { recursive: true });
+        fs.writeFileSync(PID_PATH, String(pid), "utf-8");
+    }
+    catch { /* ignore */ }
+}
+export function readPid() {
+    try {
+        const n = parseInt(fs.readFileSync(PID_PATH, "utf-8").trim(), 10);
+        return isNaN(n) ? null : n;
+    }
+    catch {
+        return null;
+    }
+}
+export function clearPid() {
+    try {
+        fs.unlinkSync(PID_PATH);
+    }
+    catch { /* already gone */ }
+}
+/** Returns true if the given PID is an active OS process. */
+export function isPidRunning(pid) {
+    try {
+        process.kill(pid, 0); // signal 0 = probe only
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Friendly elapsed-time string, e.g. "4h 23m" or "12s". */
+export function formatUptime(startedAt) {
+    const ms = Date.now() - new Date(startedAt).getTime();
+    if (ms < 0)
+        return "0s";
+    const s = Math.floor(ms / 1000);
+    const m = Math.floor(s / 60);
+    const h = Math.floor(m / 60);
+    if (h > 0)
+        return `${h}h ${m % 60}m`;
+    if (m > 0)
+        return `${m}m ${s % 60}s`;
+    return `${s}s`;
+}
+/** Friendly "X ago" string from an ISO timestamp. */
+export function formatAgo(iso) {
+    if (!iso)
+        return "never";
+    const ms = Date.now() - new Date(iso).getTime();
+    if (ms < 0)
+        return "just now";
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s ago`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ago`;
+    return `${Math.floor(m / 60)}h ago`;
+}
+//# sourceMappingURL=daemonState.js.map

package/dist/daemon/daemonState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonState.js","sourceRoot":"","sources":["../../src/daemon/daemonState.ts"],"names":[],"mappings":"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"}

package/dist/daemon/logger.d.ts

@@ -0,0 +1,7 @@
+export type LogEntry = Record<string, unknown> & {
+    event: string;
+};
+export declare function writeLog(entry: LogEntry): void;
+/** Read the last N log entries across current + rotated log files. */
+export declare function readRecentLogs(n?: number): LogEntry[];
+//# sourceMappingURL=logger.d.ts.map

package/dist/daemon/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/daemon/logger.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAc9C;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,CAAC,SAAK,GAAG,QAAQ,EAAE,CAiBjD"}

package/dist/daemon/logger.js

@@ -0,0 +1,61 @@
+import fs from "fs";
+import path from "path";
+import { PLANCKSPACE_DIR } from "../db/store.js";
+const LOG_PATH = path.join(PLANCKSPACE_DIR, "daemon.log");
+const MAX_SIZE = 10 * 1024 * 1024; // 10 MB
+const MAX_ROTATIONS = 3;
+function rotateLogs() {
+    try {
+        fs.unlinkSync(`${LOG_PATH}.${MAX_ROTATIONS}`);
+    }
+    catch { /* not present */ }
+    for (let i = MAX_ROTATIONS - 1; i >= 1; i--) {
+        try {
+            fs.renameSync(`${LOG_PATH}.${i}`, `${LOG_PATH}.${i + 1}`);
+        }
+        catch { /* not present */ }
+    }
+    try {
+        fs.renameSync(LOG_PATH, `${LOG_PATH}.1`);
+    }
+    catch { /* not present */ }
+}
+export function writeLog(entry) {
+    const line = JSON.stringify({ ts: new Date().toISOString(), ...entry }) + "\n";
+    try {
+        const stat = fs.statSync(LOG_PATH);
+        if (stat.size + line.length > MAX_SIZE)
+            rotateLogs();
+    }
+    catch { /* file not yet created */ }
+    try {
+        fs.mkdirSync(path.dirname(LOG_PATH), { recursive: true });
+        fs.appendFileSync(LOG_PATH, line, "utf-8");
+    }
+    catch (err) {
+        process.stderr.write(`[daemon] log write failed: ${String(err)}\n`);
+    }
+}
+/** Read the last N log entries across current + rotated log files. */
+export function readRecentLogs(n = 50) {
+    const files = [LOG_PATH];
+    for (let i = 1; i <= MAX_ROTATIONS; i++)
+        files.push(`${LOG_PATH}.${i}`);
+    const entries = [];
+    for (const f of files) {
+        try {
+            const lines = fs.readFileSync(f, "utf-8").trim().split("\n").filter(Boolean);
+            for (const l of lines) {
+                try {
+                    entries.push(JSON.parse(l));
+                }
+                catch { /* skip malformed */ }
+            }
+        }
+        catch { /* file not present */ }
+    }
+    // Sort by ts and return last n
+    entries.sort((a, b) => String(a.ts ?? "").localeCompare(String(b.ts ?? "")));
+    return entries.slice(-n);
+}
+//# sourceMappingURL=logger.js.map

package/dist/daemon/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/daemon/logger.ts"],"names":[],"mappings":"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"}

package/dist/daemon/syncLoop.d.ts

@@ -0,0 +1,38 @@
+import { type SyncDeps } from "../sync/syncEngine.js";
+export type SyncLoopCallbacks = {
+    /** Return current SyncDeps, or null if not connected. Called each cycle. */
+    getDeps: () => SyncDeps | null;
+    onSyncSuccess?: (synced: number) => void;
+    onSyncError?: (err: string) => void;
+    /** Called once when a 401/403 is received — the loop stops until resetAuth(). */
+    onAuthFailure?: () => void;
+};
+/**
+ * Persistent sync drain loop (Layer 3).
+ *
+ * Sessions are attributed by the authenticated token (one daemon = one user).
+ * Git email is descriptive only. Shared-machine multi-author attribution is out of scope for MVP.
+ *
+ * Runs continuously, draining the unsynced session queue.
+ * On success: waits HEALTHY_INTERVAL_MS then checks again.
+ * On network/server failure: exponential backoff (1s → 5s → 30s → 5min → 1hr).
+ * On auth failure: stops completely until resetAuth() is called.
+ */
+export declare class SyncLoop {
+    private callbacks;
+    private running;
+    private authFailed;
+    private failureCount;
+    private timer;
+    constructor(callbacks: SyncLoopCallbacks);
+    start(): void;
+    stop(): void;
+    /** Immediately attempt a sync (e.g. called on OS wake). */
+    flush(): void;
+    /** Resume after auth has been fixed (user ran `planck login`). */
+    resetAuth(): void;
+    private schedule;
+    private nextDelay;
+    private cycle;
+}
+//# sourceMappingURL=syncLoop.d.ts.map

package/dist/daemon/syncLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncLoop.d.ts","sourceRoot":"","sources":["../../src/daemon/syncLoop.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAoBhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,QAAQ,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IAMP,OAAO,CAAC,SAAS;IAL7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAA8C;gBAEvC,SAAS,EAAE,iBAAiB;IAEhD,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAQZ,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IASb,kEAAkE;IAClE,SAAS,IAAI,IAAI;IAMjB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,SAAS;YAKH,KAAK;CA0CpB"}

package/dist/daemon/syncLoop.js

@@ -0,0 +1,119 @@
+import { getUnsyncedSessions } from "../db/store.js";
+import { syncOnce } from "../sync/syncEngine.js";
+import { writeLog } from "./logger.js";
+// Backoff on network / server failures (not auth).
+// Steps in ms: 1s → 5s → 30s → 5min → max 1hr
+const BACKOFF_STEPS_MS = [1_000, 5_000, 30_000, 5 * 60_000];
+const MAX_BACKOFF_MS = 60 * 60_000;
+// Normal cadence when the queue is draining cleanly.
+const HEALTHY_INTERVAL_MS = 30_000;
+function getBackoff(failureCount) {
+    const idx = Math.min(failureCount - 1, BACKOFF_STEPS_MS.length - 1);
+    return idx < 0 ? HEALTHY_INTERVAL_MS : (BACKOFF_STEPS_MS[idx] ?? MAX_BACKOFF_MS);
+}
+/** ±10% jitter — prevents daemons started concurrently from syncing in lockstep. */
+function withJitter(baseMs) {
+    return Math.floor(baseMs * (0.9 + Math.random() * 0.2));
+}
+/**
+ * Persistent sync drain loop (Layer 3).
+ *
+ * Sessions are attributed by the authenticated token (one daemon = one user).
+ * Git email is descriptive only. Shared-machine multi-author attribution is out of scope for MVP.
+ *
+ * Runs continuously, draining the unsynced session queue.
+ * On success: waits HEALTHY_INTERVAL_MS then checks again.
+ * On network/server failure: exponential backoff (1s → 5s → 30s → 5min → 1hr).
+ * On auth failure: stops completely until resetAuth() is called.
+ */
+export class SyncLoop {
+    callbacks;
+    running = false;
+    authFailed = false;
+    failureCount = 0;
+    timer = null;
+    constructor(callbacks) {
+        this.callbacks = callbacks;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.schedule(0);
+    }
+    stop() {
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Immediately attempt a sync (e.g. called on OS wake). */
+    flush() {
+        if (!this.running || this.authFailed)
+            return;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.cycle().catch(() => { });
+    }
+    /** Resume after auth has been fixed (user ran `planck login`). */
+    resetAuth() {
+        this.authFailed = false;
+        this.failureCount = 0;
+        this.flush();
+    }
+    schedule(delayMs) {
+        if (!this.running || this.authFailed)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            this.cycle()
+                .catch(() => { })
+                .finally(() => this.schedule(this.nextDelay()));
+        }, delayMs);
+    }
+    nextDelay() {
+        const base = this.failureCount === 0 ? HEALTHY_INTERVAL_MS : getBackoff(this.failureCount);
+        return withJitter(base);
+    }
+    async cycle() {
+        const deps = this.callbacks.getDeps();
+        if (!deps) {
+            // Not connected; don't burn the queue but also don't increment failureCount
+            // — absence of a token is not a network error.
+            writeLog({ event: "sync_skip", reason: "not_connected" });
+            return;
+        }
+        const queueDepth = getUnsyncedSessions().length;
+        if (queueDepth === 0) {
+            // Nothing to do; reset failure streak on empty queue.
+            this.failureCount = 0;
+            return;
+        }
+        writeLog({ event: "sync_start", queueDepth });
+        try {
+            const result = await syncOnce(deps);
+            if (result.authWarnings.length > 0) {
+                this.authFailed = true;
+                const msg = "auth failure (401/403) — run `planck login` to resume sync";
+                writeLog({ event: "sync_auth_failure", warnings: result.authWarnings });
+                this.callbacks.onAuthFailure?.();
+                this.callbacks.onSyncError?.(msg);
+                this.stop(); // will not re-schedule
+                return;
+            }
+            this.failureCount = 0;
+            writeLog({ event: "sync_success", synced: result.synced, failed: result.failed });
+            this.callbacks.onSyncSuccess?.(result.synced);
+        }
+        catch (err) {
+            this.failureCount++;
+            const msg = String(err);
+            writeLog({ event: "sync_error", error: msg, attempt: this.failureCount });
+            this.callbacks.onSyncError?.(msg);
+        }
+    }
+}
+//# sourceMappingURL=syncLoop.js.map

package/dist/daemon/syncLoop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncLoop.js","sourceRoot":"","sources":["../../src/daemon/syncLoop.ts"],"names":[],"mappings":"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"}

package/dist/daemon/watcher.d.ts

@@ -0,0 +1,26 @@
+import { type FSWatcher } from "chokidar";
+/** Returns directories the watcher should monitor. Only existing paths are included. */
+export declare function watchPaths(overrideClaudeDir?: string): string[];
+export type WatcherCallbacks = {
+    onScrape?: (filePath: string, sessionCount: number) => void;
+    onError?: (filePath: string, err: unknown) => void;
+};
+/**
+ * Start the chokidar file watcher over Claude Code JSONL directories.
+ * Cursor and Windsurf use SQLite DBs — they are not JSONL and are covered by
+ * the 60s periodic poll instead.
+ */
+export declare function startWatcher(callbacks?: WatcherCallbacks, overrideClaudeDir?: string): FSWatcher;
+export type GitRefWatcher = {
+    /** Register a new repo working directory to watch. Idempotent. */
+    addRepo: (workingDir: string) => void;
+    /** Re-scan the DB for any repos that appeared since startup. */
+    refreshFromDb: () => void;
+    close: () => Promise<void>;
+};
+/**
+ * Start the git remote-ref watcher.
+ * `onPush` is called (after re-correlation completes) whenever a push is detected.
+ */
+export declare function startGitRefWatcher(onPush: () => void): GitRefWatcher;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/daemon/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/daemon/watcher.ts"],"names":[],"mappings":"AAGA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AASjD,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ/D;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,GAAE,gBAAqB,EAChC,iBAAiB,CAAC,EAAE,MAAM,GACzB,SAAS,CA4DX;AAwCD,MAAM,MAAM,aAAa,GAAG;IAC1B,kEAAkE;IAClE,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,gEAAgE;IAChE,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,aAAa,CAoDpE"}