@rubytech/create-sitedesk-code 0.1.530 → 0.1.531

package/payload/platform/plugins/memory/mcp/dist/tools/__tests__/learnings-scan.test.js.map

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

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-derive.d.ts

@@ -0,0 +1,41 @@
+/**
+ * learnings-derive — turn the turn's per-chunk claims into :Learning writes,
+ * then decay what nobody re-observed.
+ *
+ * Reconcile is the two-tier shape profile-update.ts:708-755 already uses for
+ * preferences: embed the claim, take the nearest same-account neighbour over
+ * the vector index, convert the normalised index score back to raw cosine, and
+ * compare against SAME_SUBJECT_COSINE. The claim's stance is explicit
+ * (`reinforce` | `contradict`) exactly as profile-update takes `mode` — the
+ * tool never infers a stance from prose.
+ *
+ * Decay runs here, inside the routine's own pass, NOT at session start.
+ * Preference decay fires only inside loadUserProfile (neo4j-store.ts:2704),
+ * which means an account nobody opens never decays; this does not inherit that.
+ */
+export type ClaimMode = "reinforce" | "contradict";
+export interface Claim {
+    title: string;
+    body: string;
+    mode: ClaimMode;
+}
+export interface LearningsDeriveParams {
+    accountId: string;
+    sessionId: string;
+    claims: Claim[];
+    /** Run the decay pass after the claims land. The overnight routine sets it. */
+    runDecay?: boolean;
+}
+export interface DecaySummary {
+    examined: number;
+    decayed: number;
+    floored: number;
+}
+export interface LearningsDeriveResult {
+    created: number;
+    amplified: number;
+    relegated: number;
+    decay: DecaySummary | null;
+}
+export declare function learningsDerive(params: LearningsDeriveParams): Promise<LearningsDeriveResult>;
+//# sourceMappingURL=learnings-derive.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings-derive.d.ts","sourceRoot":"","sources":["../../src/tools/learnings-derive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;AAGnD,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAkMD,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CA8DhC"}

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-derive.js

@@ -0,0 +1,225 @@
+/**
+ * learnings-derive — turn the turn's per-chunk claims into :Learning writes,
+ * then decay what nobody re-observed.
+ *
+ * Reconcile is the two-tier shape profile-update.ts:708-755 already uses for
+ * preferences: embed the claim, take the nearest same-account neighbour over
+ * the vector index, convert the normalised index score back to raw cosine, and
+ * compare against SAME_SUBJECT_COSINE. The claim's stance is explicit
+ * (`reinforce` | `contradict`) exactly as profile-update takes `mode` — the
+ * tool never infers a stance from prose.
+ *
+ * Decay runs here, inside the routine's own pass, NOT at session start.
+ * Preference decay fires only inside loadUserProfile (neo4j-store.ts:2704),
+ * which means an account nobody opens never decays; this does not inherit that.
+ */
+import { randomUUID } from "node:crypto";
+import { getSession } from "../lib/neo4j.js";
+import { embed } from "../lib/embeddings.js";
+import { SAME_SUBJECT_COSINE } from "../../../../../lib/active-rules/dist/index.js";
+import { LEARNING_CONTRADICTION_DECREMENT, LEARNING_INITIAL_CONFIDENCE, LEARNING_REINFORCEMENT_INCREMENT, decayedConfidence, } from "../../../../../lib/learning-constants/dist/index.js";
+const VALID_MODES = new Set(["reinforce", "contradict"]);
+async function nearestNeighbour(accountId, embedding) {
+    const session = getSession();
+    try {
+        // Over-fetch 25 then filter to this account: the vector index cannot
+        // pre-filter by accountId, and a house install co-resides many
+        // sub-accounts' learnings in one index, so a small topK could let another
+        // account's rows crowd out this account's real same-subject neighbour.
+        const res = await session.run(`
+      CALL db.index.vector.queryNodes('learning_embedding', 25, $embedding)
+      YIELD node AS l, score
+      WHERE l.accountId = $accountId
+      RETURN l.learningId AS learningId, l.title AS title,
+             l.confidence AS confidence, score
+      ORDER BY score DESC
+      LIMIT 1
+      `, { embedding, accountId });
+        const r = res.records[0];
+        if (!r)
+            return null;
+        return {
+            learningId: r.get("learningId"),
+            title: r.get("title"),
+            confidence: r.get("confidence"),
+            // Neo4j's cosine vector index returns a NORMALIZED score (1 + cosine)/2,
+            // not raw cosine. Comparing the raw score directly would fire at raw
+            // cosine ~0.70 and over-merge distinct learnings.
+            similarity: 2 * r.get("score") - 1,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+async function createLearning(accountId, sessionId, claim, embedding, nowIso) {
+    const session = getSession();
+    try {
+        // The :Learning is CREATEd unconditionally and the parent edge is attached
+        // only if a UserProfile exists. Neither of the obvious shapes is safe:
+        // `MATCH (p:UserProfile …) CREATE …` silently no-ops the whole write when
+        // the profile is absent (the hazard profile-update.ts:309-311 documents for
+        // preferences), and `MERGE (p:UserProfile { accountId })` would mint a
+        // profile missing its required `userId` (schema-base.md:32). Account scope
+        // is the `accountId` property, not the edge, so the edge is a convenience
+        // and its absence costs nothing.
+        //
+        // `embedding` is omitted entirely rather than written as [] when the
+        // embedder returned nothing. :Learning is vector-indexed, and a zero-length
+        // vector makes the node permanently invisible to the neighbour query — it
+        // could never be amplified, so every re-observation would mint a duplicate.
+        // That is exactly the rising-total/flat-amplified signature, so it is
+        // logged rather than left to be inferred.
+        await session.run(`
+      CREATE (l:Learning {
+        accountId: $accountId,
+        learningId: $learningId,
+        title: $title,
+        body: $body,
+        confidence: $confidence,
+        observedAt: $observedAt,
+        observationCount: 1,
+        sourceSessionIds: [$sessionId]
+      })
+      WITH l
+      FOREACH (_ IN CASE WHEN $embedding IS NULL THEN [] ELSE [1] END |
+        SET l.embedding = $embedding
+      )
+      WITH l
+      OPTIONAL MATCH (p:UserProfile { accountId: $accountId })
+      FOREACH (_ IN CASE WHEN p IS NULL THEN [] ELSE [1] END |
+        CREATE (p)-[:HAS_LEARNING]->(l)
+      )
+      `, {
+            accountId,
+            learningId: randomUUID(),
+            title: claim.title,
+            body: claim.body,
+            confidence: LEARNING_INITIAL_CONFIDENCE,
+            observedAt: nowIso,
+            sessionId,
+            embedding,
+        });
+        if (embedding === null) {
+            process.stderr.write(`[learnings] op=derive-embed-missing accountId=${accountId} ` +
+                `title=${JSON.stringify(claim.title)} reason=embedder-returned-nothing\n`);
+        }
+    }
+    finally {
+        await session.close();
+    }
+}
+async function applyToExisting(accountId, sessionId, match, mode, nowIso) {
+    const confidence = mode === "reinforce"
+        ? match.confidence + LEARNING_REINFORCEMENT_INCREMENT * (1 - match.confidence)
+        : Math.max(0, match.confidence - LEARNING_CONTRADICTION_DECREMENT);
+    const contradictedClause = mode === "contradict" ? ",\n          l.contradictedAt = $observedAt" : "";
+    const session = getSession();
+    try {
+        await session.run(`
+      MATCH (l:Learning { accountId: $accountId, learningId: $learningId })
+      SET l.confidence = $confidence,
+          l.observedAt = $observedAt,
+          l.observationCount = coalesce(l.observationCount, 0) + 1,
+          l.sourceSessionIds =
+            CASE WHEN $sessionId IN coalesce(l.sourceSessionIds, [])
+                 THEN l.sourceSessionIds
+                 ELSE coalesce(l.sourceSessionIds, []) + $sessionId END${contradictedClause}
+      `, {
+            accountId,
+            learningId: match.learningId,
+            confidence,
+            observedAt: nowIso,
+            sessionId,
+        });
+    }
+    finally {
+        await session.close();
+    }
+    return confidence;
+}
+async function runDecayPass(accountId, now) {
+    const session = getSession();
+    try {
+        // observedAt is an ISO STRING. Comparing it to datetime() in the predicate
+        // yields null for EVERY row, so the pass would report 0 decayed behind an
+        // otherwise healthy log line. The curve is applied in JS instead, off the
+        // same pure function the tests and the injection read use.
+        const res = await session.run(`
+      MATCH (l:Learning { accountId: $accountId })
+      RETURN l.learningId AS learningId, l.confidence AS confidence,
+             l.observedAt AS observedAt
+      `, { accountId });
+        let decayed = 0;
+        let floored = 0;
+        for (const r of res.records) {
+            const learningId = r.get("learningId");
+            const before = r.get("confidence");
+            const observedAt = String(r.get("observedAt"));
+            const after = decayedConfidence(before, observedAt, now);
+            if (after === before)
+                continue;
+            decayed += 1;
+            if (after === 0)
+                floored += 1;
+            await session.run(`MATCH (l:Learning { accountId: $accountId, learningId: $learningId })
+         SET l.confidence = $confidence`, { accountId, learningId, confidence: after });
+        }
+        return { examined: res.records.length, decayed, floored };
+    }
+    finally {
+        await session.close();
+    }
+}
+export async function learningsDerive(params) {
+    const { accountId, sessionId, claims } = params;
+    if (!accountId)
+        throw new Error("learnings-derive: accountId is required");
+    if (!sessionId)
+        throw new Error("learnings-derive: sessionId is required");
+    // Validate every claim before writing any of them, so a bad mode halfway
+    // down the list cannot leave a half-applied batch behind.
+    for (const c of claims) {
+        if (!VALID_MODES.has(c.mode)) {
+            throw new Error(`learnings-derive: Invalid mode "${c.mode}". Must be one of: reinforce, contradict`);
+        }
+    }
+    const now = new Date();
+    const nowIso = now.toISOString();
+    let created = 0;
+    let amplified = 0;
+    let relegated = 0;
+    for (const claim of claims) {
+        const embedding = await embed(`${claim.title}\n${claim.body}`);
+        const match = embedding ? await nearestNeighbour(accountId, embedding) : null;
+        if (match && match.similarity >= SAME_SUBJECT_COSINE) {
+            const after = await applyToExisting(accountId, sessionId, match, claim.mode, nowIso);
+            const action = claim.mode === "reinforce" ? "amplify" : "relegate";
+            if (claim.mode === "reinforce")
+                amplified += 1;
+            else
+                relegated += 1;
+            process.stderr.write(`[learnings] op=derive accountId=${accountId} action=${action} ` +
+                `learningId=${match.learningId} similarity=${match.similarity.toFixed(3)} ` +
+                `confBefore=${match.confidence} confAfter=${after}\n`);
+        }
+        else {
+            await createLearning(accountId, sessionId, claim, embedding ?? null, nowIso);
+            created += 1;
+            process.stderr.write(`[learnings] op=derive accountId=${accountId} action=create ` +
+                `title=${JSON.stringify(claim.title)} confidence=${LEARNING_INITIAL_CONFIDENCE}\n`);
+        }
+    }
+    // Sustained amplified=0 against a rising total is the duplicate signature —
+    // the match path never firing and every claim minting a new node.
+    process.stderr.write(`[learnings] op=derive-summary accountId=${accountId} created=${created} ` +
+        `amplified=${amplified} relegated=${relegated}\n`);
+    let decay = null;
+    if (params.runDecay === true) {
+        decay = await runDecayPass(accountId, now);
+        process.stderr.write(`[learnings] op=decay accountId=${accountId} examined=${decay.examined} ` +
+            `decayed=${decay.decayed} floored=${decay.floored}\n`);
+    }
+    return { created, amplified, relegated, decay };
+}
+//# sourceMappingURL=learnings-derive.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-derive.js.map

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

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-recall.d.ts

@@ -0,0 +1,31 @@
+/**
+ * learnings-recall — the only path from an injected learning title to its body.
+ *
+ * The system prompt carries titles and never bodies (Task 2220). When a turn
+ * matches an indexed title, the learnings-recall skill tells the agent to call
+ * this. The log line lives here, not in the skill: a SKILL.md is prose loaded
+ * into a turn and writes nothing to stderr, so without this tool the
+ * "index injected but never used" failure would be unobservable — and that
+ * measurement is what decides whether MAX_INDEXED_LEARNINGS should fall.
+ */
+export interface RecallRow {
+    learningId: string;
+    title: string;
+    body: string;
+    confidence: number;
+    observedAt: string;
+    observationCount: number;
+    /** Set when a later session disputed this learning. Surfaced so the agent
+     *  can say so rather than acting on it as settled. */
+    contradictedAt: string | null;
+}
+export interface LearningsRecallParams {
+    accountId: string;
+    /** Case-insensitive substring match against title. */
+    title?: string;
+    learningId?: string;
+}
+export declare function learningsRecall(params: LearningsRecallParams): Promise<{
+    rows: RecallRow[];
+}>;
+//# sourceMappingURL=learnings-recall.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings-recall.d.ts","sourceRoot":"","sources":["../../src/tools/learnings-recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB;0DACsD;IACtD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC,CA+DhC"}

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-recall.js

@@ -0,0 +1,67 @@
+/**
+ * learnings-recall — the only path from an injected learning title to its body.
+ *
+ * The system prompt carries titles and never bodies (Task 2220). When a turn
+ * matches an indexed title, the learnings-recall skill tells the agent to call
+ * this. The log line lives here, not in the skill: a SKILL.md is prose loaded
+ * into a turn and writes nothing to stderr, so without this tool the
+ * "index injected but never used" failure would be unobservable — and that
+ * measurement is what decides whether MAX_INDEXED_LEARNINGS should fall.
+ */
+import { getSession } from "../lib/neo4j.js";
+const MAX_ROWS = 5;
+export async function learningsRecall(params) {
+    const { accountId, title, learningId } = params;
+    if (!accountId)
+        throw new Error("learnings-recall: accountId is required");
+    if (!title && !learningId) {
+        throw new Error("learnings-recall: title or learningId is required");
+    }
+    const session = getSession();
+    try {
+        const res = await session.run(`
+      MATCH (l:Learning { accountId: $accountId })
+      WHERE ($learningId IS NULL OR l.learningId = $learningId)
+        AND ($title IS NULL OR toLower(l.title) CONTAINS toLower($title))
+      RETURN l.learningId AS learningId, l.title AS title, l.body AS body,
+             l.confidence AS confidence, l.observedAt AS observedAt,
+             coalesce(l.observationCount, 0) AS observationCount,
+             l.contradictedAt AS contradictedAt
+      ORDER BY l.confidence DESC
+      LIMIT toInteger($limit)
+      `, {
+            accountId,
+            title: title ?? null,
+            learningId: learningId ?? null,
+            limit: MAX_ROWS,
+        });
+        const rows = res.records.map((r) => {
+            const contradictedAt = r.get("contradictedAt");
+            return {
+                learningId: r.get("learningId"),
+                title: r.get("title"),
+                body: r.get("body"),
+                confidence: r.get("confidence"),
+                observedAt: String(r.get("observedAt")),
+                observationCount: Number(r.get("observationCount")),
+                contradictedAt: contradictedAt === null || contradictedAt === undefined
+                    ? null
+                    : String(contradictedAt),
+            };
+        });
+        for (const row of rows) {
+            process.stderr.write(`[learnings] op=recall accountId=${accountId} learningId=${row.learningId} ` +
+                `matchedTitle=${JSON.stringify(row.title)}\n`);
+        }
+        // A miss is still an invocation. Without this line, a week of zero recalls
+        // could not be told apart from a week of recalls that all missed.
+        if (rows.length === 0) {
+            process.stderr.write(`[learnings] op=recall accountId=${accountId} learningId=- matchedTitle=- rows=0\n`);
+        }
+        return { rows };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=learnings-recall.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings-recall.js","sourceRoot":"","sources":["../../src/tools/learnings-recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAqB7C,MAAM,QAAQ,GAAG,CAAC,CAAC;AAEnB,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAA6B;IAE7B,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAChD,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAC3B;;;;;;;;;;OAUC,EACD;YACE,SAAS;YACT,KAAK,EAAE,KAAK,IAAI,IAAI;YACpB,UAAU,EAAE,UAAU,IAAI,IAAI;YAC9B,KAAK,EAAE,QAAQ;SAChB,CACF,CAAC;QAEF,MAAM,IAAI,GAAgB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9C,MAAM,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAC/C,OAAO;gBACL,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAW;gBACzC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAW;gBAC/B,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAW;gBAC7B,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAW;gBACzC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBACvC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBACnD,cAAc,EACZ,cAAc,KAAK,IAAI,IAAI,cAAc,KAAK,SAAS;oBACrD,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;aAC7B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mCAAmC,SAAS,eAAe,GAAG,CAAC,UAAU,GAAG;gBAC1E,gBAAgB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAChD,CAAC;QACJ,CAAC;QACD,2EAA2E;QAC3E,kEAAkE;QAClE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mCAAmC,SAAS,uCAAuC,CACpF,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-scan.d.ts

@@ -0,0 +1,40 @@
+/**
+ * learnings-scan — page session transcripts to the caller's turn.
+ *
+ * Mirrors `conversation-archive-list-chunks` in shape: a read-only pager that
+ * hands bodies to the agent, which emits per-chunk claims in-turn and passes
+ * them to `learnings-derive`. The difference is the source — disk, not Neo4j.
+ *
+ * Counter contract (Task 2220 observability item 1): `candidateFiles` is the
+ * on-disk .jsonl count BEFORE filtering. candidateFiles>0 with sessions=0 is a
+ * broken sinceIso comparison; both zero on an install with known-closed
+ * sessions is a broken enumerator path. Without the pre-filter count the two
+ * are indistinguishable and both read as a quiet night.
+ */
+export interface LearningsScanParams {
+    accountId: string;
+    /** Only sessions whose last write is strictly after this. Omit for all. */
+    sinceIso?: string;
+    sessionOffset?: number;
+    sessionLimit?: number;
+    /** Zero-based chunk within each returned session. Default 0. */
+    chunkIndex?: number;
+    /** Turns per chunk (1..200). Default 40. */
+    chunkTurns?: number;
+}
+export interface ScanRow {
+    sessionId: string;
+    lastWriteIso: string;
+    chunkIndex: number;
+    totalChunks: number;
+    body: string;
+}
+export interface LearningsScanResult {
+    candidateFiles: number;
+    sessions: number;
+    skipped: number;
+    sinceIso: string | null;
+    rows: ScanRow[];
+}
+export declare function learningsScan(params: LearningsScanParams): Promise<LearningsScanResult>;
+//# sourceMappingURL=learnings-scan.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings-scan.d.ts","sourceRoot":"","sources":["../../src/tools/learnings-scan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAsD9B"}

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-scan.js

@@ -0,0 +1,55 @@
+/**
+ * learnings-scan — page session transcripts to the caller's turn.
+ *
+ * Mirrors `conversation-archive-list-chunks` in shape: a read-only pager that
+ * hands bodies to the agent, which emits per-chunk claims in-turn and passes
+ * them to `learnings-derive`. The difference is the source — disk, not Neo4j.
+ *
+ * Counter contract (Task 2220 observability item 1): `candidateFiles` is the
+ * on-disk .jsonl count BEFORE filtering. candidateFiles>0 with sessions=0 is a
+ * broken sinceIso comparison; both zero on an install with known-closed
+ * sessions is a broken enumerator path. Without the pre-filter count the two
+ * are indistinguishable and both read as a quiet night.
+ */
+import { chunkTranscript, claudeProjectsRoot, enumerateSessionJsonls, readSidecarAccountId, sessionLastWriteIso, } from "../lib/session-jsonl.js";
+const DEFAULT_SESSION_LIMIT = 5;
+const MAX_SESSION_LIMIT = 25;
+const DEFAULT_CHUNK_TURNS = 40;
+const MAX_CHUNK_TURNS = 200;
+export async function learningsScan(params) {
+    const { accountId } = params;
+    if (!accountId)
+        throw new Error("learnings-scan: accountId is required");
+    const sinceIso = params.sinceIso ?? null;
+    const sinceMs = sinceIso === null ? null : Date.parse(sinceIso);
+    if (sinceMs !== null && Number.isNaN(sinceMs)) {
+        // Fail rather than fall through to "scan everything": a malformed
+        // watermark that silently widened the scan would re-process every session
+        // and amplify every learning toward 1.0.
+        throw new Error(`learnings-scan: sinceIso is not a valid ISO timestamp: ${sinceIso}`);
+    }
+    const sessionLimit = Math.min(Math.max(1, params.sessionLimit ?? DEFAULT_SESSION_LIMIT), MAX_SESSION_LIMIT);
+    const sessionOffset = Math.max(0, params.sessionOffset ?? 0);
+    const chunkTurns = Math.min(Math.max(1, params.chunkTurns ?? DEFAULT_CHUNK_TURNS), MAX_CHUNK_TURNS);
+    const chunkIndex = Math.max(0, params.chunkIndex ?? 0);
+    // Throws when CLAUDE_CONFIG_DIR is absent. Never defaulted.
+    const projectsRoot = claudeProjectsRoot();
+    const { files, candidateFiles, skipped } = enumerateSessionJsonls(projectsRoot);
+    const eligible = files
+        .filter((f) => !f.isSubagent && !f.archived)
+        .filter((f) => readSidecarAccountId(f.path) === accountId)
+        .map((f) => ({ file: f, lastWriteIso: sessionLastWriteIso(f.path) }))
+        .filter((e) => e.lastWriteIso !== null)
+        .filter((e) => sinceMs === null || Date.parse(e.lastWriteIso) > sinceMs)
+        .sort((a, b) => a.lastWriteIso.localeCompare(b.lastWriteIso));
+    const page = eligible.slice(sessionOffset, sessionOffset + sessionLimit);
+    const rows = page.map(({ file, lastWriteIso }) => {
+        const { body, totalChunks } = chunkTranscript(file.path, chunkIndex, chunkTurns);
+        return { sessionId: file.sessionId, lastWriteIso, chunkIndex, totalChunks, body };
+    });
+    process.stderr.write(`[learnings] op=scan accountId=${accountId} sinceIso=${sinceIso ?? "-"} ` +
+        `candidateFiles=${candidateFiles} sessions=${eligible.length} skipped=${skipped} ` +
+        `returned=${rows.length}\n`);
+    return { candidateFiles, sessions: eligible.length, skipped, sinceIso, rows };
+}
+//# sourceMappingURL=learnings-scan.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/learnings-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings-scan.js","sourceRoot":"","sources":["../../src/tools/learnings-scan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,eAAe,GAAG,GAAG,CAAC;AA8B5B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA2B;IAE3B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAEzE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC;IACzC,MAAM,OAAO,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,kEAAkE;QAClE,0EAA0E;QAC1E,yCAAyC;QACzC,MAAM,IAAI,KAAK,CACb,0DAA0D,QAAQ,EAAE,CACrE,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,YAAY,IAAI,qBAAqB,CAAC,EACzD,iBAAiB,CAClB,CAAC;IACF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACzB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAC,EACrD,eAAe,CAChB,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IAEvD,4DAA4D;IAC5D,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;IAC1C,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAEhF,MAAM,QAAQ,GAAG,KAAK;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;SAC3C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;SACzD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SACpE,MAAM,CACL,CAAC,CAAC,EAAuD,EAAE,CACzD,CAAC,CAAC,YAAY,KAAK,IAAI,CAC1B;SACA,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC;SACvE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IAEhE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,aAAa,GAAG,YAAY,CAAC,CAAC;IACzE,MAAM,IAAI,GAAc,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE;QAC1D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QACjF,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iCAAiC,SAAS,aAAa,QAAQ,IAAI,GAAG,GAAG;QACvE,kBAAkB,cAAc,aAAa,QAAQ,CAAC,MAAM,YAAY,OAAO,GAAG;QAClF,YAAY,IAAI,CAAC,MAAM,IAAI,CAC9B,CAAC;IAEF,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAChF,CAAC"}

package/payload/platform/plugins/memory/references/schema-base.md

@@ -30,6 +30,7 @@ When loading this reference, confirm which schema files were consulted by noting
 | Address | `PostalAddress` | `schema:PostalAddress` | — | `streetAddress`, `addressLocality`, `postalCode` |
 | Task | `Task` | `schema:Action` (semantics) | — | `accountId`, `taskId`, `name`, `status`, `priority` |
 | UserProfile | `UserProfile` | platform-native | — | `accountId`, `userId` |
+| Learning | `Learning` | platform-native | — | `accountId`, `learningId`, `title`, `body`, `confidence`, `observedAt`, `observationCount`, `sourceSessionIds` |
 | Lead | `Lead` | `cdm:Lead` | CDM only | `accountId`, `subject`, `customer` (id), `status` |
 | Case | `Case` | `cdm:Case` | CDM only | `accountId`, `title`, `customer` (id), `status`, `priority` |
 | OpeningHours | `OpeningHoursSpecification` | `schema:OpeningHoursSpecification` | Schema.org JSON-LD | `accountId`, `dayOfWeek`, `opens`, `closes` |
@@ -66,6 +67,8 @@ When loading this reference, confirm which schema files were consulted by noting
 
 **DefinedTerm** covers reusable concepts, learnings, and glossary entries — e.g. project retrospective learnings (`name` is a short handle, `description` is the full learning). Additional properties like `category` are encouraged but not required.
 
+**Learning** is not a DefinedTerm and the two must not be conflated. A `DefinedTerm` is a glossary entry: it is written once, carries no confidence, never decays, and is retrieved by search. A `Learning` is a claim with a lifecycle — it is created at `0.5`, amplified each time a later session re-observes it, decremented and stamped `contradictedAt` when a session disputes it, and decayed linearly once nobody has re-observed it for fourteen days. Write a `DefinedTerm` when the operator is defining what a thing *is*; write a `Learning` when a session established that something *holds*, and you expect future sessions to confirm or dispute it. A `Learning` hangs off the account's `UserProfile` by `(:UserProfile)-[:HAS_LEARNING]->(:Learning)`, the same parenting `Preference` uses. `confidence` is a float in `[0,1]`; `observedAt` is an ISO string; `observationCount` is the number of distinct sessions that produced the claim; `sourceSessionIds` is the list of those session ids. `contradictedAt` is optional and stamped only when a later claim contradicted the learning. Only the `title` reaches a system prompt; the `body` is fetched on demand through the `learnings-recall` skill.
+
 **Position** carries a single role held by a `UserProfile` at an `Organization` — its title, dates, and per-role properties (e.g. achievement bullets in `description`, `endDate` for a finished role). Each role is its own node so it can carry its own structure; multiple Positions per UserProfile (career history); one Organization may host many Positions across many UserProfiles. Written by the `document-ingest` skill when a CV section classifies as `Position`. The natural pattern is `(:UserProfile)-[:HAS_POSITION]->(:Position)-[:AT]->(:Organization)` — never set the employer name as a property on Position; always create the AT edge to the (MERGEd) Organization.
 
 **`authorshipMode` on content labels.** Every `:KnowledgeDocument`, `:ConversationArchive` (every chat transcript parent, including email threads under `source:'email'`), `:Message`, `:SocialPost`, and `:Section` write carries an `authorshipMode` enum drawn from `human-only | human-led-agent-assisted | agent-led-human-reviewed | agent-only | unknown`. The value records who actually wrote the content body, not who triggered the write. `human-only` means every word of the body came from the operator; `human-led-agent-assisted` is operator-authored with light agent polish (the operator chose every claim and structure); `agent-led-human-reviewed` is agent-drafted then operator-edited before send; `agent-only` is pure agent output the operator did not touch. The voice-mirror distillation walks the corpus where `authorshipMode IN ['human-only', 'human-led-agent-assisted']` — both modes carry voice signal. `:ConversationArchive` `:Section` chunks (WhatsApp / Telegram / Signal / Granola / Otter / Circleback exports ingested under `(:ConversationArchive)-[:HAS_SECTION]->(:Section)`) are first-class voice corpus and the highest-leverage signal source because chat captures the unguarded voice in a way email rarely does. Legacy nodes default to `unknown` until reclassified via the voice-mirror backfill flow. The per-label authorshipMode index on `:Section` covers transcript chunks without a secondary label. Writers that cannot determine the mode (e.g. bulk archive imports) write `unknown` rather than guessing.

package/payload/platform/plugins/memory/skills/learnings-recall/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: learnings-recall
+description: "Fetch the full text of a learning whose title is already in your system prompt. Activate when the current turn is about a topic named in the learnings index, when you are about to repeat work a past session already resolved, or when the operator says 'what did we learn about X', 'have we hit this before', 'did we solve this already', or 'check the learnings'."
+---
+
+# Learnings recall
+
+Your system prompt carries a list of learning **titles**, not their text. A
+title is a handle, not the knowledge. When the turn in front of you is about
+one of those titles, fetch the body before acting.
+
+Call `learnings-recall` with the title as written in the index, or with a
+`learningId` if you have one. It returns the full body, the confidence, when it
+was last observed, how many sessions produced it, and whether a later session
+disputed it.
+
+Judge what comes back. A learning at low confidence, or one carrying a
+`contradictedAt` stamp, is evidence that something was once believed and later
+disputed — say so rather than acting on it as settled. A learning observed
+across many sessions is stronger than one seen once, and `observationCount`
+tells you which you have.
+
+Do not call this speculatively on every turn. The index exists so you can tell,
+cheaply, whether a body is worth fetching. Fetching a body nobody needed is the
+cost the title/body split was built to avoid.
+
+If the turn matches no indexed title, this skill has nothing to add. Carry on.

package/payload/platform/plugins/whatsapp/mcp/dist/index.js

@@ -51,7 +51,7 @@ function textResult(text, isError = false) {
 // ─── whatsapp-login-start ──────────────────────────────────────────────
 lifelineTool(server, "whatsapp-login-start", 'Start WhatsApp pairing. Requires the operator\'s WhatsApp phone number (E.164). Returns an 8-character pairing code the operator types into WhatsApp → Linked Devices → Link a Device → "Link with phone number instead." No QR image — this surface is an async chat where a rotating QR cannot be scanned in time.', {
     phone: z.string().describe("WhatsApp phone number in E.164 (e.g. +441234567890) — the number being linked"),
-    accountId: z.string().optional().describe('Account ID (default: "default")'),
+    accountId: z.string().optional().describe('Account ID. Defaults to the calling session’s own account; the house admin may pass another account id explicitly.'),
     force: z.boolean().optional().describe("Force re-link even if already connected"),
 }, async ({ phone, accountId, force }) => {
     try {
@@ -66,7 +66,7 @@ lifelineTool(server, "whatsapp-login-start", 'Start WhatsApp pairing. Requires t
 });
 // ─── whatsapp-login-wait ───────────────────────────────────────────────
 lifelineTool(server, "whatsapp-login-wait", "Wait for the operator to enter the WhatsApp pairing code and the connection to establish. Call after whatsapp-login-start. Polls for up to 60 seconds; the pairing code stays valid and the login stays alive across polls, so call again to keep waiting.", {
-    accountId: z.string().optional().describe('Account ID (default: "default")'),
+    accountId: z.string().optional().describe('Account ID. Defaults to the calling session’s own account; the house admin may pass another account id explicitly.'),
     timeoutMs: z.number().optional().describe("Max wait time in ms (default: 60000)"),
 }, async ({ accountId, timeoutMs }) => {
     try {
@@ -151,7 +151,7 @@ lifelineTool(server, "whatsapp-activity", "Get WhatsApp channel activity — mes
 });
 // ─── whatsapp-disconnect ───────────────────────────────────────────────
 lifelineTool(server, "whatsapp-disconnect", "Disconnect a WhatsApp account. Closes the Baileys WebSocket connection cleanly.", {
-    accountId: z.string().optional().describe('Account ID to disconnect (default: "default")'),
+    accountId: z.string().optional().describe('Account ID to disconnect. Defaults to the calling session’s own account; the house admin may pass another account id explicitly.'),
 }, async ({ accountId }) => {
     try {
         const result = await callApi("whatsapp-disconnect", "/api/whatsapp/disconnect", "POST", { accountId }, callerScopeHeaders(process.env));
@@ -206,7 +206,7 @@ lifelineTool(server, "whatsapp-config", [
     mode: z.enum(["active", "passive"]).optional().describe("Account-manager mode for add-account-manager (default 'active'). 'active' = a full admin session that can reply and manage the sub-account. 'passive' = a constrained requirement-intake agent: it interprets each message, files exactly one task scoped to the sub-account, and never replies."),
     slug: z.string().optional().describe("Agent slug (required for set-public-agent)"),
     fields: z.string().optional().describe('JSON string of config fields to update (required for update-config, e.g. \'{"dmPolicy":"open","allowFrom":["*"]}\')'),
-    accountId: z.string().optional().describe('Account ID (default: "default"). Used by list-groups and set-dispatch-inbound.'),
+    accountId: z.string().optional().describe('Account ID. Defaults to the calling session’s own account; the house admin may pass another account id explicitly. Used by list-groups and set-dispatch-inbound.'),
     dispatchInbound: z.boolean().optional().describe("For set-dispatch-inbound: false makes the account an observe socket (stored + readable, never dispatched); true restores agent dispatch."),
 }, async ({ action, phone, managesAccount, mode, slug, fields, accountId, dispatchInbound }) => {
     try {