@tyroneross/bookmark 0.1.0

package/dist/snapshot/compress.js

@@ -0,0 +1,93 @@
+/**
+ * Compress a full snapshot into a concise markdown summary.
+ * Target: <150 lines, <1000 tokens.
+ * This becomes LATEST.md — the hot context tier.
+ */
+export function compressToMarkdown(snapshot) {
+    const lines = [];
+    // Header
+    const date = new Date(snapshot.timestamp).toISOString();
+    lines.push(`# Session Context - Last Updated ${date}`);
+    lines.push('');
+    lines.push(`> Snapshot: ${snapshot.snapshot_id} | Compaction cycle: ${snapshot.compaction_cycle} | Trigger: ${snapshot.trigger}`);
+    lines.push(`> Context remaining: ${Math.round(snapshot.context_remaining_pct * 100)}% (~${snapshot.token_estimate.toLocaleString()} tokens used)`);
+    lines.push('');
+    // Current Status
+    if (snapshot.current_status && snapshot.current_status !== 'No status available') {
+        lines.push('## Current Status');
+        lines.push(truncate(snapshot.current_status, 300));
+        lines.push('');
+    }
+    // Decisions
+    if (snapshot.decisions.length > 0) {
+        lines.push('## Decisions Made');
+        for (const d of snapshot.decisions.slice(0, 8)) {
+            const rationale = d.rationale ? ` (${truncate(d.rationale, 80)})` : '';
+            lines.push(`- ${truncate(d.description, 150)}${rationale}`);
+        }
+        if (snapshot.decisions.length > 8) {
+            lines.push(`- ...and ${snapshot.decisions.length - 8} more`);
+        }
+        lines.push('');
+    }
+    // Files Changed
+    if (snapshot.files_changed.length > 0) {
+        lines.push('## Files Changed This Session');
+        for (const f of snapshot.files_changed.slice(0, 12)) {
+            const ops = f.operations.join(', ');
+            lines.push(`- \`${f.path}\` (${ops})`);
+        }
+        if (snapshot.files_changed.length > 12) {
+            lines.push(`- ...and ${snapshot.files_changed.length - 12} more files`);
+        }
+        lines.push('');
+    }
+    // Open Items
+    if (snapshot.open_items.length > 0) {
+        lines.push('## Open Items');
+        for (const item of snapshot.open_items.slice(0, 8)) {
+            const priority = item.priority === 'high' ? ' [HIGH]' : item.priority === 'medium' ? ' [MED]' : '';
+            lines.push(`- [ ] ${truncate(item.description, 150)}${priority}`);
+        }
+        if (snapshot.open_items.length > 8) {
+            lines.push(`- ...and ${snapshot.open_items.length - 8} more`);
+        }
+        lines.push('');
+    }
+    // Unknowns / Blockers
+    if (snapshot.unknowns.length > 0) {
+        lines.push('## Unknowns / Blockers');
+        for (const u of snapshot.unknowns.slice(0, 5)) {
+            lines.push(`- ${truncate(u, 150)}`);
+        }
+        lines.push('');
+    }
+    // Errors (only unresolved)
+    const unresolvedErrors = snapshot.errors_encountered.filter(e => !e.resolved);
+    if (unresolvedErrors.length > 0) {
+        lines.push('## Unresolved Errors');
+        for (const e of unresolvedErrors.slice(0, 3)) {
+            const tool = e.tool ? ` (${e.tool})` : '';
+            lines.push(`- ${truncate(e.message, 150)}${tool}`);
+        }
+        lines.push('');
+    }
+    // Tool Usage Summary (compact)
+    if (Object.keys(snapshot.tools_summary).length > 0) {
+        const topTools = Object.entries(snapshot.tools_summary)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([tool, count]) => `${tool}: ${count}`)
+            .join(', ');
+        lines.push(`> Tool usage: ${topTools}`);
+        lines.push('');
+    }
+    lines.push('*bookmark — context snapshot*');
+    return lines.join('\n');
+}
+function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen - 3) + '...';
+}
+//# sourceMappingURL=compress.js.map

package/dist/snapshot/compress.js.map

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

package/dist/snapshot/storage.d.ts

@@ -0,0 +1,13 @@
+import type { Snapshot, SnapshotEntry } from '../types.js';
+export declare function getSnapshotsDir(storagePath: string): string;
+export declare function getLatestPath(storagePath: string): string;
+export declare function getIndexPath(storagePath: string): string;
+export declare function ensureStorageDirs(storagePath: string): void;
+export declare function storeSnapshot(storagePath: string, snapshot: Snapshot): string;
+export declare function loadSnapshot(storagePath: string, snapshotId: string): Snapshot | null;
+export declare function loadLatestSnapshot(storagePath: string): Snapshot | null;
+export declare function listSnapshots(storagePath: string, limit?: number): SnapshotEntry[];
+export declare function writeLatestMd(storagePath: string, content: string): void;
+export declare function readLatestMd(storagePath: string): string | null;
+export declare function getSnapshotCount(storagePath: string): number;
+//# sourceMappingURL=storage.d.ts.map

package/dist/snapshot/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/snapshot/storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAiB,aAAa,EAAE,MAAM,aAAa,CAAC;AAY1E,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAW3D;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAW7E;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAcrF;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAMvE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,aAAa,EAAE,CAI9E;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGxE;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ/D;AAiED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ5D"}

package/dist/snapshot/storage.js

@@ -0,0 +1,151 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+const INDEX_VERSION = '1.0.0';
+function generateSnapshotId() {
+    const now = new Date();
+    const pad = (n, len = 2) => String(n).padStart(len, '0');
+    const date = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}`;
+    const time = `${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+    return `SNAP_${date}_${time}`;
+}
+export function getSnapshotsDir(storagePath) {
+    return join(storagePath, 'snapshots');
+}
+export function getLatestPath(storagePath) {
+    return join(storagePath, 'LATEST.md');
+}
+export function getIndexPath(storagePath) {
+    return join(storagePath, 'index.json');
+}
+export function ensureStorageDirs(storagePath) {
+    const dirs = [
+        storagePath,
+        join(storagePath, 'snapshots'),
+        join(storagePath, 'archive'),
+    ];
+    for (const dir of dirs) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+}
+export function storeSnapshot(storagePath, snapshot) {
+    ensureStorageDirs(storagePath);
+    const snapshotId = snapshot.snapshot_id || generateSnapshotId();
+    const snapshotPath = join(getSnapshotsDir(storagePath), `${snapshotId}.json`);
+    writeFileSync(snapshotPath, JSON.stringify(snapshot, null, 2), 'utf-8');
+    // Update index
+    updateIndex(storagePath, snapshot);
+    return snapshotId;
+}
+export function loadSnapshot(storagePath, snapshotId) {
+    // Validate snapshot ID format to prevent path traversal
+    if (!/^SNAP_\d{8}_\d{6}$/.test(snapshotId)) {
+        return null;
+    }
+    const snapshotPath = join(getSnapshotsDir(storagePath), `${snapshotId}.json`);
+    if (!existsSync(snapshotPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(snapshotPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function loadLatestSnapshot(storagePath) {
+    const index = loadIndex(storagePath);
+    if (!index || index.snapshots.length === 0)
+        return null;
+    const latestEntry = index.snapshots[0]; // Most recent first
+    return loadSnapshot(storagePath, latestEntry.id);
+}
+export function listSnapshots(storagePath, limit = 10) {
+    const index = loadIndex(storagePath);
+    if (!index)
+        return [];
+    return index.snapshots.slice(0, limit);
+}
+export function writeLatestMd(storagePath, content) {
+    ensureStorageDirs(storagePath);
+    writeFileSync(getLatestPath(storagePath), content, 'utf-8');
+}
+export function readLatestMd(storagePath) {
+    const path = getLatestPath(storagePath);
+    if (!existsSync(path))
+        return null;
+    try {
+        return readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function loadIndex(storagePath) {
+    const indexPath = getIndexPath(storagePath);
+    if (!existsSync(indexPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(indexPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function updateIndex(storagePath, snapshot) {
+    const indexPath = getIndexPath(storagePath);
+    let index = loadIndex(storagePath) ?? {
+        version: INDEX_VERSION,
+        project_path: snapshot.project_path,
+        last_updated: Date.now(),
+        stats: {
+            total_snapshots: 0,
+            compaction_cycles: 0,
+            last_compaction: 0,
+            last_snapshot: 0,
+            last_time_based: 0,
+        },
+        snapshots: [],
+    };
+    const entry = {
+        id: snapshot.snapshot_id,
+        timestamp: snapshot.timestamp,
+        trigger: snapshot.trigger,
+        compaction_cycle: snapshot.compaction_cycle,
+        context_remaining_pct: snapshot.context_remaining_pct,
+        token_estimate: snapshot.token_estimate,
+        decisions_count: snapshot.decisions.length,
+        files_changed_count: snapshot.files_changed.length,
+        open_items_count: snapshot.open_items.length,
+    };
+    // Add to front (most recent first)
+    index.snapshots.unshift(entry);
+    // Update stats
+    index.stats.total_snapshots = index.snapshots.length;
+    index.stats.last_snapshot = snapshot.timestamp;
+    index.last_updated = Date.now();
+    if (snapshot.trigger === 'pre_compact') {
+        index.stats.compaction_cycles = snapshot.compaction_cycle;
+        index.stats.last_compaction = snapshot.timestamp;
+    }
+    if (snapshot.trigger === 'time_interval') {
+        index.stats.last_time_based = snapshot.timestamp;
+    }
+    // Cap active snapshots
+    if (index.snapshots.length > 50) {
+        index.snapshots.length = 50;
+    }
+    writeFileSync(indexPath, JSON.stringify(index, null, 2), 'utf-8');
+}
+export function getSnapshotCount(storagePath) {
+    const snapshotsDir = getSnapshotsDir(storagePath);
+    if (!existsSync(snapshotsDir))
+        return 0;
+    try {
+        return readdirSync(snapshotsDir).filter(f => f.startsWith('SNAP_') && f.endsWith('.json')).length;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/snapshot/storage.js.map

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

package/dist/threshold/adaptive.d.ts

@@ -0,0 +1,23 @@
+import type { BookmarkConfig } from '../types.js';
+/**
+ * Get the current snapshot threshold based on compaction count.
+ *
+ * As compaction happens more frequently, snapshot earlier:
+ * - 0 compactions: snapshot when 20% context remains
+ * - 1 compaction:  snapshot when 30% context remains
+ * - 2 compactions: snapshot when 40% context remains
+ * - 3+ compactions: snapshot when 50% context remains (capped)
+ *
+ * @returns threshold as a fraction (0.0-1.0) representing % context remaining
+ */
+export declare function getThreshold(compactionCount: number, config: BookmarkConfig): number;
+/**
+ * Check if current context usage should trigger a snapshot.
+ *
+ * @param remainingPct - fraction of context remaining (0.0-1.0)
+ * @param compactionCount - number of compactions in this session chain
+ * @param config - bookmark configuration
+ * @returns true if a snapshot should be taken
+ */
+export declare function shouldSnapshotByThreshold(remainingPct: number, compactionCount: number, config: BookmarkConfig): boolean;
+//# sourceMappingURL=adaptive.d.ts.map

package/dist/threshold/adaptive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive.d.ts","sourceRoot":"","sources":["../../src/threshold/adaptive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAIpF;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,cAAc,GACrB,OAAO,CAGT"}

package/dist/threshold/adaptive.js

@@ -0,0 +1,29 @@
+/**
+ * Get the current snapshot threshold based on compaction count.
+ *
+ * As compaction happens more frequently, snapshot earlier:
+ * - 0 compactions: snapshot when 20% context remains
+ * - 1 compaction:  snapshot when 30% context remains
+ * - 2 compactions: snapshot when 40% context remains
+ * - 3+ compactions: snapshot when 50% context remains (capped)
+ *
+ * @returns threshold as a fraction (0.0-1.0) representing % context remaining
+ */
+export function getThreshold(compactionCount, config) {
+    const { thresholds, maxThreshold } = config;
+    const index = Math.min(compactionCount, thresholds.length - 1);
+    return Math.min(thresholds[index], maxThreshold);
+}
+/**
+ * Check if current context usage should trigger a snapshot.
+ *
+ * @param remainingPct - fraction of context remaining (0.0-1.0)
+ * @param compactionCount - number of compactions in this session chain
+ * @param config - bookmark configuration
+ * @returns true if a snapshot should be taken
+ */
+export function shouldSnapshotByThreshold(remainingPct, compactionCount, config) {
+    const threshold = getThreshold(compactionCount, config);
+    return remainingPct <= threshold;
+}
+//# sourceMappingURL=adaptive.js.map

package/dist/threshold/adaptive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive.js","sourceRoot":"","sources":["../../src/threshold/adaptive.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,eAAuB,EAAE,MAAsB;IAC1E,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,YAAoB,EACpB,eAAuB,EACvB,MAAsB;IAEtB,MAAM,SAAS,GAAG,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACxD,OAAO,YAAY,IAAI,SAAS,CAAC;AACnC,CAAC"}

package/dist/threshold/state.d.ts

@@ -0,0 +1,8 @@
+import type { BookmarkState } from '../types.js';
+export declare function getStatePath(storagePath: string): string;
+export declare function loadState(storagePath: string): BookmarkState;
+export declare function saveState(storagePath: string, state: BookmarkState): void;
+export declare function incrementCompaction(state: BookmarkState, thresholds: number[]): BookmarkState;
+export declare function resetForNewSession(state: BookmarkState, sessionId: string, thresholds: number[]): BookmarkState;
+export declare function updateSnapshotTime(state: BookmarkState): BookmarkState;
+//# sourceMappingURL=state.d.ts.map

package/dist/threshold/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/threshold/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAkB/D,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAY5D;AAED,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAOzE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,aAAa,CAQ7F;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,aAAa,CAyB/G;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAMtE"}

package/dist/threshold/state.js

@@ -0,0 +1,83 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+const STATE_VERSION = '1.0.0';
+const MAX_SESSION_HISTORY = 10;
+function defaultState() {
+    return {
+        version: STATE_VERSION,
+        session_id: '',
+        compaction_count: 0,
+        current_threshold: 0.20,
+        last_snapshot_time: 0,
+        last_event_time: 0,
+        snapshot_interval_minutes: 20,
+        session_history: [],
+    };
+}
+export function getStatePath(storagePath) {
+    return join(storagePath, 'state.json');
+}
+export function loadState(storagePath) {
+    const statePath = getStatePath(storagePath);
+    if (!existsSync(statePath)) {
+        return defaultState();
+    }
+    try {
+        const raw = readFileSync(statePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return { ...defaultState(), ...parsed };
+    }
+    catch {
+        return defaultState();
+    }
+}
+export function saveState(storagePath, state) {
+    const statePath = getStatePath(storagePath);
+    const dir = dirname(statePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(statePath, JSON.stringify(state, null, 2), 'utf-8');
+}
+export function incrementCompaction(state, thresholds) {
+    const newCount = state.compaction_count + 1;
+    const thresholdIndex = Math.min(newCount, thresholds.length - 1);
+    return {
+        ...state,
+        compaction_count: newCount,
+        current_threshold: thresholds[thresholdIndex],
+    };
+}
+export function resetForNewSession(state, sessionId, thresholds) {
+    // Archive current session if it has data
+    const history = [...state.session_history];
+    if (state.session_id) {
+        const currentEntry = {
+            session_id: state.session_id,
+            started: state.session_history.find(s => s.session_id === state.session_id)?.started ?? state.last_event_time,
+            ended: Date.now(),
+            compaction_count: state.compaction_count,
+            snapshots_taken: 0, // Updated elsewhere
+        };
+        history.unshift(currentEntry);
+        if (history.length > MAX_SESSION_HISTORY) {
+            history.length = MAX_SESSION_HISTORY;
+        }
+    }
+    return {
+        ...state,
+        session_id: sessionId,
+        compaction_count: 0,
+        current_threshold: thresholds[0],
+        last_event_time: Date.now(),
+        session_history: history,
+    };
+}
+export function updateSnapshotTime(state) {
+    return {
+        ...state,
+        last_snapshot_time: Date.now(),
+        last_event_time: Date.now(),
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/threshold/state.js.map

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

package/dist/threshold/time-based.d.ts

@@ -0,0 +1,13 @@
+import type { BookmarkState } from '../types.js';
+export interface TimeCheckResult {
+    shouldSnapshot: boolean;
+    elapsedMinutes: number;
+    intervalMinutes: number;
+    reason?: string;
+}
+/**
+ * Check if the time-based snapshot interval has elapsed.
+ * Piggybacks on UserPromptSubmit events — no timer needed.
+ */
+export declare function checkTimeInterval(state: BookmarkState): TimeCheckResult;
+//# sourceMappingURL=time-based.d.ts.map

package/dist/threshold/time-based.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-based.d.ts","sourceRoot":"","sources":["../../src/threshold/time-based.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,CAoBvE"}

package/dist/threshold/time-based.js

@@ -0,0 +1,24 @@
+/**
+ * Check if the time-based snapshot interval has elapsed.
+ * Piggybacks on UserPromptSubmit events — no timer needed.
+ */
+export function checkTimeInterval(state) {
+    const now = Date.now();
+    const intervalMs = state.snapshot_interval_minutes * 60 * 1000;
+    const elapsed = now - (state.last_snapshot_time || now);
+    const elapsedMinutes = Math.floor(elapsed / 60_000);
+    if (state.last_snapshot_time > 0 && elapsed >= intervalMs) {
+        return {
+            shouldSnapshot: true,
+            elapsedMinutes,
+            intervalMinutes: state.snapshot_interval_minutes,
+            reason: `${elapsedMinutes}min since last snapshot (interval: ${state.snapshot_interval_minutes}min)`,
+        };
+    }
+    return {
+        shouldSnapshot: false,
+        elapsedMinutes,
+        intervalMinutes: state.snapshot_interval_minutes,
+    };
+}
+//# sourceMappingURL=time-based.js.map

package/dist/threshold/time-based.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-based.js","sourceRoot":"","sources":["../../src/threshold/time-based.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,UAAU,GAAG,KAAK,CAAC,yBAAyB,GAAG,EAAE,GAAG,IAAI,CAAC;IAC/D,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,IAAI,GAAG,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAEpD,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;QAC1D,OAAO;YACL,cAAc,EAAE,IAAI;YACpB,cAAc;YACd,eAAe,EAAE,KAAK,CAAC,yBAAyB;YAChD,MAAM,EAAE,GAAG,cAAc,sCAAsC,KAAK,CAAC,yBAAyB,MAAM;SACrG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,cAAc,EAAE,KAAK;QACrB,cAAc;QACd,eAAe,EAAE,KAAK,CAAC,yBAAyB;KACjD,CAAC;AACJ,CAAC"}

package/dist/transcript/estimator.d.ts

@@ -0,0 +1,20 @@
+import type { TokenEstimate } from '../types.js';
+export interface EstimateOptions {
+    contextLimit?: number;
+    charsPerToken?: number;
+    startOffset?: number;
+}
+/**
+ * Estimate token usage from a transcript file.
+ * Uses a simple chars/4 heuristic — accurate enough for threshold comparison.
+ */
+export declare function estimateFromTranscript(transcriptPath: string, options?: EstimateOptions): TokenEstimate;
+/**
+ * Quick file-size-based estimation without parsing.
+ * Much faster for threshold checks — reads only file metadata.
+ */
+export declare function quickEstimate(transcriptPath: string, contextLimit?: number, charsPerToken?: number): {
+    estimatedTokens: number;
+    remainingPct: number;
+};
+//# sourceMappingURL=estimator.d.ts.map

package/dist/transcript/estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimator.d.ts","sourceRoot":"","sources":["../../src/transcript/estimator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAMlE,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,aAAa,CA2Df;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,MAAM,EACtB,YAAY,SAAwB,EACpC,aAAa,SAAkB,GAC9B;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAiBnD"}

package/dist/transcript/estimator.js

@@ -0,0 +1,95 @@
+import { existsSync, statSync } from 'node:fs';
+import { parseTranscript } from './parser.js';
+const DEFAULT_CONTEXT_LIMIT = 200_000;
+const CHARS_PER_TOKEN = 4;
+/**
+ * Estimate token usage from a transcript file.
+ * Uses a simple chars/4 heuristic — accurate enough for threshold comparison.
+ */
+export function estimateFromTranscript(transcriptPath, options) {
+    const contextLimit = options?.contextLimit ?? DEFAULT_CONTEXT_LIMIT;
+    const charsPerToken = options?.charsPerToken ?? CHARS_PER_TOKEN;
+    if (!existsSync(transcriptPath)) {
+        return emptyEstimate(contextLimit);
+    }
+    const { entries } = parseTranscript(transcriptPath, {
+        startOffset: options?.startOffset,
+    });
+    let userChars = 0;
+    let assistantChars = 0;
+    let toolChars = 0;
+    let systemChars = 0;
+    for (const entry of entries) {
+        const text = typeof entry.content === 'string' ? entry.content : '';
+        const len = text.length;
+        switch (entry.type) {
+            case 'user':
+                userChars += len;
+                break;
+            case 'assistant':
+                assistantChars += len;
+                break;
+            case 'tool_use':
+            case 'tool_result':
+                toolChars += len;
+                break;
+            case 'system':
+                systemChars += len;
+                break;
+        }
+    }
+    const totalChars = userChars + assistantChars + toolChars + systemChars;
+    const totalTokens = Math.ceil(totalChars / charsPerToken);
+    const userTokens = Math.ceil(userChars / charsPerToken);
+    const assistantTokens = Math.ceil(assistantChars / charsPerToken);
+    const toolTokens = Math.ceil(toolChars / charsPerToken);
+    const systemTokens = Math.ceil(systemChars / charsPerToken);
+    const remainingTokens = Math.max(0, contextLimit - totalTokens);
+    const remainingPct = contextLimit > 0 ? remainingTokens / contextLimit : 1;
+    return {
+        total_tokens: totalTokens,
+        message_count: entries.length,
+        user_tokens: userTokens,
+        assistant_tokens: assistantTokens,
+        tool_tokens: toolTokens,
+        system_tokens: systemTokens,
+        context_limit: contextLimit,
+        remaining_pct: Math.round(remainingPct * 100) / 100,
+        remaining_tokens: remainingTokens,
+    };
+}
+/**
+ * Quick file-size-based estimation without parsing.
+ * Much faster for threshold checks — reads only file metadata.
+ */
+export function quickEstimate(transcriptPath, contextLimit = DEFAULT_CONTEXT_LIMIT, charsPerToken = CHARS_PER_TOKEN) {
+    if (!existsSync(transcriptPath)) {
+        return { estimatedTokens: 0, remainingPct: 1 };
+    }
+    try {
+        const stat = statSync(transcriptPath);
+        // File size in bytes ≈ chars for ASCII-heavy content
+        // JSON overhead adds ~30%, so adjust
+        const estimatedContentChars = stat.size * 0.7;
+        const estimatedTokens = Math.ceil(estimatedContentChars / charsPerToken);
+        const remainingPct = Math.max(0, Math.round((1 - estimatedTokens / contextLimit) * 100) / 100);
+        return { estimatedTokens, remainingPct };
+    }
+    catch {
+        return { estimatedTokens: 0, remainingPct: 1 };
+    }
+}
+function emptyEstimate(contextLimit) {
+    return {
+        total_tokens: 0,
+        message_count: 0,
+        user_tokens: 0,
+        assistant_tokens: 0,
+        tool_tokens: 0,
+        system_tokens: 0,
+        context_limit: contextLimit,
+        remaining_pct: 1,
+        remaining_tokens: contextLimit,
+    };
+}
+//# sourceMappingURL=estimator.js.map

package/dist/transcript/estimator.js.map

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

package/dist/transcript/extractor.d.ts

@@ -0,0 +1,7 @@
+import type { TranscriptEntry, ExtractionResult } from '../types.js';
+/**
+ * Extract structured context from transcript entries using pattern matching.
+ * Zero LLM calls — pure heuristic extraction.
+ */
+export declare function extractFromEntries(entries: TranscriptEntry[]): ExtractionResult;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/transcript/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/transcript/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAA+D,MAAM,aAAa,CAAC;AA+BlI;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,gBAAgB,CAkB/E"}