aura-code 0.5.0 → 0.10.1

package/dist/rem/graph.d.ts

@@ -0,0 +1,72 @@
+/**
+ * `:rem` — parses the entity-tagged dream files under `<projectRoot>/dreams/`
+ * into a relations graph, so patterns across MANY nights become visible
+ * (not just the latest night's raw text, which is all the old `:rem` did).
+ *
+ * Parsing contract (must stay in sync with `src/dream/dream.ts`'s
+ * `buildConsolidationPrompt` — see that file's header comment too):
+ *   - Each dream file starts with `# Dream — <date>`.
+ *   - `## Lessons` and `## Open threads` sections contain bullets of the form
+ *     `- [tag] free text`. Tags are free-form, lowercase-by-convention
+ *     (e.g. [routing], [todo], [bug]) — NOT a fixed enum, so the parser must
+ *     not assume a closed tag set.
+ *   - `## Patterns` bullets are untagged prose; we don't graph these, but we
+ *     do count them as a per-night weight signal.
+ *
+ * Graph model: two node kinds —
+ *   - a `night` node per dream file (one per date)
+ *   - a `tag` node per distinct `[tag]` seen anywhere
+ * An edge connects a night to every tag that appeared in it, weighted by how
+ * many times that tag appeared that night. This is deliberately simple
+ * (bipartite, not a general knowledge graph) — it's meant to answer "what
+ * keeps coming up, and when", not model deep semantic relations.
+ */
+export interface TagOccurrence {
+    tag: string;
+    text: string;
+    /** Which section the bullet came from. */
+    section: 'lessons' | 'open-threads';
+}
+export interface DreamNight {
+    date: string;
+    file: string;
+    episodeCount: number;
+    occurrences: TagOccurrence[];
+    patternCount: number;
+}
+export interface GraphNode {
+    id: string;
+    kind: 'night' | 'tag';
+    /** For tag nodes: total occurrences across all nights. For night nodes: episodeCount. */
+    weight: number;
+}
+export interface GraphEdge {
+    night: string;
+    tag: string;
+    weight: number;
+}
+export interface RemGraph {
+    nights: DreamNight[];
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    /** Tags sorted by total occurrence, descending — the "what keeps coming up" view. */
+    topTags: {
+        tag: string;
+        count: number;
+        nights: number;
+    }[];
+}
+/**
+ * Parse a single dream markdown file into its structured night record.
+ * Tolerant of missing sections — a malformed or hand-edited file degrades to
+ * an empty occurrence list rather than throwing, since dream files are
+ * sometimes hand-edited (e.g. the 2026-06-22 provider-failure dream had only
+ * a one-line [error] lesson and no Patterns).
+ */
+export declare function parseDreamFile(filePath: string): DreamNight;
+/** Load and parse every `*.md` dream file in `<projectRoot>/dreams/`, oldest first. */
+export declare function loadDreamNights(projectRoot: string): DreamNight[];
+/** Build the bipartite night↔tag relations graph from a set of parsed nights. */
+export declare function buildRemGraph(nights: DreamNight[]): RemGraph;
+/** Convenience: load + build in one call for the given project root. */
+export declare function loadRemGraph(projectRoot: string): RemGraph;

package/dist/rem/graph.js

@@ -0,0 +1,139 @@
+"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.parseDreamFile = parseDreamFile;
+exports.loadDreamNights = loadDreamNights;
+exports.buildRemGraph = buildRemGraph;
+exports.loadRemGraph = loadRemGraph;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const TAG_BULLET = /^-\s*\[([^\]]+)\]\s*(.+)$/;
+const HEADER_META = /^>\s*(\d+)\s+episodes?\b/i;
+/**
+ * Parse a single dream markdown file into its structured night record.
+ * Tolerant of missing sections — a malformed or hand-edited file degrades to
+ * an empty occurrence list rather than throwing, since dream files are
+ * sometimes hand-edited (e.g. the 2026-06-22 provider-failure dream had only
+ * a one-line [error] lesson and no Patterns).
+ */
+function parseDreamFile(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const lines = raw.split('\n');
+    const base = path.basename(filePath, '.md');
+    const dateMatch = base.match(/\d{4}-\d{2}-\d{2}/);
+    const date = dateMatch ? dateMatch[0] : base;
+    let episodeCount = 0;
+    let section = 'other';
+    const occurrences = [];
+    let patternCount = 0;
+    for (const line of lines) {
+        const metaMatch = line.match(HEADER_META);
+        if (metaMatch)
+            episodeCount = parseInt(metaMatch[1], 10);
+        const h = line.match(/^##\s+(.+)$/);
+        if (h) {
+            const title = h[1].trim().toLowerCase();
+            if (title === 'lessons')
+                section = 'lessons';
+            else if (title === 'open threads')
+                section = 'open-threads';
+            else if (title === 'patterns')
+                section = 'patterns';
+            else
+                section = 'other';
+            continue;
+        }
+        if (section === 'patterns') {
+            if (/^-\s+/.test(line) && !/^-\s*none\s*$/i.test(line.trim()))
+                patternCount++;
+            continue;
+        }
+        if (section !== 'lessons' && section !== 'open-threads')
+            continue;
+        const m = line.match(TAG_BULLET);
+        if (!m)
+            continue;
+        const tag = m[1].trim().toLowerCase();
+        const text = m[2].trim();
+        if (!tag)
+            continue;
+        occurrences.push({ tag, text, section });
+    }
+    return { date, file: filePath, episodeCount, occurrences, patternCount };
+}
+/** Load and parse every `*.md` dream file in `<projectRoot>/dreams/`, oldest first. */
+function loadDreamNights(projectRoot) {
+    const dir = path.join(projectRoot, 'dreams');
+    let files = [];
+    try {
+        files = fs.readdirSync(dir).filter(f => f.endsWith('.md')).sort();
+    }
+    catch {
+        return [];
+    }
+    return files.map(f => parseDreamFile(path.join(dir, f)));
+}
+/** Build the bipartite night↔tag relations graph from a set of parsed nights. */
+function buildRemGraph(nights) {
+    const tagTotals = new Map();
+    const tagNightCounts = new Map();
+    const edges = [];
+    for (const night of nights) {
+        const perNightCounts = new Map();
+        for (const occ of night.occurrences) {
+            perNightCounts.set(occ.tag, (perNightCounts.get(occ.tag) ?? 0) + 1);
+        }
+        for (const [tag, count] of perNightCounts) {
+            edges.push({ night: night.date, tag, weight: count });
+            tagTotals.set(tag, (tagTotals.get(tag) ?? 0) + count);
+            if (!tagNightCounts.has(tag))
+                tagNightCounts.set(tag, new Set());
+            tagNightCounts.get(tag).add(night.date);
+        }
+    }
+    const nodes = [
+        ...nights.map(n => ({ id: n.date, kind: 'night', weight: n.episodeCount })),
+        ...[...tagTotals.entries()].map(([tag, weight]) => ({ id: tag, kind: 'tag', weight })),
+    ];
+    const topTags = [...tagTotals.entries()]
+        .map(([tag, count]) => ({ tag, count, nights: tagNightCounts.get(tag)?.size ?? 0 }))
+        .sort((a, b) => b.count - a.count || a.tag.localeCompare(b.tag));
+    return { nights, nodes, edges, topTags };
+}
+/** Convenience: load + build in one call for the given project root. */
+function loadRemGraph(projectRoot) {
+    return buildRemGraph(loadDreamNights(projectRoot));
+}
+//# sourceMappingURL=graph.js.map

package/dist/rem/graph.js.map

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

package/dist/rem/index.d.ts

@@ -0,0 +1,16 @@
+import { type RemGraph } from './graph.js';
+export interface RemRunResult {
+    graph: RemGraph;
+    terminalOutput: string;
+    htmlPath?: string;
+}
+/**
+ * Run `:rem` — load every dream file, build the relations graph, and render
+ * it for the terminal. If `writeHtml` is true, also write a standalone
+ * `dreams/rem.html` (overwritten each run — it's a current snapshot, not a
+ * dated artifact like dream/research/council files).
+ */
+export declare function runRem(opts: {
+    projectRoot: string;
+    writeHtml?: boolean;
+}): RemRunResult;

package/dist/rem/index.js

@@ -0,0 +1,60 @@
+"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.runRem = runRem;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const graph_js_1 = require("./graph.js");
+const render_terminal_js_1 = require("./render-terminal.js");
+const render_html_js_1 = require("./render-html.js");
+/**
+ * Run `:rem` — load every dream file, build the relations graph, and render
+ * it for the terminal. If `writeHtml` is true, also write a standalone
+ * `dreams/rem.html` (overwritten each run — it's a current snapshot, not a
+ * dated artifact like dream/research/council files).
+ */
+function runRem(opts) {
+    const graph = (0, graph_js_1.loadRemGraph)(opts.projectRoot);
+    const terminalOutput = (0, render_terminal_js_1.renderRemTerminal)(graph);
+    if (!opts.writeHtml) {
+        return { graph, terminalOutput };
+    }
+    const dir = path.join(opts.projectRoot, 'dreams');
+    fs.mkdirSync(dir, { recursive: true });
+    const htmlPath = path.join(dir, 'rem.html');
+    fs.writeFileSync(htmlPath, (0, render_html_js_1.wrapRemHtml)(graph));
+    return { graph, terminalOutput, htmlPath };
+}
+//# sourceMappingURL=index.js.map

package/dist/rem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rem/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,wBAcC;AAhCD,uCAAyB;AACzB,2CAA6B;AAC7B,yCAAyD;AACzD,6DAAyD;AACzD,qDAA+C;AAQ/C;;;;;GAKG;AACH,SAAgB,MAAM,CAAC,IAAkD;IACvE,MAAM,KAAK,GAAG,IAAA,uBAAY,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,cAAc,GAAG,IAAA,sCAAiB,EAAC,KAAK,CAAC,CAAC;IAEhD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC5C,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAA,4BAAW,EAAC,KAAK,CAAC,CAAC,CAAC;IAE/C,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AAC7C,CAAC"}

package/dist/rem/render-html.d.ts

@@ -0,0 +1,2 @@
+import type { RemGraph } from './graph.js';
+export declare function wrapRemHtml(graph: RemGraph): string;

package/dist/rem/render-html.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapRemHtml = wrapRemHtml;
+/**
+ * Renders a `RemGraph` as a standalone themed HTML file containing a real
+ * SVG node-and-edge graph (night nodes in a row, tag nodes arranged around
+ * them, edges weighted by occurrence count) plus a ranked tag list below it.
+ *
+ * Visually matches the warm/cream "Aura" theme used by :research / :council
+ * (see src/research/council.ts's wrapHtml) so output feels consistent
+ * across the agent's generated docs, with a dark-mode variant via
+ * prefers-color-scheme.
+ *
+ * Layout is a deterministic two-row bipartite layout (nights on top,
+ * tags on bottom, both sorted), NOT a physics-simulated force layout —
+ * this keeps the SVG static, dependency-free, and stable across renders of
+ * the same data (no jitter, no client-side JS layout pass required).
+ */
+function esc(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+const PALETTE = [
+    '#cc785c', '#5a9e6e', '#b15439', '#7a8ecc', '#c2a35a', '#9e6ecc', '#5aa3a8',
+];
+function colorFor(index) {
+    return PALETTE[index % PALETTE.length];
+}
+function buildSvg(graph) {
+    const nightIds = graph.nights.map(n => n.date);
+    const tagIds = graph.topTags.map(t => t.tag);
+    const width = Math.max(720, Math.max(nightIds.length, tagIds.length) * 110 + 80);
+    const nightY = 90;
+    const tagY = 330;
+    const height = tagY + 90;
+    const nightX = new Map();
+    nightIds.forEach((id, i) => {
+        const gap = nightIds.length > 1 ? (width - 120) / (nightIds.length - 1) : 0;
+        nightX.set(id, 60 + gap * i);
+    });
+    const tagX = new Map();
+    tagIds.forEach((id, i) => {
+        const gap = tagIds.length > 1 ? (width - 120) / (tagIds.length - 1) : 0;
+        tagX.set(id, 60 + gap * i);
+    });
+    const maxEpisodes = Math.max(...graph.nights.map(n => n.episodeCount), 1);
+    const maxTagCount = graph.topTags[0]?.count ?? 1;
+    const maxEdgeWeight = Math.max(...graph.edges.map(e => e.weight), 1);
+    const edgeLines = graph.edges.map(e => {
+        const x1 = nightX.get(e.night);
+        const y1 = nightY;
+        const x2 = tagX.get(e.tag);
+        const y2 = tagY;
+        if (x1 === undefined || x2 === undefined)
+            return '';
+        const strokeW = 1 + (e.weight / maxEdgeWeight) * 3.5;
+        const tagIdx = tagIds.indexOf(e.tag);
+        const color = colorFor(tagIdx);
+        return `<line x1="${x1}" y1="${y1 + 14}" x2="${x2}" y2="${y2 - 22}" stroke="${color}" stroke-width="${strokeW.toFixed(2)}" stroke-opacity="0.45" />`;
+    }).join('\n      ');
+    const nightNodes = nightIds.map(id => {
+        const night = graph.nights.find(n => n.date === id);
+        const r = 8 + (night.episodeCount / maxEpisodes) * 14;
+        const x = nightX.get(id);
+        return `
+      <g class="node night-node">
+        <circle cx="${x}" cy="${nightY}" r="${r.toFixed(1)}" class="night-circle" />
+        <text x="${x}" y="${nightY - r - 8}" class="night-label" text-anchor="middle">${esc(id)}</text>
+        <text x="${x}" y="${nightY + r + 16}" class="night-sub" text-anchor="middle">${night.episodeCount} ep</text>
+      </g>`;
+    }).join('');
+    const tagNodes = tagIds.map((id, i) => {
+        const t = graph.topTags[i];
+        const r = 6 + (t.count / maxTagCount) * 16;
+        const x = tagX.get(id);
+        const color = colorFor(i);
+        return `
+      <g class="node tag-node">
+        <circle cx="${x}" cy="${tagY}" r="${r.toFixed(1)}" fill="${color}" fill-opacity="0.85" />
+        <text x="${x}" y="${tagY + r + 18}" class="tag-label" text-anchor="middle" fill="${color}">[${esc(id)}]</text>
+        <text x="${x}" y="${tagY + r + 34}" class="tag-sub" text-anchor="middle">${t.count}×</text>
+      </g>`;
+    }).join('');
+    return `<svg viewBox="0 0 ${width} ${height}" xmlns="http://www.w3.org/2000/svg" class="rem-graph">
+  <g class="edges">
+      ${edgeLines}
+  </g>
+  <g class="nights">${nightNodes}
+  </g>
+  <g class="tags">${tagNodes}
+  </g>
+</svg>`;
+}
+function buildTopTagsTable(graph) {
+    const rows = graph.topTags.slice(0, 20).map((t, i) => {
+        const color = colorFor(i);
+        const pct = graph.topTags[0] ? Math.round((t.count / graph.topTags[0].count) * 100) : 0;
+        return `<tr>
+      <td class="tag-cell"><span class="dot" style="background:${color}"></span>[${esc(t.tag)}]</td>
+      <td><div class="bar-track"><div class="bar-fill" style="width:${pct}%;background:${color}"></div></div></td>
+      <td class="num-cell">${t.count}</td>
+      <td class="num-cell">${t.nights}</td>
+    </tr>`;
+    }).join('\n');
+    return `<table class="tag-table">
+    <thead><tr><th>Tag</th><th>Frequency</th><th>Count</th><th>Nights</th></tr></thead>
+    <tbody>${rows}</tbody>
+  </table>`;
+}
+function wrapRemHtml(graph) {
+    const dateRange = graph.nights.length
+        ? `${graph.nights[0].date} → ${graph.nights[graph.nights.length - 1].date}`
+        : '—';
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Rem — Aura Dream Graph</title>
+<style>
+  :root {
+    --bg: #fdf6f0; --card: #fffaf5; --text: #3e2f24; --muted: #8a7768;
+    --accent: #cc785c; --accent-2: #5a9e6e; --border: #e8d5c8;
+    --code-bg: #f4ede6; --hr: #e0cebc;
+    --shadow: 0 2px 12px rgba(62,47,36,0.06); --radius: 12px;
+    --serif: 'Georgia', 'Times New Roman', serif;
+    --sans: 'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif;
+    --mono: 'JetBrains Mono', 'Fira Code', 'Consolas', monospace;
+  }
+  @media (prefers-color-scheme: dark) {
+    :root {
+      --bg: #1e1b18; --card: #26221e; --text: #ede0cc; --muted: #9e8e80;
+      --accent: #e08a6e; --accent-2: #6db880; --border: #3a322a;
+      --code-bg: #2c2722; --hr: #3a322a;
+      --shadow: 0 2px 12px rgba(0,0,0,0.25);
+    }
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body { background: var(--bg); color: var(--text); font-family: var(--serif); line-height: 1.7; font-size: 17px; }
+  .container { max-width: 980px; margin: 0 auto; padding: 3rem 1.5rem 5rem; }
+  .hero { text-align: center; padding: 2.5rem 0 2rem; border-bottom: 2px solid var(--border); margin-bottom: 2.5rem; }
+  .hero .badge { display: inline-block; background: var(--accent); color: #fff; font-family: var(--sans); font-size: 0.7rem; font-weight: 700; letter-spacing: 0.12em; text-transform: uppercase; padding: 0.3em 1em; border-radius: 100px; margin-bottom: 1.25rem; }
+  .hero h1 { font-family: var(--sans); font-size: 2.2rem; font-weight: 700; line-height: 1.25; letter-spacing: -0.02em; margin-bottom: 0.5rem; }
+  .hero .meta { font-family: var(--sans); font-size: 0.85rem; color: var(--muted); }
+  .card { background: var(--card); border: 1px solid var(--border); border-radius: var(--radius); box-shadow: var(--shadow); padding: 2rem 2.5rem; margin-bottom: 2rem; }
+  @media (max-width: 720px) { .card { padding: 1.25rem; border-radius: 8px; } .hero h1 { font-size: 1.6rem; } .container { padding: 1.5rem 0.75rem 3rem; } }
+  .card h2 { font-family: var(--sans); font-size: 1.3rem; color: var(--accent); border-bottom: 2px solid var(--border); padding-bottom: 0.5rem; margin-bottom: 1.25rem; }
+  .rem-graph { width: 100%; height: auto; display: block; }
+  .night-circle { fill: var(--card); stroke: var(--accent); stroke-width: 2; }
+  .night-label { font-family: var(--sans); font-size: 12px; font-weight: 700; fill: var(--text); }
+  .night-sub, .tag-sub { font-family: var(--sans); font-size: 10px; fill: var(--muted); }
+  .tag-label { font-family: var(--sans); font-size: 11px; font-weight: 600; }
+  .tag-table { width: 100%; border-collapse: collapse; font-family: var(--sans); font-size: 0.9rem; }
+  .tag-table th { text-align: left; color: var(--muted); font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.06em; padding: 0.5rem 0.75rem; border-bottom: 2px solid var(--border); }
+  .tag-table td { padding: 0.55rem 0.75rem; border-bottom: 1px solid var(--hr); vertical-align: middle; }
+  .tag-cell { white-space: nowrap; font-weight: 600; }
+  .dot { display: inline-block; width: 9px; height: 9px; border-radius: 50%; margin-right: 0.5em; }
+  .num-cell { text-align: right; color: var(--muted); font-variant-numeric: tabular-nums; }
+  .bar-track { background: var(--code-bg); border-radius: 6px; height: 8px; overflow: hidden; min-width: 100px; }
+  .bar-fill { height: 100%; border-radius: 6px; }
+  .footer { text-align: center; margin-top: 1rem; font-family: var(--sans); font-size: 0.8rem; color: var(--muted); opacity: 0.7; }
+  .empty { text-align: center; color: var(--muted); font-family: var(--sans); padding: 3rem 1rem; }
+</style>
+</head>
+<body>
+<div class="container">
+  <header class="hero">
+    <div class="badge">Aura &middot; Rem</div>
+    <h1>Dream Relations Graph</h1>
+    <div class="meta">${esc(dateRange)} &middot; ${graph.nights.length} night(s) &middot; ${graph.topTags.length} tag(s)</div>
+  </header>
+
+  ${graph.nights.length === 0
+        ? '<div class="card"><p class="empty">No dreams yet. Run :dream after some work, then :rem --html again.</p></div>'
+        : `<section class="card">
+    <h2>Nights &middot; Tags</h2>
+    ${buildSvg(graph)}
+  </section>
+
+  <section class="card">
+    <h2>What keeps coming up</h2>
+    ${buildTopTagsTable(graph)}
+  </section>`}
+
+  <footer class="footer"><p>Generated by Aura Code &middot; :rem &middot; parsed from dreams/*.md</p></footer>
+</div>
+</body>
+</html>`;
+}
+//# sourceMappingURL=render-html.js.map

package/dist/rem/render-html.js.map

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

package/dist/rem/render-terminal.d.ts

@@ -0,0 +1,4 @@
+import type { RemGraph } from './graph.js';
+export declare function renderRemTerminal(graph: RemGraph, opts?: {
+    recentNights?: number;
+}): string;

package/dist/rem/render-terminal.js

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderRemTerminal = renderRemTerminal;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Renders a `RemGraph` as terminal text using Aura's existing warm palette
+ * (the same hex set used throughout src/cli/index.ts) so `:rem` looks native
+ * next to `:dream`, `:design`, etc.
+ *
+ * Layout, top to bottom:
+ *   1. A timeline strip — one row per night, oldest→newest, with a small bar
+ *      sized by episode count.
+ *   2. "What keeps coming up" — top tags ranked by total occurrence, with a
+ *      horizontal bar and the count of distinct nights it appeared in.
+ *   3. Per-night detail — for the most recent N nights, which tags fired.
+ *
+ * Deliberately not a literal node-and-edge ASCII graph (boxes-and-arrows in
+ * a terminal degrade badly past ~6 nodes); a ranked/timeline view answers
+ * the actual question ("what keeps coming up, and when") more legibly than
+ * a force-directed layout would in 80 columns.
+ */
+const C = {
+    heading: chalk_1.default.hex('#cc785c').bold,
+    text: chalk_1.default.hex('#ede0cc'),
+    muted: chalk_1.default.hex('#8a7768'),
+    dim: chalk_1.default.hex('#4e3d30'),
+    good: chalk_1.default.hex('#5a9e6e'),
+    warn: chalk_1.default.hex('#b15439'),
+};
+const BAR_CHAR = '█';
+const BAR_WIDTH = 24;
+function bar(value, max, width = BAR_WIDTH) {
+    if (max <= 0)
+        return '';
+    const filled = Math.max(1, Math.round((value / max) * width));
+    return BAR_CHAR.repeat(Math.min(filled, width));
+}
+function renderRemTerminal(graph, opts = {}) {
+    const recentNights = opts.recentNights ?? 5;
+    const lines = [];
+    if (graph.nights.length === 0) {
+        return C.muted('\n  No dreams yet. Run :dream after some work.\n');
+    }
+    lines.push('');
+    lines.push(C.heading(`  Rem — ${graph.nights.length} night(s), ${graph.topTags.length} recurring tag(s)`));
+    lines.push('');
+    // ── 1. Timeline strip ──────────────────────────────────────────────────
+    lines.push(C.muted('  Timeline'));
+    const maxEpisodes = Math.max(...graph.nights.map(n => n.episodeCount), 1);
+    for (const night of graph.nights) {
+        const tagCount = new Set(night.occurrences.map(o => o.tag)).size;
+        lines.push(`  ${C.text(night.date)}  ${C.dim(bar(night.episodeCount, maxEpisodes, 16))}  ` +
+            C.muted(`${night.episodeCount} ep · ${tagCount} tag(s)`));
+    }
+    lines.push('');
+    // ── 2. Top tags ranked by total occurrence ─────────────────────────────
+    lines.push(C.muted('  What keeps coming up'));
+    const maxCount = graph.topTags[0]?.count ?? 1;
+    for (const t of graph.topTags.slice(0, 12)) {
+        const label = `[${t.tag}]`.padEnd(20);
+        lines.push(`  ${C.heading(label)} ${C.text(bar(t.count, maxCount))} ` +
+            C.muted(`${t.count}× across ${t.nights} night(s)`));
+    }
+    lines.push('');
+    // ── 3. Per-night detail for the most recent nights ─────────────────────
+    const recent = graph.nights.slice(-recentNights).reverse();
+    lines.push(C.muted(`  Recent detail (last ${recent.length})`));
+    for (const night of recent) {
+        lines.push(`  ${C.heading(night.date)}`);
+        if (night.occurrences.length === 0) {
+            lines.push(`    ${C.muted('(no tagged lessons/threads)')}`);
+            continue;
+        }
+        const byTag = new Map();
+        for (const occ of night.occurrences) {
+            if (!byTag.has(occ.tag))
+                byTag.set(occ.tag, []);
+            byTag.get(occ.tag).push(occ.text);
+        }
+        for (const [tag, texts] of byTag) {
+            const sample = texts[0].length > 72 ? texts[0].slice(0, 69) + '...' : texts[0];
+            const more = texts.length > 1 ? C.muted(` (+${texts.length - 1} more)`) : '';
+            lines.push(`    ${C.warn(`[${tag}]`)} ${C.text(sample)}${more}`);
+        }
+    }
+    lines.push('');
+    lines.push(C.muted('  :rem --html  writes a visual graph to dreams/rem.html'));
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=render-terminal.js.map

package/dist/rem/render-terminal.js.map

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

package/dist/repl/queue.d.ts

@@ -0,0 +1,22 @@
+import type { LLMProvider } from '../providers/types.js';
+import type { ProjectContext } from '../agent/context.js';
+import { createTerminalDisplay } from '../cli/display.js';
+import { PermissionSystem } from '../safety/permissions.js';
+export interface QueueItem {
+    id: string;
+    prompt: string;
+    createdAt: number;
+    status: 'pending' | 'running' | 'done' | 'failed';
+}
+export declare function loadQueue(): QueueItem[];
+export declare function addToQueue(prompt: string): QueueItem;
+export declare function removeFromQueue(index: number): QueueItem | null;
+export declare function clearQueue(): number;
+export interface QueueRunResult {
+    success: boolean;
+    output: string;
+    turns: number;
+    toolCalls: number;
+}
+export declare function runQueueItem(index: number, provider: LLMProvider, ctx: ProjectContext, permissions: PermissionSystem, display: ReturnType<typeof createTerminalDisplay>): Promise<QueueRunResult | null>;
+export declare function formatQueue(items: QueueItem[]): string;