@rubytech/create-sitedesk-code 0.1.530 → 0.1.532

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":"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"}

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/scheduling/PLUGIN.md

@@ -262,7 +262,7 @@ An `action` invokes one pre-encoded MCP tool with no reasoning. When a due event
 - `destination` — the E.164 phone (WhatsApp) or chat id (Telegram) to run the turn for and reply to. It **must already be a registered admin or account-manager** on that channel; a destination that is not is rejected when the event is created. For WhatsApp the authoritative admin/manager lists are read from the socket-owning **house** account (never the event's own account), and the destination's registered account must match the account that created the schedule: an admin belongs to the house, a manager to its bound sub-account. The house/owner account may target any registered admin or manager; a sub-account is locked to its own manager(s). A refusal names the true reason — `not-registered` (in no house list) or `cross-account` (registered to a different account, naming both accounts).
 - `prompt` — the instruction the agent runs.
 
-An event carries **either** an `action` **or** an `agentDispatch`, never both — setting one clears the other. Agent dispatch is stored as `agentChannel`, `agentDestination`, `agentPrompt`. Use `schedule-update` with `agentDispatch` to modify or `agentDispatch: null` to clear. On WhatsApp, a destination bound as an account-manager scopes the spawned session to its sub-account; on Telegram the session runs on the house account.
+An event carries **either** an `action` **or** an `agentDispatch`, never both — setting one clears the other. Agent dispatch is stored as `agentChannel`, `agentDestination`, `agentPrompt`. Use `schedule-update` with `agentDispatch` to modify or `agentDispatch: null` to clear. On WhatsApp, a destination bound as an account-manager scopes the spawned session to its sub-account — unless that same phone is also on the house `adminPhones` list, in which case it scopes to the channel account, because the dispatch rides the house socket and so arrives from the house number. On Telegram the session runs on the house account.
 
 A WhatsApp `agentDispatch` destination may therefore be an account manager, not only an admin phone — this is the supported way to send a manager a proactive or scheduled WhatsApp message. The reply is delivered over the house's paired line regardless of which sub-account the session is scoped to; socket ownership never restricts which number the dispatch can reach.
 

package/payload/platform/plugins/whatsapp/PLUGIN.md

@@ -106,7 +106,7 @@ A native admin channel session runs a per-sender `whatsapp-channel` MCP server (
 
 ## Agent-initiated admin send
 
-`whatsapp-send-admin` is the one outbound path that does **not** require a bound inbound conversation, so a webchat session or a scheduled run can push a text summary over WhatsApp. It is hard-gated to the cold-send-ban carve-out: the destination must already be a **registered recipient** — on the house `whatsapp.adminPhones` list (managed via `whatsapp-config add-admin-phone`) **or** a registered account manager in `whatsapp.accountManagers` (managed via `whatsapp-config add-account-manager`). Both lists are read from the socket-owning house account (`resolveAccount`), and the send always rides the house's paired socket. A destination in neither list is refused with `[whatsapp:outbound] op=send-refused reason=not-admin-phone` and no send is attempted — never a cold first contact. An **account-manager** phone (in `accountManagers`, disjoint from `adminPhones`) **is** a valid `send-admin` destination regardless of its binding mode: the operator registered it, so it is not a cold stranger. `passive` governs the manager's **inbound** behaviour only (no auto-reply, intake-only) and never gates this outbound send. A successful send logs its admit basis (`op=send-admin-ok via=admin-phone|account-manager`). Delivery reuses `sendTextMessage`, so the sent id is tracked for echo suppression and the send is recorded as outbound activity. Text only; for files use the bound `reply-document` surface.
+`whatsapp-send-admin` is the one outbound path that does **not** require a bound inbound conversation, so a webchat session or a scheduled run can push a text summary over WhatsApp. It is hard-gated to the cold-send-ban carve-out: the destination must already be a **registered recipient** — on the house `whatsapp.adminPhones` list (managed via `whatsapp-config add-admin-phone`) **or** a registered account manager in `whatsapp.accountManagers` (managed via `whatsapp-config add-account-manager`). Both lists are read from the socket-owning house account (`resolveAccount`), and the send always rides the house's paired socket. A destination in neither list is refused with `[whatsapp:outbound] op=send-refused reason=not-admin-phone` and no send is attempted — never a cold first contact. An **account-manager** phone (in `accountManagers`, which may overlap `adminPhones` — a phone can hold both roles, and the number it messaged decides its inbound scope) **is** a valid `send-admin` destination regardless of its binding mode: the operator registered it, so it is not a cold stranger. `passive` governs the manager's **inbound** behaviour only (no auto-reply, intake-only) and never gates this outbound send. A successful send logs its admit basis (`op=send-admin-ok via=admin-phone|account-manager`). Delivery reuses `sendTextMessage`, so the sent id is tracked for echo suppression and the send is recorded as outbound activity. Text only; for files use the bound `reply-document` surface.
 
 ## Self-chat command lane