nightralph 0.0.53 → 0.0.54

package/dist/learnings.js

@@ -0,0 +1,356 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import {
+  appendFileSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync
+} from "node:fs";
+import { basename, dirname, join } from "node:path";
+const MAX_OWN_ENTRIES = 4;
+const MAX_ENTRY_CHARS = 4e3;
+const LOG_TAIL_LINES = 40;
+const NOTES_PATH = ".nightralph/notes.md";
+const SENTINEL_PREFIX = "<!-- nightralph:entry";
+const TRUNCATED_MARKER = "[truncated]";
+const LEARNING_OUTCOMES = [
+  "done",
+  "exit",
+  "tests",
+  "install",
+  "no-commits",
+  "error",
+  "merge"
+];
+function encodeKey(key) {
+  return key.replace(/%/g, "%25").replace(/\s/g, (c) => encodeURIComponent(c));
+}
+__name(encodeKey, "encodeKey");
+function fence(content) {
+  const longest = Math.max(
+    0,
+    ...[...content.matchAll(/`+/g)].map((m) => m[0].length)
+  );
+  const ticks = "`".repeat(Math.max(3, longest + 1));
+  return `${ticks}
+${content}
+${ticks}`;
+}
+__name(fence, "fence");
+function sanitize(text) {
+  if (!text) return "";
+  return text.replace(
+    new RegExp(SENTINEL_PREFIX, "g"),
+    "<!-- nightralph-entry"
+  );
+}
+__name(sanitize, "sanitize");
+function renderAgentSummary(run, effort) {
+  const effortLine = effort ? `Effort: ${effort}.` : "";
+  const exitLine = `Agent exit: ${run.exitCode}.`;
+  const itemsText = run.completedItems.length > 0 ? run.completedItems.map(
+    (item) => `"${sanitize(item)}"`
+  ).join(", ") + "." : "none.";
+  const itemsLine = `Checked items: ${itemsText}`;
+  return [
+    effortLine,
+    exitLine,
+    itemsLine
+  ].filter(Boolean).join(" ");
+}
+__name(renderAgentSummary, "renderAgentSummary");
+function renderNotesSection(notes) {
+  const notesSanitized = sanitize(notes);
+  return notesSanitized.trim() ? `### Agent notes
+${notesSanitized}` : "The agent left no notes.";
+}
+__name(renderNotesSection, "renderNotesSection");
+function formatDate(date) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  const hours = String(date.getHours()).padStart(2, "0");
+  const minutes = String(date.getMinutes()).padStart(2, "0");
+  return `${year}-${month}-${day} ${hours}:${minutes}`;
+}
+__name(formatDate, "formatDate");
+function isLearningOutcome(value) {
+  return LEARNING_OUTCOMES.some((o) => o === value);
+}
+__name(isLearningOutcome, "isLearningOutcome");
+function renderEntry(input) {
+  const encodedKey = encodeKey(input.key);
+  const hasRun = "run" in input;
+  const timedOut = hasRun && input.run.timedOut;
+  const timedOutStr = timedOut ? " timedout=true" : "";
+  const sentinel = `<!-- nightralph:entry ticket=${encodedKey} attempt=${input.attempt} outcome=${input.outcome}${timedOutStr} -->`;
+  const timestamp = formatDate(input.now);
+  const attemptStr = input.outcome === "merge" ? "" : ` attempt ${input.attempt}`;
+  let description;
+  switch (input.outcome) {
+    case "done":
+      description = "done";
+      break;
+    case "exit":
+      description = `failed (exit ${input.run.exitCode})`;
+      break;
+    case "tests":
+      description = "failed (tests)";
+      break;
+    case "install":
+      description = "failed (install)";
+      break;
+    case "no-commits":
+      description = "no commits";
+      break;
+    case "error":
+      description = "error";
+      break;
+    case "merge":
+      description = "merge failed";
+      break;
+    default: {
+      const _exhaustive = input;
+      description = _exhaustive;
+    }
+  }
+  const timedOutPrefix = timedOut ? "timed out, then " : "";
+  const heading = `## ${timestamp} -- ${input.label}${attemptStr} -- ${timedOutPrefix}${description}`;
+  let body;
+  switch (input.outcome) {
+    case "done":
+    case "exit":
+    case "no-commits": {
+      const run = input.run;
+      const summary = renderAgentSummary(run, input.effort);
+      const notesSection = renderNotesSection(run.notes);
+      body = summary + "\n\n" + notesSection;
+      break;
+    }
+    case "tests": {
+      const logTail = sanitize(input.logTail);
+      const fenced = fence(logTail);
+      const summary = renderAgentSummary(
+        input.run,
+        input.effort
+      );
+      const notesSection = renderNotesSection(input.run.notes);
+      const lastNLines = `Last ${LOG_TAIL_LINES} lines of \`${sanitize(input.logName)}\`:`;
+      body = summary + `
+
+Test gate failed.
+${lastNLines}
+${fenced}
+
+` + notesSection;
+      break;
+    }
+    case "install": {
+      const logTail = sanitize(input.logTail);
+      const fenced = fence(logTail);
+      const lastNLines = `Last ${LOG_TAIL_LINES} lines of \`${sanitize(input.logName)}\`:`;
+      body = `Install failed.
+${lastNLines}
+` + fenced;
+      break;
+    }
+    case "error": {
+      const errorText = sanitize(input.error);
+      const fenced = fence(errorText);
+      body = fenced;
+      break;
+    }
+    case "merge": {
+      const stderrText = sanitize(input.stderr);
+      const fenced = fence(stderrText);
+      body = `Merge failed.
+${fenced}`;
+      break;
+    }
+    default: {
+      const unknown = input;
+      throw new Error(`Unknown outcome: ${JSON.stringify(unknown)}`);
+    }
+  }
+  return `${sentinel}
+${heading}
+
+${body}
+
+---
+`;
+}
+__name(renderEntry, "renderEntry");
+function parseEntries(text) {
+  const lines = text.split("\n").map((line) => {
+    return line.endsWith("\r") ? line.slice(0, -1) : line;
+  });
+  const entries = [];
+  let currentSentinel = null;
+  let currentBody = [];
+  const sentinelRegex = /^<!-- nightralph:entry (.*) -->$/;
+  for (const line of lines) {
+    const match = line.match(sentinelRegex);
+    if (match) {
+      if (currentSentinel !== null) {
+        const entry = parseSentinel(currentSentinel, currentBody);
+        if (entry) {
+          entries.push(entry);
+        }
+      }
+      currentSentinel = match[1];
+      currentBody = [];
+    } else if (currentSentinel !== null) {
+      currentBody.push(line);
+    }
+  }
+  if (currentSentinel !== null) {
+    const entry = parseSentinel(currentSentinel, currentBody);
+    if (entry) {
+      entries.push(entry);
+    }
+  }
+  return entries;
+}
+__name(parseEntries, "parseEntries");
+function parseSentinel(sentinel, bodyLines) {
+  const parts = sentinel.split(/\s+/).filter(Boolean);
+  const attrs = {};
+  for (const part of parts) {
+    const idx = part.indexOf("=");
+    if (idx > 0) {
+      const key2 = part.slice(0, idx);
+      const value = part.slice(idx + 1);
+      if (value) {
+        attrs[key2] = value;
+      }
+    }
+  }
+  let key = attrs.ticket;
+  if (!key) return null;
+  try {
+    key = decodeURIComponent(key);
+  } catch (_e) {
+    return null;
+  }
+  if (!key.trim()) return null;
+  const attemptStr = attrs.attempt;
+  if (!attemptStr) return null;
+  if (!/^\d+$/.test(attemptStr)) return null;
+  const attempt = Number(attemptStr);
+  const outcome = attrs.outcome;
+  if (!outcome || !isLearningOutcome(outcome)) return null;
+  const timedOut = attrs.timedout === "true";
+  let body = bodyLines.join("\n").trim();
+  const lines = body.split("\n");
+  if (lines.length > 0 && lines[lines.length - 1] === "---") {
+    body = lines.slice(0, -1).join("\n").trim();
+  }
+  return {
+    key,
+    attempt,
+    outcome,
+    timedOut,
+    body
+  };
+}
+__name(parseSentinel, "parseSentinel");
+function selectHistory(entries, opts) {
+  const own = entries.filter((e) => e.key === opts.key).slice(-MAX_OWN_ENTRIES);
+  const blockers = opts.blockerKeys.flatMap((k) => {
+    const done = entries.filter((e) => {
+      return e.key === k && e.outcome === "done";
+    });
+    const last = done[done.length - 1];
+    return last ? [last] : [];
+  });
+  return { own, blockers };
+}
+__name(selectHistory, "selectHistory");
+function renderHistory(selection) {
+  if (selection.own.length === 0 && selection.blockers.length === 0) {
+    return "";
+  }
+  const framing = "These are records of earlier runs. The ticket or spec may have changed since then; where they disagree, follow the ticket and spec. Do not repeat an approach these notes say failed unless you can see why it failed.";
+  const parts = [framing, ""];
+  if (selection.own.length > 0) {
+    parts.push("---- PREVIOUS ATTEMPTS AT THIS TICKET ----");
+    parts.push(selection.own.map((e) => capEntry(e)).join("\n\n"));
+    parts.push("");
+  }
+  if (selection.blockers.length > 0) {
+    parts.push("---- WHAT THE BLOCKING TICKETS DID ----");
+    parts.push(selection.blockers.map((e) => capEntry(e)).join("\n\n"));
+  }
+  return parts.join("\n");
+}
+__name(renderHistory, "renderHistory");
+function capEntry(entry) {
+  if (entry.body.length <= MAX_ENTRY_CHARS) {
+    return entry.body;
+  }
+  return entry.body.slice(0, MAX_ENTRY_CHARS) + "\n" + TRUNCATED_MARKER;
+}
+__name(capEntry, "capEntry");
+function tailLines(text, n) {
+  let lines = text.split("\n");
+  if (lines.length > 0 && lines[lines.length - 1] === "") {
+    lines = lines.slice(0, -1);
+  }
+  if (lines.length > n) {
+    lines = lines.slice(-n);
+  }
+  return lines.join("\n");
+}
+__name(tailLines, "tailLines");
+function learningsPathFor(progressPath) {
+  return join(dirname(progressPath), "learnings.md");
+}
+__name(learningsPathFor, "learningsPathFor");
+function readEntries(path) {
+  if (!existsSync(path)) return [];
+  return parseEntries(readFileSync(path, "utf8"));
+}
+__name(readEntries, "readEntries");
+function appendEntry(path, text) {
+  mkdirSync(dirname(path), { recursive: true });
+  appendFileSync(path, text);
+}
+__name(appendEntry, "appendEntry");
+function collectNotes(worktreePath, file = basename(NOTES_PATH)) {
+  const dir = join(worktreePath, dirname(NOTES_PATH));
+  const path = join(dir, file);
+  const text = existsSync(path) ? readFileSync(path, "utf8").trim() : "";
+  rmSync(dir, { recursive: true, force: true });
+  return text || null;
+}
+__name(collectNotes, "collectNotes");
+function ensureNotesIgnored(worktreePath) {
+  const dir = join(worktreePath, dirname(NOTES_PATH));
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, ".gitignore"), "*\n");
+}
+__name(ensureNotesIgnored, "ensureNotesIgnored");
+export {
+  LEARNING_OUTCOMES,
+  LOG_TAIL_LINES,
+  MAX_ENTRY_CHARS,
+  MAX_OWN_ENTRIES,
+  NOTES_PATH,
+  TRUNCATED_MARKER,
+  appendEntry,
+  collectNotes,
+  ensureNotesIgnored,
+  formatDate,
+  isLearningOutcome,
+  learningsPathFor,
+  parseEntries,
+  readEntries,
+  renderEntry,
+  renderHistory,
+  selectHistory,
+  tailLines
+};
+//# sourceMappingURL=learnings.js.map

package/dist/learnings.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/learnings.ts"],
+  "sourcesContent": ["import {\n    appendFileSync,\n    existsSync,\n    mkdirSync,\n    readFileSync,\n    rmSync,\n    writeFileSync,\n} from 'node:fs'\nimport { basename, dirname, join } from 'node:path'\n\n// -- Constants and types --\n\nexport const MAX_OWN_ENTRIES = 4\nexport const MAX_ENTRY_CHARS = 4000\nexport const LOG_TAIL_LINES = 40\nexport const NOTES_PATH = '.nightralph/notes.md'\n\nconst SENTINEL_PREFIX = '<!-- nightralph:entry'\nexport const TRUNCATED_MARKER = '[truncated]'\n\nexport const LEARNING_OUTCOMES = [\n    'done',\n    'exit',\n    'tests',\n    'install',\n    'no-commits',\n    'error',\n    'merge',\n] as const\nexport type LearningOutcome = typeof LEARNING_OUTCOMES[number]\n\nexport type LearningEntry = {\n    key:string\n    attempt:number\n    outcome:LearningOutcome\n    timedOut:boolean\n    // Everything after the sentinel line, trimmed, without\n    // the trailing `---` separator\n    body:string\n}\n\ntype EntryBase = {\n    key:string  // ticketKey(feature, num)\n    label:string  // ticketLabel(ticket), e.g. \"my-feature/04\"\n    attempt:number  // 0 for merge entries\n    now:Date\n}\n\n// What one agent process did: its exit code, the items it reported,\n// whether it was killed at the timeout, and the notes it left.\nexport type AgentRunRecord = {\n    exitCode:number\n    completedItems:string[]\n    timedOut:boolean\n    notes:string|null\n}\n\ntype AgentFields = { run:AgentRunRecord; effort?:string }\n\ntype LogTail = { logName:string; logTail:string }\n\nexport type EntryInput = EntryBase&(\n    | (AgentFields&{ outcome:'done'|'exit'|'no-commits' })\n    | (AgentFields&LogTail&{ outcome:'tests' })\n    | (LogTail&{ outcome:'install' })\n    | { outcome:'error'; error:string }\n    | { outcome:'merge'; stderr:string }\n)\n\nexport type HistorySelection = {\n    own:LearningEntry[]\n    blockers:LearningEntry[]\n}\n\n// -- Helpers --\n\nfunction encodeKey (key:string):string {\n    return key\n        .replace(/%/g, '%25')\n        .replace(/\\s/g, c => encodeURIComponent(c))\n}\n\nfunction fence (content:string):string {\n    const longest = Math.max(\n        0,\n        ...[...content.matchAll(/`+/g)].map(m => m[0].length)\n    )\n    const ticks = '`'.repeat(Math.max(3, longest + 1))\n    return `${ticks}\\n${content}\\n${ticks}`\n}\n\nfunction sanitize (text:string|null):string {\n    if (!text) return ''\n    return text.replace(\n        new RegExp(SENTINEL_PREFIX, 'g'),\n        '<!-- nightralph-entry'\n    )\n}\n\nfunction renderAgentSummary (\n    run:AgentRunRecord,\n    effort?:string\n):string {\n    const effortLine = effort ?\n        `Effort: ${effort}.` :\n        ''\n\n    const exitLine = `Agent exit: ${run.exitCode}.`\n\n    const itemsText = run.completedItems.length > 0 ?\n        run.completedItems.map(item =>\n            `\"${sanitize(item)}\"`\n        ).join(', ') + '.' :\n        'none.'\n\n    const itemsLine = `Checked items: ${itemsText}`\n\n    return [\n        effortLine,\n        exitLine,\n        itemsLine,\n    ].filter(Boolean).join(' ')\n}\n\nfunction renderNotesSection (notes:string|null):string {\n    const notesSanitized = sanitize(notes)\n    return notesSanitized.trim() ?\n        `### Agent notes\\n${notesSanitized}` :\n        'The agent left no notes.'\n}\n\nexport function formatDate (date:Date):string {\n    const year = date.getFullYear()\n    const month = String(date.getMonth() + 1).padStart(2, '0')\n    const day = String(date.getDate()).padStart(2, '0')\n    const hours = String(date.getHours()).padStart(2, '0')\n    const minutes = String(date.getMinutes()).padStart(2, '0')\n    return `${year}-${month}-${day} ${hours}:${minutes}`\n}\n\nexport function isLearningOutcome (\n    value:string\n):value is LearningOutcome {\n    return LEARNING_OUTCOMES.some(o => o === value)\n}\n\nexport function renderEntry (input:EntryInput):string {\n    const encodedKey = encodeKey(input.key)\n\n    const hasRun = 'run' in input\n    const timedOut = hasRun && input.run.timedOut\n\n    const timedOutStr = timedOut ?\n        ' timedout=true' :\n        ''\n\n    const sentinel =\n        `<!-- nightralph:entry ticket=${encodedKey} ` +\n        `attempt=${input.attempt} outcome=${input.outcome}` +\n        `${timedOutStr} -->`\n\n    const timestamp = formatDate(input.now)\n    const attemptStr = input.outcome === 'merge' ?\n        '' :\n        ` attempt ${input.attempt}`\n\n    let description:string\n\n    switch (input.outcome) {\n        case 'done':\n            description = 'done'\n            break\n        case 'exit':\n            description = `failed (exit ${input.run.exitCode})`\n            break\n        case 'tests':\n            description = 'failed (tests)'\n            break\n        case 'install':\n            description = 'failed (install)'\n            break\n        case 'no-commits':\n            description = 'no commits'\n            break\n        case 'error':\n            description = 'error'\n            break\n        case 'merge':\n            description = 'merge failed'\n            break\n        default: {\n            const _exhaustive:never = input\n            description = _exhaustive\n        }\n    }\n\n    const timedOutPrefix = timedOut ?\n        'timed out, then ' :\n        ''\n\n    const heading =\n        `## ${timestamp} -- ${input.label}${attemptStr} -- ` +\n        `${timedOutPrefix}${description}`\n\n    let body:string\n\n    switch (input.outcome) {\n        case 'done':\n        case 'exit':\n        case 'no-commits': {\n            const run = input.run\n            const summary = renderAgentSummary(run, input.effort)\n            const notesSection = renderNotesSection(run.notes)\n            body = summary + '\\n\\n' + notesSection\n            break\n        }\n        case 'tests': {\n            const logTail = sanitize(input.logTail)\n            const fenced = fence(logTail)\n            const summary = renderAgentSummary(\n                input.run,\n                input.effort\n            )\n            const notesSection = renderNotesSection(input.run.notes)\n\n            const lastNLines =\n                `Last ${LOG_TAIL_LINES} lines of ` +\n                `\\`${sanitize(input.logName)}\\`:`\n\n            body =\n                summary + '\\n\\n' +\n                'Test gate failed.\\n' +\n                `${lastNLines}\\n` +\n                `${fenced}\\n\\n` +\n                notesSection\n            break\n        }\n        case 'install': {\n            const logTail = sanitize(input.logTail)\n            const fenced = fence(logTail)\n\n            const lastNLines =\n                `Last ${LOG_TAIL_LINES} lines of ` +\n                `\\`${sanitize(input.logName)}\\`:`\n\n            body =\n                'Install failed.\\n' +\n                `${lastNLines}\\n` +\n                fenced\n            break\n        }\n        case 'error': {\n            const errorText = sanitize(input.error)\n            const fenced = fence(errorText)\n            body = fenced\n            break\n        }\n        case 'merge': {\n            const stderrText = sanitize(input.stderr)\n            const fenced = fence(stderrText)\n            body = `Merge failed.\\n${fenced}`\n            break\n        }\n        default: {\n            const unknown:never = input\n            throw new Error(`Unknown outcome: ${JSON.stringify(unknown)}`)\n        }\n    }\n\n    return `${sentinel}\\n${heading}\\n\\n${body}\\n\\n---\\n`\n}\n\nexport function parseEntries (text:string):LearningEntry[] {\n    const lines = text.split('\\n').map(line => {\n        // Strip trailing \\r for CRLF support\n        return line.endsWith('\\r') ? line.slice(0, -1) : line\n    })\n    const entries:LearningEntry[] = []\n\n    let currentSentinel:string|null = null\n    let currentBody:string[] = []\n\n    const sentinelRegex = /^<!-- nightralph:entry (.*) -->$/\n\n    for (const line of lines) {\n        const match = line.match(sentinelRegex)\n\n        if (match) {\n            // Process previous entry if exists\n            if (currentSentinel !== null) {\n                const entry = parseSentinel(currentSentinel, currentBody)\n                if (entry) {\n                    entries.push(entry)\n                }\n            }\n\n            currentSentinel = match[1]\n            currentBody = []\n        } else if (currentSentinel !== null) {\n            currentBody.push(line)\n        }\n    }\n\n    // Process last entry\n    if (currentSentinel !== null) {\n        const entry = parseSentinel(currentSentinel, currentBody)\n        if (entry) {\n            entries.push(entry)\n        }\n    }\n\n    return entries\n}\n\nfunction parseSentinel (\n    sentinel:string,\n    bodyLines:string[]\n):LearningEntry|null {\n    const parts = sentinel.split(/\\s+/).filter(Boolean)\n    const attrs:Record<string, string> = {}\n\n    for (const part of parts) {\n        const idx = part.indexOf('=')\n        if (idx > 0) {\n            const key = part.slice(0, idx)\n            const value = part.slice(idx + 1)\n            if (value) {\n                attrs[key] = value\n            }\n        }\n    }\n\n    // Validate ticket\n    let key = attrs.ticket\n    if (!key) return null\n\n    try {\n        key = decodeURIComponent(key)\n    } catch (_e) {\n        return null\n    }\n\n    if (!key.trim()) return null\n\n    // Validate attempt\n    const attemptStr = attrs.attempt\n    if (!attemptStr) return null\n\n    if (!/^\\d+$/.test(attemptStr)) return null\n    const attempt = Number(attemptStr)\n\n    // Validate outcome\n    const outcome = attrs.outcome\n    if (!outcome || !isLearningOutcome(outcome)) return null\n\n    // Parse timedOut\n    const timedOut = attrs.timedout === 'true'\n\n    // Parse body\n    let body = bodyLines.join('\\n').trim()\n\n    // Remove trailing --- line (full line only)\n    const lines = body.split('\\n')\n    if (lines.length > 0 && lines[lines.length - 1] === '---') {\n        body = lines.slice(0, -1).join('\\n').trim()\n    }\n\n    return {\n        key,\n        attempt,\n        outcome,\n        timedOut,\n        body,\n    }\n}\n\nexport function selectHistory (\n    entries:LearningEntry[],\n    opts:{ key:string; blockerKeys:string[] }\n):HistorySelection {\n    const own = entries\n        .filter(e => e.key === opts.key)\n        .slice(-MAX_OWN_ENTRIES)\n\n    const blockers = opts.blockerKeys.flatMap(k => {\n        const done = entries.filter(e => {\n            return e.key === k && e.outcome === 'done'\n        })\n        const last = done[done.length - 1]\n        return last ? [last] : []\n    })\n\n    return { own, blockers }\n}\n\nexport function renderHistory (selection:HistorySelection):string {\n    if (selection.own.length === 0 && selection.blockers.length === 0) {\n        return ''\n    }\n\n    const framing =\n        'These are records of earlier runs. The ticket or spec may ' +\n        'have changed since then; where they disagree, follow the ' +\n        'ticket and spec. Do not repeat an approach these notes say ' +\n        'failed unless you can see why it failed.'\n\n    const parts = [framing, '']\n\n    if (selection.own.length > 0) {\n        parts.push('---- PREVIOUS ATTEMPTS AT THIS TICKET ----')\n        parts.push(selection.own.map(e => capEntry(e)).join('\\n\\n'))\n        parts.push('')\n    }\n\n    if (selection.blockers.length > 0) {\n        parts.push('---- WHAT THE BLOCKING TICKETS DID ----')\n        parts.push(selection.blockers.map(e => capEntry(e)).join('\\n\\n'))\n    }\n\n    return parts.join('\\n')\n}\n\nfunction capEntry (entry:LearningEntry):string {\n    if (entry.body.length <= MAX_ENTRY_CHARS) {\n        return entry.body\n    }\n\n    return entry.body.slice(0, MAX_ENTRY_CHARS) + '\\n' + TRUNCATED_MARKER\n}\n\nexport function tailLines (text:string, n:number):string {\n    let lines = text.split('\\n')\n\n    // Remove empty string at end if text ended with newline\n    if (lines.length > 0 && lines[lines.length - 1] === '') {\n        lines = lines.slice(0, -1)\n    }\n\n    // Keep last n\n    if (lines.length > n) {\n        lines = lines.slice(-n)\n    }\n\n    return lines.join('\\n')\n}\n\nexport function learningsPathFor (progressPath:string):string {\n    return join(dirname(progressPath), 'learnings.md')\n}\n\n// -- IO functions --\n\n// A missing log means no history yet. Any other read error (e.g.\n// the path is a directory) is thrown for the caller to report.\nexport function readEntries (path:string):LearningEntry[] {\n    if (!existsSync(path)) return []\n    return parseEntries(readFileSync(path, 'utf8'))\n}\n\n// Synchronous on purpose: tickets in a wave run concurrently in one\n// Node thread, so sync appends can never interleave.\nexport function appendEntry (path:string, text:string):void {\n    mkdirSync(dirname(path), { recursive:true })\n    appendFileSync(path, text)\n}\n\n// Reads one file from the worktree's notes directory (the notes\n// by default), then removes the whole directory (also when the\n// file is missing), so nothing in it can reach a commit. Blank\n// text counts as none.\nexport function collectNotes (\n    worktreePath:string,\n    file:string = basename(NOTES_PATH)\n):string|null {\n    const dir = join(worktreePath, dirname(NOTES_PATH))\n    const path = join(dir, file)\n    const text = existsSync(path) ?\n        readFileSync(path, 'utf8').trim() :\n        ''\n    rmSync(dir, { recursive:true, force:true })\n    return text || null\n}\n\n// Makes the notes directory ignore itself, so an agent's\n// `git add -A` cannot stage its notes. Deliberately not\n// info/exclude: that file can be a symlink shared by every repo on\n// the machine (e.g. via init.templateDir).\nexport function ensureNotesIgnored (worktreePath:string):void {\n    const dir = join(worktreePath, dirname(NOTES_PATH))\n    mkdirSync(dir, { recursive:true })\n    writeFileSync(join(dir, '.gitignore'), '*\\n')\n}\n"],
+  "mappings": "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",
+  "names": ["key"]
+}