@vinaes/succ 1.3.19

package/dist/lib/pricing.js

@@ -0,0 +1,258 @@
+/**
+ * Token Pricing for Claude Models
+ *
+ * Provides "Claude equivalent" pricing for token savings comparison.
+ * This allows users to understand the value of saved tokens regardless
+ * of which LLM backend they actually use (Ollama, OpenRouter, Claude CLI).
+ *
+ * Prices are per million tokens.
+ * Source: https://www.anthropic.com/api
+ */
+/**
+ * Pricing rates per million tokens for Claude models
+ */
+export const PRICING = {
+    // --- Claude 4.5 (Current) ---
+    'claude-opus-4-5-20251101': {
+        input: 15.0,
+        output: 75.0,
+        cache_write: 18.75,
+        cache_read: 1.5,
+    },
+    'claude-sonnet-4-5-20251101': {
+        input: 3.0,
+        output: 15.0,
+        cache_write: 3.75,
+        cache_read: 0.3,
+    },
+    // --- Claude 4 ---
+    'claude-opus-4-20250514': {
+        input: 15.0,
+        output: 75.0,
+        cache_write: 18.75,
+        cache_read: 1.5,
+    },
+    'claude-sonnet-4-20250514': {
+        input: 3.0,
+        output: 15.0,
+        cache_write: 3.75,
+        cache_read: 0.3,
+    },
+    // --- Claude 3.5 ---
+    'claude-3-5-sonnet-20241022': {
+        input: 3.0,
+        output: 15.0,
+        cache_write: 3.75,
+        cache_read: 0.3,
+    },
+    'claude-3-5-sonnet-20240620': {
+        input: 3.0,
+        output: 15.0,
+        cache_write: 3.75,
+        cache_read: 0.3,
+    },
+    'claude-3-5-haiku-20241022': {
+        input: 0.8,
+        output: 4.0,
+        cache_write: 1.0,
+        cache_read: 0.08,
+    },
+    // --- Claude 3 ---
+    'claude-3-opus-20240229': {
+        input: 15.0,
+        output: 75.0,
+        cache_write: 18.75,
+        cache_read: 1.5,
+    },
+    'claude-3-sonnet-20240229': {
+        input: 3.0,
+        output: 15.0,
+        cache_write: 3.75,
+        cache_read: 0.3,
+    },
+    'claude-3-haiku-20240307': {
+        input: 0.25,
+        output: 1.25,
+        cache_write: 0.3125,
+        cache_read: 0.025,
+    },
+};
+// Aliases for common model names
+const MODEL_ALIASES = {
+    // Short names
+    opus: 'claude-opus-4-5-20251101',
+    sonnet: 'claude-sonnet-4-5-20251101',
+    haiku: 'claude-3-5-haiku-20241022',
+    // Version shortcuts
+    'opus-4.5': 'claude-opus-4-5-20251101',
+    'sonnet-4.5': 'claude-sonnet-4-5-20251101',
+    'opus-4': 'claude-opus-4-20250514',
+    'sonnet-4': 'claude-sonnet-4-20250514',
+    'sonnet-3.5': 'claude-3-5-sonnet-20241022',
+    'haiku-3.5': 'claude-3-5-haiku-20241022',
+    'haiku-3': 'claude-3-haiku-20240307',
+};
+// Default model for unknown inputs
+const DEFAULT_MODEL = 'claude-sonnet-4-5-20251101';
+/**
+ * Get pricing for a model, with fuzzy matching
+ */
+export function getModelPricing(modelId) {
+    if (!modelId) {
+        return PRICING[DEFAULT_MODEL];
+    }
+    // Direct match
+    if (PRICING[modelId]) {
+        return PRICING[modelId];
+    }
+    // Check aliases
+    const lowerModel = modelId.toLowerCase();
+    if (MODEL_ALIASES[lowerModel]) {
+        return PRICING[MODEL_ALIASES[lowerModel]];
+    }
+    // Fuzzy match by model family
+    if (lowerModel.includes('opus')) {
+        if (lowerModel.includes('4.5') || lowerModel.includes('4-5')) {
+            return PRICING['claude-opus-4-5-20251101'];
+        }
+        if (lowerModel.includes('4')) {
+            return PRICING['claude-opus-4-20250514'];
+        }
+        return PRICING['claude-3-opus-20240229'];
+    }
+    if (lowerModel.includes('sonnet')) {
+        if (lowerModel.includes('4.5') || lowerModel.includes('4-5')) {
+            return PRICING['claude-sonnet-4-5-20251101'];
+        }
+        if (lowerModel.includes('4')) {
+            return PRICING['claude-sonnet-4-20250514'];
+        }
+        return PRICING['claude-3-5-sonnet-20241022'];
+    }
+    if (lowerModel.includes('haiku')) {
+        if (lowerModel.includes('3.5') || lowerModel.includes('3-5')) {
+            return PRICING['claude-3-5-haiku-20241022'];
+        }
+        return PRICING['claude-3-haiku-20240307'];
+    }
+    // Default
+    return PRICING[DEFAULT_MODEL];
+}
+/**
+ * Calculate cost for token usage
+ */
+export function calculateCost(usage, modelId) {
+    const pricing = getModelPricing(modelId);
+    const inputCost = (usage.input_tokens / 1_000_000) * pricing.input;
+    const outputCost = (usage.output_tokens / 1_000_000) * pricing.output;
+    const cacheWriteCost = ((usage.cache_creation_input_tokens || 0) / 1_000_000) * pricing.cache_write;
+    const cacheReadCost = ((usage.cache_read_input_tokens || 0) / 1_000_000) * pricing.cache_read;
+    return {
+        total: inputCost + outputCost + cacheWriteCost + cacheReadCost,
+        input: inputCost,
+        output: outputCost,
+        cache_write: cacheWriteCost,
+        cache_read: cacheReadCost,
+    };
+}
+/**
+ * Estimate cost for saved tokens (tokens not sent to API)
+ * Uses input pricing since saved tokens would have been input tokens
+ */
+export function estimateSavings(savedTokens, modelId) {
+    const pricing = getModelPricing(modelId);
+    return (savedTokens / 1_000_000) * pricing.input;
+}
+/**
+ * Format cost as USD string
+ */
+export function formatCost(cost) {
+    if (cost < 0.01) {
+        return `$${cost.toFixed(4)}`;
+    }
+    if (cost < 1) {
+        return `$${cost.toFixed(3)}`;
+    }
+    return `$${cost.toFixed(2)}`;
+}
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * Get current model from environment variable, Claude Code transcript, or default to sonnet
+ *
+ * Priority:
+ * 1. ANTHROPIC_MODEL env var (explicit override)
+ * 2. Most recent Claude Code session transcript (automatic detection)
+ * 3. Default to 'sonnet'
+ */
+export function getCurrentModel() {
+    // 1. Check env var first (explicit override)
+    if (process.env.ANTHROPIC_MODEL) {
+        return process.env.ANTHROPIC_MODEL;
+    }
+    // 2. Try to detect from Claude Code session transcript
+    try {
+        const detectedModel = detectModelFromClaudeCode();
+        if (detectedModel) {
+            return detectedModel;
+        }
+    }
+    catch {
+        // Ignore errors, fall back to default
+    }
+    // 3. Default
+    return 'sonnet';
+}
+/**
+ * Detect model from Claude Code session transcript
+ * Reads the most recent session in current project and extracts model from assistant messages
+ */
+function detectModelFromClaudeCode() {
+    const claudeDir = path.join(os.homedir(), '.claude');
+    const projectsDir = path.join(claudeDir, 'projects');
+    if (!fs.existsSync(projectsDir)) {
+        return null;
+    }
+    // Get current working directory to find matching project
+    const cwd = process.cwd();
+    const projectDirName = cwd.replace(/[:/\\]/g, '-').replace(/^-/, '');
+    // Find project directory (case-insensitive on Windows)
+    const projectDirs = fs.readdirSync(projectsDir);
+    const matchingDir = projectDirs.find((d) => d.toLowerCase() === projectDirName.toLowerCase());
+    if (!matchingDir) {
+        return null;
+    }
+    const projectPath = path.join(projectsDir, matchingDir);
+    // Find most recent .jsonl file (session transcript)
+    const files = fs.readdirSync(projectPath).filter((f) => f.endsWith('.jsonl'));
+    if (files.length === 0) {
+        return null;
+    }
+    // Sort by mtime, get most recent
+    const sortedFiles = files
+        .map((f) => ({
+        name: f,
+        mtime: fs.statSync(path.join(projectPath, f)).mtime.getTime(),
+    }))
+        .sort((a, b) => b.mtime - a.mtime);
+    const latestSession = path.join(projectPath, sortedFiles[0].name);
+    // Read last few KB of file to find model (reading from end is faster for large files)
+    const stats = fs.statSync(latestSession);
+    const readSize = Math.min(stats.size, 50000); // Last 50KB should be enough
+    const fd = fs.openSync(latestSession, 'r');
+    const buffer = Buffer.alloc(readSize);
+    fs.readSync(fd, buffer, 0, readSize, Math.max(0, stats.size - readSize));
+    fs.closeSync(fd);
+    const content = buffer.toString('utf-8');
+    // Find last occurrence of "model":"..." in assistant messages
+    const modelMatches = content.match(/"model"\s*:\s*"([^"]+)"/g);
+    if (!modelMatches || modelMatches.length === 0) {
+        return null;
+    }
+    // Get the last match and extract model name
+    const lastMatch = modelMatches[modelMatches.length - 1];
+    const modelName = lastMatch.match(/"model"\s*:\s*"([^"]+)"/)?.[1];
+    return modelName || null;
+}
+//# sourceMappingURL=pricing.js.map

package/dist/lib/pricing.js.map

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

package/dist/lib/process-registry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Process Registry — tracks all spawned child processes.
+ *
+ * Safety net: on process exit, kills everything we spawned.
+ * Works cross-platform (Node's process.kill handles OS differences).
+ *
+ * Usage:
+ *   processRegistry.register(proc.pid, 'claude-cli');
+ *   proc.on('close', () => processRegistry.unregister(proc.pid));
+ */
+declare class ProcessRegistry {
+    private pids;
+    private cleanupRegistered;
+    register(pid: number, label: string): void;
+    unregister(pid: number): void;
+    /** Kill all tracked processes. Called on exit. */
+    killAll(): void;
+    /** Get count of tracked processes */
+    get size(): number;
+    /** Get snapshot for logging/debugging */
+    getActive(): Array<{
+        pid: number;
+        label: string;
+        ageMs: number;
+    }>;
+    private ensureCleanup;
+}
+export declare const processRegistry: ProcessRegistry;
+export {};
+//# sourceMappingURL=process-registry.d.ts.map

package/dist/lib/process-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-registry.d.ts","sourceRoot":"","sources":["../../src/lib/process-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,cAAM,eAAe;IACnB,OAAO,CAAC,IAAI,CAAqC;IACjD,OAAO,CAAC,iBAAiB,CAAS;IAElC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM7B,kDAAkD;IAClD,OAAO,IAAI,IAAI;IA8Bf,qCAAqC;IACrC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yCAAyC;IACzC,SAAS,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IASjE,OAAO,CAAC,aAAa;CAuBtB;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/lib/process-registry.js

@@ -0,0 +1,92 @@
+/**
+ * Process Registry — tracks all spawned child processes.
+ *
+ * Safety net: on process exit, kills everything we spawned.
+ * Works cross-platform (Node's process.kill handles OS differences).
+ *
+ * Usage:
+ *   processRegistry.register(proc.pid, 'claude-cli');
+ *   proc.on('close', () => processRegistry.unregister(proc.pid));
+ */
+import { logInfo, logWarn } from './fault-logger.js';
+class ProcessRegistry {
+    pids = new Map();
+    cleanupRegistered = false;
+    register(pid, label) {
+        this.pids.set(pid, { label, spawnedAt: Date.now() });
+        this.ensureCleanup();
+        logInfo('process-registry', `Registered pid=${pid} (${label})`);
+    }
+    unregister(pid) {
+        if (this.pids.delete(pid)) {
+            logInfo('process-registry', `Unregistered pid=${pid}`);
+        }
+    }
+    /** Kill all tracked processes. Called on exit. */
+    killAll() {
+        if (this.pids.size === 0)
+            return;
+        logInfo('process-registry', `Killing ${this.pids.size} tracked process(es)`);
+        for (const [pid, info] of this.pids) {
+            try {
+                process.kill(pid, 'SIGTERM');
+                logInfo('process-registry', `Sent SIGTERM to pid=${pid} (${info.label})`);
+            }
+            catch {
+                // ESRCH = process already dead — that's fine
+            }
+        }
+        // Force-kill stragglers after 2s
+        const remaining = new Map(this.pids);
+        this.pids.clear();
+        setTimeout(() => {
+            for (const [pid, info] of remaining) {
+                try {
+                    process.kill(pid, 0); // Test if alive
+                    process.kill(pid, 'SIGKILL');
+                    logWarn('process-registry', `Force-killed pid=${pid} (${info.label})`);
+                }
+                catch {
+                    // Already dead
+                }
+            }
+        }, 2000).unref();
+    }
+    /** Get count of tracked processes */
+    get size() {
+        return this.pids.size;
+    }
+    /** Get snapshot for logging/debugging */
+    getActive() {
+        const now = Date.now();
+        return Array.from(this.pids.entries()).map(([pid, info]) => ({
+            pid,
+            label: info.label,
+            ageMs: now - info.spawnedAt,
+        }));
+    }
+    ensureCleanup() {
+        if (this.cleanupRegistered)
+            return;
+        this.cleanupRegistered = true;
+        const cleanup = () => this.killAll();
+        // 'exit' is sync-only, last resort
+        process.on('exit', () => {
+            // Can't do async here, just try SIGTERM
+            for (const [pid] of this.pids) {
+                try {
+                    process.kill(pid, 'SIGTERM');
+                }
+                catch {
+                    /* noop */
+                }
+            }
+        });
+        // These allow async cleanup
+        process.on('SIGTERM', cleanup);
+        process.on('SIGINT', cleanup);
+        process.on('beforeExit', cleanup);
+    }
+}
+export const processRegistry = new ProcessRegistry();
+//# sourceMappingURL=process-registry.js.map

package/dist/lib/process-registry.js.map

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

package/dist/lib/progress-log.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Progress Log (DB-based)
+ *
+ * Stores session outcomes and knowledge growth in the learning_deltas table.
+ * Replaces the previous file-based progress.log approach.
+ */
+import type { LearningDelta } from './learning-delta.js';
+/**
+ * Row shape from learning_deltas table
+ */
+export interface LearningDeltaRow {
+    id: number;
+    timestamp: string;
+    source: string;
+    memories_before: number;
+    memories_after: number;
+    new_memories: number;
+    types_added: string | null;
+    avg_quality: number | null;
+    created_at: string;
+}
+/**
+ * Append a learning delta entry to the DB
+ */
+export declare function appendProgressEntry(delta: LearningDelta): Promise<void>;
+/**
+ * Append a raw text entry to the progress log (for non-delta events)
+ */
+export declare function appendRawEntry(text: string): Promise<void>;
+/**
+ * Read progress log entries, most recent first
+ */
+export declare function readProgressLog(options?: {
+    limit?: number;
+    since?: string;
+}): Promise<string[]>;
+/**
+ * Get raw progress entries as structured data
+ */
+export declare function getProgressEntries(options?: {
+    limit?: number;
+    since?: string;
+}): Promise<LearningDeltaRow[]>;
+//# sourceMappingURL=progress-log.d.ts.map

package/dist/lib/progress-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-log.d.ts","sourceRoot":"","sources":["../../src/lib/progress-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAU7E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GACL,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GACL,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAO7B"}

package/dist/lib/progress-log.js

@@ -0,0 +1,58 @@
+/**
+ * Progress Log (DB-based)
+ *
+ * Stores session outcomes and knowledge growth in the learning_deltas table.
+ * Replaces the previous file-based progress.log approach.
+ */
+import { appendLearningDelta, appendRawLearningDelta, getLearningDeltas } from './storage/index.js';
+/**
+ * Append a learning delta entry to the DB
+ */
+export async function appendProgressEntry(delta) {
+    await appendLearningDelta({
+        timestamp: delta.timestamp,
+        source: delta.source,
+        memoriesBefore: delta.memoriesBefore,
+        memoriesAfter: delta.memoriesAfter,
+        newMemories: delta.newMemories,
+        typesAdded: delta.typesAdded,
+        avgQualityOfNew: delta.avgQualityOfNew ?? null,
+    });
+}
+/**
+ * Append a raw text entry to the progress log (for non-delta events)
+ */
+export async function appendRawEntry(text) {
+    await appendRawLearningDelta(text);
+}
+/**
+ * Read progress log entries, most recent first
+ */
+export async function readProgressLog(options = {}) {
+    const rows = await getLearningDeltas({
+        limit: options.limit,
+        since: options.since,
+    });
+    return rows.map((row) => formatRow(row));
+}
+/**
+ * Get raw progress entries as structured data
+ */
+export async function getProgressEntries(options = {}) {
+    const rows = await getLearningDeltas({
+        limit: options.limit,
+        since: options.since,
+    });
+    return rows;
+}
+/**
+ * Format a DB row as a human-readable log line
+ */
+function formatRow(row) {
+    const types = row.types_added ? JSON.parse(row.types_added) : {};
+    const topicStr = Object.entries(types)
+        .map(([type, count]) => `${type}:${count}`)
+        .join(', ');
+    return `[${row.timestamp}] ${row.source} | +${row.new_memories} facts (${row.memories_before} → ${row.memories_after})${topicStr ? ` | types: ${topicStr}` : ''}`;
+}
+//# sourceMappingURL=progress-log.js.map

package/dist/lib/progress-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-log.js","sourceRoot":"","sources":["../../src/lib/progress-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAkBpG;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAoB;IAC5D,MAAM,mBAAmB,CAAC;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;KAC/C,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAGI,EAAE;IAEN,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAGI,EAAE;IAEN,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,OAAO,IAA0B,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,GAAqB;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;SAC1C,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,IAAI,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,MAAM,OAAO,GAAG,CAAC,YAAY,WAAW,GAAG,CAAC,eAAe,MAAM,GAAG,CAAC,cAAc,IAAI,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACpK,CAAC"}

package/dist/lib/public-api.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Stable public API for succ integrations (plugins, extensions).
+ *
+ * Import via: import { ... } from 'succ/api'
+ *
+ * This barrel export defines the supported contract.
+ * Internal module paths (dist/lib/storage/...) are NOT part of the public API.
+ */
+export { initStorageDispatcher, closeStorageDispatcher } from './storage/dispatcher.js';
+export { hybridSearchDocs, hybridSearchCode, hybridSearchMemories, hybridSearchGlobalMemories, } from './storage/index.js';
+export { searchDocuments } from './storage/index.js';
+export { saveMemory, saveMemoriesBatch, searchMemories, getRecentMemories, getMemoryById, deleteMemory, deleteMemoriesOlderThan, deleteMemoriesByTag, deleteMemoriesByIds, findSimilarMemory, searchMemoriesAsOf, getMemoryStats, incrementMemoryAccess, getAllMemoriesForRetention, } from './storage/index.js';
+export { saveGlobalMemory, searchGlobalMemories, getRecentGlobalMemories, deleteGlobalMemory, getGlobalMemoryStats, findSimilarGlobalMemory, } from './storage/index.js';
+export { createMemoryLink, deleteMemoryLink, getMemoryLinks, getMemoryWithLinks, findConnectedMemories, findRelatedMemoriesForLinking, createAutoLinks, autoLinkSimilarMemories, getGraphStats, updateMemoryLink, upsertCentralityScore, getCentralityScores, } from './storage/index.js';
+export { upsertDocument, upsertDocumentsBatch, upsertDocumentsBatchWithHashes, deleteDocumentsByPath, getStats, getFileHash, setFileHash, deleteFileHash, getAllFileHashes, getStaleFiles, } from './storage/index.js';
+export type { IndexFreshnessResult } from './storage/index.js';
+export { getEmbedding, getEmbeddings, cosineSimilarity, cleanupEmbeddings, getEmbeddingInfo, } from './embeddings.js';
+export type { EmbeddingResponse } from './embeddings.js';
+export { getConfig, getProjectRoot, getSuccDir, isProjectInitialized, isGlobalOnlyMode, invalidateConfigCache, setConfigOverride, } from './config.js';
+export type { SuccConfig } from './config.js';
+export { invalidateBM25Index, invalidateCodeBm25Index, invalidateDocsBm25Index, invalidateMemoriesBm25Index, updateCodeBm25Index, updateMemoriesBm25Index, } from './storage/index.js';
+export { getTokenStatsAggregated, getTokenStatsSummary } from './storage/index.js';
+export { recordWebSearch, getWebSearchHistory, getWebSearchSummary } from './storage/index.js';
+export { callOpenRouterSearch } from './llm.js';
+export type { ChatMessage, OpenRouterSearchResponse } from './llm.js';
+export { calculateAIReadinessScore, formatAIReadinessScore } from './ai-readiness.js';
+export { analyzeRetention } from './retention.js';
+export { createCheckpoint, listCheckpoints } from './checkpoint.js';
+export { enrichExistingLinks } from './graph/llm-relations.js';
+export { createProximityLinks } from './graph/contextual-proximity.js';
+export { detectCommunities } from './graph/community-detection.js';
+export { updateCentralityCache } from './graph/centrality.js';
+export { exportGraphSilent } from './graph-export.js';
+export { generatePrd } from './prd/generate.js';
+export type { GenerateResult } from './prd/generate.js';
+export { loadPrd, loadTasks, listPrds, findLatestPrd } from './prd/state.js';
+export { runPrd } from './prd/runner.js';
+export type { RunOptions, RunResult } from './prd/runner.js';
+export { exportPrdToObsidian, exportAllPrds } from './prd/export.js';
+export type { Prd, Task, PrdStatus, PrdIndexEntry } from './prd/types.js';
+export { getConfigDisplay, formatConfigDisplay } from './config.js';
+export { generateSessionId, ensureDebugsDir, saveSession, loadSession, deleteSession, listSessions, findActiveSession, appendSessionLog, loadSessionLog, } from './debug/state.js';
+export { detectLanguage, generateLogStatement } from './debug/types.js';
+export type { DebugSession, DebugSessionStatus, DebugLanguage, Hypothesis, HypothesisResult, InstrumentedFile, DebugSessionIndexEntry, } from './debug/types.js';
+export { analyzeFile } from '../commands/analyze-recursive.js';
+export { indexCodeFile } from '../commands/index-code.js';
+export type { IndexCodeFileResult } from '../commands/index-code.js';
+export { reindexFiles } from '../commands/reindex.js';
+export type { ReindexResult } from '../commands/reindex.js';
+export { extractSymbolsFromFile } from './tree-sitter/public.js';
+export type { ExtractSymbolsOptions, ExtractSymbolsResult } from './tree-sitter/public.js';
+export type { SymbolInfo, SymbolType } from './tree-sitter/types.js';
+export { SuccError, ConfigError, StorageError, ValidationError, NetworkError, NotFoundError, DependencyError, isSuccError, } from './errors.js';
+export type { MemoryBatchInput, MemoryBatchResult } from './storage/index.js';
+export type { LinkRelation, MemoryType, StorageConfig, SqliteConfig, PostgresConfig, QdrantConfig, } from './storage/types.js';
+//# sourceMappingURL=public-api.d.ts.map

package/dist/lib/public-api.d.ts.map

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

package/dist/lib/public-api.js

@@ -0,0 +1,63 @@
+/**
+ * Stable public API for succ integrations (plugins, extensions).
+ *
+ * Import via: import { ... } from 'succ/api'
+ *
+ * This barrel export defines the supported contract.
+ * Internal module paths (dist/lib/storage/...) are NOT part of the public API.
+ */
+// --- Storage: init / teardown ---
+export { initStorageDispatcher, closeStorageDispatcher } from './storage/dispatcher.js';
+// --- Search ---
+export { hybridSearchDocs, hybridSearchCode, hybridSearchMemories, hybridSearchGlobalMemories, } from './storage/index.js';
+export { searchDocuments } from './storage/index.js';
+// --- Memories ---
+export { saveMemory, saveMemoriesBatch, searchMemories, getRecentMemories, getMemoryById, deleteMemory, deleteMemoriesOlderThan, deleteMemoriesByTag, deleteMemoriesByIds, findSimilarMemory, searchMemoriesAsOf, getMemoryStats, incrementMemoryAccess, getAllMemoriesForRetention, } from './storage/index.js';
+// --- Global memories ---
+export { saveGlobalMemory, searchGlobalMemories, getRecentGlobalMemories, deleteGlobalMemory, getGlobalMemoryStats, findSimilarGlobalMemory, } from './storage/index.js';
+// --- Knowledge graph ---
+export { createMemoryLink, deleteMemoryLink, getMemoryLinks, getMemoryWithLinks, findConnectedMemories, findRelatedMemoriesForLinking, createAutoLinks, autoLinkSimilarMemories, getGraphStats, updateMemoryLink, upsertCentralityScore, getCentralityScores, } from './storage/index.js';
+// --- Documents (indexing) ---
+export { upsertDocument, upsertDocumentsBatch, upsertDocumentsBatchWithHashes, deleteDocumentsByPath, getStats, getFileHash, setFileHash, deleteFileHash, getAllFileHashes, getStaleFiles, } from './storage/index.js';
+// --- Embeddings ---
+export { getEmbedding, getEmbeddings, cosineSimilarity, cleanupEmbeddings, getEmbeddingInfo, } from './embeddings.js';
+// --- Config ---
+export { getConfig, getProjectRoot, getSuccDir, isProjectInitialized, isGlobalOnlyMode, invalidateConfigCache, setConfigOverride, } from './config.js';
+// --- BM25 index management ---
+export { invalidateBM25Index, invalidateCodeBm25Index, invalidateDocsBm25Index, invalidateMemoriesBm25Index, updateCodeBm25Index, updateMemoriesBm25Index, } from './storage/index.js';
+// --- Token stats ---
+export { getTokenStatsAggregated, getTokenStatsSummary } from './storage/index.js';
+// --- Web search ---
+export { recordWebSearch, getWebSearchHistory, getWebSearchSummary } from './storage/index.js';
+export { callOpenRouterSearch } from './llm.js';
+// --- AI readiness ---
+export { calculateAIReadinessScore, formatAIReadinessScore } from './ai-readiness.js';
+// --- Retention ---
+export { analyzeRetention } from './retention.js';
+// --- Checkpoints ---
+export { createCheckpoint, listCheckpoints } from './checkpoint.js';
+// --- Graph: advanced operations ---
+export { enrichExistingLinks } from './graph/llm-relations.js';
+export { createProximityLinks } from './graph/contextual-proximity.js';
+export { detectCommunities } from './graph/community-detection.js';
+export { updateCentralityCache } from './graph/centrality.js';
+export { exportGraphSilent } from './graph-export.js';
+// --- PRD pipeline ---
+export { generatePrd } from './prd/generate.js';
+export { loadPrd, loadTasks, listPrds, findLatestPrd } from './prd/state.js';
+export { runPrd } from './prd/runner.js';
+export { exportPrdToObsidian, exportAllPrds } from './prd/export.js';
+// --- Config (write) ---
+export { getConfigDisplay, formatConfigDisplay } from './config.js';
+// --- Debug sessions ---
+export { generateSessionId, ensureDebugsDir, saveSession, loadSession, deleteSession, listSessions, findActiveSession, appendSessionLog, loadSessionLog, } from './debug/state.js';
+export { detectLanguage, generateLogStatement } from './debug/types.js';
+// --- Indexing & analysis (CLI-originated but used by plugins) ---
+export { analyzeFile } from '../commands/analyze-recursive.js';
+export { indexCodeFile } from '../commands/index-code.js';
+export { reindexFiles } from '../commands/reindex.js';
+// --- Tree-sitter symbols ---
+export { extractSymbolsFromFile } from './tree-sitter/public.js';
+// --- Errors ---
+export { SuccError, ConfigError, StorageError, ValidationError, NetworkError, NotFoundError, DependencyError, isSuccError, } from './errors.js';
+//# sourceMappingURL=public-api.js.map