aura-code 0.3.7 → 0.6.3

package/dist/dream/dream.js

@@ -0,0 +1,217 @@
+"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.lastDreamTimestamp = lastDreamTimestamp;
+exports.runDream = runDream;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const episode_capture_js_1 = require("../ruby/episode-capture.js");
+const factory_js_1 = require("../providers/factory.js");
+const parser_js_1 = require("./parser.js");
+const reconcile_js_1 = require("./reconcile.js");
+const okf_js_1 = require("./okf.js");
+const DREAMS_DIRNAME = 'dreams';
+const STATE_FILENAME = '.last.json';
+function dreamsDir(projectRoot) {
+    return path.join(projectRoot, DREAMS_DIRNAME);
+}
+/** Timestamp (ms) of the last dream for this project, or 0 if never. */
+function lastDreamTimestamp(projectRoot) {
+    try {
+        const raw = fs.readFileSync(path.join(dreamsDir(projectRoot), STATE_FILENAME), 'utf8');
+        const parsed = JSON.parse(raw);
+        return typeof parsed.lastDreamTs === 'number' ? parsed.lastDreamTs : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function writeState(projectRoot, lastDreamTs) {
+    const dir = dreamsDir(projectRoot);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, STATE_FILENAME), JSON.stringify({ lastDreamTs }, null, 2));
+}
+/** Compact, low-token digest of one episode for the consolidation prompt. */
+function digestEpisode(ep) {
+    const tier = ep.rubySucceeded ? 'ruby' : ep.largeModelUsed ? `large(${ep.largeModelUsed})` : 'none';
+    const ok = ep.reviewerApproved ? 'approved' : 'unreviewed';
+    const secs = Math.round(ep.durationMs / 1000);
+    return `- [${ep.taskCategory}] "${ep.task.slice(0, 140)}" — tier=${tier}, ${ok}, ${secs}s`;
+}
+function buildConsolidationPrompt(episodes) {
+    const system = 'You are Aura consolidating a day of work into durable memory, like a brain dreaming. ' +
+        'You are given digests of today\'s task episodes. Produce concise, reusable knowledge — ' +
+        'not a transcript. Be specific and tagged. Respond in GitHub Markdown with EXACTLY these ' +
+        'sections and nothing else:\n\n' +
+        '## Lessons\n(bullet list; each line starts with a [tag] in brackets, e.g. [routing], [tooling], [bug]. ' +
+        'State what was learned, generalised beyond the single task.)\n\n' +
+        '## Patterns\n(bullet list of recurring task shapes or failure modes seen across episodes.)\n\n' +
+        '## Open threads\n(bullet list of unresolved problems worth picking up tomorrow; ' +
+        'prefix each with [todo]. Empty bullet "- none" if nothing.)\n\n' +
+        '## Tomorrow brief\n(2–4 sentences: what Aura should be ready for next session.)';
+    const user = `Today's episodes (${episodes.length}):\n\n` +
+        episodes.map(digestEpisode).join('\n');
+    return { system, user };
+}
+function header(date, episodes, since) {
+    const succeeded = episodes.filter(e => e.reviewerApproved).length;
+    const rubyWins = episodes.filter(e => e.rubySucceeded).length;
+    const sinceStr = since > 0 ? new Date(since).toISOString() : 'beginning';
+    const cats = [...new Set(episodes.map(e => e.taskCategory))].join(', ') || '—';
+    return (`# Dream — ${date}\n\n` +
+        `> ${episodes.length} episodes recalled since ${sinceStr} · ` +
+        `${succeeded} approved · ${rubyWins} ruby wins\n` +
+        `> Categories: ${cats}\n`);
+}
+/**
+ * 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.
+ */
+async function runDream(opts) {
+    const { projectRoot, provider } = opts;
+    const ollamaFallbackModel = opts.ollamaFallbackModel === undefined ? 'llama3.2' : opts.ollamaFallbackModel;
+    const date = new Date().toISOString().slice(0, 10);
+    const since = opts.full ? 0 : (opts.since ?? lastDreamTimestamp(projectRoot));
+    const all = await (0, episode_capture_js_1.loadEpisodes)(projectRoot);
+    const episodes = all.filter(e => e.timestamp > since);
+    if (episodes.length === 0) {
+        return { path: '', date, episodeCount: 0, recalledSince: since, skipped: true, reason: 'no new episodes since last dream' };
+    }
+    // ── Consolidate via the LLM ──────────────────────────────────────────────
+    // Critical invariant: we do NOT advance the cutoff unless this succeeds.
+    const { system, user } = buildConsolidationPrompt(episodes);
+    let body;
+    let providerError;
+    const tryComplete = async (p) => {
+        const res = await p.complete(system, [{ role: 'user', content: user }], []);
+        const text = (res.text ?? '').trim();
+        if (!text)
+            throw new Error('Provider returned an empty response');
+        return text;
+    };
+    // Primary attempt
+    try {
+        body = await tryComplete(provider);
+    }
+    catch (primaryErr) {
+        const primaryMsg = primaryErr instanceof Error ? primaryErr.message : String(primaryErr);
+        // ── Ollama fallback ───────────────────────────────────────────────────
+        if (ollamaFallbackModel) {
+            const ollamaBaseUrl = 'http://localhost:11434/v1';
+            const ollamaHealthy = await (0, factory_js_1.checkOllamaHealth)('http://localhost:11434').catch(() => false);
+            if (ollamaHealthy) {
+                try {
+                    const ollamaProvider = (0, factory_js_1.createProvider)({
+                        model: `ollama/${ollamaFallbackModel}`,
+                        baseUrl: ollamaBaseUrl,
+                        maxTokens: 2048,
+                    });
+                    body = await tryComplete(ollamaProvider);
+                    providerError = undefined;
+                }
+                catch (ollamaErr) {
+                    const ollamaMsg = ollamaErr instanceof Error ? ollamaErr.message : String(ollamaErr);
+                    providerError = `primary: ${primaryMsg}; ollama fallback: ${ollamaMsg}`;
+                }
+            }
+            else {
+                providerError = `${primaryMsg} (Ollama not reachable at ${ollamaBaseUrl})`;
+            }
+        }
+        else {
+            providerError = primaryMsg;
+        }
+    }
+    // ── Provider failed — preserve episodes, return without writing state ─────
+    if (providerError !== undefined) {
+        return {
+            path: '',
+            date,
+            episodeCount: episodes.length,
+            recalledSince: since,
+            skipped: true,
+            reason: 'provider error — episodes preserved for next :dream run',
+            providerError,
+        };
+    }
+    // ── Write dream file ──────────────────────────────────────────────────────
+    const md = `${header(date, episodes, since)}\n${body}\n`;
+    const dir = dreamsDir(projectRoot);
+    fs.mkdirSync(dir, { recursive: true });
+    const outPath = path.join(dir, `${date}.md`);
+    fs.writeFileSync(outPath, md);
+    // Advance the cutoff ONLY on success.
+    const newest = Math.max(...episodes.map(e => e.timestamp));
+    writeState(projectRoot, newest);
+    // ── Reconciliation (best-effort) ──────────────────────────────────────────
+    let reconciled = false;
+    let okfBundlePath;
+    try {
+        const allDreams = (0, parser_js_1.loadExistingDreams)(projectRoot);
+        const result = await (0, reconcile_js_1.reconcileDreams)({
+            projectRoot,
+            provider,
+            dreams: allDreams,
+        });
+        if (result) {
+            // Append reconciliation log to today's dream file for traceability.
+            fs.appendFileSync(outPath, result.logSection);
+            reconciled = true;
+            // ── OKF bundle (best-effort) ────────────────────────────────────────
+            // Write the portable knowledge bundle from the same reconciled data.
+            try {
+                okfBundlePath = (0, okf_js_1.writeOkfBundle)(result.bullets, result.totalDreams, projectRoot);
+            }
+            catch {
+                // OKF write failure is silent — reconciled.md is already committed.
+            }
+        }
+    }
+    catch {
+        // Reconciliation failure is silent — dream is already saved.
+    }
+    return { path: outPath, date, episodeCount: episodes.length, recalledSince: since, skipped: false, reconciled, okfBundlePath };
+}
+//# sourceMappingURL=dream.js.map

package/dist/dream/dream.js.map

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

package/dist/dream/okf.d.ts

@@ -0,0 +1,10 @@
+import type { ReconciledBullet } from './reconcile.js';
+/**
+ * Write an OKF v0.1 knowledge bundle from reconciled bullets.
+ *
+ * Called after reconciliation succeeds. Best-effort — if this fails,
+ * .reconciled.md is already written and the dream is safe.
+ *
+ * The bundle directory is wiped and rebuilt each time (it's a projection).
+ */
+export declare function writeOkfBundle(bullets: ReconciledBullet[], totalDreams: number, projectRoot: string): string;

package/dist/dream/okf.js

@@ -0,0 +1,280 @@
+"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.writeOkfBundle = writeOkfBundle;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * OKF (Open Knowledge Format) v0.1 bundle writer.
+ *
+ * Takes the reconciled bullets from Aura's dream system and writes them
+ * as a portable OKF knowledge bundle under `<projectRoot>/knowledge/`.
+ *
+ * OKF spec: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md
+ *
+ * Why both .reconciled.md AND an OKF bundle?
+ *   - `.reconciled.md` is Aura's internal format — compact, fast, injected
+ *     into the system prompt for Aura's own use.
+ *   - `knowledge/` is the portable output — any other agent, tool, or human
+ *     can read it. Cursor, Claude Code, LangChain agents, Obsidian, MkDocs,
+ *     or any OKF consumer can consume Aura's accumulated knowledge without
+ *     understanding Aura's dream format.
+ *
+ * The bundle is regenerated on every reconciliation pass. It's a projection,
+ * just like .reconciled.md — delete it and the next :dream rebuilds it.
+ *
+ * Concept types used:
+ *   - "lesson"       — from ## Lessons
+ *   - "pattern"      — from ## Patterns
+ *   - "open-thread"  — from ## Open threads
+ *   - "conflict"     — CONFLICT verdicts get their own concepts
+ *
+ * Directory structure:
+ *   knowledge/
+ *     index.md           — bundle root index (okf_version: "0.1")
+ *     log.md             — reconciliation changelog
+ *     lessons/
+ *       index.md
+ *       <slug>.md
+ *     patterns/
+ *       index.md
+ *       <slug>.md
+ *     open-threads/
+ *       index.md
+ *       <slug>.md
+ */
+const KNOWLEDGE_DIR = 'knowledge';
+const OKF_VERSION = '0.1';
+const SECTION_DIR = {
+    lessons: 'lessons',
+    patterns: 'patterns',
+    openThreads: 'open-threads',
+};
+const SECTION_TYPE = {
+    lessons: 'lesson',
+    patterns: 'pattern',
+    openThreads: 'open-thread',
+};
+const SECTION_LABEL = {
+    lessons: 'Lessons',
+    patterns: 'Patterns',
+    openThreads: 'Open Threads',
+};
+function slugify(text, tag) {
+    const base = tag ? `${tag}-${text}` : text;
+    return base
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 60) || 'concept';
+}
+function deduplicateSlug(slug, existing) {
+    if (!existing.has(slug)) {
+        existing.add(slug);
+        return slug;
+    }
+    let i = 2;
+    while (existing.has(`${slug}-${i}`))
+        i++;
+    const unique = `${slug}-${i}`;
+    existing.add(unique);
+    return unique;
+}
+function buildFrontmatter(fields) {
+    const lines = ['---'];
+    for (const [key, val] of Object.entries(fields)) {
+        if (val === undefined)
+            continue;
+        if (Array.isArray(val)) {
+            if (val.length > 0)
+                lines.push(`${key}: [${val.map(v => `"${v}"`).join(', ')}]`);
+        }
+        else {
+            // Quote strings that contain colons or special chars
+            const needsQuote = /[:#\[\]{}"']/.test(val) || val.includes('\n');
+            lines.push(`${key}: ${needsQuote ? `"${val.replace(/"/g, '\\"')}"` : val}`);
+        }
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+function buildConceptFile(bullet, totalDreams) {
+    const type = bullet.action === 'CONFLICT' ? 'conflict' : SECTION_TYPE[bullet.section];
+    const title = bullet.text.slice(0, 120);
+    const tags = bullet.tag ? [bullet.tag] : [];
+    if (bullet.action !== 'KEEP')
+        tags.push(bullet.action.toLowerCase());
+    const latestDate = bullet.sourceDates.length > 0
+        ? bullet.sourceDates[bullet.sourceDates.length - 1]
+        : new Date().toISOString().slice(0, 10);
+    const timestamp = `${latestDate}T00:00:00Z`;
+    const frontmatter = buildFrontmatter({
+        type,
+        title,
+        description: bullet.text,
+        tags,
+        timestamp,
+    });
+    const bodyLines = [];
+    bodyLines.push(`# ${title}`);
+    bodyLines.push('');
+    bodyLines.push(bullet.text);
+    bodyLines.push('');
+    bodyLines.push(`*${bullet.annotation}* · confidence: ${bullet.confidence}`);
+    if (bullet.action === 'CONFLICT' && bullet.conflictsWith) {
+        bodyLines.push('');
+        bodyLines.push('## Opposing claim');
+        bodyLines.push('');
+        bodyLines.push(`> ${bullet.conflictsWith.text}`);
+        bodyLines.push(`> — *${bullet.conflictsWith.date}*`);
+    }
+    bodyLines.push('');
+    bodyLines.push(`Source dreams: ${bullet.sourceDates.join(', ')}`);
+    return `${frontmatter}\n\n${bodyLines.join('\n')}\n`;
+}
+function buildSectionIndex(sectionLabel, concepts) {
+    const lines = [`# ${sectionLabel}`];
+    lines.push('');
+    if (concepts.length === 0) {
+        lines.push('*No concepts in this section yet.*');
+    }
+    else {
+        for (const c of concepts) {
+            lines.push(`* [${c.title}](${c.slug}.md)`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function buildRootIndex(sections, totalDreams, totalConcepts) {
+    const frontmatter = buildFrontmatter({ okf_version: OKF_VERSION });
+    const lines = [frontmatter, ''];
+    lines.push('# Aura Code — Knowledge Bundle');
+    lines.push('');
+    lines.push(`> OKF v${OKF_VERSION} · ${totalConcepts} concepts from ${totalDreams} dream(s)`);
+    lines.push('');
+    lines.push('This bundle is generated by [Aura Code](https://github.com/milodule3-debug/aura-code)\'s');
+    lines.push('dream reconciliation system. It contains the agent\'s accumulated knowledge about');
+    lines.push('this project — lessons learned, patterns observed, and open threads — in the');
+    lines.push('[Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md).');
+    lines.push('');
+    lines.push('Any OKF-compatible agent, tool, or viewer can consume this bundle.');
+    lines.push('');
+    for (const [dirName, concepts] of Object.entries(sections)) {
+        const label = dirName.charAt(0).toUpperCase() + dirName.slice(1).replace(/-/g, ' ');
+        lines.push(`# ${label}`);
+        lines.push('');
+        if (concepts.length === 0) {
+            lines.push('*None yet.*');
+        }
+        else {
+            for (const c of concepts) {
+                lines.push(`* [${c.title}](${dirName}/${c.slug}.md)`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function buildLog(totalDreams, totalConcepts, actionCounts) {
+    const now = new Date().toISOString().slice(0, 10);
+    const stats = Object.entries(actionCounts)
+        .map(([k, v]) => `${v} ${k}`)
+        .join(', ');
+    return [
+        '# Change Log',
+        '',
+        `## ${now}`,
+        '',
+        `Reconciled ${totalDreams} dream(s) into ${totalConcepts} concepts: ${stats}.`,
+        '',
+        'Generated by Aura Code · dream reconciliation · OKF v0.1.',
+        '',
+    ].join('\n');
+}
+/**
+ * Write an OKF v0.1 knowledge bundle from reconciled bullets.
+ *
+ * Called after reconciliation succeeds. Best-effort — if this fails,
+ * .reconciled.md is already written and the dream is safe.
+ *
+ * The bundle directory is wiped and rebuilt each time (it's a projection).
+ */
+function writeOkfBundle(bullets, totalDreams, projectRoot) {
+    const bundleRoot = path.join(projectRoot, KNOWLEDGE_DIR);
+    // Clean and recreate
+    if (fs.existsSync(bundleRoot)) {
+        fs.rmSync(bundleRoot, { recursive: true, force: true });
+    }
+    const sections = ['lessons', 'patterns', 'openThreads'];
+    const sectionConcepts = {};
+    const slugSets = {};
+    const actionCounts = {};
+    for (const section of sections) {
+        const dirName = SECTION_DIR[section];
+        const dirPath = path.join(bundleRoot, dirName);
+        fs.mkdirSync(dirPath, { recursive: true });
+        sectionConcepts[dirName] = [];
+        slugSets[dirName] = new Set();
+    }
+    // Write concept files
+    for (const bullet of bullets) {
+        const dirName = SECTION_DIR[bullet.section];
+        const dirPath = path.join(bundleRoot, dirName);
+        const rawSlug = slugify(bullet.text, bullet.tag);
+        const slug = deduplicateSlug(rawSlug, slugSets[dirName]);
+        const title = bullet.text.slice(0, 120);
+        const content = buildConceptFile(bullet, totalDreams);
+        fs.writeFileSync(path.join(dirPath, `${slug}.md`), content);
+        sectionConcepts[dirName].push({ slug, title });
+        actionCounts[bullet.action] = (actionCounts[bullet.action] ?? 0) + 1;
+    }
+    // Write section index files
+    for (const section of sections) {
+        const dirName = SECTION_DIR[section];
+        const dirPath = path.join(bundleRoot, dirName);
+        const indexContent = buildSectionIndex(SECTION_LABEL[section], sectionConcepts[dirName]);
+        fs.writeFileSync(path.join(dirPath, 'index.md'), indexContent);
+    }
+    // Write root index
+    const totalConcepts = bullets.length;
+    const rootIndex = buildRootIndex(sectionConcepts, totalDreams, totalConcepts);
+    fs.writeFileSync(path.join(bundleRoot, 'index.md'), rootIndex);
+    // Write log.md
+    const log = buildLog(totalDreams, totalConcepts, actionCounts);
+    fs.writeFileSync(path.join(bundleRoot, 'log.md'), log);
+    return bundleRoot;
+}
+//# sourceMappingURL=okf.js.map

package/dist/dream/okf.js.map

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

package/dist/dream/parser.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Dream parser — turns a dream markdown file back into a structured
+ * `ParsedDream` so reconciliation can dedupe, conflict-check, and project
+ * bullets across multiple days.
+ *
+ * Round-trips files written by `runDream()` in dream.ts. The contract with
+ * the writer is fixed: four sections in a fixed order, each containing
+ * bullets that may or may not start with a `[tag]` prefix. Bullets may be
+ * separated by blank lines, may have trailing whitespace, and may use
+ * either `-` or `*` markers — all real artifacts seen in production dreams.
+ *
+ * This is the FOUNDATION for memory reconciliation (CONFLICT/STRENGTHEN/
+ * SUPERSEDE/MERGE/KEEP/DROP). The reconciler reads many ParsedDreams,
+ * groups bullets by section, then asks the LLM to reconcile. The parser
+ * must be permissive on input (real dream files vary) and lossless on
+ * structure (every bullet kept, with its source date attached).
+ *
+ * What the parser does NOT do:
+ *   - Validate tag values. `[foo]` is fine even if it's not a known category.
+ *   - Drop empty sections — they round-trip as empty arrays.
+ *   - Interpret bullet semantics. That's the reconciler's job.
+ */
+/** A single bullet from a dream section, with its source for annotation. */
+export interface DreamBullet {
+    /** Optional `[tag]` prefix at the start of the bullet (e.g. "tooling"). */
+    tag?: string;
+    /** Bullet text with tag prefix and bullet marker stripped, whitespace trimmed. */
+    text: string;
+    /** Source dream date (YYYY-MM-DD), set by `parseDreamFile` from the filename. */
+    sourceDate: string;
+}
+/** A dream file parsed into its four canonical sections. */
+export interface ParsedDream {
+    /** YYYY-MM-DD from the filename (e.g. "2026-06-26"). */
+    date: string;
+    /** Absolute path the dream was read from. */
+    path: string;
+    lessons: DreamBullet[];
+    patterns: DreamBullet[];
+    openThreads: DreamBullet[];
+    /** "Tomorrow brief" — free prose, not bullets. Stored as one string or empty. */
+    tomorrowBrief: string;
+}
+/**
+ * Parse dream markdown content. Caller supplies the source date (preferred
+ * from filename for cross-OS consistency); falls back to the title line if
+ * the filename doesn't encode it.
+ */
+export declare function parseDreamMarkdown(md: string, sourceDate: string): Omit<ParsedDream, 'path'>;
+/** Read and parse a single dream file from disk. */
+export declare function parseDreamFile(filePath: string): ParsedDream;
+/**
+ * Load and parse every `YYYY-MM-DD.md` dream file in `<projectRoot>/dreams/`.
+ * Returned oldest-first (chronological), so reconciliation can iterate
+ * forward in time when reasoning about strengthening / conflicts.
+ *
+ * Ignores `.last.json` and `.reconciled.md` (handled separately).
+ * Returns `[]` if the dreams directory doesn't exist yet.
+ */
+export declare function loadExistingDreams(projectRoot: string): ParsedDream[];