@inharness-ai/claude4spec 1.0.0

package/dist/server/services/section-indexer.js

@@ -0,0 +1,276 @@
+import crypto from 'node:crypto';
+import { customAlphabet } from 'nanoid';
+import { parseXmlTags } from '../../shared/xml-tags.js';
+import { ANCHOR_PATTERN_SOURCE } from '../../shared/anchor-pattern.js';
+import { pluginHost } from '../core/plugin-host/host.js';
+// Generator stays strict 8 (per M06 spec `15u7sazr` — auto-inject contract).
+const nanoid8 = customAlphabet('abcdefghijklmnopqrstuvwxyz0123456789', 8);
+const ANCHOR_RE = new RegExp(ANCHOR_PATTERN_SOURCE);
+const HEADING_RE = /^(#{1,6})\s+(.+?)\s*$/;
+export class SectionIndexerService {
+    db;
+    pages;
+    watcher;
+    ws;
+    debounceMs = 300;
+    pending = new Map();
+    constructor(db, pages, watcher, ws) {
+        this.db = db;
+        this.pages = pages;
+        this.watcher = watcher;
+        this.ws = ws;
+    }
+    schedulePage(relPath) {
+        const prev = this.pending.get(relPath);
+        if (prev)
+            clearTimeout(prev);
+        const timer = setTimeout(() => {
+            this.pending.delete(relPath);
+            this.indexPage(relPath).catch((err) => {
+                console.error(`[section-indexer] failed to index ${relPath}:`, err);
+            });
+        }, this.debounceMs);
+        this.pending.set(relPath, timer);
+    }
+    async handleUnlink(relPath) {
+        const prev = this.pending.get(relPath);
+        if (prev) {
+            clearTimeout(prev);
+            this.pending.delete(relPath);
+        }
+        const existing = this.db
+            .prepare('SELECT anchor FROM section_index WHERE page_path = ?')
+            .all(relPath);
+        if (existing.length === 0)
+            return;
+        const anchors = existing.map((r) => r.anchor);
+        const tx = this.db.transaction(() => {
+            for (const anchor of anchors)
+                this.removeSectionIndex(anchor);
+        });
+        tx();
+    }
+    removeSectionIndex(anchor) {
+        this.db.prepare('DELETE FROM section_entity_link WHERE anchor = ?').run(anchor);
+        this.db.prepare('DELETE FROM section_index WHERE anchor = ?').run(anchor);
+    }
+    async indexAll() {
+        const files = await this.pages.listMarkdownFiles();
+        for (const rel of files) {
+            await this.indexPage(rel);
+        }
+    }
+    async indexPage(relPath) {
+        let page;
+        try {
+            page = await this.pages.read(relPath);
+        }
+        catch {
+            return;
+        }
+        let body = page.body;
+        const lines = body.split('\n');
+        const headings = parseHeadings(lines);
+        let bodyChanged = false;
+        for (const h of headings) {
+            if (h.anchor === null) {
+                const newAnchor = nanoid8();
+                lines.splice(h.lineIndex, 0, `<!-- anchor: ${newAnchor} -->`);
+                shiftHeadingLines(headings, h.lineIndex, 1);
+                h.anchor = newAnchor;
+                h.anchorLineIndex = h.lineIndex - 1;
+                bodyChanged = true;
+            }
+        }
+        if (bodyChanged) {
+            body = lines.join('\n');
+            this.watcher.suppress(relPath);
+            await this.pages.write(relPath, { frontmatter: page.frontmatter, body });
+        }
+        const sections = buildSections(lines, headings);
+        const priorRows = this.db
+            .prepare('SELECT anchor, content_hash FROM section_index WHERE page_path = ?')
+            .all(relPath);
+        const prior = new Map(priorRows.map((r) => [r.anchor, r.content_hash]));
+        const currentAnchors = new Set(sections.map((s) => s.anchor));
+        const deletedAnchors = [];
+        for (const anchor of prior.keys()) {
+            if (!currentAnchors.has(anchor))
+                deletedAnchors.push(anchor);
+        }
+        const tx = this.db.transaction(() => {
+            const upsertStmt = this.db.prepare(`INSERT INTO section_index
+            (anchor, page_path, heading_path, heading_slug, heading_level,
+             heading_text, content_hash, line_start, line_end, paragraph_count,
+             created_at, updated_at)
+          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'), datetime('now'))
+          ON CONFLICT(anchor) DO UPDATE SET
+            page_path = excluded.page_path,
+            heading_path = excluded.heading_path,
+            heading_slug = excluded.heading_slug,
+            heading_level = excluded.heading_level,
+            heading_text = excluded.heading_text,
+            content_hash = excluded.content_hash,
+            line_start = excluded.line_start,
+            line_end = excluded.line_end,
+            paragraph_count = excluded.paragraph_count,
+            updated_at = datetime('now')`);
+            for (const s of sections) {
+                upsertStmt.run(s.anchor, relPath, s.headingPath, s.headingSlug, s.heading.level, s.heading.text, s.contentHash, s.lineStart, s.lineEnd, s.paragraphCount);
+            }
+            if (deletedAnchors.length) {
+                for (const anchor of deletedAnchors)
+                    this.removeSectionIndex(anchor);
+            }
+            const anchorsInFile = sections.map((s) => s.anchor);
+            if (anchorsInFile.length) {
+                const placeholders = anchorsInFile.map(() => '?').join(',');
+                this.db
+                    .prepare(`DELETE FROM section_entity_link WHERE anchor IN (${placeholders})`)
+                    .run(...anchorsInFile);
+                const linkStmt = this.db.prepare(`INSERT OR IGNORE INTO section_entity_link (anchor, entity_type, entity_id, relation)
+               VALUES (?, ?, ?, 'uses')`);
+                for (const s of sections) {
+                    const xmlTags = parseXmlTags(s.content);
+                    const seen = new Set();
+                    for (const tag of xmlTags) {
+                        const type = tag.attrs.type;
+                        if (!type)
+                            continue;
+                        const slugs = extractSlugsFromTag(tag);
+                        for (const slug of slugs) {
+                            const key = `${type}|${slug}`;
+                            if (seen.has(key))
+                                continue;
+                            seen.add(key);
+                            const entityId = this.resolveEntityId(type, slug);
+                            if (entityId != null)
+                                linkStmt.run(s.anchor, type, entityId);
+                        }
+                    }
+                }
+            }
+        });
+        tx();
+        this.ws.broadcast({
+            kind: 'section:indexed',
+            pagePath: relPath,
+            anchors: sections.map((s) => s.anchor),
+        });
+    }
+    resolveEntityId(type, slug) {
+        return pluginHost.resolveEntityId(type, slug);
+    }
+}
+function parseHeadings(lines) {
+    const out = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        const m = HEADING_RE.exec(line);
+        if (!m)
+            continue;
+        const level = (m[1] ?? '').length;
+        const text = (m[2] ?? '').trim();
+        let anchor = null;
+        let anchorLineIndex = null;
+        for (let j = i - 1; j >= 0; j--) {
+            const above = (lines[j] ?? '').trim();
+            if (above === '')
+                continue;
+            const am = ANCHOR_RE.exec(above);
+            if (am) {
+                anchor = am[1] ?? null;
+                anchorLineIndex = j;
+            }
+            break;
+        }
+        out.push({ level, text, lineIndex: i, anchor, anchorLineIndex });
+    }
+    return out;
+}
+function shiftHeadingLines(headings, fromIndex, delta) {
+    for (const h of headings) {
+        if (h.lineIndex >= fromIndex)
+            h.lineIndex += delta;
+        if (h.anchorLineIndex !== null && h.anchorLineIndex >= fromIndex) {
+            h.anchorLineIndex += delta;
+        }
+    }
+}
+function buildSections(lines, headings) {
+    const sections = [];
+    const stack = [];
+    for (let idx = 0; idx < headings.length; idx++) {
+        const h = headings[idx];
+        if (!h.anchor)
+            continue;
+        while (stack.length && stack[stack.length - 1].level >= h.level)
+            stack.pop();
+        const headingPath = [...stack.map((x) => x.text), h.text].join('/');
+        const headingSlug = slugifyHeading(h.text);
+        stack.push(h);
+        let endLine = lines.length;
+        for (let j = idx + 1; j < headings.length; j++) {
+            if (headings[j].level <= h.level) {
+                endLine = headings[j].anchorLineIndex ?? headings[j].lineIndex;
+                break;
+            }
+        }
+        const startLine = h.lineIndex;
+        const sectionLines = lines.slice(startLine, endLine);
+        const rawBody = sectionLines.slice(1).join('\n');
+        const normalized = normalizeContent(rawBody);
+        const contentHash = crypto.createHash('sha256').update(normalized).digest('hex');
+        const paragraphCount = countParagraphs(rawBody);
+        sections.push({
+            anchor: h.anchor,
+            heading: h,
+            headingPath,
+            headingSlug,
+            lineStart: startLine + 1,
+            lineEnd: endLine,
+            content: rawBody,
+            contentHash,
+            paragraphCount,
+        });
+    }
+    return sections;
+}
+function slugifyHeading(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-');
+}
+export function normalizeContent(content) {
+    return content
+        .replace(/<!--[\s\S]*?-->/g, '')
+        .replace(/<\w[^>]*\/?>(?:[\s\S]*?<\/\w+>)?/g, '')
+        .replace(/\*\*(.*?)\*\*/g, '$1')
+        .replace(/_(.*?)_/g, '$1')
+        .replace(/`([^`]*)`/g, '$1')
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+        .replace(/^[-*+]\s+/gm, '')
+        .replace(/^\d+\.\s+/gm, '')
+        .replace(/\s+/g, ' ')
+        .toLowerCase()
+        .trim();
+}
+function countParagraphs(content) {
+    const blocks = content.split(/\n\s*\n/).filter((b) => b.trim().length > 0);
+    return blocks.length;
+}
+function extractSlugsFromTag(tag) {
+    if (tag.kind === 'inline_mention' || tag.kind === 'single_element') {
+        return tag.attrs.slug ? [tag.attrs.slug] : [];
+    }
+    if (tag.kind === 'element_list') {
+        return (tag.attrs.slugs ?? '')
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+    }
+    return [];
+}
+//# sourceMappingURL=section-indexer.js.map

package/dist/server/services/section-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-indexer.js","sourceRoot":"","sources":["../../../src/server/services/section-indexer.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAIvE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,6EAA6E;AAC7E,MAAM,OAAO,GAAG,cAAc,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC;AAE1E,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACpD,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAsB3C,MAAM,OAAO,qBAAqB;IAKtB;IACA;IACA;IACA;IAPF,UAAU,GAAG,GAAG,CAAC;IACjB,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEpD,YACU,EAAqB,EACrB,KAAmB,EACnB,OAAqB,EACrB,EAAa;QAHb,OAAE,GAAF,EAAE,CAAmB;QACrB,UAAK,GAAL,KAAK,CAAc;QACnB,YAAO,GAAP,OAAO,CAAc;QACrB,OAAE,GAAF,EAAE,CAAW;IACpB,CAAC;IAEJ,YAAY,CAAC,OAAe;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,IAAI;YAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACpC,OAAO,CAAC,KAAK,CAAC,qCAAqC,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,IAAI,EAAE,CAAC;YACT,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;aACrB,OAAO,CAAC,sDAAsD,CAAC;aAC/D,GAAG,CAAC,OAAO,CAA8B,CAAC;QAC7C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,EAAE,EAAE,CAAC;IACP,CAAC;IAEO,kBAAkB,CAAC,MAAc;QACvC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChF,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,4CAA4C,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;QACnD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAErB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,WAAW,GAAG,KAAK,CAAC;QAExB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBACtB,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC;gBAC5B,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE,gBAAgB,SAAS,MAAM,CAAC,CAAC;gBAC9D,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBAC5C,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC;gBACrB,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;gBACpC,WAAW,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEhD,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE;aACtB,OAAO,CACN,oEAAoE,CACrE;aACA,GAAG,CAAC,OAAO,CAAoD,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,CAAU,CAAC,CAAC,CAAC;QACjF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAE9D,MAAM,cAAc,GAAa,EAAE,CAAC;QACpC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAChC;;;;;;;;;;;;;;;yCAeiC,CAClC,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,UAAU,CAAC,GAAG,CACZ,CAAC,CAAC,MAAM,EACR,OAAO,EACP,CAAC,CAAC,WAAW,EACb,CAAC,CAAC,WAAW,EACb,CAAC,CAAC,OAAO,CAAC,KAAK,EACf,CAAC,CAAC,OAAO,CAAC,IAAI,EACd,CAAC,CAAC,WAAW,EACb,CAAC,CAAC,SAAS,EACX,CAAC,CAAC,OAAO,EACT,CAAC,CAAC,cAAc,CACjB,CAAC;YACJ,CAAC;YAED,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC;gBAC1B,KAAK,MAAM,MAAM,IAAI,cAAc;oBAAE,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YACvE,CAAC;YAED,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;gBACzB,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5D,IAAI,CAAC,EAAE;qBACJ,OAAO,CAAC,oDAAoD,YAAY,GAAG,CAAC;qBAC5E,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC;gBAEzB,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC9B;wCAC8B,CAC/B,CAAC;gBACF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACxC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;oBAC/B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;wBAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;wBAC5B,IAAI,CAAC,IAAI;4BAAE,SAAS;wBACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;wBACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;4BACzB,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;4BAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gCAAE,SAAS;4BAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;4BACd,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;4BAClD,IAAI,QAAQ,IAAI,IAAI;gCAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;wBAC/D,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,EAAE,EAAE,CAAC;QAEL,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC;YAChB,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAEO,eAAe,CAAC,IAAY,EAAE,IAAY;QAChD,OAAO,UAAU,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;CACF;AAED,SAAS,aAAa,CAAC,KAAe;IACpC,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,MAAM,GAAkB,IAAI,CAAC;QACjC,IAAI,eAAe,GAAkB,IAAI,CAAC;QAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACtC,IAAI,KAAK,KAAK,EAAE;gBAAE,SAAS;YAC3B,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,EAAE,EAAE,CAAC;gBACP,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;gBACvB,eAAe,GAAG,CAAC,CAAC;YACtB,CAAC;YACD,MAAM;QACR,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAyB,EAAE,SAAiB,EAAE,KAAa;IACpF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,SAAS,IAAI,SAAS;YAAE,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC;QACnD,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI,IAAI,CAAC,CAAC,eAAe,IAAI,SAAS,EAAE,CAAC;YACjE,CAAC,CAAC,eAAe,IAAI,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAe,EAAE,QAAyB;IAC/D,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAE,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,MAAM;YAAE,SAAS;QACxB,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK;YAAE,KAAK,CAAC,GAAG,EAAE,CAAC;QAC9E,MAAM,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEd,IAAI,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBAClC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,eAAe,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC;gBACjE,MAAM;YACR,CAAC;QACH,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;QAC9B,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjF,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAChD,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,OAAO,EAAE,CAAC;YACV,WAAW;YACX,WAAW;YACX,SAAS,EAAE,SAAS,GAAG,CAAC;YACxB,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,OAAO;YAChB,WAAW;YACX,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO;SACX,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC;SAChD,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC;SAC/B,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC;SACzB,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC;SACvC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,WAAW,EAAE;SACb,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,SAAS,mBAAmB,CAAC,GAA4C;IACvE,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACnE,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;aAC3B,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/server/services/sections.d.ts

@@ -0,0 +1,34 @@
+import type Database from 'better-sqlite3';
+import type { SectionIndexEntry } from '../../shared/entities.js';
+import type { PagesService } from './pages.js';
+import type { PagesWatcher } from '../fs/watcher.js';
+export interface SectionsListQuery {
+    pagePath?: string;
+    search?: string;
+    limit?: number;
+}
+export interface SectionsServiceWriteDeps {
+    pages: PagesService;
+    watcher: PagesWatcher;
+}
+export declare class SectionsService {
+    private db;
+    private writeDeps;
+    constructor(db: Database.Database);
+    /** Wire write-side dependencies after construction (avoids circular deps with PagesService bootstrap). */
+    setWriteDeps(deps: SectionsServiceWriteDeps): void;
+    getByAnchor(anchor: string): SectionIndexEntry | null;
+    has(anchor: string): boolean;
+    listByPage(pagePath: string): SectionIndexEntry[];
+    list(query?: SectionsListQuery): SectionIndexEntry[];
+    count(): number;
+    /**
+     * Rewrite all `<section_ref anchor="oldAnchor"/>` occurrences across pagesDir to newAnchor.
+     * Atomic per-file with rollback on error. Emits page:changed via watcher suppress on each write.
+     * Page links `@path.md#anchor` (M14) live elsewhere — handled by M14's link rewriter.
+     */
+    propagateAnchorChange(oldAnchor: string, newAnchor: string): Promise<{
+        changed: string[];
+    }>;
+    private hydrate;
+}

package/dist/server/services/sections.js

@@ -0,0 +1,136 @@
+import { parseXmlTags, serializeXmlTag } from '../../shared/xml-tags.js';
+export class SectionsService {
+    db;
+    writeDeps = null;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Wire write-side dependencies after construction (avoids circular deps with PagesService bootstrap). */
+    setWriteDeps(deps) {
+        this.writeDeps = deps;
+    }
+    getByAnchor(anchor) {
+        const row = this.db
+            .prepare('SELECT * FROM section_index WHERE anchor = ?')
+            .get(anchor);
+        return row ? this.hydrate(row) : null;
+    }
+    has(anchor) {
+        const row = this.db
+            .prepare('SELECT 1 AS x FROM section_index WHERE anchor = ? LIMIT 1')
+            .get(anchor);
+        return Boolean(row);
+    }
+    listByPage(pagePath) {
+        const rows = this.db
+            .prepare('SELECT * FROM section_index WHERE page_path = ? ORDER BY line_start')
+            .all(pagePath);
+        return rows.map((r) => this.hydrate(r));
+    }
+    list(query = {}) {
+        const where = [];
+        const params = [];
+        if (query.pagePath) {
+            where.push('page_path = ?');
+            params.push(query.pagePath);
+        }
+        if (query.search) {
+            where.push('(heading_text LIKE ? OR heading_path LIKE ?)');
+            const like = `%${query.search}%`;
+            params.push(like, like);
+        }
+        const whereSql = where.length ? `WHERE ${where.join(' AND ')}` : '';
+        const limit = Math.min(Math.max(query.limit ?? 500, 1), 2000);
+        const rows = this.db
+            .prepare(`SELECT * FROM section_index ${whereSql} ORDER BY page_path, line_start LIMIT ?`)
+            .all(...params, limit);
+        return rows.map((r) => this.hydrate(r));
+    }
+    count() {
+        const row = this.db.prepare('SELECT COUNT(*) AS c FROM section_index').get();
+        return row.c;
+    }
+    /**
+     * Rewrite all `<section_ref anchor="oldAnchor"/>` occurrences across pagesDir to newAnchor.
+     * Atomic per-file with rollback on error. Emits page:changed via watcher suppress on each write.
+     * Page links `@path.md#anchor` (M14) live elsewhere — handled by M14's link rewriter.
+     */
+    async propagateAnchorChange(oldAnchor, newAnchor) {
+        if (oldAnchor === newAnchor)
+            return { changed: [] };
+        if (!this.writeDeps) {
+            throw new Error('SectionsService.propagateAnchorChange requires setWriteDeps to be called');
+        }
+        const { pages, watcher } = this.writeDeps;
+        const changed = [];
+        const backups = new Map();
+        const files = await pages.listMarkdownFiles();
+        for (const rel of files) {
+            const page = await pages.read(rel);
+            const rewritten = rewriteSectionRefAnchor(page.body, oldAnchor, newAnchor);
+            if (rewritten !== page.body) {
+                backups.set(rel, page.body);
+            }
+        }
+        try {
+            for (const [rel, originalBody] of backups) {
+                const current = await pages.read(rel);
+                const newBody = rewriteSectionRefAnchor(current.body, oldAnchor, newAnchor);
+                if (newBody !== current.body) {
+                    watcher.suppress(rel);
+                    await pages.write(rel, { frontmatter: current.frontmatter, body: newBody });
+                    changed.push(rel);
+                }
+                void originalBody;
+            }
+        }
+        catch (err) {
+            for (const [rel, originalBody] of backups) {
+                if (!changed.includes(rel))
+                    continue;
+                const current = await pages.read(rel);
+                watcher.suppress(rel);
+                await pages.write(rel, { frontmatter: current.frontmatter, body: originalBody });
+            }
+            throw err;
+        }
+        return { changed };
+    }
+    hydrate(row) {
+        return {
+            id: row.id,
+            anchor: row.anchor,
+            pagePath: row.page_path,
+            headingPath: row.heading_path,
+            headingSlug: row.heading_slug,
+            headingLevel: row.heading_level,
+            headingText: row.heading_text,
+            contentHash: row.content_hash,
+            lineStart: row.line_start,
+            lineEnd: row.line_end,
+            paragraphCount: row.paragraph_count,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+}
+function rewriteSectionRefAnchor(body, oldAnchor, newAnchor) {
+    const tags = parseXmlTags(body);
+    if (tags.length === 0)
+        return body;
+    let out = '';
+    let cursor = 0;
+    for (const tag of tags) {
+        out += body.slice(cursor, tag.start);
+        if (tag.kind === 'section_ref' && tag.attrs.anchor === oldAnchor) {
+            out += serializeXmlTag('section_ref', { ...tag.attrs, anchor: newAnchor });
+        }
+        else {
+            out += body.slice(tag.start, tag.end);
+        }
+        cursor = tag.end;
+    }
+    out += body.slice(cursor);
+    return out;
+}
+//# sourceMappingURL=sections.js.map

package/dist/server/services/sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.js","sourceRoot":"","sources":["../../../src/server/services/sections.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AA+BzE,MAAM,OAAO,eAAe;IAGN;IAFZ,SAAS,GAAoC,IAAI,CAAC;IAE1D,YAAoB,EAAqB;QAArB,OAAE,GAAF,EAAE,CAAmB;IAAG,CAAC;IAE7C,0GAA0G;IAC1G,YAAY,CAAC,IAA8B;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,WAAW,CAAC,MAAc;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,8CAA8C,CAAC;aACvD,GAAG,CAAC,MAAM,CAA2B,CAAC;QACzC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,2DAA2D,CAAC;aACpE,GAAG,CAAC,MAAM,CAA8B,CAAC;QAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,qEAAqE,CAAC;aAC9E,GAAG,CAAC,QAAQ,CAAiB,CAAC;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,QAA2B,EAAE;QAChC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,+BAA+B,QAAQ,yCAAyC,CAAC;aACzF,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,CAAiB,CAAC;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC,GAAG,EAAmB,CAAC;QAC9F,OAAO,GAAG,CAAC,CAAC,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,qBAAqB,CACzB,SAAiB,EACjB,SAAiB;QAEjB,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE1C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YAC3E,IAAI,SAAS,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,KAAK,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,OAAO,EAAE,CAAC;gBAC1C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACtC,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;gBAC5E,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;oBAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBACtB,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC5E,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC;gBACD,KAAK,YAAY,CAAC;YACpB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,OAAO,EAAE,CAAC;gBAC1C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,SAAS;gBACrC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACtB,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;YACnF,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;IAEO,OAAO,CAAC,GAAe;QAC7B,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,YAAY,EAAE,GAAG,CAAC,aAAa;YAC/B,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,OAAO,EAAE,GAAG,CAAC,QAAQ;YACrB,cAAc,EAAE,GAAG,CAAC,eAAe;YACnC,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,SAAS,EAAE,GAAG,CAAC,UAAU;SAC1B,CAAC;IACJ,CAAC;CACF;AAED,SAAS,uBAAuB,CAAC,IAAY,EAAE,SAAiB,EAAE,SAAiB;IACjF,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjE,GAAG,IAAI,eAAe,CAAC,aAAa,EAAE,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC;IACnB,CAAC;IACD,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/server/services/skill-registry.d.ts

@@ -0,0 +1,38 @@
+import type { InlineSkill } from '@inharness-ai/agent-adapters';
+export type SkillScope = 'writing-style' | 'contextual';
+export interface SkillMetadata {
+    slug: string;
+    title: string;
+    description: string;
+    version: number;
+    language: 'en' | 'pl';
+    scope: SkillScope;
+    path: string;
+}
+export interface ResolvedSkill {
+    metadata: SkillMetadata;
+    content: string;
+    files: Record<string, string>;
+}
+export declare class SkillRegistry {
+    private metadataBySlug;
+    static load(skillsDir: string): SkillRegistry;
+    list(): SkillMetadata[];
+    listSelectable(): SkillMetadata[];
+    has(slug: string): boolean;
+    isSelectable(slug: string): boolean;
+    resolve(slug: string): ResolvedSkill;
+}
+export declare class SkillResolver {
+    private readonly registry;
+    private readonly cwd;
+    constructor(registry: SkillRegistry, cwd: string);
+    /**
+     * Resolved per query — `readConfig` reads `.claude4spec/config.json` from disk
+     * each call, so editing config.json between turns takes effect on the next
+     * `POST /api/chat`. Returns `[]` when no style is active or registry doesn't
+     * know the slug (defensive — startup validation should catch the latter).
+     */
+    resolve(): InlineSkill[];
+}
+export declare function findSkillsDir(): string;