frontier-mcp 0.1.0

package/dist/storage/markdown/header-doc.js

@@ -0,0 +1,287 @@
+import { splitFrontmatter } from './frontmatter.js';
+import { NoSuchFogPatch } from '../driver.js';
+/**
+ * The Map's typed sections live under `##` headings. Only this module knows
+ * that — the driver interface carries the values, never the section names, so
+ * a SQLite driver can hold them as columns.
+ */
+const NEXT_HEADING = /^##[ \t]/m;
+export const SECTION_HEADINGS = {
+    destination: 'Destination',
+    notes: 'Notes',
+    decisions: 'Decisions so far',
+    fog: 'Not yet specified',
+    outOfScope: 'Out of scope',
+};
+/** Markers stating that their contents are overwritten — ADR 0002. */
+export const GENERATED_OPEN = '<!-- GENERATED: overwritten on every mutation through the server. Do not hand-edit. -->';
+export const GENERATED_CLOSE = '<!-- /GENERATED -->';
+const GENERATED_BLOCK = /<!--[ \t]*GENERATED\b[^>]*-->\r?\n?([\s\S]*?)<!--[ \t]*\/GENERATED[ \t]*-->/i;
+const BULLET = /^[ \t]*[-*][ \t]+(.+?)[ \t]*$/;
+/**
+ * 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 function readSpecOpening(contents) {
+    const { body } = splitFrontmatter(contents);
+    return body
+        .split(/\n{2,}/)
+        .map(block => block.trim())
+        .find(block => block !== '' && !block.startsWith('#') && !isFieldLine(block));
+}
+/**
+ * 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 function readMapDocument(contents, revision) {
+    return {
+        destination: readSection(contents, SECTION_HEADINGS.destination),
+        notes: readSection(contents, SECTION_HEADINGS.notes),
+        notYetSpecified: bulletsOutsideGenerated(readSectionRaw(contents, SECTION_HEADINGS.fog)),
+        outOfScope: bulletsOutsideGenerated(readSectionRaw(contents, SECTION_HEADINGS.outOfScope)),
+        revision,
+    };
+}
+/**
+ * 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 function applyMapEdit(contents, edit, decisions, dropped, options = {}) {
+    let next = contents;
+    if (edit.destination !== undefined) {
+        next = setSection(next, SECTION_HEADINGS.destination, edit.destination.trim());
+    }
+    if (edit.notes !== undefined) {
+        next = setSection(next, SECTION_HEADINGS.notes, edit.notes.trim());
+    }
+    if (edit.addFog !== undefined) {
+        next = appendBullet(next, SECTION_HEADINGS.fog, edit.addFog.trim());
+    }
+    if (edit.graduateFog !== undefined) {
+        next = removeBullet(next, SECTION_HEADINGS.fog, edit.graduateFog.trim());
+    }
+    if (edit.ruleOut !== undefined) {
+        next = appendBullet(next, SECTION_HEADINGS.outOfScope, edit.ruleOut.trim());
+    }
+    if (options.ensureDerivedSections) {
+        next = ensureDerivedHeading(next, SECTION_HEADINGS.decisions);
+        next = ensureDerivedHeading(next, SECTION_HEADINGS.outOfScope);
+    }
+    // Decisions is wholly derived: unfenced prose is stale cache, not hand-owned.
+    next = replaceGenerated(next, SECTION_HEADINGS.decisions, renderPointers(decisions), {
+        wipeUnfenced: true,
+    });
+    // Out of scope mixes hand-ruled bullets (outside) with dropped Tickets (inside).
+    next = replaceGenerated(next, SECTION_HEADINGS.outOfScope, renderPointers(dropped));
+    return next;
+}
+/** A brand-new Map file, with empty generated blocks ready for the first write. */
+export function scaffoldMap(edit) {
+    const destination = edit.destination?.trim() ?? '';
+    const notes = edit.notes?.trim() ?? '';
+    const fog = edit.addFog !== undefined ? `- ${edit.addFog.trim()}` : '';
+    const ruled = edit.ruleOut !== undefined ? `- ${edit.ruleOut.trim()}` : '';
+    if (edit.graduateFog !== undefined)
+        throw new NoSuchFogPatch(edit.graduateFog);
+    return [
+        '---',
+        'header: map',
+        '---',
+        '',
+        '# Map',
+        '',
+        `## ${SECTION_HEADINGS.destination}`,
+        '',
+        destination,
+        '',
+        `## ${SECTION_HEADINGS.notes}`,
+        '',
+        notes,
+        '',
+        `## ${SECTION_HEADINGS.decisions}`,
+        '',
+        GENERATED_OPEN,
+        GENERATED_CLOSE,
+        '',
+        `## ${SECTION_HEADINGS.fog}`,
+        '',
+        fog,
+        '',
+        `## ${SECTION_HEADINGS.outOfScope}`,
+        '',
+        ruled,
+        '',
+        GENERATED_OPEN,
+        GENERATED_CLOSE,
+        '',
+    ]
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n');
+}
+export function ensureTrailingNewline(text) {
+    return text.endsWith('\n') ? text : `${text}\n`;
+}
+function renderPointers(pointers) {
+    if (pointers.length === 0)
+        return '';
+    return pointers
+        .map(pointer => {
+        const head = `- [${pointer.id} — ${pointer.title}](${pointer.link})`;
+        return pointer.gist === '' ? head : `${head} — ${pointer.gist}`;
+    })
+        .join('\n');
+}
+export function readSection(contents, heading) {
+    const raw = readSectionRaw(contents, heading);
+    if (raw === undefined)
+        return undefined;
+    const trimmed = stripGenerated(raw).trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+function readSectionRaw(contents, heading) {
+    const { body } = splitFrontmatter(contents);
+    const located = locateSection(body, heading);
+    if (located === undefined)
+        return undefined;
+    return body.slice(located.start, located.end);
+}
+function setSection(contents, heading, value) {
+    const { hasFence, raw, body } = splitFrontmatter(contents);
+    const located = locateSection(body, heading);
+    const sectionBody = value === '' ? '\n\n' : `\n\n${value}\n\n`;
+    let nextBody;
+    if (located === undefined) {
+        nextBody = ensureTrailingNewline(body) + `\n## ${heading}\n${sectionBody}`;
+    }
+    else {
+        const { start, end } = located;
+        // Keep any GENERATED block that lives in this section (Out of scope).
+        const existing = body.slice(start, end);
+        const generated = existing.match(GENERATED_BLOCK)?.[0];
+        const replacement = generated === undefined
+            ? sectionBody
+            : `${sectionBody}\n${generated.endsWith('\n') ? generated : `${generated}\n`}`;
+        nextBody = body.slice(0, start) + replacement + body.slice(end);
+    }
+    return reassemble(hasFence, raw, nextBody);
+}
+function appendBullet(contents, heading, text) {
+    const raw = readSectionRaw(contents, heading);
+    if (raw === undefined) {
+        return setSection(contents, heading, `- ${text}`);
+    }
+    const outside = stripGenerated(raw).replace(/\s+$/, '');
+    const bullet = `- ${text}`;
+    const combined = outside === '' ? bullet : `${outside}\n${bullet}`;
+    return setSection(contents, heading, combined.trim());
+}
+function removeBullet(contents, heading, text) {
+    const raw = readSectionRaw(contents, heading);
+    if (raw === undefined)
+        throw new NoSuchFogPatch(text);
+    const lines = stripGenerated(raw).split('\n');
+    const index = lines.findIndex(line => {
+        const match = BULLET.exec(line);
+        return match?.[1] === text;
+    });
+    if (index < 0)
+        throw new NoSuchFogPatch(text);
+    const next = [...lines.slice(0, index), ...lines.slice(index + 1)]
+        .join('\n')
+        .replace(/^\n+/, '')
+        .replace(/\n+$/, '');
+    return setSection(contents, heading, next);
+}
+/**
+ * Append a server-owned heading with an empty GENERATED block when the Map
+ * never grew one. Only the resolve/drop refresh path asks for this — typed
+ * section edits must not reshape an unrelated Map.
+ */
+function ensureDerivedHeading(contents, heading) {
+    if (readSectionRaw(contents, heading) !== undefined)
+        return contents;
+    const block = `${GENERATED_OPEN}\n${GENERATED_CLOSE}\n`;
+    const { hasFence, raw, body } = splitFrontmatter(contents);
+    const addition = `\n## ${heading}\n\n${block}`;
+    return reassemble(hasFence, raw, ensureTrailingNewline(body) + addition);
+}
+function replaceGenerated(contents, heading, inner, options = {}) {
+    const raw = readSectionRaw(contents, heading);
+    // Content outside the markers is never touched — inventing a missing section
+    // would rewrite the Map shape on an unrelated edit.
+    if (raw === undefined)
+        return contents;
+    const block = inner === ''
+        ? `${GENERATED_OPEN}\n${GENERATED_CLOSE}\n`
+        : `${GENERATED_OPEN}\n${inner}\n${GENERATED_CLOSE}\n`;
+    const { hasFence, raw: fence, body } = splitFrontmatter(contents);
+    const { start, end } = locateSection(body, heading);
+    const section = body.slice(start, end);
+    let replacement;
+    if (GENERATED_BLOCK.test(section)) {
+        replacement = section.replace(GENERATED_BLOCK, block.trimEnd());
+        if (!replacement.endsWith('\n'))
+            replacement += '\n';
+    }
+    else if (options.wipeUnfenced) {
+        // No markers: the whole section body is the derived cache the server owns.
+        // Replacing (not appending) clears hand-typed stale Decisions that would
+        // otherwise lie next to a fresh GENERATED block — ADR 0002.
+        replacement = `\n${block}`;
+    }
+    else {
+        // Mixed sections (Out of scope): keep unfenced bullets as hand-owned and
+        // install the GENERATED dropped-Ticket block beneath them.
+        const outside = section.replace(/\s+$/, '');
+        replacement = outside === '' ? `\n${block}` : `${outside}\n\n${block}`;
+    }
+    return reassemble(hasFence, fence, body.slice(0, start) + replacement + body.slice(end));
+}
+/** Byte range of a section's body inside `body` (after the heading line). */
+function locateSection(body, heading) {
+    const pattern = new RegExp(`^##[ \\t]+${escapeRegExp(heading)}[ \\t]*$`, 'im');
+    const match = pattern.exec(body);
+    if (match === null)
+        return undefined;
+    const start = match.index + match[0].length;
+    const after = body.slice(start);
+    const next = NEXT_HEADING.exec(after);
+    const end = next === null ? body.length : start + next.index;
+    return { start, end };
+}
+function bulletsOutsideGenerated(raw) {
+    if (raw === undefined)
+        return [];
+    return stripGenerated(raw)
+        .split('\n')
+        .map(line => BULLET.exec(line)?.[1])
+        .filter((item) => item !== undefined);
+}
+function stripGenerated(raw) {
+    return raw.replace(GENERATED_BLOCK, '');
+}
+function reassemble(hasFence, raw, body) {
+    // Preserve leading newlines in the body; only guarantee a trailing newline.
+    const next = ensureTrailingNewline(body);
+    if (!hasFence || raw === undefined)
+        return next;
+    return `---\n${raw}\n---\n\n${next.replace(/^\n+/, '')}`;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * A single `Key: value` line — `Status: ready-for-agent` and the like. These sit
+ * under the title in several of these documents and say nothing about where the
+ * Effort is going, which is the whole job of the text a Board opens with.
+ */
+function isFieldLine(block) {
+    return !block.includes('\n') && /^[A-Za-z][\w -]{0,24}:[ \t]*\S+$/.test(block);
+}
+//# sourceMappingURL=header-doc.js.map

package/dist/storage/markdown/header-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-doc.js","sourceRoot":"","sources":["../../../src/storage/markdown/header-doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C;;;;GAIG;AACH,MAAM,YAAY,GAAG,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW,EAAE,aAAa;IAC1B,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,kBAAkB;IAC7B,GAAG,EAAE,mBAAmB;IACxB,UAAU,EAAE,cAAc;CAClB,CAAC;AAEX,sEAAsE;AACtE,MAAM,CAAC,MAAM,cAAc,GACzB,yFAAyF,CAAC;AAC5F,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAErD,MAAM,eAAe,GACnB,8EAA8E,CAAC;AAEjF,MAAM,MAAM,GAAG,+BAA+B,CAAC;AAa/C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE5C,OAAO,IAAI;SACR,KAAK,CAAC,QAAQ,CAAC;SACf,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC1B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,QAAgB;IAChE,OAAO;QACL,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE,gBAAgB,CAAC,WAAW,CAAC;QAChE,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC;QACpD,eAAe,EAAE,uBAAuB,CAAC,cAAc,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACxF,UAAU,EAAE,uBAAuB,CAAC,cAAc,CAAC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1F,QAAQ;KACT,CAAC;AACJ,CAAC;AAYD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,IAAa,EACb,SAAoC,EACpC,OAAkC,EAClC,OAAO,GAAwB,EAAE;IAEjC,IAAI,IAAI,GAAG,QAAQ,CAAC;IAEpB,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;QAClC,IAAI,GAAG,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,GAAG,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC;IAED,8EAA8E;IAC9E,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC,EAAE;QACnF,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IACH,iFAAiF;IACjF,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,CAAC,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3E,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE/E,OAAO;QACL,KAAK;QACL,aAAa;QACb,KAAK;QACL,EAAE;QACF,OAAO;QACP,EAAE;QACF,MAAM,gBAAgB,CAAC,WAAW,EAAE;QACpC,EAAE;QACF,WAAW;QACX,EAAE;QACF,MAAM,gBAAgB,CAAC,KAAK,EAAE;QAC9B,EAAE;QACF,KAAK;QACL,EAAE;QACF,MAAM,gBAAgB,CAAC,SAAS,EAAE;QAClC,EAAE;QACF,cAAc;QACd,eAAe;QACf,EAAE;QACF,MAAM,gBAAgB,CAAC,GAAG,EAAE;QAC5B,EAAE;QACF,GAAG;QACH,EAAE;QACF,MAAM,gBAAgB,CAAC,UAAU,EAAE;QACnC,EAAE;QACF,KAAK;QACL,EAAE;QACF,cAAc;QACd,eAAe;QACf,EAAE;KACH;SACE,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;AAClD,CAAC;AAED,SAAS,cAAc,CAAC,QAAmC;IACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,QAAQ;SACZ,GAAG,CAAC,OAAO,CAAC,EAAE;QACb,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC;QACrE,OAAO,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IAClE,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe;IAC3D,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9C,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,OAAe;IACvD,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB,EAAE,OAAe,EAAE,KAAa;IAClE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC;IAE/D,IAAI,QAAgB,CAAC;IACrB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,QAAQ,OAAO,KAAK,WAAW,EAAE,CAAC;IAC7E,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QAC/B,sEAAsE;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,WAAW,GACf,SAAS,KAAK,SAAS;YACrB,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,GAAG,WAAW,KAAK,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,EAAE,CAAC;QACnF,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,OAAe,EAAE,IAAY;IACnE,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,MAAM,EAAE,CAAC;IACnE,OAAO,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,OAAe,EAAE,IAAY;IACnE,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAE9C,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;SAC/D,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvB,OAAO,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,QAAgB,EAAE,OAAe;IAC7D,IAAI,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACrE,MAAM,KAAK,GAAG,GAAG,cAAc,KAAK,eAAe,IAAI,CAAC;IACxD,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,QAAQ,OAAO,OAAO,KAAK,EAAE,CAAC;IAC/C,OAAO,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,qBAAqB,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,gBAAgB,CACvB,QAAgB,EAChB,OAAe,EACf,KAAa,EACb,OAAO,GAAwC,EAAE;IAEjD,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,6EAA6E;IAC7E,oDAAoD;IACpD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAEvC,MAAM,KAAK,GACT,KAAK,KAAK,EAAE;QACV,CAAC,CAAC,GAAG,cAAc,KAAK,eAAe,IAAI;QAC3C,CAAC,CAAC,GAAG,cAAc,KAAK,KAAK,KAAK,eAAe,IAAI,CAAC;IAE1D,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAClE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAE,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEvC,IAAI,WAAmB,CAAC;IACxB,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,WAAW,IAAI,IAAI,CAAC;IACvD,CAAC;SAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QAChC,2EAA2E;QAC3E,yEAAyE;QACzE,4DAA4D;QAC5D,WAAW,GAAG,KAAK,KAAK,EAAE,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,yEAAyE;QACzE,2DAA2D;QAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5C,WAAW,GAAG,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,KAAK,EAAE,CAAC;IACzE,CAAC;IAED,OAAO,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,6EAA6E;AAC7E,SAAS,aAAa,CACpB,IAAY,EACZ,OAAe;IAEf,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,aAAa,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAErC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC7D,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,uBAAuB,CAAC,GAAuB;IACtD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,cAAc,CAAC,GAAG,CAAC;SACvB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SACnC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,UAAU,CAAC,QAAiB,EAAE,GAAuB,EAAE,IAAY;IAC1E,4EAA4E;IAC5E,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,QAAQ,GAAG,YAAY,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjF,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { Kind, Status } from '../../domain.ts';
+export interface LegacyTicket {
+    readonly id: string | undefined;
+    readonly title: string;
+    readonly kind: Kind;
+    readonly status: Status;
+    readonly triage: string | undefined;
+    readonly blockedBy: readonly string[];
+    /** The raw `Status:` text when it did not map to a known Status. */
+    readonly unrecognizedStatus: string | undefined;
+    /** Sub-slice references (`T38.1`) coarsened to the Ticket that exists. */
+    readonly collapsedRefs: readonly string[];
+    readonly type: string | undefined;
+}
+export declare function parseLegacyBody(contents: string): LegacyTicket;
+//# sourceMappingURL=legacy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../../src/storage/markdown/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAkFpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAmB9D"}

package/dist/storage/markdown/legacy.js

@@ -0,0 +1,152 @@
+/**
+ * The best-effort parser for Ticket files that predate the schema. Every field
+ * it produces is an inference, which is why a Legacy Ticket is flagged: an
+ * agent needs to know which values to distrust.
+ *
+ * The shapes here are the ones the real repos actually contain, not the ones a
+ * schema would have liked. Reads never write, so a file parsed badly is only
+ * ever reported badly — it is never corrected on disk.
+ */
+/** `# T30 — Grammy group boot`, or `# 01 — Is the fix a latent bug?` with no id. */
+const HEADING = /^#[ \t]+(.+?)[ \t]*$/m;
+const HEADING_ID = /^(T\d+)[ \t]*[—–-][ \t]*(.*)$/;
+const HEADING_ORDER = /^\d+[ \t]*[—–-][ \t]*(.*)$/;
+/**
+ * `Status: resolved`, `**Status:** done`, or ``Status: resolved — **`0.5.0`
+ * published**``. Bold is tolerated everywhere, because these files mark up
+ * their field labels inconsistently and a bold label is still a label.
+ */
+const STATUS_LINE = /^\**Status\**:\**[ \t]*(.+?)[ \t]*$/im;
+const TYPE_LINE = /^\**Type\**:\**[ \t]*(.+?)[ \t]*$/im;
+/** `**Depends on:** T31 (...)` and `Blocked by: 01, 02`, bold or bare. */
+const EDGE_LINE = /^\**(?:Depends on|Blocked by)\**:\**[ \t]*(.+?)[ \t]*$/gim;
+/** A withdrawn Edge, struck through rather than deleted. */
+const STRIKETHROUGH = /~~[\s\S]*?~~/g;
+/**
+ * Whole markdown links, label and target both, so a path never contributes a
+ * false id. Verified against every Edge line in the fixtures: real
+ * references are always written outside their link, so nothing is lost — and a
+ * label like `[../T99/issues/01.md]` would otherwise mint an Edge to T99.
+ */
+const MARKDOWN_LINK = /\[[^\]]*\]\([^)]*\)/g;
+/** `T31`, and `T38.1` — a sub-slice of T38, which is the Ticket that exists. */
+const TICKET_REF = /\bT(\d+)(\.\d+)?\b/g;
+/**
+ * A bare `01` in `Blocked by: 01, 02` — this Effort's sort orders, written
+ * before ids existed. Anything touching a `.` is excluded so a version string
+ * like `0.5.0` never becomes an Edge.
+ */
+const BARE_ORDER = /(?:^|[\s,;])(\d{1,3})(?![.\d])(?=[\s,;]|$)/g;
+/**
+ * Status words seen in the wild, mapped to the four the schema has. `done` and
+ * `fixed` are resolved by another name. `superseded` and `deferred` are closed
+ * rather than open, which is the safe direction: a Ticket wrongly left off the
+ * Frontier is a missed opportunity, one wrongly put on it is wasted work.
+ */
+const STATUS_WORDS = new Map([
+    ['open', 'open'],
+    ['claimed', 'claimed'],
+    ['resolved', 'resolved'],
+    ['done', 'resolved'],
+    ['fixed', 'resolved'],
+    ['dropped', 'dropped'],
+    ['superseded', 'dropped'],
+    ['deferred', 'dropped'],
+]);
+/**
+ * Triage roles found in a `Status:` line, where they do not belong. These are
+ * checked first: a triage role says nothing about lifecycle position, so
+ * finding one means the Status field never held a Status at all.
+ *
+ * `wontfix` is here and deliberately not in {@link STATUS_WORDS} — it is a
+ * Triage role, not a Status, and mapping it to `dropped` would make it
+ * contagious, turning every dependent into a broken Edge.
+ */
+const TRIAGE_WORDS = new Set([
+    'needs-triage',
+    'needs-info',
+    'ready-for-agent',
+    'ready-for-human',
+    'wontfix',
+]);
+export function parseLegacyBody(contents) {
+    const { id, title } = readHeading(contents);
+    const { status, triage, unrecognized } = readStatus(STATUS_LINE.exec(contents)?.[1]);
+    const { edges, collapsed } = readEdges(contents);
+    const type = TYPE_LINE.exec(contents)?.[1];
+    return {
+        id,
+        title,
+        // A `Type:` line is wayfinder's decision vocabulary; its presence is what
+        // marks the Ticket as a question rather than a slice of work.
+        kind: type === undefined ? 'build' : 'decision',
+        type,
+        status,
+        triage,
+        blockedBy: edges,
+        unrecognizedStatus: unrecognized,
+        collapsedRefs: collapsed,
+    };
+}
+function readHeading(contents) {
+    const heading = HEADING.exec(contents)?.[1]?.trim();
+    if (heading === undefined || heading === '')
+        return { id: undefined, title: '(untitled)' };
+    const withId = HEADING_ID.exec(heading);
+    if (withId?.[1] !== undefined)
+        return { id: withId[1], title: (withId[2] ?? '').trim() };
+    // `# 01 — Title`: the number is this Effort's sort order, never an id. A
+    // per-Effort `01` is not unique repo-wide, so minting one is migration's job.
+    const withOrder = HEADING_ORDER.exec(heading);
+    if (withOrder?.[1] !== undefined)
+        return { id: undefined, title: withOrder[1].trim() };
+    return { id: undefined, title: heading };
+}
+function readStatus(raw) {
+    if (raw === undefined)
+        return { status: 'open', triage: undefined, unrecognized: undefined };
+    // `resolved — 2026-08-04` and `deferred to 0.6.0` both carry their meaning in
+    // the first word; everything after it is a note for a human.
+    const word = (raw.split(/[—–]| - /)[0] ?? '').trim().toLowerCase();
+    const first = (word.split(/\s+/)[0] ?? '').replace(/[.,]$/, '');
+    // A Triage role is checked first, and leaves the lifecycle position alone —
+    // it never described one.
+    if (TRIAGE_WORDS.has(first))
+        return { status: 'open', triage: first, unrecognized: undefined };
+    const status = STATUS_WORDS.get(first);
+    if (status !== undefined)
+        return { status, triage: undefined, unrecognized: undefined };
+    return { status: 'open', triage: undefined, unrecognized: raw };
+}
+/**
+ * Edges out of prose. Struck-through text is dropped because a withdrawn Edge
+ * is not an Edge, and whole markdown links are stripped so a relative path
+ * never contributes an id of its own.
+ *
+ * Bare numbers (`Blocked by: 01, 02`) are kept verbatim. They are this Effort's
+ * sort orders, not ids, and are reported as unresolvable rather than guessed at
+ * — resolving them would invent a repo-wide identity the file never had.
+ */
+function readEdges(contents) {
+    const edges = new Set();
+    const collapsed = new Set();
+    for (const line of contents.matchAll(EDGE_LINE)) {
+        const declared = (line[1] ?? '').replace(STRIKETHROUGH, '').replace(MARKDOWN_LINK, '');
+        if (/^\s*(?:—|–|-|none)\s*$/i.test(declared))
+            continue;
+        for (const ref of declared.matchAll(TICKET_REF)) {
+            const id = `T${ref[1] ?? ''}`;
+            // `T38.1` names a slice of T38, and T38 is the Ticket that exists — but
+            // the reader is told, because the Edge on the Board is then coarser than
+            // the one the file declared.
+            if (ref[2] !== undefined)
+                collapsed.add(`${id}${ref[2]}`);
+            edges.add(id);
+        }
+        for (const bare of declared.matchAll(BARE_ORDER))
+            edges.add(bare[1] ?? '');
+    }
+    edges.delete('');
+    return { edges: [...edges], collapsed: [...collapsed] };
+}
+//# sourceMappingURL=legacy.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { MigrationReport, Ticket } from '../../domain.ts';
+import { type Rescan } from './create.ts';
+export interface TicketFileEntry {
+    readonly filename: string;
+    readonly ticket: Ticket;
+}
+export interface MigrateFilesRequest {
+    readonly scratch: string;
+    readonly effort: string;
+    readonly issues: string;
+    readonly entries: readonly TicketFileEntry[];
+    readonly allTickets: readonly Ticket[];
+    readonly preview: boolean;
+    readonly rename: boolean;
+    readonly rescan: Rescan;
+    readonly readContents: (filename: string) => Promise<string>;
+}
+/**
+ * Normalize Legacy Tickets in one Effort, mint ids for those without, and
+ * optionally rename. Preview plans mint ids from the scan and writes nothing.
+ *
+ * Bare sort-order Edges (`Blocked by: 01`) are rewritten to the id the target
+ * Ticket carries after this call — preserved or newly minted — so migration
+ * does not leave a Board full of unresolvable `01` references.
+ */
+export declare function migrateEffortFiles(request: MigrateFilesRequest): Promise<MigrationReport>;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/storage/markdown/migrate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAqD,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAI7F,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9D;AASD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0B/F"}