@theglitchking/semantic-memory 1.2.2 → 1.5.1

package/dist/chunk-WSU4QIPB.js

@@ -0,0 +1,311 @@
+import {
+  deriveSessionDir
+} from "./chunk-S4KW7VH4.js";
+
+// src/core/dossier.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+import { join } from "path";
+import { glob } from "glob";
+import matter from "gray-matter";
+
+// src/core/section.ts
+function extractSection(markdown, heading) {
+  const target = heading.trim().toLowerCase();
+  const lines = markdown.split("\n");
+  let startIdx = -1;
+  let startLevel = 0;
+  const headingAt = (line) => {
+    const m = /^(#{1,6})\s+(.*?)\s*$/.exec(line);
+    return m ? { level: m[1].length, text: m[2].trim().toLowerCase() } : null;
+  };
+  for (let i = 0; i < lines.length; i++) {
+    const h = headingAt(lines[i]);
+    if (h && h.text === target) {
+      startIdx = i;
+      startLevel = h.level;
+      break;
+    }
+  }
+  if (startIdx === -1) return null;
+  let endIdx = lines.length;
+  for (let i = startIdx + 1; i < lines.length; i++) {
+    const h = headingAt(lines[i]);
+    if (h && h.level <= startLevel) {
+      endIdx = i;
+      break;
+    }
+  }
+  return lines.slice(startIdx, endIdx).join("\n").trimEnd();
+}
+
+// src/core/dossier.ts
+var DOSSIER_DIR = "dossiers";
+var CACHE_FILE = "dossier-cache.json";
+var DOSSIER_SECTIONS = [
+  "Purpose",
+  "Failure modes",
+  "Knobs & commands",
+  "Incident log",
+  "Current state"
+];
+function slugifyEntity(entity) {
+  return entity.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60) || "entity";
+}
+function normalizeEntity(s) {
+  return s.toLowerCase().trim().replace(/\s+/g, " ");
+}
+function sectionBody(markdown, heading) {
+  const section = extractSection(markdown, heading);
+  if (!section) return "";
+  return section.split("\n").slice(1).join("\n").trim();
+}
+function firstParagraph(body) {
+  const para = body.split(/\n\s*\n/).map((p) => p.trim()).find(Boolean);
+  return para ?? "";
+}
+function dossierTemplate(entity, opts = {}) {
+  const purpose = opts.purpose?.trim() || `_What ${entity} is and why it exists._`;
+  const seedNote = opts.seeded_from ? `
+<!-- seeded from ${opts.seeded_from} -->
+` : "";
+  return `# ${entity}
+${seedNote}
+## Purpose
+
+${purpose}
+
+## Failure modes
+
+_How it breaks, and the tell-tale symptoms._
+
+## Knobs & commands
+
+_The buttons to push: commands, config, flags, dashboards._
+
+## Incident log
+
+_Dated entries append here (newest last). Each: what happened \u2192 cause \u2192 fix._
+
+## Current state
+
+_The single freshest sentence about where this entity stands right now._
+`;
+}
+async function listDossiers(vaultPath) {
+  const files = await glob(`${DOSSIER_DIR}/**/*.md`, { cwd: vaultPath });
+  const entries = [];
+  for (const rel of files) {
+    try {
+      const raw = await readFile(join(vaultPath, rel), "utf-8");
+      const { data, content } = matter(raw);
+      if (data.type !== "dossier") continue;
+      const entity = typeof data.entity === "string" && data.entity.trim() ? data.entity.trim() : rel.replace(/^dossiers\//, "").replace(/\.md$/, "");
+      const aliases = Array.isArray(data.aliases) ? data.aliases.map(String).map((a) => a.trim()).filter(Boolean) : [];
+      entries.push({
+        entity,
+        aliases,
+        path: rel,
+        purpose: firstParagraph(sectionBody(content, "Purpose")),
+        current_state: sectionBody(content, "Current state")
+      });
+    } catch {
+    }
+  }
+  return entries.sort((a, b) => a.entity.localeCompare(b.entity));
+}
+async function compileDossiers(vaultPath) {
+  const entries = await listDossiers(vaultPath);
+  try {
+    const dir = deriveSessionDir(vaultPath);
+    await mkdir(dir, { recursive: true });
+    await writeFile(
+      join(dir, CACHE_FILE),
+      JSON.stringify({ compiledAt: (/* @__PURE__ */ new Date()).toISOString(), dossiers: entries }, null, 2),
+      "utf-8"
+    );
+  } catch {
+  }
+  return entries;
+}
+async function loadDossierCache(vaultPath) {
+  const cachePath = join(deriveSessionDir(vaultPath), CACHE_FILE);
+  if (existsSync(cachePath)) {
+    try {
+      const data = JSON.parse(await readFile(cachePath, "utf-8"));
+      if (Array.isArray(data?.dossiers)) return data.dossiers;
+    } catch {
+    }
+  }
+  return compileDossiers(vaultPath);
+}
+function findDossier(entries, entityOrAlias) {
+  const n = normalizeEntity(entityOrAlias);
+  return entries.find(
+    (d) => normalizeEntity(d.entity) === n || d.aliases.some((a) => normalizeEntity(a) === n)
+  );
+}
+function resolveDossierForQuery(entries, query) {
+  const nq = normalizeEntity(query);
+  let best;
+  for (const d of entries) {
+    const keys = [d.entity, ...d.aliases].map(normalizeEntity).filter(Boolean);
+    for (const k of keys) {
+      if (nq.includes(k) && (!best || k.length > best.keyLen)) {
+        best = { entry: d, keyLen: k.length };
+      }
+    }
+  }
+  return best?.entry;
+}
+async function readDossierRaw(vaultPath, rel) {
+  const abs = join(vaultPath, rel);
+  if (!existsSync(abs)) return null;
+  try {
+    const raw = await readFile(abs, "utf-8");
+    const { data } = matter(raw);
+    if (data.type !== "dossier") return null;
+    const entity = typeof data.entity === "string" ? data.entity : rel;
+    return { raw, entity };
+  } catch {
+    return null;
+  }
+}
+async function resolveDossierPath(vaultPath, entityOrPath) {
+  if (entityOrPath.endsWith(".md") && existsSync(join(vaultPath, entityOrPath))) return entityOrPath;
+  const entries = await listDossiers(vaultPath);
+  const match = findDossier(entries, entityOrPath);
+  if (match) return match.path;
+  return null;
+}
+async function initDossier(vaultPath, entity, opts = {}) {
+  const existing = await listDossiers(vaultPath);
+  const already = findDossier(existing, entity);
+  if (already) return { path: already.path, created: false, entity: already.entity };
+  const rel = join(DOSSIER_DIR, `${slugifyEntity(entity)}.md`);
+  const abs = join(vaultPath, rel);
+  if (existsSync(abs)) return { path: rel, created: false, entity };
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const fm = {
+    title: entity,
+    type: "dossier",
+    entity,
+    status: "active",
+    last_verified: today,
+    confidence: "medium",
+    ...opts.aliases && opts.aliases.length > 0 ? { aliases: opts.aliases } : {},
+    ...opts.seeded_from ? { sources: [opts.seeded_from] } : {}
+  };
+  const body = dossierTemplate(entity, { purpose: opts.purpose, seeded_from: opts.seeded_from });
+  await mkdir(join(vaultPath, DOSSIER_DIR), { recursive: true });
+  await writeFile(abs, matter.stringify(body, fm), "utf-8");
+  await compileDossiers(vaultPath);
+  return { path: rel, created: true, entity };
+}
+async function appendIncident(vaultPath, entityOrPath, incident, opts = {}) {
+  const rel = await resolveDossierPath(vaultPath, entityOrPath);
+  if (!rel) return null;
+  const doc = await readDossierRaw(vaultPath, rel);
+  if (!doc) return null;
+  const today = opts.today ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const line = `- ${today} \u2014 ${incident.trim()}`;
+  const patched = appendToSection(doc.raw, "Incident log", line);
+  await writeFile(join(vaultPath, rel), patched, "utf-8");
+  await compileDossiers(vaultPath);
+  return { path: rel };
+}
+async function setCurrentState(vaultPath, entityOrPath, state) {
+  const rel = await resolveDossierPath(vaultPath, entityOrPath);
+  if (!rel) return null;
+  const doc = await readDossierRaw(vaultPath, rel);
+  if (!doc) return null;
+  const patched = replaceSectionBody(doc.raw, "Current state", state.trim());
+  await writeFile(join(vaultPath, rel), patched, "utf-8");
+  await compileDossiers(vaultPath);
+  return { path: rel };
+}
+function locateSection(markdown, heading) {
+  const lines = markdown.split("\n");
+  const want = heading.trim().toLowerCase();
+  let start = -1;
+  let level = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const m = lines[i].match(/^(#{1,6})\s+(.*?)\s*$/);
+    if (m && m[2].trim().toLowerCase() === want) {
+      start = i;
+      level = m[1].length;
+      break;
+    }
+  }
+  if (start === -1) return null;
+  let end = lines.length;
+  for (let i = start + 1; i < lines.length; i++) {
+    const m = lines[i].match(/^(#{1,6})\s+/);
+    if (m && m[1].length <= level) {
+      end = i;
+      break;
+    }
+  }
+  return { start, level, end, lines };
+}
+function isPlaceholderBody(body) {
+  const t = body.trim();
+  return t === "" || /^_.*_$/.test(t) && !t.includes("\n");
+}
+function appendToSection(markdown, heading, line) {
+  const loc = locateSection(markdown, heading);
+  if (!loc) {
+    const sep = markdown.endsWith("\n") ? "" : "\n";
+    return `${markdown}${sep}
+## ${heading}
+
+${line}
+`;
+  }
+  const { lines, start, end } = loc;
+  const body = lines.slice(start + 1, end).join("\n");
+  const bodyStripped = body.trim();
+  const replacePlaceholder = isPlaceholderBody(bodyStripped);
+  let insertAt = end;
+  while (insertAt - 1 > start && lines[insertAt - 1].trim() === "") insertAt--;
+  const before = lines.slice(0, replacePlaceholder ? start + 1 : insertAt);
+  const after = lines.slice(replacePlaceholder ? end : insertAt);
+  const injected = replacePlaceholder ? ["", line] : [line];
+  return [...before, ...injected, ...after].join("\n");
+}
+function replaceSectionBody(markdown, heading, newBody) {
+  const loc = locateSection(markdown, heading);
+  if (!loc) {
+    const sep = markdown.endsWith("\n") ? "" : "\n";
+    return `${markdown}${sep}
+## ${heading}
+
+${newBody}
+`;
+  }
+  const { lines, start, end } = loc;
+  const before = lines.slice(0, start + 1);
+  const after = lines.slice(end);
+  return [...before, "", newBody, "", ...after].join("\n").replace(/\n{3,}/g, "\n\n");
+}
+
+export {
+  extractSection,
+  DOSSIER_DIR,
+  DOSSIER_SECTIONS,
+  slugifyEntity,
+  normalizeEntity,
+  dossierTemplate,
+  listDossiers,
+  compileDossiers,
+  loadDossierCache,
+  findDossier,
+  resolveDossierForQuery,
+  resolveDossierPath,
+  initDossier,
+  appendIncident,
+  setCurrentState,
+  appendToSection,
+  replaceSectionBody
+};
+//# sourceMappingURL=chunk-WSU4QIPB.js.map

package/dist/chunk-WSU4QIPB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/dossier.ts","../src/core/section.ts"],"sourcesContent":["import { readFile, writeFile, mkdir } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { glob } from \"glob\";\nimport matter from \"gray-matter\";\nimport { deriveSessionDir } from \"./session.js\";\nimport { extractSection } from \"./section.js\";\n\n/**\n * Entity dossiers (v1.5 Phase 8) — the organizing unit of the resident expert.\n *\n * A dossier is a living note about one critical component/entity: what it is, how\n * it fails, which knobs to turn, its incident history, and its current state.\n * Knowledge accretes IN PLACE (incidents append to a log section; current-state is\n * revised) instead of spawning a new note per event — so the entity, not the file,\n * is the memory's unit. Canonical storage is markdown under <vault>/dossiers/\n * (type `dossier`); a derived JSON cache under .claude/.semantic-memory/ lets the\n * hot-path hook resolve an utterance to a dossier head for two-hop retrieval.\n */\n\nexport const DOSSIER_DIR = \"dossiers\";\nconst CACHE_FILE = \"dossier-cache.json\";\n\n/** The fixed section skeleton every dossier carries (order is meaningful). */\nexport const DOSSIER_SECTIONS = [\n  \"Purpose\",\n  \"Failure modes\",\n  \"Knobs & commands\",\n  \"Incident log\",\n  \"Current state\",\n] as const;\n\nexport type DossierSection = (typeof DOSSIER_SECTIONS)[number];\n\nexport interface DossierEntry {\n  /** The canonical entity name (e.g. \"payment-gateway\"). */\n  entity: string;\n  /** The human's phrases for this entity (feed the lexicon compiler). */\n  aliases: string[];\n  /** Dossier note path relative to vault root. */\n  path: string;\n  /** First paragraph of the Purpose section — the head injected on two-hop. */\n  purpose: string;\n  /** The Current state section body — the freshest one-liner about the entity. */\n  current_state: string;\n}\n\nexport function slugifyEntity(entity: string): string {\n  return (\n    entity\n      .toLowerCase()\n      .replace(/[^a-z0-9]+/g, \"-\")\n      .replace(/^-+|-+$/g, \"\")\n      .slice(0, 60) || \"entity\"\n  );\n}\n\nexport function normalizeEntity(s: string): string {\n  return s.toLowerCase().trim().replace(/\\s+/g, \" \");\n}\n\n/** Body-only text of a section (heading + leading/trailing blank lines stripped). */\nfunction sectionBody(markdown: string, heading: string): string {\n  const section = extractSection(markdown, heading);\n  if (!section) return \"\";\n  // Drop the heading line, collapse to a trimmed body.\n  return section\n    .split(\"\\n\")\n    .slice(1)\n    .join(\"\\n\")\n    .trim();\n}\n\n/** First non-empty paragraph of a section body (the \"head\" for injection). */\nfunction firstParagraph(body: string): string {\n  const para = body.split(/\\n\\s*\\n/).map((p) => p.trim()).find(Boolean);\n  return para ?? \"\";\n}\n\n/**\n * The dossier template — the fixed skeleton `dossier init` scaffolds and every\n * section edit patches into. Placeholders are intentionally terse prompts, not\n * prose, so an empty dossier is cheap to read and obvious to fill.\n */\nexport function dossierTemplate(entity: string, opts: { purpose?: string; seeded_from?: string } = {}): string {\n  const purpose = opts.purpose?.trim() || `_What ${entity} is and why it exists._`;\n  const seedNote = opts.seeded_from ? `\\n<!-- seeded from ${opts.seeded_from} -->\\n` : \"\";\n  return `# ${entity}\n${seedNote}\n## Purpose\n\n${purpose}\n\n## Failure modes\n\n_How it breaks, and the tell-tale symptoms._\n\n## Knobs & commands\n\n_The buttons to push: commands, config, flags, dashboards._\n\n## Incident log\n\n_Dated entries append here (newest last). Each: what happened → cause → fix._\n\n## Current state\n\n_The single freshest sentence about where this entity stands right now._\n`;\n}\n\n/** Read every dossier note into an entry (best-effort; skips unreadable files). */\nexport async function listDossiers(vaultPath: string): Promise<DossierEntry[]> {\n  const files = await glob(`${DOSSIER_DIR}/**/*.md`, { cwd: vaultPath });\n  const entries: DossierEntry[] = [];\n  for (const rel of files) {\n    try {\n      const raw = await readFile(join(vaultPath, rel), \"utf-8\");\n      const { data, content } = matter(raw);\n      if (data.type !== \"dossier\") continue;\n      const entity = typeof data.entity === \"string\" && data.entity.trim() ? data.entity.trim() : rel.replace(/^dossiers\\//, \"\").replace(/\\.md$/, \"\");\n      const aliases = Array.isArray(data.aliases) ? data.aliases.map(String).map((a) => a.trim()).filter(Boolean) : [];\n      entries.push({\n        entity,\n        aliases,\n        path: rel,\n        purpose: firstParagraph(sectionBody(content, \"Purpose\")),\n        current_state: sectionBody(content, \"Current state\"),\n      });\n    } catch {\n      /* skip unreadable dossier */\n    }\n  }\n  return entries.sort((a, b) => a.entity.localeCompare(b.entity));\n}\n\n/** Compile all dossiers into the derived cache the hook reads for two-hop routing. */\nexport async function compileDossiers(vaultPath: string): Promise<DossierEntry[]> {\n  const entries = await listDossiers(vaultPath);\n  try {\n    const dir = deriveSessionDir(vaultPath);\n    await mkdir(dir, { recursive: true });\n    await writeFile(\n      join(dir, CACHE_FILE),\n      JSON.stringify({ compiledAt: new Date().toISOString(), dossiers: entries }, null, 2),\n      \"utf-8\"\n    );\n  } catch {\n    /* cache write is best-effort */\n  }\n  return entries;\n}\n\n/** Fast read for the hook: use the cache if present, else compile. */\nexport async function loadDossierCache(vaultPath: string): Promise<DossierEntry[]> {\n  const cachePath = join(deriveSessionDir(vaultPath), CACHE_FILE);\n  if (existsSync(cachePath)) {\n    try {\n      const data = JSON.parse(await readFile(cachePath, \"utf-8\"));\n      if (Array.isArray(data?.dossiers)) return data.dossiers as DossierEntry[];\n    } catch {\n      /* fall through to recompile */\n    }\n  }\n  return compileDossiers(vaultPath);\n}\n\n/** Find a dossier by exact entity name or any of its aliases (normalized). */\nexport function findDossier(entries: DossierEntry[], entityOrAlias: string): DossierEntry | undefined {\n  const n = normalizeEntity(entityOrAlias);\n  return entries.find(\n    (d) => normalizeEntity(d.entity) === n || d.aliases.some((a) => normalizeEntity(a) === n)\n  );\n}\n\n/**\n * Resolve an utterance to a dossier for two-hop retrieval: the query mentions the\n * entity name or one of its aliases. Returns the best (longest-alias) match so a\n * specific phrase wins over a generic one. Deterministic — no LLM, no embedding.\n */\nexport function resolveDossierForQuery(entries: DossierEntry[], query: string): DossierEntry | undefined {\n  const nq = normalizeEntity(query);\n  let best: { entry: DossierEntry; keyLen: number } | undefined;\n  for (const d of entries) {\n    const keys = [d.entity, ...d.aliases].map(normalizeEntity).filter(Boolean);\n    for (const k of keys) {\n      // Word-ish containment: the key appears in the query.\n      if (nq.includes(k) && (!best || k.length > best.keyLen)) {\n        best = { entry: d, keyLen: k.length };\n      }\n    }\n  }\n  return best?.entry;\n}\n\nasync function readDossierRaw(vaultPath: string, rel: string): Promise<{ raw: string; entity: string } | null> {\n  const abs = join(vaultPath, rel);\n  if (!existsSync(abs)) return null;\n  try {\n    const raw = await readFile(abs, \"utf-8\");\n    const { data } = matter(raw);\n    if (data.type !== \"dossier\") return null;\n    const entity = typeof data.entity === \"string\" ? data.entity : rel;\n    return { raw, entity };\n  } catch {\n    return null;\n  }\n}\n\n/** Resolve an entity/alias/path argument to a concrete dossier note path. */\nexport async function resolveDossierPath(vaultPath: string, entityOrPath: string): Promise<string | null> {\n  // Direct path?\n  if (entityOrPath.endsWith(\".md\") && existsSync(join(vaultPath, entityOrPath))) return entityOrPath;\n  const entries = await listDossiers(vaultPath);\n  const match = findDossier(entries, entityOrPath);\n  if (match) return match.path;\n  // Fall back to the slug path even if not yet created.\n  return null;\n}\n\nexport interface InitDossierResult {\n  path: string;\n  created: boolean;\n  entity: string;\n}\n\n/**\n * Scaffold a dossier for an entity. No-op (created:false) if one already exists for\n * that entity/slug. `seeded_from` records provenance (e.g. a babel-fish project-map\n * entry) without failing when that source is absent — same fail-open posture as the\n * v1.2 code-symbol drift seed.\n */\nexport async function initDossier(\n  vaultPath: string,\n  entity: string,\n  opts: { aliases?: string[]; purpose?: string; seeded_from?: string } = {}\n): Promise<InitDossierResult> {\n  const existing = await listDossiers(vaultPath);\n  const already = findDossier(existing, entity);\n  if (already) return { path: already.path, created: false, entity: already.entity };\n\n  const rel = join(DOSSIER_DIR, `${slugifyEntity(entity)}.md`);\n  const abs = join(vaultPath, rel);\n  if (existsSync(abs)) return { path: rel, created: false, entity };\n\n  const today = new Date().toISOString().slice(0, 10);\n  const fm: Record<string, unknown> = {\n    title: entity,\n    type: \"dossier\",\n    entity,\n    status: \"active\",\n    last_verified: today,\n    confidence: \"medium\",\n    ...(opts.aliases && opts.aliases.length > 0 ? { aliases: opts.aliases } : {}),\n    ...(opts.seeded_from ? { sources: [opts.seeded_from] } : {}),\n  };\n  const body = dossierTemplate(entity, { purpose: opts.purpose, seeded_from: opts.seeded_from });\n  await mkdir(join(vaultPath, DOSSIER_DIR), { recursive: true });\n  await writeFile(abs, matter.stringify(body, fm), \"utf-8\");\n  await compileDossiers(vaultPath);\n  return { path: rel, created: true, entity };\n}\n\n/**\n * Append a dated incident line to a dossier's Incident log (accretion, never a new\n * file). Returns the resolved path, or null if no dossier exists for the entity.\n */\nexport async function appendIncident(\n  vaultPath: string,\n  entityOrPath: string,\n  incident: string,\n  opts: { today?: string } = {}\n): Promise<{ path: string } | null> {\n  const rel = await resolveDossierPath(vaultPath, entityOrPath);\n  if (!rel) return null;\n  const doc = await readDossierRaw(vaultPath, rel);\n  if (!doc) return null;\n  const today = opts.today ?? new Date().toISOString().slice(0, 10);\n  const line = `- ${today} — ${incident.trim()}`;\n  const patched = appendToSection(doc.raw, \"Incident log\", line);\n  await writeFile(join(vaultPath, rel), patched, \"utf-8\");\n  await compileDossiers(vaultPath);\n  return { path: rel };\n}\n\n/**\n * Replace the body of a dossier's Current state section (the freshest one-liner).\n * Returns the resolved path, or null if no dossier exists for the entity.\n */\nexport async function setCurrentState(\n  vaultPath: string,\n  entityOrPath: string,\n  state: string\n): Promise<{ path: string } | null> {\n  const rel = await resolveDossierPath(vaultPath, entityOrPath);\n  if (!rel) return null;\n  const doc = await readDossierRaw(vaultPath, rel);\n  if (!doc) return null;\n  const patched = replaceSectionBody(doc.raw, \"Current state\", state.trim());\n  await writeFile(join(vaultPath, rel), patched, \"utf-8\");\n  await compileDossiers(vaultPath);\n  return { path: rel };\n}\n\n// --- section-level markdown editing (heading-scoped, format-preserving) ---\n\n/** Split into lines, find a `## <heading>` (case-insensitive), return its bounds. */\nfunction locateSection(markdown: string, heading: string): { start: number; level: number; end: number; lines: string[] } | null {\n  const lines = markdown.split(\"\\n\");\n  const want = heading.trim().toLowerCase();\n  let start = -1;\n  let level = 0;\n  for (let i = 0; i < lines.length; i++) {\n    const m = lines[i].match(/^(#{1,6})\\s+(.*?)\\s*$/);\n    if (m && m[2].trim().toLowerCase() === want) {\n      start = i;\n      level = m[1].length;\n      break;\n    }\n  }\n  if (start === -1) return null;\n  let end = lines.length;\n  for (let i = start + 1; i < lines.length; i++) {\n    const m = lines[i].match(/^(#{1,6})\\s+/);\n    if (m && m[1].length <= level) {\n      end = i;\n      break;\n    }\n  }\n  return { start, level, end, lines };\n}\n\n/** True if a section body is only the template placeholder (an italic prompt). */\nfunction isPlaceholderBody(body: string): boolean {\n  const t = body.trim();\n  return t === \"\" || (/^_.*_$/.test(t) && !t.includes(\"\\n\"));\n}\n\n/** Append a line to the end of a section's body (before the next heading/EOF). */\nexport function appendToSection(markdown: string, heading: string, line: string): string {\n  const loc = locateSection(markdown, heading);\n  if (!loc) {\n    // Section absent — append a fresh one at EOF.\n    const sep = markdown.endsWith(\"\\n\") ? \"\" : \"\\n\";\n    return `${markdown}${sep}\\n## ${heading}\\n\\n${line}\\n`;\n  }\n  const { lines, start, end } = loc;\n  const body = lines.slice(start + 1, end).join(\"\\n\");\n  // If the body is just the placeholder prompt, replace it with the first real line.\n  const bodyStripped = body.trim();\n  const replacePlaceholder = isPlaceholderBody(bodyStripped);\n  // Find the last non-empty line index within the section body.\n  let insertAt = end;\n  while (insertAt - 1 > start && lines[insertAt - 1].trim() === \"\") insertAt--;\n  const before = lines.slice(0, replacePlaceholder ? start + 1 : insertAt);\n  const after = lines.slice(replacePlaceholder ? end : insertAt);\n  const injected = replacePlaceholder ? [\"\", line] : [line];\n  return [...before, ...injected, ...after].join(\"\\n\");\n}\n\n/** Replace a section's entire body (keeps the heading), preserving surrounding doc. */\nexport function replaceSectionBody(markdown: string, heading: string, newBody: string): string {\n  const loc = locateSection(markdown, heading);\n  if (!loc) {\n    const sep = markdown.endsWith(\"\\n\") ? \"\" : \"\\n\";\n    return `${markdown}${sep}\\n## ${heading}\\n\\n${newBody}\\n`;\n  }\n  const { lines, start, end } = loc;\n  const before = lines.slice(0, start + 1);\n  const after = lines.slice(end);\n  return [...before, \"\", newBody, \"\", ...after].join(\"\\n\").replace(/\\n{3,}/g, \"\\n\\n\");\n}\n","/**\n * Section-targeted read (v1.4 Phase 7). Extract one heading's section from a\n * markdown document so pulling a dossier's *Knobs* section doesn't cost the whole\n * file. Matches a heading by text (case-insensitive), returns from that heading\n * through to the next heading of the same or higher level.\n */\nexport function extractSection(markdown: string, heading: string): string | null {\n  const target = heading.trim().toLowerCase();\n  const lines = markdown.split(\"\\n\");\n  let startIdx = -1;\n  let startLevel = 0;\n\n  const headingAt = (line: string): { level: number; text: string } | null => {\n    const m = /^(#{1,6})\\s+(.*?)\\s*$/.exec(line);\n    return m ? { level: m[1].length, text: m[2].trim().toLowerCase() } : null;\n  };\n\n  for (let i = 0; i < lines.length; i++) {\n    const h = headingAt(lines[i]);\n    if (h && h.text === target) {\n      startIdx = i;\n      startLevel = h.level;\n      break;\n    }\n  }\n  if (startIdx === -1) return null;\n\n  let endIdx = lines.length;\n  for (let i = startIdx + 1; i < lines.length; i++) {\n    const h = headingAt(lines[i]);\n    if (h && h.level <= startLevel) {\n      endIdx = i;\n      break;\n    }\n  }\n  return lines.slice(startIdx, endIdx).join(\"\\n\").trimEnd();\n}\n"],"mappings":"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","names":[]}