@slowcook-ai/cli 0.19.0-alpha.8 → 0.19.1

package/dist/commands/refine/multifurcate.d.ts

@@ -0,0 +1,129 @@
+/**
+ * @slowcook 0.19.0-α.44 — multifurcation pre-step.
+ *
+ * Some GitHub issues are not stories. They are programs of work disguised
+ * as tickets ("everything according to mock", "rewrite the patient app",
+ * "wire X to Y" where X and Y are whole subsystems). Forcing those
+ * through refine produces a fuzzy mega-spec that no downstream agent can
+ * reasonably implement.
+ *
+ * This module runs a cheap LLM pass BEFORE refine's relationship +
+ * refinement calls. It returns either:
+ *
+ *   - { kind: "one", rationale } — refine proceeds normally
+ *   - { kind: "many", sub_issues, rationale } — refine posts a
+ *     PM-facing proposal listing the proposed sub-issues + halts; the
+ *     PM decides whether to file the split. The original issue is
+ *     marked `slowcook-multifurcation-proposed` so refine doesn't loop.
+ *
+ * Sub-issue titles + summaries are PM-style by contract (see prompt
+ * rules): intent-shaped, no file paths or pipeline names, ≤ 80 char
+ * titles, 1-3 sentence summaries. Quality of the proposal is the
+ * PM's call — the comment template makes editing easy.
+ */
+import type { LlmClient, Spec } from "@slowcook-ai/core";
+/**
+ * One existing spec the model needs to be aware of when proposing a
+ * split, so it can mark sub-issues that overlap with active scope
+ * INSTEAD of silently omitting them. The PM needs to see the full
+ * picture, not a hidden side-channel.
+ *
+ * Built from `listActiveSpecs(repoRoot)` — a single line of Spec.
+ */
+export interface ActiveSpecDigest {
+    story_id: string;
+    title: string;
+    summary: string;
+}
+export interface MultifurcationSubIssue {
+    title: string;
+    summary: string;
+    /** Optional — titles of OTHER sub-issues this one depends on landing first. */
+    depends_on?: string[];
+    /**
+     * cli α.45 — set when the proposed sub-issue's scope is already covered
+     * by an active spec. The PM still sees the sub-issue (so the parent
+     * issue's full scope is visible), but the comment renders an "Already
+     * covered by story-NNN" annotation and the PM can fold it into the
+     * existing story rather than opening a duplicate.
+     */
+    existing_spec_id?: string;
+}
+export type MultifurcationVerdict = {
+    kind: "one";
+    rationale: string;
+} | {
+    kind: "many";
+    rationale: string;
+    sub_issues: MultifurcationSubIssue[];
+};
+export interface MultifurcationInputs {
+    issueTitle: string;
+    issueBody: string;
+    /**
+     * cli α.45 — list of currently active specs in this repo. The
+     * multifurcation prompt uses them to annotate sub-issues that
+     * overlap with existing scope (story_id is the PM-visible
+     * reference; title + summary give the model enough context to
+     * decide whether overlap is real).
+     *
+     * Empty array is fine — model just won't tag anything.
+     */
+    activeSpecs?: ActiveSpecDigest[];
+}
+export interface MultifurcationResult {
+    verdict: MultifurcationVerdict;
+    costUsd: number;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheCreateTokens: number;
+    };
+}
+export declare function assessMultifurcation(inputs: MultifurcationInputs, opts: {
+    llm: LlmClient;
+    model: string;
+}): Promise<MultifurcationResult>;
+/**
+ * Compose the user-side message. Exported for tests so the snapshot can
+ * assert active-specs context lands where the model expects it.
+ */
+export declare function buildMultifurcationUserMessage(inputs: MultifurcationInputs): string;
+/**
+ * Compact a Spec list down to the digest shape the multifurcation
+ * prompt consumes. Summary is the first ~150 chars of the first
+ * acceptance scenario (the most spec-like prose); falls back to a
+ * non_goal or empty string.
+ */
+export declare function digestActiveSpecs(specs: Spec[]): ActiveSpecDigest[];
+/**
+ * Parse the JSON verdict. Tolerant of leading/trailing prose (some
+ * models still wrap JSON in fences despite the prompt). Defaults to
+ * `{ kind: "one", rationale: "(parser fallback — model output unparseable)" }`
+ * so that an LLM hiccup never blocks refine.
+ */
+export declare function parseMultifurcationJson(text: string): MultifurcationVerdict;
+/**
+ * PM-facing comment body listing the proposed sub-issues. The template
+ * mirrors the refine "questions-first" layout — proposal up top, agent's
+ * rationale folded into a <details> block, action prompts at the bottom.
+ *
+ * The HTML comment `<!-- slowcook:multifurcation -->` is a sentinel
+ * future refine runs grep for to skip re-proposing on the same issue.
+ */
+export declare function multifurcationCommentBody(proposal: {
+    rationale: string;
+    sub_issues: MultifurcationSubIssue[];
+}, opts: {
+    issueTitle: string;
+}): string;
+/**
+ * Detect whether a multifurcation proposal has already been posted on
+ * an issue's comment thread. Used by the agent to skip re-running the
+ * LLM pass when the PM is still deciding.
+ */
+export declare function hasExistingMultifurcationComment(comments: Array<{
+    body: string;
+}>): boolean;
+//# sourceMappingURL=multifurcate.d.ts.map

package/dist/commands/refine/multifurcate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multifurcate.d.ts","sourceRoot":"","sources":["../../../src/commands/refine/multifurcate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,sBAAsB,EAAE,CAAA;CAAE,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAwBnF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,gBAAgB,EAAE,CAQnE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CA2E3E;AAyBD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,sBAAsB,EAAE,CAAA;CAAE,EACrE,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAC3B,MAAM,CAkDR;AAMD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAChC,OAAO,CAET"}

package/dist/commands/refine/multifurcate.js

@@ -0,0 +1,247 @@
+/**
+ * @slowcook 0.19.0-α.44 — multifurcation pre-step.
+ *
+ * Some GitHub issues are not stories. They are programs of work disguised
+ * as tickets ("everything according to mock", "rewrite the patient app",
+ * "wire X to Y" where X and Y are whole subsystems). Forcing those
+ * through refine produces a fuzzy mega-spec that no downstream agent can
+ * reasonably implement.
+ *
+ * This module runs a cheap LLM pass BEFORE refine's relationship +
+ * refinement calls. It returns either:
+ *
+ *   - { kind: "one", rationale } — refine proceeds normally
+ *   - { kind: "many", sub_issues, rationale } — refine posts a
+ *     PM-facing proposal listing the proposed sub-issues + halts; the
+ *     PM decides whether to file the split. The original issue is
+ *     marked `slowcook-multifurcation-proposed` so refine doesn't loop.
+ *
+ * Sub-issue titles + summaries are PM-style by contract (see prompt
+ * rules): intent-shaped, no file paths or pipeline names, ≤ 80 char
+ * titles, 1-3 sentence summaries. Quality of the proposal is the
+ * PM's call — the comment template makes editing easy.
+ */
+import { MULTIFURCATION_SYSTEM } from "@slowcook-ai/llm-anthropic";
+export async function assessMultifurcation(inputs, opts) {
+    const userMessage = buildMultifurcationUserMessage(inputs);
+    const response = await opts.llm.complete({
+        system: MULTIFURCATION_SYSTEM,
+        cacheSystem: false,
+        model: opts.model,
+        messages: [{ role: "user", content: userMessage }],
+        maxTokens: 2048,
+    });
+    return {
+        verdict: parseMultifurcationJson(response.text),
+        costUsd: response.costUsd,
+        usage: response.usage,
+    };
+}
+/**
+ * Compose the user-side message. Exported for tests so the snapshot can
+ * assert active-specs context lands where the model expects it.
+ */
+export function buildMultifurcationUserMessage(inputs) {
+    const sections = [];
+    sections.push("## Issue under review");
+    sections.push(`### Title\n${inputs.issueTitle}`);
+    sections.push(`### Body\n${inputs.issueBody || "(empty body)"}`);
+    const specs = inputs.activeSpecs ?? [];
+    if (specs.length > 0) {
+        sections.push("## Active specs in this repo");
+        sections.push("If any proposed sub-issue's scope is ALREADY covered by one of these, " +
+            "set `existing_spec_id` to that story_id in the sub-issue object. " +
+            "Still include the sub-issue in the proposal — the PM needs the full picture, " +
+            "the annotation tells them this slice is already on the ratchet. " +
+            "Do NOT silently omit overlapping sub-issues.");
+        for (const s of specs) {
+            const summary = s.summary && s.summary.length > 0 ? ` — ${s.summary}` : "";
+            sections.push(`- **story-${s.story_id}** "${s.title}"${summary}`);
+        }
+    }
+    sections.push("Return the JSON verdict per the system prompt.");
+    return sections.join("\n\n");
+}
+/**
+ * Compact a Spec list down to the digest shape the multifurcation
+ * prompt consumes. Summary is the first ~150 chars of the first
+ * acceptance scenario (the most spec-like prose); falls back to a
+ * non_goal or empty string.
+ */
+export function digestActiveSpecs(specs) {
+    return specs.map((s) => {
+        const firstScenario = s.acceptance_scenarios[0] ?? "";
+        const firstInvariant = s.invariants[0] ?? "";
+        const raw = firstScenario || firstInvariant || s.non_goals[0] || "";
+        const summary = raw.replace(/\s+/g, " ").trim().slice(0, 150);
+        return { story_id: s.story_id, title: s.title, summary };
+    });
+}
+/**
+ * Parse the JSON verdict. Tolerant of leading/trailing prose (some
+ * models still wrap JSON in fences despite the prompt). Defaults to
+ * `{ kind: "one", rationale: "(parser fallback — model output unparseable)" }`
+ * so that an LLM hiccup never blocks refine.
+ */
+export function parseMultifurcationJson(text) {
+    const json = extractJsonBlob(text);
+    if (!json) {
+        return {
+            kind: "one",
+            rationale: "(parser fallback — model output unparseable, treating as single story)",
+        };
+    }
+    let raw;
+    try {
+        raw = JSON.parse(json);
+    }
+    catch {
+        return {
+            kind: "one",
+            rationale: "(parser fallback — JSON parse failed)",
+        };
+    }
+    if (!raw || typeof raw !== "object") {
+        return { kind: "one", rationale: "(parser fallback — non-object verdict)" };
+    }
+    const o = raw;
+    const verdict = typeof o.verdict === "string" ? o.verdict.toLowerCase() : "";
+    const rationale = typeof o.rationale === "string" ? o.rationale.trim() : "";
+    if (verdict === "one") {
+        return { kind: "one", rationale: rationale || "(no rationale provided)" };
+    }
+    if (verdict === "many") {
+        const subRaw = Array.isArray(o.sub_issues) ? o.sub_issues : [];
+        const sub_issues = [];
+        for (const entry of subRaw) {
+            if (!entry || typeof entry !== "object")
+                continue;
+            const e = entry;
+            const title = typeof e.title === "string" ? e.title.trim() : "";
+            const summary = typeof e.summary === "string" ? e.summary.trim() : "";
+            if (!title || !summary)
+                continue;
+            const depRaw = Array.isArray(e.depends_on) ? e.depends_on : [];
+            const depends_on = depRaw
+                .filter((d) => typeof d === "string" && d.trim().length > 0)
+                .map((d) => d.trim());
+            const item = { title, summary };
+            if (depends_on.length > 0)
+                item.depends_on = depends_on;
+            // cli α.45 — overlap annotation. Accept variants the model may
+            // emit (existing_spec_id, story_id, covered_by_story) and
+            // normalize to plain digit-suffix form ("002" not "story-002").
+            const rawId = (typeof e.existing_spec_id === "string" && e.existing_spec_id) ||
+                (typeof e.covered_by_story === "string" && e.covered_by_story) ||
+                (typeof e.story_id === "string" && e.story_id) ||
+                "";
+            const normalised = rawId.trim().replace(/^story-/i, "");
+            if (normalised.length > 0)
+                item.existing_spec_id = normalised;
+            sub_issues.push(item);
+        }
+        // Guardrail: if the model said "many" but failed to produce ≥2 valid
+        // sub-issues, fall back to "one" rather than emit a broken proposal.
+        // Always tag the rationale so downstream logs reveal the downgrade.
+        if (sub_issues.length < 2) {
+            const prefix = "(parser fallback — verdict was many but fewer than 2 valid sub-issues parsed)";
+            return {
+                kind: "one",
+                rationale: rationale ? `${prefix} · original rationale: ${rationale}` : prefix,
+            };
+        }
+        return {
+            kind: "many",
+            rationale: rationale || "(no rationale provided)",
+            sub_issues,
+        };
+    }
+    return {
+        kind: "one",
+        rationale: rationale || `(parser fallback — unknown verdict "${verdict}")`,
+    };
+}
+/**
+ * Extract the first balanced { ... } JSON blob from raw model text.
+ * Strips common decorations: leading prose, ```json fences, trailing
+ * commentary. Returns null if no balanced object is found.
+ */
+function extractJsonBlob(text) {
+    const fenced = text.match(/```(?:json)?\s*(\{[\s\S]*?\})\s*```/);
+    if (fenced && fenced[1])
+        return fenced[1];
+    const start = text.indexOf("{");
+    if (start === -1)
+        return null;
+    let depth = 0;
+    for (let i = start; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === "{")
+            depth++;
+        else if (ch === "}") {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+/**
+ * PM-facing comment body listing the proposed sub-issues. The template
+ * mirrors the refine "questions-first" layout — proposal up top, agent's
+ * rationale folded into a <details> block, action prompts at the bottom.
+ *
+ * The HTML comment `<!-- slowcook:multifurcation -->` is a sentinel
+ * future refine runs grep for to skip re-proposing on the same issue.
+ */
+export function multifurcationCommentBody(proposal, opts) {
+    const lines = [];
+    lines.push("<!-- slowcook:multifurcation -->");
+    lines.push("### slowcook · refinement agent 🍲");
+    lines.push("");
+    lines.push(`This issue looks like **more than one story** to me. Before I produce a spec, please confirm the split below — refine ships one PR per story, and a single mega-spec usually misses the things that matter at each user-facing slice.`);
+    lines.push("");
+    const overlapCount = proposal.sub_issues.filter((s) => s.existing_spec_id).length;
+    lines.push(`#### Proposed sub-issues (${proposal.sub_issues.length}${overlapCount > 0 ? `, ${overlapCount} overlap existing specs` : ""})`);
+    lines.push("");
+    for (let i = 0; i < proposal.sub_issues.length; i++) {
+        const s = proposal.sub_issues[i];
+        const overlapBadge = s.existing_spec_id
+            ? ` _(already covered by story-${escapeMd(s.existing_spec_id)})_`
+            : "";
+        lines.push(`**${i + 1}. ${escapeMd(s.title)}**${overlapBadge}`);
+        lines.push("");
+        lines.push(escapeMd(s.summary));
+        if (s.depends_on && s.depends_on.length > 0) {
+            lines.push("");
+            lines.push(`_Depends on: ${s.depends_on.map((d) => `"${d}"`).join(", ")}_`);
+        }
+        lines.push("");
+    }
+    lines.push("<details><summary>Why I think this should split</summary>");
+    lines.push("");
+    lines.push(proposal.rationale);
+    lines.push("");
+    lines.push("</details>");
+    lines.push("");
+    lines.push("#### What to do");
+    lines.push("");
+    lines.push("- 👍 **Looks right** → file each sub-issue that DOESN'T have an _already covered by_ tag. For tagged ones, decide per row whether to fold them into the existing story (comment on that story) or skip. Then close this one or remove `needs-refinement` from it.");
+    lines.push("- ✏️ **Needs tweaking** → reply with the edited list (edit titles, drop or add entries, change overlap calls). Remove the `slowcook-multifurcation-proposed` label and I'll re-propose.");
+    lines.push("- 👎 **Keep as one** → reply \"keep as one\" and remove both labels (`slowcook-multifurcation-proposed` and `needs-refinement`, then re-add `needs-refinement`). I'll proceed with a single spec.");
+    lines.push("");
+    lines.push(`_For context, the original title was: **${escapeMd(opts.issueTitle)}**_`);
+    return lines.join("\n");
+}
+function escapeMd(s) {
+    return s.replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+/**
+ * Detect whether a multifurcation proposal has already been posted on
+ * an issue's comment thread. Used by the agent to skip re-running the
+ * LLM pass when the PM is still deciding.
+ */
+export function hasExistingMultifurcationComment(comments) {
+    return comments.some((c) => c.body.includes("<!-- slowcook:multifurcation -->"));
+}
+//# sourceMappingURL=multifurcate.js.map

package/dist/commands/refine/multifurcate.js.map

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

package/dist/commands/refine/proposals-synth.d.ts

@@ -1,4 +1,14 @@
 import type { Spec, SpecProposals } from "@slowcook-ai/core";
+/**
+ * 0.19.0-α.30 (sc#63) — load the consumer's existing column-set by
+ * scanning migration files. Returns Map<table, Set<column>> indexed
+ * by lower-case names. Used by deriveSchema to distinguish columns
+ * that already exist (skip) from those that need an ALTER TABLE.
+ *
+ * Returns null if no migrations found (greenfield / first slowcook
+ * story); deriveSchema falls back to its existing CREATE TABLE flow.
+ */
+export declare function loadExistingColumns(repoRoot: string): Map<string, Set<string>> | null;
 /**
  * Deterministic post-processor that derives proposals from the spec
  * body when the LLM inlined decisions into `invariants` / `api_contract`
@@ -32,5 +42,44 @@ import type { Spec, SpecProposals } from "@slowcook-ai/core";
  * hard-signal backstop: when the LLM doesn't elevate to a structured
  * block, the synth derives one from prose + brownfield extracts.
  */
-export declare function synthesizeProposalsFromSpec(spec: Spec): SpecProposals;
+export declare function synthesizeProposalsFromSpec(spec: Spec, opts?: {
+    repoRoot?: string;
+}): SpecProposals;
+/**
+ * Map a URL path to a candidate Next.js App Router file location.
+ * Uses the `(main)` route group by default (authenticated app pages).
+ * Consumer can edit post-emit if their layout differs.
+ */
+/**
+ * 0.19.0-α.29 (sc#64) — app-shape detection for multi-app monorepos.
+ *
+ *  - `single-flat`     — `src/app/<path>/page.tsx` (no route group)
+ *  - `single-grouped`  — `src/app/(main)/<path>/page.tsx` (rewo convention)
+ *  - `multi-app`       — `apps/<app>/src/app/<path>/page.tsx` (delgoosh)
+ *
+ * Detection walks the consumer's filesystem:
+ *  - If `apps/<name>/src/app/` exists for two or more apps → multi-app.
+ *  - Else if `src/app/(main)/` exists → single-grouped.
+ *  - Else default to single-flat.
+ *
+ * When no repoRoot is provided (older callers / tests that pass spec
+ * only), defaults to `single-grouped` for backward compat with rewo.
+ *
+ * In multi-app mode, route → app assignment heuristic:
+ *  - Path's first segment matches an app name → that app owns it
+ *    (e.g., /patient/dashboard → apps/patient/src/app/dashboard/page.tsx,
+ *    the /patient prefix gets STRIPPED since it's already in the app dir)
+ *  - Path matches no app → first app gets it (caller can edit)
+ */
+export type AppShape = {
+    kind: "single-flat";
+    prefix: string;
+} | {
+    kind: "single-grouped";
+    prefix: string;
+} | {
+    kind: "multi-app";
+    apps: string[];
+};
+export declare function detectAppShape(repoRoot: string): AppShape;
 //# sourceMappingURL=proposals-synth.d.ts.map

package/dist/commands/refine/proposals-synth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proposals-synth.d.ts","sourceRoot":"","sources":["../../../src/commands/refine/proposals-synth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,CA8BrE"}
+{"version":3,"file":"proposals-synth.d.ts","sourceRoot":"","sources":["../../../src/commands/refine/proposals-synth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG7D;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GACf,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAajC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,EACV,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,aAAa,CAkCf;AA0UD;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE1C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CA8BzD"}