@openrig/cli 0.5.0 → 0.5.1

package/node_modules/@openrig/daemon/dist/domain/workspace/default-workspace-scaffold.js

@@ -0,0 +1,479 @@
+// V0.3.1 slice 21 onboarding-conveyor: rich narrative content for the
+// getting-started mission's two slices (the click-through-to-learn
+// teaching surface).
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { GETTING_STARTED_NARRATIVE } from "./getting-started-narrative.js";
+// Release-0.3.2 slice 01 (OPR.0.3.2.1) — seeded missions/slices now
+// carry §1 dot-IDs in frontmatter so the scaffold coheres with
+// `conventions/scope-and-versioning`. `getting-started` is a
+// non-release mission → escape band `OPR.99.0.1`; its slices fan out
+// as `OPR.99.0.1.<n>` (numbers monotonic, never reused).
+const DEFAULT_MISSIONS = [
+    {
+        id: "getting-started",
+        dotId: "OPR.99.0.1",
+        title: "Getting Started",
+        status: "active",
+        objective: "Launch the conveyor starter and learn how OpenRig moves work through queue-backed slices.",
+        slices: [
+            {
+                id: "first-conveyor-run",
+                dotId: "OPR.99.0.1.1",
+                title: "First Conveyor Run",
+                status: "active",
+                objective: "Move one small packet through intake, planning, build, review, and close on the conveyor starter.",
+            },
+            {
+                id: "inspect-project-evidence",
+                dotId: "OPR.99.0.1.2",
+                title: "Inspect Project Evidence",
+                status: "draft",
+                objective: "Open Project, Queue, Story, and Tests to inspect the evidence created by the first conveyor run.",
+            },
+        ],
+    },
+];
+export function workspaceScaffoldDirs() {
+    return [
+        "missions",
+        "artifacts",
+        "evidence",
+        "progress",
+        "field-notes",
+        "specs",
+        "dogfood-evidence",
+        ...DEFAULT_MISSIONS.flatMap((mission) => [
+            `missions/${mission.id}`,
+            `missions/${mission.id}/slices`,
+            ...mission.slices.flatMap((slice) => [
+                `missions/${mission.id}/slices/${slice.id}`,
+                `missions/${mission.id}/slices/${slice.id}/proof`,
+            ]),
+        ]),
+    ];
+}
+function subdirReadmeContent(subdir) {
+    switch (subdir) {
+        case "missions":
+            return "# missions\n\nProject missions live here. Each mission folder maps to one Project mission in the UI and owns a `slices/` child folder.\n\nExpected shape:\n\n```text\nmissions/<mission-name>/README.md\nmissions/<mission-name>/PROGRESS.md\nmissions/<mission-name>/slices/<slice-name>/README.md\n```\n\nEvery mission and slice README carries a stable dot-ID in its frontmatter (`id: OPR.<ver>[.<n>]`) per the scope-and-versioning convention. Use `rig scope mission create <name>` and `rig scope slice create <mission> <slug>` to mint conformant artifacts; the CLI handles the dot-ID + auto-numbering for you. The folder name is the operator-facing slug; the `id:` is the stable handle that survives renames.\n";
+        case "artifacts":
+            return "# artifacts\n\nWork products live here: plans, drafts, generated outputs, and other files that a slice may reference before closure.\n";
+        case "evidence":
+            return "# evidence\n\nHuman-readable verification notes live here. Use this for compact proof summaries that are not tied to a screenshot or video packet.\n";
+        case "progress":
+            return "# progress\n\nPROGRESS.md tree. OpenRig's Progress browse view scans this directory recursively for PROGRESS.md files and renders them as a hierarchical tree.\n";
+        case "field-notes":
+            return "# field-notes\n\nOperator field notes. Free-form markdown notes from your daily work. OpenRig surfaces these alongside missions and slices for context.\n";
+        case "specs":
+            return "# specs\n\nWorkspace specs (rig specs / agent specs / workflow specs / context packs / skills). OpenRig's Library browses this directory alongside bundled specs.\n";
+        case "dogfood-evidence":
+            return "# dogfood-evidence\n\nProof packets live here. Each proof packet folder is matched to a Project slice by folder-name tokens and may contain markdown, screenshots, videos, traces, and other verification artifacts.\n";
+        default:
+            return `# ${subdir}\n`;
+    }
+}
+const WORKSPACE_README = `# OpenRig Workspace
+
+This workspace is file-backed. The Project UI mirrors this structure:
+
+- \`missions/<mission-id>\` becomes a Project mission.
+- \`missions/<mission-id>/slices/<slice-id>\` becomes a Project slice.
+- Queue items should mention or tag the mission id and slice id so Project can attach live work to the right slice.
+- \`artifacts/\` is for work products that a slice needs to keep.
+- \`evidence/\` is for proof notes and verification summaries.
+- \`dogfood-evidence/<proof-packet-id>\` becomes Tests proof when the packet id contains the slice id tokens.
+
+Use stable kebab-case names for mission and slice folders. Every mission/slice README also carries a stable dot-ID in its frontmatter (\`id: OPR.<ver>[.<n>]\`) per the \`scope-and-versioning\` convention; mint conformant artifacts via \`rig scope mission create <name>\` and \`rig scope slice create <mission> <slug>\`. Folder names are operator-facing slugs; the \`id:\` is the rename-proof handle.
+`;
+const STEERING_PLACEHOLDER = `---
+title: Priority Stack
+status: placeholder
+---
+
+# OpenRig Priority Stack
+
+This file is a placeholder created by \`rig config init-workspace\`. Edit it
+to record your top priorities. OpenRig's Steering surface reads this file
+alongside your Project workspace.
+
+## Top 3
+
+1. Run the \`conveyor\` starter rig.
+2. Move one packet through \`basic-loop\` or \`conveyor\`.
+3. Inspect the Project, Queue, Story, and Tests surfaces.
+
+## In Motion
+
+(Active slices land here as you push them through the priority rail.)
+
+## Loop State
+
+(Health gates + loop diagnostics land here.)
+`;
+function missionReadme(mission) {
+    return `---
+id: ${mission.dotId}
+title: ${mission.title}
+status: ${mission.status}
+mission: ${mission.id}
+---
+
+# ${mission.title}
+
+${mission.objective}
+
+## Slices
+
+${mission.slices.map((slice) => `- [${slice.title}](slices/${slice.id}/README.md)`).join("\n")}
+`;
+}
+function missionProgress(mission) {
+    return `---
+title: ${mission.title} Progress
+status: ${mission.status}
+mission: ${mission.id}
+---
+
+# ${mission.title} Progress
+
+- [ ] Keep mission README current.
+- [ ] Keep active slices queue-backed with mission and slice ids.
+`;
+}
+function sliceReadme(mission, slice) {
+    // V0.3.1 slice 21: getting-started slices ship rich narrative
+    // content that teaches both "what a conveyor is" and "what each
+    // tab does". Other slices keep the boilerplate.
+    const narrative = GETTING_STARTED_NARRATIVE[slice.id];
+    if (narrative) {
+        return `---
+id: ${slice.dotId}
+title: ${slice.title}
+status: ${slice.status}
+mission: ${mission.id}
+rail-item: ${mission.id}
+slice: ${slice.id}
+---
+
+${narrative.readme}`;
+    }
+    return `---
+id: ${slice.dotId}
+title: ${slice.title}
+status: ${slice.status}
+mission: ${mission.id}
+rail-item: ${mission.id}
+slice: ${slice.id}
+---
+
+# ${slice.title}
+
+## Intent
+
+${slice.objective}
+
+## Mini-requirements
+
+1. The work is visible in the Project slice and its queue items link back to \`${slice.id}\`.
+
+## Proof contract
+
+- [ ] The work is visible in the Project slice — captured (see IMPLEMENTATION-PRD.md).
+
+## Queue Mapping
+
+Queue items for this slice should mention or tag:
+
+- mission: \`${mission.id}\`
+- slice: \`${slice.id}\`
+
+This lets Project attach queue activity to the slice story, queue, tests, and topology tabs.
+`;
+}
+/** V0.3.1 slice 21: getting-started slices emit a timeline.md that
+ *  the slice Story tab renders via the slice-06 useSliceTimelineMarkdown
+ *  hook. Returns null when no narrative is defined for the slice id
+ *  (default mission slices don't ship a timeline). */
+function sliceTimeline(mission, slice) {
+    const narrative = GETTING_STARTED_NARRATIVE[slice.id];
+    if (!narrative)
+        return null;
+    return narrative.timeline;
+}
+function sliceProgress(mission, slice) {
+    // V0.3.1 slice 21: getting-started slices ship the worked-example
+    // PROGRESS narrative (acceptance criteria for a mocked conveyor run
+    // / inspection); other slices keep the boilerplate.
+    const narrative = GETTING_STARTED_NARRATIVE[slice.id];
+    if (narrative)
+        return narrative.progress;
+    return `---
+title: ${slice.title} Progress
+status: ${slice.status}
+mission: ${mission.id}
+rail-item: ${mission.id}
+slice: ${slice.id}
+---
+
+# ${slice.title} Progress
+
+- [ ] Define the next concrete packet.
+- [ ] Attach queue work to this slice id.
+- [ ] Capture proof or notes before closing.
+`;
+}
+function sliceProof(slice) {
+    return `# PROOF — ${slice.dotId} ${slice.title}
+
+> **WHO/WHEN:** the impl/QA pair that worked the slice, at slice-close — a slice is NOT done until this file exists and every proof-contract item has evidence (mapped 1:1, artifacts under \`proof/\`). See the \`mission-slice-sop\` skill + the conventions SSOT (\`docs/reference/sdlc-conventions.md\` in the repo, \`$OPENRIG_HOME/reference/sdlc-conventions.md\` on an installed package).
+>
+> **HOW (the drop verb, not hand-placement):** put media files under \`proof/\`, then ATTACH them with \`rig proof add ${slice.dotId} --artifact-type qa --verdict PASS --candidate-sha <tip> --money-evidence "<one line>" --evidences "1" --media "screenshot-01.png"\` — the drop writes the C1 header the Living Notes DELIVERED pairing joins on. Hand-placing files without a drop leaves the deliverable unpaired and \`unverified\`.
+
+Closed by: <seat>   Date: <date>   Verdict: <pass | pass-with-residue | ...>
+
+## What this proves
+
+<1-3 sentences: the claim the slice made, now demonstrated>
+
+## Artifacts (media in proof/)
+
+Dropped via \`rig proof add … --evidences … --media …\` (one drop per verdict; media attached, never only hand-listed):
+
+- proof/screenshot-01.png — <what it shows>
+- proof/capture-behavior.gif — <what it shows>
+- proof/command-output.txt — <what it proves>
+
+## Residue / caveats (if any)
+
+<documented residue: what's not covered + where it's tracked>
+`;
+}
+function slicePrd(mission, slice) {
+    return `---
+title: ${slice.title} Implementation Notes
+status: ${slice.status}
+mission: ${mission.id}
+rail-item: ${mission.id}
+slice: ${slice.id}
+---
+
+# ${slice.title} Implementation Notes
+
+## Intent
+
+${slice.objective}
+
+## Mini-requirements
+
+1. The work is visible in the Project slice and its queue items link back to \`${slice.id}\`.
+
+## Proof contract
+
+- [ ] The work is visible in the Project slice — captured.
+- [ ] Queue items include enough body or tag context to link back to \`${slice.id}\`.
+- [ ] Proof artifacts are referenced from the slice before closure (drop via \`rig proof add\`).
+
+> Conventions SSOT: \`docs/reference/sdlc-conventions.md (installed: $OPENRIG_HOME/reference/sdlc-conventions.md)\` — section names, proof-contract format, the two locks, C1 headers. For a small slice the mini-requirements may BE the whole PRD.
+`;
+}
+const MISSION_BRIEF_BUILT_IN = `# {{mission_name}} — Brief
+<optional one-line italic TL;DR>
+
+## What & why
+<orientation, read-first: what this mission delivers + why it matters. MANDATORY.>
+
+## Building
+<what is actively in flight right now — brief-altitude, a few bullets, NOT the PROGRESS task list>
+
+## Progress
+<how far: a high-altitude phase/wave rollup. Points at PROGRESS.md for active/next detail.>
+
+## Proven
+<what has landed WITH proof — brief-altitude proof gauge. Points at the Proof tab / per-slice proof/.>
+
+## Needs you
+<open decisions + reviews waiting on the human/founder — the "never have to ask for status" section. Empty = nothing blocked on you.>
+
+## Pointers
+→ MISSION_NOTES.md (continuity / restore) · → PROGRESS.md (active / next) · other key links
+`;
+export function renderDaemonMissionBrief(missionName) {
+    return MISSION_BRIEF_BUILT_IN.replace(/\{\{mission_name\}\}/g, missionName);
+}
+// FR-5e A1 (daemon-side symmetry) — MISSION_NOTES template +
+// rendering for the daemon's `/api/config/init-workspace` route so
+// UI-driven init lands the same scaffold as CLI-driven init. The
+// template content is duplicated here from
+// packages/cli/src/lib/scope-templates/mission-notes.md to keep the
+// daemon side dependency-free of the cli package; a parity test in
+// getting-started-narrative-parity.test.ts asserts CLI + daemon emit
+// byte-identical MISSION_NOTES content given the same opts. Same
+// env-var-pivot pattern the CLI surface honors:
+// OPENRIG_MISSION_NOTES_TEMPLATE_PATH > built-in.
+const MISSION_NOTES_BUILT_IN = `---
+mission: {{mission_id}}
+name: {{mission_name}}
+status: active
+authored: {{created_date}}
+last-updated: {{created_date}}
+---
+
+# Mission Notes — {{mission_name}}
+
+> Read the frontmatter \`last-updated\` first. If stale relative to runtime,
+> treat this file as \`provisional\` and re-verify before relying on it.
+> Pointer-first by design — index durable canonical artifacts; don't duplicate
+> them (duplication is the stale-breadcrumb failure mode this convention
+> exists to kill).
+
+## §1. Top-of-mind context
+
+(Current most-load-bearing state — gates, open scope-decisions, in-flight
+surprises. Updated by anyone when material changes. Keep to 5-15 lines.)
+
+## §2. Active workstreams + drivers + tips
+
+(Per-workstream rows. THIS SECTION IS THE MISSION CODEMAP. Each row:
+state / driver / branch+tip-SHA / latest blocker or ACK.)
+
+- (workstream-id) — state — driver — tip-SHA — blocker/ACK
+
+## §3. Open scope-decisions
+
+(Labeled gates the operator owns. Per gate: where the gate is, what's needed,
+who routed.)
+
+- OQ-1: (decision needed) — gate at <artifact-path> — surfaced by <seat>
+
+## §4. Slice inventory
+
+(Full table of slices on this mission.)
+
+| # | slice | state | driver | blocker |
+|---|---|---|---|---|
+
+## §5. Pending dispatches
+
+(Next-go items waiting on driver availability or convergence. Immediately-ready
+set, not full backlog.)
+
+## §6. Ledgers
+
+(Mission-specific shared ledgers: release version + tag, SC counts, cumulative
+deltas, etc.)
+
+## §7. Banked memories that apply here
+
+(Bulleted: banked-feedback / banked-project memories load-bearing on restore
+for this mission. Ones learned during this mission go into the same list.)
+
+## §8. Convention pointers
+
+(Which banked conventions this mission inherits. Cross-reference each by path.
+This section is the principles/conventions inheritance surface for the mission.)
+
+- \`conventions/mission-notes/README.md\` — this convention (apply on every restore)
+
+## §9. Reconstruction protocol
+
+(Commands to run after compaction or for onboarding. Refresh as the mission's
+restore-needs evolve.)
+
+1. \`rig whoami --json\` — confirm seat identity
+2. Read this file's §1 + your §A-§X section + this §9
+3. Read \`missions/{{mission_id}}/README.md\` for mission scope
+4. Read \`missions/{{mission_id}}/PROGRESS.md\` for delivery state
+5. \`rig queue list --mine --full --json\` — triage your durable inbox from full
+   bodies; use \`rig queue show <id> --full --json\` for individual items. Never
+   use the bare compact queue list for triage.
+6. Optionally check \`rig transcript <your-session> --tail 100\` as secondary
+   evidence. It may be unavailable or incomplete for some runtimes; little or
+   no output does not prove the session was quiet.
+7. State "restored from {{mission_id}}; resumed at <action>" before acting
+
+## §10. What NOT to reconstruct
+
+(Explicit pruning — completed slices / merged commits / closed ACK packets are
+recoverable on demand and don't need to be in working memory. Name them to
+free attention.)
+
+## §A. <first-seat>@<rig> notes
+
+(First seat's notes. Pattern: append cont.N entries with date + state of the
+world from this seat's perspective. Latest = truth. Other seats READ but
+don't modify.)
+
+DONE {{created_date}} (cont.0 — mission scaffolded):
+- Mission scaffolded via \`rig scope mission create\`. Template applied; this
+  file is the seed state. First substantive cont.1 entry follows when work
+  begins.
+
+## §B / §C / ... — per-seat sections
+
+(Each additional seat adds an h2 ## §X section under their own header as they
+join. Section pattern matches §A.)
+`;
+function applyMissionNotesPlaceholders(content, opts) {
+    return content
+        .replace(/\{\{mission_id\}\}/g, opts.mission_id)
+        .replace(/\{\{mission_name\}\}/g, opts.mission_name)
+        .replace(/\{\{created_date\}\}/g, opts.created_date);
+}
+export function renderDaemonMissionNotes(opts) {
+    const envValue = process.env.OPENRIG_MISSION_NOTES_TEMPLATE_PATH;
+    if (envValue && envValue.trim().length > 0) {
+        const absPath = path.resolve(envValue.trim());
+        if (!fs.existsSync(absPath)) {
+            throw new Error(`OPENRIG_MISSION_NOTES_TEMPLATE_PATH points at "${envValue}", which does not exist. ` +
+                "MISSION_NOTES.md not scaffolded. Set it to an absolute path to a readable template file, " +
+                "or unset it to use the built-in bundled fallback.");
+        }
+        const raw = fs.readFileSync(absPath, "utf8");
+        return applyMissionNotesPlaceholders(raw, opts);
+    }
+    return applyMissionNotesPlaceholders(MISSION_NOTES_BUILT_IN, opts);
+}
+export function workspaceScaffoldFiles() {
+    const files = [
+        { relPath: "README.md", content: WORKSPACE_README },
+        { relPath: "STEERING.md", content: STEERING_PLACEHOLDER },
+        { relPath: "missions/README.md", content: subdirReadmeContent("missions") },
+        { relPath: "artifacts/README.md", content: subdirReadmeContent("artifacts") },
+        { relPath: "evidence/README.md", content: subdirReadmeContent("evidence") },
+        { relPath: "progress/README.md", content: subdirReadmeContent("progress") },
+        { relPath: "field-notes/README.md", content: subdirReadmeContent("field-notes") },
+        { relPath: "specs/README.md", content: subdirReadmeContent("specs") },
+        { relPath: "dogfood-evidence/README.md", content: subdirReadmeContent("dogfood-evidence") },
+    ];
+    for (const mission of DEFAULT_MISSIONS) {
+        files.push({ relPath: `missions/${mission.id}/README.md`, content: missionReadme(mission) }, { relPath: `missions/${mission.id}/PROGRESS.md`, content: missionProgress(mission) }, { relPath: `missions/${mission.id}/MISSION_BRIEF.md`, content: renderDaemonMissionBrief(mission.title) }, 
+        // FR-5e A1 (daemon-side symmetry) — match CLI scaffold so UI-init
+        // produces a workspace that passes doctor check #7. The template
+        // resolution + env-var-pivot mirrors the CLI surface;
+        // getting-started-narrative-parity.test.ts asserts byte-identity.
+        {
+            relPath: `missions/${mission.id}/MISSION_NOTES.md`,
+            content: renderDaemonMissionNotes({
+                mission_id: mission.dotId,
+                mission_name: mission.title,
+                created_date: new Date().toISOString().slice(0, 10),
+            }),
+        });
+        for (const slice of mission.slices) {
+            files.push({ relPath: `missions/${mission.id}/slices/${slice.id}/README.md`, content: sliceReadme(mission, slice) }, { relPath: `missions/${mission.id}/slices/${slice.id}/PROGRESS.md`, content: sliceProgress(mission, slice) }, { relPath: `missions/${mission.id}/slices/${slice.id}/PROOF.md`, content: sliceProof(slice) }, { relPath: `missions/${mission.id}/slices/${slice.id}/IMPLEMENTATION-PRD.md`, content: slicePrd(mission, slice) });
+            // V0.3.1 slice 21: getting-started slices ship a timeline.md
+            // so the Story tab renders the worked-example narrative via
+            // slice-06's useSliceTimelineMarkdown hook.
+            const timeline = sliceTimeline(mission, slice);
+            if (timeline) {
+                files.push({
+                    relPath: `missions/${mission.id}/slices/${slice.id}/timeline.md`,
+                    content: timeline,
+                });
+            }
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=default-workspace-scaffold.js.map

package/node_modules/@openrig/daemon/dist/domain/workspace/default-workspace-scaffold.js.map

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

package/node_modules/@openrig/daemon/dist/domain/workspace/frontmatter-validator.d.ts

@@ -0,0 +1,40 @@
+import type { WorkspaceKind } from "../types.js";
+export type FrontmatterGapKind = "missing-required-field" | "unrecognized-status-value" | "parse-error" | "missing-frontmatter";
+export interface FrontmatterGap {
+    filePath: string;
+    /** Path relative to the validation root, for stable cross-machine output. */
+    relativePath: string;
+    kind: FrontmatterGapKind;
+    /** Field name when kind === "missing-required-field" or
+     *  "unrecognized-status-value"; null otherwise. */
+    field: string | null;
+    message: string;
+    /** Workspace kind the file was validated against (e.g. "knowledge"). */
+    workspaceKind: WorkspaceKind | null;
+}
+export interface FrontmatterValidationReport {
+    root: string;
+    /** Workspace kind applied to all files under this root. v0: caller picks
+     *  one root + one kind per invocation. */
+    workspaceKind: WorkspaceKind | null;
+    totalFiles: number;
+    filesWithFrontmatter: number;
+    gapCount: number;
+    gaps: FrontmatterGap[];
+}
+export interface ValidateOpts {
+    root: string;
+    workspaceKind?: WorkspaceKind;
+    /** When true, recurse into subdirectories. Defaults to true. */
+    recursive?: boolean;
+    /** When true, validate every .md file even if frontmatter is absent
+     *  (records a `missing-frontmatter` gap). Defaults to false — files
+     *  without `---` are skipped silently (treated as informal notes). */
+    requireFrontmatter?: boolean;
+    /** Hard cap on files walked. Defaults to 10000. Prevents accidental
+     *  multi-GB walks from runaway invocations. */
+    maxFiles?: number;
+}
+/** Run the frontmatter validator. */
+export declare function validateWorkspaceFrontmatter(opts: ValidateOpts): FrontmatterValidationReport;
+//# sourceMappingURL=frontmatter-validator.d.ts.map

package/node_modules/@openrig/daemon/dist/domain/workspace/frontmatter-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-validator.d.ts","sourceRoot":"","sources":["../../../src/domain/workspace/frontmatter-validator.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,MAAM,kBAAkB,GAC1B,wBAAwB,GACxB,2BAA2B,GAC3B,aAAa,GACb,qBAAqB,CAAC;AAE1B,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,kBAAkB,CAAC;IACzB;uDACmD;IACnD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb;8CAC0C;IAC1C,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,EAAE,CAAC;CACxB;AAaD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;0EAEsE;IACtE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;mDAC+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,YAAY,GAAG,2BAA2B,CAqD5F"}