crewly 1.20.153 → 1.20.154

package/dist/backend/backend/src/services/project-tickets/project-ticket.service.js

@@ -0,0 +1,466 @@
+/**
+ * Project ticket store — list / get / create / update / transition the
+ * markdown tickets of one project (specs/2026-09-28-project-tickets.md).
+ *
+ * Storage is the project folder itself (`<project>/.crewly/tickets/`), which
+ * is tracked in git and edited by humans too. So:
+ * - every read goes through a cheap mtime/size-keyed cache (one `readdir` +
+ *   `stat` per list), which is how edits made by hand or by a `git pull` are
+ *   picked up — no long-lived watcher to leak or miss events;
+ * - every write re-reads the file under the folder lock, applies only the
+ *   owned-field / Log changes ({@link applyTicketChanges}) and writes
+ *   atomically;
+ * - files that are not valid tickets are skipped with a warning and reported
+ *   in `invalid[]`, never fatal.
+ *
+ * This layer knows nothing about teams, agents or WorkItems — permissions and
+ * the WorkItem link live in `ProjectTicketWorkflowService`.
+ *
+ * @module services/project-tickets/project-ticket.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { PROJECT_TICKET_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+import { resolveProjectDataDir } from '../core/crewly-home.utils.js';
+import { atomicWriteFile } from '../../utils/file-io.utils.js';
+import { isValidProjectTicketTransition, normalizeProjectTicketPriority, } from '../../types/project-ticket.types.js';
+import { applyTicketChanges, formatLogLine, parseTicketFile, renderNewTicketFile, slugifyTitle, } from './ticket-file.js';
+import { allocateTicketId, withTicketFolderLock } from './ticket-folder-lock.js';
+import { ensureTicketsTracked } from './ticket-tracking.js';
+/** An error with the HTTP status the API should answer with. */
+export class ProjectTicketError extends Error {
+    status;
+    /**
+     * @param status - HTTP status (400 bad input, 403 not allowed, 404 missing, 409 conflict)
+     * @param message - Human-readable reason
+     */
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'ProjectTicketError';
+    }
+}
+/**
+ * Normalise acceptance input to criteria.
+ *
+ * @param items - Strings or criteria
+ * @returns Criteria (empty texts dropped)
+ */
+function toCriteria(items) {
+    return items
+        .map((c) => (typeof c === 'string' ? { text: c, done: false } : { text: String(c.text ?? ''), done: c.done === true }))
+        .map((c) => ({ ...c, text: c.text.trim() }))
+        .filter((c) => c.text.length > 0);
+}
+/**
+ * Read a priority input or fail with 400.
+ *
+ * @param value - Raw priority
+ * @returns The priority
+ * @throws ProjectTicketError(400) when unreadable
+ */
+function requirePriority(value) {
+    const p = normalizeProjectTicketPriority(value);
+    if (!p)
+        throw new ProjectTicketError(400, 'priority must be P0, P1, P2 or P3');
+    return p;
+}
+/**
+ * Clean a labels list.
+ *
+ * @param labels - Raw labels
+ * @returns Trimmed, non-empty, de-duplicated
+ */
+function cleanLabels(labels) {
+    return [...new Set(labels.map((l) => String(l).trim()).filter((l) => l.length > 0))];
+}
+export class ProjectTicketService {
+    static instance = null;
+    logger;
+    now;
+    ensureTracked;
+    /** dir → fileName → parsed entry */
+    cache = new Map();
+    /** Invalid files already warned about (`path@mtime`) */
+    warned = new Set();
+    /** Projects whose git tracking was checked this process */
+    trackingChecked = new Set();
+    /**
+     * @param deps - Optional dependencies
+     */
+    constructor(deps = {}) {
+        this.logger = deps.logger ?? LoggerService.getInstance().createComponentLogger('ProjectTicketService');
+        this.now = deps.now ?? (() => new Date().toISOString());
+        this.ensureTracked = deps.ensureTracked ?? ((p) => ensureTicketsTracked(p));
+    }
+    /**
+     * Process-wide instance.
+     *
+     * @returns The singleton
+     */
+    static getInstance() {
+        if (!ProjectTicketService.instance)
+            ProjectTicketService.instance = new ProjectTicketService();
+        return ProjectTicketService.instance;
+    }
+    /** Reset the singleton (tests). */
+    static resetInstance() {
+        ProjectTicketService.instance = null;
+    }
+    /**
+     * The tickets folder of a project.
+     *
+     * @param projectPath - Absolute project root
+     * @returns `<project>/.crewly/tickets`
+     */
+    ticketsDir(projectPath) {
+        return path.join(resolveProjectDataDir(path.resolve(projectPath)), PROJECT_TICKET_CONSTANTS.DIR_NAME);
+    }
+    /**
+     * Every ticket of a project (plus the files that are not valid tickets).
+     * Sorted by status order, then priority, then id number.
+     *
+     * @param projectPath - Absolute project root
+     * @returns Tickets and invalid files
+     */
+    async list(projectPath) {
+        const root = path.resolve(projectPath);
+        const dir = this.ticketsDir(root);
+        let names;
+        try {
+            names = (await fs.readdir(dir)).filter((n) => n.endsWith('.md'));
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return { tickets: [], invalid: [] };
+            throw err;
+        }
+        const dirCache = this.cache.get(dir) ?? new Map();
+        this.cache.set(dir, dirCache);
+        for (const cached of [...dirCache.keys()])
+            if (!names.includes(cached))
+                dirCache.delete(cached);
+        const tickets = [];
+        const invalid = [];
+        const seen = new Map();
+        for (const fileName of names.sort()) {
+            const filePath = path.join(dir, fileName);
+            const result = await this.readCached(dirCache, filePath, fileName);
+            if (!result)
+                continue;
+            if (!result.ok) {
+                invalid.push({ fileName, error: result.error });
+                continue;
+            }
+            const dupOf = seen.get(result.file.fields.id);
+            if (dupOf) {
+                invalid.push({ fileName, error: `duplicate id ${result.file.fields.id} (also in ${dupOf})` });
+                continue;
+            }
+            seen.set(result.file.fields.id, fileName);
+            tickets.push(this.toTicket(result, fileName, filePath, root, false));
+        }
+        const statusOrder = PROJECT_TICKET_CONSTANTS.STATUSES;
+        const prioOrder = PROJECT_TICKET_CONSTANTS.PRIORITIES;
+        const num = (id) => Number(id.split('-').pop());
+        tickets.sort((a, b) => statusOrder.indexOf(a.status) - statusOrder.indexOf(b.status) ||
+            prioOrder.indexOf(a.priority) - prioOrder.indexOf(b.priority) ||
+            num(a.id) - num(b.id));
+        return { tickets, invalid };
+    }
+    /**
+     * One ticket by id, with its raw body.
+     *
+     * @param projectPath - Absolute project root
+     * @param id - Ticket id (case-insensitive)
+     * @returns The ticket, or null
+     */
+    async get(projectPath, id) {
+        const { tickets } = await this.list(projectPath);
+        const hit = tickets.find((t) => t.id.toLowerCase() === id.toLowerCase());
+        if (!hit)
+            return null;
+        const result = parseTicketFile(await fs.readFile(hit.filePath, 'utf8'));
+        return result.ok ? this.toTicket(result, hit.fileName, hit.filePath, hit.projectPath, true) : null;
+    }
+    /**
+     * Create a ticket. Allocates the id under the folder lock and checks git
+     * tracking on the first write into the project.
+     *
+     * @param projectPath - Absolute project root
+     * @param projectName - Project name (id prefix on first allocation)
+     * @param input - Ticket content
+     * @param actor - Who creates it (`owner`, a session name, `system`)
+     * @returns The new ticket
+     * @throws ProjectTicketError(400) on invalid input
+     */
+    async create(projectPath, projectName, input, actor) {
+        const title = typeof input.title === 'string' ? input.title.replace(/\s+/g, ' ').trim() : '';
+        if (!title)
+            throw new ProjectTicketError(400, 'title is required');
+        const priority = input.priority ? requirePriority(input.priority) : PROJECT_TICKET_CONSTANTS.DEFAULT_PRIORITY;
+        const status = input.status ?? PROJECT_TICKET_CONSTANTS.DEFAULT_STATUS;
+        const root = path.resolve(projectPath);
+        const dir = this.ticketsDir(root);
+        const now = this.now();
+        const created = await withTicketFolderLock(dir, async () => {
+            const id = await allocateTicketId(dir, projectName);
+            const fields = {
+                id,
+                title,
+                status,
+                priority,
+                assignee: input.assignee ?? null,
+                team: input.team ?? null,
+                labels: cleanLabels(input.labels ?? []),
+                ownerReview: input.ownerReview === true,
+                createdAt: input.createdAt ?? now,
+                updatedAt: now,
+                workItemId: null,
+                requestId: input.requestId ?? null,
+                source: input.source ?? null,
+                migratedFrom: input.migratedFrom ?? null,
+            };
+            const fileName = `${id}-${slugifyTitle(title)}.md`;
+            const filePath = path.join(dir, fileName);
+            const content = renderNewTicketFile({
+                fields,
+                description: input.description ?? '',
+                acceptance: toCriteria(input.acceptance ?? []),
+                logLines: [formatLogLine(actor, `created (${status})`, now)],
+            });
+            await atomicWriteFile(filePath, content);
+            return { fileName, filePath, content };
+        });
+        await this.checkTracking(root);
+        const parsed = parseTicketFile(created.content);
+        if (!parsed.ok)
+            throw new ProjectTicketError(500, `created ticket did not parse: ${parsed.error}`);
+        this.logger.info('Project ticket created', { projectPath: root, id: parsed.file.fields.id, actor });
+        return this.toTicket(parsed, created.fileName, created.filePath, root, true);
+    }
+    /**
+     * Apply a mutation computed from the current ticket, under the folder lock.
+     * The ticket is re-read inside the lock, so the mutation always sees the
+     * latest file (a human edit or another writer).
+     *
+     * @param projectPath - Absolute project root
+     * @param id - Ticket id
+     * @param actor - Who changes it (for Log lines)
+     * @param compute - Current ticket → changes (null = nothing to do)
+     * @returns The ticket after the change
+     * @throws ProjectTicketError(404) when the ticket does not exist; whatever `compute` throws
+     */
+    async mutate(projectPath, id, actor, compute) {
+        const root = path.resolve(projectPath);
+        const dir = this.ticketsDir(root);
+        const result = await withTicketFolderLock(dir, async () => {
+            const current = await this.get(root, id);
+            if (!current)
+                throw new ProjectTicketError(404, `Ticket not found: ${id}`);
+            const mutation = await compute(current);
+            if (!mutation)
+                return current;
+            const now = this.now();
+            const changes = {
+                fields: { ...(mutation.fields ?? {}), updatedAt: now },
+                description: mutation.description,
+                acceptance: mutation.acceptance,
+                logLines: (mutation.log ?? []).map((m) => formatLogLine(actor, m, now)),
+            };
+            const before = await fs.readFile(current.filePath, 'utf8');
+            const after = applyTicketChanges(before, changes);
+            if (after !== before)
+                await atomicWriteFile(current.filePath, after);
+            const parsed = parseTicketFile(after);
+            if (!parsed.ok)
+                throw new ProjectTicketError(500, `ticket no longer parses: ${parsed.error}`);
+            return this.toTicket(parsed, current.fileName, current.filePath, root, true);
+        });
+        return result;
+    }
+    /**
+     * Change editable fields / sections.
+     *
+     * @param projectPath - Absolute project root
+     * @param id - Ticket id
+     * @param input - Changes
+     * @param actor - Who changes it
+     * @param note - Optional Log note
+     * @returns Updated ticket
+     * @throws ProjectTicketError(400/404)
+     */
+    async update(projectPath, id, input, actor, note) {
+        return this.mutate(projectPath, id, actor, () => {
+            const fields = {};
+            const changed = [];
+            if (input.title !== undefined) {
+                const t = String(input.title).replace(/\s+/g, ' ').trim();
+                if (!t)
+                    throw new ProjectTicketError(400, 'title cannot be empty');
+                fields.title = t;
+                changed.push('title');
+            }
+            if (input.priority !== undefined) {
+                fields.priority = requirePriority(input.priority);
+                changed.push(`priority ${fields.priority}`);
+            }
+            if (input.labels !== undefined) {
+                fields.labels = cleanLabels(input.labels);
+                changed.push('labels');
+            }
+            if (input.team !== undefined) {
+                fields.team = input.team || null;
+                changed.push('team');
+            }
+            if (input.ownerReview !== undefined) {
+                fields.ownerReview = input.ownerReview === true;
+                changed.push('ownerReview');
+            }
+            if (input.requestId !== undefined) {
+                fields.requestId = input.requestId || null;
+                changed.push('requestId');
+            }
+            if (input.description !== undefined)
+                changed.push('description');
+            if (input.acceptance !== undefined)
+                changed.push('acceptance criteria');
+            if (changed.length === 0 && !note)
+                return null;
+            const log = changed.length > 0 ? [`updated ${changed.join(', ')}${note ? ` — ${note}` : ''}`] : [String(note)];
+            return {
+                fields,
+                description: input.description,
+                acceptance: input.acceptance !== undefined ? toCriteria(input.acceptance) : undefined,
+                log,
+            };
+        });
+    }
+    /**
+     * Move a ticket to another status, enforcing the state machine.
+     *
+     * @param projectPath - Absolute project root
+     * @param id - Ticket id
+     * @param to - New status
+     * @param actor - Who moves it
+     * @param note - Optional reason (goes into the Log line)
+     * @param extra - Other owned fields to set in the same write (assignee, workItemId…)
+     * @returns Updated ticket
+     * @throws ProjectTicketError(400) for an invalid transition, (404) when missing
+     */
+    async transition(projectPath, id, to, actor, note, extra = {}) {
+        return this.mutate(projectPath, id, actor, (t) => {
+            if (t.status === to)
+                return null;
+            if (!isValidProjectTicketTransition(t.status, to)) {
+                throw new ProjectTicketError(400, `Cannot move ${t.id} from ${t.status} to ${to}`);
+            }
+            return { fields: { ...extra, status: to }, log: [`${t.status} → ${to}${note ? ` — ${note}` : ''}`] };
+        });
+    }
+    /**
+     * Append a note to the Log.
+     *
+     * @param projectPath - Absolute project root
+     * @param id - Ticket id
+     * @param actor - Who writes it
+     * @param note - The note
+     * @returns Updated ticket
+     */
+    async appendLog(projectPath, id, actor, note) {
+        const text = String(note ?? '').trim();
+        if (!text)
+            throw new ProjectTicketError(400, 'note is required');
+        return this.mutate(projectPath, id, actor, () => ({ log: [text] }));
+    }
+    /**
+     * Read a file through the cache.
+     *
+     * @param dirCache - Cache of the folder
+     * @param filePath - File
+     * @param fileName - Name
+     * @returns Parse result, or null when the file vanished / is not a file
+     */
+    async readCached(dirCache, filePath, fileName) {
+        let stat;
+        try {
+            stat = await fs.stat(filePath);
+        }
+        catch {
+            dirCache.delete(fileName);
+            return null;
+        }
+        if (!stat.isFile())
+            return null;
+        const hit = dirCache.get(fileName);
+        if (hit && hit.mtimeMs === stat.mtimeMs && hit.size === stat.size)
+            return hit.result;
+        let result;
+        try {
+            result = parseTicketFile(await fs.readFile(filePath, 'utf8'));
+        }
+        catch (err) {
+            result = { ok: false, error: err instanceof Error ? err.message : String(err) };
+        }
+        dirCache.set(fileName, { mtimeMs: stat.mtimeMs, size: stat.size, result });
+        if (!result.ok) {
+            const key = `${filePath}@${stat.mtimeMs}`;
+            if (!this.warned.has(key)) {
+                this.warned.add(key);
+                this.logger.warn('Skipping invalid project ticket file', { filePath, error: result.error });
+            }
+        }
+        return result;
+    }
+    /**
+     * Build the API shape of a parsed file.
+     *
+     * @param result - Successful parse
+     * @param fileName - File name
+     * @param filePath - Absolute path
+     * @param projectPath - Project root
+     * @param withBody - Include the raw body
+     * @returns Ticket
+     */
+    toTicket(result, fileName, filePath, projectPath, withBody) {
+        const { file } = result;
+        return {
+            ...file.fields,
+            fileName,
+            filePath,
+            projectPath,
+            description: file.description,
+            acceptance: file.acceptance,
+            log: file.log,
+            extra: file.extra,
+            ...(withBody ? { body: file.body } : {}),
+        };
+    }
+    /**
+     * Check git tracking once per project per process (best-effort).
+     *
+     * @param projectPath - Project root
+     */
+    async checkTracking(projectPath) {
+        if (this.trackingChecked.has(projectPath))
+            return;
+        this.trackingChecked.add(projectPath);
+        try {
+            const outcome = await this.ensureTracked(projectPath);
+            if (outcome === 'unignored') {
+                this.logger.info('Project .gitignore updated so .crewly/tickets/ is tracked', { projectPath });
+            }
+            else if (outcome === 'still-ignored') {
+                this.logger.warn('.crewly/tickets/ is ignored by git and could not be re-included', { projectPath });
+            }
+        }
+        catch (err) {
+            this.logger.warn('Could not check git tracking of .crewly/tickets/', {
+                projectPath,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+}
+//# sourceMappingURL=project-ticket.service.js.map

package/dist/backend/backend/src/services/project-tickets/project-ticket.service.js.map

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

package/dist/backend/backend/src/services/project-tickets/ticket-file.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Project ticket file format — parse and edit one `<ID>-<slug>.md` file
+ * (specs/2026-09-28-project-tickets.md §2).
+ *
+ * The file is owned by humans as much as by Crewly: people edit the body
+ * freely, add frontmatter keys, write comments. So the writer here never
+ * re-renders a file. It edits in place:
+ * - frontmatter: only the keys in {@link OWNED_TICKET_FIELDS} are set, through
+ *   the `yaml` Document API, so unknown keys, key order and comments survive;
+ *   when no owned key changes, the frontmatter bytes are kept as they were;
+ * - body: lines are appended to the `## Log` section, and the Description /
+ *   Acceptance sections are replaced only when a caller explicitly asks.
+ * Everything else is preserved byte-for-byte.
+ *
+ * @module services/project-tickets/ticket-file
+ */
+import { type ProjectTicketCriterion, type ProjectTicketFields } from '../../types/project-ticket.types.js';
+/** Ticket ids: `<KEY>-<n>` */
+export declare const TICKET_ID_RE: RegExp;
+/** A successfully parsed ticket file. */
+export interface ParsedTicketFile {
+    /** The owned fields, validated and normalised */
+    fields: ProjectTicketFields;
+    /** Frontmatter keys the service does not own */
+    extra: Record<string, unknown>;
+    /** Everything after the closing `---` line, verbatim */
+    body: string;
+    /** Text of the Description section (trimmed) */
+    description: string;
+    /** Acceptance criteria */
+    acceptance: ProjectTicketCriterion[];
+    /** Log lines (without the leading `- `) */
+    log: string[];
+}
+/** Parse outcome: a ticket, or why the file is not one. */
+export type ParseTicketResult = {
+    ok: true;
+    file: ParsedTicketFile;
+} | {
+    ok: false;
+    error: string;
+};
+/** Changes applied by {@link applyTicketChanges}. */
+export interface TicketChanges {
+    /** Owned frontmatter fields to set */
+    fields?: Partial<ProjectTicketFields>;
+    /** Replace the Description section content */
+    description?: string;
+    /** Replace the Acceptance criteria section content */
+    acceptance?: ProjectTicketCriterion[];
+    /** Lines to append to the Log section (without `- `) */
+    logLines?: string[];
+}
+/** Content of a brand-new ticket file. */
+export interface NewTicketContent {
+    fields: ProjectTicketFields;
+    description: string;
+    acceptance: ProjectTicketCriterion[];
+    logLines: string[];
+}
+/**
+ * Render acceptance criteria as checkbox lines.
+ *
+ * @param criteria - Criteria
+ * @param eol - Line ending
+ * @returns Section content
+ */
+export declare function renderCriteria(criteria: readonly ProjectTicketCriterion[], eol?: string): string;
+/**
+ * Parse a ticket file. Never throws: an unreadable file comes back as
+ * `{ ok: false, error }` so callers can skip it with a warning.
+ *
+ * @param content - Whole file content
+ * @returns The parsed ticket, or the reason it is not one
+ *
+ * @example
+ * ```typescript
+ * const r = parseTicketFile(await fs.readFile(p, 'utf8'));
+ * if (r.ok) console.log(r.file.fields.status);
+ * ```
+ */
+export declare function parseTicketFile(content: string): ParseTicketResult;
+/**
+ * Apply changes to a ticket file, touching only owned frontmatter keys and
+ * the sections asked for.
+ *
+ * @param content - Current file content
+ * @param changes - What to change
+ * @returns New file content (identical to `content` when nothing changes)
+ * @throws When the file has no parseable frontmatter mapping
+ *
+ * @example
+ * ```typescript
+ * const next = applyTicketChanges(text, { fields: { status: 'ready' }, logLines: ['… · owner · ready'] });
+ * ```
+ */
+export declare function applyTicketChanges(content: string, changes: TicketChanges): string;
+/**
+ * Render a brand-new ticket file.
+ *
+ * @param content - Fields, description, criteria and the first log lines
+ * @returns File content
+ */
+export declare function renderNewTicketFile(content: NewTicketContent): string;
+/**
+ * A file-name slug for a title (`Export as CSV!` → `export-as-csv`).
+ *
+ * @param title - Ticket title
+ * @returns Slug (never empty)
+ */
+export declare function slugifyTitle(title: string): string;
+/**
+ * Format one Log line: `<iso> · <actor> · <message>`.
+ *
+ * @param actor - Who did it (`owner`, a session name, `system`)
+ * @param message - What happened
+ * @param at - Timestamp (defaults to now)
+ * @returns The line (without `- `)
+ */
+export declare function formatLogLine(actor: string, message: string, at?: string): string;
+//# sourceMappingURL=ticket-file.d.ts.map

package/dist/backend/backend/src/services/project-tickets/ticket-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-file.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/ticket-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACzB,MAAM,qCAAqC,CAAC;AAK7C,8BAA8B;AAC9B,eAAO,MAAM,YAAY,QAAuB,CAAC;AAejD,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,2CAA2C;IAC3C,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,UAAU,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACtC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAkLD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAAE,GAAG,SAAO,GAAG,MAAM,CAG9F;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAsClE;AAiFD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAmClF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CA6BrE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAE,MAAiC,GAAG,MAAM,CAE3G"}