hafez 1.2.0 → 1.4.0

package/dist/parser.d.ts

@@ -1,18 +0,0 @@
-import type { SessionLogEntry, SessionLogType } from './types.js';
-export declare function parseSessionLogHeading(line: string): {
-    date: string;
-    agent: string;
-    type: SessionLogType;
-} | null;
-export declare function formatSessionLogEntry(entry: SessionLogEntry): string;
-export declare function countSessionLogEntries(body: string): number;
-export declare function parseSessionLog(body: string): Array<{
-    date: string;
-    agent: string;
-    type: SessionLogType;
-    summary: string;
-}>;
-export declare function extractOldestSessionLogEntry(body: string): {
-    entry: string;
-    remaining: string;
-} | null;

package/dist/parser.js

@@ -1,68 +0,0 @@
-import { findNextStructuralHeading } from './sections.js';
-const HEADING_RE = /^### (\d{4}-\d{2}-\d{2}) (?:—|--) (.+?)(?:\s+\[(\w+)\])?$/;
-export function parseSessionLogHeading(line) {
-    const match = line.match(HEADING_RE);
-    if (!match)
-        return null;
-    return {
-        date: match[1],
-        agent: match[2],
-        type: match[3] || 'progress'
-    };
-}
-export function formatSessionLogEntry(entry) {
-    const today = new Date().toISOString().slice(0, 10);
-    const lines = [`### ${today} — ${entry.agent} [${entry.type}]`, `Summary: ${entry.summary}`];
-    if (entry.body)
-        lines.push(entry.body);
-    return lines.join('\n');
-}
-export function countSessionLogEntries(body) {
-    return (body.match(/^### \d{4}-\d{2}-\d{2} (?:—|--)/gm) || []).length;
-}
-export function parseSessionLog(body) {
-    // Inline section extraction to avoid circular import with sections.ts
-    const idx = body.indexOf('## Session Log');
-    if (idx === -1)
-        return [];
-    const afterPos = idx + '## Session Log'.length;
-    // Find end: next structural ## heading or end of string
-    const nextH = findNextStructuralHeading(body, afterPos);
-    const sectionContent = nextH !== -1 ? body.slice(afterPos, nextH) : body.slice(afterPos);
-    const entries = [];
-    const lines = sectionContent.split('\n');
-    let current = null;
-    let summaryLine = null;
-    for (const line of lines) {
-        const heading = parseSessionLogHeading(line);
-        if (heading) {
-            if (current && summaryLine) {
-                entries.push({ ...current, summary: summaryLine });
-            }
-            current = heading;
-            summaryLine = null;
-        }
-        else if (current && !summaryLine && line.startsWith('Summary: ')) {
-            summaryLine = line.slice('Summary: '.length);
-        }
-    }
-    if (current && summaryLine) {
-        entries.push({ ...current, summary: summaryLine });
-    }
-    return entries;
-}
-export function extractOldestSessionLogEntry(body) {
-    const sectionStart = body.indexOf('## Session Log');
-    if (sectionStart === -1)
-        return null;
-    const afterHeader = body.slice(sectionStart + '## Session Log'.length);
-    const entryStarts = [...afterHeader.matchAll(/^### \d{4}-\d{2}-\d{2} (?:—|--)/gm)];
-    if (entryStarts.length < 2)
-        return null;
-    // Entries are newest-first in the file, so the oldest is the last match
-    const lastIdx = entryStarts.length - 1;
-    const oldestStart = entryStarts[lastIdx].index;
-    const entry = afterHeader.slice(oldestStart).trim();
-    const remaining = body.slice(0, sectionStart + '## Session Log'.length) + afterHeader.slice(0, oldestStart);
-    return { entry, remaining };
-}

package/dist/query.d.ts

@@ -1,24 +0,0 @@
-import type { QueryResult, KnowledgeQueryResult, EntityQueryOpts, KnowledgeQueryOpts, UnifiedResult } from './types.js';
-import type { HafezIndex } from './db.js';
-export declare function queryEntities(index: HafezIndex, opts?: EntityQueryOpts): {
-    items: QueryResult[];
-    total: number;
-};
-export declare function queryChildren(index: HafezIndex, parentSlug: string): {
-    items: QueryResult[];
-    total: number;
-};
-export declare function queryRelatedTo(index: HafezIndex, slug: string, relation?: string): {
-    items: (QueryResult | KnowledgeQueryResult)[];
-    total: number;
-};
-export declare function queryKnowledge(index: HafezIndex, opts?: KnowledgeQueryOpts): {
-    items: KnowledgeQueryResult[];
-    total: number;
-};
-export declare function queryUnified(index: HafezIndex, opts?: EntityQueryOpts & {
-    kind?: 'entity' | 'knowledge' | 'all';
-}): {
-    items: UnifiedResult[];
-    total: number;
-};

package/dist/query.js

@@ -1,167 +0,0 @@
-import { HafezError } from './types.js';
-function toQueryResult(slug, row) {
-    return {
-        slug,
-        name: row.name,
-        type: row.type,
-        status: row.status,
-        description: row.description ?? null,
-        resource: row.resource ?? null,
-        domain: row.domain ?? [],
-        last_touched: row.last_touched,
-        next_action: row.next_action ?? null,
-        next_action_count: row.next_action_count ?? 0,
-        parent: row.parent ?? null,
-        related: row.related ?? [],
-        staleness_days: row.staleness_days ?? null,
-        tags: row.tags ?? [],
-        brief: row.brief ?? null,
-        session_log_count: row.session_log_count ?? 0,
-        last_session_date: row.last_session_date ?? null,
-        last_session_type: row.last_session_type ?? null,
-        last_session_summary: row.last_session_summary ?? null,
-    };
-}
-function toKnowledgeResult(slug, row) {
-    return {
-        slug,
-        name: row.name,
-        description: row.description ?? null,
-        domain: row.domain ?? [],
-        confidence: row.confidence ?? 'observation',
-        related: row.related ?? [],
-        reinforcement_count: row.reinforcement_count ?? 0,
-        last_reinforced: row.last_reinforced ?? null,
-        last_touched: row.last_touched ?? null,
-    };
-}
-const STATUS_FILTERS = new Set(['active', 'paused', 'done']);
-const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
-function validateDateOpts(opts) {
-    const fields = ['since', 'before', 'createdSince', 'createdBefore'];
-    for (const f of fields) {
-        if (opts?.[f] !== undefined && !ISO_DATE.test(opts[f])) {
-            throw new HafezError('VALIDATION_FAILED', `Invalid date format for ${f}: "${opts[f]}". Must be YYYY-MM-DD.`);
-        }
-    }
-}
-export function queryEntities(index, opts) {
-    index.syncIfStale();
-    validateDateOpts(opts);
-    const qopts = { kind: 'entity' };
-    if (opts?.filter && STATUS_FILTERS.has(opts.filter))
-        qopts.status = opts.filter;
-    if (opts?.filter === 'stale')
-        qopts.filter = 'stale';
-    if (opts?.filter === 'capture')
-        qopts.filter = 'capture';
-    if (opts?.type)
-        qopts.type = opts.type;
-    if (opts?.parent)
-        qopts.parent = opts.parent;
-    if (opts?.domain)
-        qopts.domain = opts.domain;
-    if (opts?.since)
-        qopts.since = opts.since;
-    if (opts?.before)
-        qopts.before = opts.before;
-    if (opts?.createdSince)
-        qopts.createdSince = opts.createdSince;
-    if (opts?.createdBefore)
-        qopts.createdBefore = opts.createdBefore;
-    if (opts?.tags)
-        qopts.tags = opts.tags;
-    if (opts?.sort_by)
-        qopts.sort_by = opts.sort_by;
-    if (opts?.sort_order)
-        qopts.sort_order = opts.sort_order;
-    if (opts?.limit != null)
-        qopts.limit = opts.limit;
-    if (opts?.offset != null)
-        qopts.offset = opts.offset;
-    const { items, total } = index.queryItems(qopts);
-    return { items: items.map(i => toQueryResult(i.slug, i)), total };
-}
-export function queryChildren(index, parentSlug) {
-    return queryEntities(index, { parent: parentSlug });
-}
-export function queryRelatedTo(index, slug, relation) {
-    index.syncIfStale();
-    const { items, total } = index.queryItems({ relatedTo: slug, relation });
-    return {
-        items: items.map(i => i.kind === 'entity' ? toQueryResult(i.slug, i) : toKnowledgeResult(i.slug, i)),
-        total,
-    };
-}
-export function queryKnowledge(index, opts) {
-    index.syncIfStale();
-    const qopts = { kind: 'knowledge' };
-    if (opts?.domain)
-        qopts.domain = opts.domain;
-    if (opts?.confidence)
-        qopts.confidence = opts.confidence;
-    if (opts?.subtype)
-        qopts.subtype = opts.subtype;
-    if (opts?.tags)
-        qopts.tags = opts.tags;
-    if (opts?.sort_by)
-        qopts.sort_by = opts.sort_by;
-    if (opts?.sort_order)
-        qopts.sort_order = opts.sort_order;
-    if (opts?.limit != null)
-        qopts.limit = opts.limit;
-    if (opts?.offset != null)
-        qopts.offset = opts.offset;
-    const { items, total } = index.queryItems(qopts);
-    return { items: items.map(i => toKnowledgeResult(i.slug, i)), total };
-}
-export function queryUnified(index, opts) {
-    index.syncIfStale();
-    validateDateOpts(opts);
-    const qopts = {};
-    if (opts?.kind && opts.kind !== 'all')
-        qopts.kind = opts.kind;
-    // When kind is 'all' or unset, no kind filter — both entities and knowledge are returned
-    if (opts?.filter && STATUS_FILTERS.has(opts.filter))
-        qopts.status = opts.filter;
-    if (opts?.filter === 'stale')
-        qopts.filter = 'stale';
-    if (opts?.filter === 'capture')
-        qopts.filter = 'capture';
-    if (opts?.type)
-        qopts.type = opts.type;
-    if (opts?.parent)
-        qopts.parent = opts.parent;
-    if (opts?.domain)
-        qopts.domain = opts.domain;
-    if (opts?.confidence)
-        qopts.confidence = opts.confidence;
-    if (opts?.since)
-        qopts.since = opts.since;
-    if (opts?.before)
-        qopts.before = opts.before;
-    if (opts?.createdSince)
-        qopts.createdSince = opts.createdSince;
-    if (opts?.createdBefore)
-        qopts.createdBefore = opts.createdBefore;
-    if (opts?.tags)
-        qopts.tags = opts.tags;
-    if (opts?.sort_by)
-        qopts.sort_by = opts.sort_by;
-    if (opts?.sort_order)
-        qopts.sort_order = opts.sort_order;
-    if (opts?.limit !== undefined)
-        qopts.limit = opts.limit;
-    if (opts?.offset !== undefined)
-        qopts.offset = opts.offset;
-    const result = index.queryItems(qopts);
-    const items = result.items.map(i => {
-        if (i.kind === 'entity') {
-            return { ...toQueryResult(i.slug, i), kind: 'entity' };
-        }
-        else {
-            return { ...toKnowledgeResult(i.slug, i), kind: 'knowledge' };
-        }
-    });
-    return { items, total: result.total };
-}

package/dist/sections.d.ts

@@ -1,54 +0,0 @@
-/**
- * Known structural section headings in Hafez entities and knowledge notes.
- * Derived from contracts.ts (defaultSections + optionalSections) plus
- * auto-generated sections not tracked in contracts (Related, Summary).
- * Only these are treated as section boundaries. Any other `## ` heading
- * inside section content (e.g. in a brief or session log) is preserved as-is.
- */
-export declare const STRUCTURAL_SECTIONS: Set<string>;
-/**
- * Find the next structural `## Heading` boundary after a given position.
- * Skips `## ` headings that are not known structural sections (content headings).
- * Returns the index of the `\n` before the `## `, or -1 if no structural heading found.
- */
-export declare function findNextStructuralHeading(body: string, from: number): number;
-/**
- * Find a ## Heading section and its content.
- * Returns { start, end, content } or null if not found.
- * Matches heading exactly (e.g. "## Brief" won't match "## Briefing").
- * Only treats known structural headings as section boundaries -- content
- * inside a section may contain arbitrary `## ` headings without corruption.
- */
-export declare function findSection(body: string, heading: string): {
-    start: number;
-    end: number;
-    content: string;
-} | null;
-export declare function getBrief(body: string): string | null;
-export declare function setBrief(body: string, content: string): string;
-export declare function removeBrief(body: string): string;
-export declare function getNextActions(body: string): string[];
-export declare function addNextAction(body: string, action: string): string;
-export declare function completeNextAction(body: string, query: string): {
-    matched: string;
-    body: string;
-};
-export declare function removeNextAction(body: string, query: string): {
-    matched: string;
-    body: string;
-};
-export declare function clearNextActions(body: string): string;
-export declare function firstNonEmptyLine(s: string | null | undefined): string;
-/**
- * One-line summary for a doc: frontmatter description first, then the first
- * non-empty line of the kind's primary section (entity: Brief; knowledge:
- * Synthesis, falling back to Goal for plans; session: Summary).
- * Shared by the vault index and the OKF export so the two surfaces agree.
- */
-export declare function deriveSummary(kind: 'entity' | 'knowledge' | 'session', fm: Record<string, any>, body: string): string;
-/** Matches [[slug]] or [[slug|display text]], capturing slug in group 1. Non-global — wrap with `new RegExp(WIKI_LINK_RE.source, 'g')` for iteration. */
-export declare const WIKI_LINK_RE: RegExp;
-export declare function syncRelatedSection(body: string, frontmatter: {
-    parent?: string;
-    related?: string[];
-}): string;

package/dist/sections.js

@@ -1,297 +0,0 @@
-// src/sections.ts
-// Pure string→string functions for Brief and Next Actions section manipulation.
-import { ALL_CONTRACTS, SUBTYPE_SECTIONS } from './contracts.js';
-const UNCHECKED_RE = /^- \[ \] (.+)$/gm;
-/**
- * Known structural section headings in Hafez entities and knowledge notes.
- * Derived from contracts.ts (defaultSections + optionalSections) plus
- * auto-generated sections not tracked in contracts (Related, Summary).
- * Only these are treated as section boundaries. Any other `## ` heading
- * inside section content (e.g. in a brief or session log) is preserved as-is.
- */
-export const STRUCTURAL_SECTIONS = new Set([
-    ...ALL_CONTRACTS.flatMap(c => [...c.defaultSections, ...c.optionalSections]),
-    ...Object.values(SUBTYPE_SECTIONS).flat(),
-    'Related', // auto-generated by syncRelatedSection
-    'Summary', // used in session files
-]);
-/**
- * Find the next structural `## Heading` boundary after a given position.
- * Skips `## ` headings that are not known structural sections (content headings).
- * Returns the index of the `\n` before the `## `, or -1 if no structural heading found.
- */
-export function findNextStructuralHeading(body, from) {
-    const re = /\n## ([^\n]+)/g;
-    re.lastIndex = from;
-    let match;
-    while ((match = re.exec(body)) !== null) {
-        const headingName = match[1].trim();
-        if (STRUCTURAL_SECTIONS.has(headingName)) {
-            return match.index;
-        }
-    }
-    return -1;
-}
-// --- Internal helpers ---
-/**
- * Find a ## Heading section and its content.
- * Returns { start, end, content } or null if not found.
- * Matches heading exactly (e.g. "## Brief" won't match "## Briefing").
- * Only treats known structural headings as section boundaries -- content
- * inside a section may contain arbitrary `## ` headings without corruption.
- */
-export function findSection(body, heading) {
-    const re = new RegExp(`(^|\\n)(## ${escapeRegex(heading)})(?:\\n|$)`);
-    const match = re.exec(body);
-    if (!match)
-        return null;
-    const start = match.index + match[1].length;
-    const afterHeading = start + match[2].length + 1;
-    // Find the next structural ## heading or EOF
-    const nextHeading = findNextStructuralHeading(body, afterHeading);
-    const end = nextHeading === -1 ? body.length : nextHeading;
-    const rawContent = body.slice(afterHeading, end);
-    const content = rawContent.replace(/^\n+/, '').replace(/\n+$/, '');
-    return { start, end, content };
-}
-function escapeRegex(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-/**
- * Remove a section (heading + content) from body, cleaning up extra whitespace.
- */
-function removeSection(body, heading) {
-    const section = findSection(body, heading);
-    if (!section)
-        return body;
-    const before = body.slice(0, section.start);
-    const after = body.slice(section.end);
-    // Clean up: avoid triple+ newlines at the splice point
-    const trimmedBefore = before.replace(/\n+$/, '');
-    const trimmedAfter = after.replace(/^\n+/, '');
-    if (!trimmedBefore)
-        return trimmedAfter;
-    if (!trimmedAfter)
-        return trimmedBefore;
-    return trimmedBefore + '\n\n' + trimmedAfter;
-}
-/**
- * Insert a new section before a target heading, or at EOF.
- * `before` is an array of headings to try inserting before (first found wins).
- */
-function insertSectionBefore(body, heading, content, before) {
-    const sectionBlock = `## ${heading}\n\n${content}`;
-    for (const target of before) {
-        const targetSection = findSection(body, target);
-        if (targetSection) {
-            const insertPoint = targetSection.start;
-            const textBefore = body.slice(0, insertPoint).replace(/\n+$/, '');
-            const textAfter = body.slice(insertPoint);
-            if (!textBefore)
-                return sectionBlock + '\n\n' + textAfter;
-            return textBefore + '\n\n' + sectionBlock + '\n\n' + textAfter;
-        }
-    }
-    // No target found — append at EOF
-    const trimmed = body.replace(/\n+$/, '');
-    return trimmed + '\n\n' + sectionBlock;
-}
-/**
- * Insert a new section after a target heading (and its content), or fall back to inserting before fallbacks.
- */
-function insertSectionAfter(body, heading, content, after, beforeFallbacks) {
-    const afterSection = findSection(body, after);
-    if (afterSection) {
-        const insertPoint = afterSection.end;
-        const textBefore = body.slice(0, insertPoint).replace(/\n+$/, '');
-        const textAfter = body.slice(insertPoint).replace(/^\n+/, '');
-        const sectionBlock = `## ${heading}\n\n${content}`;
-        if (!textAfter)
-            return textBefore + '\n\n' + sectionBlock;
-        return textBefore + '\n\n' + sectionBlock + '\n\n' + textAfter;
-    }
-    // After-target not found — fall back to insertBefore logic
-    return insertSectionBefore(body, heading, content, beforeFallbacks);
-}
-/**
- * Normalize text for matching: trim whitespace, replace smart quotes with
- * straight equivalents, normalize em-dashes to regular dashes.
- * Applied to both query and action text before comparison only — stored text is unchanged.
- */
-function normalizeForMatch(s) {
-    return s
-        .trim()
-        .replace(/[\u2018\u2019]/g, "'")
-        .replace(/[\u201C\u201D]/g, '"')
-        .replace(/\u2014/g, '-');
-}
-/**
- * Match an action by case-insensitive substring against unchecked items.
- * Throws on 0 or >1 matches.
- */
-function matchAction(body, query) {
-    const section = findSection(body, 'Next Actions');
-    if (!section)
-        throw new Error(`No matching action for "${query}"`);
-    const normalizedQuery = normalizeForMatch(query).toLowerCase();
-    const matches = [];
-    const allActions = [];
-    let m;
-    const re = new RegExp(UNCHECKED_RE.source, 'gm');
-    while ((m = re.exec(section.content)) !== null) {
-        allActions.push(m[1]);
-        if (normalizeForMatch(m[1]).toLowerCase().includes(normalizedQuery)) {
-            matches.push(m[1]);
-        }
-    }
-    if (matches.length === 0) {
-        throw new Error(`No matching action for "${query}". Actions: ${JSON.stringify(allActions)}`);
-    }
-    if (matches.length > 1)
-        throw new Error(`Ambiguous match for "${query}": ${matches.join(', ')}`);
-    return matches[0];
-}
-// --- Brief functions ---
-export function getBrief(body) {
-    const section = findSection(body, 'Brief');
-    if (!section)
-        return null;
-    return section.content || null;
-}
-export function setBrief(body, content) {
-    const existing = findSection(body, 'Brief');
-    if (existing) {
-        // Replace existing brief content
-        const updated = removeSection(body, 'Brief');
-        return setBrief(updated, content);
-    }
-    // Insert before: Next Actions > Current State > Session Log > EOF
-    return insertSectionBefore(body, 'Brief', content, ['Next Actions', 'Current State', 'Session Log']);
-}
-export function removeBrief(body) {
-    return removeSection(body, 'Brief');
-}
-// --- Next Actions functions ---
-export function getNextActions(body) {
-    const section = findSection(body, 'Next Actions');
-    if (!section)
-        return [];
-    const actions = [];
-    let m;
-    const re = new RegExp(UNCHECKED_RE.source, 'gm');
-    while ((m = re.exec(section.content)) !== null) {
-        actions.push(m[1]);
-    }
-    return actions;
-}
-export function addNextAction(body, action) {
-    const section = findSection(body, 'Next Actions');
-    if (section) {
-        // Add the new item at the end of unchecked items (before any checked items)
-        const lines = section.content.split('\n');
-        const lastUncheckedIdx = lines.reduce((last, line, i) => line.startsWith('- [ ] ') ? i : last, -1);
-        const insertIdx = lastUncheckedIdx === -1 ? 0 : lastUncheckedIdx + 1;
-        lines.splice(insertIdx, 0, `- [ ] ${action}`);
-        const newContent = lines.join('\n');
-        const before = body.slice(0, section.start).replace(/\n+$/, '');
-        const after = body.slice(section.end).replace(/^\n+/, '');
-        const sectionBlock = `## Next Actions\n\n${newContent}`;
-        const parts = [before, sectionBlock, after].filter(Boolean);
-        return parts.join('\n\n');
-    }
-    // No section — insert after Brief if present, otherwise before Session Log
-    return insertSectionAfter(body, 'Next Actions', `- [ ] ${action}`, 'Brief', ['Session Log']);
-}
-export function completeNextAction(body, query) {
-    const matched = matchAction(body, query);
-    // Replace the unchecked item with checked
-    const updatedBody = body.replace(`- [ ] ${matched}`, `- [x] ${matched}`);
-    // Check if any unchecked items remain
-    const remaining = getNextActions(updatedBody);
-    if (remaining.length === 0) {
-        return { matched, body: clearNextActions(updatedBody) };
-    }
-    return { matched, body: updatedBody };
-}
-export function removeNextAction(body, query) {
-    const matched = matchAction(body, query);
-    // Remove the line
-    const line = `- [ ] ${matched}`;
-    const updatedBody = body.split('\n').filter(l => l !== line).join('\n');
-    // Check if any unchecked items remain
-    const remaining = getNextActions(updatedBody);
-    if (remaining.length === 0) {
-        return { matched, body: clearNextActions(updatedBody) };
-    }
-    return { matched, body: updatedBody };
-}
-export function clearNextActions(body) {
-    return removeSection(body, 'Next Actions');
-}
-// --- Summary derivation ---
-export function firstNonEmptyLine(s) {
-    return s?.split('\n').find(l => l.trim())?.trim() ?? '';
-}
-/**
- * One-line summary for a doc: frontmatter description first, then the first
- * non-empty line of the kind's primary section (entity: Brief; knowledge:
- * Synthesis, falling back to Goal for plans; session: Summary).
- * Shared by the vault index and the OKF export so the two surfaces agree.
- */
-export function deriveSummary(kind, fm, body) {
-    if (fm.description)
-        return fm.description;
-    if (kind === 'entity')
-        return firstNonEmptyLine(getBrief(body));
-    if (kind === 'knowledge') {
-        const synthesis = findSection(body, 'Synthesis');
-        if (synthesis?.content)
-            return firstNonEmptyLine(synthesis.content);
-        return firstNonEmptyLine(findSection(body, 'Goal')?.content);
-    }
-    return firstNonEmptyLine(findSection(body, 'Summary')?.content);
-}
-// --- Related section functions ---
-/** Matches [[slug]] or [[slug|display text]], capturing slug in group 1. Non-global — wrap with `new RegExp(WIKI_LINK_RE.source, 'g')` for iteration. */
-export const WIKI_LINK_RE = /\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/;
-export function syncRelatedSection(body, frontmatter) {
-    const targets = [];
-    if (frontmatter.parent)
-        targets.push({ slug: frontmatter.parent, label: 'parent' });
-    for (const slug of frontmatter.related ?? [])
-        targets.push({ slug });
-    if (targets.length === 0) {
-        // No frontmatter links — remove Related section if present
-        const existing = findSection(body, 'Related');
-        if (!existing)
-            return body;
-        const before = body.slice(0, existing.start).replace(/\n+$/, '');
-        const after = body.slice(existing.end).replace(/^\n+/, '');
-        return [before, after].filter(Boolean).join('\n\n');
-    }
-    // Strip existing Related section before checking coverage
-    let authoredBody = body;
-    const existingRelated = findSection(body, 'Related');
-    if (existingRelated) {
-        const before = body.slice(0, existingRelated.start);
-        const after = body.slice(existingRelated.end);
-        authoredBody = (before + after).replace(/\n{3,}/g, '\n\n');
-    }
-    // Find which targets are NOT mentioned in authored body
-    const mentionedSlugs = new Set();
-    let match;
-    const re = new RegExp(WIKI_LINK_RE.source, 'g');
-    while ((match = re.exec(authoredBody)) !== null) {
-        mentionedSlugs.add(match[1]);
-    }
-    const uncovered = targets.filter(t => !mentionedSlugs.has(t.slug));
-    if (uncovered.length === 0) {
-        // All covered inline — return body without Related section
-        return authoredBody.replace(/\n+$/, '');
-    }
-    // Build Related section
-    const lines = uncovered.map(t => t.label ? `- [[${t.slug}]] (${t.label})` : `- [[${t.slug}]]`);
-    const section = `## Related\n\n${lines.join('\n')}`;
-    // Append at end
-    return authoredBody.replace(/\n+$/, '') + '\n\n' + section;
-}