@nickmeriano/task 0.7.1 → 0.9.0

package/dist/claim-io.js

@@ -0,0 +1,344 @@
+/**
+ * Ask I/O against claim branches (TAS-38, second round): a claimed ticket's
+ * truth lives on its claim branch, so ask *writes* on a claimed ticket go to
+ * the branch too — resolve, reopen, add, delete — as real commits, made and
+ * pushed without ever touching the checkout. The owner clicks a checkbox on
+ * main's board; the commit lands on `claude/task/tas-40`; the worker's next
+ * tick pulls it and sees the answer in the one place it was ever going to
+ * look. No parallel copies, no merge collision, no relay through comments.
+ *
+ * The mechanics are plain git plumbing: build the new tree in a temporary
+ * index (`read-tree` → `update-index` → `write-tree`), commit it with the
+ * branch tip as parent, and push fast-forward. A concurrent worker push just
+ * rejects ours; we refetch and reapply once against the new tip — the
+ * mutation is expressed as a function of the file's current bytes, so a
+ * retry can notice the work is already done and quietly stand down.
+ *
+ * Reads (the inbox's view of a claimed ticket) live here too, so reading and
+ * writing can never disagree about where an ask file is.
+ */
+import { rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, relative, sep } from "node:path";
+import { claimBranch, claimNamespace } from "./claim.js";
+import { gitOut, runGit } from "./git.js";
+import { commentStem, parseAskLenient, serializeAsk } from "./ticket-doc.js";
+import { ASKS_DIR, TICKETS_DIR } from "./file-store.js";
+/**
+ * Soft git (from git.ts): null on any failure — callers decide whether that's
+ * an error. These run inside `task serve` request handlers, so a network call
+ * must never wait on a human: the shared module's no-prompt env turns a
+ * would-be credential prompt into a fast failure, and its timeout bounds a
+ * wedged remote. The 30s default is kept even for the fetches and pushes
+ * here — a serve request that can't finish in that is better off failing.
+ */
+const git = gitOut;
+/** Like `git`, but with extra env — the temp-index dance needs GIT_INDEX_FILE. */
+function gitEnv(cwd, env, ...args) {
+    const result = runGit(cwd, args, { env });
+    return result.status === 0 ? result.stdout : null;
+}
+/**
+ * Every claim branch on origin right now, with its tip sha — one bounded
+ * `ls-remote`, the single unavoidable network call behind live claim status.
+ * Null means "origin can't be asked" (offline, no remote, auth would have
+ * prompted), which every caller treats as "act on file truth". This is the
+ * read-path twin of claim.ts's `remoteClaims`, deliberately separate: reads
+ * must never prompt for credentials — this runs inside `task serve` request
+ * handlers — while `task claim` itself may legitimately ask a human to log in.
+ */
+export function remoteClaimTips(store) {
+    let namespace;
+    try {
+        namespace = claimNamespace(store.config);
+    }
+    catch {
+        return null;
+    }
+    const out = git(store.root, "ls-remote", "--heads", "origin", `${namespace}*`);
+    if (out === null)
+        return null;
+    const tips = new Map();
+    for (const line of out.split("\n")) {
+        const [sha, ref] = line.split("\t");
+        if (ref?.startsWith("refs/heads/"))
+            tips.set(ref.slice("refs/heads/".length), sha);
+    }
+    return tips;
+}
+/**
+ * Make the local remote-tracking claim refs agree with the tips `ls-remote`
+ * just reported — fetching *only the branches that moved* (the tip sha says
+ * whether anything changed, so an unchanged claim costs no fetch at all) and
+ * deleting local refs for claims origin no longer has, so a released claim
+ * can't linger as a ghost. This is what keeps the inbox cheap under the UI's
+ * refetch-on-every-change behavior: steady state is one ls-remote and zero
+ * fetches.
+ */
+export function syncClaimRefs(store, namespace, tips) {
+    const stale = [...tips].filter(([branch, sha]) => git(store.root, "rev-parse", "--verify", "--quiet", `refs/remotes/origin/${branch}`) !== sha);
+    if (stale.length > 0) {
+        git(store.root, "fetch", "--quiet", "origin", ...stale.map(([branch]) => `+refs/heads/${branch}:refs/remotes/origin/${branch}`));
+    }
+    const local = git(store.root, "for-each-ref", "--format=%(refname:short)", `refs/remotes/origin/${namespace}*`);
+    for (const short of local?.split("\n") ?? []) {
+        const branch = short.replace(/^origin\//, "");
+        if (branch && !tips.has(branch)) {
+            git(store.root, "update-ref", "-d", `refs/remotes/origin/${branch}`);
+        }
+    }
+}
+/** Force-refresh one claim branch's local ref — the write path's retry needs the moved tip. */
+function fetchClaimBranch(store, branch) {
+    git(store.root, "fetch", "--quiet", "origin", `+refs/heads/${branch}:refs/remotes/origin/${branch}`);
+}
+/**
+ * The ticket's claim branch if one exists on origin right now, else null —
+ * null also for "origin unreachable". Syncs the local claim refs as a side
+ * effect when a claim is found, so subsequent branch reads see the tip the
+ * answer was based on.
+ */
+export function claimFor(store, key) {
+    try {
+        const branch = claimBranch(store.config, key);
+        const tips = remoteClaimTips(store);
+        if (!tips?.has(branch))
+            return null;
+        syncClaimRefs(store, claimNamespace(store.config), tips);
+        return branch;
+    }
+    catch {
+        return null;
+    }
+}
+/** True when this checkout *is* the claim branch — then local writes are branch writes. */
+export function onClaimBranch(store, branch) {
+    return git(store.root, "symbolic-ref", "--quiet", "--short", "HEAD") === branch;
+}
+/** The ask directory's path relative to the git toplevel — git speaks toplevel paths. */
+function askDirOnBranch(store, key) {
+    const toplevel = git(store.root, "rev-parse", "--show-toplevel");
+    if (!toplevel)
+        return null;
+    return [relative(toplevel, store.taskDir).split(sep).join("/"), TICKETS_DIR, key, ASKS_DIR]
+        .filter(Boolean)
+        .join("/");
+}
+/**
+ * The ask files of one ticket as its claim branch has them, leniently — the
+ * branch's bytes were written by another checkout and possibly an older CLI.
+ * Any git failure (ref gone between fetch and read, no asks dir) reads as
+ * "no asks on the branch", never an error.
+ */
+export function branchAsks(store, branch, key) {
+    const dir = askDirOnBranch(store, key);
+    if (!dir)
+        return [];
+    const listing = git(store.root, "ls-tree", "--name-only", `origin/${branch}:${dir}`);
+    if (!listing)
+        return [];
+    const asks = [];
+    for (const name of listing.split("\n")) {
+        if (!name.endsWith(".md") || name.startsWith("."))
+            continue;
+        const text = git(store.root, "show", `origin/${branch}:${dir}/${name}`);
+        if (text === null)
+            continue;
+        const doc = parseAskLenient(text);
+        if (!doc)
+            continue;
+        asks.push({
+            id: name.slice(0, -3),
+            taskId: store.displayId(key),
+            text: doc.body,
+            author: doc.author,
+            createdAt: doc.createdAt,
+            resolvedAt: doc.resolvedAt,
+            resolvedBy: doc.resolvedBy,
+        });
+    }
+    return asks;
+}
+/**
+ * Local and branch asks, unioned by id with the branch winning — the branch
+ * holds the claim, so its version of a shared ask is the fresher one — then
+ * re-ordinaled over the union. These are the ordinals the inbox prints and
+ * the ones a resolve against a claimed ticket accepts.
+ */
+export function mergedAsks(store, branch, task) {
+    const merged = new Map(task.asks.map((a) => [a.id, a]));
+    for (const ask of branchAsks(store, branch, task.key))
+        merged.set(ask.id, ask);
+    return [...merged.values()]
+        .sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id))
+        .map((ask, index) => ({ ...ask, ordinal: index + 1 }));
+}
+/**
+ * Commit one file change onto the claim branch and push it, without touching
+ * the checkout. `mutate` maps the file's current bytes (null = absent) to its
+ * next bytes (null = delete) — expressed that way so the fast-forward-reject
+ * retry can recompute against the moved tip, and return `null → no change`
+ * when someone else already made the edit.
+ */
+function writeOnClaimBranch(store, branch, path, message, mutate) {
+    const cwd = store.root;
+    for (let attempt = 0;; attempt++) {
+        const tip = git(cwd, "rev-parse", `refs/remotes/origin/${branch}`);
+        if (!tip)
+            throw new Error(`can't read origin/${branch} — is origin reachable?`);
+        const current = git(cwd, "show", `${tip}:${path}`);
+        const next = mutate(current);
+        if (next === current || (next === null && current === null))
+            return; // already there
+        const index = join(tmpdir(), `task-claim-index-${process.pid}-${Date.now()}`);
+        const env = { GIT_INDEX_FILE: index };
+        try {
+            if (gitEnv(cwd, env, "read-tree", tip) === null) {
+                throw new Error(`git read-tree failed on origin/${branch}`);
+            }
+            if (next === null) {
+                if (gitEnv(cwd, env, "update-index", "--force-remove", path) === null) {
+                    throw new Error(`git update-index --force-remove failed for ${path}`);
+                }
+            }
+            else {
+                const blob = runGit(cwd, ["hash-object", "-w", "--stdin"], { input: next });
+                const sha = blob.status === 0 ? blob.stdout : null;
+                if (!sha)
+                    throw new Error("git hash-object failed");
+                if (gitEnv(cwd, env, "update-index", "--add", "--cacheinfo", `100644,${sha},${path}`) === null) {
+                    throw new Error(`git update-index failed for ${path}`);
+                }
+            }
+            const tree = gitEnv(cwd, env, "write-tree");
+            if (!tree)
+                throw new Error("git write-tree failed");
+            const commit = git(cwd, "commit-tree", tree, "-p", tip, "-m", message);
+            if (!commit) {
+                throw new Error("git commit-tree failed — is git user.name/user.email configured?");
+            }
+            // The lease pins the remote ref to the tip this commit was built on:
+            // a moved branch rejects (retry below), and — the case a plain push
+            // gets dangerously wrong — a *deleted* branch rejects too, instead of
+            // being quietly re-created. A claim released mid-click must stay
+            // released; resurrecting the branch would re-lock the ticket.
+            if (git(cwd, "push", "--quiet", "origin", `${commit}:refs/heads/${branch}`, `--force-with-lease=refs/heads/${branch}:${tip}`) !== null) {
+                // Keep the local remote-tracking ref in step so an immediate re-read
+                // (the UI refetching the inbox) sees what was just pushed.
+                git(cwd, "update-ref", `refs/remotes/origin/${branch}`, commit);
+                return;
+            }
+        }
+        finally {
+            rmSync(index, { force: true });
+        }
+        // Push rejected — a worker moved the branch under us. Refetch and
+        // reapply once; a second rejection is contention worth surfacing.
+        if (attempt >= 1) {
+            throw new Error(`origin/${branch} keeps moving — a worker is pushing; retry in a moment`);
+        }
+        fetchClaimBranch(store, branch);
+    }
+}
+export function addAskRouted(store, key, text, author = "") {
+    const branch = claimFor(store, key);
+    if (!branch || onClaimBranch(store, branch)) {
+        return { ask: store.addAsk(key, text, author), branch: null };
+    }
+    const dir = askDirOnBranch(store, key);
+    if (!dir)
+        return { ask: store.addAsk(key, text, author), branch: null };
+    const createdAt = new Date().toISOString();
+    const existing = new Set(branchAsks(store, branch, key).map((a) => a.id));
+    const stem = commentStem(createdAt, author);
+    let id = stem;
+    for (let n = 2; existing.has(id); n++)
+        id = `${stem}-${n}`;
+    const doc = { author, createdAt, resolvedAt: null, resolvedBy: null, body: text };
+    writeOnClaimBranch(store, branch, `${dir}/${id}.md`, `chore(board): ask on ${store.displayId(key)}`, 
+    // Absent → create; if a racing write took the name, keep theirs.
+    (current) => current ?? serializeAsk(doc));
+    const ask = mergedAsks(store, branch, store.get(key)).find((a) => a.id === id);
+    if (!ask)
+        throw new Error(`ask ${id} didn't land on ${branch} — retry`);
+    return { ask, branch };
+}
+export function setAskResolvedRouted(store, key, ref, resolved, resolvedBy = "") {
+    const branch = claimFor(store, key);
+    if (!branch || onClaimBranch(store, branch)) {
+        return {
+            ask: resolved ? store.resolveAsk(key, ref, resolvedBy) : store.reopenAsk(key, ref),
+            branch: null,
+        };
+    }
+    const task = store.get(key);
+    if (!task)
+        throw new Error(`no such task: ${store.displayId(key)}`);
+    const union = mergedAsks(store, branch, task);
+    const target = findInUnion(store, key, union, ref);
+    const onBranch = branchAsks(store, branch, key).some((a) => a.id === target.id);
+    if (!onBranch) {
+        return {
+            ask: resolved
+                ? store.resolveAsk(key, target.id, resolvedBy)
+                : store.reopenAsk(key, target.id),
+            branch: null,
+        };
+    }
+    const dir = askDirOnBranch(store, key);
+    const resolvedAt = new Date().toISOString();
+    writeOnClaimBranch(store, branch, `${dir}/${target.id}.md`, `chore(board): ${resolved ? "resolve" : "reopen"} ask [${target.ordinal}] on ${store.displayId(key)}`, (current) => {
+        if (current === null)
+            return null; // deleted under us — nothing to write
+        const doc = parseAskLenient(current);
+        if (!doc)
+            return current;
+        if (resolved && doc.resolvedAt)
+            return current; // already resolved — stand down
+        if (!resolved && !doc.resolvedAt)
+            return current;
+        return serializeAsk({
+            ...doc,
+            resolvedAt: resolved ? resolvedAt : null,
+            resolvedBy: resolved ? resolvedBy : null,
+        });
+    });
+    const ask = mergedAsks(store, branch, task).find((a) => a.id === target.id);
+    return { ask: ask ?? { ...target, resolvedAt: resolved ? resolvedAt : null, resolvedBy: resolved ? resolvedBy : null }, branch };
+}
+export function deleteAskRouted(store, key, ref) {
+    const branch = claimFor(store, key);
+    if (!branch || onClaimBranch(store, branch)) {
+        return { ask: store.deleteAsk(key, ref), branch: null };
+    }
+    const task = store.get(key);
+    if (!task)
+        throw new Error(`no such task: ${store.displayId(key)}`);
+    const union = mergedAsks(store, branch, task);
+    const target = findInUnion(store, key, union, ref);
+    const onBranch = branchAsks(store, branch, key).some((a) => a.id === target.id);
+    if (!onBranch)
+        return { ask: store.deleteAsk(key, target.id), branch: null };
+    const dir = askDirOnBranch(store, key);
+    writeOnClaimBranch(store, branch, `${dir}/${target.id}.md`, `chore(board): delete ask [${target.ordinal}] on ${store.displayId(key)}`, () => null);
+    // The local copy of a both-sides ask goes too, or the union resurrects it.
+    if (task.asks.some((a) => a.id === target.id))
+        store.deleteAsk(key, target.id);
+    return { ask: target, branch };
+}
+/** Ordinal-or-id against the union — the numbering the inbox shows for claimed tickets. */
+function findInUnion(store, key, union, ref) {
+    const trimmed = ref.trim();
+    const byOrdinal = /^\d+$/.test(trimmed)
+        ? union.find((a) => a.ordinal === Number(trimmed))
+        : undefined;
+    const ask = byOrdinal ?? union.find((a) => a.id === trimmed);
+    if (!ask) {
+        const id = store.displayId(key);
+        throw new Error(union.length === 0
+            ? `${id} has no asks`
+            : `no such ask on ${id}: ${ref} — ordinals run 1-${union.length} (\`task inbox\` lists them for claimed tickets)`);
+    }
+    return ask;
+}
+//# sourceMappingURL=claim-io.js.map

package/dist/claim-io.js.map

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

package/dist/claim.d.ts

@@ -9,7 +9,7 @@
  * against `origin`. PR/session awareness belongs to whatever drives the claim
  * (the implement-task skill, a human).
  */
-import type { Store } from "./store.ts";
+import { type Store } from "./store.ts";
 import type { ProjectConfig, Task } from "./types.ts";
 /**
  * The branch namespace claims live under when the board doesn't configure
@@ -22,13 +22,25 @@ import type { ProjectConfig, Task } from "./types.ts";
  */
 export declare const DEFAULT_CLAIM_PREFIX = "task/claim/";
 /**
- * The board's claim namespace: configured `claimPrefix` (a trailing slash is
+ * The board's claim namespace: `claims.branchPrefix` (a trailing slash is
  * implied) or the default. Validated here because it becomes a git ref and an
  * ls-remote glob — a malformed value must fail the claim, not corrupt it.
+ *
+ * The pre-0.8 top-level `claimPrefix` spelling is not honored — no consumers,
+ * no compat (TAS-41) — but silently *defaulting* over it would be worse than
+ * a shim: the board's committed lock convention would change under every
+ * worker at once. So its presence refuses, loudly, by name.
  */
 export declare function claimNamespace(config: ProjectConfig): string;
-/** { prefix: "TAS" }, 21 → "task/claim/tas-21" (or under the configured namespace). */
-export declare function claimBranch(config: ProjectConfig, number: number): string;
+/**
+ * The repo-wide cap on open claims: `claims.maxOpenCount` read from the
+ * *root* board's config (the outermost `.task/` above `root`), never the
+ * nearest one — a WIP cap each board could set for itself is no cap at all.
+ * Absent, unparseable or nonsensical values all mean "no cap".
+ */
+export declare function openClaimCap(root: string): number | undefined;
+/** { prefix: "TAS" }, "x7k4m" → "task/claim/tas-x7k4m" (or under the configured namespace). */
+export declare function claimBranch(config: ProjectConfig, key: string): string;
 /**
  * Why a claim was refused: "claimed" (someone holds the branch — exit 1, pick
  * the next ticket) vs "invalid" (the ticket or the tree isn't claimable —
@@ -45,6 +57,10 @@ export interface ClaimResult {
     branch: string;
     base: string;
 }
+export interface ClaimOptions {
+    /** Claim past the root board's `claims.maxOpenCount` cap. */
+    force?: boolean;
+}
 /**
  * Claim `number`: validate, branch off origin's default branch, flip the
  * ticket to in_progress as the branch's first commit, and push. The push
@@ -54,7 +70,7 @@ export interface ClaimResult {
  * someone pre-created without a claim commit can't be hijacked by a plain
  * fast-forward. Leaves the winner checked out on the claim branch.
  */
-export declare function claim(store: Store, number: number): ClaimResult;
+export declare function claim(store: Store, key: string, options?: ClaimOptions): ClaimResult;
 export interface ReleaseResult {
     branch: string;
     /** Whether a branch was actually there to delete, per side. */
@@ -66,11 +82,47 @@ export interface ReleaseResult {
  * flip only ever existed as a commit on that branch, so deleting it *is* the
  * revert — the default branch never saw in_progress.
  */
-export declare function release(store: Store, number: number): ReleaseResult;
+export declare function release(store: Store, key: string): ReleaseResult;
 /**
- * The dispatcher's queue view: `todo` in position order, minus needs-human,
- * minus blocked, minus tickets whose claim branch already exists on origin
- * (one ls-remote for the whole namespace). The top entry is next up.
+ * The dispatcher's queue view: `todo` in position order, minus blocked, minus
+ * tickets whose claim branch already exists on origin (one ls-remote for the
+ * whole namespace). The top entry is next up. Open asks don't exclude a
+ * ticket — see assertClaimable.
  */
 export declare function claimableTasks(store: Store): Task[];
+export interface PromoteResult {
+    task: Task;
+    /** Claim-time gates still in the way — promoted, but not claimable yet. */
+    holds: string[];
+}
+/**
+ * `task promote` — the human "build this" call, as a verb: `backlog` → `todo`.
+ * No quality gate: planning happens at claim time (the worker's plan tick),
+ * so a one-line backlog ticket is promotable. Blockers are claim-time facts
+ * that `claim`/`--claimable` already enforce live, so promoting a blocked
+ * ticket is legitimate sequencing ("build this once NIC-11 lands") — reported
+ * as a hold, never refused. Open asks aren't a hold at all: they don't gate
+ * claiming, only done. Writes the ticket like `update` does; committing is
+ * the caller's job.
+ */
+export declare function promote(store: Store, key: string): PromoteResult;
+/**
+ * The boards `claim --next` and `list --claimable` select over, in priority
+ * order. Resolution: an explicit `--board` list > the root board's top-level
+ * `boards` key > the nearest board alone. The list is *selection scope*, not
+ * permission — `task claim <id>` works on any board regardless — and it's
+ * read from the repo's root board only, so a vendored board can't opt itself
+ * into a repo's automation by shipping a config.
+ */
+export declare function selectionBoards(cwd: string, prefixes?: string[]): Store[];
+/**
+ * `task claim --next`: walk the selection scope in priority order and claim
+ * the first ticket that sticks. Losing a race for one ticket (another worker
+ * pushed its branch first) means *try the next*, so every ClaimError inside
+ * the loop is a skip — which is why the repo-level preconditions (dirty tree,
+ * malformed prefix, WIP cap) are asserted up front, where they still mean
+ * "stop and fix something" (exit 2) instead of draining the queue to a bogus
+ * "nothing claimable". Returns null when the queue really is empty (exit 1).
+ */
+export declare function claimNext(stores: Store[], options?: ClaimOptions): ClaimResult | null;
 //# sourceMappingURL=claim.d.ts.map

package/dist/claim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../src/claim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAErD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,gBAAgB,CAAA;AAKjD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAU5D;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAA;gBACxB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS;CAIzD;AA6CD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAQxE;AA4BD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAkF/D;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CA6BnE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,CAOnD"}
+{"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../src/claim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,OAAO,EAKL,KAAK,KAAK,EACX,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAErD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,gBAAgB,CAAA;AAKjD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAgB5D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO7D;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAA;gBACxB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS;CAIzD;AAWD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAQxE;AAiCD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,CA6FxF;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CA6BhE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,CAMnD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,IAAI,CAAA;IACV,2EAA2E;IAC3E,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAehE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CA+BzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,GAAG,IAAI,CA6BzF"}