pi-loop 0.1.0

package/dist/git/repo.d.ts

@@ -0,0 +1,13 @@
+export declare function gitExec(args: string[], cwd: string): Promise<string>;
+export declare function ensureRepo(cwd: string, autoInit: boolean): Promise<void>;
+export declare function getRepoRoot(cwd: string): Promise<string>;
+export declare function getCurrentBranch(cwd: string): Promise<string>;
+export declare function getStatus(cwd: string): Promise<string>;
+export declare function createBranch(cwd: string, name: string, base?: string): Promise<void>;
+export declare function checkoutBranch(cwd: string, name: string): Promise<void>;
+export declare function gitLog(cwd: string, count?: number): Promise<string>;
+export declare function stageAll(cwd: string): Promise<void>;
+export declare function commit(cwd: string, message: string): Promise<string>;
+export declare function resetHard(cwd: string): Promise<void>;
+export declare function diff(cwd: string, ref?: string): Promise<string>;
+//# sourceMappingURL=repo.d.ts.map

package/dist/git/repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/git/repo.ts"],"names":[],"mappings":"AAKA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1E;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB9E;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE9D;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5D;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1F;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7E;AAED,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1E;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrE"}

package/dist/git/repo.js

@@ -0,0 +1,74 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function gitExec(args, cwd) {
+    try {
+        const { stdout } = await execFileAsync("git", args, { cwd });
+        return stdout.trim();
+    }
+    catch (error) {
+        const err = error;
+        const stderr = err.stderr?.trim() ?? err.message ?? "Unknown git error";
+        throw new Error(`git ${args.join(" ")} failed: ${stderr}`);
+    }
+}
+export async function ensureRepo(cwd, autoInit) {
+    try {
+        await gitExec(["rev-parse", "--is-inside-work-tree"], cwd);
+    }
+    catch {
+        if (autoInit) {
+            await gitExec(["init"], cwd);
+        }
+        else {
+            throw new Error(`Not a git repository: ${cwd}`);
+        }
+    }
+    // Ensure at least one commit exists (required for worktree/branch operations)
+    try {
+        await gitExec(["rev-parse", "HEAD"], cwd);
+    }
+    catch {
+        // No commits yet — create an initial commit with whatever is in the directory
+        await gitExec(["add", "-A"], cwd);
+        await gitExec(["commit", "--allow-empty", "-m", "[pi-loop] initial commit"], cwd);
+    }
+}
+export async function getRepoRoot(cwd) {
+    return gitExec(["rev-parse", "--show-toplevel"], cwd);
+}
+export async function getCurrentBranch(cwd) {
+    return gitExec(["rev-parse", "--abbrev-ref", "HEAD"], cwd);
+}
+export async function getStatus(cwd) {
+    return gitExec(["status", "--porcelain"], cwd);
+}
+export async function createBranch(cwd, name, base) {
+    const args = ["branch", name];
+    if (base) {
+        args.push(base);
+    }
+    await gitExec(args, cwd);
+}
+export async function checkoutBranch(cwd, name) {
+    await gitExec(["checkout", name], cwd);
+}
+export async function gitLog(cwd, count = 20) {
+    return gitExec(["log", "--oneline", "-n", String(count)], cwd);
+}
+export async function stageAll(cwd) {
+    await gitExec(["add", "-A"], cwd);
+}
+export async function commit(cwd, message) {
+    await gitExec(["commit", "-m", message], cwd);
+    return gitExec(["rev-parse", "HEAD"], cwd);
+}
+export async function resetHard(cwd) {
+    await gitExec(["reset", "--hard", "HEAD"], cwd);
+}
+export async function diff(cwd, ref) {
+    const args = ["diff"];
+    args.push(ref ?? "HEAD");
+    return gitExec(args, cwd);
+}
+//# sourceMappingURL=repo.js.map

package/dist/git/repo.js.map

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

package/dist/git/same-branch.d.ts

@@ -0,0 +1,9 @@
+export interface PushResult {
+    success: boolean;
+    needsRebase: boolean;
+    commitHash?: string;
+}
+export declare function pullLatest(cwd: string): Promise<void>;
+export declare function commitAndPush(cwd: string, message: string, prefix: string): Promise<PushResult>;
+export declare function rebaseAndRetry(cwd: string, maxRetries: number): Promise<boolean>;
+//# sourceMappingURL=same-branch.d.ts.map

package/dist/git/same-branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"same-branch.d.ts","sourceRoot":"","sources":["../../src/git/same-branch.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3D;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAqBrG;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAetF"}

package/dist/git/same-branch.js

@@ -0,0 +1,55 @@
+import { gitExec } from "./repo.js";
+export async function pullLatest(cwd) {
+    try {
+        await gitExec(["pull", "--rebase"], cwd);
+    }
+    catch (error) {
+        const msg = error.message ?? "";
+        // Silently succeed if no remote configured
+        if (msg.includes("no tracking information") ||
+            msg.includes("No remote configured") ||
+            msg.includes("no such remote")) {
+            return;
+        }
+        throw error;
+    }
+}
+export async function commitAndPush(cwd, message, prefix) {
+    const prefixedMessage = prefix ? `${prefix} ${message}` : message;
+    await gitExec(["add", "-A"], cwd);
+    await gitExec(["commit", "-m", prefixedMessage], cwd);
+    const commitHash = (await gitExec(["rev-parse", "HEAD"], cwd)).trim();
+    try {
+        await gitExec(["push"], cwd);
+        return { success: true, needsRebase: false, commitHash };
+    }
+    catch (error) {
+        const msg = error.message ?? "";
+        if (msg.includes("rejected") || msg.includes("non-fast-forward")) {
+            return { success: false, needsRebase: true, commitHash };
+        }
+        // No remote configured — commit succeeded locally
+        if (msg.includes("no configured push destination") || msg.includes("No configured push destination")) {
+            return { success: true, needsRebase: false, commitHash };
+        }
+        throw error;
+    }
+}
+export async function rebaseAndRetry(cwd, maxRetries) {
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        try {
+            await gitExec(["pull", "--rebase"], cwd);
+            await gitExec(["push"], cwd);
+            return true;
+        }
+        catch (error) {
+            const msg = error.message ?? "";
+            if (msg.includes("rejected") || msg.includes("non-fast-forward")) {
+                continue;
+            }
+            throw error;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=same-branch.js.map

package/dist/git/same-branch.js.map

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

package/dist/git/worktree.d.ts

@@ -0,0 +1,14 @@
+export interface WorktreeInfo {
+    path: string;
+    branch: string;
+    head: string;
+}
+export interface MergeResult {
+    success: boolean;
+    conflictFiles?: string[];
+}
+export declare function createWorktree(repoRoot: string, taskId: string, baseBranch: string, baseDir: string, branchNameOverride?: string): Promise<string>;
+export declare function removeWorktree(repoRoot: string, worktreePath: string, branchName?: string): Promise<void>;
+export declare function listWorktrees(repoRoot: string): Promise<WorktreeInfo[]>;
+export declare function mergeWorktree(repoRoot: string, taskBranch: string, targetBranch: string): Promise<MergeResult>;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/git/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/git/worktree.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAsB,cAAc,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,kBAAkB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/G;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA+B7E;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAkBpH"}

package/dist/git/worktree.js

@@ -0,0 +1,78 @@
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { gitExec } from "./repo.js";
+export async function createWorktree(repoRoot, taskId, baseBranch, baseDir, branchNameOverride) {
+    const worktreePath = join(baseDir, taskId);
+    const branchName = branchNameOverride ?? `pi-loop/${taskId}`;
+    await mkdir(baseDir, { recursive: true });
+    // Check if worktree already exists at this path
+    const existing = await listWorktrees(repoRoot);
+    const found = existing.find((w) => w.path === worktreePath);
+    if (found) {
+        return worktreePath;
+    }
+    // Use -B to force-create the branch (it may already exist from a previous cycle)
+    await gitExec(["worktree", "add", "-B", branchName, worktreePath, baseBranch], repoRoot);
+    return worktreePath;
+}
+export async function removeWorktree(repoRoot, worktreePath, branchName) {
+    await gitExec(["worktree", "remove", "--force", worktreePath], repoRoot);
+    await gitExec(["worktree", "prune"], repoRoot);
+    // Clean up the branch so it doesn't collide on the next cycle
+    if (branchName) {
+        try {
+            await gitExec(["branch", "-D", branchName], repoRoot);
+        }
+        catch {
+            // Branch may already be deleted or merged — ignore
+        }
+    }
+}
+export async function listWorktrees(repoRoot) {
+    const output = await gitExec(["worktree", "list", "--porcelain"], repoRoot);
+    if (!output) {
+        return [];
+    }
+    const worktrees = [];
+    let current = {};
+    for (const line of output.split("\n")) {
+        if (line.startsWith("worktree ")) {
+            current.path = line.slice("worktree ".length);
+        }
+        else if (line.startsWith("HEAD ")) {
+            current.head = line.slice("HEAD ".length);
+        }
+        else if (line.startsWith("branch ")) {
+            // branch refs/heads/main -> main
+            current.branch = line.slice("branch refs/heads/".length);
+        }
+        else if (line === "" || line === "bare") {
+            if (current.path && current.head && current.branch) {
+                worktrees.push(current);
+            }
+            current = {};
+        }
+    }
+    // Handle last entry if output doesn't end with blank line
+    if (current.path && current.head && current.branch) {
+        worktrees.push(current);
+    }
+    return worktrees;
+}
+export async function mergeWorktree(repoRoot, taskBranch, targetBranch) {
+    await gitExec(["checkout", targetBranch], repoRoot);
+    try {
+        await gitExec(["merge", taskBranch], repoRoot);
+        return { success: true };
+    }
+    catch {
+        // Merge failed — detect conflict files from status
+        const status = await gitExec(["status", "--porcelain"], repoRoot);
+        const conflictFiles = status
+            .split("\n")
+            .filter((line) => line.startsWith("UU ") || line.startsWith("AA ") || line.startsWith("DU ") || line.startsWith("UD "))
+            .map((line) => line.slice(3));
+        return { success: false, conflictFiles };
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/git/worktree.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for pi-loop.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/index.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for pi-loop.
+ */
+import { parseArgs } from "./cli/args.js";
+import { cleanCommand, helpCommand, resumeCommand, runCommand, statusCommand, validateCommand, } from "./cli/commands.js";
+import { logError } from "./cli/output.js";
+async function main() {
+    const parsed = parseArgs(process.argv);
+    switch (parsed.command) {
+        case "run": {
+            if (!parsed.planPath) {
+                logError("Missing plan path. Usage: pi-loop run <plan.md>");
+                process.exitCode = 1;
+                return;
+            }
+            await runCommand(parsed.planPath, parsed.options);
+            break;
+        }
+        case "resume":
+            await resumeCommand(parsed.options);
+            break;
+        case "status":
+            await statusCommand();
+            break;
+        case "validate": {
+            if (!parsed.planPath) {
+                logError("Missing plan path. Usage: pi-loop validate <plan.md>");
+                process.exitCode = 1;
+                return;
+            }
+            await validateCommand(parsed.planPath, parsed.options);
+            break;
+        }
+        case "clean":
+            await cleanCommand();
+            break;
+        case "help":
+            helpCommand();
+            break;
+    }
+}
+main().catch((err) => {
+    logError(err instanceof Error ? err.message : String(err));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EACN,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,aAAa,EACb,eAAe,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,KAAK,UAAU,IAAI;IAClB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACxB,KAAK,KAAK,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACtB,QAAQ,CAAC,iDAAiD,CAAC,CAAC;gBAC5D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACR,CAAC;YACD,MAAM,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAClD,MAAM;QACP,CAAC;QACD,KAAK,QAAQ;YACZ,MAAM,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM;QACP,KAAK,QAAQ;YACZ,MAAM,aAAa,EAAE,CAAC;YACtB,MAAM;QACP,KAAK,UAAU,CAAC,CAAC,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACtB,QAAQ,CAAC,sDAAsD,CAAC,CAAC;gBACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACR,CAAC;YACD,MAAM,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACvD,MAAM;QACP,CAAC;QACD,KAAK,OAAO;YACX,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;QACP,KAAK,MAAM;YACV,WAAW,EAAE,CAAC;YACd,MAAM;IACR,CAAC;AACF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC7B,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACtB,CAAC,CAAC,CAAC"}

package/dist/integrations/linear/backend.d.ts

@@ -0,0 +1,38 @@
+import type { AgentRole } from "../../agents/types.js";
+import type { LinearConfig } from "../../config/types.js";
+import type { BackendCheckpointContext, BackendTask, ReadinessValidation, TaskBackend } from "../../core/task-backend.js";
+import { LinearClient } from "./client.js";
+export declare class LinearTaskBackend implements TaskBackend {
+    private readonly client;
+    private readonly config;
+    readonly mode: "linear";
+    private activeCycle;
+    private currentTaskId;
+    private lastSyncedAt;
+    private reconciliationSummary;
+    private readonly issueIdByIdentifier;
+    private readonly stateIdByName;
+    private readonly labelIdByName;
+    constructor(client: LinearClient, config: LinearConfig);
+    initializeCycle(cycle: number): Promise<void>;
+    getReadyTasks(_role: AgentRole): Promise<BackendTask[]>;
+    reconcileState(): Promise<string>;
+    validateDefinitionOfReady(task: BackendTask): Promise<ReadinessValidation>;
+    markInProgress(taskId: string): Promise<void>;
+    markInReview(taskId: string, worklog: string): Promise<void>;
+    markDone(taskId: string, verificationLog: string): Promise<void>;
+    markFailed(taskId: string, reason: string): Promise<void>;
+    markNeedsDecision(taskId: string, optionsComment: string): Promise<void>;
+    snapshotForJudge(): Promise<string>;
+    getCheckpointContext(): Promise<BackendCheckpointContext>;
+    applyCheckpointContext(context?: BackendCheckpointContext): Promise<void>;
+    private listIssues;
+    private transitionIssue;
+    private commentOnIssue;
+    private ensureLabel;
+    private resolveIssueId;
+    private resolveStateId;
+    private resolveLabelId;
+}
+export declare function createLinearTaskBackend(config: LinearConfig): TaskBackend;
+//# sourceMappingURL=backend.d.ts.map

package/dist/integrations/linear/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/integrations/linear/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EACX,wBAAwB,EACxB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAyK3C,qBAAa,iBAAkB,YAAW,WAAW;IAYnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZxB,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,qBAAqB,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;gBAGzC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY;IAGhC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgCvD,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IA4BjC,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQ1E,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxE,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAoBnC,oBAAoB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAQzD,sBAAsB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;YAMjE,UAAU;YAmCV,eAAe;YASf,cAAc;YAQd,WAAW;YAoBX,cAAc;YAgBd,cAAc;YAed,cAAc;CAY5B;AAaD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAGzE"}