donguri-journal 0.1.0

package/dist/originals/store.js

@@ -0,0 +1,185 @@
+/**
+ * Original-artifact store.
+ *
+ * The two-layer design keeps originals verbatim and the vector index disposable.
+ * When the front-end LLM captures media, it sends the original bytes over MCP and
+ * the server persists them here, then points `original_ref` at the saved object.
+ * The server never interprets the bytes (no vision/audio models) — it only stores
+ * and serves them so the LLM can re-view / re-extract later.
+ *
+ * Objects are addressed purely by content hash, so identical bytes always map to
+ * the same ref regardless of the supplied filename/MIME. The MIME type is kept as
+ * separate sidecar metadata rather than baked into the ref.
+ *
+ * The backend is pluggable behind `OriginalStore`. The default is a local
+ * directory; an Eagle backend can be added as an opt-in later without touching
+ * callers.
+ */
+import { createHash } from "node:crypto";
+import { existsSync } from "node:fs";
+import { mkdir, readFile, readdir, stat, unlink, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+const EXT_TO_MIME = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    svg: "image/svg+xml",
+    bmp: "image/bmp",
+    tiff: "image/tiff",
+    avif: "image/avif",
+    heic: "image/heic",
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    ogg: "audio/ogg",
+    flac: "audio/flac",
+    aac: "audio/aac",
+    m4a: "audio/mp4",
+    weba: "audio/webm",
+    mp4: "video/mp4",
+    mov: "video/quicktime",
+    webm: "video/webm",
+    pdf: "application/pdf",
+    txt: "text/plain",
+    md: "text/markdown",
+    json: "application/json",
+};
+/** Resolve a MIME type from the explicit value, else the filename extension. */
+function resolveMime(input) {
+    if (input.mime && input.mime.length > 0)
+        return input.mime.toLowerCase();
+    if (input.filename) {
+        const dot = input.filename.lastIndexOf(".");
+        if (dot >= 0) {
+            const ext = input.filename
+                .slice(dot + 1)
+                .toLowerCase()
+                .replace(/[^a-z0-9]/g, "");
+            const mime = EXT_TO_MIME[ext];
+            if (mime)
+                return mime;
+        }
+    }
+    return undefined;
+}
+/**
+ * Content-addressed store under a local directory. Each original is stored as a
+ * blob named `<sha256>` plus a `<sha256>.json` sidecar holding its MIME type and
+ * original filename.
+ */
+export class LocalDirStore {
+    kind = "local";
+    #baseDir;
+    constructor(baseDir) {
+        this.#baseDir = resolve(baseDir);
+    }
+    async save(input) {
+        const sha = createHash("sha256").update(input.data).digest("hex");
+        const mime = resolveMime(input);
+        const blobPath = join(this.#baseDir, sha);
+        const metaPath = join(this.#baseDir, `${sha}.json`);
+        if (!existsSync(blobPath)) {
+            await mkdir(this.#baseDir, { recursive: true });
+            await writeFile(blobPath, input.data);
+        }
+        // Create the sidecar, or backfill fields a previous save left empty (e.g. a
+        // first save without a MIME followed by one that knows it).
+        let existing = {};
+        if (existsSync(metaPath)) {
+            try {
+                existing = JSON.parse(await readFile(metaPath, "utf8"));
+            }
+            catch {
+                // Corrupt sidecar — rewrite it from the current input.
+            }
+        }
+        const merged = {
+            mime: existing.mime ?? mime,
+            filename: existing.filename ?? input.filename,
+        };
+        if (!existsSync(metaPath) ||
+            merged.mime !== existing.mime ||
+            merged.filename !== existing.filename) {
+            await mkdir(this.#baseDir, { recursive: true });
+            await writeFile(metaPath, JSON.stringify(merged));
+        }
+        return { ref: `local:${sha}`, bytes: input.data.length, mime: merged.mime };
+    }
+    async get(ref) {
+        const prefix = "local:";
+        if (!ref.startsWith(prefix))
+            return null;
+        const sha = ref.slice(prefix.length);
+        // Pure hex sha256: also rules out path traversal.
+        if (!/^[a-f0-9]{64}$/.test(sha))
+            return null;
+        const blobPath = join(this.#baseDir, sha);
+        if (!blobPath.startsWith(this.#baseDir) || !existsSync(blobPath))
+            return null;
+        const data = await readFile(blobPath);
+        let mime;
+        const metaPath = join(this.#baseDir, `${sha}.json`);
+        if (existsSync(metaPath)) {
+            try {
+                const meta = JSON.parse(await readFile(metaPath, "utf8"));
+                if (typeof meta.mime === "string")
+                    mime = meta.mime;
+            }
+            catch {
+                // Corrupt sidecar — fall back to no MIME rather than failing the read.
+            }
+        }
+        return { data, mime, path: blobPath };
+    }
+    async delete(ref) {
+        const prefix = "local:";
+        if (!ref.startsWith(prefix))
+            return false;
+        const sha = ref.slice(prefix.length);
+        if (!/^[a-f0-9]{64}$/.test(sha))
+            return false;
+        const blobPath = join(this.#baseDir, sha);
+        const metaPath = join(this.#baseDir, `${sha}.json`);
+        let removed = false;
+        if (existsSync(blobPath)) {
+            await unlink(blobPath);
+            removed = true;
+        }
+        if (existsSync(metaPath)) {
+            await unlink(metaPath);
+        }
+        return removed;
+    }
+    async stats() {
+        if (!existsSync(this.#baseDir))
+            return { count: 0, bytes: 0 };
+        const names = await readdir(this.#baseDir);
+        let count = 0;
+        let bytes = 0;
+        for (const name of names) {
+            if (name.endsWith(".json"))
+                continue;
+            const info = await stat(join(this.#baseDir, name));
+            if (info.isFile()) {
+                count += 1;
+                bytes += info.size;
+            }
+        }
+        return { count, bytes };
+    }
+}
+/**
+ * Choose an original store. Today this is always the local directory; an Eagle
+ * backend (when JOURNAL_EAGLE_API is set) can be slotted in here later.
+ */
+export function createOriginalStore(baseDir) {
+    if (baseDir && baseDir.length > 0) {
+        return new LocalDirStore(baseDir);
+    }
+    const fromEnv = process.env.JOURNAL_ORIGINALS_DIR;
+    const dir = fromEnv && fromEnv.length > 0 ? fromEnv : join(homedir(), ".journal-mcp", "originals");
+    return new LocalDirStore(dir);
+}
+//# sourceMappingURL=store.js.map

package/dist/originals/store.js.map

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

package/dist/review/charts.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tiny dependency-free SVG bar-chart builder, rasterized to PNG via sharp.
+ *
+ * Reviews return rendered PNG charts (plus structured data and presentation
+ * hints) so the front-end LLM can present richly — markdown alone is not enough.
+ * sharp is imported lazily so the server starts even where it is unavailable;
+ * callers fall back to data-only output if rendering throws.
+ */
+export interface BarDatum {
+    label: string;
+    value: number;
+}
+/** Build a vertical bar chart as an SVG string. */
+export declare function barChartSvg(title: string, data: BarDatum[]): string;
+/** Rasterize an SVG string to a PNG buffer using sharp (lazy-loaded). */
+export declare function renderPng(svg: string): Promise<Buffer>;

package/dist/review/charts.js

@@ -0,0 +1,69 @@
+/**
+ * Tiny dependency-free SVG bar-chart builder, rasterized to PNG via sharp.
+ *
+ * Reviews return rendered PNG charts (plus structured data and presentation
+ * hints) so the front-end LLM can present richly — markdown alone is not enough.
+ * sharp is imported lazily so the server starts even where it is unavailable;
+ * callers fall back to data-only output if rendering throws.
+ */
+const COLORS = {
+    bg: "#ffffff",
+    bar: "#4f46e5",
+    axis: "#9ca3af",
+    text: "#1f2937",
+    subtext: "#6b7280",
+};
+function esc(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/** Build a vertical bar chart as an SVG string. */
+export function barChartSvg(title, data) {
+    const marginTop = 40;
+    const marginBottom = 64;
+    const marginLeft = 44;
+    const marginRight = 16;
+    const n = Math.max(data.length, 1);
+    const slot = Math.max(18, Math.min(56, Math.floor(640 / n)));
+    const barW = Math.max(8, slot - 10);
+    const plotW = n * slot;
+    const plotH = 200;
+    // Width must fit both the bars and the (left-aligned) title; ~9.5px/char at 15px bold.
+    const barsWidth = marginLeft + plotW + marginRight;
+    const titleWidth = marginLeft + Math.ceil(title.length * 9.5) + marginRight;
+    const width = Math.max(barsWidth, titleWidth);
+    const height = marginTop + plotH + marginBottom;
+    const maxValue = Math.max(1, ...data.map((d) => d.value));
+    const baselineY = marginTop + plotH;
+    const parts = [];
+    parts.push(`<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" font-family="system-ui, -apple-system, Segoe UI, sans-serif">`);
+    parts.push(`<rect width="${width}" height="${height}" fill="${COLORS.bg}"/>`);
+    parts.push(`<text x="${marginLeft}" y="24" font-size="15" font-weight="600" fill="${COLORS.text}">${esc(title)}</text>`);
+    // y-axis max label + baseline
+    parts.push(`<text x="${marginLeft - 8}" y="${marginTop + 4}" font-size="11" text-anchor="end" fill="${COLORS.subtext}">${maxValue}</text>`);
+    parts.push(`<line x1="${marginLeft}" y1="${baselineY}" x2="${marginLeft + plotW}" y2="${baselineY}" stroke="${COLORS.axis}" stroke-width="1"/>`);
+    data.forEach((d, i) => {
+        const h = Math.round((d.value / maxValue) * plotH);
+        const x = marginLeft + i * slot + (slot - barW) / 2;
+        const y = baselineY - h;
+        parts.push(`<rect x="${x}" y="${y}" width="${barW}" height="${h}" rx="2" fill="${COLORS.bar}"/>`);
+        if (d.value > 0) {
+            parts.push(`<text x="${x + barW / 2}" y="${y - 4}" font-size="10" text-anchor="middle" fill="${COLORS.subtext}">${d.value}</text>`);
+        }
+        const cx = x + barW / 2;
+        const ly = baselineY + 14;
+        parts.push(`<text x="${cx}" y="${ly}" font-size="10" text-anchor="end" fill="${COLORS.text}" transform="rotate(-45 ${cx} ${ly})">${esc(d.label)}</text>`);
+    });
+    parts.push("</svg>");
+    return parts.join("");
+}
+/** Rasterize an SVG string to a PNG buffer using sharp (lazy-loaded). */
+export async function renderPng(svg) {
+    const sharpModule = await import("sharp");
+    const sharp = sharpModule.default;
+    return sharp(Buffer.from(svg)).png().toBuffer();
+}
+//# sourceMappingURL=charts.js.map

package/dist/review/charts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charts.js","sourceRoot":"","sources":["../../src/review/charts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,IAAgB;IACzD,MAAM,SAAS,GAAG,EAAE,CAAC;IACrB,MAAM,YAAY,GAAG,EAAE,CAAC;IACxB,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,MAAM,WAAW,GAAG,EAAE,CAAC;IAEvB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC;IACvB,MAAM,KAAK,GAAG,GAAG,CAAC;IAClB,uFAAuF;IACvF,MAAM,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,WAAW,CAAC;IACnD,MAAM,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,WAAW,CAAC;IAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;IAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;IAEpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CACR,kDAAkD,KAAK,aAAa,MAAM,kBAAkB,KAAK,IAAI,MAAM,iEAAiE,CAC7K,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,aAAa,MAAM,WAAW,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CACR,YAAY,UAAU,mDAAmD,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,SAAS,CAC7G,CAAC;IACF,8BAA8B;IAC9B,KAAK,CAAC,IAAI,CACR,YAAY,UAAU,GAAG,CAAC,QAAQ,SAAS,GAAG,CAAC,4CAA4C,MAAM,CAAC,OAAO,KAAK,QAAQ,SAAS,CAChI,CAAC;IACF,KAAK,CAAC,IAAI,CACR,aAAa,UAAU,SAAS,SAAS,SAAS,UAAU,GAAG,KAAK,SAAS,SAAS,aAAa,MAAM,CAAC,IAAI,sBAAsB,CACrI,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CACR,YAAY,CAAC,QAAQ,CAAC,YAAY,IAAI,aAAa,CAAC,kBAAkB,MAAM,CAAC,GAAG,KAAK,CACtF,CAAC;QACF,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CACR,YAAY,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,+CAA+C,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,SAAS,CACxH,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QACxB,MAAM,EAAE,GAAG,SAAS,GAAG,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CACR,YAAY,EAAE,QAAQ,EAAE,4CAA4C,MAAM,CAAC,IAAI,2BAA2B,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAC9I,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC;IAClC,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;AAClD,CAAC"}

package/dist/review/patterns.d.ts

@@ -0,0 +1,33 @@
+/**
+ * surface_patterns — find recurring themes ("you wrote something similar
+ * before"). For each recent entry we look for semantically similar OLDER
+ * entries; clusters of echoes are returned as structured data + a PNG chart of
+ * the strongest echoes + presentation hints. The front-end LLM judges which
+ * echoes are meaningful and weaves the narrative.
+ */
+import type { Entry, JournalStore, RecallHit } from "../db/store.js";
+export interface SurfacePatternsInput {
+    /** How far back to treat entries as "recent". Default 30 days. */
+    lookback_days?: number;
+    /** Max recent entries to examine. Default 50. */
+    max_recent?: number;
+    /** Neighbours to consider per recent entry. Default 5. */
+    per_entry?: number;
+    /** Distance cutoff; only echoes at or below this are kept. Default 1.3. */
+    max_distance?: number;
+}
+export interface Echo {
+    recent: Pick<Entry, "id" | "body" | "created_at" | "occurred_at" | "tags">;
+    related: Array<Pick<RecallHit, "id" | "body" | "created_at" | "distance">>;
+}
+export interface PatternsOutput {
+    structured: {
+        lookback_days: number;
+        max_distance: number;
+        examined: number;
+        echoes: Echo[];
+    };
+    chartPng: Buffer | null;
+    presentation_hints: Record<string, unknown>;
+}
+export declare function surfacePatterns(store: JournalStore, input: SurfacePatternsInput): Promise<PatternsOutput>;

package/dist/review/patterns.js

@@ -0,0 +1,73 @@
+import { barChartSvg, renderPng } from "./charts.js";
+function shortLabel(body) {
+    const oneLine = body.replace(/\s+/g, " ").trim();
+    return oneLine.length > 18 ? `${oneLine.slice(0, 17)}…` : oneLine;
+}
+export async function surfacePatterns(store, input) {
+    const lookbackDays = Math.min(Math.max(Math.trunc(input.lookback_days ?? 30), 1), 3650);
+    const maxRecent = Math.min(Math.max(Math.trunc(input.max_recent ?? 50), 1), 200);
+    const perEntry = Math.min(Math.max(Math.trunc(input.per_entry ?? 5), 1), 20);
+    const maxDistance = input.max_distance ?? 1.3;
+    const since = new Date(Date.now() - lookbackDays * 86_400_000).toISOString();
+    const recent = store.query({ since, time_field: "created_at", limit: maxRecent });
+    const echoes = [];
+    for (const entry of recent) {
+        // Over-fetch: self and newer entries can crowd the top neighbours, so we
+        // need a larger candidate pool to still find `perEntry` OLDER echoes.
+        const candidateK = Math.min(100, perEntry * 4 + 5);
+        const neighbours = await store.recall(entry.body, candidateK);
+        const related = neighbours
+            .filter((h) => h.id !== entry.id && h.created_at < entry.created_at && h.distance <= maxDistance)
+            .slice(0, perEntry)
+            .map((h) => ({ id: h.id, body: h.body, created_at: h.created_at, distance: h.distance }));
+        if (related.length > 0) {
+            echoes.push({
+                recent: {
+                    id: entry.id,
+                    body: entry.body,
+                    created_at: entry.created_at,
+                    occurred_at: entry.occurred_at,
+                    tags: entry.tags,
+                },
+                related,
+            });
+        }
+    }
+    echoes.sort((a, b) => b.related.length - a.related.length);
+    let chartPng = null;
+    if (echoes.length > 0) {
+        try {
+            const svg = barChartSvg("Recurring echoes (recent entries with past matches)", echoes
+                .slice(0, 12)
+                .map((e) => ({ label: shortLabel(e.recent.body), value: e.related.length })));
+            chartPng = await renderPng(svg);
+        }
+        catch (err) {
+            console.error("[donguri-journal] patterns chart render failed:", err);
+            chartPng = null;
+        }
+    }
+    const presentation_hints = {
+        headline: echoes.length > 0
+            ? `Found ${echoes.length} recent ${echoes.length === 1 ? "entry that echoes" : "entries that echo"} earlier ones`
+            : "No clear recurring themes in this window",
+        interpretation: "Each echo is a candidate recurrence, not a certainty — judge relevance yourself before " +
+            "presenting. Distances are L2 (smaller = closer); ~<1.2 is usually a strong match.",
+        tone: "Curious and gentle: 'you've returned to this before…'. Avoid over-claiming.",
+        chart: chartPng
+            ? "A PNG chart of the strongest echoes is attached."
+            : "No chart rendered (no echoes, or rendering unavailable).",
+        next: "Use query_entries or recall_related to pull full context for any echo worth discussing.",
+    };
+    return {
+        structured: {
+            lookback_days: lookbackDays,
+            max_distance: maxDistance,
+            examined: recent.length,
+            echoes,
+        },
+        chartPng,
+        presentation_hints,
+    };
+}
+//# sourceMappingURL=patterns.js.map

package/dist/review/patterns.js.map

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

package/dist/review/review.d.ts

@@ -0,0 +1,30 @@
+/**
+ * generate_review — pull entries in a time window and return rich aggregates:
+ * structured data + a rendered PNG activity chart + presentation hints, so the
+ * front-end LLM can present a reflective review (not just a markdown list).
+ */
+import { type DayCount, type JournalStore, type SourceKindCount, type TagCount } from "../db/store.js";
+import { type ReviewPeriod, type ReviewWindow } from "./window.js";
+export interface GenerateReviewInput {
+    period?: ReviewPeriod;
+    anchor?: string;
+    since?: string;
+    until?: string;
+    time_field?: "created_at" | "occurred_at";
+}
+export interface ReviewStructured {
+    window: ReviewWindow;
+    time_field: "created_at" | "occurred_at";
+    total: number;
+    busiest_day: DayCount | null;
+    by_day: DayCount[];
+    by_source_kind: SourceKindCount[];
+    top_tags: TagCount[];
+}
+export interface ReviewOutput {
+    structured: ReviewStructured;
+    /** PNG chart of entries per day, if rendering succeeded. */
+    chartPng: Buffer | null;
+    presentation_hints: Record<string, unknown>;
+}
+export declare function generateReview(store: JournalStore, input: GenerateReviewInput): Promise<ReviewOutput>;

package/dist/review/review.js

@@ -0,0 +1,82 @@
+/**
+ * generate_review — pull entries in a time window and return rich aggregates:
+ * structured data + a rendered PNG activity chart + presentation hints, so the
+ * front-end LLM can present a reflective review (not just a markdown list).
+ */
+import { normalizeTimestamp, } from "../db/store.js";
+import { barChartSvg, renderPng } from "./charts.js";
+import { computeWindow } from "./window.js";
+export async function generateReview(store, input) {
+    const timeField = input.time_field === "occurred_at" ? "occurred_at" : "created_at";
+    // A custom window needs both bounds; one-sided input must fail loudly rather
+    // than silently falling back to `period` and returning a different range.
+    const { since, until } = input;
+    if ((since === undefined) !== (until === undefined)) {
+        throw new Error("A custom window requires both `since` and `until` (or neither — use `period`).");
+    }
+    let window;
+    if (since !== undefined && until !== undefined) {
+        const s = normalizeTimestamp(since);
+        const u = normalizeTimestamp(until);
+        if (s > u) {
+            throw new Error(`Invalid custom window: since (${s}) is after until (${u}).`);
+        }
+        window = { since: s, until: u, label: `${s}–${u} (custom)` };
+    }
+    else {
+        window = computeWindow(input.period ?? "week", input.anchor);
+    }
+    const filter = {
+        since: window.since,
+        until: window.until,
+        time_field: timeField,
+    };
+    const byDay = store.aggregateByDay(filter);
+    const total = store.countInWindow(filter);
+    const bySourceKind = store.aggregateBySourceKind(filter);
+    const topTags = store.aggregateTags(filter, 10);
+    const busiestDay = byDay.reduce((best, d) => (best === null || d.count > best.count ? d : best), null);
+    const structured = {
+        window,
+        time_field: timeField,
+        total,
+        busiest_day: busiestDay,
+        by_day: byDay,
+        by_source_kind: bySourceKind,
+        top_tags: topTags,
+    };
+    let chartPng = null;
+    if (byDay.length > 0) {
+        try {
+            // Keep the year in labels when the window spans more than one (MM-DD alone
+            // would be ambiguous across years); otherwise MM-DD keeps labels compact.
+            const includeYear = new Set(byDay.map((d) => d.day.slice(0, 4))).size > 1;
+            const svg = barChartSvg(`Entries per day — ${window.label}`, byDay.map((d) => ({ label: includeYear ? d.day : d.day.slice(5), value: d.count })));
+            chartPng = await renderPng(svg);
+        }
+        catch (err) {
+            console.error("[donguri-journal] review chart render failed:", err);
+            chartPng = null;
+        }
+    }
+    const presentation_hints = {
+        headline: `Review of ${window.label}: ${total} ${total === 1 ? "entry" : "entries"}`,
+        highlight: {
+            total,
+            busiest_day: busiestDay,
+            top_tags: topTags.slice(0, 5),
+        },
+        chart: chartPng
+            ? "A PNG bar chart of entries per day is attached; show it alongside your summary."
+            : "No chart was rendered (no entries in window, or rendering unavailable).",
+        tone: "Reflective and concise. Surface notable themes; invite the user to reflect.",
+        suggestions: [
+            total === 0
+                ? "Window is empty — gently note it and suggest capturing more."
+                : "Call out the busiest day and the recurring tags.",
+            "If patterns recur, consider calling surface_patterns for deeper echoes.",
+        ],
+    };
+    return { structured, chartPng, presentation_hints };
+}
+//# sourceMappingURL=review.js.map

package/dist/review/review.js.map

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

package/dist/review/window.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Calendar window helpers for reviews. All windows are computed in UTC so they
+ * line up with the stored `...Z` timestamps (see normalizeTimestamp in store).
+ */
+export type ReviewPeriod = "day" | "week" | "month";
+export interface ReviewWindow {
+    /** Inclusive ISO-8601 lower bound. */
+    since: string;
+    /** Inclusive ISO-8601 upper bound. */
+    until: string;
+    /** Human-readable label, e.g. "2026-06 (month)". */
+    label: string;
+}
+/**
+ * Compute the calendar window (day / ISO-week Mon–Sun / month) containing
+ * `anchorIso` (defaults to now).
+ */
+export declare function computeWindow(period: ReviewPeriod, anchorIso?: string): ReviewWindow;

package/dist/review/window.js

@@ -0,0 +1,57 @@
+/**
+ * Calendar window helpers for reviews. All windows are computed in UTC so they
+ * line up with the stored `...Z` timestamps (see normalizeTimestamp in store).
+ */
+function startOfDayUTC(d) {
+    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
+}
+/** End of an inclusive window: 1 ms before the start of the next window. */
+function inclusiveEnd(exclusiveStartOfNext) {
+    return new Date(exclusiveStartOfNext.getTime() - 1).toISOString();
+}
+function dayLabel(d) {
+    return d.toISOString().slice(0, 10);
+}
+/**
+ * Compute the calendar window (day / ISO-week Mon–Sun / month) containing
+ * `anchorIso` (defaults to now).
+ */
+export function computeWindow(period, anchorIso) {
+    const anchor = anchorIso ? new Date(anchorIso) : new Date();
+    if (Number.isNaN(anchor.getTime())) {
+        throw new Error(`Invalid anchor timestamp: ${anchorIso}`);
+    }
+    if (period === "day") {
+        const start = startOfDayUTC(anchor);
+        const next = new Date(start);
+        next.setUTCDate(start.getUTCDate() + 1);
+        return {
+            since: start.toISOString(),
+            until: inclusiveEnd(next),
+            label: `${dayLabel(start)} (day)`,
+        };
+    }
+    if (period === "week") {
+        const start = startOfDayUTC(anchor);
+        // Shift back to Monday (getUTCDay: 0=Sun..6=Sat -> 0=Mon..6=Sun).
+        const mondayOffset = (start.getUTCDay() + 6) % 7;
+        start.setUTCDate(start.getUTCDate() - mondayOffset);
+        const next = new Date(start);
+        next.setUTCDate(start.getUTCDate() + 7);
+        const sunday = new Date(next.getTime() - 1);
+        return {
+            since: start.toISOString(),
+            until: inclusiveEnd(next),
+            label: `${dayLabel(start)}–${dayLabel(sunday)} (week)`,
+        };
+    }
+    // month
+    const start = new Date(Date.UTC(anchor.getUTCFullYear(), anchor.getUTCMonth(), 1));
+    const next = new Date(Date.UTC(anchor.getUTCFullYear(), anchor.getUTCMonth() + 1, 1));
+    return {
+        since: start.toISOString(),
+        until: inclusiveEnd(next),
+        label: `${start.toISOString().slice(0, 7)} (month)`,
+    };
+}
+//# sourceMappingURL=window.js.map

package/dist/review/window.js.map

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