Function recordEpisode

src/context/episodic-memory.ts:46–55

(projectRoot: string, rec: Omit<Episode, 'ts'>)

/** Append one episode after an objectively-successful task. Best-effort. */
export async function recordEpisode(projectRoot: string, rec: Omit<Episode, 'ts'>): Promise<void> {
  try {
    if (!rec.prompt.trim()) return;
    const full = episodesPath(projectRoot);
    await fs.mkdir(path.dirname(full), { recursive: true });
    await fs.appendFile(full, JSON.stringify({ ts: new Date().toISOString(), ...rec }) + '\n', 'utf-8');
  } catch (e: any) {
    logger.debug('Episode not recorded', { err: e?.message });
  }
}

/** Read this project's episodes (most recent `limit`). */
export async function readEpisodes(projectRoot: string, limit = 500): Promise<Episode[]> {