@made-by-moonlight/athene-cli 0.9.2

package/dist/lib/running-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"running-state.d.ts","sourceRoot":"","sources":["../../src/lib/running-state.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAUD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,uEAAuE;IACvE,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACpE;AAiJD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAOjE;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAOhD;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/E;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1E;AAED;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA4B/D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAErE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,SAAQ,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAE/E;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAOjF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAUvE;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAYlE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAOnD"}

package/dist/lib/running-state.js

@@ -0,0 +1,338 @@
+import { readFileSync, writeFileSync, mkdirSync, unlinkSync, openSync, closeSync, constants, statSync, } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { setTimeout as sleep } from "node:timers/promises";
+import { atomicWriteFileSync, recordActivityEvent } from "@made-by-moonlight/athene-core";
+const STATE_DIR = join(homedir(), ".agent-orchestrator");
+const STATE_FILE = join(STATE_DIR, "running.json");
+const STATE_LOCK_FILE = join(STATE_DIR, "running.lock");
+const STARTUP_LOCK_FILE = join(STATE_DIR, "startup.lock");
+const LAST_STOP_LOCK_FILE = join(STATE_DIR, "last-stop.lock");
+const LAST_STOP_FILE = join(STATE_DIR, "last-stop.json");
+const UNPARSEABLE_LOCK_GRACE_MS = 5_000;
+function ensureDir() {
+    mkdirSync(STATE_DIR, { recursive: true });
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "EPERM") {
+            return true;
+        }
+        return false;
+    }
+}
+function readLockMetadata(lockFile) {
+    try {
+        const raw = readFileSync(lockFile, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.pid !== "number")
+            return null;
+        return {
+            pid: parsed.pid,
+            acquiredAt: typeof parsed.acquiredAt === "string" ? parsed.acquiredAt : new Date(0).toISOString(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function isStaleUnparseableLock(lockFile) {
+    try {
+        const mtimeMs = statSync(lockFile).mtimeMs;
+        return Date.now() - mtimeMs > UNPARSEABLE_LOCK_GRACE_MS;
+    }
+    catch {
+        return false;
+    }
+}
+/** Try to create the lockfile atomically. Returns a release function on success, null on failure. */
+function tryAcquire(lockFile) {
+    try {
+        const fd = openSync(lockFile, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY);
+        const metadata = {
+            pid: process.pid,
+            acquiredAt: new Date().toISOString(),
+        };
+        try {
+            writeFileSync(fd, JSON.stringify(metadata), "utf-8");
+        }
+        catch {
+            try {
+                unlinkSync(lockFile);
+            }
+            catch { /* best effort */ }
+            return null;
+        }
+        finally {
+            try {
+                closeSync(fd);
+            }
+            catch { /* best effort */ }
+        }
+        return () => {
+            try {
+                unlinkSync(lockFile);
+            }
+            catch { /* best effort */ }
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Advisory lockfile using O_EXCL for atomic creation.
+ * Retries with jittered backoff. Dead owners are treated as stale and cleaned
+ * up automatically. Live owners are never stolen; callers get a clear timeout.
+ */
+async function acquireLock(lockFile, timeoutMs = 5000, resourceName = "lock") {
+    ensureDir();
+    const start = Date.now();
+    let attempt = 0;
+    while (true) {
+        const release = tryAcquire(lockFile);
+        if (release)
+            return release;
+        const owner = readLockMetadata(lockFile);
+        if ((!owner && isStaleUnparseableLock(lockFile))
+            || (owner && !isProcessAlive(owner.pid))) {
+            try {
+                unlinkSync(lockFile);
+            }
+            catch { /* ignore */ }
+            const retryRelease = tryAcquire(lockFile);
+            if (retryRelease)
+                return retryRelease;
+        }
+        if (Date.now() - start > timeoutMs) {
+            recordActivityEvent({
+                source: "cli",
+                kind: "cli.lock_timeout",
+                level: "warn",
+                summary: `lock acquisition timed out`,
+                data: {
+                    resourceName,
+                    lockFile,
+                    timeoutMs,
+                    attempts: attempt,
+                },
+            });
+            throw new Error(`Could not acquire ${resourceName} (${lockFile})`);
+        }
+        // Jittered backoff: 30-70ms base, growing with attempts (capped at 200ms)
+        const baseMs = Math.min(50 + attempt * 20, 200);
+        const jitter = Math.floor(Math.random() * 40) - 20;
+        await sleep(baseMs + jitter);
+        attempt++;
+    }
+}
+function readState() {
+    try {
+        const raw = readFileSync(STATE_FILE, "utf-8");
+        const state = JSON.parse(raw);
+        if (!state || typeof state.pid !== "number")
+            return null;
+        return state;
+    }
+    catch {
+        return null;
+    }
+}
+function writeState(state) {
+    ensureDir();
+    if (state === null) {
+        try {
+            unlinkSync(STATE_FILE);
+        }
+        catch { /* file may not exist */ }
+    }
+    else {
+        // Atomic temp+rename so a crash mid-write cannot leave torn JSON
+        // that makes `getRunning()` silently return `null` and orphan a
+        // still-alive AO process from later CLI commands.
+        atomicWriteFileSync(STATE_FILE, JSON.stringify(state, null, 2));
+    }
+}
+/**
+ * Register the current AO instance as running.
+ * Uses a lockfile to prevent concurrent registration.
+ */
+export async function register(entry) {
+    const release = await acquireLock(STATE_LOCK_FILE, 5000, "running.json lock");
+    try {
+        writeState(entry);
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Unregister the running AO instance.
+ */
+export async function unregister() {
+    const release = await acquireLock(STATE_LOCK_FILE, 5000, "running.json lock");
+    try {
+        writeState(null);
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Remove a single project from the running state's project list.
+ * Used by `athene stop <project>` so that `athene start <project>` can restart
+ * the orchestrator without hitting the "already running" gate.
+ * No-op if the state is missing or the project isn't listed.
+ */
+export async function removeProjectFromRunning(projectId) {
+    const release = await acquireLock(STATE_LOCK_FILE, 5000, "running.json lock");
+    try {
+        const state = readState();
+        if (!state)
+            return;
+        const updated = state.projects.filter((p) => p !== projectId);
+        if (updated.length === state.projects.length)
+            return;
+        writeState({ ...state, projects: updated });
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Add a project to the running state's project list (idempotent).
+ * Used when a project's orchestrator is spawned against an already-running
+ * daemon — for example after `athene start <project>` attaches to an existing
+ * parent process whose `projects` list didn't yet include the project.
+ * Without this, subsequent `athene stop` (no args) would leave the new
+ * orchestrator orphaned because it isn't in `running.projects`.
+ * No-op if the state is missing or the project is already listed.
+ */
+export async function addProjectToRunning(projectId) {
+    const release = await acquireLock(STATE_LOCK_FILE, 5000, "running.json lock");
+    try {
+        const state = readState();
+        if (!state)
+            return;
+        if (state.projects.includes(projectId))
+            return;
+        writeState({ ...state, projects: [...state.projects, projectId] });
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Get the currently running AO instance, if any.
+ * Auto-prunes stale entries (dead PIDs).
+ */
+export async function getRunning() {
+    const release = await acquireLock(STATE_LOCK_FILE, 5000, "running.json lock");
+    try {
+        const state = readState();
+        if (!state)
+            return null;
+        if (!isProcessAlive(state.pid)) {
+            // Stale entry — process is dead, clean up
+            writeState(null);
+            recordActivityEvent({
+                source: "cli",
+                kind: "cli.stale_running_pruned",
+                level: "warn",
+                summary: `pruned stale running.json entry (dead pid ${state.pid})`,
+                data: {
+                    pid: state.pid,
+                    port: state.port,
+                    startedAt: state.startedAt,
+                    projects: state.projects,
+                },
+            });
+            return null;
+        }
+        return state;
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Check if AO is already running.
+ * Returns the running state if alive, null otherwise.
+ */
+export async function isAlreadyRunning() {
+    return getRunning();
+}
+/**
+ * Serialize `athene start` so concurrent startups cannot both observe an empty
+ * running.json and create competing orchestrator/dashboard processes.
+ */
+export async function acquireStartupLock(timeoutMs = 30000) {
+    return await acquireLock(STARTUP_LOCK_FILE, timeoutMs, "startup lock");
+}
+/**
+ * Wait for a process to exit, polling isProcessAlive.
+ * Returns true if the process exited, false if timeout reached.
+ */
+export async function waitForExit(pid, timeoutMs = 5000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        if (!isProcessAlive(pid))
+            return true;
+        await sleep(100);
+    }
+    return !isProcessAlive(pid);
+}
+/**
+ * Record which sessions were active when `athene stop` ran.
+ */
+export async function writeLastStop(state) {
+    const release = await acquireLock(LAST_STOP_LOCK_FILE, 5000, "last-stop.json lock");
+    try {
+        // Atomic temp+rename so a crash mid-write cannot leave torn JSON
+        // that makes `readLastStop()` silently return `null` and lose the
+        // restore prompt for sessions the user just stopped.
+        atomicWriteFileSync(LAST_STOP_FILE, JSON.stringify(state, null, 2));
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Read the last-stop state, if any.
+ */
+export async function readLastStop() {
+    const release = await acquireLock(LAST_STOP_LOCK_FILE, 5000, "last-stop.json lock");
+    try {
+        const raw = readFileSync(LAST_STOP_FILE, "utf-8");
+        const state = JSON.parse(raw);
+        if (!state || typeof state.stoppedAt !== "string" || !state.projectId || !Array.isArray(state.sessionIds))
+            return null;
+        return state;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Remove the last-stop state file (after restore or skip).
+ */
+export async function clearLastStop() {
+    const release = await acquireLock(LAST_STOP_LOCK_FILE, 5000, "last-stop.json lock");
+    try {
+        try {
+            unlinkSync(LAST_STOP_FILE);
+        }
+        catch { /* file may not exist */ }
+    }
+    finally {
+        release();
+    }
+}
+//# sourceMappingURL=running-state.js.map

package/dist/lib/running-state.js.map

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

package/dist/lib/script-runner.d.ts

@@ -0,0 +1,10 @@
+export type ScriptLayout = "source-checkout" | "package-install";
+export declare function resolveScriptLayoutFromPath(modulePath: string): ScriptLayout;
+export declare function resolveDefaultRepoRootFromPath(modulePath: string): string;
+export declare function resolveRepoRoot(): string;
+export declare function resolveScriptLayout(): ScriptLayout;
+export declare function resolveScriptPath(scriptName: string): string;
+export declare function hasRepoScript(scriptName: string): boolean;
+export declare function runRepoScript(scriptName: string, args: string[]): Promise<number>;
+export declare function executeScriptCommand(scriptName: string, args: string[]): Promise<void>;
+//# sourceMappingURL=script-runner.d.ts.map

package/dist/lib/script-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-runner.d.ts","sourceRoot":"","sources":["../../src/lib/script-runner.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEjE,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAU5E;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAMzE;AAWD,wBAAgB,eAAe,IAAI,MAAM,CAgBxC;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CASlD;AAMD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAkDD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDvF;AA4BD,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAU5F"}

package/dist/lib/script-runner.js

@@ -0,0 +1,189 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { isWindows } from "@made-by-moonlight/athene-core";
+import { classifyInstallPath, hasNodeModulesAncestor, isAgentOrchestratorRepoRoot, isAoCliPackageRoot, } from "./update-check.js";
+const CURRENT_MODULE_PATH = fileURLToPath(import.meta.url);
+const CURRENT_MODULE_DIR = dirname(CURRENT_MODULE_PATH);
+const CLI_DIST_ROOT = resolve(CURRENT_MODULE_DIR, "..");
+export function resolveScriptLayoutFromPath(modulePath) {
+    const installMethod = classifyInstallPath(modulePath);
+    if (installMethod === "git") {
+        return "source-checkout";
+    }
+    if (installMethod === "npm-global" || installMethod === "pnpm-global") {
+        return "package-install";
+    }
+    return hasNodeModulesAncestor(modulePath) ? "package-install" : "source-checkout";
+}
+export function resolveDefaultRepoRootFromPath(modulePath) {
+    const moduleDir = dirname(modulePath);
+    const layout = resolveScriptLayoutFromPath(modulePath);
+    return layout === "package-install"
+        ? resolve(moduleDir, "../..")
+        : resolve(moduleDir, "../../../../");
+}
+const DEFAULT_REPO_ROOT = resolveDefaultRepoRootFromPath(CURRENT_MODULE_PATH);
+const DEFAULT_SCRIPT_LAYOUT = resolveScriptLayoutFromPath(CURRENT_MODULE_PATH);
+function isValidRepoRootForLayout(root, layout) {
+    return layout === "source-checkout"
+        ? isAgentOrchestratorRepoRoot(root)
+        : isAoCliPackageRoot(root);
+}
+export function resolveRepoRoot() {
+    const override = process.env["AO_REPO_ROOT"];
+    if (!override) {
+        return DEFAULT_REPO_ROOT;
+    }
+    const resolved = resolve(override);
+    if (!isValidRepoRootForLayout(resolved, DEFAULT_SCRIPT_LAYOUT)) {
+        const expected = DEFAULT_SCRIPT_LAYOUT === "source-checkout"
+            ? "an agent-orchestrator checkout"
+            : "an installed @made-by-moonlight/athene-cli package";
+        throw new Error(`AO_REPO_ROOT=${override} does not look like ${expected}`);
+    }
+    return resolved;
+}
+export function resolveScriptLayout() {
+    const override = process.env["AO_SCRIPT_LAYOUT"];
+    if (process.env["AO_DEV"] === "1" &&
+        (override === "package-install" || override === "source-checkout")) {
+        return override;
+    }
+    return DEFAULT_SCRIPT_LAYOUT;
+}
+function getScriptPath(scriptName) {
+    return resolve(CLI_DIST_ROOT, "assets", "scripts", scriptName);
+}
+export function resolveScriptPath(scriptName) {
+    const scriptPath = getScriptPath(scriptName);
+    if (!existsSync(scriptPath)) {
+        throw new Error(`Script not found: ${scriptName}. Expected at: ${scriptPath} (scripts directory: ${resolve(CLI_DIST_ROOT, "assets", "scripts")})`);
+    }
+    return scriptPath;
+}
+// Common Git Bash install locations on Windows. WSL's bash.exe is intentionally
+// excluded: when invoked from Windows-native Node, the spawned WSL bash sees
+// Linux paths (/mnt/c/...) while cwd is a Windows path (D:\...), which silently
+// breaks repo scripts. Users on WSL run `ao` as a Linux process anyway, where
+// process.platform === "linux" and this branch never executes.
+const WINDOWS_BASH_CANDIDATES = [
+    "C:\\Program Files\\Git\\bin\\bash.exe",
+    "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
+    "C:\\Program Files\\Git\\usr\\bin\\bash.exe",
+];
+// Walk PATH searching for bash.exe. Lets us discover Git Bash installs on
+// non-default drives (e.g. D:\Program Files\Git) that the hardcoded list above
+// would miss. Returns the first match or null. PATH-walking is sync but
+// microseconds — no subprocess.
+function findBashOnPath() {
+    const dirs = (process.env["PATH"] ?? "").split(";").filter(Boolean);
+    for (const dir of dirs) {
+        const candidate = resolve(dir, "bash.exe");
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+function detectWindowsBash() {
+    for (const candidate of WINDOWS_BASH_CANDIDATES) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return findBashOnPath();
+}
+// Windows: prefer PowerShell 7 (pwsh.exe), fall back to bundled Windows
+// PowerShell 5.1 (powershell.exe). Both can run our .ps1 scripts.
+function detectWindowsPowerShell() {
+    const candidates = ["pwsh.exe", "powershell.exe"];
+    const dirs = (process.env["PATH"] ?? "").split(";").filter(Boolean);
+    for (const exe of candidates) {
+        for (const dir of dirs) {
+            const candidate = resolve(dir, exe);
+            if (existsSync(candidate))
+                return candidate;
+        }
+    }
+    // Fallback: powershell.exe ships in System32 on every supported Windows.
+    const sysRoot = process.env["SystemRoot"] ?? "C:\\Windows";
+    const fallback = resolve(sysRoot, "System32\\WindowsPowerShell\\v1.0\\powershell.exe");
+    return existsSync(fallback) ? fallback : null;
+}
+export function hasRepoScript(scriptName) {
+    return existsSync(getScriptPath(scriptName));
+}
+export async function runRepoScript(scriptName, args) {
+    const repoRoot = resolveRepoRoot();
+    const scriptLayout = resolveScriptLayout();
+    // Windows: prefer the .ps1 sibling of the requested .sh script and run via
+    // PowerShell. .sh scripts can still be run if the user has installed Git Bash
+    // and we ship no .ps1 equivalent. Booth/WSL bash isn't supported (see comment
+    // on WINDOWS_BASH_CANDIDATES).
+    if (isWindows()) {
+        const ps1Name = scriptName.replace(/\.sh$/i, ".ps1");
+        if (ps1Name !== scriptName && hasRepoScript(ps1Name)) {
+            const ps = detectWindowsPowerShell();
+            if (!ps) {
+                throw new Error("Cannot run PowerShell scripts on Windows. " +
+                    "Install PowerShell 7 (https://aka.ms/powershell) or ensure powershell.exe is in PATH.");
+            }
+            const scriptPath = resolveScriptPath(ps1Name);
+            // -File runs the script with positional args; -ExecutionPolicy Bypass
+            // avoids machine policy blocking unsigned bundled scripts.
+            return await spawnAndWait(ps, ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", scriptPath, ...args], repoRoot, scriptLayout);
+        }
+    }
+    let shellOverride = process.env["AO_BASH_PATH"];
+    // Unix: always use bash — repo scripts have #!/bin/bash shebangs and bash-specific syntax.
+    // Shebangs are only honoured by the kernel when a file is executed directly; when passed as
+    // an argument to another interpreter (e.g. zsh script.sh) the shebang is ignored, so we must
+    // name bash explicitly rather than using the user's $SHELL.
+    // Windows: no native shell (pwsh, powershell.exe, cmd.exe) can run bash scripts —
+    // shebangs are ignored and bash-specific syntax fails. Auto-detect Git Bash / WSL,
+    // fall back to AO_BASH_PATH, throw with guidance if neither is found.
+    if (!shellOverride && isWindows()) {
+        const detected = detectWindowsBash();
+        if (!detected) {
+            throw new Error("Cannot run repo scripts on Windows without bash. " +
+                "Install Git for Windows (https://git-scm.com/download/win) or " +
+                "set AO_BASH_PATH to a bash executable " +
+                "(e.g. C:\\Program Files\\Git\\bin\\bash.exe).");
+        }
+        shellOverride = detected;
+    }
+    const shell = shellOverride ?? "bash";
+    const scriptPath = resolveScriptPath(scriptName);
+    return await spawnAndWait(shell, [scriptPath, ...args], repoRoot, scriptLayout);
+}
+function spawnAndWait(shell, shellArgs, repoRoot, scriptLayout) {
+    return new Promise((resolveExit, reject) => {
+        const child = spawn(shell, shellArgs, {
+            cwd: repoRoot,
+            env: { ...process.env, AO_REPO_ROOT: repoRoot, AO_SCRIPT_LAYOUT: scriptLayout },
+            stdio: "inherit",
+            windowsHide: true,
+        });
+        child.on("error", reject);
+        child.on("exit", (code, signal) => {
+            if (signal) {
+                resolveExit(1);
+                return;
+            }
+            resolveExit(code ?? 1);
+        });
+    });
+}
+export async function executeScriptCommand(scriptName, args) {
+    try {
+        const exitCode = await runRepoScript(scriptName, args);
+        if (exitCode !== 0) {
+            process.exit(exitCode);
+        }
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=script-runner.js.map

package/dist/lib/script-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-runner.js","sourceRoot":"","sources":["../../src/lib/script-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3D,MAAM,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AACxD,MAAM,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;AAIxD,MAAM,UAAU,2BAA2B,CAAC,UAAkB;IAC5D,MAAM,aAAa,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACtD,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,IAAI,aAAa,KAAK,YAAY,IAAI,aAAa,KAAK,aAAa,EAAE,CAAC;QACtE,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,UAAkB;IAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,2BAA2B,CAAC,UAAU,CAAC,CAAC;IACvD,OAAO,MAAM,KAAK,iBAAiB;QACjC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;QAC7B,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,iBAAiB,GAAG,8BAA8B,CAAC,mBAAmB,CAAC,CAAC;AAC9E,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,mBAAmB,CAAC,CAAC;AAE/E,SAAS,wBAAwB,CAAC,IAAY,EAAE,MAAoB;IAClE,OAAO,MAAM,KAAK,iBAAiB;QACjC,CAAC,CAAC,2BAA2B,CAAC,IAAI,CAAC;QACnC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,EAAE,CAAC;QAC/D,MAAM,QAAQ,GACZ,qBAAqB,KAAK,iBAAiB;YACzC,CAAC,CAAC,gCAAgC;YAClC,CAAC,CAAC,oDAAoD,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,gBAAgB,QAAQ,uBAAuB,QAAQ,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACjD,IACE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,GAAG;QAC7B,CAAC,QAAQ,KAAK,iBAAiB,IAAI,QAAQ,KAAK,iBAAiB,CAAC,EAClE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,SAAS,aAAa,CAAC,UAAkB;IACvC,OAAO,OAAO,CAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,qBAAqB,UAAU,kBAAkB,UAAU,wBAAwB,OAAO,CAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC,GAAG,CAClI,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,8EAA8E;AAC9E,+DAA+D;AAC/D,MAAM,uBAAuB,GAAG;IAC9B,uCAAuC;IACvC,6CAA6C;IAC7C,4CAA4C;CAC7C,CAAC;AAEF,0EAA0E;AAC1E,+EAA+E;AAC/E,wEAAwE;AACxE,gCAAgC;AAChC,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC3C,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB;IACxB,KAAK,MAAM,SAAS,IAAI,uBAAuB,EAAE,CAAC;QAChD,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAC9C,CAAC;IACD,OAAO,cAAc,EAAE,CAAC;AAC1B,CAAC;AAED,wEAAwE;AACxE,kEAAkE;AAClE,SAAS,uBAAuB;IAC9B,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACpC,IAAI,UAAU,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,yEAAyE;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,aAAa,CAAC;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,mDAAmD,CAAC,CAAC;IACvF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB,EAAE,IAAc;IACpE,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAC;IAE3C,2EAA2E;IAC3E,8EAA8E;IAC9E,8EAA8E;IAC9E,+BAA+B;IAC/B,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,OAAO,KAAK,UAAU,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,MAAM,EAAE,GAAG,uBAAuB,EAAE,CAAC;YACrC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,MAAM,IAAI,KAAK,CACb,4CAA4C;oBAC1C,uFAAuF,CAC1F,CAAC;YACJ,CAAC;YACD,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC9C,sEAAsE;YACtE,2DAA2D;YAC3D,OAAO,MAAM,YAAY,CACvB,EAAE,EACF,CAAC,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,EAC7F,QAAQ,EACR,YAAY,CACb,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChD,2FAA2F;IAC3F,4FAA4F;IAC5F,6FAA6F;IAC7F,4DAA4D;IAC5D,kFAAkF;IAClF,mFAAmF;IACnF,sEAAsE;IACtE,IAAI,CAAC,aAAa,IAAI,SAAS,EAAE,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,mDAAmD;gBACjD,gEAAgE;gBAChE,wCAAwC;gBACxC,+CAA+C,CAClD,CAAC;QACJ,CAAC;QACD,aAAa,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,IAAI,MAAM,CAAC;IACtC,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEjD,OAAO,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,YAAY,CACnB,KAAa,EACb,SAAmB,EACnB,QAAgB,EAChB,YAA0B;IAE1B,OAAO,IAAI,OAAO,CAAS,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE;YACpC,GAAG,EAAE,QAAQ;YACb,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE;YAC/E,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChC,IAAI,MAAM,EAAE,CAAC;gBACX,WAAW,CAAC,CAAC,CAAC,CAAC;gBACf,OAAO;YACT,CAAC;YAED,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAkB,EAAE,IAAc;IAC3E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/lib/session-utils.d.ts

@@ -0,0 +1,14 @@
+import type { OrchestratorConfig } from "@made-by-moonlight/athene-core";
+export declare function escapeRegex(str: string): string;
+/**
+ * Strip optional 12-char hex hash prefix from a tmux session name.
+ * "1686e4aaaeaa-ao-145" → "ao-145"
+ * "ao-145" → "ao-145" (no-op if no hash prefix)
+ */
+export declare function stripHashPrefix(name: string): string;
+/** Check whether a session name matches a project prefix (strict: prefix-\d+ only). */
+export declare function matchesPrefix(sessionName: string, prefix: string): boolean;
+/** Find which project a session belongs to by matching its name against session prefixes. */
+export declare function findProjectForSession(config: OrchestratorConfig, sessionName: string): string | null;
+export declare function isOrchestratorSessionName(config: OrchestratorConfig, sessionName: string, projectId?: string): boolean;
+//# sourceMappingURL=session-utils.d.ts.map

package/dist/lib/session-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-utils.d.ts","sourceRoot":"","sources":["../../src/lib/session-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG1E;AAED,6FAA6F;AAC7F,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAUf;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAwCT"}

package/dist/lib/session-utils.js

@@ -0,0 +1,58 @@
+export function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Strip optional 12-char hex hash prefix from a tmux session name.
+ * "1686e4aaaeaa-ao-145" → "ao-145"
+ * "ao-145" → "ao-145" (no-op if no hash prefix)
+ */
+export function stripHashPrefix(name) {
+    const match = name.match(/^[a-f0-9]{12}-(.+)$/);
+    return match ? match[1] : name;
+}
+/** Check whether a session name matches a project prefix (strict: prefix-\d+ only). */
+export function matchesPrefix(sessionName, prefix) {
+    const normalizedName = stripHashPrefix(sessionName);
+    return new RegExp(`^${escapeRegex(prefix)}-\\d+$`).test(normalizedName);
+}
+/** Find which project a session belongs to by matching its name against session prefixes. */
+export function findProjectForSession(config, sessionName) {
+    for (const [id, project] of Object.entries(config.projects)) {
+        const prefix = project.sessionPrefix || id;
+        if (matchesPrefix(sessionName, prefix) || isOrchestratorSessionName(config, sessionName, id)) {
+            return id;
+        }
+    }
+    return null;
+}
+export function isOrchestratorSessionName(config, sessionName, projectId) {
+    const normalizedName = stripHashPrefix(sessionName);
+    // If sessionName is a numbered worker for any configured project, it is not an orchestrator.
+    // This guard runs first to prevent cross-project false positives: e.g. prefix "app" would
+    // match "app-orchestrator-1" as an orchestrator pattern, but if another project has prefix
+    // "app-orchestrator" then "app-orchestrator-1" is a worker, not an orchestrator.
+    for (const [id, project] of Object.entries(config.projects)) {
+        const prefix = project.sessionPrefix || id;
+        if (matchesPrefix(normalizedName, prefix))
+            return false;
+    }
+    if (projectId) {
+        const project = config.projects[projectId];
+        if (project) {
+            const prefix = project.sessionPrefix || projectId;
+            if (normalizedName === `${prefix}-orchestrator` ||
+                new RegExp(`^${escapeRegex(prefix)}-orchestrator-\\d+$`).test(normalizedName)) {
+                return true;
+            }
+        }
+    }
+    for (const [id, project] of Object.entries(config.projects)) {
+        const prefix = project.sessionPrefix || id;
+        if (normalizedName === `${prefix}-orchestrator` ||
+            new RegExp(`^${escapeRegex(prefix)}-orchestrator-\\d+$`).test(normalizedName)) {
+            return true;
+        }
+    }
+    return normalizedName.endsWith("-orchestrator");
+}
+//# sourceMappingURL=session-utils.js.map

package/dist/lib/session-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-utils.js","sourceRoot":"","sources":["../../src/lib/session-utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,MAAc;IAC/D,MAAM,cAAc,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IACpD,OAAO,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAC1E,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,qBAAqB,CACnC,MAA0B,EAC1B,WAAmB;IAEnB,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAEzD,EAAE,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAC3C,IAAI,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,yBAAyB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC;YAC7F,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAA0B,EAC1B,WAAmB,EACnB,SAAkB;IAElB,MAAM,cAAc,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAEpD,6FAA6F;IAC7F,0FAA0F;IAC1F,2FAA2F;IAC3F,iFAAiF;IACjF,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAEzD,EAAE,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAC3C,IAAI,aAAa,CAAC,cAAc,EAAE,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;IAC1D,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,IAAI,SAAS,CAAC;YAClD,IACE,cAAc,KAAK,GAAG,MAAM,eAAe;gBAC3C,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAC7E,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAEzD,EAAE,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAC3C,IACE,cAAc,KAAK,GAAG,MAAM,eAAe;YAC3C,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAC7E,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAClD,CAAC"}