@rubytech/create-maxy-code 0.1.132 → 0.1.140

package/payload/platform/plugins/memory/mcp/dist/lib/compiled-truth-rewriter.js

@@ -0,0 +1,99 @@
+// Compiled-truth rewriter (Task 306).
+//
+// Given a node's current `compiledTruth` and its most-recent N :TimelineEvent
+// rows, produce a new compiledTruth ≤ 2000 chars. Strictly OAuth-bearer LLM
+// (admin classifier doctrine — never API key). The skill / agent / backfill
+// caller is responsible for: (a) selecting which node to rewrite, (b)
+// enforcing the 7-day operator-edit cooldown, (c) writing the result back.
+// This library is the prompt + LLM call + cap-enforcement only.
+//
+// Output style baseline (this sprint):
+//   - ≤ COMPILED_TRUTH_MAX_CHARS
+//   - Neutral, declarative voice. Third person.
+//   - No hedging adverbs ("likely", "perhaps", "possibly", "presumably").
+//   - No first person ("I", "we"), no second person ("you").
+//   - No marketing / superlatives.
+//
+// Voice grafting (no AI tells, IDENTITY alignment, BrainBench eval) is
+// deferred — see follow-up task referenced in the task brief.
+import { callOauthLlm, } from "../../../../../lib/oauth-llm/dist/index.js";
+import { COMPILED_TRUTH_MAX_CHARS } from "./graph-write-gate.js";
+const DEFAULT_MODEL = "claude-haiku-4-5";
+const SYSTEM_PROMPT = [
+    "You are the compiled-truth rewriter for a personal knowledge graph.",
+    "",
+    "Your job: produce a neutral, declarative summary of what the operator knows about a subject right now.",
+    "",
+    "RULES (all binding, never relaxed):",
+    `- Output must be ${COMPILED_TRUTH_MAX_CHARS} characters or fewer. This is a hard cap.`,
+    "- Third person only. No 'I', 'we', 'you', 'us'.",
+    "- Declarative voice. No hedging adverbs (likely, perhaps, possibly, presumably, apparently, seemingly).",
+    "- No marketing, no superlatives, no commentary on the operator's relationship with the subject.",
+    "- Restate the most-load-bearing facts from the timeline. Drop trivia.",
+    "- If the existing compiledTruth contradicts the timeline, the timeline wins.",
+    "- Do not invent details that are not present in either the existing truth or the timeline.",
+    "- Do not add a preamble (no 'Here is the summary:'). Output the summary directly.",
+].join("\n");
+function buildUserMessage(p) {
+    const lines = [];
+    lines.push(`Subject: ${p.subjectName}`);
+    lines.push(`Label: :${p.subjectLabel}`);
+    lines.push("");
+    lines.push("Current compiledTruth:");
+    lines.push(p.currentTruth ? p.currentTruth : "(empty)");
+    lines.push("");
+    lines.push(`Timeline events (newest-first, ${p.events.length} shown):`);
+    for (const e of p.events) {
+        lines.push(`- [${e.occurredAt}] kind=${e.kind}: ${e.summary}`);
+    }
+    lines.push("");
+    lines.push("Rewrite the compiledTruth.");
+    return lines.join("\n");
+}
+function isOkText(r) {
+    return r.kind === "ok";
+}
+export async function rewriteCompiledTruth(p) {
+    if (p.events.length === 0) {
+        console.log(`[compiled-truth-rewriter] refused subject="${p.subjectName}" reason=no-events`);
+        return { kind: "refused", reason: "no-events" };
+    }
+    const userMessage = buildUserMessage(p);
+    const result = await callOauthLlm({
+        model: p.model ?? DEFAULT_MODEL,
+        system: SYSTEM_PROMPT,
+        userMessage,
+        maxTokens: 1024,
+    });
+    if (!isOkText(result)) {
+        console.log(`[compiled-truth-rewriter] llm-failure subject="${p.subjectName}" cause=${result.cause}`);
+        return { kind: "llm-failure", fallback: result };
+    }
+    const truth = result.text.trim();
+    const before = p.currentTruth.length;
+    const after = truth.length;
+    console.log(`[compiled-truth-rewriter] subject="${p.subjectName}" charsBefore=${before} charsAfter=${after} events=${p.events.length}`);
+    if (after > COMPILED_TRUTH_MAX_CHARS) {
+        // One retry with a stricter prompt before surfacing the over-cap failure.
+        // Per eng review: avoids losing the rewrite on a single LLM verbosity slip.
+        const stricterResult = await callOauthLlm({
+            model: p.model ?? DEFAULT_MODEL,
+            system: SYSTEM_PROMPT +
+                `\n\nPRIOR ATTEMPT WAS ${after} CHARACTERS — TOO LONG. ` +
+                `Tighten to fit ${COMPILED_TRUTH_MAX_CHARS}. Drop the lowest-value sentences first.`,
+            userMessage,
+            maxTokens: 1024,
+        });
+        if (!isOkText(stricterResult)) {
+            return { kind: "llm-failure", fallback: stricterResult };
+        }
+        const retry = stricterResult.text.trim();
+        if (retry.length > COMPILED_TRUTH_MAX_CHARS) {
+            console.log(`[compiled-truth-rewriter] still-too-long subject="${p.subjectName}" retryLen=${retry.length}`);
+            return { kind: "too-long", attemptedLen: retry.length };
+        }
+        return { kind: "ok", compiledTruth: retry };
+    }
+    return { kind: "ok", compiledTruth: truth };
+}
+//# sourceMappingURL=compiled-truth-rewriter.js.map

package/payload/platform/plugins/memory/mcp/dist/lib/compiled-truth-rewriter.js.map

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

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

@@ -34,5 +34,26 @@ export type GateResult = {
     subReason: "no-admin-user-node" | "admin-user-no-accountid" | "no-business-or-personal-profile";
     message: string;
 };
+/** Compiled-truth cap. ≤2000 chars ≈ 300 words — forces the rewriter to summarise, not transcribe. */
+export declare const COMPILED_TRUTH_MAX_CHARS = 2000;
+export type PropertyGateResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: "compiled-truth-too-long";
+    message: string;
+};
+/**
+ * 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.
+ *
+ * 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 declare function checkPropertyWriteGate(args: {
+    properties: Record<string, unknown>;
+}): PropertyGateResult;
 export declare function checkGraphWriteGate(args: GateArgs): Promise<GateResult>;
 //# sourceMappingURL=graph-write-gate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"graph-write-gate.d.ts","sourceRoot":"","sources":["../../src/lib/graph-write-gate.ts"],"names":[],"mappings":"AAuCA,MAAM,WAAW,WAAW;IAC1B,GAAG,CACD,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,eAAe,GAAG,mBAAmB,CAAC;IAC9C,SAAS,EACL,oBAAoB,GACpB,yBAAyB,GACzB,iCAAiC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAaN,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAuD7E"}
+{"version":3,"file":"graph-write-gate.d.ts","sourceRoot":"","sources":["../../src/lib/graph-write-gate.ts"],"names":[],"mappings":"AAuCA,MAAM,WAAW,WAAW;IAC1B,GAAG,CACD,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,eAAe,GAAG,mBAAmB,CAAC;IAC9C,SAAS,EACL,oBAAoB,GACpB,yBAAyB,GACzB,iCAAiC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,sGAAsG;AACtG,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,GAAG,kBAAkB,CAerB;AAaD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAuD7E"}

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

@@ -36,6 +36,30 @@
 // account, add a composite index on Person(accountId, role) so the
 // hasPersonalProfile subquery doesn't full-scan. Same scaling concern applies
 // to LocalBusiness(accountId) and AdminUser(accountId). Not in 704 scope.
+/** 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.
+ *
+ * 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.`,
+        };
+    }
+    return { ok: true };
+}
 const EXEMPT_LABELS = new Set([
     "Person",
     "LocalBusiness",

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":"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"}
+{"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/timeline-extractor.d.ts

@@ -0,0 +1,13 @@
+export interface DatedStatement {
+    occurredAt: string;
+    summary: string;
+    /** The literal date phrase that triggered the match. Useful for diagnostics. */
+    matched: string;
+}
+/**
+ * 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).
+ */
+export declare function extractDatedStatements(body: string | null | undefined): DatedStatement[];
+//# sourceMappingURL=timeline-extractor.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,151 @@
+// Deterministic dated-statement extractor for Task 306.
+//
+// Reads a free-text body and returns one row per parseable dated statement.
+// Strictly deterministic — no LLM, no heuristics that could collapse to a
+// catch-all. The 305 typed-edge post-write hook upgrades `kind` from the
+// default "mentioned" to a more specific value asynchronously; until then
+// rows land as `mentioned`, which is the most-faithful default.
+//
+// Date forms recognised (in priority order):
+//   1. ISO date           — 2026-03-10, 2026/03/10
+//   2. Day-month-year     — 10 March 2026, 10 Mar 2026
+//   3. Month-year         — March 2026, Mar 2026
+//   4. "in YYYY"          — "in 2018"
+//   5. "since YYYY"       — "since 2018"
+//   6. Bare year          — 2018 (only when 1900-2099 and surrounded by word boundaries)
+//
+// Coarse forms (bare year, "in YYYY") parse to YYYY-01-01T00:00:00Z so the
+// `occurredAt` index is queryable. Day-precision forms parse exactly.
+//
+// A statement is the sentence containing the parsed date. Summaries
+// truncate to 500 chars at sentence boundaries when possible.
+const MONTHS = {
+    jan: 1, january: 1,
+    feb: 2, february: 2,
+    mar: 3, march: 3,
+    apr: 4, april: 4,
+    may: 5,
+    jun: 6, june: 6,
+    jul: 7, july: 7,
+    aug: 8, august: 8,
+    sep: 9, sept: 9, september: 9,
+    oct: 10, october: 10,
+    nov: 11, november: 11,
+    dec: 12, december: 12,
+};
+const SUMMARY_MAX = 500;
+function pad(n) {
+    return n < 10 ? `0${n}` : String(n);
+}
+function isoDay(year, month, day) {
+    return `${year}-${pad(month)}-${pad(day)}T00:00:00Z`;
+}
+function isoMonth(year, month) {
+    return `${year}-${pad(month)}-01T00:00:00Z`;
+}
+function isoYear(year) {
+    return `${year}-01-01T00:00:00Z`;
+}
+function validYear(y) {
+    return y >= 1900 && y <= 2099;
+}
+function validMonth(m) {
+    return m >= 1 && m <= 12;
+}
+function validDay(d) {
+    return d >= 1 && d <= 31;
+}
+/** Split body into sentences (period / question / exclamation followed by space or end). */
+function splitSentences(body) {
+    return body
+        .split(/(?<=[.?!])\s+/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+function clampSummary(s) {
+    if (s.length <= SUMMARY_MAX)
+        return s;
+    // Truncate at the last sentence boundary inside the cap, else hard-truncate.
+    const sliced = s.slice(0, SUMMARY_MAX);
+    const lastBoundary = Math.max(sliced.lastIndexOf(". "), sliced.lastIndexOf("? "), sliced.lastIndexOf("! "));
+    if (lastBoundary > SUMMARY_MAX * 0.5) {
+        return sliced.slice(0, lastBoundary + 1);
+    }
+    return sliced.slice(0, SUMMARY_MAX - 1) + "…";
+}
+/**
+ * Returns null if the sentence has no parseable date; otherwise the first
+ * matching date and its ISO normalisation.
+ */
+function parseFirstDate(sentence) {
+    // 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) {
+        const y = Number(iso[1]);
+        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] };
+        }
+    }
+    // 2. Day-month-year: "10 March 2026" / "10 Mar 2026"
+    const dmy = sentence.match(/\b(\d{1,2})\s+([A-Za-z]+)\s+(\d{4})\b/);
+    if (dmy) {
+        const d = Number(dmy[1]);
+        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] };
+        }
+    }
+    // 3. Month-year: "March 2026" / "Mar 2026"
+    const my = sentence.match(/\b([A-Za-z]+)\s+(\d{4})\b/);
+    if (my) {
+        const m = MONTHS[my[1].toLowerCase()];
+        const y = Number(my[2]);
+        if (m && validYear(y)) {
+            return { occurredAt: isoMonth(y, m), matched: my[0] };
+        }
+    }
+    // 4 + 5. "in YYYY" / "since YYYY"
+    const inYear = sentence.match(/\b(?:in|since)\s+(\d{4})\b/i);
+    if (inYear) {
+        const y = Number(inYear[1]);
+        if (validYear(y)) {
+            return { occurredAt: isoYear(y), matched: inYear[0] };
+        }
+    }
+    // 6. 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 null;
+}
+/**
+ * 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).
+ */
+export function extractDatedStatements(body) {
+    if (!body || typeof body !== "string")
+        return [];
+    const out = [];
+    for (const sentence of splitSentences(body)) {
+        const hit = parseFirstDate(sentence);
+        if (hit) {
+            out.push({
+                occurredAt: hit.occurredAt,
+                summary: clampSummary(sentence),
+                matched: hit.matched,
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=timeline-extractor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-extractor.js","sourceRoot":"","sources":["../../src/lib/timeline-extractor.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,yEAAyE;AACzE,0EAA0E;AAC1E,gEAAgE;AAChE,EAAE;AACF,6CAA6C;AAC7C,mDAAmD;AACnD,uDAAuD;AACvD,iDAAiD;AACjD,sCAAsC;AACtC,yCAAyC;AACzC,yFAAyF;AACzF,EAAE;AACF,2EAA2E;AAC3E,sEAAsE;AACtE,EAAE;AACF,oEAAoE;AACpE,8DAA8D;AAS9D,MAAM,MAAM,GAA2B;IACrC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IAChB,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IAChB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC;IAC7B,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;IACpB,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE;IACrB,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE;CACtB,CAAC;AAEF,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW;IACtD,OAAO,GAAG,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC;AACvD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa;IAC3C,OAAO,GAAG,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC;AAC9C,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,GAAG,IAAI,kBAAkB,CAAC;AACnC,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,4FAA4F;AAC5F,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,KAAK,CAAC,eAAe,CAAC;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,IAAI,CAAC,CAAC,MAAM,IAAI,WAAW;QAAE,OAAO,CAAC,CAAC;IACtC,6EAA6E;IAC7E,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EACxB,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EACxB,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CACzB,CAAC;IACF,IAAI,YAAY,GAAG,WAAW,GAAG,GAAG,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,QAAgB;IACtC,wCAAwC;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACpE,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACpE,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACvD,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7D,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,yEAAyE;IACzE,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACxE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA+B;IACpE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACjD,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,KAAK,MAAM,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,IAAI,CAAC;gBACP,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC;gBAC/B,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/payload/platform/plugins/memory/mcp/dist/lib/typed-edge-pass.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Typed-edge auto-extraction pass.
+ *
+ * Runs once per session at the retrospective turn (admin-spawned via
+ * database-operator), or as a one-off backfill. Reads prose-bearing
+ * nodes (Message/Page/Meeting/Email/Idea/Note/Post/Report) the operator's
+ * account wrote since `sinceIso`, batches them, asks Haiku for typed-edge
+ * proposals against the `TYPED_EDGE_ALLOWLIST` schema, validates each
+ * proposal inline, and MERGEs accepted edges directly via Cypher with
+ * `createdBy` provenance.
+ *
+ * Continue-on-error: per-batch Haiku failure increments `failed`; per-edge
+ * MERGE failure increments `rejected`. A single bad batch never bricks the
+ * pass — partial results are returned to the caller.
+ *
+ * The pass does NOT route through `graph-write-gate`: that gate is a
+ * node-precondition surface (AdminUser + LocalBusiness must exist), not
+ * an edge-schema validator. Edge validation is owned here against
+ * `TYPED_EDGE_ALLOWLIST`.
+ *
+ * Auth: Haiku is called via Claude Code OAuth — never the Anthropic API key.
+ */
+import type { Session } from "neo4j-driver";
+export interface RunTypedEdgePassArgs {
+    /** Neo4j session — caller owns the lifecycle. */
+    session: Session;
+    /** Account scope. Required: cross-account writes are impossible by query design. */
+    accountId: string;
+    /**
+     * Lower bound on `node.updatedAt` for the enumeration. The session-end
+     * retrospective passes the session-start timestamp; backfill passes null
+     * to mean "all prose nodes ever written in this account".
+     */
+    sinceIso: string | null;
+    /** Nodes per Haiku call. Default 8. */
+    batchSize?: number;
+    /** Conversation id to stamp on `createdBy` provenance. Optional (backfill mode has none). */
+    conversationId?: string | null;
+    /**
+     * Cap on total nodes processed in one invocation. The backfill pages
+     * through Neo4j in 500-node chunks; the retrospective passes its session's
+     * worth of nodes and never trips this. Default 500.
+     */
+    maxNodes?: number;
+}
+export interface TypedEdgePassResult {
+    nodes: number;
+    proposed: number;
+    accepted: number;
+    rejected: number;
+    failed: number;
+    ms: number;
+}
+export declare function runTypedEdgePass(args: RunTypedEdgePassArgs): Promise<TypedEdgePassResult>;
+//# sourceMappingURL=typed-edge-pass.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/lib/typed-edge-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-edge-pass.d.ts","sourceRoot":"","sources":["../../src/lib/typed-edge-pass.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAc5C,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ;AA4SD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiF/F"}