frontier-mcp 0.1.0

package/dist/storage/markdown/driver.js

@@ -0,0 +1,492 @@
+import { mkdir, readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { NoSuchEffort, NoSuchMap, NoSuchSpec, NoSuchTicket, RevisionMismatch } from '../driver.js';
+import { createTicketFiles } from './create.js';
+import { migrateEffortFiles } from './migrate.js';
+import { applyEdit } from './serialize.js';
+import { currentRevision, GuardHeld, withGuard, writeAtomically } from './write.js';
+import { applyMapEdit, readMapDocument, readSection, readSpecOpening, scaffoldMap, SECTION_HEADINGS, } from './header-doc.js';
+import { parseTicket } from './ticket.js';
+/**
+ * The layout this driver serves, per AGENTS.md:
+ *
+ *   .scratch/<effort>/
+ *   ├── map.md            # Header doc — wayfinder
+ *   ├── spec.md           # Header doc — to-spec
+ *   └── issues/
+ *       └── NN-slug.md    # Tickets
+ *
+ * Anything else in an Effort directory is ignored, never an error.
+ */
+const SCRATCH_DIR = '.scratch';
+const ISSUES_DIR = 'issues';
+const MAP_FILE = 'map.md';
+const SPEC_FILE = 'spec.md';
+const HEADER_DOCS = [
+    ['map', MAP_FILE],
+    ['spec', SPEC_FILE],
+];
+/**
+ * The markdown driver — the only driver in v1. Bound to `root`, the resolved
+ * workspace, so that no path crosses the {@link StorageDriver} interface.
+ */
+export function createMarkdownDriver(root) {
+    const scratch = join(root, SCRATCH_DIR);
+    let writes = Promise.resolve();
+    const walk = async () => {
+        // A repo that has never used the tracker is a supported starting state,
+        // not an error: it simply holds no Efforts.
+        const slugs = await readDirectories(scratch);
+        const scanned = await Promise.all(slugs.map(slug => readEffort(scratch, slug)));
+        return scanned
+            .filter((entry) => entry !== undefined)
+            .toSorted((a, b) => a.effort.slug.localeCompare(b.effort.slug));
+    };
+    /**
+     * Both methods are always called together to build one index, and each walk
+     * reads every `issues/` directory. Sharing the in-flight walk makes that one
+     * pass instead of two.
+     *
+     * The share lasts only as long as the walk itself — the driver holds no
+     * results, because deciding when a scan is stale belongs to the index above
+     * it and to the watcher T8 attaches there.
+     */
+    let inFlight;
+    const scan = () => {
+        inFlight ??= walk().finally(() => {
+            inFlight = undefined;
+        });
+        return inFlight;
+    };
+    return {
+        async listEfforts() {
+            return (await scan()).map(entry => entry.effort);
+        },
+        async listTickets() {
+            return (await scan()).flatMap(entry => entry.tickets);
+        },
+        updateTicket(handle, edit, expectedRevision) {
+            return serialized(() => write(scratch, handle, edit, expectedRevision));
+        },
+        createTickets(effort, drafts, options) {
+            // The scan is deliberately not the shared one: allocation re-reads under
+            // its own guards, and an in-flight walk started before them would defeat
+            // the check it exists to make.
+            return serialized(() => create(scratch, effort, drafts, options, walk));
+        },
+        readMap(effort) {
+            return serialized(() => loadMap(scratch, effort));
+        },
+        editMap(effort, edit, expectedRevision, options) {
+            return serialized(() => saveMap(scratch, effort, edit, expectedRevision, options));
+        },
+        readSpec(effort) {
+            return serialized(() => loadSpec(scratch, effort));
+        },
+        putSpec(effort, body, expectedRevision, options) {
+            return serialized(() => saveSpec(scratch, effort, body, expectedRevision, options));
+        },
+        migrateEffort(effort, options) {
+            return serialized(() => migrate(scratch, effort, options, walk));
+        },
+    };
+    /**
+     * Writes are serialized per workspace. Two calls racing on one Ticket would
+     * otherwise both pass the revision check before either renamed, and the
+     * loser's edit would be lost rather than refused. The queue is in-memory and
+     * dies with the process — no lock file can outlive a crash.
+     *
+     * Queueing continues after a failure: one refused write must not stop the next.
+     */
+    function serialized(operation) {
+        const next = writes.then(operation, operation);
+        writes = next.catch(() => undefined);
+        return next;
+    }
+}
+async function migrate(scratch, effort, options, walk) {
+    const dir = join(scratch, effort);
+    if ((await readEffort(scratch, effort)) === undefined)
+        throw new NoSuchEffort(effort);
+    const entries = await readTicketFiles(dir, effort);
+    const allTickets = (await walk()).flatMap(entry => entry.tickets);
+    const issues = join(dir, ISSUES_DIR);
+    return migrateEffortFiles({
+        scratch,
+        effort,
+        issues,
+        entries,
+        allTickets,
+        preview: options.preview,
+        rename: options.rename,
+        // Allocation must not share a walk started before the guards — same reason
+        // createTickets builds its own rescan.
+        rescan: async () => (await walk()).flatMap(entry => entry.tickets),
+        readContents: filename => readFile(join(issues, filename), 'utf8'),
+    });
+}
+async function create(scratch, effort, drafts, options, walk) {
+    const dir = join(scratch, effort);
+    const missing = (await readEffort(scratch, effort)) === undefined;
+    if (missing && !options.createEffort)
+        throw new NoSuchEffort(effort);
+    // The directory is made inside, after validation — an Effort created here and
+    // then refused would show up in list_efforts as an empty one nobody asked for.
+    const filenames = await createTicketFiles({
+        scratch,
+        effort,
+        dir,
+        issues: join(dir, ISSUES_DIR),
+        drafts,
+        rescan: async () => (await walk()).flatMap(entry => entry.tickets),
+        validate: options.validate ?? (() => { }),
+        createEffort: missing,
+    });
+    const written = await readTicketFiles(dir, effort);
+    const byFilename = new Map(written.map(entry => [entry.filename, entry.ticket]));
+    return filenames.map(filename => {
+        const ticket = byFilename.get(filename);
+        if (ticket === undefined)
+            throw new Error(`${filename} was written but could not be read back.`);
+        return ticket;
+    });
+}
+async function write(scratch, handle, edit, expectedRevision) {
+    const located = await locate(scratch, handle);
+    if (located === undefined)
+        throw new NoSuchTicket(handle);
+    const { dir, effort, filename, ticket } = located;
+    const path = join(dir, ISSUES_DIR, filename);
+    // The index that produced expectedRevision may be stale, so the check is
+    // against the file as it is right now, immediately before the write.
+    if ((await currentRevision(path)) !== expectedRevision)
+        throw new RevisionMismatch(handle);
+    const contents = await readFile(path, 'utf8');
+    const updated = applyEdit(contents, edit, defaultsFor(ticket));
+    try {
+        await withGuard(path, expectedRevision, async () => {
+            // Re-check inside the guard: holding it means nobody else can be writing
+            // this revision, so a mismatch now is a genuinely earlier write.
+            if ((await currentRevision(path)) !== expectedRevision)
+                throw new RevisionMismatch(handle);
+            await writeAtomically(path, updated);
+        });
+    }
+    catch (error) {
+        // Losing the guard and losing the revision race mean the same thing to a
+        // caller: somebody else got there first, and nothing of theirs was touched.
+        if (error instanceof GuardHeld)
+            throw new RevisionMismatch(handle);
+        throw error;
+    }
+    const written = (await readTicketFiles(dir, effort)).find(entry => entry.filename === filename)?.ticket;
+    if (written === undefined)
+        throw new NoSuchTicket(handle);
+    // Resolving or dropping moves what the Map's derived blocks must show. Refresh
+    // them here so a session that never touches edit_map still leaves the file
+    // truthful for a human reading it on GitHub. Best-effort: the Ticket Status is
+    // already on disk, so a refresh failure must not make the lifecycle change look
+    // like it failed — the Map catches up on a later successful refresh or edit.
+    const warnings = [];
+    if (edit.status === 'resolved' || edit.status === 'dropped') {
+        try {
+            await refreshMapDerived(scratch, effort);
+        }
+        catch {
+            warnings.push('Decisions-so-far / dropped Out-of-scope may be stale — Map derived refresh failed after the Ticket write.');
+        }
+    }
+    return { ticket: written, warnings };
+}
+async function loadMap(scratch, effort) {
+    const path = join(scratch, effort, MAP_FILE);
+    const revision = await currentRevision(path);
+    if (revision === undefined)
+        throw new NoSuchMap(effort);
+    return readMapDocument(await readFile(path, 'utf8'), revision);
+}
+async function saveMap(scratch, effort, edit, expectedRevision, options) {
+    const dir = join(scratch, effort);
+    const path = join(dir, MAP_FILE);
+    const current = await currentRevision(path);
+    const handle = `map:${effort}`;
+    if (current === undefined) {
+        // createEffort only guards starting a new Effort. An Effort that already
+        // holds a Spec or issues/ must be able to gain a Map without that flag —
+        // that is wayfinder's handoff, not a mistyped slug.
+        if ((await readEffort(scratch, effort)) === undefined && !options.createEffort) {
+            throw new NoSuchEffort(effort);
+        }
+        await mkdir(join(dir, ISSUES_DIR), { recursive: true });
+        const entries = await readTicketFiles(dir, effort);
+        const seeded = applyMapEdit(scaffoldMap(edit), {}, ticketPointers(entries, 'resolved'), ticketPointers(entries, 'dropped'));
+        await writeAtomically(path, seeded);
+        return readMapDocument(seeded, await requireRevision(path));
+    }
+    if (expectedRevision === undefined || current !== expectedRevision) {
+        throw new RevisionMismatch(handle);
+    }
+    const contents = await readFile(path, 'utf8');
+    const entries = await readTicketFiles(dir, effort);
+    const updated = applyMapEdit(contents, edit, ticketPointers(entries, 'resolved'), ticketPointers(entries, 'dropped'));
+    await guardedWrite(path, current, updated, handle);
+    return readMapDocument(updated, await requireRevision(path));
+}
+/**
+ * How many times a resolve/drop may re-read and rewrite the Map's derived
+ * blocks when a parallel edit_map holds the guard. This path is server-owned
+ * regeneration, not a caller CAS — swallowing GuardHeld left Decisions stale
+ * when the winner had scanned Tickets before the resolve landed.
+ */
+const DERIVED_REFRESH_ATTEMPTS = 16;
+/**
+ * Rewrite the Map's generated blocks from the Effort's Tickets. No-op when the
+ * Effort has no Map — a Spec-only Effort has nowhere to put them.
+ *
+ * Retries on GuardHeld / lost revision: re-read Map + Tickets and regenerate.
+ * Invents the GENERATED-bearing headings when absent so a slim Map still gets
+ * a truthful Decisions / Out-of-scope cache after resolve or drop.
+ */
+async function refreshMapDerived(scratch, effort) {
+    return refreshMapDerivedOnce(scratch, effort, DERIVED_REFRESH_ATTEMPTS);
+}
+async function refreshMapDerivedOnce(scratch, effort, remaining) {
+    const path = join(scratch, effort, MAP_FILE);
+    const revision = await currentRevision(path);
+    if (revision === undefined)
+        return;
+    const contents = await readFile(path, 'utf8');
+    const entries = await readTicketFiles(join(scratch, effort), effort);
+    const updated = applyMapEdit(contents, {}, ticketPointers(entries, 'resolved'), ticketPointers(entries, 'dropped'), { ensureDerivedSections: true });
+    if (updated === contents)
+        return;
+    try {
+        await withGuard(path, revision, async () => {
+            if ((await currentRevision(path)) !== revision) {
+                throw new DerivedRefreshLost();
+            }
+            await writeAtomically(path, updated);
+        });
+    }
+    catch (error) {
+        // Server-owned derived regeneration may retry; caller CAS mismatches never do.
+        if (!(error instanceof GuardHeld || error instanceof DerivedRefreshLost))
+            throw error;
+        if (remaining <= 1) {
+            throw new Error(`Could not refresh Map derived blocks for ${effort} after concurrent edits.`, { cause: error });
+        }
+        await new Promise(wait => setTimeout(wait, 10));
+        return refreshMapDerivedOnce(scratch, effort, remaining - 1);
+    }
+}
+/** Internal signal: another writer changed the Map while we held its guard. */
+class DerivedRefreshLost extends Error {
+    constructor() {
+        super('Map revision changed during derived refresh');
+        this.name = 'DerivedRefreshLost';
+    }
+}
+async function loadSpec(scratch, effort) {
+    const path = join(scratch, effort, SPEC_FILE);
+    const revision = await currentRevision(path);
+    if (revision === undefined)
+        throw new NoSuchSpec(effort);
+    return { body: await readFile(path, 'utf8'), revision };
+}
+async function saveSpec(scratch, effort, body, expectedRevision, options) {
+    const dir = join(scratch, effort);
+    const path = join(dir, SPEC_FILE);
+    const current = await currentRevision(path);
+    const handle = `spec:${effort}`;
+    // Opaque bytes — store what the caller sent. No BOM strip, no trailing
+    // newline inject, no frontmatter reshape (ADR 0001; Spec has no typed body).
+    if (current === undefined) {
+        // Same rule as Maps: createEffort starts an Effort; putting a Spec onto an
+        // Effort that already has a Map needs no flag.
+        if ((await readEffort(scratch, effort)) === undefined && !options.createEffort) {
+            throw new NoSuchEffort(effort);
+        }
+        await mkdir(join(dir, ISSUES_DIR), { recursive: true });
+        await writeAtomically(path, body);
+        return { body, revision: await requireRevision(path) };
+    }
+    if (expectedRevision === undefined || current !== expectedRevision) {
+        throw new RevisionMismatch(handle);
+    }
+    await guardedWrite(path, current, body, handle);
+    return { body, revision: await requireRevision(path) };
+}
+async function guardedWrite(path, revision, contents, handle) {
+    try {
+        await withGuard(path, revision, async () => {
+            if ((await currentRevision(path)) !== revision)
+                throw new RevisionMismatch(handle);
+            await writeAtomically(path, contents);
+        });
+    }
+    catch (error) {
+        if (error instanceof GuardHeld)
+            throw new RevisionMismatch(handle);
+        throw error;
+    }
+}
+async function requireRevision(path) {
+    const revision = await currentRevision(path);
+    if (revision === undefined) {
+        throw new Error(`Wrote ${path} but could not read its revision back.`);
+    }
+    return revision;
+}
+function ticketPointers(entries, status) {
+    return entries.flatMap(entry => {
+        const { ticket, filename } = entry;
+        if (ticket.status !== status || ticket.id === undefined)
+            return [];
+        const gist = status === 'resolved' ? ticket.answerGist : ticket.droppedReason;
+        return [
+            {
+                id: ticket.id,
+                title: ticket.title,
+                link: `${ISSUES_DIR}/${filename}`,
+                gist: gist ?? '',
+            },
+        ];
+    });
+}
+/** Find the file backing a Ticket, by id or by its `<effort>#<order>` handle. */
+async function locate(scratch, handle) {
+    const slugs = await readDirectories(scratch);
+    const perEffort = await Promise.all(slugs.map(async (slug) => ({ slug, entries: await readTicketFiles(join(scratch, slug), slug) })));
+    for (const { slug, entries } of perEffort) {
+        const found = entries.find(entry => entry.ticket.id === handle || entry.ticket.handle === handle);
+        if (found !== undefined) {
+            return {
+                dir: join(scratch, slug),
+                effort: slug,
+                filename: found.filename,
+                ticket: found.ticket,
+            };
+        }
+    }
+    return undefined;
+}
+function defaultsFor(ticket) {
+    return {
+        id: ticket.id,
+        title: ticket.title,
+        kind: ticket.kind,
+        type: ticket.type,
+        status: ticket.status,
+        triage: ticket.triage,
+        blockedBy: ticket.blockedBy,
+    };
+}
+/**
+ * Every Ticket in one Effort with the file behind it, in sort order. Paths never
+ * cross the driver interface, so this pairing stays inside the driver — it is
+ * how a write finds the file a Ticket came from.
+ */
+async function readTicketFiles(dir, effort) {
+    const issues = join(dir, ISSUES_DIR);
+    const entries = await readDir(issues);
+    const filenames = entries
+        .filter(entry => entry.isFile() && entry.name.endsWith('.md'))
+        .map(entry => entry.name)
+        .toSorted();
+    const parsed = await Promise.all(filenames.map(async (filename, position) => {
+        const path = join(issues, filename);
+        const [contents, revision] = await Promise.all([
+            readFile(path, 'utf8'),
+            currentRevision(path),
+        ]);
+        // A file with no `NN-` prefix still needs a position; its place in the
+        // sorted listing is the only order it has.
+        return {
+            filename,
+            ticket: parseTicket(effort, { filename, contents }, position + 1, revision ?? ''),
+        };
+    }));
+    return withUniqueHandles(parsed.toSorted((a, b) => a.ticket.order - b.ticket.order));
+}
+/** Every Ticket in one Effort, in sort order. A missing `issues/` yields none. */
+async function readTickets(dir, effort) {
+    return (await readTicketFiles(dir, effort)).map(entry => entry.ticket);
+}
+/**
+ * Two files can share an `NN-` prefix, which would give two id-less Tickets the
+ * same `<effort>#<order>` handle and make one of them unfetchable. Later
+ * collisions get a suffix, so every Ticket stays individually addressable.
+ */
+function withUniqueHandles(entries) {
+    const seen = new Set();
+    return entries.map(entry => {
+        const { ticket } = entry;
+        if (!seen.has(ticket.handle)) {
+            seen.add(ticket.handle);
+            return entry;
+        }
+        let suffix = 2;
+        while (seen.has(`${ticket.handle}.${String(suffix)}`))
+            suffix += 1;
+        const handle = `${ticket.handle}.${String(suffix)}`;
+        seen.add(handle);
+        return { filename: entry.filename, ticket: { ...ticket, handle } };
+    });
+}
+/**
+ * A directory under `.scratch/` is an Effort only once it holds something the
+ * schema recognizes — a Header doc or an `issues/` directory. `.scratch/` is
+ * also where these repos keep loose scratch output, and a directory of research
+ * notes is not an empty Effort.
+ */
+async function readEffort(scratch, slug) {
+    const dir = join(scratch, slug);
+    const entries = await readDir(dir);
+    const files = new Set(entries.filter(entry => entry.isFile()).map(entry => entry.name));
+    const headerDocs = HEADER_DOCS.filter(([, filename]) => files.has(filename)).map(([doc]) => doc);
+    const hasIssues = entries.some(entry => entry.isDirectory() && entry.name === ISSUES_DIR);
+    if (headerDocs.length === 0 && !hasIssues)
+        return undefined;
+    const [tickets, destination, specOpening] = await Promise.all([
+        readTickets(dir, slug),
+        headerDocs.includes('map')
+            ? readText(join(dir, 'map.md')).then(contents => readSection(contents, SECTION_HEADINGS.destination))
+            : undefined,
+        headerDocs.includes('spec') ? readText(join(dir, 'spec.md')).then(readSpecOpening) : undefined,
+    ]);
+    return {
+        effort: { slug, headerDocs, ticketCount: tickets.length, destination, specOpening },
+        tickets,
+    };
+}
+/** A file that vanished between the scan and the read is read as empty, not as a failure. */
+async function readText(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (isMissing(error))
+            return '';
+        throw error;
+    }
+}
+async function readDirectories(dir) {
+    const entries = await readDir(dir);
+    return entries.filter(entry => entry.isDirectory()).map(entry => entry.name);
+}
+/** A missing directory reads as empty — the layout is optional at every level. */
+async function readDir(dir) {
+    try {
+        return await readdir(dir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isMissing(error))
+            return [];
+        throw error;
+    }
+}
+function isMissing(error) {
+    const code = error?.code;
+    return code === 'ENOENT' || code === 'ENOTDIR';
+}
+//# sourceMappingURL=driver.js.map

package/dist/storage/markdown/driver.js.map

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

package/dist/storage/markdown/frontmatter.d.ts

@@ -0,0 +1,17 @@
+export interface Split {
+    /**
+     * Whether the file opened with a `---` fence at all. Distinct from
+     * {@link Split.fields} being undefined, which also happens when a fence is
+     * present but its YAML will not parse — a write must normalize that file
+     * rather than treat the fence as body prose and duplicate it.
+     */
+    readonly hasFence: boolean;
+    /** The fence's raw YAML, unparsed. Undefined when there was no fence. */
+    readonly raw: string | undefined;
+    /** The parsed frontmatter, or undefined when there is none or it is malformed. */
+    readonly fields: Record<string, unknown> | undefined;
+    /** Everything after the fence, verbatim. The whole file when there is none. */
+    readonly body: string;
+}
+export declare function splitFrontmatter(contents: string): Split;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/storage/markdown/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/storage/markdown/frontmatter.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,KAAK;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACrD,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAYxD"}

package/dist/storage/markdown/frontmatter.js

@@ -0,0 +1,36 @@
+import { parse } from 'yaml';
+/**
+ * The `---` fence split, which is all a frontmatter library would have given us.
+ * Per ADR 0003 the writes in T3 mutate a parsed YAML document rather than
+ * re-emitting an object, so this file deliberately stops at splitting.
+ */
+const FENCE = /^---\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/;
+export function splitFrontmatter(contents) {
+    const match = FENCE.exec(contents);
+    if (match?.[1] === undefined) {
+        return { hasFence: false, raw: undefined, fields: undefined, body: contents };
+    }
+    return {
+        hasFence: true,
+        raw: match[1],
+        fields: parseFields(match[1]),
+        body: contents.slice(match[0].length),
+    };
+}
+/**
+ * Reads are lenient: frontmatter that is not a YAML mapping — malformed, or a
+ * scalar, or a list — reads as no frontmatter at all, and the file falls through
+ * to the Legacy parser rather than failing the whole scan.
+ */
+function parseFields(yaml) {
+    try {
+        const parsed = parse(yaml);
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/storage/markdown/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../src/storage/markdown/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B;;;;GAIG;AACH,MAAM,KAAK,GAAG,8CAA8C,CAAC;AAkB7D,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAChF,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACb,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;KACtC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QAC7F,OAAO,MAAiC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/storage/markdown/header-doc.d.ts

@@ -0,0 +1,56 @@
+import type { MapDocument, MapEdit } from '../../domain.ts';
+export declare const SECTION_HEADINGS: {
+    readonly destination: 'Destination';
+    readonly notes: 'Notes';
+    readonly decisions: 'Decisions so far';
+    readonly fog: 'Not yet specified';
+    readonly outOfScope: 'Out of scope';
+};
+/** Markers stating that their contents are overwritten — ADR 0002. */
+export declare const GENERATED_OPEN = "<!-- GENERATED: overwritten on every mutation through the server. Do not hand-edit. -->";
+export declare const GENERATED_CLOSE = "<!-- /GENERATED -->";
+/**
+ * One derived pointer line: a resolved or dropped Ticket as it appears in a
+ * generated Map block. The link is relative to the Map file.
+ */
+export interface DerivedPointer {
+    readonly id: string;
+    readonly title: string;
+    readonly link: string;
+    readonly gist: string;
+}
+/**
+ * The opening paragraph of a Spec — the first prose under its title. A Spec has
+ * no Destination section, so this is the orienting text a Spec-only Effort has,
+ * and a Board that opens with nothing leaves every Ticket line uninterpretable.
+ */
+export declare function readSpecOpening(contents: string): string | undefined;
+/**
+ * Typed sections a caller can read without paying for the whole Map body —
+ * Decisions-so-far is deliberately absent; it is never read from the file.
+ */
+export declare function readMapDocument(contents: string, revision: string): MapDocument;
+export interface ApplyMapEditOptions {
+    /**
+     * When true, invent the Decisions / Out-of-scope headings (with empty
+     * GENERATED blocks) if absent. Used by resolve/drop refresh so a slim Map
+     * still gets a truthful derived cache. Ordinary edit_map section edits leave
+     * the Map shape alone — they never invent unrelated headings.
+     */
+    readonly ensureDerivedSections?: boolean;
+}
+/**
+ * Apply a section edit and rewrite the derived blocks. Content outside the
+ * GENERATED markers is left alone; the blocks themselves are replaced whole.
+ * When Decisions has no markers, its whole body is replaced by a GENERATED
+ * block (unfenced stale prose must not remain). Out of scope without markers
+ * keeps unfenced bullets as hand-owned and installs the GENERATED block under
+ * them. Missing headings are not invented unless
+ * {@link ApplyMapEditOptions.ensureDerivedSections} is set.
+ */
+export declare function applyMapEdit(contents: string, edit: MapEdit, decisions: readonly DerivedPointer[], dropped: readonly DerivedPointer[], options?: ApplyMapEditOptions): string;
+/** A brand-new Map file, with empty generated blocks ready for the first write. */
+export declare function scaffoldMap(edit: MapEdit): string;
+export declare function ensureTrailingNewline(text: string): string;
+export declare function readSection(contents: string, heading: string): string | undefined;
+//# sourceMappingURL=header-doc.d.ts.map

package/dist/storage/markdown/header-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-doc.d.ts","sourceRoot":"","sources":["../../../src/storage/markdown/header-doc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAS5D,eAAO,MAAM,gBAAgB;aAC3B,WAAW,EAAE,aAAa;aAC1B,KAAK,EAAE,OAAO;aACd,SAAS,EAAE,kBAAkB;aAC7B,GAAG,EAAE,mBAAmB;aACxB,UAAU,EAAE,cAAc;CAClB,CAAC;AAEX,sEAAsE;AACtE,eAAO,MAAM,cAAc,4FACgE,CAAC;AAC5F,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAOrD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAQ/E;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,SAAS,cAAc,EAAE,EACpC,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAgCR;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CA0CjD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAYD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjF"}