@tyroneross/bookmark 0.1.0

package/dist/restore/index.js

@@ -0,0 +1,94 @@
+import { existsSync } from 'node:fs';
+import { readLatestMd, loadLatestSnapshot, getSnapshotCount } from '../snapshot/storage.js';
+import { loadState, saveState, resetForNewSession, incrementCompaction } from '../threshold/state.js';
+import { loadConfig, getStoragePath } from '../config.js';
+/**
+ * Generate restoration context for a SessionStart hook.
+ * Returns a HookOutput with systemMessage containing the LATEST.md content.
+ */
+export function restoreContext(options) {
+    const config = loadConfig(options.cwd);
+    const storagePath = getStoragePath(options.cwd, config);
+    const state = loadState(storagePath);
+    // Handle session state transitions
+    handleSessionTransition(storagePath, state, options, config.thresholds);
+    // Check if restoration is needed
+    if (!config.restoreOnSessionStart) {
+        return {};
+    }
+    // On resume, context is likely intact — skip restoration
+    if (options.source === 'resume') {
+        return {};
+    }
+    // Check for existing snapshots
+    const snapshotCount = getSnapshotCount(storagePath);
+    if (snapshotCount === 0) {
+        // First run — tell Claude that bookmark is active
+        return {
+            systemMessage: '[Bookmark: Active — no snapshots yet. Snapshots will be captured automatically ' +
+                'before compaction, on 20-minute intervals, and at session end.]\n\n' +
+                'Briefly let the user know that Bookmark is active and will start capturing context snapshots automatically.',
+        };
+    }
+    // Read LATEST.md
+    const latestMd = readLatestMd(storagePath);
+    if (!latestMd) {
+        return {};
+    }
+    if (options.format === 'json') {
+        const snapshot = loadLatestSnapshot(storagePath);
+        return {
+            systemMessage: JSON.stringify(snapshot, null, 2),
+        };
+    }
+    if (options.format === 'markdown') {
+        return {
+            systemMessage: latestMd,
+        };
+    }
+    // Default: system_message format
+    const systemMessage = buildRestorationMessage(latestMd, snapshotCount);
+    return { systemMessage };
+}
+function buildRestorationMessage(latestMd, snapshotCount) {
+    const lines = [];
+    lines.push('[Bookmark: Context recovered from previous session]');
+    lines.push('');
+    lines.push('Briefly notify the user that their prior session context has been recovered by Bookmark.');
+    lines.push('');
+    lines.push('## Prior Session Context (Bookmark)');
+    lines.push('');
+    lines.push(latestMd);
+    lines.push('');
+    if (snapshotCount > 1) {
+        lines.push(`> ${snapshotCount} snapshots available. Use \`/bookmark:list\` for history or \`/bookmark:restore\` for a specific snapshot.`);
+    }
+    return lines.join('\n');
+}
+function handleSessionTransition(storagePath, state, options, thresholds) {
+    const source = options.source ?? 'startup';
+    const sessionId = options.sessionId ?? `session_${Date.now()}`;
+    let updatedState;
+    switch (source) {
+        case 'startup':
+        case 'clear':
+            // New session — reset compaction count
+            updatedState = resetForNewSession(state, sessionId, thresholds);
+            break;
+        case 'compact':
+            // After compaction — increment compaction count
+            updatedState = incrementCompaction(state, thresholds);
+            updatedState.session_id = sessionId;
+            break;
+        case 'resume':
+            // Resuming — keep state, just update session ID if different
+            updatedState = { ...state, session_id: sessionId, last_event_time: Date.now() };
+            break;
+        default:
+            updatedState = state;
+    }
+    if (!existsSync(storagePath))
+        return;
+    saveState(storagePath, updatedState);
+}
+//# sourceMappingURL=index.js.map

package/dist/restore/index.js.map

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

package/dist/setup/auto-setup.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Check if bookmark hooks are already configured in a project.
+ */
+export declare function isProjectConfigured(cwd: string): boolean;
+/**
+ * Set up bookmark in a project directory.
+ * Creates storage dirs, configures hooks, injects gitignore and CLAUDE.md.
+ * Returns list of steps completed. Silent (no console output) — caller decides output.
+ */
+export declare function setupProject(cwd: string): string[];
+/**
+ * Auto-bootstrap: silently configure hooks if bookmark CLI runs in an unconfigured project.
+ * Called at the top of CLI commands. No-op if already configured.
+ */
+export declare function ensureProjectBootstrapped(cwd: string): void;
+//# sourceMappingURL=auto-setup.d.ts.map

package/dist/setup/auto-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-setup.d.ts","sourceRoot":"","sources":["../../src/setup/auto-setup.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASxD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAgClD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAW3D"}

package/dist/setup/auto-setup.js

@@ -0,0 +1,192 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { configureHooks } from './configure-hooks.js';
+const GREEN = '\x1b[32m';
+const CYAN = '\x1b[36m';
+const DIM = '\x1b[2m';
+const RESET = '\x1b[0m';
+/**
+ * Find the project root — npm sets INIT_CWD to the original working directory.
+ */
+function findProjectRoot() {
+    if (process.env.INIT_CWD) {
+        return process.env.INIT_CWD;
+    }
+    return process.cwd();
+}
+// ─── Core Setup (reusable) ───
+/**
+ * Check if bookmark hooks are already configured in a project.
+ */
+export function isProjectConfigured(cwd) {
+    const settingsPath = join(cwd, '.claude', 'settings.json');
+    if (!existsSync(settingsPath))
+        return false;
+    try {
+        const content = readFileSync(settingsPath, 'utf-8');
+        return content.includes('@tyroneross/bookmark');
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Set up bookmark in a project directory.
+ * Creates storage dirs, configures hooks, injects gitignore and CLAUDE.md.
+ * Returns list of steps completed. Silent (no console output) — caller decides output.
+ */
+export function setupProject(cwd) {
+    const steps = [];
+    // 1. Ensure storage directories
+    const bookmarkPath = join(cwd, '.claude', 'bookmarks');
+    mkdirSync(join(bookmarkPath, 'snapshots'), { recursive: true });
+    mkdirSync(join(bookmarkPath, 'archive'), { recursive: true });
+    steps.push('Created .claude/bookmarks/ directories');
+    // 2. Configure hooks in settings.json
+    try {
+        configureHooks(cwd);
+        steps.push('Configured 4 hooks (PreCompact, SessionStart, UserPromptSubmit, Stop)');
+    }
+    catch { /* silently skip */ }
+    // 3. Add .claude/bookmarks/ to .gitignore
+    try {
+        const added = injectGitignore(cwd);
+        if (added) {
+            steps.push('Added .claude/bookmarks/ to .gitignore');
+        }
+    }
+    catch { /* silently skip */ }
+    // 4. Inject CLAUDE.md section
+    try {
+        const updated = injectClaudeMd(cwd);
+        if (updated) {
+            steps.push('Updated .claude/CLAUDE.md with bookmark docs');
+        }
+    }
+    catch { /* silently skip */ }
+    return steps;
+}
+/**
+ * Auto-bootstrap: silently configure hooks if bookmark CLI runs in an unconfigured project.
+ * Called at the top of CLI commands. No-op if already configured.
+ */
+export function ensureProjectBootstrapped(cwd) {
+    if (isProjectConfigured(cwd))
+        return;
+    // Skip if no package.json (not a real project)
+    if (!existsSync(join(cwd, 'package.json')))
+        return;
+    try {
+        setupProject(cwd);
+    }
+    catch {
+        // Silent — don't break the command
+    }
+}
+// ─── Postinstall Entry Point ───
+/**
+ * Auto-setup runs on npm postinstall.
+ * Sets up hooks, CLAUDE.md injection, and storage directories.
+ * Shows visible output so users know setup succeeded.
+ */
+function autoSetup() {
+    // Skip in CI or when disabled
+    if (process.env.CI || process.env.BOOKMARK_SKIP_SETUP === 'true') {
+        return;
+    }
+    const projectRoot = findProjectRoot();
+    const isGlobal = process.env.npm_config_global === 'true';
+    const hasProject = projectRoot !== '/' && existsSync(join(projectRoot, 'package.json'));
+    // Global install with no project context
+    if (isGlobal && !hasProject) {
+        console.log(`\n  ${GREEN}Bookmark${RESET} installed globally.`);
+        console.log(`  Hooks will auto-configure when you use ${CYAN}/bookmark:activate${RESET} in a Claude Code session.\n`);
+        return;
+    }
+    // No project found
+    if (!hasProject) {
+        return;
+    }
+    // Skip if this is our own package (development mode)
+    try {
+        const pkg = JSON.parse(readFileSync(join(projectRoot, 'package.json'), 'utf-8'));
+        if (pkg.name === '@tyroneross/bookmark')
+            return;
+    }
+    catch { /* ignore */ }
+    // Global install FROM a project directory — configure that project
+    // Local install — configure the project
+    console.log(`\n  ${GREEN}Bookmark${RESET} — Setting up context snapshots\n`);
+    try {
+        const steps = setupProject(projectRoot);
+        for (const step of steps) {
+            console.log(`  ${GREEN}+${RESET} ${step}`);
+        }
+        console.log();
+        console.log(`  ${GREEN}Ready.${RESET} Context snapshots are now active.`);
+        console.log();
+        console.log(`  ${DIM}How it works:${RESET}`);
+        console.log(`  ${DIM}  - Snapshots captured automatically before compaction and on intervals${RESET}`);
+        console.log(`  ${DIM}  - Context restored when you start a new session${RESET}`);
+        console.log(`  ${DIM}  - Use${RESET} ${CYAN}/bookmark:snapshot${RESET} ${DIM}for manual snapshots${RESET}`);
+        console.log();
+    }
+    catch (error) {
+        // Don't fail npm install
+        console.warn(`  Setup skipped: ${error.message}\n`);
+    }
+}
+// ─── Inject Helpers ───
+function injectGitignore(cwd) {
+    const gitignorePath = join(cwd, '.gitignore');
+    const entry = '.claude/bookmarks/';
+    let content = '';
+    if (existsSync(gitignorePath)) {
+        content = readFileSync(gitignorePath, 'utf-8');
+        if (content.includes(entry))
+            return false;
+        if (!content.endsWith('\n'))
+            content += '\n';
+    }
+    content += `\n# Bookmark snapshot data\n${entry}\n`;
+    writeFileSync(gitignorePath, content, 'utf-8');
+    return true;
+}
+function injectClaudeMd(cwd) {
+    const claudeMdPath = join(cwd, '.claude', 'CLAUDE.md');
+    const marker = '## Bookmark — Context Snapshots';
+    let content = '';
+    if (existsSync(claudeMdPath)) {
+        content = readFileSync(claudeMdPath, 'utf-8');
+        // Don't duplicate
+        if (content.includes(marker))
+            return false;
+        content += '\n\n';
+    }
+    else {
+        // Ensure .claude dir exists
+        mkdirSync(join(cwd, '.claude'), { recursive: true });
+    }
+    content += `${marker}
+
+This project uses @tyroneross/bookmark for context snapshots.
+
+**Automatic behavior:**
+- Snapshots captured before compaction and on session end
+- Context restored automatically on session start
+- Adaptive thresholds increase snapshot frequency with compaction count
+- Time-based snapshots every 20 minutes (configurable)
+
+**Commands:**
+- \`/bookmark:snapshot\` — Manual snapshot
+- \`/bookmark:restore\` — Restore from a snapshot
+- \`/bookmark:status\` — Show snapshot stats
+- \`/bookmark:list\` — List all snapshots
+
+The system operates with zero context window tax — all processing runs externally.
+`;
+    writeFileSync(claudeMdPath, content, 'utf-8');
+    return true;
+}
+autoSetup();
+//# sourceMappingURL=auto-setup.js.map

package/dist/setup/auto-setup.js.map

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

package/dist/setup/configure-hooks.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Configure hooks in the project's .claude/settings.json.
+ * Adds bookmark hooks without duplicating or overwriting existing hooks.
+ */
+export declare function configureHooks(cwd: string): void;
+/**
+ * Remove bookmark hooks from settings.json.
+ */
+export declare function removeHooks(cwd: string): void;
+//# sourceMappingURL=configure-hooks.d.ts.map

package/dist/setup/configure-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-hooks.d.ts","sourceRoot":"","sources":["../../src/setup/configure-hooks.ts"],"names":[],"mappings":"AA2DA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAqChD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAqB7C"}

package/dist/setup/configure-hooks.js

@@ -0,0 +1,97 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+const BOOKMARK_HOOKS = {
+    PreCompact: {
+        matcher: '',
+        hooks: [{
+                type: 'command',
+                command: 'npx @tyroneross/bookmark snapshot --trigger pre_compact 2>/dev/null || true',
+                timeout: 30000,
+                async: true,
+            }],
+    },
+    SessionStart: {
+        matcher: '',
+        hooks: [{
+                type: 'command',
+                command: 'npx @tyroneross/bookmark restore 2>/dev/null || echo \'{}\'',
+                timeout: 5000,
+            }],
+    },
+    UserPromptSubmit: {
+        matcher: '',
+        hooks: [{
+                type: 'command',
+                command: 'npx @tyroneross/bookmark check 2>/dev/null || true',
+                timeout: 3000,
+                async: true,
+            }],
+    },
+    Stop: {
+        matcher: '',
+        hooks: [{
+                type: 'command',
+                command: 'npx @tyroneross/bookmark snapshot --trigger session_end 2>/dev/null || true',
+                timeout: 15000,
+            }],
+    },
+};
+const BOOKMARK_MARKER = '@tyroneross/bookmark';
+/**
+ * Configure hooks in the project's .claude/settings.json.
+ * Adds bookmark hooks without duplicating or overwriting existing hooks.
+ */
+export function configureHooks(cwd) {
+    const settingsDir = join(cwd, '.claude');
+    const settingsPath = join(settingsDir, 'settings.json');
+    if (!existsSync(settingsDir)) {
+        mkdirSync(settingsDir, { recursive: true });
+    }
+    let settings = {};
+    if (existsSync(settingsPath)) {
+        try {
+            settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        }
+        catch {
+            settings = {};
+        }
+    }
+    if (!settings.hooks) {
+        settings.hooks = {};
+    }
+    for (const [event, hookConfig] of Object.entries(BOOKMARK_HOOKS)) {
+        if (!settings.hooks[event]) {
+            settings.hooks[event] = [];
+        }
+        // Check if bookmark hook already exists
+        const exists = settings.hooks[event].some(h => h.hooks.some(hh => hh.command?.includes(BOOKMARK_MARKER)));
+        if (!exists) {
+            settings.hooks[event].push(hookConfig);
+        }
+    }
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+}
+/**
+ * Remove bookmark hooks from settings.json.
+ */
+export function removeHooks(cwd) {
+    const settingsPath = join(cwd, '.claude', 'settings.json');
+    if (!existsSync(settingsPath))
+        return;
+    try {
+        const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        if (!settings.hooks)
+            return;
+        for (const event of Object.keys(settings.hooks)) {
+            settings.hooks[event] = settings.hooks[event].filter(h => !h.hooks.some(hh => hh.command?.includes(BOOKMARK_MARKER)));
+            if (settings.hooks[event].length === 0) {
+                delete settings.hooks[event];
+            }
+        }
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+    }
+    catch {
+        // Silent
+    }
+}
+//# sourceMappingURL=configure-hooks.js.map

package/dist/setup/configure-hooks.js.map

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

package/dist/snapshot/capture.d.ts

@@ -0,0 +1,21 @@
+import type { Snapshot, SnapshotTrigger } from '../types.js';
+export interface CaptureOptions {
+    trigger: SnapshotTrigger;
+    transcriptPath: string;
+    cwd: string;
+    sessionId?: string;
+    smart?: boolean;
+}
+/**
+ * Full snapshot capture pipeline:
+ * 1. Parse transcript
+ * 2. Estimate token usage
+ * 3. Extract decisions/status/files/errors
+ * 4. Optionally enhance with LLM (--smart)
+ * 5. Build snapshot object
+ * 6. Store snapshot JSON
+ * 7. Generate and write LATEST.md
+ * 8. Update state
+ */
+export declare function captureSnapshot(options: CaptureOptions): Promise<Snapshot>;
+//# sourceMappingURL=capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/snapshot/capture.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyDhF"}

package/dist/snapshot/capture.js

@@ -0,0 +1,134 @@
+import { parseTranscript } from '../transcript/parser.js';
+import { estimateFromTranscript } from '../transcript/estimator.js';
+import { extractFromEntries } from '../transcript/extractor.js';
+import { storeSnapshot, writeLatestMd, loadLatestSnapshot } from './storage.js';
+import { compressToMarkdown } from './compress.js';
+import { loadState, saveState, updateSnapshotTime } from '../threshold/state.js';
+import { loadConfig, getStoragePath } from '../config.js';
+/**
+ * Full snapshot capture pipeline:
+ * 1. Parse transcript
+ * 2. Estimate token usage
+ * 3. Extract decisions/status/files/errors
+ * 4. Optionally enhance with LLM (--smart)
+ * 5. Build snapshot object
+ * 6. Store snapshot JSON
+ * 7. Generate and write LATEST.md
+ * 8. Update state
+ */
+export async function captureSnapshot(options) {
+    const config = loadConfig(options.cwd);
+    const storagePath = getStoragePath(options.cwd, config);
+    const state = loadState(storagePath);
+    // 1. Parse transcript
+    const { entries } = parseTranscript(options.transcriptPath);
+    // 2. Estimate token usage
+    const estimate = estimateFromTranscript(options.transcriptPath, {
+        contextLimit: config.contextLimitTokens,
+        charsPerToken: config.charsPerToken,
+    });
+    // 3. Extract structured content
+    let extraction = extractFromEntries(entries);
+    // 4. Optional LLM enhancement
+    if (options.smart ?? config.smartDefault) {
+        extraction = await enhanceWithLLM(extraction, entries);
+    }
+    // 5. Build snapshot
+    const snapshotId = generateSnapshotId();
+    const priorSnapshot = loadLatestSnapshot(storagePath);
+    const snapshot = {
+        snapshot_id: snapshotId,
+        timestamp: Date.now(),
+        session_id: options.sessionId ?? state.session_id ?? 'unknown',
+        project_path: options.cwd,
+        trigger: options.trigger,
+        compaction_cycle: state.compaction_count,
+        context_remaining_pct: estimate.remaining_pct,
+        token_estimate: estimate.total_tokens,
+        current_status: extraction.current_status,
+        decisions: extraction.decisions,
+        open_items: extraction.open_items,
+        unknowns: extraction.unknowns,
+        files_changed: extraction.files_changed,
+        errors_encountered: extraction.errors_encountered,
+        tools_summary: extraction.tools_summary,
+        prior_snapshot_id: priorSnapshot?.snapshot_id,
+    };
+    // 6. Store snapshot
+    storeSnapshot(storagePath, snapshot);
+    // 7. Generate LATEST.md
+    const markdown = compressToMarkdown(snapshot);
+    writeLatestMd(storagePath, markdown);
+    // 8. Update state
+    const updatedState = updateSnapshotTime(state);
+    saveState(storagePath, updatedState);
+    return snapshot;
+}
+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}`;
+}
+/**
+ * Enhance extraction with Claude Haiku for higher-quality summaries.
+ * Falls back to original extraction if SDK not available or API key missing.
+ */
+async function enhanceWithLLM(extraction, entries) {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey)
+        return extraction;
+    try {
+        // Dynamic import — @anthropic-ai/sdk is an optional dependency
+        const { default: Anthropic } = await import('@anthropic-ai/sdk');
+        const client = new Anthropic({ apiKey });
+        // Build a compressed transcript excerpt (last ~2000 tokens worth)
+        const recentEntries = entries.slice(-50); // Last 50 entries
+        const transcript = recentEntries
+            .filter(e => e.type === 'assistant' || e.type === 'user')
+            .map(e => `[${e.type}]: ${typeof e.content === 'string' ? e.content.slice(0, 200) : ''}`)
+            .join('\n')
+            .slice(-4000);
+        const response = await client.messages.create({
+            model: 'claude-haiku-4-5-20251001',
+            max_tokens: 1000,
+            messages: [{
+                    role: 'user',
+                    content: `Analyze this coding session transcript and extract:
+1. Key decisions made (with brief rationale)
+2. Current status (1-2 sentences)
+3. Open items/TODOs (with priority: high/medium/low)
+4. Unknowns or blockers
+
+Transcript excerpt:
+${transcript}
+
+Respond in JSON format:
+{
+  "current_status": "...",
+  "decisions": [{"description": "...", "rationale": "..."}],
+  "open_items": [{"description": "...", "priority": "high|medium|low"}],
+  "unknowns": ["..."]
+}`,
+                }],
+        });
+        const text = response.content[0]?.type === 'text' ? response.content[0].text : '';
+        const jsonMatch = text.match(/\{[\s\S]*\}/);
+        if (jsonMatch) {
+            const enhanced = JSON.parse(jsonMatch[0]);
+            return {
+                ...extraction,
+                current_status: enhanced.current_status ?? extraction.current_status,
+                decisions: enhanced.decisions?.length ? enhanced.decisions : extraction.decisions,
+                open_items: enhanced.open_items?.length ? enhanced.open_items : extraction.open_items,
+                unknowns: enhanced.unknowns?.length ? enhanced.unknowns : extraction.unknowns,
+            };
+        }
+    }
+    catch {
+        // Fall back silently to pattern-based extraction
+    }
+    return extraction;
+}
+//# sourceMappingURL=capture.js.map

package/dist/snapshot/capture.js.map

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

package/dist/snapshot/compress.d.ts

@@ -0,0 +1,8 @@
+import type { Snapshot } from '../types.js';
+/**
+ * Compress a full snapshot into a concise markdown summary.
+ * Target: <150 lines, <1000 tokens.
+ * This becomes LATEST.md — the hot context tier.
+ */
+export declare function compressToMarkdown(snapshot: Snapshot): string;
+//# sourceMappingURL=compress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../../src/snapshot/compress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA2F7D"}