@blxzer/cursor-trellis 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,258 @@
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import { Command } from "commander";
+import { init } from "../commands/init.js";
+import { update } from "../commands/update.js";
+import { rollout } from "../commands/rollout.js";
+import { upgrade } from "../commands/upgrade.js";
+import { uninstall } from "../commands/uninstall.js";
+import { runMem } from "../commands/mem.js";
+import { runWorkflowCommand, WorkflowCommandError, } from "../commands/workflow.js";
+import { registerChannelCommand } from "../commands/channel/index.js";
+import { DIR_NAMES } from "../constants/paths.js";
+import { PACKAGE_NAME, VERSION } from "../constants/version.js";
+import { compareVersions } from "../utils/compare-versions.js";
+// Re-export for backwards compatibility (consumers should prefer constants/version.js)
+export { VERSION, PACKAGE_NAME };
+/**
+ * Check if a Trellis update is available (compare project version with CLI version)
+ */
+function checkForUpdates(cwd) {
+    const versionFile = path.join(cwd, DIR_NAMES.WORKFLOW, ".version");
+    if (!fs.existsSync(versionFile))
+        return;
+    const projectVersion = fs.readFileSync(versionFile, "utf-8").trim();
+    const cliVersion = VERSION;
+    const comparison = compareVersions(cliVersion, projectVersion);
+    if (comparison > 0) {
+        // CLI is newer than project - update available
+        console.log(chalk.yellow(`\n⚠️  Trellis update available: ${projectVersion} → ${cliVersion}`));
+        console.log(chalk.gray(`   Run: trellis update\n`));
+    }
+    else if (comparison < 0) {
+        // CLI is older than project - CLI needs updating
+        console.log(chalk.yellow(`\n⚠️  Your CLI (${cliVersion}) is older than project (${projectVersion})`));
+        console.log(chalk.gray(`   Run: trellis upgrade\n`));
+    }
+}
+// Check for updates at CLI startup (only if .trellis exists)
+const cwd = process.cwd();
+if (fs.existsSync(path.join(cwd, DIR_NAMES.WORKFLOW))) {
+    checkForUpdates(cwd);
+}
+const program = new Command();
+function collectOption(value, previous) {
+    return [...previous, value];
+}
+program
+    .name("trellis")
+    .description("AI-assisted development workflow framework for Codex, Claude Code, and Cursor")
+    .version(VERSION, "-v, --version", "output the version number");
+program
+    .command("init")
+    .description("Initialize trellis in the current project")
+    .option("--cursor", "Include Cursor commands")
+    .option("--claude", "Include Claude Code commands")
+    .option("--opencode", "Include OpenCode commands")
+    .option("--codex", "Include Codex skills")
+    .option("--kilo", "Include Kilo CLI commands")
+    .option("--kiro", "Include Kiro Code skills")
+    .option("--gemini", "Include Gemini CLI commands")
+    .option("--antigravity", "Include Antigravity workflows")
+    .option("--windsurf", "Include Windsurf workflows")
+    .option("--qoder", "Include Qoder commands")
+    .option("--codebuddy", "Include CodeBuddy commands")
+    .option("--copilot", "Include GitHub Copilot hooks")
+    .option("--droid", "Include Factory Droid commands")
+    .option("--pi", "Include Pi Agent extension assets")
+    .option("-y, --yes", "Skip prompts and use defaults")
+    .option("--cursor2plus", "Materialize Cursor++ BYOK local bundle (.trellis/local/cursor2plus/); ignored unless --cursor is also selected")
+    .option("-u, --user <name>", "Initialize developer identity with specified name")
+    .option("-f, --force", "Overwrite existing files without asking")
+    .option("-s, --skip-existing", "Skip existing files without asking")
+    .option("--skip-readiness", "Skip Smart Search and selected capability readiness checks and report framework readiness as unverified")
+    .option("--capability <id>", "Enable an optional project capability (repeatable; use 'all' for every selectable capability)", collectOption, [])
+    .option("--monorepo", "Force monorepo mode")
+    .option("--no-monorepo", "Skip monorepo detection")
+    .option("-t, --template <name>", "Use a remote spec template (e.g., electron-fullstack)")
+    .option("--overwrite", "Overwrite existing spec directory when using template")
+    .option("--append", "Only add missing files when using template")
+    .option("-r, --registry <source>", "Use a custom template registry (e.g., gh:myorg/myrepo/specs)")
+    .option("--workflow <id>", "Workflow template id for .trellis/workflow.md (default: native; e.g., tdd, channel-driven-subagent-dispatch)")
+    .option("--workflow-source <source>", "Custom marketplace source for the --workflow lookup (e.g., gh:myorg/myrepo/marketplace)")
+    .action(async (options) => {
+    try {
+        await init(options);
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("update")
+    .description("Update trellis configuration and commands to latest version")
+    .option("--dry-run", "Preview changes without applying them")
+    .option("-f, --force", "Overwrite all changed files without asking")
+    .option("-s, --skip-all", "Skip all changed files without asking")
+    .option("-n, --create-new", "Create .new copies for all changed files")
+    .option("--allow-downgrade", "Allow downgrading to an older version")
+    .option("--migrate", "Apply pending file migrations (renames/deletions)")
+    .option("--skip-readiness", "Skip Smart Search and selected capability readiness checks and report framework readiness as unverified")
+    .option("--json", "Emit one-line JSON rollout evidence (dry-run or apply)")
+    .option("--skip-post-update-smoke", "Skip post-apply Python script smoke checks")
+    .action(async (options) => {
+    try {
+        await update({
+            dryRun: options.dryRun,
+            force: options.force,
+            skipAll: options.skipAll,
+            createNew: options.createNew,
+            allowDowngrade: options.allowDowngrade,
+            migrate: options.migrate,
+            skipReadiness: options.skipReadiness,
+            json: options.json,
+            skipPostUpdateSmoke: options.skipPostUpdateSmoke,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("rollout")
+    .description("Run trellis update across multiple project paths and aggregate rollout evidence")
+    .requiredOption("-p, --project <path>", "Project root with .trellis/ (repeatable)", (val, prev) => [...(prev ?? []), val], [])
+    .option("--dry-run", "Preview updates without applying")
+    .option("-f, --force", "Overwrite all changed files without asking")
+    .option("-s, --skip-all", "Skip all changed files without asking")
+    .option("-n, --create-new", "Create .new copies for all changed files")
+    .option("--migrate", "Apply pending file migrations")
+    .option("--allow-downgrade", "Allow downgrading project version")
+    .option("--skip-readiness", "Skip readiness checks")
+    .option("--skip-post-update-smoke", "Skip post-apply script smoke")
+    .option("--json", "Emit aggregated JSON rollout evidence")
+    .option("-o, --output <file>", "Write --json output to file")
+    .action(async (options) => {
+    try {
+        await rollout({
+            projects: options.project,
+            dryRun: options.dryRun,
+            force: options.force,
+            skipAll: options.skipAll,
+            createNew: options.createNew,
+            migrate: options.migrate,
+            allowDowngrade: options.allowDowngrade,
+            skipReadiness: options.skipReadiness,
+            skipPostUpdateSmoke: options.skipPostUpdateSmoke,
+            json: options.json,
+            output: options.output,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("upgrade")
+    .description("Upgrade the global Trellis CLI package")
+    .option("--tag <tag>", "npm dist-tag or version to install (default follows current channel: latest, beta, or rc)")
+    .option("--dry-run", "Print the install command without running it")
+    .action(async (options) => {
+    try {
+        await upgrade({
+            tag: options.tag,
+            dryRun: options.dryRun,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("uninstall")
+    .description("Remove all trellis files (managed platform files + .trellis/) from this project")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .option("--dry-run", "List what would be removed without changing anything")
+    .action(async (options) => {
+    try {
+        await uninstall({
+            yes: options.yes,
+            dryRun: options.dryRun,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("mem")
+    .description("Search/recall AI conversation history across Claude Code, Codex, OpenCode (run 'trellis mem help' for subcommands and flags)")
+    .allowUnknownOption(true)
+    .helpOption(false)
+    .argument("[args...]", "subcommand and arguments (list|search|context|extract|projects|help)")
+    .action((args = []) => {
+    try {
+        runMem(args);
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("workflow")
+    .description("List or switch the project's .trellis/workflow.md template (native, tdd, channel-driven-subagent-dispatch, or marketplace)")
+    .option("-t, --template <id>", "Workflow template id (e.g., native, tdd, channel-driven-subagent-dispatch)")
+    .option("-m, --marketplace <source>", "Custom marketplace source (e.g., gh:myorg/myrepo/marketplace)")
+    .option("--list", "List available workflow templates and exit")
+    .option("-f, --force", "Overwrite a modified workflow.md without asking")
+    .option("-n, --create-new", "Write .trellis/workflow.md.new instead of replacing the active workflow")
+    .action(async (options) => {
+    try {
+        await runWorkflowCommand({
+            template: options.template,
+            marketplace: options.marketplace,
+            list: options.list,
+            force: options.force,
+            createNew: options.createNew,
+        });
+    }
+    catch (error) {
+        if (error instanceof WorkflowCommandError) {
+            console.error(chalk.red("Error:"), error.message);
+            process.exit(1);
+        }
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+registerChannelCommand(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/commands/channel/adapters/claude.d.ts

@@ -0,0 +1,29 @@
+import type { ParseResult } from "./types.js";
+/**
+ * Parse one line of Claude stream-json stdout.
+ * Returns the channel events to emit + any side effects.
+ *
+ * Pure function: same input always produces same output. No I/O.
+ */
+export declare function parseClaudeLine(line: string): ParseResult;
+/**
+ * Encode a channel user message into Claude stream-json stdin line(s).
+ */
+export declare function encodeClaudeUserMessage(text: string): string;
+/**
+ * Send Claude's provider-level interrupt control request before the
+ * replacement prompt. Current SDK behavior is best-effort, but keeping it
+ * separate from channel message metadata makes interrupt an explicit command path.
+ */
+export declare function encodeClaudeInterruptMessage(text: string): string;
+/**
+ * Build the Claude CLI args for `claude -p` in stream-json mode.
+ */
+export declare function buildClaudeArgs(opts: {
+    resumeSessionId?: string;
+    model?: string;
+    verbose?: boolean;
+    /** Appended to Claude's default system prompt (per agent definition body). */
+    systemPrompt?: string;
+}): string[];
+//# sourceMappingURL=claude.d.ts.map

package/dist/commands/channel/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../../src/commands/channel/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,YAAY,CAAC;AA4D5D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAuCzD;AAyFD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,EAAE,CAkBX"}

package/dist/commands/channel/adapters/claude.js

@@ -0,0 +1,203 @@
+function summarizeInput(input, max = 120) {
+    if (input === null || input === undefined)
+        return "";
+    let s;
+    try {
+        s = typeof input === "string" ? input : JSON.stringify(input);
+    }
+    catch {
+        s = String(input);
+    }
+    return s.length > max ? s.slice(0, max) + "…" : s;
+}
+function isMcpToolName(name) {
+    return /^mcp__/.test(name);
+}
+/**
+ * Parse one line of Claude stream-json stdout.
+ * Returns the channel events to emit + any side effects.
+ *
+ * Pure function: same input always produces same output. No I/O.
+ */
+export function parseClaudeLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return { events: [] };
+    let msg;
+    try {
+        msg = JSON.parse(trimmed);
+    }
+    catch {
+        return {
+            events: [
+                {
+                    kind: "error",
+                    payload: {
+                        message: "Failed to parse Claude stdout line",
+                        raw_excerpt: trimmed.slice(0, 200),
+                    },
+                },
+            ],
+        };
+    }
+    switch (msg.type) {
+        case "system":
+            return handleSystem(msg);
+        case "assistant":
+            return handleAssistant(msg);
+        case "user":
+            return { events: [] };
+        case "rate_limit_event":
+            return { events: [] };
+        case "result":
+            return handleResult(msg);
+        case "control_response":
+            // Acknowledgement of our outbound control_request (e.g. interrupt).
+            // Silently consume — supervisor doesn't need to wait on it.
+            return { events: [] };
+        default:
+            return { events: [] };
+    }
+}
+function handleSystem(msg) {
+    if (msg.subtype === "init" && msg.session_id) {
+        return {
+            events: [],
+            side: { persistSessionId: msg.session_id },
+        };
+    }
+    return { events: [] };
+}
+function handleAssistant(msg) {
+    const blocks = msg.message?.content;
+    if (!Array.isArray(blocks))
+        return { events: [] };
+    const events = [];
+    for (const b of blocks) {
+        switch (b.type) {
+            case "text": {
+                if (b.text && b.text.length > 0) {
+                    events.push({ kind: "message", payload: { text: b.text } });
+                }
+                break;
+            }
+            case "tool_use": {
+                const name = b.name ?? "";
+                const payload = {
+                    detail: {
+                        tool: name,
+                        input_summary: summarizeInput(b.input),
+                    },
+                };
+                if (isMcpToolName(name)) {
+                    const parts = name.split("__");
+                    payload.detail.kind = "mcp";
+                    if (parts.length >= 3) {
+                        payload.detail.server = parts[1];
+                        payload.detail.tool_name = parts
+                            .slice(2)
+                            .join("__");
+                    }
+                }
+                events.push({ kind: "progress", payload });
+                break;
+            }
+            case "thinking":
+                // skip in default mode
+                break;
+            default:
+                // unknown block type — skip silently
+                break;
+        }
+    }
+    return { events };
+}
+function handleResult(msg) {
+    if (msg.is_error) {
+        return {
+            events: [
+                {
+                    kind: "error",
+                    payload: {
+                        message: msg.result ?? "Claude reported is_error",
+                        duration_ms: msg.duration_ms,
+                    },
+                },
+            ],
+        };
+    }
+    // Intentionally do NOT copy `msg.result` into `done.text`. Claude already
+    // emitted the final text as an `assistant.message.content[].text` block,
+    // which we turned into a `kind:message` event above. Repeating it on
+    // `done` makes GUI consumers render the answer twice.
+    return {
+        events: [
+            {
+                kind: "done",
+                payload: {
+                    duration_ms: msg.duration_ms,
+                    total_cost_usd: msg.total_cost_usd,
+                    num_turns: msg.num_turns,
+                },
+            },
+        ],
+    };
+}
+/**
+ * Encode a channel user message into Claude stream-json stdin line(s).
+ */
+export function encodeClaudeUserMessage(text) {
+    const lines = [];
+    lines.push(JSON.stringify({
+        type: "user",
+        message: {
+            role: "user",
+            content: [{ type: "text", text }],
+        },
+    }));
+    return lines.join("\n") + "\n";
+}
+/**
+ * Send Claude's provider-level interrupt control request before the
+ * replacement prompt. Current SDK behavior is best-effort, but keeping it
+ * separate from channel message metadata makes interrupt an explicit command path.
+ */
+export function encodeClaudeInterruptMessage(text) {
+    const lines = [
+        JSON.stringify({
+            type: "control_request",
+            request_id: `trellis-int-${Date.now()}-${Math.random()
+                .toString(36)
+                .slice(2, 8)}`,
+            request: { subtype: "interrupt" },
+        }),
+        encodeClaudeUserMessage(text).trimEnd(),
+    ];
+    return lines.join("\n") + "\n";
+}
+/**
+ * Build the Claude CLI args for `claude -p` in stream-json mode.
+ */
+export function buildClaudeArgs(opts) {
+    const args = [
+        "-p",
+        "--input-format",
+        "stream-json",
+        "--output-format",
+        "stream-json",
+        "--permission-mode",
+        "bypassPermissions",
+        "--dangerously-skip-permissions",
+    ];
+    if (opts.verbose !== false)
+        args.push("--verbose");
+    if (opts.resumeSessionId)
+        args.push("--resume", opts.resumeSessionId);
+    if (opts.model)
+        args.push("--model", opts.model);
+    if (opts.systemPrompt?.trim()) {
+        args.push("--append-system-prompt", opts.systemPrompt);
+    }
+    return args;
+}
+//# sourceMappingURL=claude.js.map

package/dist/commands/channel/adapters/claude.js.map

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

package/dist/commands/channel/adapters/codex.d.ts

@@ -0,0 +1,85 @@
+import type { ParseResult } from "./types.js";
+/**
+ * Codex `app-server` adapter (JSON-RPC 2.0 over stdio).
+ *
+ * Wire shape (real data — see research/probes/codex/*.jsonl):
+ *
+ *   Three inbound message kinds:
+ *     1. Response to our outgoing request: { id, result } | { id, error }, no method
+ *     2. Server-to-client request:         { method, id, params }    — must reply
+ *     3. Notification:                     { method, params }        — fire-and-forget
+ *
+ *   Outbound: initialize → thread/start → turn/start
+ *
+ *   Translated events (per probe-findings.md):
+ *     thread/start result.thread.id      → persistThreadId + persistSessionId (same UUIDv7)
+ *     item/started   commandExecution    → progress(tool=shell, cmd, status=inProgress)
+ *     item/started   mcpToolCall         → progress(kind=mcp, server, tool, args_summary)
+ *     item/started   dynamicToolCall     → progress(kind=dynamic, namespace, tool, args)
+ *     item/started   webSearch           → progress(kind=web_search, query)
+ *     item/started   fileChange          → progress(kind=file_change)
+ *     item/completed agentMessage        → say(text, phase)
+ *     item/agentMessage/delta            → progress(kind, stream_id, text_delta)
+ *     item/completed commandExecution    → optional progress(status, exitCode)
+ *     item/started   collabAgentToolCall → error(reason=collab_blocked, recommendation=set features.multi_agent=false)
+ *     turn/completed                     → done
+ *     turn/aborted                       → error(reason=aborted)
+ *     warning                            → progress(kind=warning, message)
+ *     mcpServer/elicitation/request      → reply { action: accept, content: {} }  (auto-allow)
+ *
+ *   Notifications we skip silently:
+ *     remoteControl/status/changed
+ *     mcpServer/startupStatus/updated
+ *     mcpServer/oauthLoginCompleted
+ *     account/rateLimits/updated
+ *     thread/tokenUsage/updated
+ *     thread/status/changed
+ *     thread/started        (we record thread id from thread/start result instead)
+ *     turn/started
+ *     serverRequest/resolved
+ *     ItemGuardianApprovalReview* (until channel supports human-in-loop)
+ *
+ *  This module exposes:
+ *   - parseCodexLine(line, ctx) — pure parser; ctx tracks pending outgoing ids
+ *   - encodeCodexRequest / encodeCodexUserMessage — outbound framing helpers
+ *   - buildCodexArgs                                — CLI args
+ *   - createCodexCtx                                — state holder for pending ids
+ */
+export interface CodexCtx {
+    /** id → label tracking outgoing requests, so adapter can recognise their responses. */
+    pending: Map<number, "initialize" | "thread/start" | "turn/start" | "other">;
+    /** Codex item id → stream metadata used to classify interleaved deltas. */
+    items: Map<string, CodexItemMeta>;
+    /** Whether the current turn has emitted a final user-visible answer. */
+    finalMessageSeen: boolean;
+    /** Codex may send turn/completed before the final agentMessage item. */
+    pendingDone: boolean;
+    /** Last-known thread id (used to scope future requests). */
+    threadId?: string;
+    /** Monotonic outbound id allocator. */
+    nextId: number;
+}
+export declare function createCodexCtx(): CodexCtx;
+interface CodexItemMeta {
+    type?: string;
+    phase?: string;
+}
+export declare function parseCodexLine(line: string, ctx: CodexCtx): ParseResult;
+export declare function encodeCodexRequest(ctx: CodexCtx, method: string, params: unknown, label?: "initialize" | "thread/start" | "turn/start" | "other"): {
+    id: number;
+    line: string;
+};
+export declare function encodeCodexUserMessage(ctx: CodexCtx, text: string): {
+    id: number;
+    line: string;
+};
+export declare function encodeCodexInterruptMessage(ctx: CodexCtx, text: string): {
+    id: number;
+    line: string;
+};
+export declare function buildCodexArgs(opts: {
+    model?: string;
+}): string[];
+export declare function buildCodexThreadStartParams(cwd: string, systemPrompt?: string): Record<string, unknown>;
+export {};
+//# sourceMappingURL=codex.d.ts.map

package/dist/commands/channel/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../../src/commands/channel/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,MAAM,WAAW,QAAQ;IACvB,uFAAuF;IACvF,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC;IAC7E,2EAA2E;IAC3E,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClC,wEAAwE;IACxE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,WAAW,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,IAAI,QAAQ,CAQzC;AAED,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,WAAW,CAqCvE;AAwZD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,KAAK,GAAE,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,OAAiB,GACtE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAK9B;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,MAAM,GACX;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAiB9B;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,MAAM,GACX;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAM9B;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAIjE;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB"}