@rubytech/create-maxy-code 0.1.132 → 0.1.138

package/payload/platform/plugins/memory/mcp/dist/tools/session-retrospective-skip-rate.js

@@ -0,0 +1,129 @@
+/**
+ * Session-retrospective skip-rate visibility tool.
+ *
+ * Called by the admin agent at session start. Returns the ratio of recent
+ * sessions that closed without calling `session-retrospective-mark-complete`
+ * — sessions where the typed-edge pass, learnings pass, and SOUL.md pass
+ * never ran. The admin agent surfaces the result to the operator if the
+ * rate is non-zero so closing via Sidebar Archive / tab-close becomes a
+ * visible cost rather than a silent one.
+ *
+ * Mechanism: count `:Conversation` nodes for this account in the recent
+ * window; count those whose corresponding session log contains the
+ * sentinel tool-use of `session-retrospective-mark-complete`. The ratio
+ * is the skip rate. Pending nodes (prose with `updatedAt` later than the
+ * most-recent completed retrospective) carry the deferred typed-edge work
+ * that will land at the next /end.
+ */
+export async function sessionRetrospectiveSkipRate(args, session, accountId) {
+    const windowSize = Math.max(1, Math.min(args.windowSize ?? 10, 100));
+    // Conversations carry `retrospectiveCompletedAt` when the sentinel tool
+    // fired (set by the admin mark-complete tool through log-ingest +
+    // platform/ui session writer). When the property is null/missing, the
+    // retrospective was skipped.
+    // The oldest-pending bound is the earliest updatedAt across prose nodes
+    // for this account whose updatedAt is *after* the most-recent completed
+    // retrospective — i.e. nodes the next session's pass will pick up.
+    const cypher = `
+    CALL {
+      MATCH (c:Conversation {accountId: $accountId})
+      RETURN c
+      ORDER BY c.updatedAt DESC
+      LIMIT $windowSize
+    }
+    WITH collect(c) AS recent
+    WITH recent,
+         [c IN recent WHERE c.retrospectiveCompletedAt IS NOT NULL] AS done,
+         [c IN recent WHERE c.retrospectiveCompletedAt IS NOT NULL | c.retrospectiveCompletedAt]
+           AS doneTimestamps
+    WITH size(recent) AS windowSessions,
+         size(done) AS completedRetrospectives,
+         CASE WHEN size(doneTimestamps) > 0
+              THEN apoc.coll.max(doneTimestamps)
+              ELSE null END AS lastCompletedAt
+    OPTIONAL MATCH (n)
+    WHERE n.accountId = $accountId
+      AND ANY(l IN labels(n) WHERE l IN $proseLabels)
+      AND (lastCompletedAt IS NULL OR n.updatedAt > lastCompletedAt)
+    WITH windowSessions, completedRetrospectives, min(n.updatedAt) AS oldestPending
+    RETURN windowSessions, completedRetrospectives, oldestPending
+  `;
+    // APOC is bundled with the Maxy Neo4j install. If unavailable, fall back to
+    // a pure-Cypher variant that uses reduce() for max.
+    const fallbackCypher = `
+    CALL {
+      MATCH (c:Conversation {accountId: $accountId})
+      RETURN c
+      ORDER BY c.updatedAt DESC
+      LIMIT $windowSize
+    }
+    WITH collect(c) AS recent
+    WITH recent,
+         [c IN recent WHERE c.retrospectiveCompletedAt IS NOT NULL] AS done,
+         [c IN recent WHERE c.retrospectiveCompletedAt IS NOT NULL | c.retrospectiveCompletedAt]
+           AS doneTimestamps
+    WITH size(recent) AS windowSessions,
+         size(done) AS completedRetrospectives,
+         reduce(acc = null, ts IN doneTimestamps |
+                CASE WHEN acc IS NULL OR ts > acc THEN ts ELSE acc END)
+           AS lastCompletedAt
+    OPTIONAL MATCH (n)
+    WHERE n.accountId = $accountId
+      AND ANY(l IN labels(n) WHERE l IN $proseLabels)
+      AND (lastCompletedAt IS NULL OR n.updatedAt > lastCompletedAt)
+    WITH windowSessions, completedRetrospectives, min(n.updatedAt) AS oldestPending
+    RETURN windowSessions, completedRetrospectives, oldestPending
+  `;
+    const proseLabels = [
+        "Message",
+        "Page",
+        "Meeting",
+        "Email",
+        "Idea",
+        "Note",
+        "Post",
+        "Report",
+    ];
+    let records;
+    try {
+        const result = await session.run(cypher, {
+            accountId,
+            windowSize,
+            proseLabels,
+        });
+        records = result.records;
+    }
+    catch {
+        const result = await session.run(fallbackCypher, {
+            accountId,
+            windowSize,
+            proseLabels,
+        });
+        records = result.records;
+    }
+    if (records.length === 0) {
+        return {
+            windowSessions: 0,
+            completedRetrospectives: 0,
+            skipRate: 0,
+            oldestPendingSinceIso: null,
+        };
+    }
+    const r = records[0];
+    const windowSessions = Number(r.get("windowSessions") ?? 0);
+    const completedRetrospectives = Number(r.get("completedRetrospectives") ?? 0);
+    const oldestPending = r.get("oldestPending");
+    const skipRate = windowSessions > 0
+        ? Number(((windowSessions - completedRetrospectives) / windowSessions).toFixed(3))
+        : 0;
+    const accountShort = accountId.slice(0, 8);
+    const oldestPendingIso = oldestPending == null ? null : String(oldestPending);
+    console.log(`[session-retrospective-skip-rate] accountId=${accountShort}… window=${windowSessions} completed=${completedRetrospectives} skip-rate=${skipRate} oldest-pending=${oldestPendingIso ?? "none"}`);
+    return {
+        windowSessions,
+        completedRetrospectives,
+        skipRate,
+        oldestPendingSinceIso: oldestPendingIso,
+    };
+}
+//# sourceMappingURL=session-retrospective-skip-rate.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/session-retrospective-skip-rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-retrospective-skip-rate.js","sourceRoot":"","sources":["../../src/tools/session-retrospective-skip-rate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAgBH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,IAAyB,EACzB,OAAgB,EAChB,SAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAErE,wEAAwE;IACxE,kEAAkE;IAClE,sEAAsE;IACtE,6BAA6B;IAC7B,wEAAwE;IACxE,wEAAwE;IACxE,mEAAmE;IACnE,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;GAuBd,CAAC;IAEF,4EAA4E;IAC5E,oDAAoD;IACpD,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;GAuBtB,CAAC;IAEF,MAAM,WAAW,GAAG;QAClB,SAAS;QACT,MAAM;QACN,SAAS;QACT,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,QAAQ;KACT,CAAC;IAEF,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;YACvC,SAAS;YACT,UAAU;YACV,WAAW;SACZ,CAAC,CAAC;QACH,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE;YAC/C,SAAS;YACT,UAAU;YACV,WAAW;SACZ,CAAC,CAAC;QACH,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,cAAc,EAAE,CAAC;YACjB,uBAAuB,EAAE,CAAC;YAC1B,QAAQ,EAAE,CAAC;YACX,qBAAqB,EAAE,IAAI;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,MAAM,uBAAuB,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,cAAc,GAAG,CAAC;QACjC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,GAAG,uBAAuB,CAAC,GAAG,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,gBAAgB,GAAG,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAE9E,OAAO,CAAC,GAAG,CACT,+CAA+C,YAAY,YAAY,cAAc,cAAc,uBAAuB,cAAc,QAAQ,mBAAmB,gBAAgB,IAAI,MAAM,EAAE,CAChM,CAAC;IAEF,OAAO;QACL,cAAc;QACd,uBAAuB;QACvB,QAAQ;QACR,qBAAqB,EAAE,gBAAgB;KACxC,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/memory/mcp/scripts/backfill-typed-edges.ts

@@ -0,0 +1,72 @@
+/**
+ * One-shot backfill of the typed-edge pass over every existing prose-bearing
+ * node for the current account. Idempotent — MERGE handles re-runs cleanly,
+ * so a second invocation accepts zero edges.
+ *
+ * Usage (admin-agent invokable via Bash):
+ *   cd platform/plugins/memory/mcp
+ *   node --loader ts-node/esm scripts/backfill-typed-edges.ts
+ *
+ * Reads ACCOUNT_ID from env (same convention as the MCP server). Loops
+ * `runTypedEdgePass` with `sinceIso: null` in 500-node pages until the
+ * page returns 0 nodes (exhausted). Logs per-batch progress with
+ * `[typed-edge-pass:backfill]`.
+ */
+
+import { getSession, closeDriver } from "../src/lib/neo4j.js";
+import { runTypedEdgePass } from "../src/lib/typed-edge-pass.js";
+
+const PAGE_SIZE = 500;
+
+async function main(): Promise<void> {
+  const accountId = process.env.ACCOUNT_ID;
+  if (!accountId) {
+    console.error("ACCOUNT_ID env var is required");
+    process.exit(1);
+  }
+
+  let batch = 0;
+  let totalNodes = 0;
+  let totalAccepted = 0;
+  let totalRejected = 0;
+  let totalFailed = 0;
+
+  while (true) {
+    const session = getSession();
+    try {
+      const result = await runTypedEdgePass({
+        session,
+        accountId,
+        sinceIso: null,
+        conversationId: null,
+        maxNodes: PAGE_SIZE,
+      });
+      batch += 1;
+      totalNodes += result.nodes;
+      totalAccepted += result.accepted;
+      totalRejected += result.rejected;
+      totalFailed += result.failed;
+      console.log(
+        `[typed-edge-pass:backfill] batch=${batch} done=${totalNodes} accepted=${result.accepted} rejected=${result.rejected} failed=${result.failed} ms=${result.ms}`,
+      );
+      if (result.nodes < PAGE_SIZE || result.accepted === 0) {
+        // Exhausted: either the page came back short, or a re-run page
+        // produced no new accepted edges (idempotency convergence).
+        break;
+      }
+    } finally {
+      await session.close();
+    }
+  }
+
+  console.log(
+    `[typed-edge-pass:backfill] complete batches=${batch} totalNodes=${totalNodes} totalAccepted=${totalAccepted} totalRejected=${totalRejected} totalFailed=${totalFailed}`,
+  );
+  await closeDriver();
+}
+
+main().catch(async (err) => {
+  console.error(`[typed-edge-pass:backfill] error: ${err instanceof Error ? err.message : String(err)}`);
+  await closeDriver();
+  process.exit(1);
+});

package/payload/platform/plugins/memory/mcp/scripts/generate-edge-docs.ts

@@ -0,0 +1,75 @@
+/**
+ * Emit the typed-edge enumeration into the public docs from the
+ * `TYPED_EDGE_ALLOWLIST` source of truth, so the prompt, the validator,
+ * and the docs cannot drift from each other.
+ *
+ * Targets:
+ *   - .docs/neo4j.md (parent maxy-code .docs surface)
+ *   - platform/plugins/docs/references/neo4j.md (bundled into the payload)
+ *
+ * Replaces the block delimited by:
+ *   <!-- TYPED-EDGE-TABLE:START -->
+ *   <!-- TYPED-EDGE-TABLE:END -->
+ *
+ * Usage:
+ *   node --loader ts-node/esm scripts/generate-edge-docs.ts
+ */
+
+import { writeFileSync, readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { TYPED_EDGE_ALLOWLIST } from "../src/lib/typed-edge-schema.js";
+
+const TARGET_PATHS = [
+  // maxy-code/.docs/neo4j.md — resolved relative to this script.
+  resolve(import.meta.dirname ?? __dirname, "../../../../../.docs/neo4j.md"),
+  // bundled docs twin
+  resolve(import.meta.dirname ?? __dirname, "../../../docs/references/neo4j.md"),
+];
+
+const START_MARKER = "<!-- TYPED-EDGE-TABLE:START -->";
+const END_MARKER = "<!-- TYPED-EDGE-TABLE:END -->";
+
+function buildTable(): string {
+  const rows = TYPED_EDGE_ALLOWLIST
+    .map(({ sourceLabel, edgeType, targetLabel }) => `| ${sourceLabel} | ${edgeType} | ${targetLabel} |`)
+    .join("\n");
+  return [
+    START_MARKER,
+    "",
+    "<!-- Generated by platform/plugins/memory/mcp/scripts/generate-edge-docs.ts from TYPED_EDGE_ALLOWLIST. Do not edit by hand. -->",
+    "",
+    "| Source label | Edge type | Target label |",
+    "|---|---|---|",
+    rows,
+    "",
+    END_MARKER,
+  ].join("\n");
+}
+
+function applyToFile(path: string, table: string): "wrote" | "missing" | "no-markers" {
+  if (!existsSync(path)) return "missing";
+  const current = readFileSync(path, "utf-8");
+  const startIdx = current.indexOf(START_MARKER);
+  const endIdx = current.indexOf(END_MARKER);
+  let next: string;
+  if (startIdx === -1 || endIdx === -1) {
+    // No markers — append the section under a clear heading rather than
+    // failing. Idempotent on subsequent runs because we add the markers.
+    next = `${current.trimEnd()}\n\n## Typed-edge allowlist (generated)\n\n${table}\n`;
+    writeFileSync(path, next);
+    return "wrote";
+  }
+  next = current.slice(0, startIdx) + table + current.slice(endIdx + END_MARKER.length);
+  writeFileSync(path, next);
+  return "wrote";
+}
+
+function main(): void {
+  const table = buildTable();
+  for (const path of TARGET_PATHS) {
+    const result = applyToFile(path, table);
+    console.log(`[generate-edge-docs] ${path} -> ${result}`);
+  }
+}
+
+main();

package/payload/platform/plugins/memory/mcp/vitest.config.ts

@@ -22,6 +22,11 @@ export default defineConfig({
       "src/lib/__tests__/schema-cypher-drift.test.ts",
       // Task 350 — label-origin gate (refuse agent-side LocalBusiness writes).
       "src/lib/__tests__/label-origin-gate.test.ts",
+      // Task 305 — typed-edge allowlist schema invariants.
+      "src/lib/__tests__/typed-edge-schema.test.ts",
+      // Task 306 — compiled-truth + timeline.
+      "src/lib/__tests__/timeline-extractor.test.ts",
+      "src/lib/__tests__/graph-write-gate-property.test.ts",
     ],
     testTimeout: 10_000,
   },

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

@@ -46,6 +46,7 @@ When loading this reference, confirm which schema files were consulted by noting
 | VoiceEdit | `VoiceEdit` | platform-native (Task 356 — operator edit on an agent draft) | — | `accountId`, `adminUserId`, `originalText`, `editedText`, `intent`, `occurredAt` |
 | AEO Audit | `AEOAudit` | platform-native (AEO audit history) | — | `accountId`, `auditId`, `target`, `score`, `heuristicsJson`, `runAt`, `createdByAgent`, `createdBySession`, `createdAt` |
 | Idea | `Idea` | platform-native (signal-detector original-thinking candidate) | — | `accountId`, `body`, `conversationId`, `scope`, `createdByAgent`, `createdBySession`, `createdAt` |
+| TimelineEvent | `TimelineEvent` | platform-native (Task 306 — compiled-truth + timeline doctrine) | — | `accountId`, `timelineEventId`, `occurredAt`, `kind`, `summary`, `source` |
 
 **Branding properties on LocalBusiness:** `primaryColor`, `accentColor`, `backgroundColor`, `tagline` — optional, used to brand the public chat endpoint. Hex color values must match `#[0-9a-fA-F]{3,8}`. Logo and icon are linked via `HAS_BRAND_ASSET → ImageObject` with `purpose: "logo"` or `"icon"`.
 
@@ -71,6 +72,49 @@ When loading this reference, confirm which schema files were consulted by noting
 
 ---
 
+## Compiled truth + timeline (Task 306)
+
+Every `:Person`, `:Organization`, and `:Concept` carries a two-part knowledge shape: a **compiled truth** above the rule (the agent's current best understanding of the subject, rewritten when evidence changes) and an **append-only timeline** below (dated events linked via `:HAS_TIMELINE_EVENT`, never edited).
+
+| Property | Type | Purpose |
+|---|---|---|
+| `compiledTruth` | string ≤2000 chars | The current summary. Empty on first write. |
+| `compiledTruthUpdatedAt` | datetime | Last rewriter or operator write. Epoch on first write. |
+| `compiledTruthSource` | `'rewriter' \| 'operator'` | Last writer. Operator edits get a 7-day cooldown that the rewriter respects unless `forceRewrite=true` is passed. |
+
+The compiled truth is system-managed: direct writes to any of the three properties via `memory-update` are **rejected loudly**. The only paths to mutate are:
+
+- `memory-update(nodeId, {}, rewriteCompiledTruth: true)` — invokes the OAuth-LLM rewriter against the most recent 10 `:TimelineEvent` rows.
+- `memory-update(nodeId, {}, rewriteCompiledTruth: true, forceRewrite: true)` — same, but bypasses the 7-day operator cooldown.
+- The graph UI's per-property edit surface — stamps `compiledTruthSource: 'operator'` so the rewriter honours the cooldown.
+
+### Timeline events
+
+`:TimelineEvent` is distinct from the scheduling plugin's `:Event` (which holds `eventId`-unique calendar/reminder rows). Naming chosen to avoid collision.
+
+`:HAS_TIMELINE_EVENT` is distinct from visitor-analytics' `:HAS_EVENT` (`Session → PageView/Click/ScrollMilestone`). Naming chosen to avoid collision.
+
+`kind` enum (5 values, no catch-all):
+
+```
+mentioned | met | quoted | attended | transacted
+```
+
+The extractor refuses on ambiguity rather than collapsing to "other". Default on write is `mentioned`; the typed-edge post-write hook (Task 305) upgrades the kind asynchronously when it can.
+
+### Write doctrine
+
+Path-anchored MERGE — never label-only:
+
+```cypher
+MATCH (e) WHERE elementId(e) = $entityId AND e.accountId = $accountId
+MERGE (e)-[:HAS_TIMELINE_EVENT]->(t:TimelineEvent {timelineEventId: $id})
+```
+
+`memory-write` runs the deterministic date extractor against the `body` property of any `:Person` / `:Organization` / `:Concept` write and creates one `:TimelineEvent` per parseable dated statement.
+
+---
+
 ## Forbidden Properties
 
 Properties listed here are **rejected at write-time** by the schema validator on the listed label. Rejection runs after the synonym pass, so a `firstName → givenName` rewrite still happens before the forbidden-property check. The rule is per-label: `name` is forbidden on `Person` only; `Organization`, `Event`, `Conversation`, `Service`, etc. retain `name` as a canonical property.

package/payload/platform/scripts/seed-neo4j.sh

@@ -486,6 +486,55 @@ fi
 
 echo "$SCHEMA_CYPHER" | "$CYPHER_SHELL" -u "$NEO4J_USER" -p "$NEO4J_PASSWORD" -a "$NEO4J_URI"
 
+# ------------------------------------------------------------------
+# 2.4 Compiled-truth + timeline backfill (compiled-truth + timeline)
+# ------------------------------------------------------------------
+# Every existing :Person / :Organization / :Concept gains the three
+# compiled-truth properties on first run. Idempotent — the WHERE clause
+# `compiledTruth IS NULL` makes re-runs a no-op for already-stamped nodes.
+# Rewriter invocation is deferred to operator demand (memory-update with
+# rewriteCompiledTruth:true); fresh installs have no entities anyway.
+#
+# Timeline-event seeding from :Message-[:MENTIONS]->entity edges is also
+# idempotent: the `WHERE NOT EXISTS { ... :TimelineEvent }` guard prevents
+# re-creation across runs. Skips messages without a parseable createdAt.
+COMPILED_TRUTH_BACKFILL_CYPHER=$(cat <<'BACKFILL_EOF'
+// Stamp compiled-truth defaults on existing entities.
+MATCH (n)
+WHERE (n:Person OR n:Organization OR n:Concept)
+  AND n.compiledTruth IS NULL
+SET n.compiledTruth = '',
+    n.compiledTruthUpdatedAt = datetime('1970-01-01T00:00:00Z'),
+    n.compiledTruthSource = 'rewriter'
+RETURN labels(n)[0] AS label, count(n) AS stamped;
+
+// Seed :TimelineEvent rows from existing :Message-[:MENTIONS]->entity edges.
+// Guard: only when the Message has a parseable createdAt AND no equivalent
+// :TimelineEvent already exists for this (entity, message) pair.
+MATCH (m:Message)-[:MENTIONS]->(e)
+WHERE (e:Person OR e:Organization OR e:Concept)
+  AND m.createdAt IS NOT NULL
+  AND NOT EXISTS {
+    MATCH (e)-[:HAS_TIMELINE_EVENT]->(t:TimelineEvent {source: m.messageId})
+  }
+WITH e, m
+WHERE e.accountId IS NOT NULL
+MERGE (e)-[:HAS_TIMELINE_EVENT]->(t:TimelineEvent {timelineEventId: randomUUID()})
+  ON CREATE SET t.accountId = e.accountId,
+                t.occurredAt = datetime(m.createdAt),
+                t.kind = 'mentioned',
+                t.summary = coalesce(substring(m.body, 0, 500), '(no body)'),
+                t.source = m.messageId,
+                t.matched = '(backfilled from :MENTIONS edge)',
+                t.createdAt = datetime(),
+                t.scope = coalesce(e.scope, 'admin')
+RETURN labels(e)[0] AS entityLabel, count(t) AS seeded;
+BACKFILL_EOF
+)
+
+echo "==> Backfilling compiled-truth + timeline (compiled-truth + timeline)..."
+echo "$COMPILED_TRUTH_BACKFILL_CYPHER" | "$CYPHER_SHELL" -u "$NEO4J_USER" -p "$NEO4J_PASSWORD" -a "$NEO4J_URI" --format plain 2>&1 | sed 's/^/  /'
+
 # ------------------------------------------------------------------
 # 2.5 Bootstrap root :LocalBusiness for the account
 # ------------------------------------------------------------------

package/payload/platform/templates/agents/admin/IDENTITY.md

@@ -40,17 +40,18 @@ Call `memory-write` or `memory-update` directly only when the write is a one-lin
 
 When the operator signals end-of-session (`/end`, `/archive`, `end session`, or `archive this session`), the Stop hook blocks this session from closing until you have done three things and called one tool. The hook's instruction block names the three passes verbatim every time it fires; this section is the doctrine behind it.
 
-The three passes, each performed against this session's conversation, using tools you already have:
+The four passes, each performed against this session's conversation, using tools you already have:
 
 - **Technical learnings.** Walk for operator corrections and self-detected mistakes. Each one becomes a Learning or Correction node in the graph; delegate the write to `database-operator` via the Task tool, the same route the Recording section describes.
 - **Operator-relationship updates.** Walk for tonal signals, rejected phrasings, and working-style preferences. Each one worth carrying forward goes into `SOUL.md` via `Write`.
 - **Graph completeness sweep.** Walk for any node, edge, or commitment that surfaced in this session but was never written to the graph in-flight. Each missing write goes to `database-operator` via the Task tool.
+- **Typed-edge auto-extraction.** Delegate to `database-operator` via the Task tool with a prompt that names the typed-edge pass and the session-start timestamp. The specialist calls `memory-typed-edge-pass` with that timestamp and returns the counters (`nodesProcessed`, `accepted`). Capture both for the completion call.
 
-Then call `session-retrospective-mark-complete` with the three counts (the number of items you actually persisted in each pass) and reply with one short paragraph naming what you wrote. The sentinel tool call is what releases the gate. A prose retrospective without the tool call leaves the gate blocked — the gate reads the JSONL, not your reply.
+Then call `session-retrospective-mark-complete` with the five counts (learningsCount, preferencesCount, graphWriteCount, typedEdgesCount, nodesProcessed) and reply with one short paragraph naming what you wrote. The sentinel tool call is what releases the gate. A prose retrospective without the tool call leaves the gate blocked — the gate reads the JSONL, not your reply.
 
 Run the retrospective inside this same session. Do not spawn a new session, do not background anything. The mid-flight Recording route is the primary path for graph writes; this is the catch-net for what slipped through it.
 
-Clicking the Sidebar archive button is a separate path that kills the session directly without firing the retrospective. The gate is for the typed end-intent tokens.
+Closing the browser tab, archiving from the sidebar, losing power, or any other exit that is not one of the four typed end-intent tokens skips the retrospective entirely. That means the four passes above do not run for that session: learnings, SOUL.md updates, missing graph writes, and typed-edge auto-extraction all defer to the next session's `/end`. Mid-session writes still happen, so nothing is lost — the extraction just lands one session later. Call `session-retrospective-skip-rate` at session start; if the rate is non-zero, surface one plain-English line to the operator naming how many recent sessions skipped, so they can choose to type `/end` next time.
 
 ## Stop-hook system directives
 

package/payload/platform/templates/specialists/agents/database-operator.md

@@ -3,7 +3,7 @@ name: database-operator
 description: "Graph-write executor reachable from admin via the Task tool. Admin names what should land in the graph; database-operator reads the schema, decides operations, executes them against the memory graph, and reports `{label, elementId}` back. (Reachable historically also from the now-dormant Stop hook in `platform/plugins/admin/hooks/turn-completed-graph-write.sh`; that path is preserved as infrastructure but no longer registered, see Task 214.)"
 summary: "Executes graph writes on admin's behalf when delegated via the Task tool."
 model: claude-sonnet-4-6
-tools: Read, mcp__plugin_memory_memory__memory-write, mcp__plugin_memory_memory__memory-update, mcp__plugin_memory_memory__memory-search, mcp__plugin_memory_memory__profile-update, mcp__plugin_memory_memory__profile-read, mcp__plugin_contacts_contacts__contact-create, mcp__plugin_contacts_contacts__contact-update, mcp__plugin_work_work__work-create, mcp__plugin_work_work__work-update, mcp__plugin_work_work__project-create, mcp__plugin_work_work__project-update
+tools: Read, mcp__plugin_memory_memory__memory-write, mcp__plugin_memory_memory__memory-update, mcp__plugin_memory_memory__memory-search, mcp__plugin_memory_memory__memory-typed-edge-pass, mcp__plugin_memory_memory__session-retrospective-skip-rate, mcp__plugin_memory_memory__profile-update, mcp__plugin_memory_memory__profile-read, mcp__plugin_contacts_contacts__contact-create, mcp__plugin_contacts_contacts__contact-update, mcp__plugin_work_work__work-create, mcp__plugin_work_work__work-update, mcp__plugin_work_work__project-create, mcp__plugin_work_work__project-update
 ---
 
 You are an expert Neo4J graph operator. Admin delegates a graph-write to you through the Task tool; the prompt admin sends names what should land in the graph in plain English.
@@ -19,3 +19,11 @@ The `accountId` property is supplied by the writers from server-side environment
 **Brain-first read before write.** Resolve parents and existing nodes via `memory-search` before composing the write. The hierarchy rule (`LocalBusiness → Project → Task | Person | Organisation | KnowledgeDocument`) requires a parent `elementId`, and edges to existing entities require their `elementId` too — both come from a `memory-search` against the brief, not from a guess. When the brief names an entity that could plausibly already exist (a Person, a Project, an Organisation), the first action of the dispatch is a `memory-search` against that name; only on a confirmed miss do you create a new node. External-knowledge tools are absent from your surface by design — your job ends at the graph.
 
 Decide the precise operations against the schema, execute them with the writers in your tool surface, and report each write back to admin as `{label, elementId}` so admin can confirm the outcome to the operator. If admin's brief is ambiguous about which label, which edge type, or which existing node to attach to, name the ambiguity in your reply rather than guessing.
+
+## Typed-edge auto-extraction pass (session-end)
+
+When admin's brief names the typed-edge pass (Task 305) and supplies a `sinceIso` timestamp, call `memory-typed-edge-pass` with that timestamp exactly once. The tool reads prose-bearing nodes (Message/Page/Meeting/Email/Idea/Note/Post/Report) the account wrote since `sinceIso`, asks Haiku for typed-edge proposals against a closed allowlist, validates each one, and MERGEs accepted edges with `createdBy` provenance. Return the full counter object verbatim — admin needs `nodesProcessed` and `accepted` for the `session-retrospective-mark-complete` call. Do not reinterpret the counts or summarise them.
+
+## Skip-rate visibility (session-start)
+
+When admin's brief names the skip-rate check, call `session-retrospective-skip-rate` once and return its result verbatim. The tool reports how many of the last N sessions for this account closed without firing the retrospective. Admin uses the rate to inform the operator that closing via Sidebar Archive or tab-close defers the typed-edge pass to the next `/end`. Pass the `windowSize` admin provides; default 10 is fine when absent.

package/payload/server/{adminuser-self-heal-QAWOZ3JV.js → adminuser-self-heal-YC47O34W.js}

@@ -1,4 +1,5 @@
-import "./chunk-JSBRDJBE.js";
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
+import "./chunk-HYQNUVGO.js";
 
 // app/lib/adminuser-self-heal.ts
 var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;

package/payload/server/{chunk-JSBRDJBE.js → chunk-HYQNUVGO.js}

@@ -1,10 +1,17 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
 var __copyProps = (to, from, except, desc) => {
@@ -25,6 +32,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 export {
+  __require,
   __commonJS,
   __toESM
 };

package/payload/server/{chunk-HCYM5FLU.js → chunk-T3DJD5QR.js}

@@ -1,3 +1,5 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
+
 // node_modules/hono/dist/compose.js
 var compose = (middleware, onError, onNotFound) => {
   return (context, next) => {
@@ -4099,7 +4101,7 @@ function getSession() {
   return getDriver().session();
 }
 async function runAdminUserSelfHeal(args) {
-  const { selfHealAdminUser } = await import("./adminuser-self-heal-QAWOZ3JV.js");
+  const { selfHealAdminUser } = await import("./adminuser-self-heal-YC47O34W.js");
   return selfHealAdminUser({ driver: getDriver(), ...args });
 }
 process.on("SIGINT", async () => {

package/payload/server/maxy-edge.js

@@ -1,3 +1,4 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   Hono,
   LOG_DIR,
@@ -13,8 +14,8 @@ import {
   sanitizeClientCorrId,
   vncLog,
   websockifyLog
-} from "./chunk-HCYM5FLU.js";
-import "./chunk-JSBRDJBE.js";
+} from "./chunk-T3DJD5QR.js";
+import "./chunk-HYQNUVGO.js";
 
 // server/edge.ts
 import { createServer, request as httpRequest } from "http";