frontier-mcp 0.1.0

package/dist/storage/markdown/migrate.js

@@ -0,0 +1,158 @@
+import { rename as renameFile, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { peekMintedIds, ticketFilename, withIdReservations } from './create.js';
+import { normalizeTicket } from './serialize.js';
+import { stage, unstage, writeAtomically } from './write.js';
+/**
+ * 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 async function migrateEffortFiles(request) {
+    const { effort, entries, preview, rename } = request;
+    const candidates = entries.filter(entry => entry.ticket.legacy || entry.ticket.id === undefined);
+    if (candidates.length === 0) {
+        return { effort, preview, renamed: rename, changes: [] };
+    }
+    const needMint = candidates.filter(entry => entry.ticket.id === undefined).length;
+    const used = idsOf(request.allTickets);
+    if (preview) {
+        const plan = planChanges(candidates, peekMintedIds(used, needMint), entries, rename);
+        return { effort, preview: true, renamed: rename, changes: plan.map(file => file.change) };
+    }
+    return withIdReservations(request.scratch, needMint, request.rescan, async (minted) => {
+        const plan = planChanges(candidates, minted, entries, rename);
+        await applyPlan(request, plan);
+        return {
+            effort,
+            preview: false,
+            renamed: rename,
+            changes: plan.map(file => file.change),
+        };
+    });
+}
+function planChanges(candidates, minted, entries, rename) {
+    let mintAt = 0;
+    const idByOrder = new Map();
+    // Every Ticket in the Effort contributes to Edge remapping — a blocker that
+    // already had an id must still be findable by its sort order.
+    for (const entry of entries) {
+        if (entry.ticket.id !== undefined)
+            idByOrder.set(entry.ticket.order, entry.ticket.id);
+    }
+    const assigned = new Map();
+    for (const entry of candidates) {
+        if (entry.ticket.id !== undefined) {
+            assigned.set(entry.ticket.handle, entry.ticket.id);
+            idByOrder.set(entry.ticket.order, entry.ticket.id);
+            continue;
+        }
+        const id = minted[mintAt++];
+        if (id === undefined)
+            throw new Error('Reserved fewer ids than Tickets needing one.');
+        assigned.set(entry.ticket.handle, id);
+        idByOrder.set(entry.ticket.order, id);
+    }
+    return candidates.map(entry => {
+        const id = assigned.get(entry.ticket.handle);
+        if (id === undefined)
+            throw new Error(`No id planned for ${entry.ticket.handle}.`);
+        const to = rename ? ticketFilename(entry.ticket.order, id, entry.ticket.title) : entry.filename;
+        const blockedBy = remapEdges(entry.ticket.blockedBy, idByOrder);
+        return {
+            from: entry.filename,
+            to,
+            defaults: {
+                id,
+                title: entry.ticket.title,
+                kind: entry.ticket.kind,
+                type: entry.ticket.type,
+                status: entry.ticket.status,
+                triage: entry.ticket.triage,
+                blockedBy,
+            },
+            change: {
+                beforeHandle: entry.ticket.handle,
+                id,
+                title: entry.ticket.title,
+                minted: entry.ticket.id === undefined,
+                normalized: entry.ticket.legacy,
+                fromName: to === entry.filename ? undefined : entry.filename,
+                toName: to === entry.filename ? undefined : to,
+                blockedBy,
+            },
+        };
+    });
+}
+async function applyPlan(request, plan) {
+    const targets = new Set(plan.map(file => file.to));
+    const sources = new Set(plan.map(file => file.from));
+    for (const file of plan) {
+        if (file.to !== file.from && !sources.has(file.to)) {
+            // A name that already exists and is not being vacated would destroy a Ticket.
+            const clash = request.entries.some(entry => entry.filename === file.to);
+            if (clash) {
+                throw new Error(`Cannot rename to ${file.to}: that name is already taken in ${request.effort}.`);
+            }
+        }
+    }
+    // Detect two Tickets collapsing onto one target name.
+    if (targets.size !== plan.length) {
+        throw new Error(`Rename would collide on a filename inside Effort '${request.effort}'.`);
+    }
+    const prepared = await Promise.all(plan.map(async (file) => ({
+        ...file,
+        contents: normalizeTicket(await request.readContents(file.from), file.defaults),
+    })));
+    // Same-name updates are per-file atomic. Renames stage every new file first,
+    // land them, then remove the vacated names — so a failure mid-batch never
+    // deletes a source whose replacement did not land.
+    const inPlace = prepared.filter(file => file.from === file.to);
+    const moved = prepared.filter(file => file.from !== file.to);
+    await Promise.all(inPlace.map(file => writeAtomically(join(request.issues, file.to), file.contents)));
+    if (moved.length === 0)
+        return;
+    const staged = await Promise.allSettled(moved.map(async (file) => ({
+        temporary: await stage(join(request.issues, file.to), file.contents),
+        target: join(request.issues, file.to),
+        from: join(request.issues, file.from),
+    })));
+    const ready = staged.filter(entry => entry.status === 'fulfilled').map(entry => entry.value);
+    const failed = staged.find(entry => entry.status === 'rejected');
+    if (failed !== undefined) {
+        await Promise.allSettled(ready.map(entry => unstage(entry.temporary)));
+        throw failed.reason;
+    }
+    const landed = await Promise.allSettled(ready.map(async (entry) => {
+        await renameFile(entry.temporary, entry.target);
+        return entry;
+    }));
+    const written = landed.filter(entry => entry.status === 'fulfilled').map(entry => entry.value);
+    const lost = landed.find(entry => entry.status === 'rejected');
+    if (lost !== undefined) {
+        await Promise.allSettled([
+            ...written.map(entry => unlink(entry.target).catch(() => { })),
+            ...ready.map(entry => unstage(entry.temporary)),
+        ]);
+        throw lost.reason;
+    }
+    await Promise.all(written.map(entry => unlink(entry.from)));
+}
+/**
+ * A bare sort-order Edge becomes the id of the Ticket at that order. Real ids
+ * and anything else pass through unchanged — dangling Edges stay Board warnings.
+ */
+function remapEdges(edges, idByOrder) {
+    return edges.map(edge => {
+        if (!/^\d+$/.test(edge))
+            return edge;
+        return idByOrder.get(Number(edge)) ?? edge;
+    });
+}
+function idsOf(tickets) {
+    return new Set(tickets.map(entry => entry.id).filter(id => id !== undefined));
+}
+//# sourceMappingURL=migrate.js.map

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

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

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

@@ -0,0 +1,37 @@
+import type { TicketEdit } from '../../domain.ts';
+export interface Defaults {
+    readonly id: string | undefined;
+    readonly title: string;
+    readonly kind: string;
+    readonly type: string | undefined;
+    readonly status: string;
+    readonly triage: string | undefined;
+    readonly blockedBy: readonly string[];
+}
+/**
+ * Normalize a Ticket file to schema frontmatter. A Legacy file with no fence
+ * gets a full block from {@link defaults}; a file that already has frontmatter
+ * keeps key order and only gains a missing id plus an updated Edge list (so a
+ * bare sort-order Edge can become the id migration just minted). Body prose is
+ * kept verbatim either way.
+ */
+export declare function normalizeTicket(contents: string, defaults: Defaults): string;
+/**
+ * Apply an edit to a Ticket file, returning the new contents.
+ *
+ * Per ADR 0003 the frontmatter is mutated as a parsed YAML document rather than
+ * rebuilt from an object, so comments, key order and quoting style survive on
+ * every field the edit did not name. The body is a string this only ever
+ * appends to or replaces one known section of.
+ */
+export declare function applyEdit(contents: string, edit: TicketEdit, defaults: Defaults): string;
+/**
+ * A Ticket file as first written. Everything is a field this driver is creating,
+ * so the whole block is in schema order — the one case where that is allowed,
+ * since there is no author's ordering to preserve.
+ *
+ * The body is the caller's prose, stored verbatim. A draft with none produces a
+ * Ticket with none rather than a heading nobody asked for.
+ */
+export declare function serializeNew(fields: Defaults, body: string | undefined): string;
+//# sourceMappingURL=serialize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/storage/markdown/serialize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA4BlD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAiB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAsBxF;AA0LD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK/E"}

package/dist/storage/markdown/serialize.js

@@ -0,0 +1,321 @@
+import { Document, isSeq, parseDocument } from 'yaml';
+import { splitFrontmatter } from './frontmatter.js';
+/**
+ * Field order for frontmatter this driver *creates*. An existing file is never
+ * reordered — a new field is appended, because moving keys a write did not name
+ * is exactly the reformatting ADR 0003 forbids.
+ */
+const FIELD_ORDER = [
+    'id',
+    'title',
+    'kind',
+    'type',
+    'status',
+    'triage',
+    'blocked_by',
+    'claimed_by',
+    'claimed_at',
+    'answer_gist',
+    'dropped_reason',
+];
+/** The body sections a write may touch. Everything else is opaque prose. */
+const ANSWER_HEADING = '## Answer';
+const COMMENTS_HEADING = '## Comments';
+/** Any `##` heading, so replacing the answer stops at the next section. */
+const NEXT_SECTION = /^##[ \t]/m;
+/**
+ * Normalize a Ticket file to schema frontmatter. A Legacy file with no fence
+ * gets a full block from {@link defaults}; a file that already has frontmatter
+ * keeps key order and only gains a missing id plus an updated Edge list (so a
+ * bare sort-order Edge can become the id migration just minted). Body prose is
+ * kept verbatim either way.
+ */
+export function normalizeTicket(contents, defaults) {
+    const split = splitFrontmatter(contents);
+    if (!split.hasFence)
+        return applyEdit(contents, {}, defaults);
+    const document = existingDocument(split.raw);
+    if (document === undefined)
+        return applyEdit(contents, {}, defaults);
+    if (defaults.id !== undefined) {
+        const existing = document.get('id');
+        if (existing === undefined || existing === null || String(existing).trim() === '') {
+            document.set('id', defaults.id);
+        }
+    }
+    setEdges(document, defaults.blockedBy);
+    const body = split.body.replace(/^\s+/, '').replace(/\n+$/, '');
+    return `---\n${render(document)}\n---\n\n${body}\n`;
+}
+/**
+ * Apply an edit to a Ticket file, returning the new contents.
+ *
+ * Per ADR 0003 the frontmatter is mutated as a parsed YAML document rather than
+ * rebuilt from an object, so comments, key order and quoting style survive on
+ * every field the edit did not name. The body is a string this only ever
+ * appends to or replaces one known section of.
+ */
+export function applyEdit(contents, edit, defaults) {
+    const split = splitFrontmatter(contents);
+    const document = existingDocument(split.hasFence ? split.raw : undefined) ?? schemaFor(defaults);
+    for (const [field, value] of fieldsOf(edit)) {
+        if (value === null)
+            document.delete(field);
+        else
+            document.set(field, value);
+    }
+    if (edit.blockedBy !== undefined)
+        setEdges(document, edit.blockedBy);
+    const frontmatter = render(document);
+    // Only the outer edges are trimmed, and only newlines at the end — trailing
+    // spaces on the last line of a comment are part of what the author wrote.
+    let body = split.body.replace(/^\s+/, '').replace(/\n+$/, '');
+    body = withTicks(body, edit.tick);
+    // The answer goes in before the comment log so the log stays at the bottom,
+    // which is where the skills append and where a reader looks for it.
+    body = withAnswer(body, edit.answer);
+    body = withComment(body, edit.comment);
+    return `---\n${frontmatter}\n---\n\n${body}\n`;
+}
+/**
+ * The Edge list, replaced whole rather than merged — a caller changing Edges
+ * knows which ones it wants, and a merge would leave no way to remove one.
+ *
+ * The existing collection style survives: a Ticket written `blocked_by: [T3]`
+ * must not come back as a block list just because its Edges changed. That is the
+ * same rule as the rest of ADR 0003, applied to the one field being named.
+ */
+function setEdges(document, blockedBy) {
+    const existing = document.get('blocked_by', true);
+    const flow = isSeq(existing) ? existing.flow === true : true;
+    document.set('blocked_by', document.createNode([...blockedBy], { flow }));
+}
+/** Where a `##` section ends: the next `##` heading, or the end of the body. */
+function endOfSection(body, from) {
+    const after = body.slice(from);
+    const next = NEXT_SECTION.exec(after);
+    return next === null ? body.length : from + next.index;
+}
+/**
+ * Tick acceptance criteria by their text. Only the checkbox marker changes —
+ * the line keeps its own indentation and wording, and every other line of the
+ * body is untouched, so progress is visible without rewriting the body around
+ * it. Wrapped criteria match both as `get_tickets` returns them and re-joined
+ * onto one line; comparison collapses whitespace so neither form needs special
+ * casing.
+ */
+function withTicks(body, tick) {
+    if (tick === undefined || tick.length === 0)
+        return body;
+    const lines = body.split('\n');
+    const criteria = findCriteria(lines);
+    // Resolve every reference before changing anything, so an ambiguous or
+    // unmatched one leaves the file exactly as it was.
+    const targets = tick.map(asked => ({ asked, line: resolveCriterion(asked, criteria) }));
+    const ticked = [...lines];
+    for (const { line } of targets) {
+        const box = CHECKBOX.exec(ticked[line] ?? '');
+        if (box !== null)
+            ticked[line] = `${box[1]}x${box[3]}${box[4]}`;
+    }
+    return ticked.join('\n');
+}
+const CHECKBOX = /^(\s*[-*]\s*\[)( |x|X)(\]\s*)(.*)$/;
+/** A fenced code block, where a `- [ ]` is illustration rather than a criterion. */
+const FENCE_LINE = /^\s*(?:```|~~~)/;
+/**
+ * Collapse runs of whitespace (including newlines and continuation indent) so
+ * a wrapped criterion matches both the `get_tickets` form and a single-line
+ * rejoin of the same words.
+ */
+function collapseCriterionText(text) {
+    return text.replace(/\s+/g, ' ').trim().toLowerCase();
+}
+/**
+ * A continuation of the criterion above: indented prose that is not itself a
+ * checkbox, heading, or fence. Blank lines end the wrap — house style never
+ * leaves a hole inside a criterion.
+ */
+function isCriterionContinuation(line) {
+    if (line.trim() === '')
+        return false;
+    if (CHECKBOX.test(line))
+        return false;
+    if (FENCE_LINE.test(line))
+        return false;
+    if (/^#{1,6}\s/.test(line))
+        return false;
+    return /^\s+\S/.test(line);
+}
+/** Checkbox lines outside any code fence — the ones that are really criteria. */
+function findCriteria(lines) {
+    const criteria = [];
+    let fenced = false;
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index] ?? '';
+        if (FENCE_LINE.test(line)) {
+            fenced = !fenced;
+            continue;
+        }
+        if (fenced)
+            continue;
+        const box = CHECKBOX.exec(line);
+        if (box === null)
+            continue;
+        const checkboxLine = index;
+        const parts = [box[4] ?? ''];
+        while (index + 1 < lines.length && isCriterionContinuation(lines[index + 1] ?? '')) {
+            index += 1;
+            parts.push(lines[index] ?? '');
+        }
+        criteria.push({ line: checkboxLine, text: collapseCriterionText(parts.join('\n')) });
+    }
+    return criteria;
+}
+/**
+ * Exact text wins. Otherwise a substring is accepted only when it names exactly
+ * one criterion — a reference that fits several is a question, not an
+ * instruction, and ticking all of them would be answering it on the caller's
+ * behalf.
+ */
+function resolveCriterion(asked, criteria) {
+    const target = collapseCriterionText(asked);
+    const exact = criteria.filter(criterion => criterion.text === target);
+    if (exact.length === 1)
+        return exact[0]?.line ?? -1;
+    if (exact.length > 1)
+        throw new Error(`"${asked}" matches ${String(exact.length)} criteria.`);
+    const partial = criteria.filter(criterion => criterion.text.includes(target));
+    if (partial.length === 1)
+        return partial[0]?.line ?? -1;
+    if (partial.length > 1) {
+        throw new Error(`"${asked}" matches ${String(partial.length)} criteria — name one exactly: ` +
+            partial.map(criterion => `"${criterion.text}"`).join(', '));
+    }
+    throw new Error(`No acceptance criterion matches "${asked}".`);
+}
+/**
+ * Append to the comment log, creating its heading the first time. The comment
+ * is stored exactly as written — nothing is prepended, appended, or reformatted
+ * around it, including `/triage`'s mandatory disclaimer, which is the skill's
+ * own to write and not ours to inject.
+ */
+function withComment(body, comment) {
+    if (comment === undefined)
+        return body;
+    const heading = /^##[ \t]+Comments[ \t]*$/m.exec(body);
+    if (heading === null)
+        return `${body}\n\n${COMMENTS_HEADING}\n\n${comment}`;
+    // At the end of the Comments section, not the end of the body — a Ticket
+    // whose log is followed by another section would otherwise take the comment
+    // into whichever section happens to come last.
+    const end = endOfSection(body, heading.index + heading[0].length);
+    const before = body.slice(0, end).replace(/\n+$/, '');
+    const rest = body.slice(end);
+    return rest === '' ? `${before}\n\n${comment}` : `${before}\n\n${comment}\n\n${rest}`;
+}
+/**
+ * The existing frontmatter, or undefined when there is none to preserve. A fence
+ * whose YAML does not parse cannot be round-tripped — `yaml` refuses to
+ * stringify a document carrying errors — so it is rebuilt from the schema
+ * instead, which is what "strict on write" means for a file this broken.
+ */
+function existingDocument(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parsed = parseDocument(raw);
+    return parsed.errors.length > 0 ? undefined : parsed;
+}
+function fieldsOf(edit) {
+    const pairs = [];
+    if (edit.status !== undefined)
+        pairs.push(['status', edit.status]);
+    if (edit.triage !== undefined)
+        pairs.push(['triage', edit.triage]);
+    if (edit.claimedBy !== undefined)
+        pairs.push(['claimed_by', edit.claimedBy]);
+    if (edit.claimedAt !== undefined)
+        pairs.push(['claimed_at', edit.claimedAt]);
+    if (edit.answerGist !== undefined)
+        pairs.push(['answer_gist', edit.answerGist]);
+    if (edit.droppedReason !== undefined)
+        pairs.push(['dropped_reason', edit.droppedReason]);
+    return pairs;
+}
+/**
+ * A Ticket file as first written. Everything is a field this driver is creating,
+ * so the whole block is in schema order — the one case where that is allowed,
+ * since there is no author's ordering to preserve.
+ *
+ * The body is the caller's prose, stored verbatim. A draft with none produces a
+ * Ticket with none rather than a heading nobody asked for.
+ */
+export function serializeNew(fields, body) {
+    const frontmatter = render(schemaFor(fields));
+    const prose = body?.trim() ?? '';
+    return prose === '' ? `---\n${frontmatter}\n---\n` : `---\n${frontmatter}\n---\n\n${prose}\n`;
+}
+/**
+ * `lineWidth: 0` stops long values being re-wrapped, and without
+ * `flowCollectionPadding: false` an untouched `[a, b]` comes back `[ a, b ]` —
+ * both would be reformatting a field the edit never named.
+ */
+function render(document) {
+    return document.toString({ lineWidth: 0, flowCollectionPadding: false }).trimEnd();
+}
+/**
+ * A Legacy file has no frontmatter, so a write is where it gets one — the
+ * "strict on write" half of the contract: the tracker converts itself as it is
+ * worked rather than in one risky pass. Only a created block gets to be in the
+ * schema's field order.
+ */
+function schemaFor(defaults) {
+    const document = new Document({});
+    const values = {
+        ...(defaults.id === undefined ? {} : { id: defaults.id }),
+        title: defaults.title,
+        kind: defaults.kind,
+        ...(defaults.type === undefined ? {} : { type: defaults.type }),
+        status: defaults.status,
+        ...(defaults.triage === undefined ? {} : { triage: defaults.triage }),
+        // Flow, because that is how every Ticket in these repos is written by hand
+        // and a normalized file should not stand out from the ones beside it.
+        blocked_by: document.createNode([...defaults.blockedBy], { flow: true }),
+    };
+    for (const field of FIELD_ORDER) {
+        const value = values[field];
+        if (value !== undefined)
+            document.set(field, value);
+    }
+    return document;
+}
+/**
+ * The answer replaces the Answer section and nothing else. Slicing to the end of
+ * the body would take the comment log with it — a Ticket body is opaque apart
+ * from the three places the schema says are edited.
+ */
+function withAnswer(body, answer) {
+    if (answer === undefined)
+        return body;
+    const section = `${ANSWER_HEADING}\n\n${answer.trim()}`;
+    const start = findAnswerHeading(body);
+    if (start === -1) {
+        // No Answer section yet. It goes above the comment log if there is one, so
+        // the log stays at the bottom where it is appended and read.
+        const comments = /^##[ \t]+Comments[ \t]*$/m.exec(body);
+        if (comments === null)
+            return `${body}\n\n${section}`;
+        const head = body.slice(0, comments.index).replace(/\n+$/, '');
+        return `${head}\n\n${section}\n\n${body.slice(comments.index)}`;
+    }
+    const end = endOfSection(body, start + ANSWER_HEADING.length);
+    const head = body.slice(0, start).replace(/\n+$/, '');
+    const rest = body.slice(end).replace(/^\n+/, '');
+    return rest === '' ? `${head}\n\n${section}` : `${head}\n\n${section}\n\n${rest}`;
+}
+/** `## Answer` at the start of a line, and not the start of `## Answerable`. */
+function findAnswerHeading(body) {
+    const match = /^##[ \t]+Answer[ \t]*$/m.exec(body);
+    return match?.index ?? -1;
+}
+//# sourceMappingURL=serialize.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { Ticket } from '../../domain.ts';
+export interface TicketFile {
+    readonly filename: string;
+    readonly contents: string;
+}
+/**
+ * Parse one Ticket file. Schema-conformant files read from their frontmatter;
+ * everything else falls through to the Legacy parser and is flagged, because a
+ * server that is useless until its repo is migrated never gets installed.
+ */
+export declare function parseTicket(effort: string, file: TicketFile, fallbackOrder: number, revision: string): Ticket;
+//# sourceMappingURL=ticket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.d.ts","sourceRoot":"","sources":["../../../src/storage/markdown/ticket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAQ5D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CA6BR"}