aura-code 0.3.0

package/dist/ruby/alternator.d.ts

@@ -0,0 +1,40 @@
+import type { LLMProvider } from '../providers/types.js';
+import type { ProjectContext } from '../agent/context.js';
+import type { Display } from '../cli/display.js';
+import type { AlternationDecision, Episode, RubyConfig } from './types.js';
+import type { EpisodeStats } from './episode-capture.js';
+/** Configuration for a {@link RubyAlternator} instance. */
+export interface AlternatorOptions {
+    rubyConfig: RubyConfig;
+    largeModelProvider: LLMProvider;
+    projectRoot: string;
+    context: ProjectContext;
+    /** When set, routing and loop events are surfaced to the user. */
+    display?: Display;
+}
+export interface AlternatorRunResult {
+    result: string;
+    episode: Episode;
+    usedRuby: boolean;
+    decision: AlternationDecision;
+}
+/**
+ * Routes tasks between the small Ruby model (Ollama) and a large model based on
+ * learned competence, capturing every alternation as an {@link Episode}.
+ */
+export declare class RubyAlternator {
+    private readonly opts;
+    private readonly display;
+    private readonly permissions;
+    constructor(opts: AlternatorOptions);
+    /**
+     * Runs a task through Ruby and/or the large model, persists an episode, and
+     * returns the final output. Never throws — failures escalate to the large model.
+     */
+    run(task: string): Promise<AlternatorRunResult>;
+    /**
+     * Returns aggregate episode statistics for this alternator's project.
+     * Never throws.
+     */
+    getStats(): Promise<EpisodeStats>;
+}

package/dist/ruby/alternator.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RubyAlternator = void 0;
+const crypto_1 = require("crypto");
+const openai_compatible_js_1 = require("../providers/openai-compatible.js");
+const loop_js_1 = require("../agent/loop.js");
+const permissions_js_1 = require("../safety/permissions.js");
+const competence_js_1 = require("./competence.js");
+const episode_capture_js_1 = require("./episode-capture.js");
+const RECENT_EPISODE_LIMIT = 50;
+const OLLAMA_PING_MS = 3_000;
+// ─────────────────────────────────────────────────────────────────────────────
+// Display noop
+// ─────────────────────────────────────────────────────────────────────────────
+function createNoopDisplay() {
+    return {
+        agentThinking: () => { },
+        streamText: () => { },
+        streamEnd: () => { },
+        toolStart: () => { },
+        toolCall: () => { },
+        toolResult: () => { },
+        toolBlocked: () => { },
+        warning: () => { },
+        success: () => { },
+        error: () => { },
+        header: () => { },
+        summary: () => { },
+        showPlan: () => { },
+        stepStarted: () => { },
+        stepCompleted: () => { },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function inferTaskCategory(task) {
+    const t = task.toLowerCase();
+    if (/\b(review|audit|lint|check)\b/.test(t))
+        return 'review';
+    if (/\b(research|explore|find|investigate|understand)\b/.test(t))
+        return 'research';
+    if (/\b(refactor|restructure|rename|migrate)\b/.test(t))
+        return 'refactor';
+    if (/\b(implement|fix|add|write|create|build|update)\b/.test(t))
+        return 'implementation';
+    return 'other';
+}
+function isNonEmptyResult(text) {
+    return typeof text === 'string' && text.trim().length > 0;
+}
+/**
+ * Checks whether the Ollama OpenAI-compatible endpoint responds.
+ * Never throws.
+ */
+async function isOllamaAvailable(baseUrl) {
+    try {
+        const root = baseUrl.replace(/\/v1\/?$/, '').replace(/\/$/, '');
+        const url = `${root}/v1/models`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), OLLAMA_PING_MS);
+        const res = await fetch(url, {
+            method: 'GET',
+            headers: { Authorization: 'Bearer ollama' },
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+function buildRubyProvider(config) {
+    return new openai_compatible_js_1.OpenAICompatibleProvider({
+        model: config.modelName,
+        baseUrl: config.ollamaBaseUrl,
+        apiKey: 'ollama',
+    }, 'Ruby (Ollama)');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// RubyAlternator
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Routes tasks between the small Ruby model (Ollama) and a large model based on
+ * learned competence, capturing every alternation as an {@link Episode}.
+ */
+class RubyAlternator {
+    opts;
+    display;
+    permissions = new permissions_js_1.PermissionSystem('auto');
+    constructor(opts) {
+        this.opts = opts;
+        this.display = opts.display ?? createNoopDisplay();
+    }
+    /**
+     * Runs a task through Ruby and/or the large model, persists an episode, and
+     * returns the final output. Never throws — failures escalate to the large model.
+     */
+    async run(task) {
+        const startMs = Date.now();
+        const { rubyConfig, largeModelProvider, projectRoot, context } = this.opts;
+        let decision = {
+            useRuby: false,
+            reason: 'Initializing alternation.',
+            confidence: 0,
+            fallbackModel: largeModelProvider.model,
+        };
+        let rubyAttempted = false;
+        let rubySucceeded = false;
+        let rubyOutput;
+        let rubyTokens = 0;
+        let largeModelOutput;
+        let largeModelTokens = 0;
+        let usedRuby = false;
+        let result = '';
+        try {
+            const recent = await episode_capture_js_1.episodeStore.loadEpisodes(projectRoot, RECENT_EPISODE_LIMIT);
+            decision = (0, competence_js_1.assessCompetence)(recent, task, rubyConfig);
+            decision.fallbackModel = largeModelProvider.model;
+            this.display.header('Ruby Principle', decision.reason);
+            if (decision.useRuby && rubyConfig.enabled) {
+                const available = await isOllamaAvailable(rubyConfig.ollamaBaseUrl);
+                if (!available) {
+                    this.display.warning('Ruby (Ollama) is not reachable — escalating to large model.');
+                }
+                else {
+                    rubyAttempted = true;
+                    this.display.success(`Trying Ruby (${rubyConfig.modelName})…`);
+                    try {
+                        const rubyProvider = buildRubyProvider(rubyConfig);
+                        const loopResult = await (0, loop_js_1.runAgentLoop)({
+                            provider: rubyProvider,
+                            task,
+                            context,
+                            permissions: this.permissions,
+                            display: this.display,
+                            disableSpawn: true,
+                            maxTurns: 15,
+                        });
+                        rubyTokens = loopResult.usage.totalTokens;
+                        rubyOutput = loopResult.summary;
+                        if (isNonEmptyResult(rubyOutput) && loopResult.success) {
+                            rubySucceeded = true;
+                            usedRuby = true;
+                            result = rubyOutput;
+                            this.display.success('Ruby handled the task without escalation.');
+                        }
+                        else {
+                            this.display.warning('Ruby did not produce a usable result — escalating.');
+                        }
+                    }
+                    catch (e) {
+                        this.display.warning(`Ruby error: ${String(e)} — escalating.`);
+                        rubyOutput = rubyOutput ?? `Error: ${String(e)}`;
+                    }
+                }
+            }
+            if (!usedRuby) {
+                this.display.header('Large model', largeModelProvider.name);
+                try {
+                    const loopResult = await (0, loop_js_1.runAgentLoop)({
+                        provider: largeModelProvider,
+                        task,
+                        context,
+                        permissions: this.permissions,
+                        display: this.display,
+                        disableSpawn: true,
+                    });
+                    largeModelTokens = loopResult.usage.totalTokens;
+                    largeModelOutput = loopResult.summary;
+                    result = isNonEmptyResult(largeModelOutput)
+                        ? largeModelOutput
+                        : loopResult.success
+                            ? '(Task completed with no output)'
+                            : `Large model did not complete: ${loopResult.summary}`;
+                }
+                catch (e) {
+                    result = `Large model error: ${String(e)}`;
+                    largeModelOutput = result;
+                    this.display.error(result);
+                }
+            }
+        }
+        catch (e) {
+            result = `Alternation error: ${String(e)}`;
+            this.display.error(result);
+        }
+        const episode = {
+            id: (0, crypto_1.randomUUID)(),
+            timestamp: Date.now(),
+            task,
+            projectRoot,
+            rubyAttempted,
+            rubySucceeded,
+            rubyOutput,
+            largeModelUsed: usedRuby ? undefined : largeModelProvider.model,
+            largeModelOutput: usedRuby ? undefined : largeModelOutput,
+            reviewerApproved: isNonEmptyResult(result),
+            tokensUsed: {
+                ruby: rubyAttempted ? rubyTokens : undefined,
+                largeModel: usedRuby ? undefined : largeModelTokens,
+            },
+            durationMs: Date.now() - startMs,
+            taskCategory: inferTaskCategory(task),
+        };
+        try {
+            await episode_capture_js_1.episodeStore.saveEpisode(projectRoot, episode);
+        }
+        catch (e) {
+            this.display.warning(`Failed to save episode: ${String(e)}`);
+        }
+        try {
+            const all = await episode_capture_js_1.episodeStore.loadEpisodes(projectRoot);
+            if ((0, competence_js_1.shouldFineTune)(all)) {
+                this.display.warning('Ruby Principle: enough failures accumulated — project is ready for fine-tuning.');
+            }
+        }
+        catch {
+            /* best-effort */
+        }
+        return { result, episode, usedRuby, decision };
+    }
+    /**
+     * Returns aggregate episode statistics for this alternator's project.
+     * Never throws.
+     */
+    async getStats() {
+        return episode_capture_js_1.episodeStore.getEpisodeStats(this.opts.projectRoot);
+    }
+}
+exports.RubyAlternator = RubyAlternator;
+//# sourceMappingURL=alternator.js.map

package/dist/ruby/alternator.js.map

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

package/dist/ruby/competence.d.ts

@@ -0,0 +1,34 @@
+import type { AlternationDecision, CompetenceLevel, Episode, RubyConfig } from './types.js';
+/** Large model used when Ruby is not trusted or is disabled. */
+export declare const DEFAULT_FALLBACK_MODEL = "claude-sonnet-4-5-20251001";
+/** Default failure count before `shouldFineTune` returns true. */
+export declare const DEFAULT_MIN_FAILURES = 20;
+/**
+ * Decides whether the current task should be routed to Ruby or escalated to
+ * the large model, based on historical episodes and configuration thresholds.
+ *
+ * Never throws — returns a conservative `AlternationDecision` on bad input.
+ */
+export declare function assessCompetence(episodes: Episode[], task: string, config: RubyConfig): AlternationDecision;
+/**
+ * Merges one completed episode into the competence map.
+ * Never throws — returns the previous list unchanged on invalid input.
+ */
+export declare function updateCompetence(existing: CompetenceLevel[], episode: Episode): CompetenceLevel[];
+/**
+ * Summarises Ruby performance grouped by `taskCategory`.
+ * Never throws — returns an empty array on invalid input.
+ */
+export declare function getCompetenceReport(episodes: Episode[]): {
+    category: string;
+    successRate: number;
+    count: number;
+}[];
+/**
+ * Returns true when enough Ruby failures have accumulated to justify a
+ * fine-tune pass. A failure is an episode where Ruby was attempted but did
+ * not succeed (large model intervened or reviewer rejected).
+ *
+ * Never throws — returns false on invalid input.
+ */
+export declare function shouldFineTune(episodes: Episode[], minFailures?: number): boolean;

package/dist/ruby/competence.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MIN_FAILURES = exports.DEFAULT_FALLBACK_MODEL = void 0;
+exports.assessCompetence = assessCompetence;
+exports.updateCompetence = updateCompetence;
+exports.getCompetenceReport = getCompetenceReport;
+exports.shouldFineTune = shouldFineTune;
+const types_js_1 = require("./types.js");
+// ─────────────────────────────────────────────────────────────────────────────
+// Constants
+// ─────────────────────────────────────────────────────────────────────────────
+/** Large model used when Ruby is not trusted or is disabled. */
+exports.DEFAULT_FALLBACK_MODEL = 'claude-sonnet-4-5-20251001';
+/** Default failure count before `shouldFineTune` returns true. */
+exports.DEFAULT_MIN_FAILURES = 20;
+/** Maximum exemplars kept per competence pattern. */
+const MAX_EXAMPLES = 10;
+/** Minimum token-overlap ratio to treat two tasks as similar. */
+const SIMILARITY_THRESHOLD = 0.35;
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal helpers (pure, no I/O)
+// ─────────────────────────────────────────────────────────────────────────────
+function clamp01(n) {
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.max(0, Math.min(1, n));
+}
+function safeConfig(config) {
+    return {
+        modelName: config?.modelName ?? types_js_1.DEFAULT_RUBY_CONFIG.modelName,
+        ollamaBaseUrl: config?.ollamaBaseUrl ?? types_js_1.DEFAULT_RUBY_CONFIG.ollamaBaseUrl,
+        competenceThreshold: clamp01(config?.competenceThreshold ?? types_js_1.DEFAULT_RUBY_CONFIG.competenceThreshold),
+        minAttempts: Math.max(0, config?.minAttempts ?? types_js_1.DEFAULT_RUBY_CONFIG.minAttempts),
+        enabled: config?.enabled ?? types_js_1.DEFAULT_RUBY_CONFIG.enabled,
+    };
+}
+function tokenize(text) {
+    if (typeof text !== 'string')
+        return [];
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter(t => t.length > 2);
+}
+function similarity(a, b) {
+    const ta = new Set(tokenize(a));
+    const tb = new Set(tokenize(b));
+    if (ta.size === 0 || tb.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const t of ta) {
+        if (tb.has(t))
+            intersection++;
+    }
+    const union = ta.size + tb.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+function tasksSimilar(task, other) {
+    const na = task.trim().toLowerCase();
+    const nb = other.trim().toLowerCase();
+    if (!na || !nb)
+        return false;
+    if (na === nb)
+        return true;
+    if (na.includes(nb) || nb.includes(na))
+        return true;
+    return similarity(na, nb) >= SIMILARITY_THRESHOLD;
+}
+/**
+ * Derives a stable pattern key from a task string and optional category.
+ */
+function taskPatternFrom(task, category) {
+    const tokens = tokenize(task).slice(0, 8);
+    const slug = tokens.join('_') || 'generic';
+    const cat = category ?? 'other';
+    return `${cat}:${slug}`;
+}
+function safeEpisodes(episodes) {
+    if (!Array.isArray(episodes))
+        return [];
+    return episodes.filter(e => e && typeof e.task === 'string' && typeof e.rubyAttempted === 'boolean');
+}
+function buildLevelFromEpisodes(pattern, matched) {
+    const attempted = matched.filter(e => e.rubyAttempted);
+    const successes = attempted.filter(e => e.rubySucceeded);
+    const attemptCount = attempted.length;
+    const successRate = attemptCount === 0 ? 0 : successes.length / attemptCount;
+    const examples = attempted
+        .slice(-MAX_EXAMPLES)
+        .map(e => ({ task: e.task, succeeded: e.rubySucceeded }));
+    const lastUpdated = attempted.reduce((max, e) => Math.max(max, e.timestamp ?? 0), 0);
+    return {
+        taskPattern: pattern,
+        successRate: clamp01(successRate),
+        attemptCount,
+        lastUpdated: lastUpdated || Date.now(),
+        examples,
+    };
+}
+function safeDecision(partial) {
+    return {
+        useRuby: partial.useRuby ?? true,
+        reason: partial.reason ?? 'Defaulting to Ruby (safe fallback).',
+        confidence: clamp01(partial.confidence ?? 0),
+        competenceLevel: partial.competenceLevel,
+        fallbackModel: partial.fallbackModel ?? exports.DEFAULT_FALLBACK_MODEL,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// assessCompetence
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Decides whether the current task should be routed to Ruby or escalated to
+ * the large model, based on historical episodes and configuration thresholds.
+ *
+ * Never throws — returns a conservative `AlternationDecision` on bad input.
+ */
+function assessCompetence(episodes, task, config) {
+    try {
+        const cfg = safeConfig(config);
+        const fallbackModel = exports.DEFAULT_FALLBACK_MODEL;
+        if (!cfg.enabled) {
+            return safeDecision({
+                useRuby: false,
+                reason: 'Ruby alternation is disabled in configuration.',
+                confidence: 1,
+                fallbackModel,
+            });
+        }
+        const safeTask = typeof task === 'string' ? task : '';
+        const list = safeEpisodes(episodes);
+        const matched = list.filter(e => tasksSimilar(safeTask, e.task));
+        const pattern = taskPatternFrom(safeTask, matched[0]?.taskCategory ?? 'other');
+        const level = buildLevelFromEpisodes(pattern, matched);
+        if (level.attemptCount < cfg.minAttempts) {
+            return safeDecision({
+                useRuby: true,
+                reason: `Only ${level.attemptCount} prior attempt(s) for this pattern (minimum ${cfg.minAttempts}) — giving Ruby a chance to learn.`,
+                confidence: clamp01(0.3 + level.attemptCount / Math.max(cfg.minAttempts, 1) * 0.3),
+                competenceLevel: level,
+                fallbackModel,
+            });
+        }
+        if (level.successRate >= cfg.competenceThreshold) {
+            return safeDecision({
+                useRuby: true,
+                reason: `Ruby success rate ${(level.successRate * 100).toFixed(0)}% meets threshold ${(cfg.competenceThreshold * 100).toFixed(0)}% for pattern "${pattern}".`,
+                confidence: clamp01(level.successRate * Math.min(1, level.attemptCount / 10)),
+                competenceLevel: level,
+                fallbackModel,
+            });
+        }
+        return safeDecision({
+            useRuby: false,
+            reason: `Ruby success rate ${(level.successRate * 100).toFixed(0)}% below threshold ${(cfg.competenceThreshold * 100).toFixed(0)}% after ${level.attemptCount} attempt(s) — escalating to large model.`,
+            confidence: clamp01((1 - level.successRate) * Math.min(1, level.attemptCount / 10)),
+            competenceLevel: level,
+            fallbackModel,
+        });
+    }
+    catch {
+        return safeDecision({
+            useRuby: true,
+            reason: 'Assessment error — defaulting to Ruby attempt.',
+            confidence: 0,
+        });
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// updateCompetence
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Merges one completed episode into the competence map.
+ * Never throws — returns the previous list unchanged on invalid input.
+ */
+function updateCompetence(existing, episode) {
+    try {
+        if (!episode?.rubyAttempted)
+            return Array.isArray(existing) ? [...existing] : [];
+        const list = Array.isArray(existing) ? [...existing] : [];
+        const pattern = taskPatternFrom(episode.task ?? '', episode.taskCategory);
+        const idx = list.findIndex(l => l.taskPattern === pattern);
+        const prev = idx >= 0 ? list[idx] : undefined;
+        const examples = [
+            ...(prev?.examples ?? []),
+            { task: episode.task, succeeded: episode.rubySucceeded },
+        ].slice(-MAX_EXAMPLES);
+        const attemptCount = (prev?.attemptCount ?? 0) + 1;
+        const prevSuccesses = Math.round((prev?.successRate ?? 0) * (prev?.attemptCount ?? 0));
+        const newSuccesses = prevSuccesses + (episode.rubySucceeded ? 1 : 0);
+        const successRate = attemptCount === 0 ? 0 : newSuccesses / attemptCount;
+        const updated = {
+            taskPattern: pattern,
+            successRate: clamp01(successRate),
+            attemptCount,
+            lastUpdated: episode.timestamp ?? Date.now(),
+            examples,
+        };
+        if (idx >= 0) {
+            list[idx] = updated;
+            return list;
+        }
+        return [...list, updated];
+    }
+    catch {
+        return Array.isArray(existing) ? [...existing] : [];
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// getCompetenceReport
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Summarises Ruby performance grouped by `taskCategory`.
+ * Never throws — returns an empty array on invalid input.
+ */
+function getCompetenceReport(episodes) {
+    try {
+        const list = safeEpisodes(episodes);
+        const buckets = new Map();
+        for (const ep of list) {
+            if (!ep.rubyAttempted)
+                continue;
+            const cat = ep.taskCategory ?? 'other';
+            const b = buckets.get(cat) ?? { successes: 0, count: 0 };
+            b.count += 1;
+            if (ep.rubySucceeded)
+                b.successes += 1;
+            buckets.set(cat, b);
+        }
+        return Array.from(buckets.entries())
+            .map(([category, { successes, count }]) => ({
+            category,
+            successRate: clamp01(count === 0 ? 0 : successes / count),
+            count,
+        }))
+            .sort((a, b) => b.count - a.count);
+    }
+    catch {
+        return [];
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// shouldFineTune
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Returns true when enough Ruby failures have accumulated to justify a
+ * fine-tune pass. A failure is an episode where Ruby was attempted but did
+ * not succeed (large model intervened or reviewer rejected).
+ *
+ * Never throws — returns false on invalid input.
+ */
+function shouldFineTune(episodes, minFailures = exports.DEFAULT_MIN_FAILURES) {
+    try {
+        const threshold = Math.max(1, minFailures ?? exports.DEFAULT_MIN_FAILURES);
+        const list = safeEpisodes(episodes);
+        const failures = list.filter(e => e.rubyAttempted && !e.rubySucceeded).length;
+        return failures >= threshold;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=competence.js.map

package/dist/ruby/competence.js.map

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

package/dist/ruby/episode-capture.d.ts

@@ -0,0 +1,56 @@
+import type { Episode } from './types.js';
+/**
+ * Rough character-based token estimation (≈1 token per 4 characters).
+ * Used only for episode recording when the provider does not report usage
+ * (e.g. MiMo streaming, Google Gemini streaming).
+ */
+export declare function estimateTokens(text: string | undefined): number;
+/** Stats returned by {@link getEpisodeStats}. */
+export interface EpisodeStats {
+    total: number;
+    rubySuccesses: number;
+    rubyFailures: number;
+    largeModelInterventions: number;
+    readyForFineTune: boolean;
+}
+/**
+ * On-disk episode persistence for the Ruby Principle.
+ * Mirrors {@link sessionStore} — atomic `.tmp` writes, namespaced by project hash.
+ */
+export declare const episodeStore: {
+    defaultDir(): string;
+    /**
+     * First 8 characters of the base64 encoding of `projectRoot`.
+     */
+    projectHash(projectRoot: string): string;
+    /** Directory containing all episodes for a project. */
+    projectDir(projectRoot: string): string;
+    /** Full path to one episode file. */
+    episodePath(projectRoot: string, id: string): string;
+    /**
+     * Persists one episode to `~/.aura/episodes/{projectHash}/{id}.json`.
+     *
+     * When the provider did not report token usage (totalTokens === 0), fills in
+     * a character-based estimate from the episode's output text so that fine-tune
+     * readiness and competence tracking still have meaningful token counts.
+     */
+    saveEpisode(projectRoot: string, episode: Episode): Promise<void>;
+    /**
+     * Loads episodes for a project, newest first.
+     * Never throws — returns `[]` on missing dir or parse errors.
+     */
+    loadEpisodes(projectRoot: string, limit?: number): Promise<Episode[]>;
+    /**
+     * Removes one episode file. Safe when the file does not exist.
+     */
+    deleteEpisode(projectRoot: string, id: string): Promise<void>;
+    /**
+     * Aggregates episode counters and fine-tune readiness for a project.
+     * Never throws — returns zeroed stats on error.
+     */
+    getEpisodeStats(projectRoot: string): Promise<EpisodeStats>;
+};
+export declare const saveEpisode: (projectRoot: string, episode: Episode) => Promise<void>;
+export declare const loadEpisodes: (projectRoot: string, limit?: number) => Promise<Episode[]>;
+export declare const deleteEpisode: (projectRoot: string, id: string) => Promise<void>;
+export declare const getEpisodeStats: (projectRoot: string) => Promise<EpisodeStats>;