frontier-mcp 0.1.0

package/dist/server.js

@@ -0,0 +1,210 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { frontierOf } from './frontier.js';
+import { createIndexRegistry } from './workspace-index.js';
+import { createMarkdownDriver } from './storage/markdown/driver.js';
+import { NoSuchMap, RevisionMismatch } from './storage/driver.js';
+import { createTicketsDescription, createTicketsInputSchema, planBatch, renderCreated, } from './tools/create-tickets.js';
+import { editMapDescription, editMapInputSchema, mapEditFor, renderMap } from './tools/edit-map.js';
+import { boardFor, getBoardDescription, getBoardInputSchema, renderBoard, } from './tools/get-board.js';
+import { getTicketsDescription, getTicketsInputSchema, renderTickets, } from './tools/get-tickets.js';
+import { listEffortsDescription, listEffortsInputSchema, renderEfforts, } from './tools/list-efforts.js';
+import { migrateEffortDescription, migrateEffortInputSchema, renderMigration, } from './tools/migrate-effort.js';
+import { renderSpec, specDescription, specInputSchema } from './tools/spec.js';
+import { editFor, renderUpdate, updateTicketDescription, updateTicketInputSchema, } from './tools/update-ticket.js';
+import { readTrackerDoc, TRACKER_DOC_URI } from './tracker-doc.js';
+import { resolveWorkspace } from './workspace.js';
+export const SERVER_NAME = 'frontier';
+export const SERVER_VERSION = '0.1.0';
+/** Injectable so a test can pin the moment a claim was taken. */
+function now() {
+    return new Date().toISOString();
+}
+export function createFrontierMCP(options = {}) {
+    const context = {
+        cwd: options.cwd ?? process.cwd(),
+        env: options.env ?? process.env,
+    };
+    const registry = createIndexRegistry(options.createDriver ?? createMarkdownDriver, options.watcherDebounceMs === undefined ? {} : { watcherDebounceMs: options.watcherDebounceMs });
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {}, resources: {} } });
+    server.registerResource('tracker-doc', TRACKER_DOC_URI, {
+        title: 'Issue tracker configuration',
+        description: 'Tracker conventions and FrontierMCP tool mapping. Read once at setup; file conventions work as fallback without the server.',
+        mimeType: 'text/markdown',
+    }, async () => ({
+        contents: [{ uri: TRACKER_DOC_URI, mimeType: 'text/markdown', text: readTrackerDoc() }],
+    }));
+    server.registerTool('list_efforts', {
+        title: 'List Efforts',
+        description: listEffortsDescription,
+        inputSchema: listEffortsInputSchema,
+        annotations: { readOnlyHint: true },
+    }, async ({ root }) => {
+        const workspace = resolveWorkspace(root, context);
+        const index = registry.forWorkspace(workspace);
+        const [efforts, tickets] = await Promise.all([index.efforts(), index.tickets()]);
+        return {
+            content: [{ type: 'text', text: renderEfforts(workspace, efforts, frontierOf(tickets)) }],
+        };
+    });
+    server.registerTool('get_board', {
+        title: 'Get Board',
+        description: getBoardDescription,
+        inputSchema: getBoardInputSchema,
+        annotations: { readOnlyHint: true },
+    }, async ({ effort: slug, root }) => {
+        const workspace = resolveWorkspace(root, context);
+        const index = registry.forWorkspace(workspace);
+        const [efforts, tickets] = await Promise.all([index.efforts(), index.tickets()]);
+        const effort = efforts.find(candidate => candidate.slug === slug);
+        if (effort === undefined) {
+            throw new Error(`No Effort '${slug}' in ${workspace}. Known: ${efforts.map(e => e.slug).join(', ') || '(none)'}`);
+        }
+        return { content: [{ type: 'text', text: renderBoard(boardFor(effort, tickets)) }] };
+    });
+    server.registerTool('get_tickets', {
+        title: 'Get Tickets',
+        description: getTicketsDescription,
+        inputSchema: getTicketsInputSchema,
+        annotations: { readOnlyHint: true },
+    }, async ({ ids, root }) => {
+        const workspace = resolveWorkspace(root, context);
+        const tickets = await registry.forWorkspace(workspace).tickets();
+        const wanted = new Set(ids);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: renderTickets(ids, tickets.filter(ticket => wanted.has(ticket.handle) || (ticket.id !== undefined && wanted.has(ticket.id)))),
+                },
+            ],
+        };
+    });
+    server.registerTool('create_tickets', {
+        title: 'Create Tickets',
+        description: createTicketsDescription,
+        inputSchema: createTicketsInputSchema,
+        annotations: { readOnlyHint: false, idempotentHint: false },
+    }, async ({ effort, create, tickets, root }) => {
+        const workspace = resolveWorkspace(root, context);
+        const index = registry.forWorkspace(workspace);
+        // Every reference resolves before anything is written, so a refusal —
+        // an unknown key, a cycle — leaves the workspace exactly as it was. The
+        // one rule that needs real ids runs under the driver's reservations,
+        // still before any file lands.
+        const { drafts, validate } = planBatch(tickets, await index.tickets());
+        const created = await index.create(effort, drafts, {
+            createEffort: create === true,
+            validate,
+        });
+        return { content: [{ type: 'text', text: renderCreated(effort, created) }] };
+    });
+    server.registerTool('update_ticket', {
+        title: 'Update Ticket',
+        description: updateTicketDescription,
+        inputSchema: updateTicketInputSchema,
+        annotations: { readOnlyHint: false, idempotentHint: false },
+    }, async ({ id, claim, resolve, drop, status, triage, blocked_by, comment, tick, root }) => {
+        const workspace = resolveWorkspace(root, context);
+        const index = registry.forWorkspace(workspace);
+        const tickets = await index.tickets();
+        const request = { claim, resolve, drop, status, triage, blocked_by, comment, tick };
+        const find = (from) => {
+            const ticket = from.find(entry => entry.id === id || entry.handle === id);
+            if (ticket === undefined)
+                throw new Error(`No Ticket '${id}' in ${workspace}.`);
+            return ticket;
+        };
+        const ticket = find(tickets);
+        let written;
+        try {
+            written = await index.update(ticket.handle, editFor(ticket, tickets, request, now()), ticket.revision);
+        }
+        catch (error) {
+            if (!(error instanceof RevisionMismatch))
+                throw error;
+            // The Ticket moved under us. Re-read and re-validate, but only to
+            // explain why: most often a parallel session claimed it, and "already
+            // claimed by agent-3" is the useful message. The write is never
+            // retried — a mismatch may equally be somebody's hand edit, and
+            // overwriting that is exactly what the check exists to prevent.
+            const fresh = await index.tickets();
+            editFor(find(fresh), fresh, request, now());
+            throw error;
+        }
+        return {
+            content: [{ type: 'text', text: renderUpdate(written.ticket, written.warnings) }],
+        };
+    });
+    server.registerTool('edit_map', {
+        title: 'Edit Map',
+        description: editMapDescription,
+        inputSchema: editMapInputSchema,
+        annotations: { readOnlyHint: false, idempotentHint: false },
+    }, async ({ effort, create, destination, notes, add_fog, graduate_fog, rule_out, expected_revision, root, }) => {
+        const workspace = resolveWorkspace(root, context);
+        const index = registry.forWorkspace(workspace);
+        const edit = mapEditFor({ destination, notes, add_fog, graduate_fog, rule_out });
+        const mutating = Object.keys(edit).length > 0;
+        // create alone is for starting a missing Effort/Map — not a flag to send
+        // on every call. With no section fields, an existing Map is a plain read
+        // (no expected_revision); only a missing Map takes the write path.
+        let document;
+        if (!mutating) {
+            try {
+                document = await index.readMap(effort);
+            }
+            catch (error) {
+                if (!(create === true && error instanceof NoSuchMap))
+                    throw error;
+                document = await index.editMap(effort, edit, undefined, { createEffort: true });
+            }
+        }
+        else {
+            document = await index.editMap(effort, edit, expected_revision, {
+                createEffort: create === true,
+            });
+        }
+        return { content: [{ type: 'text', text: renderMap(effort, document) }] };
+    });
+    server.registerTool('spec', {
+        title: 'Spec',
+        description: specDescription,
+        inputSchema: specInputSchema,
+        annotations: { readOnlyHint: false, idempotentHint: false },
+    }, async ({ effort, create, content, expected_revision, root }) => {
+        const workspace = resolveWorkspace(root, context);
+        const index = registry.forWorkspace(workspace);
+        const document = content === undefined
+            ? await index.readSpec(effort)
+            : await index.putSpec(effort, content, expected_revision, {
+                createEffort: create === true,
+            });
+        return { content: [{ type: 'text', text: renderSpec(effort, document) }] };
+    });
+    server.registerTool('migrate_effort', {
+        title: 'Migrate Effort',
+        description: migrateEffortDescription,
+        inputSchema: migrateEffortInputSchema,
+        annotations: { readOnlyHint: false, idempotentHint: false },
+    }, async ({ effort, preview, rename, root }) => {
+        const workspace = resolveWorkspace(root, context);
+        const index = registry.forWorkspace(workspace);
+        const report = await index.migrate(effort, {
+            preview: preview === true,
+            rename: rename === true,
+        });
+        return { content: [{ type: 'text', text: renderMigration(report) }] };
+    });
+    return {
+        server,
+        async warmUp() {
+            const workspace = resolveWorkspace(undefined, context);
+            await registry.forWorkspace(workspace).efforts();
+        },
+        async close() {
+            registry.closeAll();
+            await server.close();
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/storage/driver.d.ts

@@ -0,0 +1,131 @@
+import type { Effort, MapDocument, MapEdit, MigrateOptions, MigrationReport, SpecDocument, Ticket, TicketDraft, TicketEdit } from '../domain.ts';
+export type { MapDocument, MapEdit, MigrateOptions, MigrationReport, SpecDocument, TicketDraft, TicketEdit, };
+export interface CreateOptions {
+    /**
+     * Create the Effort rather than failing when the workspace does not hold it.
+     * Off by default, so starting work is one deliberate call while a mistyped
+     * slug never silently forks an Effort.
+     */
+    readonly createEffort: boolean;
+    /**
+     * Called with the ids about to be written, in draft order, and the workspace
+     * as it looks under those reservations. Runs before anything lands, so
+     * throwing abandons the batch and nothing is created — not the Tickets, and
+     * not the Effort either.
+     *
+     * It exists for the rules that cannot be checked until the ids are real. A
+     * cycle is the one that matters: a Ticket already on disk may declare an Edge
+     * on an id nobody has minted yet, which the Board reports as dangling — and
+     * minting exactly that id is the moment it becomes a loop. Nothing above the
+     * seam can see that coming, because nothing above the seam knows what the
+     * next id will be.
+     */
+    readonly validate?: (ids: readonly string[], tickets: readonly Ticket[]) => void;
+}
+/**
+ * Whether a Header-doc write may start an Effort that does not yet exist.
+ * Off by default — same reason as {@link CreateOptions.createEffort}.
+ */
+export interface HeaderDocOptions {
+    readonly createEffort: boolean;
+}
+/**
+ * The seam from ADR 0001. Every read and write reaches storage through this
+ * interface, and the tool layer never touches a filesystem.
+ *
+ * Nothing markdown-shaped may cross it — no file paths, no frontmatter, no
+ * section names. A driver is constructed already bound to its workspace (the
+ * markdown driver takes a directory, a SQLite driver would take a connection),
+ * so no method ever takes or returns a location. The planned SQLite driver, and
+ * the `md <-> db` conversion either side of it, are only writable if this holds.
+ */
+export interface StorageDriver {
+    /**
+     * Every Effort in the workspace, ordered by slug. A workspace holding no
+     * Efforts yields an empty list; that is not an error.
+     */
+    listEfforts(): Promise<readonly Effort[]>;
+    /**
+     * Every Ticket in the workspace, ordered by Effort then by sort order. Ids
+     * resolve repo-wide, so callers that need one Effort filter this rather than
+     * asking for a subset — at these volumes the whole set is the cheap answer.
+     */
+    listTickets(): Promise<readonly Ticket[]>;
+    /**
+     * Apply an edit to one Ticket and return it as written.
+     *
+     * `expectedRevision` is the {@link TicketSummary.revision} the caller last
+     * read. The driver refuses the write if the stored Ticket has moved on since,
+     * so a concurrent edit fails loudly instead of being clobbered. The write is
+     * atomic: it either lands whole or not at all.
+     *
+     * Resolving or dropping also refreshes the Map's derived blocks. That refresh
+     * is best-effort: a failure after the Ticket write still returns success, with
+     * a warning that Decisions-so-far / dropped Out-of-scope may be stale.
+     */
+    updateTicket(handle: string, edit: TicketEdit, expectedRevision: string): Promise<TicketWriteResult>;
+    /**
+     * Create a whole set of Tickets in one Effort and return them as written, in
+     * the order asked for.
+     *
+     * The batch is the unit for a reason: the driver mints every id, resolves
+     * every {@link TicketDraft.key} an Edge names into the id it was given, and
+     * either creates all of them or none. Splitting this into a create call and a
+     * wire-them-up call is the second pass this exists to delete.
+     *
+     * Ids are unique across the whole workspace, and stay unique when two sessions
+     * in separate processes create at the same instant.
+     */
+    createTickets(effort: string, drafts: readonly TicketDraft[], options: CreateOptions): Promise<readonly Ticket[]>;
+    /**
+     * The Map's typed sections for one Effort. Decisions-so-far is not here — it
+     * is derived from Tickets and never read from the file.
+     */
+    readMap(effort: string): Promise<MapDocument>;
+    /**
+     * Apply a section edit to a Map and regenerate its derived blocks. Reads go
+     * through {@link readMap} — the tool layer never uses an empty edit as a
+     * refresh; resolve/drop refresh the derived blocks on their own path.
+     */
+    editMap(effort: string, edit: MapEdit, expectedRevision: string | undefined, options: HeaderDocOptions): Promise<MapDocument>;
+    /** A Spec as an opaque document. Absent when the Effort has none. */
+    readSpec(effort: string): Promise<SpecDocument>;
+    /** Replace a Spec wholesale with opaque document bytes. */
+    putSpec(effort: string, body: string, expectedRevision: string | undefined, options: HeaderDocOptions): Promise<SpecDocument>;
+    /**
+     * Normalize every Legacy Ticket in one Effort, mint ids for Tickets that have
+     * none, and optionally rename files to the schema convention. Preview writes
+     * nothing. Unrecognized files in the Effort directory are ignored.
+     */
+    migrateEffort(effort: string, options: MigrateOptions): Promise<MigrationReport>;
+}
+/** A Ticket write, plus any non-fatal warnings that rode along. */
+export interface TicketWriteResult {
+    readonly ticket: Ticket;
+    readonly warnings: readonly string[];
+}
+/** Thrown when the stored Ticket moved on since the caller read it. */
+export declare class RevisionMismatch extends Error {
+    constructor(handle: string);
+}
+/** Thrown when the edit names a Ticket the workspace does not hold. */
+export declare class NoSuchTicket extends Error {
+    constructor(handle: string);
+}
+/** Thrown when a creation names an Effort that does not exist and may not be made. */
+export declare class NoSuchEffort extends Error {
+    constructor(slug: string);
+}
+/** Thrown when a Map operation names an Effort that holds no Map. */
+export declare class NoSuchMap extends Error {
+    constructor(slug: string);
+}
+/** Thrown when a Spec operation names an Effort that holds no Spec. */
+export declare class NoSuchSpec extends Error {
+    constructor(slug: string);
+}
+/** Thrown when graduating a fog patch that the Map does not hold. */
+export declare class NoSuchFogPatch extends Error {
+    constructor(patch: string);
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/storage/driver.d.ts.map

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

package/dist/storage/driver.js

@@ -0,0 +1,43 @@
+/** Thrown when the stored Ticket moved on since the caller read it. */
+export class RevisionMismatch extends Error {
+    constructor(handle) {
+        super(`${handle} changed on disk since it was read. Nothing was written — re-read it and retry.`);
+        this.name = 'RevisionMismatch';
+    }
+}
+/** Thrown when the edit names a Ticket the workspace does not hold. */
+export class NoSuchTicket extends Error {
+    constructor(handle) {
+        super(`No Ticket '${handle}' in this workspace.`);
+        this.name = 'NoSuchTicket';
+    }
+}
+/** Thrown when a creation names an Effort that does not exist and may not be made. */
+export class NoSuchEffort extends Error {
+    constructor(slug) {
+        super(`No Effort '${slug}' in this workspace. Pass create to start it.`);
+        this.name = 'NoSuchEffort';
+    }
+}
+/** Thrown when a Map operation names an Effort that holds no Map. */
+export class NoSuchMap extends Error {
+    constructor(slug) {
+        super(`No Map for Effort '${slug}'.`);
+        this.name = 'NoSuchMap';
+    }
+}
+/** Thrown when a Spec operation names an Effort that holds no Spec. */
+export class NoSuchSpec extends Error {
+    constructor(slug) {
+        super(`No Spec for Effort '${slug}'.`);
+        this.name = 'NoSuchSpec';
+    }
+}
+/** Thrown when graduating a fog patch that the Map does not hold. */
+export class NoSuchFogPatch extends Error {
+    constructor(patch) {
+        super(`No fog patch matching '${patch}' under Not yet specified.`);
+        this.name = 'NoSuchFogPatch';
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/storage/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/storage/driver.ts"],"names":[],"mappings":"AA4JA,uEAAuE;AACvE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,MAAc;QACxB,KAAK,CACH,GAAG,MAAM,iFAAiF,CAC3F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,MAAc;QACxB,KAAK,CAAC,cAAc,MAAM,sBAAsB,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,sFAAsF;AACtF,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,IAAY;QACtB,KAAK,CAAC,cAAc,IAAI,+CAA+C,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,IAAY;QACtB,KAAK,CAAC,sBAAsB,IAAI,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,IAAY;QACtB,KAAK,CAAC,uBAAuB,IAAI,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,KAAa;QACvB,KAAK,CAAC,0BAA0B,KAAK,4BAA4B,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

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

@@ -0,0 +1,52 @@
+import type { Ticket, TicketDraft } from '../../domain.ts';
+/** Every Ticket in the workspace, re-read rather than served from any cache. */
+export type Rescan = () => Promise<readonly Ticket[]>;
+export interface CreateRequest {
+    /** Where the id guards live: one namespace for the whole workspace. */
+    readonly scratch: string;
+    readonly effort: string;
+    /** The Effort's directory, and the directory its Tickets go in. Both owned by the driver. */
+    readonly dir: string;
+    readonly issues: string;
+    readonly drafts: readonly TicketDraft[];
+    /** Re-read the workspace. Called under the guards, so it must not be cached. */
+    readonly rescan: Rescan;
+    /**
+     * The last check, run with the reserved ids and the workspace as it looks
+     * under the guards. Throwing abandons the batch before anything is written.
+     */
+    readonly validate: (ids: readonly string[], tickets: readonly Ticket[]) => void;
+    /** Whether the Effort's directory has to be made, and unmade if nothing lands. */
+    readonly createEffort: boolean;
+}
+/**
+ * Create every Ticket in the batch, or none, and return the filenames written in
+ * the order asked for.
+ *
+ * Ids are `max + 1` over the whole workspace — derived, so there is no counter
+ * file to drift — and made safe against a parallel session by an exclusive
+ * create: `open(..., 'wx')` on a guard named for the candidate id, bumping to the
+ * next candidate on collision. The filesystem provides the mutual exclusion.
+ *
+ * The guard alone is not compare-and-set. A session that scanned before ours and
+ * finished writing after would hand us an id it has already used, so the batch
+ * re-scans *while holding every guard* and starts over if any candidate has
+ * turned up on disk. That is what makes the invariant hold: a file carrying id X
+ * is only ever written while X's guard is held, and the guard is only kept when a
+ * scan taken after acquiring it shows X unused — so two sessions can never both
+ * write X. See ADR 0005.
+ */
+export declare function createTicketFiles(request: CreateRequest): Promise<readonly string[]>;
+/**
+ * Hold exclusive id guards for `count` fresh ids, run `use`, then release.
+ * Migration mints through this so a parallel create_tickets cannot collide.
+ */
+export declare function withIdReservations<T>(scratch: string, count: number, rescan: Rescan, use: (ids: readonly string[]) => Promise<T>): Promise<T>;
+/**
+ * The next `count` minted ids from a scan, without taking guards. Preview uses
+ * this so a dry run never leaves `.frontier-id-*.guard` files behind.
+ */
+export declare function peekMintedIds(used: ReadonlySet<string>, count: number): readonly string[];
+/** The cosmetic filename convention: `<NN>-T<n>-<slug>.md`. */
+export declare function ticketFilename(order: number, id: string, title: string): string;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/storage/markdown/create.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAyB3D,gFAAgF;AAChF,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAChF,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CA4B1F;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAWzF;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/E"}