synomem 0.1.0

package/src/projections.ts

@@ -0,0 +1,624 @@
+import { existsSync, lstatSync, unlinkSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { SynomemError } from './errors.js';
+import {
+  assertNoSymlinkEscape,
+  atomicWriteDerivedFile,
+  atomicWriteFile,
+  ensureDirectory,
+} from './fs-utils.js';
+import type { SynomemStorage } from './storage.js';
+import type { ProjectionWriter } from './ports/projections.js';
+import type {
+  AgentProfile,
+  EvidenceReference,
+  SynomemEvent,
+  KudosRecord,
+  MemoRecord,
+  NoteRecord,
+  TodoRecord,
+} from './types.js';
+
+const generatedMarker = '<!-- Generated by Synomem. Rebuild with `synomem rebuild`. -->';
+
+function manifestPath(home: string, path: string): string {
+  return relative(home, path).split(sep).join('/');
+}
+
+export function escapeMarkdown(value: string): string {
+  return value
+    .replaceAll('&', '&amp;')
+    .replaceAll('<', '&lt;')
+    .replaceAll('>', '&gt;')
+    .replace(/([\\`*_{}[\]()#+!|])/g, '\\$1')
+    .replace(/^(\s*)(-|\d+\.)\s/gm, '$1\\$2 ');
+}
+
+function evidenceLine(evidence: EvidenceReference): string {
+  const kind = evidence.kind.replace('-', ' ');
+  const label = evidence.label ? `${escapeMarkdown(evidence.label)} — ` : '';
+  return `- **${escapeMarkdown(kind[0]?.toUpperCase() + kind.slice(1))}:** ${label}${escapeMarkdown(evidence.value)}`;
+}
+
+function recordMarkdown(record: KudosRecord, includeTitle = true): string {
+  const event = record.event;
+  const lines = [
+    ...(includeTitle ? [`### ${escapeMarkdown(event.title)}`, ''] : []),
+    `**Received:** ${event.createdAt.slice(0, 10)}  `,
+    `**From:** ${escapeMarkdown(event.actor.displayName ?? event.actor.id)}  `,
+    `**Status:** ${record.status === 'acknowledged' ? 'Acknowledged' : 'Unacknowledged'}  `,
+  ];
+  if (event.tags?.length) lines.push(`**Tags:** ${event.tags.map(escapeMarkdown).join(', ')}  `);
+  lines.push('', escapeMarkdown(event.reason), '');
+  if (event.evidence?.length) {
+    lines.push('**Evidence**', '', ...event.evidence.map(evidenceLine), '');
+  }
+  if (record.acknowledgment?.note) {
+    lines.push(`**Acknowledgment note:** ${escapeMarkdown(record.acknowledgment.note)}`, '');
+  }
+  lines.push(`**Kudos ID:** \`${event.id}\``, '');
+  return lines.join('\n');
+}
+
+function winsMarkdown(profile: AgentProfile, records: KudosRecord[], rebuiltAt: string): string {
+  const active = records.filter((record) => !record.revocation);
+  const lines = [
+    generatedMarker,
+    '',
+    `# Wins — ${escapeMarkdown(profile.displayName)}`,
+    '',
+    `_Last rebuilt: ${rebuiltAt}_`,
+    '',
+  ];
+  if (active.length === 0) {
+    lines.push('_No kudos yet. Excellent work remains entirely possible._', '');
+    return `${lines.join('\n')}\n`;
+  }
+  let year = '';
+  for (const record of active) {
+    const nextYear = record.event.createdAt.slice(0, 4);
+    if (nextYear !== year) {
+      year = nextYear;
+      lines.push(`## ${year}`, '');
+    }
+    lines.push(recordMarkdown(record));
+  }
+  return `${lines.join('\n')}\n`;
+}
+
+function inboxMarkdown(record: KudosRecord): string {
+  return `${[
+    generatedMarker,
+    '',
+    `# ${escapeMarkdown(record.event.title)}`,
+    '',
+    recordMarkdown(record, false),
+  ].join('\n')}\n`;
+}
+
+function memoInboxMarkdown(record: MemoRecord): string {
+  return `${[
+    generatedMarker,
+    '',
+    `# ${escapeMarkdown(record.event.subject)}`,
+    '',
+    `**From:** ${escapeMarkdown(record.event.actor.displayName ?? record.event.actor.id)}  `,
+    `**Sent:** ${record.event.createdAt}  `,
+    `**Memo ID:** \`${record.event.id}\``,
+    '',
+    escapeMarkdown(record.event.body),
+    '',
+  ].join('\n')}\n`;
+}
+
+function todoInboxMarkdown(record: TodoRecord): string {
+  const due =
+    record.current.due?.kind === 'date'
+      ? record.current.due.date
+      : record.current.due
+        ? `${record.current.due.datetime} (${record.current.due.timeZone})`
+        : 'None';
+  return `${[
+    generatedMarker,
+    '',
+    `# ${escapeMarkdown(record.current.title)}`,
+    '',
+    `**Status:** ${record.status}  `,
+    `**Priority:** ${record.current.priority}  `,
+    `**Due:** ${escapeMarkdown(due)}  `,
+    `**Todo ID:** \`${record.event.id}\``,
+    '',
+    ...(record.current.description ? [escapeMarkdown(record.current.description), ''] : []),
+  ].join('\n')}\n`;
+}
+
+function memoryMarkdown(profile: AgentProfile, records: NoteRecord[], rebuiltAt: string): string {
+  const active = records.filter((record) => record.status === 'active');
+  const lines = [
+    generatedMarker,
+    '',
+    `# Memory — ${escapeMarkdown(profile.displayName)}`,
+    '',
+    `_Last rebuilt: ${rebuiltAt}_`,
+    '',
+  ];
+  if (!active.length) lines.push('_No canonical notes yet._', '');
+  for (const record of active) {
+    lines.push(
+      `## ${escapeMarkdown(record.current.title)}`,
+      '',
+      escapeMarkdown(record.current.body),
+      '',
+      `**Version:** ${record.current.version}  `,
+      `**Note ID:** \`${record.event.id}\``,
+      '',
+    );
+  }
+  return `${lines.join('\n')}\n`;
+}
+
+function todosMarkdown(profile: AgentProfile, records: TodoRecord[], rebuiltAt: string): string {
+  const lines = [
+    generatedMarker,
+    '',
+    `# Todos — ${escapeMarkdown(profile.displayName)}`,
+    '',
+    `_Last rebuilt: ${rebuiltAt}_`,
+    '',
+  ];
+  if (!records.length) lines.push('_No todos yet._', '');
+  for (const record of records) {
+    const due =
+      record.current.due?.kind === 'date'
+        ? record.current.due.date
+        : record.current.due
+          ? `${record.current.due.datetime} (${record.current.due.timeZone})`
+          : 'None';
+    lines.push(
+      `## ${escapeMarkdown(record.current.title)}`,
+      '',
+      `**Status:** ${record.status}  `,
+      `**Priority:** ${record.current.priority}  `,
+      `**Due:** ${escapeMarkdown(due)}  `,
+      `**Todo ID:** \`${record.event.id}\``,
+      '',
+    );
+  }
+  return `${lines.join('\n')}\n`;
+}
+
+export function recordsFromEvents(events: SynomemEvent[]): KudosRecord[] {
+  const acknowledgments = new Map<string, KudosRecord['acknowledgment']>();
+  const revocations = new Map<string, KudosRecord['revocation']>();
+  for (const event of events) {
+    if (event.type === 'kudos.acknowledged' && !acknowledgments.has(event.kudosId)) {
+      acknowledgments.set(event.kudosId, event);
+    }
+    if (event.type === 'kudos.revoked' && !revocations.has(event.kudosId)) {
+      revocations.set(event.kudosId, event);
+    }
+  }
+  return events
+    .filter((event) => event.type === 'kudos.given')
+    .map((event) => {
+      const acknowledgment = acknowledgments.get(event.id);
+      const revocation = revocations.get(event.id);
+      return {
+        event,
+        ...(acknowledgment ? { acknowledgment } : {}),
+        ...(revocation ? { revocation } : {}),
+        status: acknowledgment ? 'acknowledged' : 'unacknowledged',
+        revocationStatus: revocation ? 'revoked' : 'active',
+      } satisfies KudosRecord;
+    })
+    .sort(
+      (a, b) =>
+        b.event.createdAt.localeCompare(a.event.createdAt) || b.event.id.localeCompare(a.event.id),
+    );
+}
+
+export function memoRecordsFromEvents(events: SynomemEvent[]): MemoRecord[] {
+  const records = new Map<string, MemoRecord>();
+  for (const event of events) {
+    if (event.type === 'memo.sent') {
+      records.set(event.id, { event, status: 'unread' });
+    } else if (event.type === 'memo.read') {
+      const record = records.get(event.memoId);
+      if (record) {
+        record.read = event;
+        if (!record.archived) record.status = 'read';
+      }
+    } else if (event.type === 'memo.archived') {
+      const record = records.get(event.memoId);
+      if (record) {
+        record.archived = event;
+        record.status = 'archived';
+      }
+    }
+  }
+  return [...records.values()].sort((a, b) => b.event.createdAt.localeCompare(a.event.createdAt));
+}
+
+export function noteRecordsFromEvents(events: SynomemEvent[]): NoteRecord[] {
+  const records = new Map<string, NoteRecord>();
+  for (const event of events) {
+    if (event.type === 'note.created') {
+      records.set(event.id, {
+        event,
+        current: {
+          title: event.title,
+          body: event.body,
+          tags: event.tags ?? [],
+          visibility: event.visibility,
+          version: event.aggregateVersion,
+        },
+        status: 'active',
+      });
+    } else if (event.type === 'note.revised') {
+      const record = records.get(event.noteId);
+      if (record) {
+        record.revision = event;
+        record.current = {
+          title: event.title,
+          body: event.body,
+          tags: event.tags ?? [],
+          visibility: event.visibility,
+          version: event.aggregateVersion,
+        };
+      }
+    } else if (event.type === 'note.archived') {
+      const record = records.get(event.noteId);
+      if (record) {
+        record.archived = event;
+        record.current.version = event.aggregateVersion;
+        record.status = 'archived';
+      }
+    }
+  }
+  return [...records.values()].sort((a, b) => b.event.createdAt.localeCompare(a.event.createdAt));
+}
+
+export function todoRecordsFromEvents(events: SynomemEvent[]): TodoRecord[] {
+  const records = new Map<string, TodoRecord>();
+  for (const event of events) {
+    if (event.type === 'todo.created') {
+      records.set(event.id, {
+        event,
+        current: {
+          title: event.title,
+          ...(event.description !== undefined ? { description: event.description } : {}),
+          priority: event.priority,
+          ...(event.due ? { due: event.due } : {}),
+          tags: event.tags ?? [],
+          visibility: event.visibility,
+          version: event.aggregateVersion,
+        },
+        status: event.requiresAcceptance ? 'assigned' : 'open',
+      });
+    } else if (event.type === 'todo.updated') {
+      const record = records.get(event.todoId);
+      if (record) {
+        record.update = event;
+        record.current = {
+          title: event.title,
+          ...(event.description !== undefined ? { description: event.description } : {}),
+          priority: event.priority,
+          ...(event.due ? { due: event.due } : {}),
+          tags: event.tags ?? [],
+          visibility: event.visibility,
+          version: event.aggregateVersion,
+        };
+      }
+    } else if (event.type === 'todo.accepted') {
+      const record = records.get(event.todoId);
+      if (record) {
+        record.current.version = event.aggregateVersion;
+        record.status = 'open';
+      }
+    } else if (
+      event.type === 'todo.completed' ||
+      event.type === 'todo.rejected' ||
+      event.type === 'todo.canceled'
+    ) {
+      const record = records.get(event.todoId);
+      if (record) {
+        record.terminal = event;
+        record.current.version = event.aggregateVersion;
+        record.status =
+          event.type === 'todo.completed'
+            ? 'completed'
+            : event.type === 'todo.rejected'
+              ? 'rejected'
+              : 'canceled';
+      }
+    } else if (event.type === 'todo.reopened') {
+      const record = records.get(event.todoId);
+      if (record) {
+        record.reopened = event;
+        record.current.version = event.aggregateVersion;
+        record.status = 'open';
+      }
+    }
+  }
+  return [...records.values()].sort((a, b) => b.event.createdAt.localeCompare(a.event.createdAt));
+}
+
+/** Render a portable human-readable export without reading generated projections. */
+export function renderMarkdownExport(events: SynomemEvent[]): string {
+  const sections = [
+    ...recordsFromEvents(events).map(
+      (record) =>
+        `## Kudos: ${escapeMarkdown(record.event.title)}\n\n${escapeMarkdown(record.event.reason)}\n\nStatus: ${record.revocationStatus === 'revoked' ? 'Revoked' : record.status}\n\nID: \`${record.event.id}\``,
+    ),
+    ...memoRecordsFromEvents(events).map(
+      (record) =>
+        `## Memo: ${escapeMarkdown(record.event.subject)}\n\n${escapeMarkdown(record.event.body)}\n\nStatus: ${record.status}\n\nID: \`${record.event.id}\``,
+    ),
+    ...noteRecordsFromEvents(events).map(
+      (record) =>
+        `## Note: ${escapeMarkdown(record.current.title)}\n\n${escapeMarkdown(record.current.body)}\n\nStatus: ${record.status}; version ${record.current.version}\n\nID: \`${record.event.id}\``,
+    ),
+    ...todoRecordsFromEvents(events).map(
+      (record) =>
+        `## Todo: ${escapeMarkdown(record.current.title)}\n\n${record.current.description ? `${escapeMarkdown(record.current.description)}\n\n` : ''}Status: ${record.status}; priority ${record.current.priority}\n\nID: \`${record.event.id}\``,
+    ),
+  ];
+  return `${sections.join('\n\n')}\n`;
+}
+
+export class ProjectionManager implements ProjectionWriter {
+  constructor(private readonly storage: SynomemStorage) {}
+
+  rebuild(): { generated: string[]; removed: string[] } {
+    this.storage.assertWritable();
+    const events = this.storage.getEvents();
+    this.storage.transactionSync(() => {
+      this.storage.rebuildKudosCurrentIndex();
+      this.storage.rebuildItemsCurrentIndex();
+    });
+    const profiles = this.storage.listAgents();
+    const records = recordsFromEvents(events);
+    const memos = memoRecordsFromEvents(events);
+    const notes = noteRecordsFromEvents(events);
+    const todos = todoRecordsFromEvents(events);
+    const rebuiltAt = events.at(-1)?.createdAt ?? new Date(0).toISOString();
+    const generated: string[] = [];
+
+    for (const profile of profiles) {
+      const agentDirectory = join(this.storage.home, profile.id);
+      assertNoSymlinkEscape(this.storage.home, agentDirectory);
+      ensureDirectory(agentDirectory);
+      const profilePath = join(agentDirectory, 'profile.json');
+      const winsPath = join(agentDirectory, 'WINS.md');
+      const notesPath = join(agentDirectory, 'NOTES.md');
+      const inboxDirectory = join(agentDirectory, 'inbox');
+      const kudosInboxDirectory = join(inboxDirectory, 'kudos');
+      const memoInboxDirectory = join(inboxDirectory, 'memos');
+      const todoInboxDirectory = join(inboxDirectory, 'todos');
+      assertNoSymlinkEscape(this.storage.home, inboxDirectory);
+      ensureDirectory(inboxDirectory);
+      ensureDirectory(kudosInboxDirectory);
+      ensureDirectory(memoInboxDirectory);
+      ensureDirectory(todoInboxDirectory);
+
+      atomicWriteDerivedFile(
+        profilePath,
+        `${JSON.stringify({ _generatedBy: 'synomem', ...profile }, null, 2)}\n`,
+      );
+      generated.push(manifestPath(this.storage.home, profilePath));
+      if (!existsSync(notesPath)) {
+        atomicWriteFile(
+          notesPath,
+          `# Notes — ${profile.displayName}\n\n<!-- Human-owned. Synomem will never overwrite this file. -->\n`,
+        );
+      }
+
+      const agentRecords = records.filter((record) => record.event.recipientAgentId === profile.id);
+      if (this.storage.config.projection.writeWinsMarkdown) {
+        atomicWriteDerivedFile(winsPath, winsMarkdown(profile, agentRecords, rebuiltAt));
+        generated.push(manifestPath(this.storage.home, winsPath));
+      }
+      const agentNotes = notes.filter((record) => record.event.ownerAgentId === profile.id);
+      if (this.storage.config.projection.writeMemoryMarkdown) {
+        const memoryPath = join(agentDirectory, 'MEMORY.md');
+        atomicWriteDerivedFile(memoryPath, memoryMarkdown(profile, agentNotes, rebuiltAt));
+        generated.push(manifestPath(this.storage.home, memoryPath));
+      }
+      const agentTodos = todos.filter((record) => record.event.assigneeAgentId === profile.id);
+      if (this.storage.config.projection.writeTodosMarkdown) {
+        const todosPath = join(agentDirectory, 'TODOS.md');
+        atomicWriteDerivedFile(todosPath, todosMarkdown(profile, agentTodos, rebuiltAt));
+        generated.push(manifestPath(this.storage.home, todosPath));
+      }
+      if (this.storage.config.projection.writeInboxEntries) {
+        for (const record of agentRecords.filter(
+          (item) => item.status === 'unacknowledged' && item.revocationStatus === 'active',
+        )) {
+          const inboxPath = join(kudosInboxDirectory, `${record.event.id}.md`);
+          atomicWriteDerivedFile(inboxPath, inboxMarkdown(record));
+          generated.push(manifestPath(this.storage.home, inboxPath));
+        }
+        for (const record of memos.filter(
+          (item) => item.event.recipientAgentId === profile.id && item.status === 'unread',
+        )) {
+          const inboxPath = join(memoInboxDirectory, `${record.event.id}.md`);
+          atomicWriteDerivedFile(inboxPath, memoInboxMarkdown(record));
+          generated.push(manifestPath(this.storage.home, inboxPath));
+        }
+        for (const record of agentTodos.filter(
+          (item) => item.status === 'open' || item.status === 'assigned',
+        )) {
+          const inboxPath = join(todoInboxDirectory, `${record.event.id}.md`);
+          atomicWriteDerivedFile(inboxPath, todoInboxMarkdown(record));
+          generated.push(manifestPath(this.storage.home, inboxPath));
+        }
+      }
+    }
+
+    const keep = new Set(generated);
+    const removed: string[] = [];
+    for (const stale of this.storage.projectionManifest()) {
+      if (keep.has(stale)) continue;
+      const path = join(this.storage.home, stale);
+      assertNoSymlinkEscape(this.storage.home, path);
+      if (!existsSync(path)) continue;
+      const stat = lstatSync(path);
+      if (!stat.isFile() || stat.isSymbolicLink()) {
+        throw new SynomemError('UNSAFE_PATH', `Refusing to remove unsafe generated path: ${stale}`);
+      }
+      unlinkSync(path);
+      removed.push(stale);
+    }
+    this.storage.replaceProjectionManifest(generated, rebuiltAt);
+    return { generated: generated.sort(), removed: removed.sort() };
+  }
+
+  syncAgent(agentId: string): { generated: string[]; removed: string[] } {
+    this.storage.assertWritable();
+    const profile = this.storage.getAgent(agentId);
+    if (!profile) throw new SynomemError('AGENT_NOT_FOUND', `Unknown agent: ${agentId}`);
+    const events = this.storage.getEvents();
+    const records = recordsFromEvents(events).filter(
+      (record) => record.event.recipientAgentId === profile.id,
+    );
+    const memos = memoRecordsFromEvents(events).filter(
+      (record) => record.event.recipientAgentId === profile.id,
+    );
+    const notes = noteRecordsFromEvents(events).filter(
+      (record) => record.event.ownerAgentId === profile.id,
+    );
+    const todos = todoRecordsFromEvents(events).filter(
+      (record) => record.event.assigneeAgentId === profile.id,
+    );
+    const rebuiltAt = events.at(-1)?.createdAt ?? new Date(0).toISOString();
+    const agentDirectory = join(this.storage.home, profile.id);
+    const inboxDirectory = join(agentDirectory, 'inbox');
+    const kudosInboxDirectory = join(inboxDirectory, 'kudos');
+    const memoInboxDirectory = join(inboxDirectory, 'memos');
+    const todoInboxDirectory = join(inboxDirectory, 'todos');
+    assertNoSymlinkEscape(this.storage.home, agentDirectory);
+    assertNoSymlinkEscape(this.storage.home, inboxDirectory);
+    ensureDirectory(agentDirectory);
+    ensureDirectory(inboxDirectory);
+    ensureDirectory(kudosInboxDirectory);
+    ensureDirectory(memoInboxDirectory);
+    ensureDirectory(todoInboxDirectory);
+
+    const generated: string[] = [];
+    const profilePath = join(agentDirectory, 'profile.json');
+    atomicWriteDerivedFile(
+      profilePath,
+      `${JSON.stringify({ _generatedBy: 'synomem', ...profile }, null, 2)}\n`,
+    );
+    generated.push(manifestPath(this.storage.home, profilePath));
+
+    const notesPath = join(agentDirectory, 'NOTES.md');
+    if (!existsSync(notesPath)) {
+      atomicWriteFile(
+        notesPath,
+        `# Notes — ${profile.displayName}\n\n<!-- Human-owned. Synomem will never overwrite this file. -->\n`,
+      );
+    }
+
+    if (this.storage.config.projection.writeWinsMarkdown) {
+      const winsPath = join(agentDirectory, 'WINS.md');
+      atomicWriteDerivedFile(winsPath, winsMarkdown(profile, records, rebuiltAt));
+      generated.push(manifestPath(this.storage.home, winsPath));
+    }
+
+    if (this.storage.config.projection.writeMemoryMarkdown) {
+      const memoryPath = join(agentDirectory, 'MEMORY.md');
+      atomicWriteDerivedFile(memoryPath, memoryMarkdown(profile, notes, rebuiltAt));
+      generated.push(manifestPath(this.storage.home, memoryPath));
+    }
+
+    if (this.storage.config.projection.writeTodosMarkdown) {
+      const todosPath = join(agentDirectory, 'TODOS.md');
+      atomicWriteDerivedFile(todosPath, todosMarkdown(profile, todos, rebuiltAt));
+      generated.push(manifestPath(this.storage.home, todosPath));
+    }
+
+    if (this.storage.config.projection.writeInboxEntries) {
+      for (const record of records.filter(
+        (item) => item.status === 'unacknowledged' && item.revocationStatus === 'active',
+      )) {
+        const inboxPath = join(kudosInboxDirectory, `${record.event.id}.md`);
+        const relativePath = manifestPath(this.storage.home, inboxPath);
+        if (!existsSync(inboxPath)) atomicWriteDerivedFile(inboxPath, inboxMarkdown(record));
+        generated.push(relativePath);
+      }
+      for (const record of memos.filter((item) => item.status === 'unread')) {
+        const inboxPath = join(memoInboxDirectory, `${record.event.id}.md`);
+        const relativePath = manifestPath(this.storage.home, inboxPath);
+        if (!existsSync(inboxPath)) atomicWriteDerivedFile(inboxPath, memoInboxMarkdown(record));
+        generated.push(relativePath);
+      }
+      for (const record of todos.filter(
+        (item) => item.status === 'open' || item.status === 'assigned',
+      )) {
+        const inboxPath = join(todoInboxDirectory, `${record.event.id}.md`);
+        const relativePath = manifestPath(this.storage.home, inboxPath);
+        if (!existsSync(inboxPath)) atomicWriteDerivedFile(inboxPath, todoInboxMarkdown(record));
+        generated.push(relativePath);
+      }
+    }
+
+    const keep = new Set(generated);
+    const prefixes = [`${profile.id}/`, `${profile.id}\\`];
+    const removed: string[] = [];
+    for (const stale of this.storage
+      .projectionManifest()
+      .filter((path) => prefixes.some((prefix) => path.startsWith(prefix)))) {
+      if (keep.has(stale)) continue;
+      const path = join(this.storage.home, stale);
+      assertNoSymlinkEscape(this.storage.home, path);
+      if (!existsSync(path)) continue;
+      const stat = lstatSync(path);
+      if (!stat.isFile() || stat.isSymbolicLink()) {
+        throw new SynomemError('UNSAFE_PATH', `Refusing to remove unsafe generated path: ${stale}`);
+      }
+      unlinkSync(path);
+      removed.push(stale);
+    }
+    this.storage.replaceAgentProjectionManifest(profile.id, generated, rebuiltAt);
+    return { generated: generated.sort(), removed: removed.sort() };
+  }
+
+  expectedPaths(): string[] {
+    const profiles = this.storage.listAgents();
+    const events = this.storage.getReadableEvents();
+    const records = recordsFromEvents(events);
+    const memos = memoRecordsFromEvents(events);
+    const todos = todoRecordsFromEvents(events);
+    const paths: string[] = [];
+    for (const profile of profiles) {
+      paths.push(`${profile.id}/profile.json`);
+      if (this.storage.config.projection.writeWinsMarkdown) paths.push(`${profile.id}/WINS.md`);
+      if (this.storage.config.projection.writeMemoryMarkdown) paths.push(`${profile.id}/MEMORY.md`);
+      if (this.storage.config.projection.writeTodosMarkdown) paths.push(`${profile.id}/TODOS.md`);
+      if (this.storage.config.projection.writeInboxEntries) {
+        for (const record of records.filter(
+          (item) =>
+            item.event.recipientAgentId === profile.id &&
+            item.status === 'unacknowledged' &&
+            item.revocationStatus === 'active',
+        )) {
+          paths.push(`${profile.id}/inbox/kudos/${record.event.id}.md`);
+        }
+        for (const record of memos.filter(
+          (item) => item.event.recipientAgentId === profile.id && item.status === 'unread',
+        )) {
+          paths.push(`${profile.id}/inbox/memos/${record.event.id}.md`);
+        }
+        for (const record of todos.filter(
+          (item) =>
+            item.event.assigneeAgentId === profile.id &&
+            (item.status === 'open' || item.status === 'assigned'),
+        )) {
+          paths.push(`${profile.id}/inbox/todos/${record.event.id}.md`);
+        }
+      }
+    }
+    return paths.sort();
+  }
+}