engimcp 1.0.0

package/dist/documents/documentService.js

@@ -0,0 +1,371 @@
+import { access, readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { writeAuditLog } from "../audit/auditLog.js";
+import { EngiMcpError } from "../mcp/errors.js";
+import { assertAbsoluteRoot, isDeniedPathForRoot, resolveSafePath } from "../project/pathSafety.js";
+import { assertNoGitConflictMarkers, assertProjectWritable } from "../project/writeGuards.js";
+import { atomicWrite } from "../utils/atomicWrite.js";
+import { parseFrontmatter, serializeDocument } from "./frontmatter.js";
+import { parseHeadings } from "./headings.js";
+import { patchSection } from "./sectionPatch.js";
+import { loadTemplate } from "./templates.js";
+const ignoredDirectories = new Set([".git", ".engimcp", "node_modules", "dist", "templates"]);
+const relationFields = [
+    "depends_on",
+    "impacts",
+    "satisfies",
+    "verified_by",
+    "verifies",
+    "decided_by",
+    "updates",
+    "supersedes",
+    "relates_to",
+    "blocks",
+    "derives_from"
+];
+export async function discoverMarkdownDocuments(rootInput) {
+    const root = assertAbsoluteRoot(rootInput);
+    const documents = [];
+    async function walk(directory) {
+        const entries = await readdir(directory, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (!ignoredDirectories.has(entry.name)) {
+                    await walk(path.join(directory, entry.name));
+                }
+                continue;
+            }
+            if (!entry.isFile() || !entry.name.endsWith(".md")) {
+                continue;
+            }
+            const absolutePath = path.join(directory, entry.name);
+            const relativePath = path.relative(root, absolutePath);
+            if (await isDeniedPathForRoot(root, relativePath)) {
+                continue;
+            }
+            const content = await readFile(absolutePath, "utf8");
+            const frontmatter = parseFrontmatter(content);
+            const data = frontmatter.data ?? {};
+            documents.push({
+                id: data.id,
+                path: relativePath,
+                absolutePath,
+                kind: data.kind,
+                status: data.status,
+                version: data.version,
+                title: typeof data.title === "string" ? data.title : undefined,
+                summary: typeof data.summary === "string" ? data.summary : undefined,
+                frontmatter: data,
+                headings: parseHeadings(frontmatter.body),
+                frontmatterError: frontmatter.error
+            });
+        }
+    }
+    await walk(root);
+    return documents;
+}
+export async function buildDocumentRegistry(root) {
+    const documents = await discoverMarkdownDocuments(root);
+    const byId = new Map();
+    const byPath = new Map();
+    for (const document of documents) {
+        if (document.id && !byId.has(document.id)) {
+            byId.set(document.id, document);
+        }
+        byPath.set(document.path, document);
+    }
+    return { documents, byId, byPath };
+}
+export async function readDocument(root, input) {
+    const registry = await buildDocumentRegistry(root);
+    const document = resolveDocument(registry, input);
+    const content = await readFile(await resolveSafePath(root, document.path), "utf8");
+    const parsed = parseFrontmatter(content);
+    const mode = input.mode ?? "full";
+    const result = {
+        id: document.id,
+        path: document.path,
+        frontmatter: parsed.data ?? {},
+        links: extractFrontmatterLinks(parsed.data ?? {})
+    };
+    if (mode === "frontmatter") {
+        return result;
+    }
+    if (mode === "headings") {
+        return {
+            ...result,
+            headings: parseHeadings(parsed.body).map(formatHeading)
+        };
+    }
+    if (mode === "summary") {
+        return {
+            ...result,
+            content: document.summary ?? firstParagraph(parsed.body)
+        };
+    }
+    if (mode === "section") {
+        if (!input.heading_path || input.heading_path.length === 0) {
+            throw new EngiMcpError("INVALID_HEADING_PATH", "heading_path is required for section mode.");
+        }
+        return {
+            ...result,
+            content: readSection(parsed.body, input.heading_path)
+        };
+    }
+    return {
+        ...result,
+        content: content,
+        headings: parseHeadings(parsed.body).map(formatHeading)
+    };
+}
+export async function createDocument(input) {
+    const root = path.resolve(input.root);
+    await assertProjectWritable(root);
+    const targetPath = await resolveSafePath(root, input.path);
+    const templateContent = await loadTemplate(root, input.template, input.kind);
+    const parsed = parseFrontmatter(templateContent);
+    const frontmatter = {
+        ...(parsed.data ?? {}),
+        ...(input.frontmatter ?? {}),
+        id: input.id,
+        kind: input.kind
+    };
+    const body = parsed.body.replace(/^# .*(?:\r?\n|$)/, `# ${input.title}\n`);
+    const content = serializeDocument(frontmatter, body);
+    try {
+        await access(targetPath);
+        throw new EngiMcpError("DOCUMENT_EXISTS", `Document already exists: ${input.path}`);
+    }
+    catch (error) {
+        if (error instanceof EngiMcpError) {
+            throw error;
+        }
+    }
+    if (input.dry_run) {
+        return {
+            ok: true,
+            changed: true,
+            path: input.path,
+            id: input.id,
+            diff_summary: "dry run: document would be created",
+            content
+        };
+    }
+    await atomicWrite(targetPath, content);
+    const auditId = await writeAuditLog({
+        root,
+        tool: "engi_doc_create",
+        target: input.id,
+        operation: "create",
+        result: "ok",
+        diff_summary: "document created"
+    });
+    return {
+        ok: true,
+        changed: true,
+        path: input.path,
+        id: input.id,
+        diff_summary: "document created",
+        audit_id: auditId
+    };
+}
+export async function patchDocumentFrontmatter(input) {
+    const root = path.resolve(input.root);
+    await assertProjectWritable(root);
+    const registry = await buildDocumentRegistry(root);
+    const document = resolveDocument(registry, { id: input.id });
+    const original = await readFile(document.absolutePath, "utf8");
+    assertNoGitConflictMarkers(original, document.path);
+    const parsed = parseFrontmatter(original);
+    if (parsed.error) {
+        throw new EngiMcpError("BROKEN_FRONTMATTER", parsed.error);
+    }
+    const nextContent = serializeDocument({ ...(parsed.data ?? {}), ...input.patch }, parsed.body);
+    const diffSummary = summarizeLineDiff(original, nextContent);
+    if (input.dry_run) {
+        return {
+            ok: true,
+            changed: nextContent !== original,
+            path: document.path,
+            id: document.id,
+            diff_summary: diffSummary,
+            content: nextContent
+        };
+    }
+    await atomicWrite(document.absolutePath, nextContent);
+    const auditId = await writeAuditLog({
+        root,
+        tool: "engi_frontmatter_patch",
+        target: input.id,
+        operation: "frontmatter_patch",
+        result: "ok",
+        diff_summary: diffSummary
+    });
+    return {
+        ok: true,
+        changed: nextContent !== original,
+        path: document.path,
+        id: document.id,
+        diff_summary: diffSummary,
+        audit_id: auditId
+    };
+}
+export async function patchDocumentSection(input) {
+    const root = path.resolve(input.root);
+    await assertProjectWritable(root);
+    const registry = await buildDocumentRegistry(root);
+    const document = resolveDocument(registry, { id: input.id });
+    const original = await readFile(document.absolutePath, "utf8");
+    assertNoGitConflictMarkers(original, document.path);
+    const parsed = parseFrontmatter(original);
+    if (parsed.error) {
+        throw new EngiMcpError("BROKEN_FRONTMATTER", parsed.error);
+    }
+    const nextBody = patchSection(parsed.body, {
+        headingPath: input.heading_path,
+        operation: input.operation,
+        content: input.content
+    });
+    const nextContent = serializeDocument(parsed.data ?? {}, nextBody);
+    const diffSummary = summarizeLineDiff(original, nextContent);
+    if (input.dry_run) {
+        return {
+            ok: true,
+            changed: nextContent !== original,
+            path: document.path,
+            id: document.id,
+            diff_summary: diffSummary,
+            content: nextContent
+        };
+    }
+    await atomicWrite(document.absolutePath, nextContent);
+    const auditId = await writeAuditLog({
+        root,
+        tool: "engi_doc_patch_section",
+        target: input.id,
+        operation: input.operation,
+        result: "ok",
+        diff_summary: diffSummary
+    });
+    return {
+        ok: true,
+        changed: nextContent !== original,
+        path: document.path,
+        id: document.id,
+        diff_summary: diffSummary,
+        audit_id: auditId
+    };
+}
+export async function addDocumentRelationship(input) {
+    const root = path.resolve(input.root);
+    const registry = await buildDocumentRegistry(root);
+    const document = resolveDocument(registry, { id: input.id });
+    const current = document.frontmatter[input.relation_type];
+    const existing = Array.isArray(current)
+        ? current.filter((item) => typeof item === "string")
+        : typeof current === "string"
+            ? [current]
+            : [];
+    const next = existing.includes(input.target_id) ? existing : [...existing, input.target_id];
+    return patchDocumentFrontmatter({
+        root,
+        id: input.id,
+        patch: {
+            [input.relation_type]: next
+        },
+        dry_run: input.dry_run
+    });
+}
+export function extractFrontmatterLinks(frontmatter) {
+    return relationFields.flatMap((field) => {
+        const value = frontmatter[field];
+        if (Array.isArray(value)) {
+            return value.filter((item) => typeof item === "string");
+        }
+        return typeof value === "string" ? [value] : [];
+    });
+}
+function resolveDocument(registry, input) {
+    if (input.id) {
+        const document = registry.byId.get(input.id);
+        if (!document) {
+            throw new EngiMcpError("DOCUMENT_NOT_FOUND", `Document id not found: ${input.id}`);
+        }
+        return document;
+    }
+    if (input.path) {
+        const normalizedPath = path.normalize(input.path);
+        const document = registry.byPath.get(normalizedPath);
+        if (!document) {
+            throw new EngiMcpError("DOCUMENT_NOT_FOUND", `Document path not found: ${input.path}`);
+        }
+        return document;
+    }
+    if (input.kind) {
+        const matches = registry.documents
+            .filter((document) => document.kind === input.kind)
+            .sort((left, right) => left.path.localeCompare(right.path));
+        if (matches.length === 0) {
+            throw new EngiMcpError("DOCUMENT_NOT_FOUND", `Document kind not found: ${input.kind}`);
+        }
+        return matches[0];
+    }
+    throw new EngiMcpError("DOCUMENT_SELECTOR_REQUIRED", "Provide document id, path, or kind.");
+}
+function formatHeading(heading) {
+    return `${"#".repeat(heading.level)} ${heading.text}`;
+}
+function firstParagraph(markdown) {
+    return (markdown
+        .split(/\r?\n\r?\n/)
+        .map((part) => part.trim())
+        .find((part) => part.length > 0 && !part.startsWith("#")) ?? "");
+}
+function readSection(markdown, headingPath) {
+    const lines = markdown.split(/\r?\n/);
+    let searchFrom = 0;
+    let currentStart = -1;
+    let currentLevel = 0;
+    for (const heading of headingPath) {
+        let found = false;
+        for (let index = searchFrom; index < lines.length; index += 1) {
+            const match = lines[index]?.match(/^(#{1,6})\s+(.*)$/);
+            if (!match) {
+                continue;
+            }
+            const level = match[1].length;
+            if (currentLevel > 0 && level <= currentLevel) {
+                break;
+            }
+            if (match[2].trim() === heading) {
+                currentStart = index;
+                currentLevel = level;
+                searchFrom = index + 1;
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            throw new EngiMcpError("SECTION_NOT_FOUND", `Section not found: ${heading}`);
+        }
+    }
+    let end = lines.length;
+    for (let index = currentStart + 1; index < lines.length; index += 1) {
+        const match = lines[index]?.match(/^(#{1,6})\s+/);
+        if (match && match[1].length <= currentLevel) {
+            end = index;
+            break;
+        }
+    }
+    return lines.slice(currentStart, end).join("\n");
+}
+function summarizeLineDiff(before, after) {
+    if (before === after) {
+        return "no changes";
+    }
+    const beforeLineCount = before.split(/\r?\n/).length;
+    const afterLineCount = after.split(/\r?\n/).length;
+    const delta = afterLineCount - beforeLineCount;
+    return delta === 0 ? "content changed" : `${Math.abs(delta)} line count delta`;
+}
+//# sourceMappingURL=documentService.js.map

package/dist/documents/documentService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentService.js","sourceRoot":"","sources":["../../src/documents/documentService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAgB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,YAAY,EAA8B,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoF9C,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAC9F,MAAM,cAAc,GAAG;IACrB,YAAY;IACZ,SAAS;IACT,WAAW;IACX,aAAa;IACb,UAAU;IACV,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,QAAQ;IACR,cAAc;CACf,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,SAAiB;IAC/D,MAAM,IAAI,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAsB,EAAE,CAAC;IAExC,KAAK,UAAU,IAAI,CAAC,SAAiB;QACnC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAElE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC/C,CAAC;gBACD,SAAS;YACX,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnD,SAAS;YACX,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACvD,IAAI,MAAM,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;gBAClD,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACrD,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC;YAEpC,SAAS,CAAC,IAAI,CAAC;gBACb,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,IAAI,EAAE,YAAY;gBAClB,YAAY;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAC9D,OAAO,EAAE,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACpE,WAAW,EAAE,IAAI;gBACjB,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC;gBACzC,gBAAgB,EAAE,WAAW,CAAC,KAAK;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY;IACtD,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,GAAG,EAA2B,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAElD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,KAAwB;IAExB,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IACnF,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC;IAElC,MAAM,MAAM,GAAuB;QACjC,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,WAAW,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;QAC9B,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;KAClD,CAAC;IAEF,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO;YACL,GAAG,MAAM;YACT,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO;YACL,GAAG,MAAM;YACT,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,YAAY,CAAC,sBAAsB,EAAE,4CAA4C,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO;YACL,GAAG,MAAM;YACT,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC;SACtD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAA0B;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG;QAClB,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACtB,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzB,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,4BAA4B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;YAClC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,YAAY,EAAE,oCAAoC;YAClD,OAAO;SACR,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC;QAClC,IAAI;QACJ,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,KAAK,CAAC,EAAE;QAChB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,kBAAkB;KACjC,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,YAAY,EAAE,kBAAkB;QAChC,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA4B;IAE5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC/D,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE1C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/F,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAE7D,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,WAAW,KAAK,QAAQ;YACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,YAAY,EAAE,WAAW;YACzB,OAAO,EAAE,WAAW;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,CAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC;QAClC,IAAI;QACJ,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,KAAK,CAAC,EAAE;QAChB,SAAS,EAAE,mBAAmB;QAC9B,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,WAAW;KAC1B,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,WAAW,KAAK,QAAQ;QACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,YAAY,EAAE,WAAW;QACzB,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAgC;IAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC/D,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE1C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE;QACzC,WAAW,EAAE,KAAK,CAAC,YAAY;QAC/B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAE7D,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,WAAW,KAAK,QAAQ;YACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,YAAY,EAAE,WAAW;YACzB,OAAO,EAAE,WAAW;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,CAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC;QAClC,IAAI;QACJ,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,KAAK,CAAC,EAAE;QAChB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,WAAW;KAC1B,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,WAAW,KAAK,QAAQ;QACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,YAAY,EAAE,WAAW;QACzB,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAA2B;IAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACrC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QACpE,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ;YAC3B,CAAC,CAAC,CAAC,OAAO,CAAC;YACX,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAE5F,OAAO,wBAAwB,CAAC;QAC9B,IAAI;QACJ,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE;YACL,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,IAAI;SAC5B;QACD,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAoC;IAC1E,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,QAA0B,EAAE,KAAwB;IAC3E,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,0BAA0B,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,4BAA4B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS;aAC/B,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;aAClD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,4BAA4B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,CAAoB,CAAC;IACvC,CAAC;IAED,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,qCAAqC,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,aAAa,CAAC,OAAgB;IACrC,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,CACL,QAAQ;SACL,KAAK,CAAC,YAAY,CAAC;SACnB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAClE,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,WAAqB;IAC1D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;IACtB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,KAAK,IAAI,KAAK,GAAG,UAAU,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACvD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC9B,IAAI,YAAY,GAAG,CAAC,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;gBAC9C,MAAM;YACR,CAAC;YACD,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;gBAChC,YAAY,GAAG,KAAK,CAAC;gBACrB,YAAY,GAAG,KAAK,CAAC;gBACrB,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC;gBACvB,KAAK,GAAG,IAAI,CAAC;gBACb,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,YAAY,CAAC,mBAAmB,EAAE,sBAAsB,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,KAAK,IAAI,KAAK,GAAG,YAAY,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QAClD,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;YAC7C,GAAG,GAAG,KAAK,CAAC;YACZ,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc,EAAE,KAAa;IACtD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACnD,MAAM,KAAK,GAAG,cAAc,GAAG,eAAe,CAAC;IAE/C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC;AACjF,CAAC"}

package/dist/documents/frontmatter.d.ts

@@ -0,0 +1,14 @@
+export interface FrontmatterData {
+    id?: string;
+    kind?: string;
+    status?: string;
+    version?: string;
+    [key: string]: unknown;
+}
+export interface ParsedFrontmatter {
+    data?: FrontmatterData;
+    body: string;
+    error?: string;
+}
+export declare function parseFrontmatter(content: string): ParsedFrontmatter;
+export declare function serializeDocument(frontmatter: Record<string, unknown>, body: string): string;

package/dist/documents/frontmatter.js

@@ -0,0 +1,30 @@
+import { parse } from "yaml";
+import { stringify } from "yaml";
+export function parseFrontmatter(content) {
+    if (!content.startsWith("---\n")) {
+        return { body: content };
+    }
+    const closingDelimiter = content.match(/\n---\s*(?:\r?\n|$)/);
+    if (!closingDelimiter?.index) {
+        return {
+            body: content,
+            error: "Missing closing frontmatter delimiter."
+        };
+    }
+    const raw = content.slice(4, closingDelimiter.index);
+    const body = content.slice(closingDelimiter.index + closingDelimiter[0].length);
+    try {
+        const parsed = parse(raw);
+        return { data: parsed ?? {}, body };
+    }
+    catch (error) {
+        return {
+            body,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+export function serializeDocument(frontmatter, body) {
+    return `---\n${stringify(frontmatter).trimEnd()}\n---\n\n${body.trimStart()}`;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/documents/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/documents/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAgBjC,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC9D,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,wCAAwC;SAChD,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAEhF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAA2B,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI;YACJ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAoC,EAAE,IAAY;IAClF,OAAO,QAAQ,SAAS,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,YAAY,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;AAChF,CAAC"}

package/dist/documents/headings.d.ts

@@ -0,0 +1,6 @@
+export interface Heading {
+    level: number;
+    text: string;
+    line: number;
+}
+export declare function parseHeadings(markdown: string): Heading[];

package/dist/documents/headings.js

@@ -0,0 +1,15 @@
+export function parseHeadings(markdown) {
+    return markdown
+        .split(/\r?\n/)
+        .map((line, index) => ({ line, index }))
+        .filter(({ line }) => /^#{1,6}\s+/.test(line))
+        .map(({ line, index }) => {
+        const marker = line.match(/^#{1,6}/)?.[0] ?? "#";
+        return {
+            level: marker.length,
+            text: line.slice(marker.length).trim(),
+            line: index + 1
+        };
+    });
+}
+//# sourceMappingURL=headings.js.map

package/dist/documents/headings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headings.js","sourceRoot":"","sources":["../../src/documents/headings.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,QAAQ;SACZ,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SACvC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC7C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACjD,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;YACtC,IAAI,EAAE,KAAK,GAAG,CAAC;SAChB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/documents/markdownParser.d.ts

@@ -0,0 +1,2 @@
+export { parseFrontmatter } from "./frontmatter.js";
+export { parseHeadings } from "./headings.js";

package/dist/documents/markdownParser.js

@@ -0,0 +1,3 @@
+export { parseFrontmatter } from "./frontmatter.js";
+export { parseHeadings } from "./headings.js";
+//# sourceMappingURL=markdownParser.js.map

package/dist/documents/markdownParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownParser.js","sourceRoot":"","sources":["../../src/documents/markdownParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/documents/sectionPatch.d.ts

@@ -0,0 +1,7 @@
+export type SectionPatchOperation = "replace" | "append" | "prepend" | "insert_after";
+export interface SectionPatchInput {
+    headingPath: string[];
+    operation: SectionPatchOperation;
+    content: string;
+}
+export declare function patchSection(markdown: string, input: SectionPatchInput): string;

package/dist/documents/sectionPatch.js

@@ -0,0 +1,73 @@
+import { EngiMcpError } from "../mcp/errors.js";
+export function patchSection(markdown, input) {
+    const lines = markdown.split(/\r?\n/);
+    const range = findSectionRange(lines, input.headingPath);
+    const existing = lines.slice(range.start, range.end).join("\n");
+    const nextSection = applyOperation(existing, input);
+    return [
+        ...lines.slice(0, range.start),
+        ...nextSection.split(/\r?\n/),
+        ...lines.slice(range.end)
+    ].join("\n");
+}
+function applyOperation(existing, input) {
+    if (input.operation === "replace") {
+        return input.content.trimEnd();
+    }
+    if (input.operation === "append") {
+        return `${existing.trimEnd()}\n\n${input.content.trimEnd()}`;
+    }
+    if (input.operation === "prepend") {
+        const [heading, ...body] = existing.split(/\r?\n/);
+        return `${heading}\n\n${input.content.trimEnd()}\n${body.join("\n").trimStart()}`;
+    }
+    return `${existing.trimEnd()}\n\n${input.content.trimEnd()}`;
+}
+function findSectionRange(lines, headingPath) {
+    if (headingPath.length === 0) {
+        throw new EngiMcpError("INVALID_HEADING_PATH", "Heading path must not be empty.");
+    }
+    let searchFrom = 0;
+    let current;
+    for (const heading of headingPath) {
+        current = findNextHeading(lines, heading, searchFrom, current?.level);
+        searchFrom = current.start + 1;
+    }
+    if (!current) {
+        throw new EngiMcpError("SECTION_NOT_FOUND", "Section not found.");
+    }
+    return {
+        ...current,
+        end: findSectionEnd(lines, current.start, current.level)
+    };
+}
+function findNextHeading(lines, text, start, parentLevel) {
+    for (let index = start; index < lines.length; index += 1) {
+        const match = lines[index]?.match(/^(#{1,6})\s+(.*)$/);
+        if (!match) {
+            continue;
+        }
+        const level = match[1].length;
+        if (parentLevel !== undefined && level <= parentLevel) {
+            break;
+        }
+        if (match[2].trim() === text) {
+            return {
+                start: index,
+                end: lines.length,
+                level
+            };
+        }
+    }
+    throw new EngiMcpError("SECTION_NOT_FOUND", `Section not found: ${text}`);
+}
+function findSectionEnd(lines, start, level) {
+    for (let index = start + 1; index < lines.length; index += 1) {
+        const match = lines[index]?.match(/^(#{1,6})\s+/);
+        if (match && match[1].length <= level) {
+            return index;
+        }
+    }
+    return lines.length;
+}
+//# sourceMappingURL=sectionPatch.js.map

package/dist/documents/sectionPatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sectionPatch.js","sourceRoot":"","sources":["../../src/documents/sectionPatch.ts"],"names":[],"mappings":"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"}

package/dist/documents/templates.d.ts

@@ -0,0 +1 @@
+export declare function loadTemplate(root: string, template: string, kind: string): Promise<string>;

package/dist/documents/templates.js

@@ -0,0 +1,62 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+const builtInTemplates = {
+    design_doc: `---
+id: DOC-EXAMPLE
+kind: design_doc
+status: draft
+version: 0.1.0
+---
+
+# Document Title
+
+## Purpose
+
+## Requirements
+
+## Current Solution
+
+## Calculations / Arguments
+
+## Risks
+
+## Related Documents
+`,
+    requirement: `---
+id: FR-000
+kind: requirement
+status: draft
+version: 0.1.0
+---
+
+# Requirement Title
+`,
+    edr: `---
+id: EDR-0000
+kind: decision
+status: proposed
+version: 0.1.0
+---
+
+# Decision Title
+`,
+    task: `---
+id: TASK-0000
+kind: task
+status: todo
+version: 0.1.0
+---
+
+# Task Title
+`
+};
+export async function loadTemplate(root, template, kind) {
+    const localTemplatePath = path.join(root, "templates", `${template}.md`);
+    try {
+        return await readFile(localTemplatePath, "utf8");
+    }
+    catch {
+        return builtInTemplates[template] ?? builtInTemplates[kind] ?? builtInTemplates.design_doc;
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/documents/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/documents/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,gBAAgB,GAA2B;IAC/C,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;CAoBb;IACC,WAAW,EAAE;;;;;;;;CAQd;IACC,GAAG,EAAE;;;;;;;;CAQN;IACC,IAAI,EAAE;;;;;;;;CAQP;CACA,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB,EAAE,IAAY;IAC7E,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,QAAQ,KAAK,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC;IAC7F,CAAC;AACH,CAAC"}