@made-by-moonlight/athene-cli 0.9.2

package/dist/lib/resolve-project.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Unified project resolution for `athene start`.
+ *
+ * Replaces the per-arg-shape dispatch that lived inline in start.ts (URL →
+ * handleUrlStart, path → addProjectToConfig, none → loadConfig/autoCreate +
+ * registerFlatConfig recovery, project-id → resolveProject). Each shape
+ * still has its own helper here, but they all return the same shape so
+ * the caller can treat them uniformly.
+ *
+ * The same resolver runs whether or not a daemon is already up. When a
+ * daemon is running, callers pass `targetGlobalRegistry: true` so URL/path
+ * args register the project in the global config (the daemon's source of
+ * truth) rather than into the cwd-local config a non-running fresh start
+ * would generate.
+ */
+import { type OrchestratorConfig, type ParsedRepoUrl, type ProjectConfig } from "@made-by-moonlight/athene-core";
+export type ProjectSource = "url" | "path" | "cwd" | "existing-id";
+export interface Resolved {
+    config: OrchestratorConfig;
+    projectId: string;
+    project: ProjectConfig;
+    source: ProjectSource;
+    /** True when this resolve call wrote new state to disk (cloned a repo,
+     *  generated a config, or registered a project). False when the project
+     *  was already known. Useful for dashboard cache invalidation hints. */
+    justCreated: boolean;
+    /** Populated only when source === "url". */
+    parsed?: ParsedRepoUrl;
+}
+/**
+ * Dependencies the resolver needs to delegate to existing start.ts helpers.
+ * Passed in rather than imported to keep this module decoupled from
+ * start.ts's other concerns (interactive prompts, agent detection, etc.).
+ */
+export interface ResolveDeps {
+    /**
+     * Add an unregistered local path as a new project. The signature matches
+     * start.ts's `addProjectToConfig`. Returns the registered project id.
+     */
+    addProjectToConfig: (config: OrchestratorConfig, path: string) => Promise<string>;
+    /**
+     * Auto-create a config when none exists at `workingDir`. Matches
+     * start.ts's `autoCreateConfig`. Returns the loaded config.
+     */
+    autoCreateConfig: (workingDir: string) => Promise<OrchestratorConfig>;
+    /**
+     * Resolve an existing project from a loaded config (handles single-
+     * project, explicit arg, multi-project prompt). Matches start.ts's
+     * `resolveProject`.
+     */
+    resolveProject: (config: OrchestratorConfig, projectArg?: string) => Promise<{
+        projectId: string;
+        project: ProjectConfig;
+        config: OrchestratorConfig;
+    }>;
+    /**
+     * Resolve a project from a loaded config by matching the URL's
+     * `ownerRepo`. Matches start.ts's `resolveProjectByRepo`.
+     */
+    resolveProjectByRepo: (config: OrchestratorConfig, parsed: ParsedRepoUrl) => Promise<{
+        projectId: string;
+        project: ProjectConfig;
+        config: OrchestratorConfig;
+    }>;
+    /**
+     * Recover a flat local config that exists but isn't registered globally.
+     * Matches start.ts's `registerFlatConfig`. Returns the registered id, or
+     * null if recovery is not possible.
+     */
+    registerFlatConfig: (configPath: string) => Promise<string | null>;
+    /**
+     * Clone a repo into the target dir. Matches start.ts's `cloneRepo`.
+     */
+    cloneRepo: (parsed: ParsedRepoUrl, targetDir: string, cwd: string) => Promise<void>;
+}
+/**
+ * Options that change how the resolver writes new state to disk.
+ *
+ * `targetGlobalRegistry`:
+ *   When `true`, URL and path arguments resolve and register against the
+ *   global config (`~/.agent-orchestrator/config.yaml`) rather than a cwd-
+ *   local one. Used when an `ao` daemon is already running — the daemon's
+ *   project supervisor reads from the global registry, so anything we
+ *   freshly clone or add must land there to be visible.
+ *
+ *   When `false` (default), the resolver behaves as if this were the very
+ *   first `athene start`: URL clones generate a wrapped (`projects:`) yaml in
+ *   the cloned repo, paths register against whatever config the cwd walks
+ *   up to find.
+ */
+export interface ResolveOptions {
+    targetGlobalRegistry?: boolean;
+}
+/**
+ * Resolve (and create if necessary) the project a given `athene start [arg]`
+ * invocation refers to.
+ *
+ * Dispatches by arg shape:
+ * - `arg` is a URL → clone (or reuse), load/generate config, match by repo
+ * - `arg` is a local path → load existing or addProject or autoCreate
+ * - `arg` is a project id → load config, fall back to global if needed
+ * - `arg` is undefined → load cwd config, autoCreate on first run, register
+ *   flat configs that exist but aren't globally known
+ *
+ * The same `Resolved` shape comes back regardless of source; callers use
+ * `source` and `justCreated` for hints (e.g. dashboard cache invalidation).
+ *
+ * Pass `opts.targetGlobalRegistry: true` when an `ao` daemon is already
+ * running so URL/path args register the project in the global config the
+ * daemon supervises rather than into a fresh cwd-local one.
+ */
+export declare function resolveOrCreateProject(arg: string | undefined, deps: ResolveDeps, opts?: ResolveOptions): Promise<Resolved>;
+//# sourceMappingURL=resolve-project.d.ts.map

package/dist/lib/resolve-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-project.d.ts","sourceRoot":"","sources":["../../src/lib/resolve-project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAgBL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AAQxC,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,CAAC;AAEnE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB;;4EAEwE;IACxE,WAAW,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,kBAAkB,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClF;;;OAGG;IACH,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtE;;;;OAIG;IACH,cAAc,EAAE,CACd,MAAM,EAAE,kBAAkB,EAC1B,UAAU,CAAC,EAAE,MAAM,KAChB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;IACxF;;;OAGG;IACH,oBAAoB,EAAE,CACpB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,aAAa,KAClB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;IACxF;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnE;;OAEG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAwaD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,QAAQ,CAAC,CAInB"}

package/dist/lib/resolve-project.js

@@ -0,0 +1,433 @@
+/**
+ * Unified project resolution for `athene start`.
+ *
+ * Replaces the per-arg-shape dispatch that lived inline in start.ts (URL →
+ * handleUrlStart, path → addProjectToConfig, none → loadConfig/autoCreate +
+ * registerFlatConfig recovery, project-id → resolveProject). Each shape
+ * still has its own helper here, but they all return the same shape so
+ * the caller can treat them uniformly.
+ *
+ * The same resolver runs whether or not a daemon is already up. When a
+ * daemon is running, callers pass `targetGlobalRegistry: true` so URL/path
+ * args register the project in the global config (the daemon's source of
+ * truth) rather than into the cwd-local config a non-running fresh start
+ * would generate.
+ */
+import { existsSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { pathsEqual } from "./path-equality.js";
+import { cwd } from "node:process";
+import { ConfigNotFoundError, detectScmPlatform, findConfigFile, generateConfigFromUrl, configToYaml, isRepoUrl, loadConfig, parseRepoUrl, recordActivityEvent, registerProjectInGlobalConfig, resolveCloneTarget, isRepoAlreadyCloned, getGlobalConfigPath, sanitizeProjectId, writeLocalProjectConfig, } from "@made-by-moonlight/athene-core";
+import chalk from "chalk";
+import ora from "ora";
+import { findFreePort } from "./web-dir.js";
+import { DEFAULT_PORT } from "./constants.js";
+import { ensureGit } from "./startup-preflight.js";
+import { git } from "./shell.js";
+/**
+ * Decide whether `arg` looks like a path (rather than a project id).
+ * Matches start.ts's `isLocalPath` — including Windows drive-letter and
+ * UNC patterns so e.g. `athene start C:\path\to\repo` is correctly classified.
+ */
+function isLocalPath(arg) {
+    if (arg.startsWith("/") || arg.startsWith("~") || arg.startsWith("./") || arg.startsWith("..")) {
+        return true;
+    }
+    if (/^[A-Za-z]:[\\/]/.test(arg))
+        return true;
+    if (arg.startsWith("\\\\") || arg.startsWith(".\\") || arg.startsWith("..\\"))
+        return true;
+    return false;
+}
+/**
+ * Detect the actual default branch of a freshly cloned repo. Prefers
+ * `origin/HEAD` (the remote's default), falls back to the current local
+ * branch. Returns null for empty repos (no commits).
+ */
+async function detectClonedRepoDefaultBranch(repoPath) {
+    const symref = await git(["symbolic-ref", "refs/remotes/origin/HEAD"], repoPath);
+    if (symref) {
+        const match = symref.trim().match(/^refs\/remotes\/origin\/(.+)$/);
+        if (match)
+            return match[1];
+    }
+    const head = await git(["symbolic-ref", "--short", "HEAD"], repoPath);
+    if (head) {
+        const trimmed = head.trim();
+        if (trimmed.length > 0)
+            return trimmed;
+    }
+    return null;
+}
+/**
+ * Clone (or reuse) a URL and register the project in the global config.
+ * The repo gets a flat local config (behavior only — scm/tracker plugin
+ * choices); identity (path, repo, defaultBranch, sessionPrefix) lives in
+ * the global registry so the daemon's project supervisor can see it.
+ *
+ * Mirrors the inline clone+register block that previously lived in start.ts
+ * for the "AO already running + URL arg" case.
+ */
+async function fromUrlIntoGlobal(arg, deps) {
+    const parsed = parseRepoUrl(arg);
+    const globalConfigPath = getGlobalConfigPath();
+    const globalConfig = existsSync(globalConfigPath) ? loadConfig(globalConfigPath) : loadConfig();
+    // Existing project with the same repo? Skip the clone entirely.
+    for (const [id, p] of Object.entries(globalConfig.projects)) {
+        if (p.repo === parsed.ownerRepo) {
+            return {
+                config: globalConfig,
+                projectId: id,
+                project: p,
+                source: "url",
+                justCreated: false,
+                parsed,
+            };
+        }
+    }
+    console.log(chalk.bold.cyan(`\n  Cloning ${parsed.ownerRepo} (${parsed.host})\n`));
+    await ensureGit("repository cloning");
+    const cwdDir = process.cwd();
+    const targetDir = resolveCloneTarget(parsed, cwdDir);
+    if (isRepoAlreadyCloned(targetDir, parsed.cloneUrl)) {
+        console.log(chalk.green(`  Reusing existing clone at ${targetDir}`));
+    }
+    else {
+        try {
+            await deps.cloneRepo(parsed, targetDir, cwdDir);
+            console.log(chalk.green(`  Cloned to ${targetDir}`));
+        }
+        catch (err) {
+            recordActivityEvent({
+                source: "cli",
+                kind: "cli.project_resolve_failed",
+                level: "error",
+                summary: `failed to clone ${parsed.ownerRepo}`,
+                data: {
+                    ownerRepo: parsed.ownerRepo,
+                    targetDir,
+                    source: "url-global",
+                    errorMessage: err instanceof Error ? err.message : String(err),
+                },
+            });
+            throw new Error(`Failed to clone ${parsed.ownerRepo}: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+        }
+    }
+    // Empty repos can't host an orchestrator worktree — fail early with a
+    // clear message instead of a confusing "Unable to resolve base ref" later.
+    const detectedBranch = await detectClonedRepoDefaultBranch(targetDir);
+    if (!detectedBranch) {
+        throw new Error(`Repository "${parsed.ownerRepo}" appears to be empty (no commits or refs).\n` +
+            `  AO needs at least one commit on the default branch to spawn an orchestrator.\n` +
+            `  Push an initial commit, then re-run \`athene start ${arg}\`.`);
+    }
+    const platform = detectScmPlatform(parsed.host);
+    const requestedProjectId = sanitizeProjectId(parsed.repo);
+    const registeredId = registerProjectInGlobalConfig(requestedProjectId, parsed.repo, targetDir, {
+        repo: parsed.ownerRepo,
+        defaultBranch: detectedBranch,
+    }, globalConfigPath);
+    // Write a flat local config (behavior only, no `projects:` wrapper, no
+    // identity fields). Identity lives in the global registry; this file
+    // holds plugin choices for the project. Skip if the upstream commits its
+    // own agent-orchestrator.yaml — leave it for the user to reconcile.
+    const hasCommittedConfig = existsSync(resolve(targetDir, "agent-orchestrator.yaml")) ||
+        existsSync(resolve(targetDir, "agent-orchestrator.yml"));
+    if (!hasCommittedConfig) {
+        writeLocalProjectConfig(targetDir, {
+            scm: { plugin: platform !== "unknown" ? platform : "github" },
+            tracker: {
+                plugin: platform === "gitlab" ? "gitlab" : "github",
+            },
+        });
+    }
+    const refreshedConfig = loadConfig(globalConfigPath);
+    const project = refreshedConfig.projects[registeredId];
+    if (!project) {
+        throw new Error(`Failed to register "${registeredId}" in the global config — aborting.`);
+    }
+    return {
+        config: refreshedConfig,
+        projectId: registeredId,
+        project,
+        source: "url",
+        justCreated: true,
+        parsed,
+    };
+}
+async function fromUrl(arg, deps, opts) {
+    if (opts.targetGlobalRegistry) {
+        return fromUrlIntoGlobal(arg, deps);
+    }
+    console.log(chalk.bold.cyan("\n  Athene — Quick Start\n"));
+    const spinner = ora();
+    spinner.start("Parsing repository URL");
+    const parsed = parseRepoUrl(arg);
+    spinner.succeed(`Repository: ${chalk.cyan(parsed.ownerRepo)} (${parsed.host})`);
+    await ensureGit("repository cloning");
+    const cwdDir = process.cwd();
+    const targetDir = resolveCloneTarget(parsed, cwdDir);
+    const alreadyCloned = isRepoAlreadyCloned(targetDir, parsed.cloneUrl);
+    if (alreadyCloned) {
+        console.log(chalk.green(`  Reusing existing clone at ${targetDir}`));
+    }
+    else {
+        spinner.start(`Cloning ${parsed.ownerRepo}`);
+        try {
+            spinner.stop();
+            await deps.cloneRepo(parsed, targetDir, cwdDir);
+            spinner.succeed(`Cloned to ${targetDir}`);
+        }
+        catch (err) {
+            spinner.fail("Clone failed");
+            recordActivityEvent({
+                source: "cli",
+                kind: "cli.project_resolve_failed",
+                level: "error",
+                summary: `failed to clone ${parsed.ownerRepo}`,
+                data: {
+                    ownerRepo: parsed.ownerRepo,
+                    targetDir,
+                    source: "url-local",
+                    errorMessage: err instanceof Error ? err.message : String(err),
+                },
+            });
+            throw new Error(`Failed to clone ${parsed.ownerRepo}: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+        }
+    }
+    const configPath = resolve(targetDir, "agent-orchestrator.yaml");
+    const configPathAlt = resolve(targetDir, "agent-orchestrator.yml");
+    let config;
+    let justCreated;
+    if (existsSync(configPath)) {
+        console.log(chalk.green(`  Using existing config: ${configPath}`));
+        config = loadConfig(configPath);
+        justCreated = false;
+    }
+    else if (existsSync(configPathAlt)) {
+        console.log(chalk.green(`  Using existing config: ${configPathAlt}`));
+        config = loadConfig(configPathAlt);
+        justCreated = false;
+    }
+    else {
+        spinner.start("Generating config");
+        const freePort = await findFreePort(DEFAULT_PORT);
+        const rawConfig = generateConfigFromUrl({
+            parsed,
+            repoPath: targetDir,
+            port: freePort ?? DEFAULT_PORT,
+        });
+        const yamlContent = configToYaml(rawConfig);
+        writeFileSync(configPath, yamlContent);
+        spinner.succeed(`Config generated: ${configPath}`);
+        config = loadConfig(configPath);
+        justCreated = true;
+    }
+    const resolved = await deps.resolveProjectByRepo(config, parsed);
+    return {
+        config: resolved.config,
+        projectId: resolved.projectId,
+        project: resolved.project,
+        source: "url",
+        justCreated,
+        parsed,
+    };
+}
+async function fromPath(arg, deps, opts) {
+    const resolvedPath = resolve(arg.replace(/^~/, process.env["HOME"] || ""));
+    // When a daemon is already running, register against the global config
+    // (the daemon's source of truth) instead of whatever cwd-local config
+    // findConfigFile() walks up to. addProjectToConfig is canonical-global-
+    // aware, so handing it a config loaded from the global path routes the
+    // write through registerProjectInGlobalConfig.
+    if (opts.targetGlobalRegistry) {
+        const globalPath = getGlobalConfigPath();
+        const globalConfig = existsSync(globalPath) ? loadConfig(globalPath) : loadConfig();
+        // pathsEqual canonicalizes via realpathSync so symlinked paths (e.g.
+        // macOS /tmp -> /private/tmp) match an entry stored under the
+        // resolved target, and lowercases on Windows so drive-letter / 8.3
+        // case mismatches don't slip through. Without this, `athene start
+        // /tmp/foo` against a daemon whose global config has /private/tmp/foo
+        // would fail to dedupe and double-register the project.
+        const existingEntry = Object.entries(globalConfig.projects).find(([, p]) => pathsEqual(p.path, resolvedPath));
+        if (existingEntry) {
+            return {
+                config: globalConfig,
+                projectId: existingEntry[0],
+                project: existingEntry[1],
+                source: "path",
+                justCreated: false,
+            };
+        }
+        const addedId = await deps.addProjectToConfig(globalConfig, resolvedPath);
+        const reloaded = loadConfig(globalConfig.configPath);
+        const project = reloaded.projects[addedId];
+        if (!project) {
+            throw new Error(`Failed to register "${addedId}" in the global config — aborting.`);
+        }
+        return {
+            config: reloaded,
+            projectId: addedId,
+            project,
+            source: "path",
+            justCreated: true,
+        };
+    }
+    let configPath;
+    try {
+        configPath = findConfigFile() ?? undefined;
+    }
+    catch {
+        // No config — fall through to autoCreate.
+    }
+    if (!configPath) {
+        // No config anywhere — auto-create at the target path (or cwd if they match).
+        const targetDir = resolve(cwd()) === resolvedPath ? cwd() : resolvedPath;
+        const config = await deps.autoCreateConfig(targetDir);
+        const resolved = await deps.resolveProject(config);
+        return {
+            config: resolved.config,
+            projectId: resolved.projectId,
+            project: resolved.project,
+            source: "path",
+            justCreated: true,
+        };
+    }
+    // Config exists — check if the path is already registered.
+    const config = loadConfig(configPath);
+    const existingEntry = Object.entries(config.projects).find(([, p]) => pathsEqual(p.path, resolvedPath));
+    if (existingEntry) {
+        return {
+            config,
+            projectId: existingEntry[0],
+            project: existingEntry[1],
+            source: "path",
+            justCreated: false,
+        };
+    }
+    // Path is new — register it.
+    const addedId = await deps.addProjectToConfig(config, resolvedPath);
+    const reloaded = loadConfig(config.configPath);
+    return {
+        config: reloaded,
+        projectId: addedId,
+        project: reloaded.projects[addedId],
+        source: "path",
+        justCreated: true,
+    };
+}
+async function fromCwdOrId(arg, deps, opts) {
+    // Daemon-running + project id: the global registry is the source of
+    // truth for project identity, so look there directly. Skipping the cwd-
+    // local loadConfig() also avoids first-run autoCreate prompts when the
+    // user just wants to attach to a known project.
+    if (opts.targetGlobalRegistry && arg) {
+        const globalPath = getGlobalConfigPath();
+        const config = existsSync(globalPath) ? loadConfig(globalPath) : loadConfig();
+        const project = config.projects[arg];
+        if (!project) {
+            throw new Error(`Project "${arg}" is not registered in the global config (${config.configPath}).\n` +
+                `  Run \`athene project add\` or \`athene start <path|url>\` first.`);
+        }
+        return {
+            config,
+            projectId: arg,
+            project,
+            source: "existing-id",
+            justCreated: false,
+        };
+    }
+    let config;
+    let recovered = false;
+    try {
+        config = loadConfig();
+    }
+    catch (err) {
+        if (err instanceof ConfigNotFoundError) {
+            // First run — auto-create config in cwd.
+            config = await deps.autoCreateConfig(cwd());
+            recovered = true;
+            recordActivityEvent({
+                source: "cli",
+                kind: "cli.config_recovered",
+                level: "info",
+                summary: `auto-created config in cwd (first-run)`,
+                data: { recovery: "auto_create", cwd: cwd() },
+            });
+        }
+        else {
+            // A config file exists but failed to load — likely a flat local
+            // config whose project isn't in the global registry yet. Recover
+            // by registering it, then retry the load.
+            const foundConfig = findConfigFile() ?? undefined;
+            if (!foundConfig)
+                throw err;
+            const addedId = await deps.registerFlatConfig(foundConfig);
+            if (!addedId) {
+                recordActivityEvent({
+                    source: "cli",
+                    kind: "cli.config_recovery_failed",
+                    level: "error",
+                    summary: `registerFlatConfig returned null — recovery failed`,
+                    data: {
+                        configPath: foundConfig,
+                        errorMessage: err instanceof Error ? err.message : String(err),
+                    },
+                });
+                throw err;
+            }
+            config = loadConfig(foundConfig);
+            recovered = true;
+            recordActivityEvent({
+                projectId: addedId,
+                source: "cli",
+                kind: "cli.config_recovered",
+                level: "info",
+                summary: `registered flat config into global config and retried load`,
+                data: { recovery: "register_flat", configPath: foundConfig },
+            });
+        }
+    }
+    // If the user named a project that isn't in the local config, fall back
+    // to the global registry (which has all registered projects).
+    if (arg && !config.projects[arg]) {
+        const globalPath = getGlobalConfigPath();
+        if (existsSync(globalPath)) {
+            config = loadConfig(globalPath);
+        }
+    }
+    const resolved = await deps.resolveProject(config, arg);
+    return {
+        config: resolved.config,
+        projectId: resolved.projectId,
+        project: resolved.project,
+        source: arg ? "existing-id" : "cwd",
+        justCreated: recovered,
+    };
+}
+/**
+ * Resolve (and create if necessary) the project a given `athene start [arg]`
+ * invocation refers to.
+ *
+ * Dispatches by arg shape:
+ * - `arg` is a URL → clone (or reuse), load/generate config, match by repo
+ * - `arg` is a local path → load existing or addProject or autoCreate
+ * - `arg` is a project id → load config, fall back to global if needed
+ * - `arg` is undefined → load cwd config, autoCreate on first run, register
+ *   flat configs that exist but aren't globally known
+ *
+ * The same `Resolved` shape comes back regardless of source; callers use
+ * `source` and `justCreated` for hints (e.g. dashboard cache invalidation).
+ *
+ * Pass `opts.targetGlobalRegistry: true` when an `ao` daemon is already
+ * running so URL/path args register the project in the global config the
+ * daemon supervises rather than into a fresh cwd-local one.
+ */
+export async function resolveOrCreateProject(arg, deps, opts = {}) {
+    if (arg && isRepoUrl(arg))
+        return fromUrl(arg, deps, opts);
+    if (arg && isLocalPath(arg))
+        return fromPath(arg, deps, opts);
+    return fromCwdOrId(arg, deps, opts);
+}
+//# sourceMappingURL=resolve-project.js.map

package/dist/lib/resolve-project.js.map

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

package/dist/lib/routes.d.ts

@@ -0,0 +1,2 @@
+export declare function projectSessionUrl(port: number, projectId: string, sessionId: string): string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/lib/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/lib/routes.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5F"}

package/dist/lib/routes.js

@@ -0,0 +1,5 @@
+import { dashboardUrl } from "./dashboard-url.js";
+export function projectSessionUrl(port, projectId, sessionId) {
+    return `${dashboardUrl(port)}/projects/${encodeURIComponent(projectId)}/sessions/${encodeURIComponent(sessionId)}`;
+}
+//# sourceMappingURL=routes.js.map

package/dist/lib/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/lib/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,SAAiB,EAAE,SAAiB;IAClF,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,aAAa,kBAAkB,CAAC,SAAS,CAAC,aAAa,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;AACrH,CAAC"}

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

@@ -0,0 +1,76 @@
+export interface RunningState {
+    pid: number;
+    configPath: string;
+    port: number;
+    startedAt: string;
+    projects: string[];
+}
+export interface LastStopState {
+    stoppedAt: string;
+    projectId: string;
+    sessionIds: string[];
+    /** Sessions from other projects that were also active at stop time. */
+    otherProjects?: Array<{
+        projectId: string;
+        sessionIds: string[];
+    }>;
+}
+/**
+ * Register the current AO instance as running.
+ * Uses a lockfile to prevent concurrent registration.
+ */
+export declare function register(entry: RunningState): Promise<void>;
+/**
+ * Unregister the running AO instance.
+ */
+export declare function unregister(): Promise<void>;
+/**
+ * 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 declare function removeProjectFromRunning(projectId: string): Promise<void>;
+/**
+ * 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 declare function addProjectToRunning(projectId: string): Promise<void>;
+/**
+ * Get the currently running AO instance, if any.
+ * Auto-prunes stale entries (dead PIDs).
+ */
+export declare function getRunning(): Promise<RunningState | null>;
+/**
+ * Check if AO is already running.
+ * Returns the running state if alive, null otherwise.
+ */
+export declare function isAlreadyRunning(): Promise<RunningState | null>;
+/**
+ * Serialize `athene start` so concurrent startups cannot both observe an empty
+ * running.json and create competing orchestrator/dashboard processes.
+ */
+export declare function acquireStartupLock(timeoutMs?: number): Promise<() => void>;
+/**
+ * Wait for a process to exit, polling isProcessAlive.
+ * Returns true if the process exited, false if timeout reached.
+ */
+export declare function waitForExit(pid: number, timeoutMs?: number): Promise<boolean>;
+/**
+ * Record which sessions were active when `athene stop` ran.
+ */
+export declare function writeLastStop(state: LastStopState): Promise<void>;
+/**
+ * Read the last-stop state, if any.
+ */
+export declare function readLastStop(): Promise<LastStopState | null>;
+/**
+ * Remove the last-stop state file (after restore or skip).
+ */
+export declare function clearLastStop(): Promise<void>;
+//# sourceMappingURL=running-state.d.ts.map