@yoavsh/treekeeper 0.0.0-stage → 0.1.0

package/dist/core/sessions.js

@@ -0,0 +1,300 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { run } from "../util/exec.js";
+import { expandPath, isInside } from "../util/paths.js";
+import { parseDuration } from "../util/time.js";
+/** Directories whose contents say nothing about whether an agent is working. */
+const MTIME_SKIP = new Set([
+    "node_modules", ".git", "dist", "build", "target", ".next", ".nuxt", ".venv",
+    "venv", "__pycache__", ".cache", "coverage", ".turbo", ".pytest_cache",
+    ".gradle", ".mypy_cache", ".ruff_cache", "vendor", ".terraform",
+]);
+const MTIME_MAX_ENTRIES = 4_000;
+const MTIME_MAX_DEPTH = 3;
+export async function createActivityContext(cfg, logger, now = Date.now()) {
+    const detectors = new Set(cfg.sessions.detectors);
+    const ctx = {
+        now,
+        graceMs: parseDuration(cfg.sessions.grace),
+        detectors,
+        extraPaths: cfg.sessions.extraPaths,
+        commands: cfg.sessions.commands,
+        logger,
+        processCwds: null,
+    };
+    if (detectors.has("process")) {
+        ctx.processCwds = await loadProcessCwds(logger);
+    }
+    return ctx;
+}
+/**
+ * Is an agent (or a human) still working in this worktree?
+ *
+ * Detectors are deliberately layered: the harness-specific ones give a precise
+ * answer with a timestamp, while `process` and `mtime` are the catch-all that
+ * makes this work with harnesses treekeeper has never heard of.
+ */
+export async function detectActivity(ctx, worktreePath) {
+    const cutoff = ctx.now - ctx.graceMs;
+    const hits = [];
+    if (ctx.detectors.has("process") && ctx.processCwds) {
+        const match = ctx.processCwds.find((p) => isInside(worktreePath, p));
+        if (match) {
+            hits.push({
+                detector: "process",
+                lastActivity: ctx.now,
+                detail: "a running process is sitting in this directory",
+            });
+        }
+    }
+    if (ctx.detectors.has("claude-code")) {
+        const hit = await claudeCodeActivity(worktreePath, cutoff);
+        if (hit)
+            hits.push(hit);
+    }
+    if (ctx.detectors.has("codex")) {
+        const hit = await codexActivity(worktreePath, cutoff, ctx);
+        if (hit)
+            hits.push(hit);
+    }
+    if (ctx.detectors.has("aider")) {
+        const hit = await newestFileIn(worktreePath, [".aider.chat.history.md", ".aider.input.history"], "aider", cutoff);
+        if (hit)
+            hits.push(hit);
+    }
+    if (ctx.extraPaths.length > 0) {
+        const paths = ctx.extraPaths.map((p) => expandPath(p.replaceAll("{worktree}", worktreePath)));
+        const hit = await newestPath(paths, "extra-path", cutoff);
+        if (hit)
+            hits.push(hit);
+    }
+    if (ctx.detectors.has("mtime")) {
+        const hit = await mtimeActivity(worktreePath, cutoff);
+        if (hit)
+            hits.push(hit);
+    }
+    for (const cmd of ctx.commands) {
+        const r = await run("sh", ["-c", cmd.command], {
+            timeoutMs: 15_000,
+            env: { ...process.env, TREEKEEPER_WORKTREE: worktreePath },
+            cwd: undefined,
+        });
+        if (r.code === 0) {
+            hits.push({
+                detector: cmd.name,
+                lastActivity: ctx.now,
+                detail: `custom check "${cmd.name}" reported activity`,
+            });
+        }
+    }
+    if (hits.length === 0)
+        return null;
+    hits.sort((a, b) => b.lastActivity - a.lastActivity);
+    return hits[0];
+}
+/** `true` when the hit falls inside the session grace window. */
+export function isActive(ctx, hit) {
+    if (!hit)
+        return false;
+    return hit.lastActivity >= ctx.now - ctx.graceMs;
+}
+// --- harness-specific detectors --------------------------------------------
+/**
+ * Claude Code stores one JSONL transcript per session under
+ * `~/.claude/projects/<slugified-cwd>/`, so the newest transcript mtime is the
+ * last time an agent did anything in that worktree.
+ */
+export function claudeProjectSlugs(worktreePath) {
+    const all = worktreePath.replace(/[^a-zA-Z0-9]/g, "-");
+    const slashesOnly = worktreePath.replace(/\//g, "-");
+    return all === slashesOnly ? [all] : [all, slashesOnly];
+}
+async function claudeCodeActivity(worktreePath, cutoff) {
+    const base = process.env.CLAUDE_CONFIG_DIR
+        ? expandPath(process.env.CLAUDE_CONFIG_DIR)
+        : join(homedir(), ".claude");
+    for (const slug of claudeProjectSlugs(worktreePath)) {
+        const dir = join(base, "projects", slug);
+        const hit = await newestInDir(dir, ".jsonl", "claude-code", cutoff);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+/**
+ * Codex CLI writes rollout transcripts under `~/.codex/sessions/<y>/<m>/<d>/`.
+ * Only recently-modified files are opened, and only their head is read, so the
+ * cwd match stays cheap even with thousands of archived sessions.
+ */
+async function codexActivity(worktreePath, cutoff, ctx) {
+    const root = join(homedir(), ".codex", "sessions");
+    const recent = [];
+    const walk = async (dir, depth) => {
+        if (depth > 4 || recent.length >= 40)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const p = join(dir, e.name);
+            if (e.isDirectory()) {
+                await walk(p, depth + 1);
+            }
+            else if (e.isFile() && e.name.endsWith(".jsonl")) {
+                try {
+                    const st = await stat(p);
+                    if (st.mtimeMs >= cutoff)
+                        recent.push({ path: p, mtime: st.mtimeMs });
+                }
+                catch {
+                    /* vanished mid-walk */
+                }
+            }
+        }
+    };
+    await walk(root, 0);
+    recent.sort((a, b) => b.mtime - a.mtime);
+    for (const file of recent) {
+        try {
+            const handle = await readFile(file.path, "utf8");
+            const head = handle.slice(0, 8_000);
+            if (head.includes(`"cwd":"${worktreePath}"`) || head.includes(`"cwd": "${worktreePath}"`)) {
+                return {
+                    detector: "codex",
+                    lastActivity: file.mtime,
+                    detail: "a Codex session transcript was updated",
+                };
+            }
+        }
+        catch (err) {
+            ctx.logger?.debug(`codex detector: ${err.message}`);
+        }
+    }
+    return null;
+}
+// --- generic detectors ------------------------------------------------------
+/**
+ * Last-resort signal that covers every harness: did anything inside the
+ * worktree change recently? Bounded in depth and entry count so a sweep over
+ * dozens of worktrees stays fast.
+ */
+async function mtimeActivity(worktreePath, cutoff) {
+    let visited = 0;
+    let newest = 0;
+    let newestPathSeen = "";
+    const walk = async (dir, depth) => {
+        if (visited >= MTIME_MAX_ENTRIES)
+            return false;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return false;
+        }
+        for (const e of entries) {
+            if (visited >= MTIME_MAX_ENTRIES)
+                return false;
+            visited += 1;
+            if (MTIME_SKIP.has(e.name))
+                continue;
+            const p = join(dir, e.name);
+            if (e.isDirectory()) {
+                if (depth < MTIME_MAX_DEPTH && (await walk(p, depth + 1)))
+                    return true;
+                continue;
+            }
+            if (!e.isFile())
+                continue;
+            try {
+                const st = await stat(p);
+                if (st.mtimeMs > newest) {
+                    newest = st.mtimeMs;
+                    newestPathSeen = e.name;
+                }
+                if (st.mtimeMs >= cutoff)
+                    return true; // early exit: already "active"
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        return false;
+    };
+    const active = await walk(worktreePath, 0);
+    if (!active && newest < cutoff)
+        return null;
+    return {
+        detector: "mtime",
+        lastActivity: newest,
+        detail: `files changed recently (${newestPathSeen})`,
+    };
+}
+async function loadProcessCwds(logger) {
+    if (process.platform === "win32")
+        return null;
+    const r = await run("lsof", ["-d", "cwd", "-Fn"], { timeoutMs: 30_000 });
+    if (r.code !== 0 && r.stdout.trim() === "") {
+        logger?.debug("process detector: lsof unavailable, skipping");
+        return null;
+    }
+    const out = new Set();
+    for (const line of r.stdout.split("\n")) {
+        if (line.startsWith("n/"))
+            out.add(line.slice(1));
+    }
+    return [...out];
+}
+async function newestInDir(dir, suffix, detector, cutoff) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return null;
+    }
+    let newest = 0;
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.endsWith(suffix))
+            continue;
+        try {
+            const st = await stat(join(dir, e.name));
+            if (st.mtimeMs > newest)
+                newest = st.mtimeMs;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    if (newest === 0 || newest < cutoff)
+        return null;
+    return { detector, lastActivity: newest, detail: "a session transcript was updated" };
+}
+async function newestFileIn(base, names, detector, cutoff) {
+    return newestPath(names.map((n) => join(base, n)), detector, cutoff);
+}
+async function newestPath(paths, detector, cutoff) {
+    let newest = 0;
+    let which = "";
+    for (const p of paths) {
+        try {
+            const st = await stat(p);
+            if (st.mtimeMs > newest) {
+                newest = st.mtimeMs;
+                which = p;
+            }
+        }
+        catch {
+            /* missing is fine */
+        }
+    }
+    if (newest === 0 || newest < cutoff)
+        return null;
+    return { detector, lastActivity: newest, detail: `${which} was updated` };
+}
+//# sourceMappingURL=sessions.js.map

package/dist/core/sessions.js.map

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

package/dist/core/size.d.ts

@@ -0,0 +1,3 @@
+/** Disk usage in KB. Uses `du` (fast, counts real blocks); null when unavailable. */
+export declare function dirSizeKb(path: string): Promise<number | null>;
+//# sourceMappingURL=size.d.ts.map

package/dist/core/size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../src/core/size.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMpE"}

package/dist/core/size.js

@@ -0,0 +1,11 @@
+import { run } from "../util/exec.js";
+/** Disk usage in KB. Uses `du` (fast, counts real blocks); null when unavailable. */
+export async function dirSizeKb(path) {
+    const r = await run("du", ["-sk", path], { timeoutMs: 120_000 });
+    if (r.code !== 0 && r.stdout.trim() === "")
+        return null;
+    const first = r.stdout.trim().split("\n")[0] ?? "";
+    const kb = Number(first.split(/\s+/)[0]);
+    return Number.isFinite(kb) ? kb : null;
+}
+//# sourceMappingURL=size.js.map

package/dist/core/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../src/core/size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACxD,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC"}

package/dist/daemon/lock.d.ts

@@ -0,0 +1,10 @@
+export interface Lock {
+    release(): Promise<void>;
+}
+/**
+ * Take the machine-wide sweep lock, so a scheduled sweep and a manual
+ * `treekeeper gc --apply` can never remove the same worktree twice.
+ * Returns null when another sweep holds it.
+ */
+export declare function acquireLock(): Promise<Lock | null>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/daemon/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/daemon/lock.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,IAAI;IACnB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAeD;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAoCxD"}

package/dist/daemon/lock.js

@@ -0,0 +1,64 @@
+import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { treekeeperHome } from "../util/paths.js";
+const LOCK = "sweep.lock";
+function lockPath() {
+    return join(treekeeperHome(), LOCK);
+}
+function alive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === "EPERM";
+    }
+}
+/**
+ * Take the machine-wide sweep lock, so a scheduled sweep and a manual
+ * `treekeeper gc --apply` can never remove the same worktree twice.
+ * Returns null when another sweep holds it.
+ */
+export async function acquireLock() {
+    const path = lockPath();
+    await mkdir(treekeeperHome(), { recursive: true });
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        try {
+            await writeFile(path, JSON.stringify({ pid: process.pid, at: Date.now() }), { flag: "wx" });
+            return {
+                release: async () => {
+                    try {
+                        await unlink(path);
+                    }
+                    catch {
+                        /* already gone */
+                    }
+                },
+            };
+        }
+        catch (err) {
+            if (err.code !== "EEXIST")
+                throw err;
+            // Stale lock from a killed process? Clear it once and retry.
+            let holder = null;
+            try {
+                const parsed = JSON.parse(await readFile(path, "utf8"));
+                const pid = parsed.pid;
+                holder = typeof pid === "number" ? pid : null;
+            }
+            catch {
+                holder = null;
+            }
+            if (holder !== null && alive(holder))
+                return null;
+            try {
+                await unlink(path);
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=lock.js.map

package/dist/daemon/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/daemon/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,IAAI,GAAG,YAAY,CAAC;AAM1B,SAAS,QAAQ;IACf,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,KAAK,CAAC,GAAW;IACxB,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5F,OAAO;gBACL,OAAO,EAAE,KAAK,IAAI,EAAE;oBAClB,IAAI,CAAC;wBACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;oBACrB,CAAC;oBAAC,MAAM,CAAC;wBACP,kBAAkB;oBACpB,CAAC;gBACH,CAAC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;YAChE,6DAA6D;YAC7D,IAAI,MAAM,GAAkB,IAAI,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;gBACjE,MAAM,GAAG,GAAI,MAA4B,CAAC,GAAG,CAAC;gBAC9C,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;YACD,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;YAClD,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/daemon/service.d.ts

@@ -0,0 +1,34 @@
+import type { SweepRecord } from "./state.js";
+export declare const LABEL = "com.treekeeper.agent";
+export declare const SYSTEMD_UNIT = "treekeeper";
+export type Manager = "launchd" | "systemd" | "unsupported";
+export interface DaemonStatus {
+    manager: Manager;
+    installed: boolean;
+    /** Loaded with the service manager and scheduled to run. */
+    active: boolean;
+    unitPath: string | null;
+    intervalSeconds: number | null;
+    lastSweep: SweepRecord | null;
+    logFile: string;
+}
+export declare function currentManager(): Manager;
+/** Absolute path to this installation's CLI entry point. */
+export declare function cliPath(): string;
+/** The command a scheduled sweep runs. */
+export declare function sweepArgv(extra?: string[]): string[];
+export declare function daemonStatus(): Promise<DaemonStatus>;
+export interface InstallResult {
+    ok: boolean;
+    manager: Manager;
+    unitPath: string | null;
+    messages: string[];
+}
+/** Write and load the service definition for the current platform. */
+export declare function installDaemon(interval: string): Promise<InstallResult>;
+export declare function uninstallDaemon(): Promise<InstallResult>;
+export declare function setDaemonRunning(running: boolean): Promise<InstallResult>;
+export declare function launchdPlist(seconds: number): string;
+export declare function systemdService(): string;
+export declare function systemdTimer(seconds: number): string;
+//# sourceMappingURL=service.d.ts.map

package/dist/daemon/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/daemon/service.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,eAAO,MAAM,KAAK,yBAAyB,CAAC;AAC5C,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,IAAI,OAAO,CAIxC;AAiBD,4DAA4D;AAC5D,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAExD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CA4C1D;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,sEAAsE;AACtE,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA6D5E;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,aAAa,CAAC,CAyB9D;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAuB/E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqCpD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAavC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAapD"}