@rubytech/create-maxy-code 0.1.143 → 0.1.146

package/payload/platform/plugins/memory/mcp/dist/lib/graph-write-gate.js

@@ -39,24 +39,27 @@
 /** Compiled-truth cap. ≤2000 chars ≈ 300 words — forces the rewriter to summarise, not transcribe. */
 export const COMPILED_TRUTH_MAX_CHARS = 2000;
 /**
- * Property-level write gate (Task 306). Today: one rule — `compiledTruth`
- * must not exceed COMPILED_TRUTH_MAX_CHARS. Used by both `memory-write`
- * and `memory-update`; the rewriter calls it before writing too.
+ * Property-level write gate (Task 306, extended Task 392). The cap applies
+ * to both `compiledTruth` and its public twin `compiledTruthPublic`; either
+ * field exceeding COMPILED_TRUTH_MAX_CHARS rejects the write. Used by both
+ * `memory-write` and `memory-update`; the rewriter calls it before writing too.
  *
  * Pure / synchronous on purpose — no session needed. Loud-fail on
  * violation so an over-producing rewriter surfaces immediately instead
  * of silently truncating the operator's summary.
  */
 export function checkPropertyWriteGate(args) {
-    const truth = args.properties.compiledTruth;
-    if (typeof truth === "string" && truth.length > COMPILED_TRUTH_MAX_CHARS) {
-        console.log(`[graph-write-gate] reject reason=compiled-truth-too-long len=${truth.length} cap=${COMPILED_TRUTH_MAX_CHARS}`);
-        return {
-            ok: false,
-            reason: "compiled-truth-too-long",
-            message: `compiledTruth length ${truth.length} exceeds cap of ${COMPILED_TRUTH_MAX_CHARS} chars. ` +
-                `The rewriter must produce a tighter summary.`,
-        };
+    for (const field of ["compiledTruth", "compiledTruthPublic"]) {
+        const value = args.properties[field];
+        if (typeof value === "string" && value.length > COMPILED_TRUTH_MAX_CHARS) {
+            console.log(`[graph-write-gate] reject reason=compiled-truth-too-long field=${field} len=${value.length} cap=${COMPILED_TRUTH_MAX_CHARS}`);
+            return {
+                ok: false,
+                reason: "compiled-truth-too-long",
+                message: `${field} length ${value.length} exceeds cap of ${COMPILED_TRUTH_MAX_CHARS} chars. ` +
+                    `The rewriter must produce a tighter summary.`,
+            };
+        }
     }
     return { ok: true };
 }
@@ -65,6 +68,38 @@ const EXEMPT_LABELS = new Set([
     "LocalBusiness",
     "AdminUser",
 ]);
+/**
+ * Labels the agent must never write directly via memory-write /
+ * memory-update. `:CompiledTruthRevision` (compiled-truth rewriter) is read-only after
+ * write: the only writer is the rewriter (composed via the revision
+ * helper, in the same transaction as the live `compiledTruth` SET), and
+ * the only mutation path is the dream-cycle prune. Direct writes from
+ * the agent would let an LLM forge or rewrite audit history — defeating
+ * the point of having it.
+ */
+const FORBIDDEN_LABELS = new Set([
+    "CompiledTruthRevision",
+]);
+/**
+ * Label-level write gate (compiled-truth rewriter). Rejects any agent-side write
+ * whose labels include a FORBIDDEN_LABEL. Pure / synchronous — no
+ * session needed.
+ */
+export function checkLabelWriteGate(args) {
+    for (const label of args.labels) {
+        if (FORBIDDEN_LABELS.has(label)) {
+            console.log(`[graph-write-gate] reject reason=forbidden-label label=${label}`);
+            return {
+                ok: false,
+                reason: "forbidden-label",
+                forbiddenLabel: label,
+                message: `:${label} is read-only and may not be written via memory-write or memory-update. ` +
+                    `It is produced by the compiled-truth rewriter (compiled-truth rewriter) and pruned by the dream-cycle.`,
+            };
+        }
+    }
+    return { ok: true };
+}
 const NEXT_MOVE = "Run the business-profile skill to establish the admin user and business " +
     "identity, or complete the personal-profile bootstrap (onboarding step 9 " +
     "personal mode), before writing this node.";

package/payload/platform/plugins/memory/mcp/dist/lib/graph-write-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-write-gate.js","sourceRoot":"","sources":["../../src/lib/graph-write-gate.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,yEAAyE;AACzE,iEAAiE;AACjE,2EAA2E;AAC3E,4EAA4E;AAC5E,uEAAuE;AACvE,8EAA8E;AAC9E,sEAAsE;AACtE,gDAAgD;AAChD,EAAE;AACF,2BAA2B;AAC3B,uDAAuD;AACvD,mEAAmE;AACnE,EAAE;AACF,8EAA8E;AAC9E,uEAAuE;AACvE,uEAAuE;AACvE,0DAA0D;AAC1D,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,0EAA0E;AAC1E,6EAA6E;AAC7E,+CAA+C;AAC/C,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,qCAAqC;AACrC,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,+DAA+D;AAC/D,EAAE;AACF,4EAA4E;AAC5E,mEAAmE;AACnE,8EAA8E;AAC9E,0EAA0E;AA2C1E,sGAAsG;AACtG,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAU7C;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAEtC;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,wBAAwB,EAAE,CAAC;QACzE,OAAO,CAAC,GAAG,CACT,gEAAgE,KAAK,CAAC,MAAM,QAAQ,wBAAwB,EAAE,CAC/G,CAAC;QACF,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,yBAAyB;YACjC,OAAO,EACL,wBAAwB,KAAK,CAAC,MAAM,mBAAmB,wBAAwB,UAAU;gBACzF,8CAA8C;SACjD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC;IACjD,QAAQ;IACR,eAAe;IACf,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,SAAS,GACb,0EAA0E;IAC1E,0EAA0E;IAC1E,2CAA2C,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAc;IACtD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE5C,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,mEAAmE;IACnE,oEAAoE;IACpE,sEAAsE;IACtE,yDAAyD;IACzD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B;;;;4GAIwG,EACxG,EAAE,SAAS,EAAE,CACd,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IACxD,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAEtE,IAAI,QAAQ,IAAI,CAAC,WAAW,IAAI,kBAAkB,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,8DAA8D;IAC9D,qEAAqE;IACrE,yEAAyE;IACzE,4EAA4E;IAC5E,wEAAwE;IACxE,wCAAwC;IACxC,IAAI,MAA6C,CAAC;IAClD,IAAI,SAGiC,CAAC;IACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG,eAAe,CAAC;QACzB,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,oBAAoB,CAAC;IACjF,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,mBAAmB,CAAC;QAC7B,SAAS,GAAG,iCAAiC,CAAC;IAChD,CAAC;IAED,OAAO,CAAC,GAAG,CACT,uCAAuC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI;QAC9D,UAAU,MAAM,cAAc,SAAS,eAAe,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAC3E,CAAC;IAEF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"graph-write-gate.js","sourceRoot":"","sources":["../../src/lib/graph-write-gate.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/memory/mcp/dist/lib/relative-date.d.ts

@@ -0,0 +1,13 @@
+export type RelativeDateForm = "literal-day" | "weekday" | "ago" | "holiday" | "quarter";
+export interface RelativeDateMatch {
+    date: Date;
+    form: RelativeDateForm;
+    /** The literal phrase that matched, for diagnostics. */
+    matched: string;
+}
+/**
+ * Parse `text` against `reference`. Returns the first matching form or null.
+ * Recurring phrases ("every other Friday") return null by design.
+ */
+export declare function parseRelativeDate(text: string, reference: Date): RelativeDateMatch | null;
+//# sourceMappingURL=relative-date.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/lib/relative-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-date.d.ts","sourceRoot":"","sources":["../../src/lib/relative-date.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAkJD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,iBAAiB,GAAG,IAAI,CAazF"}

package/payload/platform/plugins/memory/mcp/dist/lib/relative-date.js

@@ -0,0 +1,191 @@
+// Task 390: deterministic relative-date parser.
+//
+// Parses a free-text date phrase against a reference timestamp and returns
+// the resolved Date plus the form that matched. Used by:
+//   - timeline-extractor.ts (sentence-scoped parse during memory-write)
+//   - datetime/SKILL.md (operator-facing arithmetic via `node -e`)
+//
+// Both consumers need identical semantics; this is the single source of
+// truth. The parser is deterministic — no LLM, no chrono-node. Forms not
+// listed here return null; the caller decides what to do with that.
+//
+// Recognised forms (priority order — first match wins):
+//   1. Literal day words           — yesterday / today / tomorrow
+//   2. Last/next/this <weekday>    — "last Tuesday", "next Fri"
+//   3. N units ago                 — "two weeks ago", "3 days ago"
+//   4. Holiday anchors             — "this Christmas", "this New Year"
+//   5. Fiscal quarter, year known  — "Q3 2024", "Q1 25"
+//   6. Fiscal quarter, year word   — "Q3 last year", "Q1 this year"
+//
+// Recurring forms ("every other Friday") return null intentionally —
+// they belong on :Routine, not :TimelineEvent.
+const WEEKDAYS = {
+    sun: 0, sunday: 0,
+    mon: 1, monday: 1,
+    tue: 2, tues: 2, tuesday: 2,
+    wed: 3, weds: 3, wednesday: 3,
+    thu: 4, thur: 4, thurs: 4, thursday: 4,
+    fri: 5, friday: 5,
+    sat: 6, saturday: 6,
+};
+const WORD_NUMBERS = {
+    one: 1, two: 2, three: 3, four: 4, five: 5,
+    six: 6, seven: 7, eight: 8, nine: 9, ten: 10,
+    eleven: 11, twelve: 12,
+};
+function startOfDay(d) {
+    const out = new Date(d.getTime());
+    out.setUTCHours(0, 0, 0, 0);
+    return out;
+}
+function addDays(d, n) {
+    const out = new Date(d.getTime());
+    out.setUTCDate(out.getUTCDate() + n);
+    return out;
+}
+function addMonths(d, n) {
+    const out = new Date(d.getTime());
+    out.setUTCMonth(out.getUTCMonth() + n);
+    return out;
+}
+function addYears(d, n) {
+    const out = new Date(d.getTime());
+    out.setUTCFullYear(out.getUTCFullYear() + n);
+    return out;
+}
+/** Returns null for "every other X" / "every X" — recurring is not a TimelineEvent. */
+function isRecurring(text) {
+    return /\bevery(\s+other)?\s+/i.test(text);
+}
+function parseLiteralDay(text, ref) {
+    const m = text.match(/\b(yesterday|today|tomorrow)\b/i);
+    if (!m)
+        return null;
+    const word = m[1].toLowerCase();
+    const base = startOfDay(ref);
+    if (word === "yesterday")
+        return { date: addDays(base, -1), form: "literal-day", matched: m[0] };
+    if (word === "tomorrow")
+        return { date: addDays(base, 1), form: "literal-day", matched: m[0] };
+    return { date: base, form: "literal-day", matched: m[0] };
+}
+function parseWeekday(text, ref) {
+    // "last Tuesday", "next Fri", "this Monday"
+    const m = text.match(/\b(last|next|this)\s+([A-Za-z]+)\b/i);
+    if (!m)
+        return null;
+    const qualifier = m[1].toLowerCase();
+    const target = WEEKDAYS[m[2].toLowerCase()];
+    if (target === undefined)
+        return null;
+    const base = startOfDay(ref);
+    const refDow = base.getUTCDay();
+    let delta;
+    if (qualifier === "last") {
+        delta = target - refDow;
+        if (delta >= 0)
+            delta -= 7;
+    }
+    else if (qualifier === "next") {
+        delta = target - refDow;
+        if (delta <= 0)
+            delta += 7;
+    }
+    else {
+        // "this <weekday>" — the matching day in the current ISO week
+        // (Mon-Sun). For ref = Wed, "this Monday" is two days ago;
+        // "this Friday" is two days ahead. Always within +/-6 days of ref.
+        const isoDow = refDow === 0 ? 7 : refDow; // Mon=1..Sun=7
+        const isoTarget = target === 0 ? 7 : target;
+        delta = isoTarget - isoDow;
+    }
+    return { date: addDays(base, delta), form: "weekday", matched: m[0] };
+}
+function parseUnitsAgo(text, ref) {
+    // "two weeks ago", "3 days ago", "a month ago"
+    const m = text.match(/\b(a|an|\d+|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve)\s+(day|week|month|year)s?\s+ago\b/i);
+    if (!m)
+        return null;
+    const numWord = m[1].toLowerCase();
+    let n;
+    if (numWord === "a" || numWord === "an")
+        n = 1;
+    else if (WORD_NUMBERS[numWord] !== undefined)
+        n = WORD_NUMBERS[numWord];
+    else
+        n = Number(numWord);
+    if (!Number.isFinite(n) || n <= 0)
+        return null;
+    const unit = m[2].toLowerCase();
+    const base = startOfDay(ref);
+    let date;
+    if (unit === "day")
+        date = addDays(base, -n);
+    else if (unit === "week")
+        date = addDays(base, -7 * n);
+    else if (unit === "month")
+        date = addMonths(base, -n);
+    else
+        date = addYears(base, -n);
+    return { date, form: "ago", matched: m[0] };
+}
+function parseHoliday(text, ref) {
+    // "this Christmas" -> 25 Dec of reference year.
+    // "this New Year" -> 1 Jan of reference year.
+    const xmas = text.match(/\b(?:this\s+)?Christmas\b/i);
+    if (xmas) {
+        const d = new Date(Date.UTC(ref.getUTCFullYear(), 11, 25));
+        return { date: d, form: "holiday", matched: xmas[0] };
+    }
+    const ny = text.match(/\b(?:this\s+)?New\s+Year('s)?(\s+Day)?\b/i);
+    if (ny) {
+        const d = new Date(Date.UTC(ref.getUTCFullYear(), 0, 1));
+        return { date: d, form: "holiday", matched: ny[0] };
+    }
+    return null;
+}
+function quarterStart(year, q) {
+    // Q1 -> Jan 1, Q2 -> Apr 1, Q3 -> Jul 1, Q4 -> Oct 1.
+    return new Date(Date.UTC(year, (q - 1) * 3, 1));
+}
+function parseQuarter(text, ref) {
+    // "Q3 2024", "Q1 25", "Q4 last year", "Q2 this year", "Q1 next year"
+    const explicit = text.match(/\bQ([1-4])\s+(\d{2}|\d{4})\b/i);
+    if (explicit) {
+        const q = Number(explicit[1]);
+        let y = Number(explicit[2]);
+        if (y < 100)
+            y = 2000 + y;
+        if (y < 1900 || y > 2099)
+            return null;
+        return { date: quarterStart(y, q), form: "quarter", matched: explicit[0] };
+    }
+    const relative = text.match(/\bQ([1-4])\s+(last|this|next)\s+year\b/i);
+    if (relative) {
+        const q = Number(relative[1]);
+        const word = relative[2].toLowerCase();
+        const refYear = ref.getUTCFullYear();
+        const y = word === "last" ? refYear - 1 : word === "next" ? refYear + 1 : refYear;
+        return { date: quarterStart(y, q), form: "quarter", matched: relative[0] };
+    }
+    return null;
+}
+/**
+ * Parse `text` against `reference`. Returns the first matching form or null.
+ * Recurring phrases ("every other Friday") return null by design.
+ */
+export function parseRelativeDate(text, reference) {
+    if (!text || typeof text !== "string")
+        return null;
+    if (!(reference instanceof Date) || Number.isNaN(reference.getTime()))
+        return null;
+    if (isRecurring(text))
+        return null;
+    return (parseLiteralDay(text, reference) ??
+        parseWeekday(text, reference) ??
+        parseUnitsAgo(text, reference) ??
+        parseHoliday(text, reference) ??
+        parseQuarter(text, reference) ??
+        null);
+}
+//# sourceMappingURL=relative-date.js.map

package/payload/platform/plugins/memory/mcp/dist/lib/relative-date.js.map

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

package/payload/platform/plugins/memory/mcp/dist/lib/timeline-extractor.d.ts

@@ -1,13 +1,19 @@
+export type DateForm = "iso" | "dmy" | "my" | "in-year" | "bare-year" | "relative" | "quarter";
 export interface DatedStatement {
     occurredAt: string;
     summary: string;
     /** The literal date phrase that triggered the match. Useful for diagnostics. */
     matched: string;
+    /** Which heuristic matched. */
+    form: DateForm;
 }
 /**
  * Extract every dated statement from `body`. One row per sentence containing
  * the first parseable date in that sentence. Sentences without a date are
  * dropped silently (the diagnostic count is the caller's concern).
+ *
+ * `reference` anchors relative forms ("yesterday", "two weeks ago", "Q3 last
+ * year"). Callers pass the message's createdAt; absent that, current time.
  */
-export declare function extractDatedStatements(body: string | null | undefined): DatedStatement[];
+export declare function extractDatedStatements(body: string | null | undefined, reference?: Date): DatedStatement[];
 //# sourceMappingURL=timeline-extractor.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/lib/timeline-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-extractor.d.ts","sourceRoot":"","sources":["../../src/lib/timeline-extractor.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;CACjB;AAkID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,EAAE,CAcxF"}
+{"version":3,"file":"timeline-extractor.d.ts","sourceRoot":"","sources":["../../src/lib/timeline-extractor.ts"],"names":[],"mappings":"AA2BA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/F,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,IAAI,EAAE,QAAQ,CAAC;CAChB;AAiJD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,SAAS,GAAE,IAAiB,GAC3B,cAAc,EAAE,CA0BlB"}

package/payload/platform/plugins/memory/mcp/dist/lib/timeline-extractor.js

@@ -13,12 +13,16 @@
 //   4. "in YYYY"          — "in 2018"
 //   5. "since YYYY"       — "since 2018"
 //   6. Bare year          — 2018 (only when 1900-2099 and surrounded by word boundaries)
+//   7. Relative + quarter — yesterday / last Tuesday / two weeks ago / Q3 2024
+//      (Task 390 — delegated to parseRelativeDate against caller-supplied reference)
 //
 // Coarse forms (bare year, "in YYYY") parse to YYYY-01-01T00:00:00Z so the
 // `occurredAt` index is queryable. Day-precision forms parse exactly.
+// Relative forms resolve to a UTC day from the reference timestamp.
 //
 // A statement is the sentence containing the parsed date. Summaries
 // truncate to 500 chars at sentence boundaries when possible.
+import { parseRelativeDate } from "./relative-date.js";
 const MONTHS = {
     jan: 1, january: 1,
     feb: 2, february: 2,
@@ -77,7 +81,7 @@ function clampSummary(s) {
  * Returns null if the sentence has no parseable date; otherwise the first
  * matching date and its ISO normalisation.
  */
-function parseFirstDate(sentence) {
+function parseFirstDate(sentence, reference) {
     // 1. ISO date: 2026-03-10 or 2026/03/10
     const iso = sentence.match(/\b(\d{4})[-/](\d{1,2})[-/](\d{1,2})\b/);
     if (iso) {
@@ -85,7 +89,7 @@ function parseFirstDate(sentence) {
         const m = Number(iso[2]);
         const d = Number(iso[3]);
         if (validYear(y) && validMonth(m) && validDay(d)) {
-            return { occurredAt: isoDay(y, m, d), matched: iso[0] };
+            return { occurredAt: isoDay(y, m, d), matched: iso[0], form: "iso" };
         }
     }
     // 2. Day-month-year: "10 March 2026" / "10 Mar 2026"
@@ -95,7 +99,7 @@ function parseFirstDate(sentence) {
         const m = MONTHS[dmy[2].toLowerCase()];
         const y = Number(dmy[3]);
         if (m && validYear(y) && validDay(d)) {
-            return { occurredAt: isoDay(y, m, d), matched: dmy[0] };
+            return { occurredAt: isoDay(y, m, d), matched: dmy[0], form: "dmy" };
         }
     }
     // 3. Month-year: "March 2026" / "Mar 2026"
@@ -104,7 +108,7 @@ function parseFirstDate(sentence) {
         const m = MONTHS[my[1].toLowerCase()];
         const y = Number(my[2]);
         if (m && validYear(y)) {
-            return { occurredAt: isoMonth(y, m), matched: my[0] };
+            return { occurredAt: isoMonth(y, m), matched: my[0], form: "my" };
         }
     }
     // 4 + 5. "in YYYY" / "since YYYY"
@@ -112,17 +116,28 @@ function parseFirstDate(sentence) {
     if (inYear) {
         const y = Number(inYear[1]);
         if (validYear(y)) {
-            return { occurredAt: isoYear(y), matched: inYear[0] };
+            return { occurredAt: isoYear(y), matched: inYear[0], form: "in-year" };
         }
     }
-    // 6. Bare year — restrictive: must be 4 digits surrounded by word boundaries
+    // 6. Relative + quarter forms (Task 390). Delegated to the shared lib so the
+    // datetime skill calls the same code path. Checked before bare-year so that
+    // "Q3 2024" parses as the quarter rather than the bare year 2024.
+    const rel = parseRelativeDate(sentence, reference);
+    if (rel) {
+        return {
+            occurredAt: rel.date.toISOString().replace(/\.\d{3}Z$/, "Z"),
+            matched: rel.matched,
+            form: rel.form === "quarter" ? "quarter" : "relative",
+        };
+    }
+    // 7. Bare year — restrictive: must be 4 digits surrounded by word boundaries
     // and not preceded by "$" (price), ":" (time), or "-" (already part of a
     // date we would have matched above). Cheap defensive guards.
     const bareYear = sentence.match(/(?<![$:\d-])\b(\d{4})\b(?!\s*[-/]\d)/);
     if (bareYear) {
         const y = Number(bareYear[1]);
         if (validYear(y)) {
-            return { occurredAt: isoYear(y), matched: bareYear[0] };
+            return { occurredAt: isoYear(y), matched: bareYear[0], form: "bare-year" };
         }
     }
     return null;
@@ -131,21 +146,34 @@ function parseFirstDate(sentence) {
  * Extract every dated statement from `body`. One row per sentence containing
  * the first parseable date in that sentence. Sentences without a date are
  * dropped silently (the diagnostic count is the caller's concern).
+ *
+ * `reference` anchors relative forms ("yesterday", "two weeks ago", "Q3 last
+ * year"). Callers pass the message's createdAt; absent that, current time.
  */
-export function extractDatedStatements(body) {
+export function extractDatedStatements(body, reference = new Date()) {
     if (!body || typeof body !== "string")
         return [];
+    const ref = reference instanceof Date && !Number.isNaN(reference.getTime())
+        ? reference
+        : new Date();
     const out = [];
+    const formCounts = {};
     for (const sentence of splitSentences(body)) {
-        const hit = parseFirstDate(sentence);
+        const hit = parseFirstDate(sentence, ref);
         if (hit) {
             out.push({
                 occurredAt: hit.occurredAt,
                 summary: clampSummary(sentence),
                 matched: hit.matched,
+                form: hit.form,
             });
+            formCounts[hit.form] = (formCounts[hit.form] ?? 0) + 1;
         }
     }
+    // Task 390 diagnostic: coverage so the rewriter team can observe parse rate.
+    const forms = Object.keys(formCounts).sort().join(",");
+    // eslint-disable-next-line no-console
+    console.log(`[timeline-extract] coverage body-len=${body.length} dates=${out.length}${forms ? ` forms=[${forms}]` : ""}`);
     return out;
 }
 //# sourceMappingURL=timeline-extractor.js.map

package/payload/platform/plugins/memory/mcp/dist/lib/timeline-extractor.js.map

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

package/payload/platform/plugins/memory/mcp/dist/tools/__tests__/memory-compiled-truth-history.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-compiled-truth-history.test.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/__tests__/memory-compiled-truth-history.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-compiled-truth-history.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/memory-compiled-truth-history.test.ts"],"names":[],"mappings":""}

package/payload/platform/plugins/memory/mcp/dist/tools/__tests__/memory-compiled-truth-history.test.js

@@ -0,0 +1,81 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+vi.mock("../../lib/neo4j.js", () => {
+    const run = vi.fn();
+    const close = vi.fn();
+    return {
+        getSession: () => ({ run, close }),
+        __mocks: { run, close },
+    };
+});
+import { memoryCompiledTruthHistory } from "../memory-compiled-truth-history.js";
+import * as neo4jMock from "../../lib/neo4j.js";
+const { run, close } = neo4jMock.__mocks;
+function row(props) {
+    return { get: (key) => props[key] };
+}
+describe("memoryCompiledTruthHistory", () => {
+    beforeEach(() => {
+        run.mockReset();
+        close.mockReset();
+    });
+    it("returns revisions newest first, account-scoped", async () => {
+        run.mockResolvedValue({
+            records: [
+                row({
+                    revisionId: "00000000-0000-0000-0000-000000000002",
+                    truth: "Newer truth",
+                    writtenAt: "2026-05-25T10:00:00Z",
+                    source: "rewriter",
+                }),
+                row({
+                    revisionId: "00000000-0000-0000-0000-000000000001",
+                    truth: "Older truth",
+                    writtenAt: "2026-05-20T10:00:00Z",
+                    source: "rewriter",
+                }),
+            ],
+        });
+        const result = await memoryCompiledTruthHistory({
+            accountId: "acc-1",
+            nodeId: "4:abc:1",
+        });
+        expect(result.entityNodeId).toBe("4:abc:1");
+        expect(result.revisions).toHaveLength(2);
+        expect(result.revisions[0].truth).toBe("Newer truth");
+        expect(result.revisions[1].truth).toBe("Older truth");
+        const args = run.mock.calls[0];
+        expect(args[0]).toContain("ORDER BY r.writtenAt DESC");
+        expect(args[0]).toContain("e.accountId = $accountId");
+        expect(args[0]).toContain("r.accountId = $accountId");
+        expect(args[1]).toEqual({ accountId: "acc-1", nodeId: "4:abc:1", limit: 20 });
+    });
+    it("returns an empty list when no revisions exist", async () => {
+        run.mockResolvedValue({ records: [] });
+        const result = await memoryCompiledTruthHistory({
+            accountId: "acc-1",
+            nodeId: "4:abc:2",
+        });
+        expect(result.revisions).toEqual([]);
+    });
+    it("throws when accountId or nodeId is missing", async () => {
+        await expect(memoryCompiledTruthHistory({ accountId: "", nodeId: "4:abc:1" })).rejects.toThrow(/accountId/);
+        await expect(memoryCompiledTruthHistory({ accountId: "acc-1", nodeId: "" })).rejects.toThrow(/nodeId/);
+    });
+});
+describe("memory-compiled-truth-history registration", () => {
+    it("registered in tool server index.ts as an eagerTool", () => {
+        const src = readFileSync(resolve(import.meta.dirname, "../../index.ts"), "utf-8");
+        expect(src).toMatch(/eagerTool\(server,\s*\n?\s*"memory-compiled-truth-history"/);
+        expect(src).toContain('registered tool=memory-compiled-truth-history');
+    });
+    it("declared in PLUGIN.md with admin allowlist", () => {
+        const plugin = readFileSync(resolve(import.meta.dirname, "../../../../PLUGIN.md"), "utf-8");
+        expect(plugin).toContain("name: memory-compiled-truth-history");
+        // verify admin allowlist line follows shortly after the name
+        const idx = plugin.indexOf("name: memory-compiled-truth-history");
+        expect(plugin.slice(idx, idx + 120)).toContain("adminAllowlist: true");
+    });
+});
+//# sourceMappingURL=memory-compiled-truth-history.test.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/__tests__/memory-compiled-truth-history.test.js.map

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

package/payload/platform/plugins/memory/mcp/dist/tools/__tests__/memory-report-tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-report-tools.test.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/__tests__/memory-report-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-report-tools.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/memory-report-tools.test.ts"],"names":[],"mappings":""}