sensorium-mcp 3.0.102 → 3.1.0-refactor.0

package/dist/data/memory/narrative-lint.js

@@ -0,0 +1,117 @@
+/**
+ * Narrative quality lint — detects filler language, out-of-period dates, and
+ * low-density sentences in generated narratives.
+ */
+const NARRATIVE_FILLER_PHRASES = [
+    /\bsignificant progress\b/i,
+    /\bnotable improvements?\b/i,
+    /\bvarious features\b/i,
+    /\bseveral enhancements\b/i,
+    /\bsignificant (evolution|strides|developments?)\b/i,
+    /\boverall.{0,20}(positive|good|well)\b/i,
+    /\bpivotal (moments?|decisions?|turning)\b/i,
+    /\bcrucial (step|milestone|decision)\b/i,
+    /\bnotable (milestone|achievement|development)\b/i,
+    /\bsubstantial (progress|improvement)\b/i,
+    /\bremarkable (progress|growth|improvement)\b/i,
+    /\bmeaningful (progress|improvement|change)\b/i,
+    /\bas I (navigated|reflected|observed|witnessed)\b/i,
+    /\bthis (prompted|led) me to reflect\b/i,
+    /\bI (noticed|observed|witnessed) a (critical|pivotal|key)\b/i,
+    /\bmarked by a series of\b/i,
+    /\bpart of a broader effort\b/i,
+    /\bshaped the (direction|trajectory)\b/i,
+    /\bturning points? that\b/i,
+    /\bset the stage for\b/i,
+    /\bnot only .{5,40} but also\b/i,
+    /\bculminating in\b/i,
+    /\bthe focus remains on\b/i,
+    /\bdriven by a commitment\b/i,
+    /\bthis decision to\b/i,
+    /\bthe current status reflects\b/i,
+    /\bresulting in a more\b/i,
+    /\bleading to more\b/i,
+    /\baddress(ed|ing) the root causes? of\b/i,
+    /\benhancing overall\b/i,
+    /\baligning with\b/i,
+];
+export function findFillerPhrase(text) {
+    for (const pattern of NARRATIVE_FILLER_PHRASES) {
+        const match = pattern.exec(text);
+        if (match)
+            return match[0];
+    }
+    return null;
+}
+export function findDateViolation(text, periodStart, periodEnd) {
+    const startDate = new Date(periodStart);
+    const endDate = new Date(periodEnd);
+    const validYears = new Set();
+    for (let y = startDate.getFullYear(); y <= endDate.getFullYear(); y++)
+        validYears.add(y);
+    // Check standalone year references (e.g. "in 2025", "2025–2026")
+    const yearMatches = text.matchAll(/\b(20\d{2})\b/g);
+    for (const m of yearMatches) {
+        const year = parseInt(m[1], 10);
+        if (!validYears.has(year))
+            return `year ${year} outside valid range ${[...validYears].join("–")}`;
+    }
+    // Check month+year combos (e.g. "March 2026", "Apr 2025")
+    const monthNames = [
+        "january",
+        "february",
+        "march",
+        "april",
+        "may",
+        "june",
+        "july",
+        "august",
+        "september",
+        "october",
+        "november",
+        "december",
+    ];
+    const monthPattern = /\b(Jan(?:uary)?|Feb(?:ruary)?|Mar(?:ch)?|Apr(?:il)?|May|June?|July?|Aug(?:ust)?|Sep(?:tember)?|Oct(?:ober)?|Nov(?:ember)?|Dec(?:ember)?)\s+(20\d{2})\b/gi;
+    for (const m of text.matchAll(monthPattern)) {
+        const monthStr = m[1].toLowerCase().slice(0, 3);
+        const monthIdx = monthNames.findIndex((mn) => mn.startsWith(monthStr));
+        const year = parseInt(m[2], 10);
+        if (monthIdx === -1)
+            continue;
+        const refDate = new Date(year, monthIdx, 15);
+        const windowStart = new Date(startDate);
+        windowStart.setDate(windowStart.getDate() - 7);
+        const windowEnd = new Date(endDate);
+        windowEnd.setDate(windowEnd.getDate() + 7);
+        if (refDate < windowStart || refDate > windowEnd) {
+            return `"${m[0]}" falls outside the period ${periodStart.slice(0, 10)} to ${periodEnd.slice(0, 10)}`;
+        }
+    }
+    return null;
+}
+export function findLowDensitySentences(text) {
+    const sentences = text.split(/(?<=[.!?])\s+/).filter((s) => s.length > 20);
+    if (sentences.length === 0)
+        return { count: 0, total: 0, examples: [] };
+    const identifierPattern = /\b(?:\d{4}[-/]\d{2}[-/]\d{2}|\d{1,2}:\d{2}|v\d+\.\d+|#\d+|ID\s*\d+|\d{3,}|(?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\w*\s+\d{1,2}|(?:Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday))/i;
+    const quotedNamePattern = /['"][^'"]+['"]|`[^`]+`/;
+    const namedEntityPattern = /thread\s*\d+|ID\s*\d+|(?:MCP|API|LLM|GPT|SQL|WAL|CLI|SDK|PR|CI|CD)\b/i;
+    const midSentenceProperNoun = (s) => {
+        const afterFirst = s.replace(/^\S+\s+/, "");
+        return /\b[A-Z][a-z]{2,}/.test(afterFirst);
+    };
+    const hasNumber = (s) => /\d+/.test(s);
+    const lowDensity = [];
+    for (const sentence of sentences) {
+        const hasIdentifier = identifierPattern.test(sentence);
+        const hasProperNoun = midSentenceProperNoun(sentence);
+        const hasQuotedName = quotedNamePattern.test(sentence);
+        const hasEntity = namedEntityPattern.test(sentence);
+        const hasNum = hasNumber(sentence);
+        if (!hasIdentifier && !hasProperNoun && !hasQuotedName && !hasEntity && !hasNum) {
+            lowDensity.push(sentence.slice(0, 80));
+        }
+    }
+    return { count: lowDensity.length, total: sentences.length, examples: lowDensity.slice(0, 3) };
+}
+//# sourceMappingURL=narrative-lint.js.map

package/dist/data/memory/narrative-lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative-lint.js","sourceRoot":"","sources":["../../../src/data/memory/narrative-lint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,wBAAwB,GAAa;IACzC,2BAA2B;IAC3B,4BAA4B;IAC5B,uBAAuB;IACvB,2BAA2B;IAC3B,oDAAoD;IACpD,yCAAyC;IACzC,4CAA4C;IAC5C,wCAAwC;IACxC,kDAAkD;IAClD,yCAAyC;IACzC,+CAA+C;IAC/C,+CAA+C;IAC/C,oDAAoD;IACpD,wCAAwC;IACxC,8DAA8D;IAC9D,4BAA4B;IAC5B,+BAA+B;IAC/B,wCAAwC;IACxC,2BAA2B;IAC3B,wBAAwB;IACxB,gCAAgC;IAChC,qBAAqB;IACrB,2BAA2B;IAC3B,6BAA6B;IAC7B,uBAAuB;IACvB,kCAAkC;IAClC,0BAA0B;IAC1B,sBAAsB;IACtB,0CAA0C;IAC1C,wBAAwB;IACxB,oBAAoB;CACrB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,KAAK,MAAM,OAAO,IAAI,wBAAwB,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,WAAmB,EACnB,SAAiB;IAEjB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE;QAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEzF,iEAAiE;IACjE,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YACvB,OAAO,QAAQ,IAAI,wBAAwB,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3E,CAAC;IAED,0DAA0D;IAC1D,MAAM,UAAU,GAAG;QACjB,SAAS;QACT,UAAU;QACV,OAAO;QACP,OAAO;QACP,KAAK;QACL,MAAM;QACN,MAAM;QACN,QAAQ;QACR,WAAW;QACX,SAAS;QACT,UAAU;QACV,UAAU;KACX,CAAC;IACF,MAAM,YAAY,GAChB,0JAA0J,CAAC;IAC7J,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,SAAS;QAC9B,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QACpC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3C,IAAI,OAAO,GAAG,WAAW,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,8BAA8B,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACvG,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAKlD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC3E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAExE,MAAM,iBAAiB,GACrB,2MAA2M,CAAC;IAC9M,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;IACnD,MAAM,kBAAkB,GACtB,uEAAuE,CAAC;IAC1E,MAAM,qBAAqB,GAAG,CAAC,CAAS,EAAW,EAAE;QACnD,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC5C,OAAO,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAExD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,aAAa,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEnC,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;YAChF,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACjG,CAAC"}

package/dist/data/memory/narrative-resolutions.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The narrative resolution ladder — cooldowns, token/char budgets, the
+ * parent→child composition map, and child-window enumeration.
+ */
+import type { NarrativeResolution } from "./narrative-types.js";
+/** Cooldown per resolution before regenerating */
+export declare const COOLDOWNS: Record<NarrativeResolution, number>;
+/** Target output token count per resolution */
+export declare const OUTPUT_TOKEN_TARGETS: Record<NarrativeResolution, number>;
+export declare const INPUT_CHAR_BUDGETS: Record<NarrativeResolution, {
+    episodes: number;
+    notes: number;
+}>;
+export declare const CHILD_RESOLUTION: Partial<Record<NarrativeResolution, NarrativeResolution>>;
+/** Minimum episode-history span (days) before a resolution becomes eligible.
+ *  Without this, a young thread with ≥5 episodes gets month/quarter/half_year
+ *  narratives that just re-summarize the same few days under coarser labels.
+ *  A resolution needs at least one full child-period of real history to mean
+ *  anything, so month wants a week, quarter a month, half_year a quarter. */
+export declare const MIN_HISTORY_DAYS: Record<NarrativeResolution, number>;
+export declare const NARRATIVE_MODEL: string;
+export declare function enumerateChildWindows(resolution: NarrativeResolution, parentStart: string, parentEnd: string): Array<{
+    start: string;
+    end: string;
+}>;
+//# sourceMappingURL=narrative-resolutions.d.ts.map

package/dist/data/memory/narrative-resolutions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative-resolutions.d.ts","sourceRoot":"","sources":["../../../src/data/memory/narrative-resolutions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,kDAAkD;AAClD,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAMzD,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAMpE,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,mBAAmB,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAO7F,CAAC;AAEJ,eAAO,MAAM,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAItF,CAAC;AAEF;;;;6EAI6E;AAC7E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAMhE,CAAC;AAEF,eAAO,MAAM,eAAe,QACgD,CAAC;AAiB7E,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,mBAAmB,EAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBvC"}

package/dist/data/memory/narrative-resolutions.js

@@ -0,0 +1,81 @@
+/**
+ * The narrative resolution ladder — cooldowns, token/char budgets, the
+ * parent→child composition map, and child-window enumeration.
+ */
+/** Cooldown per resolution before regenerating */
+export const COOLDOWNS = {
+    day: 2 * 60 * 60 * 1000, // 2 hours
+    week: 12 * 60 * 60 * 1000, // 12 hours
+    month: 24 * 60 * 60 * 1000, // 24 hours
+    quarter: 7 * 24 * 60 * 60 * 1000, // 7 days
+    half_year: 14 * 24 * 60 * 60 * 1000, // 14 days
+};
+/** Target output token count per resolution */
+export const OUTPUT_TOKEN_TARGETS = {
+    day: 400,
+    week: 800,
+    month: 1600,
+    quarter: 3000,
+    half_year: 4000,
+};
+export const INPUT_CHAR_BUDGETS = {
+    day: { episodes: 30_000, notes: 10_000 },
+    week: { episodes: 50_000, notes: 15_000 },
+    month: { episodes: 60_000, notes: 20_000 },
+    quarter: { episodes: 80_000, notes: 25_000 },
+    half_year: { episodes: 100_000, notes: 30_000 },
+};
+export const CHILD_RESOLUTION = {
+    month: "week",
+    quarter: "month",
+    half_year: "quarter",
+};
+/** Minimum episode-history span (days) before a resolution becomes eligible.
+ *  Without this, a young thread with ≥5 episodes gets month/quarter/half_year
+ *  narratives that just re-summarize the same few days under coarser labels.
+ *  A resolution needs at least one full child-period of real history to mean
+ *  anything, so month wants a week, quarter a month, half_year a quarter. */
+export const MIN_HISTORY_DAYS = {
+    day: 0,
+    week: 0,
+    month: 7,
+    quarter: 30,
+    half_year: 90,
+};
+export const NARRATIVE_MODEL = process.env.NARRATIVE_MODEL || process.env.CONSOLIDATION_MODEL || "gpt-4o";
+function getChildWindowDays(resolution) {
+    switch (resolution) {
+        case "week":
+            return 1;
+        case "month":
+            return 7;
+        case "quarter":
+            return 30;
+        case "half_year":
+            return 90;
+        default:
+            return 0;
+    }
+}
+export function enumerateChildWindows(resolution, parentStart, parentEnd) {
+    const childRes = CHILD_RESOLUTION[resolution];
+    if (!childRes)
+        return [];
+    const windowDays = getChildWindowDays(resolution);
+    if (windowDays === 0)
+        return [];
+    const windows = [];
+    const pEnd = new Date(parentEnd);
+    const cur = new Date(parentStart);
+    cur.setUTCHours(0, 0, 0, 0);
+    while (cur < pEnd) {
+        const wEnd = new Date(cur);
+        wEnd.setUTCDate(wEnd.getUTCDate() + windowDays);
+        if (wEnd > pEnd)
+            wEnd.setTime(pEnd.getTime());
+        windows.push({ start: cur.toISOString(), end: wEnd.toISOString() });
+        cur.setUTCDate(cur.getUTCDate() + windowDays);
+    }
+    return windows;
+}
+//# sourceMappingURL=narrative-resolutions.js.map

package/dist/data/memory/narrative-resolutions.js.map

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

package/dist/data/memory/narrative-sources.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Narrative source data — episode/note collection for a period, history-span
+ * queries, and budget-aware formatting of sources for the LLM prompt.
+ */
+import type { Database } from "./schema.js";
+import type { TemporalNarrative } from "./narrative-types.js";
+import { type Episode } from "./episodes.js";
+import { type SemanticNote } from "./semantic-notes.js";
+export declare function getEarliestEpisodeDate(db: Database, threadId: number): string | null;
+/** Days of episode history a thread has (earliest episode → now); 0 if none. */
+export declare function getHistorySpanDays(db: Database, threadId: number): number;
+export declare function getEpisodesInPeriod(db: Database, threadId: number, start: string, end: string): Episode[];
+export declare function getNotesInPeriod(db: Database, threadId: number, start: string): SemanticNote[];
+export declare function extractEpisodeText(ep: Episode): string;
+export declare function formatEpisodeLine(ep: Episode, text: string): string;
+export declare function formatEpisodesForLLM(episodes: Episode[], maxChars: number): string;
+export declare function formatNotesForLLM(notes: SemanticNote[], maxChars: number): string;
+export declare function formatChildNarrativesForLLM(narratives: TemporalNarrative[]): string;
+//# sourceMappingURL=narrative-sources.d.ts.map

package/dist/data/memory/narrative-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative-sources.d.ts","sourceRoot":"","sources":["../../../src/data/memory/narrative-sources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKpF;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIzE;AAID,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,EAAE,CAyBX;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CA+B9F;AAID,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAItD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyClF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYjF;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAYnF"}

package/dist/data/memory/narrative-sources.js

@@ -0,0 +1,150 @@
+/**
+ * Narrative source data — episode/note collection for a period, history-span
+ * queries, and budget-aware formatting of sources for the LLM prompt.
+ */
+import { parseJsonArray, parseJsonObject } from "./utils.js";
+// ─── Episode History ─────────────────────────────────────────────────────────
+export function getEarliestEpisodeDate(db, threadId) {
+    const row = db
+        .prepare(`SELECT MIN(timestamp) as earliest FROM episodes WHERE thread_id = ?`)
+        .get(threadId);
+    return row?.earliest ?? null;
+}
+/** Days of episode history a thread has (earliest episode → now); 0 if none. */
+export function getHistorySpanDays(db, threadId) {
+    const earliest = getEarliestEpisodeDate(db, threadId);
+    if (!earliest)
+        return 0;
+    return (Date.now() - new Date(earliest).getTime()) / 86_400_000;
+}
+// ─── Source Data Collection ──────────────────────────────────────────────────
+export function getEpisodesInPeriod(db, threadId, start, end) {
+    const rows = db
+        .prepare(`SELECT * FROM episodes
+       WHERE thread_id = ? AND timestamp >= ? AND timestamp <= ?
+       ORDER BY timestamp ASC`)
+        .all(threadId, start, end);
+    // Inline light rowToEpisode to avoid circular dep
+    return rows.map((r) => ({
+        episodeId: r.episode_id,
+        sessionId: r.session_id,
+        threadId: r.thread_id,
+        timestamp: r.timestamp,
+        type: r.type,
+        modality: r.modality,
+        content: parseJsonObject(r.content),
+        topicTags: parseJsonArray(r.topic_tags),
+        importance: r.importance,
+        consolidated: r.consolidated === 1,
+        accessedCount: r.accessed_count,
+        lastAccessed: r.last_accessed,
+        createdAt: r.created_at,
+    }));
+}
+export function getNotesInPeriod(db, threadId, start) {
+    const rows = db
+        .prepare(`SELECT * FROM semantic_notes
+       WHERE thread_id = ? AND valid_to IS NULL AND created_at >= ?
+       ORDER BY access_count DESC LIMIT 30`)
+        .all(threadId, start);
+    return rows.map((r) => ({
+        noteId: r.note_id,
+        type: r.type,
+        content: r.content,
+        keywords: parseJsonArray(r.keywords),
+        confidence: r.confidence,
+        sourceEpisodes: parseJsonArray(r.source_episodes),
+        linkedNotes: parseJsonArray(r.linked_notes),
+        linkReasons: parseJsonObject(r.link_reasons),
+        validFrom: r.valid_from,
+        validTo: r.valid_to,
+        supersededBy: r.superseded_by,
+        accessCount: r.access_count,
+        lastAccessed: r.last_accessed,
+        createdAt: r.created_at,
+        updatedAt: r.updated_at,
+        priority: r.priority ?? 0,
+        threadId: r.thread_id,
+        isGuardrail: r.is_guardrail === 1,
+        pinned: r.pinned === 1,
+        qualityScore: r.quality_score ?? null,
+    }));
+}
+// ─── Content Extraction ──────────────────────────────────────────────────────
+export function extractEpisodeText(ep) {
+    const content = ep.content;
+    const text = (content.text || content.raw || content.caption || content.message || "");
+    return text.slice(0, 1500);
+}
+export function formatEpisodeLine(ep, text) {
+    const ts = ep.timestamp.slice(0, 16).replace("T", " ");
+    const imp = ep.importance != null && ep.importance !== 0.5 ? ` [imp: ${ep.importance.toFixed(1)}]` : "";
+    const tags = ep.topicTags.length > 0 ? ` [tags: ${ep.topicTags.join(", ")}]` : "";
+    return `[${ts}] (${ep.type}/${ep.modality})${imp}${tags} ${text}`;
+}
+export function formatEpisodesForLLM(episodes, maxChars) {
+    const importanceBudget = Math.round(maxChars * 0.3);
+    // Pool 1: top episodes by importance (guaranteed inclusion)
+    const byImportance = [...episodes].sort((a, b) => (b.importance ?? 0.5) - (a.importance ?? 0.5));
+    const selected = new Set();
+    const pool1 = [];
+    let pool1Chars = 0;
+    for (const ep of byImportance) {
+        const text = extractEpisodeText(ep);
+        if (!text.trim())
+            continue;
+        const line = formatEpisodeLine(ep, text);
+        if (pool1Chars + line.length > importanceBudget)
+            break;
+        pool1.push({ ep, line });
+        selected.add(ep.episodeId);
+        pool1Chars += line.length;
+    }
+    // Pool 2: chronological fill (remaining budget)
+    const remainingBudget = maxChars - pool1Chars;
+    const chronological = [...episodes]
+        .filter((ep) => !selected.has(ep.episodeId))
+        .sort((a, b) => (a.timestamp < b.timestamp ? -1 : 1));
+    const pool2 = [];
+    let pool2Chars = 0;
+    for (const ep of chronological) {
+        const text = extractEpisodeText(ep);
+        if (!text.trim())
+            continue;
+        const line = formatEpisodeLine(ep, text);
+        if (pool2Chars + line.length > remainingBudget)
+            break;
+        pool2.push({ ep, line });
+        pool2Chars += line.length;
+    }
+    // Merge both pools and sort chronologically for coherent reading
+    return [...pool1, ...pool2]
+        .sort((a, b) => (a.ep.timestamp < b.ep.timestamp ? -1 : 1))
+        .map((x) => x.line)
+        .join("\n");
+}
+export function formatNotesForLLM(notes, maxChars) {
+    const lines = [];
+    let chars = 0;
+    for (const n of notes) {
+        const line = `- [${n.type}] ${n.content.slice(0, 600)} (conf: ${n.confidence.toFixed(2)})`;
+        if (chars + line.length > maxChars)
+            break;
+        lines.push(line);
+        chars += line.length;
+    }
+    return lines.join("\n");
+}
+export function formatChildNarrativesForLLM(narratives) {
+    return narratives
+        .map((n) => {
+        const fmtDate = (d) => new Date(d).toLocaleDateString("en-US", {
+            month: "short",
+            day: "numeric",
+            year: "numeric",
+        });
+        return `--- ${n.resolution} narrative (${fmtDate(n.periodStart)} – ${fmtDate(n.periodEnd)}, ${n.sourceEpisodeCount} episodes) ---\n${n.narrative}`;
+    })
+        .join("\n\n");
+}
+//# sourceMappingURL=narrative-sources.js.map

package/dist/data/memory/narrative-sources.js.map

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

package/dist/data/memory/narrative-store.d.ts

@@ -0,0 +1,11 @@
+/**
+ * temporal_narratives reads — latest/current/child narrative lookups and the
+ * per-resolution regeneration cooldown check.
+ */
+import type { Database } from "./schema.js";
+import type { NarrativeResolution, TemporalNarrative } from "./narrative-types.js";
+export declare function getChildNarratives(db: Database, threadId: number, resolution: NarrativeResolution, start: string, end: string): TemporalNarrative[];
+export declare function getLastNarrative(db: Database, threadId: number, resolution: NarrativeResolution): TemporalNarrative | null;
+export declare function getCurrentNarrative(db: Database, threadId: number, resolution: NarrativeResolution): TemporalNarrative | null;
+export declare function isCooldownActive(db: Database, threadId: number, resolution: NarrativeResolution): boolean;
+//# sourceMappingURL=narrative-store.d.ts.map

package/dist/data/memory/narrative-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative-store.d.ts","sourceRoot":"","sources":["../../../src/data/memory/narrative-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGnF,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,iBAAiB,EAAE,CAwBrB;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,mBAAmB,GAC9B,iBAAiB,GAAG,IAAI,CAuB1B;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,mBAAmB,GAC9B,iBAAiB,GAAG,IAAI,CA0B1B;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAMT"}

package/dist/data/memory/narrative-store.js

@@ -0,0 +1,80 @@
+/**
+ * temporal_narratives reads — latest/current/child narrative lookups and the
+ * per-resolution regeneration cooldown check.
+ */
+import { CHILD_RESOLUTION, COOLDOWNS } from "./narrative-resolutions.js";
+export function getChildNarratives(db, threadId, resolution, start, end) {
+    const child = CHILD_RESOLUTION[resolution];
+    if (!child)
+        return [];
+    const rows = db
+        .prepare(`SELECT * FROM temporal_narratives
+       WHERE thread_id = ? AND resolution = ? AND period_start >= ? AND period_start <= ?
+       ORDER BY period_start ASC`)
+        .all(threadId, child, start, end);
+    return rows.map((r) => ({
+        id: r.id,
+        threadId: r.thread_id,
+        resolution: r.resolution,
+        periodStart: r.period_start,
+        periodEnd: r.period_end,
+        narrative: r.narrative,
+        sourceEpisodeCount: r.source_episode_count,
+        sourceNoteCount: r.source_note_count,
+        model: r.model,
+        createdAt: r.created_at,
+    }));
+}
+export function getLastNarrative(db, threadId, resolution) {
+    const row = db
+        .prepare(`SELECT * FROM temporal_narratives
+       WHERE thread_id = ? AND resolution = ?
+       ORDER BY period_start DESC LIMIT 1`)
+        .get(threadId, resolution);
+    if (!row)
+        return null;
+    return {
+        id: row.id,
+        threadId: row.thread_id,
+        resolution: row.resolution,
+        periodStart: row.period_start,
+        periodEnd: row.period_end,
+        narrative: row.narrative,
+        sourceEpisodeCount: row.source_episode_count,
+        sourceNoteCount: row.source_note_count,
+        model: row.model,
+        createdAt: row.created_at,
+    };
+}
+export function getCurrentNarrative(db, threadId, resolution) {
+    const row = db
+        .prepare(`SELECT * FROM temporal_narratives
+       WHERE thread_id = ? AND resolution = ?
+         AND period_start <= datetime('now')
+         AND period_end >= datetime('now', '-1 day')
+       ORDER BY julianday(period_end) - julianday(period_start) DESC, created_at DESC
+       LIMIT 1`)
+        .get(threadId, resolution);
+    if (!row)
+        return null;
+    return {
+        id: row.id,
+        threadId: row.thread_id,
+        resolution: row.resolution,
+        periodStart: row.period_start,
+        periodEnd: row.period_end,
+        narrative: row.narrative,
+        sourceEpisodeCount: row.source_episode_count,
+        sourceNoteCount: row.source_note_count,
+        model: row.model,
+        createdAt: row.created_at,
+    };
+}
+export function isCooldownActive(db, threadId, resolution) {
+    const last = getLastNarrative(db, threadId, resolution);
+    if (!last)
+        return false;
+    const elapsed = Date.now() - new Date(last.createdAt).getTime();
+    return elapsed < COOLDOWNS[resolution];
+}
+//# sourceMappingURL=narrative-store.js.map

package/dist/data/memory/narrative-store.js.map

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

package/dist/data/memory/narrative-types.d.ts

@@ -0,0 +1,15 @@
+/** Shared types for the temporal narrative pipeline. */
+export type NarrativeResolution = "day" | "week" | "month" | "quarter" | "half_year";
+export interface TemporalNarrative {
+    id: number;
+    threadId: number;
+    resolution: NarrativeResolution;
+    periodStart: string;
+    periodEnd: string;
+    narrative: string;
+    sourceEpisodeCount: number;
+    sourceNoteCount: number;
+    model: string | null;
+    createdAt: string;
+}
+//# sourceMappingURL=narrative-types.d.ts.map

package/dist/data/memory/narrative-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative-types.d.ts","sourceRoot":"","sources":["../../../src/data/memory/narrative-types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,mBAAmB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/data/memory/narrative-types.js

@@ -0,0 +1,3 @@
+/** Shared types for the temporal narrative pipeline. */
+export {};
+//# sourceMappingURL=narrative-types.js.map

package/dist/data/memory/narrative-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative-types.js","sourceRoot":"","sources":["../../../src/data/memory/narrative-types.ts"],"names":[],"mappings":"AAAA,wDAAwD"}

package/dist/data/memory/narrative.d.ts

@@ -12,7 +12,11 @@
  * coherent temporal awareness across long-running sessions.
  */
 import type { Database } from "./schema.js";
-type NarrativeResolution = "day" | "week" | "month" | "quarter" | "half_year";
+import type { NarrativeResolution } from "./narrative-types.js";
+export declare function getPeriodBounds(db: Database, threadId: number, resolution: NarrativeResolution): {
+    start: string;
+    end: string;
+};
 /**
  * Generate all temporal narratives for a thread, respecting cooldowns.
  * Returns narratives that were generated or already cached.
@@ -29,5 +33,4 @@ export declare function runNarrativeGeneration(db: Database, threadId: number, o
  * Returns available narratives without triggering generation.
  */
 export declare function getNarrativesForBootstrap(db: Database, threadId: number): Record<NarrativeResolution, string | null>;
-export {};
 //# sourceMappingURL=narrative.d.ts.map

package/dist/data/memory/narrative.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"narrative.d.ts","sourceRoot":"","sources":["../../../src/data/memory/narrative.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAW5C,KAAK,mBAAmB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAy3B9E;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC;IAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;IAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwChG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC,CAmB5C"}
+{"version":3,"file":"narrative.d.ts","sourceRoot":"","sources":["../../../src/data/memory/narrative.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,sBAAsB,CAAC;AAwCnF,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,mBAAmB,GAC9B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAgDhC;AAyQD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC;IAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;IAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA4ChG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC,CAsB5C"}