@planckspace/cli 0.1.0 → 0.2.0

package/dist/daemon/watcher.js

@@ -0,0 +1,187 @@
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { watch } from "chokidar";
+import { parseClaudeCodeFile } from "../scrapers/claudeCode.js";
+import { upsertSessions, getFileOffset, setFileOffset, getSessionsForCorrelation } from "../db/store.js";
+import { correlateSessions } from "../correlate.js";
+import { writeLog } from "./logger.js";
+// Coalesce rapid writes to the same file — one scrape after burst settles.
+const DEBOUNCE_MS = 250;
+/** Returns directories the watcher should monitor. Only existing paths are included. */
+export function watchPaths(overrideClaudeDir) {
+    const home = os.homedir();
+    const candidates = [
+        overrideClaudeDir ?? path.join(home, ".claude", "projects"),
+    ];
+    return candidates.filter((p) => {
+        try {
+            fs.statSync(p);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/**
+ * 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 function startWatcher(callbacks = {}, overrideClaudeDir) {
+    const dirs = watchPaths(overrideClaudeDir);
+    const timers = new Map();
+    async function scrapeFile(filePath) {
+        if (!filePath.endsWith(".jsonl"))
+            return;
+        let currentSize = 0;
+        try {
+            currentSize = fs.statSync(filePath).size;
+        }
+        catch {
+            return; // file was deleted between event and handler
+        }
+        // Skip if we've already processed this version of the file.
+        if (currentSize <= getFileOffset(filePath))
+            return;
+        const sessionId = path.basename(filePath, ".jsonl");
+        try {
+            const session = parseClaudeCodeFile(filePath, sessionId);
+            if (session) {
+                upsertSessions([session]);
+                setFileOffset(filePath, currentSize);
+                // Fire-and-forget git correlation — errors are non-fatal.
+                correlateSessions().catch(() => { });
+                writeLog({ event: "watch_scrape", file: path.basename(filePath) });
+                callbacks.onScrape?.(filePath, 1);
+            }
+        }
+        catch (err) {
+            writeLog({ event: "watch_error", file: filePath, error: String(err) });
+            callbacks.onError?.(filePath, err);
+        }
+    }
+    function schedule(filePath) {
+        const prev = timers.get(filePath);
+        if (prev)
+            clearTimeout(prev);
+        timers.set(filePath, setTimeout(() => {
+            timers.delete(filePath);
+            scrapeFile(filePath).catch(() => { });
+        }, DEBOUNCE_MS));
+    }
+    const watcher = watch(dirs, {
+        persistent: true,
+        ignoreInitial: true, // don't fire for files that already existed at startup
+        depth: 3, // projects/<dir>/<session>.jsonl → 2 levels deep is enough
+        awaitWriteFinish: { stabilityThreshold: 150, pollInterval: 50 },
+    });
+    watcher.on("add", schedule);
+    watcher.on("change", schedule);
+    writeLog({ event: "watcher_start", paths: dirs });
+    return watcher;
+}
+// ── Git ref watcher (Layer 4) ─────────────────────────────────────────────────
+// Watches .git/refs/remotes/ and .git/packed-refs across all repos with active
+// sessions. When `git push` completes, git writes the updated remote-tracking ref
+// locally — that file change triggers immediate re-correlation so session outcomes
+// flip from "unknown" → "shipped" without waiting for the 60s periodic scan.
+const GIT_DEBOUNCE_MS = 500;
+/**
+ * Returns the git ref paths to watch for a working directory.
+ * Handles both normal repos (.git/ is a dir) and git worktrees (.git is a file).
+ */
+function buildGitRefPaths(workingDir) {
+    try {
+        const gitEntry = path.join(workingDir, ".git");
+        const stat = fs.statSync(gitEntry);
+        let gitDir;
+        if (stat.isFile()) {
+            // Worktree: .git is a pointer like "gitdir: ../.git/worktrees/foo"
+            const content = fs.readFileSync(gitEntry, "utf-8").trim();
+            const m = content.match(/^gitdir:\s*(.+)$/);
+            if (!m)
+                return [];
+            // The actual remotes live two levels up from .git/worktrees/<name>
+            gitDir = path.resolve(workingDir, m[1], "..", "..");
+        }
+        else {
+            gitDir = gitEntry;
+        }
+        const paths = [];
+        const remotes = path.join(gitDir, "refs", "remotes");
+        const packedRefs = path.join(gitDir, "packed-refs");
+        try {
+            fs.statSync(remotes);
+            paths.push(remotes);
+        }
+        catch { /* not present yet */ }
+        try {
+            fs.statSync(packedRefs);
+            paths.push(packedRefs);
+        }
+        catch { /* not present yet */ }
+        return paths;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Start the git remote-ref watcher.
+ * `onPush` is called (after re-correlation completes) whenever a push is detected.
+ */
+export function startGitRefWatcher(onPush) {
+    // Track individual watched paths (not just dirs) so that refs/remotes can be
+    // added on a later refreshFromDb call if it didn't exist at initial addRepo time.
+    const watchedPaths = new Set();
+    let debounceTimer = null;
+    const fsWatcher = watch([], {
+        persistent: true,
+        ignoreInitial: true,
+        depth: 3,
+    });
+    function schedule() {
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(() => {
+            debounceTimer = null;
+            writeLog({ event: "git_push_detected" });
+            correlateSessions()
+                .then(() => onPush())
+                .catch(() => { });
+        }, GIT_DEBOUNCE_MS);
+    }
+    fsWatcher.on("change", schedule);
+    fsWatcher.on("add", schedule);
+    function addRepo(workingDir) {
+        if (!workingDir)
+            return;
+        if (!fs.existsSync(workingDir))
+            return;
+        const paths = buildGitRefPaths(workingDir);
+        const newPaths = paths.filter((p) => !watchedPaths.has(p));
+        if (newPaths.length === 0)
+            return;
+        for (const p of newPaths) {
+            watchedPaths.add(p);
+            fsWatcher.add(p);
+        }
+        writeLog({ event: "git_ref_watch_added", dir: path.basename(workingDir), paths: newPaths });
+    }
+    function refreshFromDb() {
+        try {
+            const sessions = getSessionsForCorrelation();
+            for (const s of sessions) {
+                if (s.workingDir)
+                    addRepo(s.workingDir);
+            }
+        }
+        catch { /* non-fatal */ }
+    }
+    // Seed from sessions already in the DB at startup.
+    refreshFromDb();
+    return { addRepo, refreshFromDb, close: () => fsWatcher.close() };
+}
+//# sourceMappingURL=watcher.js.map

package/dist/daemon/watcher.js.map

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

package/dist/db/store.d.ts

@@ -1,4 +1,6 @@
 import type { ParsedSession } from "../scrapers/claudeCode.js";
+import type { Insight } from "../detectors/types.js";
+import type { AnomalyEvent } from "../anomaly/types.js";
 export declare const PLANCKSPACE_DIR: string;
 export declare const DB_PATH: string;
 export type SessionRow = {
@@ -12,6 +14,9 @@ export type SessionRow = {
     cacheReadTokens: number;
     cacheWriteTokens: number;
     costUsd: number;
+    costType: string;
+    subscriptionPlan: string | null;
+    unmatchedTurns: number;
     repoName: string | null;
     gitBranch: string | null;
     gitAuthorEmail: string | null;
@@ -21,9 +26,12 @@ export type SessionRow = {
     outcome: string;
     turnsJson: string;
     scrapedAt: string;
+    mergedPrNumber: number | null;
+    mergedAt: string | null;
+    timeToMergeMs: number | null;
 };
 /** The subset of a session needed to correlate it against its git repo. */
-export type CorrelationSessionRow = Pick<SessionRow, "id" | "repoName" | "gitBranch" | "workingDir" | "startedAt" | "endedAt" | "outcome">;
+export type CorrelationSessionRow = Pick<SessionRow, "id" | "repoName" | "gitBranch" | "workingDir" | "startedAt" | "endedAt" | "outcome" | "gitAuthorEmail">;
 export declare function initDb(dbPath?: string): void;
 /** Close the database handle (mainly for tests; releases the file lock on Windows). */
 export declare function closeDb(): void;
@@ -32,15 +40,128 @@ export declare function upsertSessions(sessions: ParsedSession[]): {
     updated: number;
 };
 export declare function getSessions(): SessionRow[];
-export declare function getUnsyncedSessions(): Omit<SessionRow, "turnsJson">[];
+/**
+ * Sessions that have not yet been synced, including turnsJson and merge metadata.
+ * turnsJson is included so buildTelemetryPayload can extract per-turn metadata;
+ * the privacy invariant is enforced there (explicit field mapping, never forwarded raw).
+ */
+export declare function getUnsyncedSessions(): SessionRow[];
+/** Full session row by ID — used by `planck inspect`. Returns null if not found. */
+export declare function getSessionById(id: string): SessionRow | null;
+/** Sessions for the value report: tool filter + 30-day window. */
+export type ValueSessionRow = Pick<SessionRow, "costUsd" | "costType" | "gitAuthorEmail" | "tool">;
+export declare function getSessionsForValue(tool: string, sinceIso: string): ValueSessionRow[];
 /** Sessions to feed the git correlator — only the fields it needs to classify outcomes. */
 export declare function getSessionsForCorrelation(): CorrelationSessionRow[];
 /** Persist a session's correlated outcome and the git author email it was attributed to. */
 export declare function setSessionCorrelation(id: string, outcome: string, gitAuthorEmail: string | null): void;
+/**
+ * Persist merge metadata for a shipped session.
+ * Called after correlation determines outcome = "shipped".
+ * Clears these fields for non-shipped sessions when called with nulls.
+ */
+export declare function setSessionMergeInfo(id: string, mergedPrNumber: number | null, mergedAt: string | null, timeToMergeMs: number | null): void;
+/** Sessions needed for productivity metrics computation. */
+export type MetricsSessionRow = {
+    id: string;
+    costUsd: number;
+    outcome: string;
+    gitBranch: string | null;
+    repoName: string | null;
+    workingDir: string;
+    startedAt: string;
+    gitAuthorEmail: string | null;
+    mergedPrNumber: number | null;
+    mergedAt: string | null;
+    timeToMergeMs: number | null;
+};
+export declare function getSessionsForMetrics(sinceIso?: string): MetricsSessionRow[];
 /** Mark sessions as successfully synced (sets syncedAt, clears lastError). */
 export declare function markSessionsSynced(ids: string[]): void;
+/**
+ * Reset sync state for all sessions, forcing a full re-sync on next run.
+ * Called when switching to a different workspace so previous sessions are
+ * sent to the new workspace rather than silently skipped as already-synced.
+ */
+export declare function resetSyncState(): void;
 /** Record a sync failure; leaves syncedAt NULL so the rows retry next run. */
 export declare function recordSyncError(ids: string[], error: string): void;
 export declare function setMeta(key: string, value: string): void;
 export declare function getMeta(key: string): string | null;
+export declare function getConnectionState(key: string): string | null;
+export declare function setConnectionState(key: string, value: string): void;
+/** Session IDs that have been successfully synced (syncedAt IS NOT NULL). */
+export declare function getSyncedSessionIds(): string[];
+/**
+ * Reset sync state for specific sessions so they are re-sent on the next sync.
+ * Used by reconcileWithManifest when sessions are missing from the backend.
+ */
+export declare function resetSyncStateForIds(ids: string[], reason: string): void;
+/** Total number of sessions in the local DB (cheap COUNT, no row loading). */
+export declare function getSessionCount(): number;
+export type InsightRow = {
+    id: string;
+    detectorId: string;
+    repoName: string | null;
+    workspaceScope: string;
+    titleShort: string;
+    estimatedMonthlySavingsUsd: number;
+    confidence: string;
+    evidenceJson: string;
+    manualFix: string;
+    createdAt: string;
+    syncedAt: string | null;
+};
+/** Upsert a batch of insights; resets syncedAt so updated findings re-sync. */
+export declare function upsertInsights(insights: Insight[]): void;
+export declare function getUnsyncedInsights(): InsightRow[];
+export declare function markInsightsSynced(ids: string[]): void;
+/** Returns the last processed byte offset for a file path, or 0 if unseen. */
+export declare function getFileOffset(filePath: string): number;
+/** Record that a file has been fully processed up to the given byte offset. */
+export declare function setFileOffset(filePath: string, byteOffset: number): void;
+/** Return all file paths whose stored offset is less than the given current size map. */
+export declare function getFilesNeedingScrape(currentSizes: Map<string, number>): string[];
+export type AnomalyRow = {
+    id: string;
+    type: string;
+    repoName: string | null;
+    sessionId: string | null;
+    costUsd: number;
+    baselineUsd: number;
+    ratio: number;
+    detectedAt: string;
+    syncedAt: string | null;
+};
+/**
+ * Insert anomaly events that don't already exist (deduplication by stable id).
+ * Returns only the newly inserted events so callers can report them to the user.
+ */
+export declare function upsertAnomalies(events: AnomalyEvent[]): AnomalyEvent[];
+export declare function getUnsyncedAnomalies(): AnomalyRow[];
+export declare function markAnomaliesSynced(ids: string[]): void;
+/** Daily cost totals per repo for the given time window; ordered by repoName, day ASC. */
+export declare function getDailySessionCosts(since: string): {
+    repoName: string | null;
+    day: string;
+    dailyCost: number;
+}[];
+/** Sessions with a known developer email; ordered by gitAuthorEmail, costUsd ASC. */
+export declare function getSessionsForAnomalyDetection(since: string): {
+    id: string;
+    gitAuthorEmail: string;
+    costUsd: number;
+    repoName: string | null;
+}[];
+/** All session fields except turnsJson, filtered by a [monthStart, monthEnd) window. */
+export type ExportSessionRow = Omit<SessionRow, "turnsJson">;
+export declare function getSessionsForExport(monthStart: string, monthEnd: string): ExportSessionRow[];
+/**
+ * Total session cost since `monthStart`, broken down by repoName.
+ * Used to compute burn-rate for configured budgets.
+ */
+export declare function getMonthlyCosts(monthStart: string): {
+    byRepo: Map<string, number>;
+    total: number;
+};
 //# sourceMappingURL=store.d.ts.map

package/dist/db/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/db/store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,eAAO,MAAM,eAAe,QAA0C,CAAC;AACvE,eAAO,MAAM,OAAO,QAAyC,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,UAAU,EACV,IAAI,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CACrF,CAAC;AASF,wBAAgB,MAAM,CAAC,MAAM,SAAU,GAAG,IAAI,CAqD7C;AAED,uFAAuF;AACvF,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAqE5F;AAED,wBAAgB,WAAW,IAAI,UAAU,EAAE,CAI1C;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,CAarE;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,IAAI,qBAAqB,EAAE,CAOnE;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,IAAI,CAIN;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAetD;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAalE;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOxD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKlD"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/db/store.ts"],"names":[],"mappings":"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"}