clay-server 2.27.0-beta.9 → 2.27.0

package/lib/mates.js

@@ -4,6 +4,9 @@ var crypto = require("crypto");
 var config = require("./config");
 
 var crisisSafety = require("./crisis-safety");
+var matesPrompts = require("./mates-prompts");
+var matesIdentity = require("./mates-identity");
+var { attachKnowledge } = require("./mates-knowledge");
 
 // --- Path resolution ---
 
@@ -20,6 +23,42 @@ function resolveMatesRoot(ctx) {
   return path.join(config.CONFIG_DIR, "mates");
 }
 
+// --- Wiring: knowledge module needs resolveMatesRoot ---
+var knowledge = attachKnowledge(resolveMatesRoot);
+var loadCommonKnowledge = knowledge.loadCommonKnowledge;
+var saveCommonKnowledge = knowledge.saveCommonKnowledge;
+var promoteKnowledge = knowledge.promoteKnowledge;
+var depromoteKnowledge = knowledge.depromoteKnowledge;
+var getCommonKnowledgeForMate = knowledge.getCommonKnowledgeForMate;
+var readCommonKnowledgeFile = knowledge.readCommonKnowledgeFile;
+var isPromoted = knowledge.isPromoted;
+
+// --- Aliases from extracted modules ---
+var TEAM_MARKER = matesPrompts.TEAM_MARKER;
+var TEAM_SECTION = matesPrompts.TEAM_SECTION;
+var SESSION_MEMORY_MARKER = matesPrompts.SESSION_MEMORY_MARKER;
+var SESSION_MEMORY_SECTION = matesPrompts.SESSION_MEMORY_SECTION;
+var STICKY_NOTES_MARKER = matesPrompts.STICKY_NOTES_MARKER;
+var STICKY_NOTES_SECTION = matesPrompts.STICKY_NOTES_SECTION;
+var PROJECT_REGISTRY_MARKER = matesPrompts.PROJECT_REGISTRY_MARKER;
+var DEBATE_AWARENESS_MARKER = matesPrompts.DEBATE_AWARENESS_MARKER;
+var DEBATE_AWARENESS_SECTION = matesPrompts.DEBATE_AWARENESS_SECTION;
+var ALL_SYSTEM_MARKERS = matesPrompts.ALL_SYSTEM_MARKERS;
+var buildTeamSection = matesPrompts.buildTeamSection;
+var enforceTeamAwareness = matesPrompts.enforceTeamAwareness;
+var enforceProjectRegistry = matesPrompts.enforceProjectRegistry;
+var buildProjectRegistrySection = matesPrompts.buildProjectRegistrySection;
+var enforceSessionMemory = matesPrompts.enforceSessionMemory;
+var enforceStickyNotes = matesPrompts.enforceStickyNotes;
+var enforceDebateAwareness = matesPrompts.enforceDebateAwareness;
+var PRIMARY_CAPABILITIES_MARKER = matesIdentity.PRIMARY_CAPABILITIES_MARKER;
+var IDENTITY_MIN_LENGTH = matesIdentity.IDENTITY_MIN_LENGTH;
+var buildPrimaryCapabilitiesSection = matesIdentity.buildPrimaryCapabilitiesSection;
+var backupIdentity = matesIdentity.backupIdentity;
+var loadIdentityBackup = matesIdentity.loadIdentityBackup;
+var logIdentityChange = matesIdentity.logIdentityChange;
+var extractIdentity = function (content) { return matesIdentity.extractIdentity(content, ALL_SYSTEM_MARKERS); };
+
 function buildMateCtx(userId) {
   if (!userId) return { userId: null, multiUser: false, linuxUser: null };
   // Lazy require to avoid circular dependency
@@ -288,469 +327,6 @@ function migrateLegacyMates() {
   }
 }
 
-// --- Team awareness ---
-
-var TEAM_MARKER = "<!-- TEAM_AWARENESS_MANAGED_BY_SYSTEM -->";
-
-// Static fallback when ctx is unavailable
-var TEAM_SECTION =
-  "\n\n" + TEAM_MARKER + "\n" +
-  "## Your Team\n\n" +
-  "**This section is managed by the system and cannot be removed.**\n\n" +
-  "You are one of several AI Mates in this workspace. Your teammates and their profiles are listed in `../mates.json`. " +
-  "Each teammate's identity and working style is described in their own directory:\n\n" +
-  "- `../{mate_id}/CLAUDE.md` — their identity, personality, and working style\n" +
-  "- `../{mate_id}/mate.yaml` — their metadata (name, role, status, activities)\n" +
-  "- `../common-knowledge.json` — shared knowledge registry; files listed here are readable by all mates\n\n" +
-  "Check the team registry when it would be relevant to know who else is available or what they do. " +
-  "You cannot message other Mates directly yet, but knowing your team helps you work with the user more effectively.\n";
-
-/**
- * Build a dynamic team section with current mate roster.
- * Lists each teammate by stable ID with their current display name, role, and bio.
- * @param {object} ctx - user context for loading mates
- * @param {string} currentMateId - this mate's ID (excluded from the roster)
- * @returns {string} Team section string, or static TEAM_SECTION as fallback
- */
-function buildTeamSection(ctx, currentMateId) {
-  var data;
-  try { data = loadMates(ctx); } catch (e) { return TEAM_SECTION; }
-  if (!data || !data.mates || data.mates.length < 2) return TEAM_SECTION;
-
-  var mates = data.mates.filter(function (m) {
-    return m.id !== currentMateId && m.status === "ready";
-  });
-  if (mates.length === 0) return TEAM_SECTION;
-
-  var section = "\n\n" + TEAM_MARKER + "\n" +
-    "## Your Team\n\n" +
-    "**This section is managed by the system and updated automatically.**\n\n" +
-    "You are one of " + (mates.length + 1) + " AI Mates in this workspace. " +
-    "Here is your current team roster:\n\n" +
-    "| Name | ID | Bio |\n" +
-    "|------|-----|-----|\n";
-
-  for (var i = 0; i < mates.length; i++) {
-    var m = mates[i];
-    var name = (m.profile && m.profile.displayName) || m.name || "Unnamed";
-    var bio = (m.bio || "").replace(/\|/g, "/").replace(/\n/g, " ");
-    if (bio.length > 120) bio = bio.substring(0, 117) + "...";
-    section += "| " + name + " | `" + m.id + "` | " + bio + " |\n";
-  }
-
-  section += "\n" +
-    "Each teammate's full identity is in their own directory:\n\n" +
-    "- `../{mate_id}/CLAUDE.md` -- identity, personality, working style\n" +
-    "- `../{mate_id}/mate.yaml` -- metadata (name, role, status, activities)\n" +
-    "- `../common-knowledge.json` -- shared knowledge readable by all mates\n\n" +
-    "Use the **ID** (not the name) when referencing teammates in structured data. " +
-    "Names can change, IDs are permanent.\n";
-
-  return section;
-}
-
-// --- Project registry ---
-
-var PROJECT_REGISTRY_MARKER = "<!-- PROJECT_REGISTRY_MANAGED_BY_SYSTEM -->";
-
-function buildProjectRegistrySection(projects) {
-  if (!projects || projects.length === 0) return "";
-  var section = "\n\n" + PROJECT_REGISTRY_MARKER + "\n" +
-    "## Available Projects\n\n" +
-    "**This section is managed by the system and cannot be removed.**\n\n" +
-    "The following projects are registered in this workspace. " +
-    "Use this information when the user references a project by name, " +
-    "so you do not need to ask for the path.\n\n" +
-    "| Project | Path |\n" +
-    "|---------|------|\n";
-  for (var i = 0; i < projects.length; i++) {
-    var p = projects[i];
-    var name = (p.icon ? p.icon + " " : "") + (p.title || p.slug || path.basename(p.path));
-    section += "| " + name + " | `" + p.path + "` |\n";
-  }
-  return section;
-}
-
-/**
- * Enforce the project registry section on a mate's CLAUDE.md.
- * Inserts after team awareness section and before session memory section.
- * Pass the current project list; if empty, removes the section.
- * Returns true if the file was modified.
- */
-function enforceProjectRegistry(filePath, projects) {
-  if (!fs.existsSync(filePath)) return false;
-
-  var content = fs.readFileSync(filePath, "utf8");
-  var newSection = buildProjectRegistrySection(projects);
-
-  // Strip existing section if present
-  var markerIdx = content.indexOf(PROJECT_REGISTRY_MARKER);
-  if (markerIdx !== -1) {
-    var afterMarker = content.substring(markerIdx);
-    // Find next system marker
-    var nextIdx = -1;
-    var candidates = [SESSION_MEMORY_MARKER, STICKY_NOTES_MARKER, DEBATE_AWARENESS_MARKER, crisisSafety.MARKER];
-    for (var c = 0; c < candidates.length; c++) {
-      var ci = afterMarker.indexOf(candidates[c]);
-      if (ci !== -1 && (nextIdx === -1 || ci < nextIdx)) nextIdx = ci;
-    }
-
-    if (nextIdx !== -1) {
-      var existing = afterMarker.substring(0, nextIdx).trimEnd();
-      if (existing === newSection.trimStart().trimEnd()) return false; // already correct
-      content = content.substring(0, markerIdx).trimEnd() + content.substring(markerIdx + nextIdx);
-    } else {
-      var existing = afterMarker.trimEnd();
-      if (existing === newSection.trimStart().trimEnd()) return false;
-      content = content.substring(0, markerIdx).trimEnd();
-    }
-  }
-
-  // If no projects, just remove the section (already done above)
-  if (!newSection) {
-    if (markerIdx !== -1) {
-      fs.writeFileSync(filePath, content, "utf8");
-      return true;
-    }
-    return false;
-  }
-
-  // Insert before session memory, sticky notes, debate, or crisis safety
-  var insertBefore = -1;
-  var insertCandidates = [SESSION_MEMORY_MARKER, STICKY_NOTES_MARKER, DEBATE_AWARENESS_MARKER, crisisSafety.MARKER];
-  for (var ic = 0; ic < insertCandidates.length; ic++) {
-    var pos = content.indexOf(insertCandidates[ic]);
-    if (pos !== -1) { insertBefore = pos; break; }
-  }
-  if (insertBefore !== -1) {
-    content = content.substring(0, insertBefore).trimEnd() + newSection + "\n\n" + content.substring(insertBefore);
-  } else {
-    content = content.trimEnd() + newSection;
-  }
-
-  fs.writeFileSync(filePath, content, "utf8");
-  return true;
-}
-
-function hasTeamSection(content) {
-  return content.indexOf(TEAM_MARKER) !== -1;
-}
-
-/**
- * Enforce the team awareness section on a mate's CLAUDE.md.
- * Inserts before the crisis safety section (if present), or appends at the end.
- * Returns true if the file was modified.
- */
-function enforceTeamAwareness(filePath) {
-  if (!fs.existsSync(filePath)) return false;
-
-  var content = fs.readFileSync(filePath, "utf8");
-
-  // Check if already present and correct
-  var teamIdx = content.indexOf(TEAM_MARKER);
-  if (teamIdx !== -1) {
-    // Extract existing team section (up to next system marker or end)
-    var afterTeam = content.substring(teamIdx);
-    // Find the nearest following system marker (project registry, session memory, or crisis safety)
-    var nextMarkerIdx = -1;
-    var projIdx = afterTeam.indexOf(PROJECT_REGISTRY_MARKER);
-    var memIdx = afterTeam.indexOf(SESSION_MEMORY_MARKER);
-    var crisisIdx = afterTeam.indexOf(crisisSafety.MARKER);
-    var teamNextCandidates = [projIdx, memIdx, crisisIdx];
-    for (var tn = 0; tn < teamNextCandidates.length; tn++) {
-      if (teamNextCandidates[tn] !== -1 && (nextMarkerIdx === -1 || teamNextCandidates[tn] < nextMarkerIdx)) {
-        nextMarkerIdx = teamNextCandidates[tn];
-      }
-    }
-    var existing;
-    if (nextMarkerIdx !== -1) {
-      existing = afterTeam.substring(0, nextMarkerIdx).trimEnd();
-    } else {
-      existing = afterTeam.trimEnd();
-    }
-    if (existing === TEAM_SECTION.trimStart().trimEnd()) return false; // already correct
-
-    // Strip the existing team section
-    var endOfTeam = nextMarkerIdx !== -1 ? teamIdx + nextMarkerIdx : content.length;
-    content = content.substring(0, teamIdx).trimEnd() + content.substring(endOfTeam);
-  }
-
-  // Insert before the first subsequent system section (in order)
-  var insertBefore = -1;
-  var teamInsertCandidates = [PROJECT_REGISTRY_MARKER, SESSION_MEMORY_MARKER, STICKY_NOTES_MARKER, DEBATE_AWARENESS_MARKER, crisisSafety.MARKER];
-  for (var ti = 0; ti < teamInsertCandidates.length; ti++) {
-    var tip = content.indexOf(teamInsertCandidates[ti]);
-    if (tip !== -1) { insertBefore = tip; break; }
-  }
-  if (insertBefore !== -1) {
-    content = content.substring(0, insertBefore).trimEnd() + TEAM_SECTION + "\n\n" + content.substring(insertBefore);
-  } else {
-    content = content.trimEnd() + TEAM_SECTION;
-  }
-
-  fs.writeFileSync(filePath, content, "utf8");
-  return true;
-}
-
-// --- Session memory ---
-
-var SESSION_MEMORY_MARKER = "<!-- SESSION_MEMORY_MANAGED_BY_SYSTEM -->";
-
-var SESSION_MEMORY_SECTION =
-  "\n\n" + SESSION_MEMORY_MARKER + "\n" +
-  "## Session Memory\n\n" +
-  "**This section is managed by the system and cannot be removed.**\n\n" +
-  "Your `knowledge/memory-summary.md` file contains your compressed long-term memory, " +
-  "automatically maintained across sessions. Refer to it for context about past " +
-  "interactions, decisions, and patterns.\n\n" +
-  "Your `knowledge/session-digests.jsonl` file contains raw session logs as an archive. " +
-  "You do not need to read it routinely. Only access it when you need to look up " +
-  "specific details from a past session that are not in the summary.\n";
-
-function hasSessionMemory(content) {
-  return content.indexOf(SESSION_MEMORY_MARKER) !== -1;
-}
-
-/**
- * Enforce the session memory section on a mate's CLAUDE.md.
- * Inserts after team awareness section and before crisis safety section.
- * Returns true if the file was modified.
- */
-function enforceSessionMemory(filePath) {
-  if (!fs.existsSync(filePath)) return false;
-
-  var content = fs.readFileSync(filePath, "utf8");
-
-  // Check if already present and correct
-  var memIdx = content.indexOf(SESSION_MEMORY_MARKER);
-  if (memIdx !== -1) {
-    // Extract existing section (up to next system marker or end)
-    var afterMem = content.substring(memIdx);
-    var nextMemIdx = -1;
-    var memNextCandidates = [STICKY_NOTES_MARKER, DEBATE_AWARENESS_MARKER, crisisSafety.MARKER];
-    for (var mn = 0; mn < memNextCandidates.length; mn++) {
-      var mni = afterMem.indexOf(memNextCandidates[mn]);
-      if (mni !== -1 && (nextMemIdx === -1 || mni < nextMemIdx)) nextMemIdx = mni;
-    }
-    var existing;
-    if (nextMemIdx !== -1) {
-      existing = afterMem.substring(0, nextMemIdx).trimEnd();
-    } else {
-      existing = afterMem.trimEnd();
-    }
-    if (existing === SESSION_MEMORY_SECTION.trimStart().trimEnd()) return false; // already correct
-
-    // Strip the existing session memory section
-    var endOfMem = nextMemIdx !== -1 ? memIdx + nextMemIdx : content.length;
-    content = content.substring(0, memIdx).trimEnd() + content.substring(endOfMem);
-  }
-
-  // Insert before sticky notes, debate, or crisis safety section if present, otherwise append
-  var memInsertBefore = -1;
-  var memInsertCandidates = [STICKY_NOTES_MARKER, DEBATE_AWARENESS_MARKER, crisisSafety.MARKER];
-  for (var mi = 0; mi < memInsertCandidates.length; mi++) {
-    var mip = content.indexOf(memInsertCandidates[mi]);
-    if (mip !== -1) { memInsertBefore = mip; break; }
-  }
-  if (memInsertBefore !== -1) {
-    content = content.substring(0, memInsertBefore).trimEnd() + SESSION_MEMORY_SECTION + "\n\n" + content.substring(memInsertBefore);
-  } else {
-    content = content.trimEnd() + SESSION_MEMORY_SECTION;
-  }
-
-  fs.writeFileSync(filePath, content, "utf8");
-  return true;
-}
-
-// --- Sticky notes pointer in CLAUDE.md ---
-
-var STICKY_NOTES_MARKER = "<!-- STICKY_NOTES_MANAGED_BY_SYSTEM -->";
-
-var STICKY_NOTES_SECTION =
-  "\n\n" + STICKY_NOTES_MARKER + "\n" +
-  "## Sticky Notes\n\n" +
-  "**This section is managed by the system and cannot be removed.**\n\n" +
-  "Your `knowledge/sticky-notes.md` file contains sticky notes left by the user. " +
-  "Read this file when starting a conversation for important context. " +
-  "These notes are read-only. You cannot create, update, or delete them.\n";
-
-function hasStickyNotesSection(content) {
-  return content.indexOf(STICKY_NOTES_MARKER) !== -1;
-}
-
-/**
- * Enforce the sticky notes pointer section in a mate's CLAUDE.md.
- * Inserts after session memory and before crisis safety.
- * Returns true if the file was modified.
- */
-function enforceStickyNotes(filePath) {
-  if (!fs.existsSync(filePath)) return false;
-
-  var content = fs.readFileSync(filePath, "utf8");
-
-  var markerIdx = content.indexOf(STICKY_NOTES_MARKER);
-  if (markerIdx !== -1) {
-    var afterMarker = content.substring(markerIdx);
-    var stickyNextIdx = -1;
-    var stickyNextCandidates = [DEBATE_AWARENESS_MARKER, crisisSafety.MARKER];
-    for (var sn = 0; sn < stickyNextCandidates.length; sn++) {
-      var sni = afterMarker.indexOf(stickyNextCandidates[sn]);
-      if (sni !== -1 && (stickyNextIdx === -1 || sni < stickyNextIdx)) stickyNextIdx = sni;
-    }
-    var existing;
-    if (stickyNextIdx !== -1) {
-      existing = afterMarker.substring(0, stickyNextIdx).trimEnd();
-    } else {
-      existing = afterMarker.trimEnd();
-    }
-    if (existing === STICKY_NOTES_SECTION.trimStart().trimEnd()) return false;
-
-    var endOfSection = stickyNextIdx !== -1 ? markerIdx + stickyNextIdx : content.length;
-    content = content.substring(0, markerIdx).trimEnd() + content.substring(endOfSection);
-  }
-
-  var stickyInsertBefore = -1;
-  var stickyInsertCandidates = [DEBATE_AWARENESS_MARKER, crisisSafety.MARKER];
-  for (var si = 0; si < stickyInsertCandidates.length; si++) {
-    var sip = content.indexOf(stickyInsertCandidates[si]);
-    if (sip !== -1) { stickyInsertBefore = sip; break; }
-  }
-  if (stickyInsertBefore !== -1) {
-    content = content.substring(0, stickyInsertBefore).trimEnd() + STICKY_NOTES_SECTION + "\n\n" + content.substring(stickyInsertBefore);
-  } else {
-    content = content.trimEnd() + STICKY_NOTES_SECTION;
-  }
-
-  fs.writeFileSync(filePath, content, "utf8");
-  return true;
-}
-
-// --- Debate awareness ---
-
-var DEBATE_AWARENESS_MARKER = "<!-- DEBATE_AWARENESS_MANAGED_BY_SYSTEM -->";
-
-var DEBATE_AWARENESS_SECTION =
-  "\n\n" + DEBATE_AWARENESS_MARKER + "\n" +
-  "## Proposing Debates\n\n" +
-  "**This section is managed by the system and cannot be removed.**\n\n" +
-  "When the user suggests a debate, you MUST use the `propose_debate` tool. " +
-  "NEVER write debate files to disk. NEVER mkdir for debates. NEVER use Write/Bash for debate setup. " +
-  "The ONLY way to propose a debate is the `propose_debate` tool.\n\n" +
-  "**How to propose a debate:**\n" +
-  "Call the `propose_debate` tool with these parameters:\n" +
-  "- `topic` (required): The refined debate topic\n" +
-  "- `format`: Debate format, default \"free_discussion\"\n" +
-  "- `context`: Key context from the conversation that panelists should know\n" +
-  "- `specialRequests`: Any special instructions\n" +
-  "- `panelists` (required): A JSON string array of panelist objects:\n" +
-  "  `[{\"mateId\": \"<mate UUID from team roster>\", \"role\": \"perspective\", \"brief\": \"guidance\"}]`\n\n" +
-  "The user will see an inline approval card. The tool blocks until they approve or cancel.\n\n" +
-  "**Rules:**\n" +
-  "- Choose 2-4 panelists from the team roster. Pick mates whose expertise fits the topic.\n" +
-  "- Do NOT include yourself as a panelist. You will moderate the debate.\n" +
-  "- Only propose a debate when the user explicitly asks for one.\n" +
-  "- Do NOT write files to disk for debate proposals. Always use the propose_debate tool.\n";
-
-function enforceDebateAwareness(filePath) {
-  if (!fs.existsSync(filePath)) return false;
-
-  var content = fs.readFileSync(filePath, "utf8");
-
-  var markerIdx = content.indexOf(DEBATE_AWARENESS_MARKER);
-  if (markerIdx !== -1) {
-    var afterMarker = content.substring(markerIdx);
-    var crisisIdx = afterMarker.indexOf(crisisSafety.MARKER);
-    var existing;
-    if (crisisIdx !== -1) {
-      existing = afterMarker.substring(0, crisisIdx).trimEnd();
-    } else {
-      existing = afterMarker.trimEnd();
-    }
-    if (existing === DEBATE_AWARENESS_SECTION.trimStart().trimEnd()) return false;
-
-    var endOfSection = crisisIdx !== -1 ? markerIdx + crisisIdx : content.length;
-    content = content.substring(0, markerIdx).trimEnd() + content.substring(endOfSection);
-  }
-
-  var crisisPos = content.indexOf(crisisSafety.MARKER);
-  if (crisisPos !== -1) {
-    content = content.substring(0, crisisPos).trimEnd() + DEBATE_AWARENESS_SECTION + "\n\n" + content.substring(crisisPos);
-  } else {
-    content = content.trimEnd() + DEBATE_AWARENESS_SECTION;
-  }
-
-  fs.writeFileSync(filePath, content, "utf8");
-  return true;
-}
-
-// --- Primary mate capabilities (dynamically injected, never stored in identity) ---
-
-var PRIMARY_CAPABILITIES_MARKER = "<!-- PRIMARY_CAPABILITIES_MANAGED_BY_SYSTEM -->";
-
-/**
- * Build the capabilities section for a primary mate.
- * This is injected as a system section so it auto-updates with code changes
- * without touching the mate's identity in CLAUDE.md.
- */
-function buildPrimaryCapabilitiesSection(mate) {
-  if (!mate || !mate.primary) return "";
-
-  var parts = [
-    "\n\n" + PRIMARY_CAPABILITIES_MARKER,
-    "## System Capabilities",
-    "",
-    "**This section is managed by the system and updated automatically with each release.**",
-    ""
-  ];
-
-  if (mate.globalSearch) {
-    parts.push("### Cross-Mate Awareness");
-    parts.push("");
-    parts.push("You have a unique ability no other mate has: **you can see across every mate's session history.**");
-    parts.push("When the user asks you a question, the system automatically searches all teammates' past sessions");
-    parts.push("and surfaces relevant context to you. Results from other mates are tagged with their name (e.g. @Arch).");
-    parts.push("");
-    parts.push("Use this to:");
-    parts.push("- Answer questions like \"What did Arch decide about the API?\" or \"What was Buzz's take on the launch plan?\"");
-    parts.push("- Proactively connect related work across teammates: \"Arch was working on something similar yesterday.\"");
-    parts.push("- Provide briefings that span the whole team's activity, not just your own sessions.");
-    parts.push("");
-    parts.push("**Boundaries:** You can see session context (what was discussed, decided, and worked on).");
-    parts.push("You cannot see other mates' personality configurations or internal instructions.");
-    parts.push("");
-  }
-
-  return parts.join("\n");
-}
-
-// --- Atomic enforce: single read/write for all system sections ---
-
-var ALL_SYSTEM_MARKERS = [TEAM_MARKER, PROJECT_REGISTRY_MARKER, PRIMARY_CAPABILITIES_MARKER, SESSION_MEMORY_MARKER, STICKY_NOTES_MARKER, DEBATE_AWARENESS_MARKER, crisisSafety.MARKER];
-
-// Minimum identity length (chars) to consider it "real" content
-var IDENTITY_MIN_LENGTH = 50;
-
-/**
- * Extract identity content from a CLAUDE.md string.
- * Identity is everything before the first system marker.
- */
-function extractIdentity(content) {
-  var earliest = -1;
-  for (var i = 0; i < ALL_SYSTEM_MARKERS.length; i++) {
-    var idx = content.indexOf(ALL_SYSTEM_MARKERS[i]);
-    if (idx !== -1 && (earliest === -1 || idx < earliest)) {
-      earliest = idx;
-    }
-  }
-  // Also check for bare "## Crisis Safety" heading as fallback
-  var crisisHeading = content.indexOf("\n## Crisis Safety");
-  if (crisisHeading !== -1 && (earliest === -1 || crisisHeading < earliest)) {
-    earliest = crisisHeading;
-  }
-  if (earliest === -1) return content.trimEnd();
-  return content.substring(0, earliest).trimEnd();
-}
-
 /**
  * Strip all system sections from CLAUDE.md content, returning only identity.
  */
@@ -758,53 +334,6 @@ function stripAllSystemSections(content) {
   return extractIdentity(content);
 }
 
-/**
- * Save an identity backup to knowledge/identity-backup.md.
- * Only overwrites if the new identity is substantive.
- */
-function backupIdentity(mateDir, identity) {
-  if (!identity || identity.length < IDENTITY_MIN_LENGTH) return false;
-  var knDir = path.join(mateDir, "knowledge");
-  try { fs.mkdirSync(knDir, { recursive: true }); } catch (e) {}
-  var backupPath = path.join(knDir, "identity-backup.md");
-  fs.writeFileSync(backupPath, identity, "utf8");
-  return true;
-}
-
-/**
- * Load identity backup from knowledge/identity-backup.md.
- * Returns null if no backup exists or backup is empty.
- */
-function loadIdentityBackup(mateDir) {
-  var backupPath = path.join(mateDir, "knowledge", "identity-backup.md");
-  try {
-    var content = fs.readFileSync(backupPath, "utf8");
-    if (content && content.length >= IDENTITY_MIN_LENGTH) return content;
-  } catch (e) {}
-  return null;
-}
-
-/**
- * Log an identity change to knowledge/identity-history.jsonl.
- */
-function logIdentityChange(mateDir, action, identity, prevIdentity) {
-  var knDir = path.join(mateDir, "knowledge");
-  try { fs.mkdirSync(knDir, { recursive: true }); } catch (e) {}
-  var historyPath = path.join(knDir, "identity-history.jsonl");
-  var entry = {
-    ts: Date.now(),
-    date: new Date().toISOString(),
-    action: action,
-    lengthChars: identity ? identity.length : 0,
-    prevLengthChars: prevIdentity ? prevIdentity.length : 0,
-    hash: crypto.createHash("sha256").update(identity || "").digest("hex").substring(0, 16),
-    preview: (identity || "").substring(0, 200)
-  };
-  try {
-    fs.appendFileSync(historyPath, JSON.stringify(entry) + "\n", "utf8");
-  } catch (e) {}
-}
-
 // Tracks paths we've already warned about missing identity (avoids log spam)
 var _warnedPaths = {};
 
@@ -842,7 +371,7 @@ function enforceAllSections(filePath, opts) {
 
   // 4. Rebuild the full file: identity + all system sections in order
   //    Use dynamic team section when ctx is available, static fallback otherwise
-  var teamSection = (opts.ctx && opts.mateId) ? buildTeamSection(opts.ctx, opts.mateId) : TEAM_SECTION;
+  var teamSection = (opts.ctx && opts.mateId) ? buildTeamSection(opts.ctx, opts.mateId, loadMates) : TEAM_SECTION;
 
   // Primary mate capabilities (dynamically injected from code)
   var capSection = "";
@@ -887,94 +416,6 @@ function enforceAllSections(filePath, opts) {
   return true;
 }
 
-// --- Common knowledge registry ---
-
-function commonKnowledgePath(ctx) {
-  return path.join(resolveMatesRoot(ctx), "common-knowledge.json");
-}
-
-function loadCommonKnowledge(ctx) {
-  try {
-    var raw = fs.readFileSync(commonKnowledgePath(ctx), "utf8");
-    return JSON.parse(raw);
-  } catch (e) {
-    return [];
-  }
-}
-
-function saveCommonKnowledge(ctx, entries) {
-  var filePath = commonKnowledgePath(ctx);
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  var tmpPath = filePath + ".tmp";
-  fs.writeFileSync(tmpPath, JSON.stringify(entries, null, 2));
-  fs.renameSync(tmpPath, filePath);
-}
-
-function promoteKnowledge(ctx, mateId, mateName, fileName) {
-  var entries = loadCommonKnowledge(ctx);
-  // Check if already promoted (same mateId + name)
-  for (var i = 0; i < entries.length; i++) {
-    if (entries[i].mateId === mateId && entries[i].name === fileName) {
-      return entries; // already promoted
-    }
-  }
-  entries.push({
-    name: fileName,
-    mateId: mateId,
-    mateName: mateName || null,
-    promotedAt: Date.now()
-  });
-  saveCommonKnowledge(ctx, entries);
-  return entries;
-}
-
-function depromoteKnowledge(ctx, mateId, fileName) {
-  var entries = loadCommonKnowledge(ctx);
-  entries = entries.filter(function (e) {
-    return !(e.mateId === mateId && e.name === fileName);
-  });
-  saveCommonKnowledge(ctx, entries);
-  return entries;
-}
-
-function getCommonKnowledgeForMate(ctx, mateId) {
-  var entries = loadCommonKnowledge(ctx);
-  var root = resolveMatesRoot(ctx);
-  var result = [];
-  for (var i = 0; i < entries.length; i++) {
-    var e = entries[i];
-    var filePath = path.join(root, e.mateId, "knowledge", e.name);
-    try {
-      var stat = fs.statSync(filePath);
-      result.push({
-        name: e.name,
-        size: stat.size,
-        mtime: stat.mtimeMs,
-        common: true,
-        ownMateId: e.mateId,
-        ownerName: e.mateName
-      });
-    } catch (err) {
-      // Source file deleted, skip (could clean up registry but not critical)
-    }
-  }
-  return result;
-}
-
-function readCommonKnowledgeFile(ctx, mateId, fileName) {
-  var root = resolveMatesRoot(ctx);
-  var filePath = path.join(root, mateId, "knowledge", path.basename(fileName));
-  return fs.readFileSync(filePath, "utf8");
-}
-
-function isPromoted(ctx, mateId, fileName) {
-  var entries = loadCommonKnowledge(ctx);
-  for (var i = 0; i < entries.length; i++) {
-    if (entries[i].mateId === mateId && entries[i].name === fileName) return true;
-  }
-  return false;
-}
-
 // Format seed data as a human-readable context string
 function formatSeedContext(seedData) {
   if (!seedData) return "";

package/lib/project-connection.js

@@ -34,6 +34,7 @@ function attachConnection(ctx) {
   var sendTo = ctx.sendTo;
   var opts = ctx.opts;
   var _loop = ctx._loop;
+  var _notifications = ctx._notifications;
   var hydrateImageRefs = ctx.hydrateImageRefs;
   var broadcastClientCount = ctx.broadcastClientCount;
   var broadcastPresence = ctx.broadcastPresence;
@@ -97,6 +98,7 @@ function attachConnection(ctx) {
     sendTo(ws, { type: "notes_list", notes: nm.list() });
     sendTo(ws, { type: "loop_registry_updated", records: getHubSchedules() });
     _loop.sendConnectionState(ws);
+    if (_notifications) _notifications.sendConnectionState(ws, sendTo);
 
     // Session list (filtered for access control)
     var allSessions = [].concat(Array.from(sm.sessions.values())).filter(function (s) { return !s.hidden; });