aura-code 0.6.3 → 0.10.1

package/dist/doctor/index.js

@@ -0,0 +1,229 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctor = runDoctor;
+exports.formatDoctorReport = formatDoctorReport;
+/**
+ * Aura Doctor — entry point. runDoctor() runs all checks, optionally
+ * attempts repairs, and returns a DoctorReport. formatDoctorReport()
+ * renders it as a colored terminal string.
+ *
+ * Usage:
+ *   const report = await runDoctor({ projectRoot, fix: true });
+ *   console.log(formatDoctorReport(report));
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const checks_js_1 = require("./checks.js");
+const repair_js_1 = require("./repair.js");
+async function runDoctor(opts) {
+    const { projectRoot, fix = false, offline = false } = opts;
+    const pkg = readPkgVersion(projectRoot);
+    // Run all sync checks
+    let findings = [];
+    for (const check of checks_js_1.ALL_CHECKS) {
+        try {
+            findings = findings.concat(check.run(projectRoot, offline));
+        }
+        catch (e) {
+            findings.push({
+                category: check.category, name: `${check.category} check`,
+                severity: 'error', message: `Check crashed: ${String(e).slice(0, 150)}`,
+                fixable: false,
+            });
+        }
+    }
+    // Async latest-version check (skipped offline)
+    if (!offline && pkg !== 'unknown') {
+        const latest = await (0, checks_js_1.checkLatestVersion)(pkg);
+        if (latest)
+            findings.push(latest);
+    }
+    // Attempt repairs
+    const fixed = [];
+    const fixFailed = [];
+    if (fix) {
+        const toFix = findings.filter(f => f.fixable);
+        const done = new Set();
+        for (const f of toFix) {
+            // Deduplicate by repair key — e.g. "dist directory" and "dist freshness"
+            // both map to "rebuild dist", so only do it once.
+            const result = (0, repair_js_1.attemptRepair)(projectRoot, f);
+            if (!result)
+                continue;
+            if (done.has(result.name))
+                continue;
+            done.add(result.name);
+            if (result.success) {
+                fixed.push(f.name);
+                // Flip the finding to ok
+                f.severity = 'ok';
+                f.message = `${f.message} [FIXED: ${result.message}]`;
+            }
+            else {
+                fixFailed.push(f.name);
+                f.detail = (f.detail ?? '') + `\nRepair failed: ${result.message}`;
+            }
+        }
+        // After repairs, re-run the build check to confirm dist is now fresh
+        if (fixed.some(n => n.includes('dist') || n === 'entry point' || n === 'dist directory')) {
+            const buildCheck = checks_js_1.ALL_CHECKS.find(c => c.category === 'build');
+            if (buildCheck) {
+                const rechecked = buildCheck.run(projectRoot, offline);
+                // Replace build-category findings with the rechecked ones
+                findings = findings.filter(f => f.category !== 'build').concat(rechecked);
+            }
+        }
+    }
+    const summary = { ok: 0, warn: 0, error: 0, fixable: 0 };
+    for (const f of findings)
+        summary[f.severity]++;
+    const report = {
+        timestamp: Date.now(),
+        version: pkg,
+        projectRoot,
+        findings,
+        summary,
+        fixed,
+        fixFailed,
+    };
+    // Persist to .aura/doctor-report.json (gitignored)
+    try {
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? '~';
+        const auraDir = path.join(home, '.aura');
+        if (!fs.existsSync(auraDir))
+            fs.mkdirSync(auraDir, { recursive: true });
+        fs.writeFileSync(path.join(auraDir, 'doctor-report.json'), JSON.stringify(report, null, 2), 'utf8');
+    }
+    catch { /* best-effort */ }
+    return report;
+}
+function readPkgVersion(root) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+        return pkg.version ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+// ── Formatting ───────────────────────────────────────────────────────────────
+const SEVERITY_ICON = {
+    ok: '✓', warn: '⚠', error: '✗', fixable: '⟳',
+};
+const SEVERITY_COLOR = {
+    ok: chalk_1.default.hex('#5a9e6e'),
+    warn: chalk_1.default.hex('#d4903a'),
+    error: chalk_1.default.hex('#b15439'),
+    fixable: chalk_1.default.hex('#d4903a'),
+};
+const CATEGORY_LABEL = {
+    build: 'Build', config: 'Config', source: 'Source', assets: 'Assets',
+    skills: 'Skills', deps: 'Dependencies', git: 'Git', env: 'Environment',
+    version: 'Version', memory: 'Memory', hygiene: 'Repo Hygiene',
+};
+function formatDoctorReport(report) {
+    const w = process.stdout.columns ?? 80;
+    const line = chalk_1.default.hex('#4e3d30')('─'.repeat(Math.min(w - 4, 60)));
+    const parts = [
+        '',
+        line,
+        chalk_1.default.hex('#cc785c').bold('  ◆ Aura Doctor — System Diagnostic'),
+        chalk_1.default.hex('#8a7768')(`  v${report.version} · ${new Date(report.timestamp).toLocaleString()}`),
+        line,
+        '',
+    ];
+    // Group findings by category
+    const categories = [...new Set(report.findings.map(f => f.category))];
+    for (const cat of categories) {
+        const catFindings = report.findings.filter(f => f.category === cat);
+        parts.push(chalk_1.default.hex('#cc785c').bold(`  ${CATEGORY_LABEL[cat] ?? cat}`));
+        for (const f of catFindings) {
+            const icon = SEVERITY_COLOR[f.severity](SEVERITY_ICON[f.severity]);
+            const msg = chalk_1.default.hex('#c8b5a0')(f.message);
+            const fixTag = f.fixable && !report.fixed.includes(f.name)
+                ? ' ' + chalk_1.default.hex('#d4903a')('[fixable]')
+                : report.fixed.includes(f.name)
+                    ? ' ' + chalk_1.default.hex('#5a9e6e')('[fixed]')
+                    : '';
+            parts.push(`    ${icon} ${msg}${fixTag}`);
+            if (f.detail) {
+                for (const dl of f.detail.split('\n')) {
+                    parts.push(chalk_1.default.hex('#4e3d30')(`       ${dl}`));
+                }
+            }
+            if (f.fixDescription && f.fixable && !report.fixed.includes(f.name)) {
+                parts.push(chalk_1.default.hex('#8a7768')(`       → ${f.fixDescription}`));
+            }
+        }
+        parts.push('');
+    }
+    // Summary
+    const s = report.summary;
+    const allOk = s.error === 0 && s.warn === 0 && s.fixable === 0;
+    parts.push(line);
+    if (allOk) {
+        parts.push(chalk_1.default.hex('#5a9e6e').bold('  ✓ All checks passed — Aura is healthy.'));
+    }
+    else {
+        const bits = [];
+        if (s.error > 0)
+            bits.push(chalk_1.default.hex('#b15439')(`${s.error} error(s)`));
+        if (s.warn > 0)
+            bits.push(chalk_1.default.hex('#d4903a')(`${s.warn} warning(s)`));
+        if (s.fixable > 0)
+            bits.push(chalk_1.default.hex('#d4903a')(`${s.fixable} fixable`));
+        if (s.ok > 0)
+            bits.push(chalk_1.default.hex('#5a9e6e')(`${s.ok} ok`));
+        parts.push(`  ${bits.join(' · ')}`);
+    }
+    if (report.fixed.length > 0) {
+        parts.push(chalk_1.default.hex('#5a9e6e')(`  ✓ Repaired: ${report.fixed.join(', ')}`));
+    }
+    if (report.fixFailed.length > 0) {
+        parts.push(chalk_1.default.hex('#b15439')(`  ✗ Could not repair: ${report.fixFailed.join(', ')}`));
+    }
+    const fixableCount = report.findings.filter(f => f.fixable && !report.fixed.includes(f.name)).length;
+    if (fixableCount > 0 && !report.fixed.length) {
+        parts.push(chalk_1.default.hex('#8a7768')(`  Run aura --doctor --fix to attempt ${fixableCount} repair(s).`));
+    }
+    parts.push(line + '\n');
+    return parts.join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/doctor/index.js.map

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

package/dist/doctor/repair.d.ts

@@ -0,0 +1,19 @@
+import type { Finding } from './types.js';
+export interface RepairResult {
+    name: string;
+    success: boolean;
+    message: string;
+}
+/** Rebuild dist/ from src/ via `npm run build`. */
+export declare function repairBuild(root: string): RepairResult;
+/** Restore a git-tracked file to its committed state via `git restore`. */
+export declare function repairGitFile(root: string, fileRel: string): RepairResult;
+/** Run npm install to restore missing node_modules. */
+export declare function repairDeps(root: string): RepairResult;
+/** Delete a corrupted file (e.g. invalid identity.json). */
+export declare function repairDelete(root: string, absPath: string): RepairResult;
+/**
+ * Attempt to repair a single finding. Returns the repair result, or null
+ * if the finding is not auto-repairable or doesn't map to a known repair.
+ */
+export declare function attemptRepair(root: string, finding: Finding): RepairResult | null;

package/dist/doctor/repair.js

@@ -0,0 +1,126 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repairBuild = repairBuild;
+exports.repairGitFile = repairGitFile;
+exports.repairDeps = repairDeps;
+exports.repairDelete = repairDelete;
+exports.attemptRepair = attemptRepair;
+/**
+ * Aura Doctor — repair module. Each function attempts to fix a specific
+ * class of finding and returns true on success, false on failure.
+ *
+ * Repairs use direct execSync / fs calls — they never go through the agent
+ * tool layer (the safety layer blocks git checkout/reset for telegram, and
+ * the agent has no git_restore tool anyway).
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+function sh(cmd, cwd) {
+    try {
+        return (0, child_process_1.execSync)(cmd, { cwd, encoding: 'utf8', timeout: 120_000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+    }
+    catch (e) {
+        throw new Error(String(e));
+    }
+}
+/** Rebuild dist/ from src/ via `npm run build`. */
+function repairBuild(root) {
+    try {
+        sh('npm run build', root);
+        return { name: 'rebuild dist', success: true, message: 'Rebuilt dist/ via npm run build.' };
+    }
+    catch (e) {
+        return { name: 'rebuild dist', success: false, message: `Build failed: ${String(e).slice(0, 200)}` };
+    }
+}
+/** Restore a git-tracked file to its committed state via `git restore`. */
+function repairGitFile(root, fileRel) {
+    try {
+        sh(`git restore -- "${fileRel}"`, root);
+        return { name: `restore ${fileRel}`, success: true, message: `Restored ${fileRel} from git.` };
+    }
+    catch (e) {
+        return { name: `restore ${fileRel}`, success: false, message: `Could not restore: ${String(e).slice(0, 200)}` };
+    }
+}
+/** Run npm install to restore missing node_modules. */
+function repairDeps(root) {
+    try {
+        sh('npm install', root);
+        return { name: 'npm install', success: true, message: 'Dependencies installed.' };
+    }
+    catch (e) {
+        return { name: 'npm install', success: false, message: `npm install failed: ${String(e).slice(0, 200)}` };
+    }
+}
+/** Delete a corrupted file (e.g. invalid identity.json). */
+function repairDelete(root, absPath) {
+    try {
+        fs.unlinkSync(absPath);
+        return { name: `delete ${path.basename(absPath)}`, success: true, message: `Deleted ${absPath}.` };
+    }
+    catch (e) {
+        return { name: `delete ${path.basename(absPath)}`, success: false, message: `Could not delete: ${String(e).slice(0, 200)}` };
+    }
+}
+/**
+ * Attempt to repair a single finding. Returns the repair result, or null
+ * if the finding is not auto-repairable or doesn't map to a known repair.
+ */
+function attemptRepair(root, finding) {
+    if (!finding.fixable)
+        return null;
+    // Build staleness / missing dist
+    if (finding.category === 'build' && (finding.name === 'dist directory' || finding.name === 'entry point' || finding.name === 'dist freshness')) {
+        return repairBuild(root);
+    }
+    // Missing node_modules or key deps
+    if (finding.category === 'deps' && (finding.name === 'node_modules' || finding.name.startsWith('dep:'))) {
+        return repairDeps(root);
+    }
+    // Corrupted identity.json
+    if (finding.category === 'memory' && finding.name === 'identity') {
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? '~';
+        return repairDelete(root, path.join(home, '.aura', 'memory', 'identity.json'));
+    }
+    // Corrupted .aura.json — suggest deletion (don't auto-delete config the user wrote)
+    if (finding.category === 'config' && finding.name === '.aura.json') {
+        return { name: '.aura.json', success: false, message: 'Cannot auto-repair .aura.json — fix the JSON syntax manually or delete it to use defaults.' };
+    }
+    return null;
+}
+//# sourceMappingURL=repair.js.map

package/dist/doctor/repair.js.map

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

package/dist/doctor/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Aura Doctor — type definitions for the self-diagnostic system.
+ *
+ * A Finding is a single check result. A DoctorReport is the full scan
+ * output. Everything is observational unless the caller passes fix:true,
+ * in which case repair.ts attempts auto-repairs and records what it did.
+ */
+export type Severity = 'ok' | 'warn' | 'error' | 'fixable';
+export type Category = 'build' | 'config' | 'source' | 'assets' | 'skills' | 'deps' | 'git' | 'env' | 'version' | 'memory' | 'hygiene';
+export interface Finding {
+    category: Category;
+    name: string;
+    severity: Severity;
+    message: string;
+    detail?: string;
+    /** Whether runDoctor({fix:true}) can attempt to repair this. */
+    fixable: boolean;
+    /** Human description of what the fix does, shown when not auto-fixing. */
+    fixDescription?: string;
+}
+export interface DoctorReport {
+    timestamp: number;
+    version: string;
+    projectRoot: string;
+    findings: Finding[];
+    summary: Record<Severity, number>;
+    /** Names of findings that were auto-repaired (only when fix:true). */
+    fixed: string[];
+    /** Names of findings where repair was attempted but failed. */
+    fixFailed: string[];
+}
+export interface DoctorOptions {
+    projectRoot: string;
+    /** Attempt auto-repair for fixable findings. */
+    fix?: boolean;
+    /** Skip checks that hit the network (version check). */
+    offline?: boolean;
+}

package/dist/doctor/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Aura Doctor — type definitions for the self-diagnostic system.
+ *
+ * A Finding is a single check result. A DoctorReport is the full scan
+ * output. Everything is observational unless the caller passes fix:true,
+ * in which case repair.ts attempts auto-repairs and records what it did.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/doctor/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/doctor/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/dream/dream.d.ts

@@ -1,71 +1,91 @@
 import type { LLMProvider } from '../providers/types.js';
 /**
- * Aura's "dream": an offline consolidation pass over recorded episodes.
- *
- * Stages:
- *   1. Recall      — load episodes since the last dream.
- *   2. Consolidate — distil them into lessons + patterns via the LLM.
- *   3. Prepare     — write a short brief of open threads for tomorrow.
- *   4. Reconcile   — if ≥3 existing dreams, run memory reconciliation
- *                    across all dreams and write `dreams/.reconciled.md`.
- *   5. OKF bundle  — if reconciliation succeeded, write a portable
- *                    Open Knowledge Format bundle to `knowledge/`.
- *                    Any OKF-compatible agent can consume Aura's knowledge.
- *
- * Steps 4-5 are BEST-EFFORT: if they fail, the dream file is still
- * written and the cutoff is advanced.
- *
- * Output is one dated Markdown file per night under `<projectRoot>/dreams/`.
- * The structure is deliberately stable and entity-tagged so a later pass
- * (`:rem`) can parse these files into a relations graph. Do not reformat the
- * headers without updating the parser (parser.ts).
- *
- * Memory reconciliation produces `dreams/.reconciled.md` — a PROJECTION
- * (materialized view) of current beliefs with annotations showing lineage.
- * The OKF bundle in `knowledge/` is the same data in a portable, vendor-
- * neutral format readable by any agent or tool.
- * Old dream files stay untouched as an append-only audit trail.
+ * Dated dream-store path for a mid-session flush (see generational-flush.ts).
+ * Suffixed so multiple flushes in one day don't collide with each other or
+ * with the end-of-session `todayFile()` dream — each is its own dream file,
+ * picked up the same way by `listDreamFiles`/`runReconciliation`.
  */
-export interface DreamResult {
-    path: string;
-    date: string;
-    episodeCount: number;
-    recalledSince: number;
-    skipped: boolean;
-    reason?: string;
-    /** Set when the LLM consolidation failed — episodes are preserved and NOT burned. */
-    providerError?: string;
-    /** True if memory reconciliation ran successfully after the dream was written. */
-    reconciled?: boolean;
-    /** Path to the OKF bundle if it was written. */
-    okfBundlePath?: string;
-}
-/** Timestamp (ms) of the last dream for this project, or 0 if never. */
-export declare function lastDreamTimestamp(projectRoot: string): number;
+export declare function sessionFlushFile(root: string, seq: number): string;
 /**
- * Run a dream. Pure with respect to I/O sources: caller supplies the provider.
- * Never throws on an empty day — returns { skipped: true }.
- *
- * IMPORTANT: the `.last.json` state cutoff is only advanced when the LLM
- * consolidation succeeds. If the primary provider fails, a single retry on a
- * local Ollama instance is attempted before giving up gracefully. Episodes are
- * NEVER burned (cut off) when the provider is unreachable.
- *
- * After a successful dream write, memory reconciliation runs (if ≥3 dreams
- * exist). If reconciliation succeeds, an OKF knowledge bundle is also
- * written to `knowledge/`. Both are best-effort — if either fails, the
- * dream file and cutoff are already committed.
+ * The consolidation cutoff: the timestamp of the newest episode covered by
+ * the last successful dream. Stored in dreams/.state.json — NOT derived from
+ * file mtimes, so a failed run (which writes nothing) can never advance it
+ * and the same episodes are re-recalled next time.
+ */
+export declare function lastDreamTimestamp(root: string): number;
+/**
+ * Spend one LLM call distilling `userContent` under `systemPrompt`, and
+ * write the result to `outPath`. The one shared distillation primitive —
+ * `runDream` uses it for episode batches, and a mid-session context-window
+ * rollover (src/agent/generational-flush.ts) uses it for a recap block —
+ * so both write into the same dream-store shape and both feed the same
+ * `runReconciliation()` pass.
  */
-export declare function runDream(opts: {
+export declare function distillText(opts: {
+    systemPrompt: string;
+    userContent: string;
+    provider: LLMProvider;
+    outPath: string;
+}): Promise<string>;
+export interface DreamOptions {
     projectRoot: string;
     provider: LLMProvider;
-    /** Override the "since" cutoff (ms). Defaults to last dream timestamp. */
+    /** Cutoff override (ms). Defaults to the stored cutoff from the last successful dream. */
     since?: number;
-    /** If true, consolidate ALL episodes regardless of last-dream cutoff. */
+    /** Ignore the cutoff and consolidate every recorded episode. */
     full?: boolean;
     /**
-     * Ollama model to use as a local fallback when the primary provider fails.
-     * Set to false to disable. Defaults to 'llama3.2'.
+     * Local model to retry with when the primary provider fails (Ollama must be
+     * running). Pass `false` to disable the fallback entirely.
      */
     ollamaFallbackModel?: string | false;
-}): Promise<DreamResult>;
+}
+export interface DreamResult {
+    /** True when nothing was written — empty day, or provider failure. */
+    skipped: boolean;
+    /** Episodes recalled for this cycle (still counted on failure — they're preserved). */
+    episodeCount: number;
+    /** Why the run was skipped, for the empty-day case. */
+    reason?: string;
+    /** Written dream file, on success. */
+    path?: string;
+    /** The cutoff actually used (0 for full runs). */
+    recalledSince?: number;
+    /** Provider failure detail — set only when skipped due to LLM errors. */
+    providerError?: string;
+    /** True when >=3 dreams existed after the write and reconciliation ran. */
+    reconciled?: boolean;
+}
+/**
+ * Run one dream cycle: consolidate episodes since the last dream into a
+ * dated markdown file. Spends exactly one LLM call (plus at most one Ollama
+ * fallback call). Triggers reconciliation automatically once >=3 dream
+ * files exist.
+ *
+ * Critical invariant: episodes are NEVER burned on failure. The dream file
+ * and the cutoff advance together, and only after the model produced real
+ * content — any provider error or empty response leaves both untouched, so
+ * the next run re-recalls the same episodes.
+ */
+export declare function runDream(opts: DreamOptions): Promise<DreamResult>;
+/**
+ * Reconcile all dream files into one projection. Pure statistics:
+ * confidence = (number of dreams whose topicKey group contains this claim) / (total dream files).
+ * This is a lexical-overlap heuristic (v1) — not full semantic dedup.
+ */
+export declare function runReconciliation(root: string): string;
+/** For :rem — the current reconciled projection, or the latest dream if reconciliation hasn't triggered yet. */
+export declare function getReconciledOrLatest(root: string): {
+    content: string;
+    isReconciled: boolean;
+} | null;
+/**
+ * Global lessons digest — pure statistics over EVERY project's episodes.
+ * Written to ~/.aura/memory/lessons-global.md for the Telegram bot (which
+ * isn't tied to one project). No LLM call: counts successes/failures per model
+ * and surfaces the most recent activity. Mirrors runReconciliation's "trust
+ * numbers, not a model's guess" philosophy.
+ */
+export declare function runGlobalReconciliation(): string;
+/** For system-prompt injection — the reconciled memory, truncated, or empty string if none exists. */
+export declare function loadReconciledMemorySection(root: string): string;