@kynetic-ai/spec 0.9.1 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynetic-ai/spec",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "Kynetic Spec - Structured specification format for human-AI collaboration",
   "type": "module",
   "workspaces": [
@@ -22,9 +22,10 @@
   "author": "Kynetic AI",
   "scripts": {
     "bootstrap": "node scripts/bootstrap.cjs",
-    "build": "tsc && chmod +x dist/cli/index.js && npm run build:daemon && npm run build:plugin",
+    "build": "tsc && chmod +x dist/cli/index.js && npm run build:daemon && npm run build:web-ui && npm run build:plugin",
     "build:plugin": "node scripts/build-plugin.cjs",
     "build:daemon": "shx rm -rf dist/daemon && shx mkdir -p dist/daemon && shx cp -r packages/daemon/src/* dist/daemon/",
+    "build:web-ui": "shx rm -rf dist/web-ui && cd packages/web-ui && npm run build && shx cp -r build ../../dist/web-ui",
     "dev": "tsx src/cli/index.ts",
     "setup:dev": "npm install && npm run build && npm link",
     "prepack": "npm run build:plugin",

package/plugin/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "kspec",
       "description": "kspec agent skills",
-      "version": "0.9.1",
+      "version": "0.10.0",
       "source": "./plugins/kspec",
       "category": "development"
     }

package/plugin/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "kspec",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "kspec agent skills"
 }

package/plugin/plugins/kspec/skills/task-work/SKILL.md

@@ -61,6 +61,7 @@ Use CLI commands to find information. **Do NOT search `.kspec/` YAML files manua
 | List by type | `kspec item list --type feature` |
 | All traits | `kspec trait list` |
 | Task's linked spec | `kspec task get @ref` → read `spec_ref` field |
+| Task's linked plan | `kspec task get @ref` → if `plan_ref` is non-null, run `kspec plan get @plan-ref` |
 
 **Key pattern:** When `kspec item get` output shows "Inherited from @trait-slug", run `kspec item get @trait-slug` to see the trait's ACs. One command — do not grep YAML files.
 
@@ -93,9 +94,30 @@ If already implemented: verify tests pass, AC coverage exists, then `kspec task
 ### 3. Start Task
 
 ```bash
+# Check task links first
+kspec task get @ref
+
+# If plan_ref is non-null, load implementation context from the plan
+kspec plan get @plan-ref
+
+# Then start work
 kspec task start @ref
 ```
 
+### 3.5 Branch Isolation (Required Before Edits)
+
+Immediately after `kspec task start` and before any file edits, create or switch to a dedicated branch for that task. Do not keep implementing on a branch that is tied to another pending-review task.
+
+```bash
+# Example naming from task intent/slug
+TASK_BRANCH="fix/<task-slug>"
+
+# Create the branch if missing, otherwise switch to it
+git checkout -b "$TASK_BRANCH" 2>/dev/null || git checkout "$TASK_BRANCH"
+```
+
+This keeps each task's commits scoped to its own PR and prevents cross-task contamination.
+
 ### 4. Work and Note
 
 Read all ACs (own + trait) before implementing:
@@ -266,6 +288,7 @@ kspec tasks ready --eligible  # Only automation-eligible tasks
 ### Key Behaviors
 
 - Verify work is needed before starting (prevent duplicates)
+- Create/switch to a dedicated task branch before making code edits
 - Decisions auto-resolve without prompts
 - PR review handled externally (not this workflow)
 - All actions are logged and auditable
@@ -288,12 +311,12 @@ After blocking:
 kspec task block @ref --reason "Reason..."
 kspec tasks ready --eligible  # Check for other work
 # If tasks exist: work on the next one
-# If empty: stop responding (ralph auto-exits)
+# If empty: stop responding (agent dispatch exits automatically)
 ```
 
 ### Turn Completion
 
-After creating a PR, **stop responding**. Ralph continues automatically — it checks for remaining eligible tasks and exits the loop when none remain.
+After creating a PR, **stop responding**. The agent dispatch engine continues automatically — it checks for remaining eligible tasks and exits when none remain.
 
 **Do NOT call `end-loop`** after creating a PR. That ends ALL remaining iterations. It's a rare escape hatch for when work is stalling across multiple iterations.
 

package/templates/agents-sections/06-ralph-loop.md

@@ -1,24 +1,77 @@
-## Ralph Loop Mode
+## Agent Dispatch Mode
 
-When running in automated loop mode (ralph):
+When running as an automated agent via the dispatch engine:
 
-### The Loop
+### Dispatch Engine Commands
+
+```bash
+# Start background dispatch (daemon must be running)
+kspec agent dispatch start
+
+# Inspect active/queued work and loaded agents
+kspec agent dispatch status
+
+# Stream live text output from running invocations
+kspec agent dispatch watch
+
+# Stop dispatch gracefully
+kspec agent dispatch stop
+```
+
+### Built-In Agents
+
+`kspec setup` ensures default worker/reviewer agent definitions exist in `kynetic.meta.yaml`:
+
+- `task-worker` — handles automation-eligible `task.ready`, `task.in_progress`, and `task.needs_work`
+- `pr-reviewer` — handles `task.pending_review`
+
+Inspect current definitions with:
+
+```bash
+kspec agent list
+```
+
+### Dispatch Rules and Trigger Events
+
+| Trigger event | Typical handler | Notes |
+|---------------|-----------------|-------|
+| `task.ready` | `task-worker` | Worker picks up newly ready automation-eligible tasks |
+| `task.in_progress` | `task-worker` | Worker can continue existing automation-eligible tasks |
+| `task.needs_work` | `task-worker` | Fix-cycle tasks return to worker |
+| `task.pending_review` | `pr-reviewer` | Review/merge workflow runs in separate invocation |
+
+### One-Shot Invocation
+
+Run a single agent directly (outside dispatch):
+
+```bash
+kspec agent run <agent-id> [prompt]
+```
+
+Common flags:
+
+- `--task @task-ref` to target a specific task
+- `--dry-run` to preview prompt without spawning
+- `--json` for structured output
+- `--timeout <minutes>` and `--budget <n>` for execution limits
+
+### Dispatch Loop Behavior
 
 ```
-for each iteration:
-  1. Ralph checks eligible tasks — if none, exits loop
+for each dispatched invocation:
+  1. Agent runtime checks eligible tasks — if none, invocation ends
   2. Agent works on tasks, may create PR(s)
+     - Before editing files on a selected task, create/switch to a dedicated task branch
   3. Agent stops responding (turn complete)
-  4. Ralph sends reflection prompt
-  5. Ralph processes pending_review via subagent
-  6. Continue
+  4. pr-reviewer agent handles pending_review tasks via separate dispatch
+  5. Continue
 ```
 
-**When you stop responding, ralph continues automatically.** Do NOT call `end-loop` after creating a PR.
+**When you stop responding, the dispatch engine continues automatically.** Do NOT call `kspec agent end-loop` after creating a PR.
 
 ### Task Inheritance
 
-Priority: `needs_work` > `in_progress` > `pending`. Always inherit existing work before starting new tasks. (`pending_review` tasks are handled by the review subagent, not the worker.)
+Priority: `needs_work` > `in_progress` > `pending`. Always inherit existing work before starting new tasks. (`pending_review` tasks are handled by the pr-reviewer agent, not the worker.)
 
 ### Blocking Rules
 
@@ -39,7 +92,7 @@ Priority: `needs_work` > `in_progress` > `pending`. Always inherit existing work
 kspec task block @task --reason "Reason..."
 kspec tasks ready --eligible
 # If tasks returned: work on next one
-# If empty: stop responding — ralph auto-exits
+# If empty: stop responding — dispatch engine auto-exits
 ```
 
 **One blocked task is NOT "no more work."** `kspec tasks ready --eligible` output is authoritative.

package/templates/skills/task-work/SKILL.md

@@ -54,6 +54,7 @@ Use CLI commands to find information. **Do NOT search `.kspec/` YAML files manua
 | List by type | `kspec item list --type feature` |
 | All traits | `kspec trait list` |
 | Task's linked spec | `kspec task get @ref` → read `spec_ref` field |
+| Task's linked plan | `kspec task get @ref` → if `plan_ref` is non-null, run `kspec plan get @plan-ref` |
 
 **Key pattern:** When `kspec item get` output shows "Inherited from @trait-slug", run `kspec item get @trait-slug` to see the trait's ACs. One command — do not grep YAML files.
 
@@ -86,9 +87,30 @@ If already implemented: verify tests pass, AC coverage exists, then `kspec task
 ### 3. Start Task
 
 ```bash
+# Check task links first
+kspec task get @ref
+
+# If plan_ref is non-null, load implementation context from the plan
+kspec plan get @plan-ref
+
+# Then start work
 kspec task start @ref
 ```
 
+### 3.5 Branch Isolation (Required Before Edits)
+
+Immediately after `kspec task start` and before any file edits, create or switch to a dedicated branch for that task. Do not keep implementing on a branch that is tied to another pending-review task.
+
+```bash
+# Example naming from task intent/slug
+TASK_BRANCH="fix/<task-slug>"
+
+# Create the branch if missing, otherwise switch to it
+git checkout -b "$TASK_BRANCH" 2>/dev/null || git checkout "$TASK_BRANCH"
+```
+
+This keeps each task's commits scoped to its own PR and prevents cross-task contamination.
+
 ### 4. Work and Note
 
 Read all ACs (own + trait) before implementing:
@@ -259,6 +281,7 @@ kspec tasks ready --eligible  # Only automation-eligible tasks
 ### Key Behaviors
 
 - Verify work is needed before starting (prevent duplicates)
+- Create/switch to a dedicated task branch before making code edits
 - Decisions auto-resolve without prompts
 - PR review handled externally (not this workflow)
 - All actions are logged and auditable
@@ -281,12 +304,12 @@ After blocking:
 kspec task block @ref --reason "Reason..."
 kspec tasks ready --eligible  # Check for other work
 # If tasks exist: work on the next one
-# If empty: stop responding (ralph auto-exits)
+# If empty: stop responding (agent dispatch exits automatically)
 ```
 
 ### Turn Completion
 
-After creating a PR, **stop responding**. Ralph continues automatically — it checks for remaining eligible tasks and exits the loop when none remain.
+After creating a PR, **stop responding**. The agent dispatch engine continues automatically — it checks for remaining eligible tasks and exits when none remain.
 
 **Do NOT call `end-loop`** after creating a PR. That ends ALL remaining iterations. It's a rare escape hatch for when work is stalling across multiple iterations.
 

package/dist/ralph/cli-renderer.d.ts

@@ -1,27 +0,0 @@
-/**
- * Ralph CLI Renderer
- *
- * Renders RalphEvents to the terminal with chalk colors and formatting.
- * This is the CLI-specific implementation; other renderers (TUI) could
- * consume the same event stream with different display logic.
- */
-import type { RalphEvent } from "./events.js";
-export interface RalphRenderer {
-    /**
-     * Render an event to the output.
-     */
-    render(event: RalphEvent): void;
-    /**
-     * Called when a new section starts (e.g., iteration boundary).
-     */
-    newSection?(label: string): void;
-}
-export declare function createCliRenderer(): RalphRenderer;
-/**
- * Create a renderer that prefixes all output with a label.
- * Used to distinguish subagent output from main agent output.
- *
- * AC: @ralph-subagent-spawning ac-11
- */
-export declare function createPrefixedRenderer(prefix: string): RalphRenderer;
-//# sourceMappingURL=cli-renderer.d.ts.map

package/dist/ralph/cli-renderer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-renderer.d.ts","sourceRoot":"","sources":["../../src/ralph/cli-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAGV,UAAU,EAKX,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAgCD,wBAAgB,iBAAiB,IAAI,aAAa,CAgDjD;AA8JD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAqEpE"}

package/dist/ralph/cli-renderer.js

@@ -1,250 +0,0 @@
-/**
- * Ralph CLI Renderer
- *
- * Renders RalphEvents to the terminal with chalk colors and formatting.
- * This is the CLI-specific implementation; other renderers (TUI) could
- * consume the same event stream with different display logic.
- */
-import chalk from "chalk";
-// ============================================================================
-// Timestamp Formatting
-// ============================================================================
-/**
- * Format milliseconds as relative timestamp.
- * Examples: +0s, +5s, +1m, +2m30s
- */
-function formatTimestamp(ms) {
-    const seconds = Math.floor(ms / 1000);
-    if (seconds < 60) {
-        return `+${seconds}s`;
-    }
-    const minutes = Math.floor(seconds / 60);
-    const remainingSeconds = seconds % 60;
-    if (remainingSeconds === 0) {
-        return `+${minutes}m`;
-    }
-    return `+${minutes}m${remainingSeconds}s`;
-}
-export function createCliRenderer() {
-    const state = {
-        lastEventType: null,
-        isStreaming: false,
-    };
-    function render(event) {
-        const ts = chalk.gray(`[${formatTimestamp(event.timestamp)}]`);
-        const data = event.data;
-        switch (data.kind) {
-            case "agent_message":
-                renderAgentMessage(ts, data, state);
-                break;
-            case "agent_thought":
-                renderAgentThought(ts, data, state);
-                break;
-            case "tool_start":
-                renderToolStart(ts, data, state);
-                break;
-            case "tool_update":
-                renderToolUpdate(ts, data);
-                break;
-            case "tool_result":
-                renderToolResult(ts, data, state);
-                break;
-            case "status":
-                renderStatus(ts, data);
-                break;
-        }
-    }
-    function newSection(label) {
-        // End any streaming state
-        if (state.isStreaming) {
-            process.stdout.write("\n");
-            state.isStreaming = false;
-        }
-        state.lastEventType = null;
-        console.log("");
-        console.log(chalk.cyan(`${"─".repeat(60)}`));
-        console.log(chalk.cyan.bold(label));
-        console.log(chalk.cyan(`${"─".repeat(60)}`));
-        console.log("");
-    }
-    return { render, newSection };
-}
-// ============================================================================
-// Event Renderers
-// ============================================================================
-function renderAgentMessage(ts, data, state) {
-    // New section header if switching from non-message
-    if (state.lastEventType !== "agent_message" && !state.isStreaming) {
-        if (state.lastEventType !== null) {
-            console.log(""); // Spacing
-        }
-        console.log(`${ts} ${chalk.blue("--- Agent ---")}`);
-    }
-    // Stream content directly
-    if (data.isStreaming) {
-        process.stdout.write(data.content);
-        state.isStreaming = true;
-    }
-    else {
-        // Final content - ensure newline
-        if (state.isStreaming) {
-            process.stdout.write("\n");
-        }
-        state.isStreaming = false;
-    }
-    state.lastEventType = "agent_message";
-}
-function renderAgentThought(ts, data, state) {
-    // New section header if switching from non-thought
-    if (state.lastEventType !== "agent_thought" && !state.isStreaming) {
-        if (state.lastEventType !== null) {
-            console.log("");
-        }
-        console.log(`${ts} ${chalk.magenta("--- Thinking ---")}`);
-    }
-    // Stream content in dim/gray
-    if (data.isStreaming) {
-        process.stdout.write(chalk.dim(data.content));
-        state.isStreaming = true;
-    }
-    else {
-        if (state.isStreaming) {
-            process.stdout.write("\n");
-        }
-        state.isStreaming = false;
-    }
-    state.lastEventType = "agent_thought";
-}
-function renderToolStart(ts, data, state) {
-    // End any streaming
-    if (state.isStreaming) {
-        process.stdout.write("\n");
-        state.isStreaming = false;
-    }
-    if (state.lastEventType !== null) {
-        console.log("");
-    }
-    console.log(`${ts} ${chalk.yellow(`--- Tool: ${data.tool} ---`)}`);
-    // Show summary if available
-    if (data.summary) {
-        console.log(`${ts} ${chalk.gray(data.summary)}`);
-    }
-    state.lastEventType = "tool_start";
-}
-function renderToolUpdate(ts, data) {
-    // If summary is present, this is the phased input arrival - show the summary
-    if (data.summary) {
-        console.log(`${ts} ${chalk.gray(data.summary)}`);
-        return;
-    }
-    // Otherwise show status update
-    const statusIcon = data.status === "running" ? chalk.blue("⟳") : chalk.gray("○");
-    console.log(`${ts} ${statusIcon} ${chalk.gray(data.status)}`);
-}
-function renderToolResult(ts, data, state) {
-    // Status line
-    const statusColor = data.status === "completed"
-        ? chalk.green
-        : data.status === "failed"
-            ? chalk.red
-            : chalk.yellow;
-    const statusIcon = data.status === "completed" ? "✓" : data.status === "failed" ? "✗" : "○";
-    console.log(`${ts} ${statusColor(`${statusIcon} ${data.status}`)}`);
-    // Output (if any)
-    if (data.output) {
-        const outputLines = data.output.split("\n");
-        const indent = "       "; // Align with timestamp
-        // Show output with indentation
-        for (const line of outputLines.slice(0, 20)) {
-            console.log(chalk.gray(`${indent}${line}`));
-        }
-        if (data.truncated) {
-            console.log(chalk.gray(`${indent}... (truncated)`));
-        }
-    }
-    state.lastEventType = "tool_result";
-}
-function renderStatus(ts, data) {
-    const statusColor = data.status === "completed" || data.status === "end_turn"
-        ? chalk.green
-        : data.status === "error" || data.status === "crashed"
-            ? chalk.red
-            : chalk.gray;
-    let statusText = data.status;
-    if (data.message) {
-        statusText += `: ${data.message}`;
-    }
-    console.log(`${ts} ${statusColor(`[${statusText}]`)}`);
-}
-/**
- * Create a renderer that prefixes all output with a label.
- * Used to distinguish subagent output from main agent output.
- *
- * AC: @ralph-subagent-spawning ac-11
- */
-export function createPrefixedRenderer(prefix) {
-    const inner = createCliRenderer();
-    const prefixStr = chalk.cyan(`${prefix} `);
-    const state = {
-        atLineStart: true,
-    };
-    /**
-     * Execute a function with prefixed console.log and stdout.write.
-     * Ensures all output is prefixed consistently.
-     */
-    function withPrefixedOutput(fn) {
-        const originalLog = console.log;
-        const originalWrite = process.stdout.write;
-        // Wrap console.log - prefix is handled by stdout.write wrapper below,
-        // so we just delegate to the original and mark line start.
-        console.log = (...args) => {
-            originalLog(...args);
-            state.atLineStart = true;
-        };
-        // Wrap process.stdout.write for streaming content
-        // Track line boundaries to only prefix at start of lines
-        // biome-ignore lint/suspicious/noExplicitAny: stdout.write has complex overloads
-        process.stdout.write = (chunk, ...args) => {
-            if (typeof chunk === "string") {
-                // Split by newlines but preserve them
-                const parts = chunk.split(/(\n)/);
-                let output = "";
-                for (const part of parts) {
-                    if (part === "\n") {
-                        output += part;
-                        state.atLineStart = true;
-                    }
-                    else if (part.length > 0) {
-                        if (state.atLineStart) {
-                            output += prefixStr + part;
-                            state.atLineStart = false;
-                        }
-                        else {
-                            output += part;
-                        }
-                    }
-                }
-                return originalWrite.call(process.stdout, output, ...args);
-            }
-            // For Uint8Array, pass through unchanged
-            return originalWrite.call(process.stdout, chunk, ...args);
-        };
-        try {
-            return fn();
-        }
-        finally {
-            console.log = originalLog;
-            process.stdout.write = originalWrite;
-        }
-    }
-    return {
-        render(event) {
-            withPrefixedOutput(() => inner.render(event));
-        },
-        newSection(label) {
-            state.atLineStart = true;
-            withPrefixedOutput(() => inner.newSection?.(label));
-        },
-    };
-}
-//# sourceMappingURL=cli-renderer.js.map

package/dist/ralph/cli-renderer.js.map

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

package/dist/ralph/events.d.ts

@@ -1,65 +0,0 @@
-/**
- * Ralph Event System
- *
- * Translates ACP SessionUpdate events into structured RalphEvents.
- * This layer is pure data - no rendering concerns. Enables future
- * TUI or other renderers to consume the same event stream.
- */
-import type { SessionUpdate } from "../acp/types.js";
-export type RalphEventType = "agent_message" | "agent_thought" | "tool_start" | "tool_update" | "tool_result" | "status";
-export interface RalphEvent {
-    type: RalphEventType;
-    timestamp: number;
-    data: RalphEventData;
-}
-export type RalphEventData = AgentMessageData | AgentThoughtData | ToolStartData | ToolUpdateData | ToolResultData | StatusData;
-export interface AgentMessageData {
-    kind: "agent_message";
-    content: string;
-    isStreaming: boolean;
-}
-export interface AgentThoughtData {
-    kind: "agent_thought";
-    content: string;
-    isStreaming: boolean;
-}
-export interface ToolStartData {
-    kind: "tool_start";
-    toolCallId: string;
-    tool: string;
-    summary: string;
-    input: unknown;
-}
-export interface ToolUpdateData {
-    kind: "tool_update";
-    toolCallId: string;
-    tool: string;
-    status: "pending" | "running";
-    summary?: string;
-}
-export interface ToolResultData {
-    kind: "tool_result";
-    toolCallId: string;
-    tool: string;
-    status: "completed" | "failed" | "cancelled";
-    output?: string;
-    truncated: boolean;
-}
-export interface StatusData {
-    kind: "status";
-    status: string;
-    message?: string;
-}
-export interface RalphTranslator {
-    /**
-     * Translate an ACP SessionUpdate to a RalphEvent.
-     * Returns null if the update should be suppressed.
-     */
-    translate(update: SessionUpdate): RalphEvent | null;
-    /**
-     * Signal end of stream. Returns final event if there's pending state.
-     */
-    finalize(): RalphEvent | null;
-}
-export declare function createTranslator(): RalphTranslator;
-//# sourceMappingURL=events.d.ts.map

package/dist/ralph/events.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/ralph/events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMrD,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,eAAe,GACf,YAAY,GACZ,aAAa,GACb,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,cAAc,GACd,UAAU,CAAC;AAEf,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,GAAG,IAAI,CAAC;IAEpD;;OAEG;IACH,QAAQ,IAAI,UAAU,GAAG,IAAI,CAAC;CAC/B;AA2VD,wBAAgB,gBAAgB,IAAI,eAAe,CAqWlD"}