@made-by-moonlight/athene-core 0.9.1

package/dist/config-generator.js

@@ -0,0 +1,295 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { stringify } from 'yaml';
+import { generateSessionPrefix } from './paths.js';
+import { getDefaultRuntime } from './platform.js';
+
+/**
+ * Config generator for `athene start <url>` — auto-detects project settings
+ * from a repo URL and generates a valid agent-orchestrator.yaml.
+ *
+ * SCM-agnostic: parses GitHub, GitLab, Bitbucket URLs and infers plugins.
+ */
+// Main is the canonical config-schema contract; schema evolution must remain
+// forward-compatible and additive for older CLIs that stamp this URL.
+const CONFIG_SCHEMA_URL = "https://raw.githubusercontent.com/slievr/Athene/main/schema/config.schema.json";
+function withConfigSchema(config) {
+    const { $schema: providedSchema, ...rest } = config;
+    const schema = typeof providedSchema === "string" && providedSchema.trim().length > 0
+        ? providedSchema
+        : CONFIG_SCHEMA_URL;
+    return {
+        $schema: schema,
+        ...rest,
+    };
+}
+/**
+ * Check if a string looks like a repo URL (HTTP(S) or SSH git URL).
+ */
+function isRepoUrl(arg) {
+    return /^https?:\/\//.test(arg) || /^git@[^:]+:.+\/.+/.test(arg);
+}
+/**
+ * Parse a repo URL into components.
+ * Supports:
+ *   - https://github.com/owner/repo
+ *   - https://github.com/owner/repo.git
+ *   - git@github.com:owner/repo.git
+ *   - Same patterns for GitLab, Bitbucket, etc.
+ */
+function parseRepoUrl(url) {
+    // SSH format: git@host:owner/repo.git
+    const sshMatch = url.match(/^git@([^:]+):([^/]+)\/([^/]+?)(?:\.git)?$/);
+    if (sshMatch) {
+        const host = sshMatch[1];
+        const owner = sshMatch[2];
+        const repo = sshMatch[3];
+        return {
+            ownerRepo: `${owner}/${repo}`,
+            owner,
+            repo,
+            host,
+            cloneUrl: `https://${host}/${owner}/${repo}.git`,
+        };
+    }
+    // HTTPS format: https://host/owner/repo[.git]
+    const httpsMatch = url.match(/^https?:\/\/([^/]+)\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/);
+    if (httpsMatch) {
+        const host = httpsMatch[1];
+        const owner = httpsMatch[2];
+        const repo = httpsMatch[3];
+        return {
+            ownerRepo: `${owner}/${repo}`,
+            owner,
+            repo,
+            host,
+            cloneUrl: `https://${host}/${owner}/${repo}.git`,
+        };
+    }
+    throw new Error(`Could not parse repo URL: ${url}\n` +
+        `Expected format: https://github.com/owner/repo or git@github.com:owner/repo.git`);
+}
+/**
+ * Detect SCM platform from hostname.
+ */
+function detectScmPlatform(host) {
+    const lower = host.toLowerCase();
+    if (lower === "github.com" || lower.endsWith(".github.com"))
+        return "github";
+    if (lower === "gitlab.com" || lower.endsWith(".gitlab.com"))
+        return "gitlab";
+    if (lower === "bitbucket.org" ||
+        lower.endsWith(".bitbucket.org") ||
+        lower.endsWith(".bitbucket.com"))
+        return "bitbucket";
+    return "unknown";
+}
+// =============================================================================
+// PROJECT DETECTION (minimal — reuses cli/project-detection for full detection)
+// =============================================================================
+/** Detect the default branch from a local repo directory. */
+function detectDefaultBranchFromDir(repoDir) {
+    // Check HEAD file for symref
+    const headPath = join(repoDir, ".git", "HEAD");
+    if (existsSync(headPath)) {
+        const head = readFileSync(headPath, "utf-8").trim();
+        const match = head.match(/^ref: refs\/heads\/(.+)$/);
+        if (match) {
+            // This is the current branch, not necessarily the default.
+            // Check for common default branch names in refs.
+            const commonDefaults = ["main", "master", "next", "develop"];
+            for (const branch of commonDefaults) {
+                const refPath = join(repoDir, ".git", "refs", "remotes", "origin", branch);
+                const packedRefs = join(repoDir, ".git", "packed-refs");
+                if (existsSync(refPath))
+                    return branch;
+                // Check packed-refs for the branch
+                if (existsSync(packedRefs)) {
+                    const packed = readFileSync(packedRefs, "utf-8");
+                    if (packed.includes(`refs/remotes/origin/${branch}`))
+                        return branch;
+                }
+            }
+            // Fallback to current branch if no common default found
+            return match[1];
+        }
+    }
+    return "main";
+}
+function detectProjectInfo(repoDir) {
+    const hasFile = (name) => existsSync(join(repoDir, name));
+    if (hasFile("package.json")) {
+        const pm = hasFile("pnpm-lock.yaml")
+            ? "pnpm"
+            : hasFile("yarn.lock")
+                ? "yarn"
+                : hasFile("bun.lockb") || hasFile("bun.lock")
+                    ? "bun"
+                    : "npm";
+        const lang = hasFile("tsconfig.json") || hasFile("tsconfig.base.json") ? "typescript" : "javascript";
+        return { language: lang, packageManager: pm };
+    }
+    if (hasFile("Cargo.toml"))
+        return { language: "rust", packageManager: "cargo" };
+    if (hasFile("go.mod"))
+        return { language: "go", packageManager: "go" };
+    if (hasFile("pyproject.toml") || hasFile("requirements.txt") || hasFile("setup.py")) {
+        return { language: "python", packageManager: "pip" };
+    }
+    return { language: null, packageManager: null };
+}
+function readOriginRemoteUrl(projectPath) {
+    const gitConfigPath = join(resolve(projectPath), ".git", "config");
+    if (!existsSync(gitConfigPath))
+        return null;
+    const lines = readFileSync(gitConfigPath, "utf-8").split(/\r?\n/);
+    let inOrigin = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+            inOrigin = trimmed === '[remote "origin"]';
+            continue;
+        }
+        if (!inOrigin)
+            continue;
+        const match = line.match(/^\s*url\s*=\s*(.+)\s*$/);
+        if (match?.[1])
+            return match[1].trim();
+    }
+    return null;
+}
+// =============================================================================
+// CONFIG GENERATION
+// =============================================================================
+/**
+ * Sanitize a repo name for use as a YAML project key.
+ * Lowercases, replaces dots/special chars with hyphens, strips leading/trailing hyphens.
+ */
+function sanitizeProjectId(repoName) {
+    return repoName
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-{2,}/g, "-");
+}
+/**
+ * Generate a complete agent-orchestrator.yaml config object from a repo URL.
+ * Returns the raw object ready for YAML serialization.
+ */
+function generateConfigFromUrl(options) {
+    const { parsed, repoPath, port = 3000 } = options;
+    const platform = detectScmPlatform(parsed.host);
+    const defaultBranch = detectDefaultBranchFromDir(repoPath);
+    const projectInfo = detectProjectInfo(repoPath);
+    // Use original case for prefix generation (preserves CamelCase detection),
+    // lowercase for the YAML project key.
+    const projectId = sanitizeProjectId(parsed.repo);
+    // Strip characters invalid in sessionPrefix (Zod: [a-zA-Z0-9_-]+) before
+    // passing to generateSessionPrefix, so "my.app" → "my-app" → "ma" (kebab path).
+    const prefixInput = parsed.repo.replace(/[^a-zA-Z0-9_-]/g, "-").replace(/^-+|-+$/g, "");
+    const prefix = generateSessionPrefix(prefixInput || parsed.repo);
+    // Build project config
+    const projectConfig = {
+        name: parsed.repo,
+        repo: parsed.ownerRepo,
+        path: repoPath,
+        defaultBranch,
+        sessionPrefix: prefix,
+    };
+    // SCM plugin — always set explicitly so applyProjectDefaults doesn't override.
+    // For known platforms, use the matching plugin. For unknown hosts, default to github
+    // (best available option since it's the only fully implemented SCM plugin).
+    projectConfig.scm = { plugin: platform !== "unknown" ? platform : "github" };
+    // Tracker — same platform as SCM for known hosts, github as fallback
+    projectConfig.tracker = {
+        plugin: platform === "github" || platform === "gitlab" ? platform : "github",
+    };
+    // Post-create commands based on detected package manager (JS ecosystem only)
+    const JS_PACKAGE_MANAGERS = {
+        pnpm: "pnpm install",
+        yarn: "yarn install",
+        bun: "bun install",
+        npm: "npm install",
+    };
+    const installCmd = projectInfo.packageManager
+        ? JS_PACKAGE_MANAGERS[projectInfo.packageManager]
+        : undefined;
+    if (installCmd) {
+        projectConfig.postCreate = [installCmd];
+    }
+    return withConfigSchema({
+        port,
+        defaults: {
+            runtime: getDefaultRuntime(),
+            agent: "claude-code",
+            workspace: "worktree",
+            notifiers: [],
+        },
+        projects: {
+            [projectId]: projectConfig,
+        },
+    });
+}
+/**
+ * Serialize a config object to YAML string.
+ */
+function configToYaml(config) {
+    return stringify(withConfigSchema(config), { indent: 2 });
+}
+/**
+ * Check if a directory already has the repo cloned by comparing remote URLs.
+ * Returns true if the directory is a git repo with a matching origin remote.
+ */
+function isRepoAlreadyCloned(dir, expectedCloneUrl) {
+    if (!existsSync(join(dir, ".git")))
+        return false;
+    const configPath = join(dir, ".git", "config");
+    if (!existsSync(configPath))
+        return false;
+    const gitConfig = readFileSync(configPath, "utf-8");
+    // Normalize URLs for comparison:
+    // - Convert SSH to HTTPS (git@host:owner/repo → https://host/owner/repo)
+    // - Strip .git suffix and trailing slashes
+    // - Lowercase for case-insensitive match
+    const normalize = (url) => {
+        let normalized = url.trim();
+        // Convert SSH format to HTTPS
+        const sshMatch = normalized.match(/^git@([^:]+):(.+)$/);
+        if (sshMatch) {
+            normalized = `https://${sshMatch[1]}/${sshMatch[2]}`;
+        }
+        return normalized
+            .replace(/\.git$/, "")
+            .replace(/\/$/, "")
+            .toLowerCase();
+    };
+    const expectedNorm = normalize(expectedCloneUrl);
+    // Look for url = ... lines in git config
+    const urlMatches = gitConfig.match(/url\s*=\s*(.+)/g);
+    if (!urlMatches)
+        return false;
+    return urlMatches.some((line) => {
+        const url = line.replace(/url\s*=\s*/, "").trim();
+        return normalize(url) === expectedNorm;
+    });
+}
+/**
+ * Determine the target directory for cloning a repo.
+ * If CWD matches the repo, return CWD. Otherwise return CWD/repo-name.
+ */
+function resolveCloneTarget(parsed, cwd) {
+    // If CWD is already the repo, reuse it
+    if (isRepoAlreadyCloned(cwd, parsed.cloneUrl)) {
+        return cwd;
+    }
+    // If CWD/repo-name exists and matches, reuse it
+    const subDir = resolve(cwd, parsed.repo);
+    if (isRepoAlreadyCloned(subDir, parsed.cloneUrl)) {
+        return subDir;
+    }
+    // Clone into CWD/repo-name
+    return subDir;
+}
+
+export { CONFIG_SCHEMA_URL, configToYaml, detectDefaultBranchFromDir, detectProjectInfo, detectScmPlatform, generateConfigFromUrl, isRepoAlreadyCloned, isRepoUrl, parseRepoUrl, readOriginRemoteUrl, resolveCloneTarget, sanitizeProjectId, withConfigSchema };
+//# sourceMappingURL=config-generator.js.map

package/dist/config-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-generator.js","sources":["../src/config-generator.ts"],"sourcesContent":[null],"names":["yamlStringify"],"mappings":";;;;;;AAAA;;;;;AAKG;AAQH;AACA;AACO,MAAM,iBAAiB,GAC5B;AAEI,SAAU,gBAAgB,CAC9B,MAAS,EAAA;IAET,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAE5C;AACD,IAAA,MAAM,MAAM,GACV,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG;AACnE,UAAE;UACA,iBAAiB;IAEvB,OAAO;AACL,QAAA,OAAO,EAAE,MAAM;AACf,QAAA,GAAG,IAAI;KACmB;AAC9B;AAuBA;;AAEG;AACG,SAAU,SAAS,CAAC,GAAW,EAAA;AACnC,IAAA,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;AAClE;AAEA;;;;;;;AAOG;AACG,SAAU,YAAY,CAAC,GAAW,EAAA;;IAEtC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,2CAA2C,CAAC;IACvE,IAAI,QAAQ,EAAE;AACZ,QAAA,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC;AACxB,QAAA,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC;AACzB,QAAA,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC;QACxB,OAAO;AACL,YAAA,SAAS,EAAE,CAAA,EAAG,KAAK,CAAA,CAAA,EAAI,IAAI,CAAA,CAAE;YAC7B,KAAK;YACL,IAAI;YACJ,IAAI;AACJ,YAAA,QAAQ,EAAE,CAAA,QAAA,EAAW,IAAI,IAAI,KAAK,CAAA,CAAA,EAAI,IAAI,CAAA,IAAA,CAAM;SACjD;IACH;;IAGA,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,sDAAsD,CAAC;IACpF,IAAI,UAAU,EAAE;AACd,QAAA,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC;AAC1B,QAAA,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC;AAC3B,QAAA,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC;QAC1B,OAAO;AACL,YAAA,SAAS,EAAE,CAAA,EAAG,KAAK,CAAA,CAAA,EAAI,IAAI,CAAA,CAAE;YAC7B,KAAK;YACL,IAAI;YACJ,IAAI;AACJ,YAAA,QAAQ,EAAE,CAAA,QAAA,EAAW,IAAI,IAAI,KAAK,CAAA,CAAA,EAAI,IAAI,CAAA,IAAA,CAAM;SACjD;IACH;AAEA,IAAA,MAAM,IAAI,KAAK,CACb,CAAA,0BAAA,EAA6B,GAAG,CAAA,EAAA,CAAI;AAClC,QAAA,CAAA,+EAAA,CAAiF,CACpF;AACH;AAEA;;AAEG;AACG,SAAU,iBAAiB,CAAC,IAAY,EAAA;AAC5C,IAAA,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE;IAChC,IAAI,KAAK,KAAK,YAAY,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;AAAE,QAAA,OAAO,QAAQ;IAC5E,IAAI,KAAK,KAAK,YAAY,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;AAAE,QAAA,OAAO,QAAQ;IAC5E,IACE,KAAK,KAAK,eAAe;AACzB,QAAA,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;AAChC,QAAA,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;AAEhC,QAAA,OAAO,WAAW;AACpB,IAAA,OAAO,SAAS;AAClB;AAEA;AACA;AACA;AAEA;AACM,SAAU,0BAA0B,CAAC,OAAe,EAAA;;IAExD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;AAC9C,IAAA,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE;QACxB,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC;QACpD,IAAI,KAAK,EAAE;;;YAGT,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC;AAC5D,YAAA,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE;AACnC,gBAAA,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC;gBAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC;gBACvD,IAAI,UAAU,CAAC,OAAO,CAAC;AAAE,oBAAA,OAAO,MAAM;;AAEtC,gBAAA,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE;oBAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC;AAChD,oBAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAA,oBAAA,EAAuB,MAAM,EAAE,CAAC;AAAE,wBAAA,OAAO,MAAM;gBACrE;YACF;;AAEA,YAAA,OAAO,KAAK,CAAC,CAAC,CAAC;QACjB;IACF;AACA,IAAA,OAAO,MAAM;AACf;AAQM,SAAU,iBAAiB,CAAC,OAAe,EAAA;AAC/C,IAAA,MAAM,OAAO,GAAG,CAAC,IAAY,KAAK,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAEjE,IAAA,IAAI,OAAO,CAAC,cAAc,CAAC,EAAE;AAC3B,QAAA,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB;AACjC,cAAE;AACF,cAAE,OAAO,CAAC,WAAW;AACnB,kBAAE;kBACA,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,UAAU;AAC1C,sBAAE;sBACA,KAAK;AACb,QAAA,MAAM,IAAI,GACR,OAAO,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,oBAAoB,CAAC,GAAG,YAAY,GAAG,YAAY;QACzF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE;IAC/C;IACA,IAAI,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE;IAC/E,IAAI,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;AACtE,IAAA,IAAI,OAAO,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,kBAAkB,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,EAAE;QACnF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE;IACtD;IAEA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;AACjD;AAEM,SAAU,mBAAmB,CAAC,WAAmB,EAAA;AACrD,IAAA,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC;AAClE,IAAA,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;AAAE,QAAA,OAAO,IAAI;AAE3C,IAAA,MAAM,KAAK,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IACjE,IAAI,QAAQ,GAAG,KAAK;AACpB,IAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;AACxB,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE;AAC3B,QAAA,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;AACpD,YAAA,QAAQ,GAAG,OAAO,KAAK,mBAAmB;YAC1C;QACF;AACA,QAAA,IAAI,CAAC,QAAQ;YAAE;QAEf,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC;AAClD,QAAA,IAAI,KAAK,GAAG,CAAC,CAAC;AAAE,YAAA,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;IACxC;AAEA,IAAA,OAAO,IAAI;AACb;AAEA;AACA;AACA;AAEA;;;AAGG;AACG,SAAU,iBAAiB,CAAC,QAAgB,EAAA;AAChD,IAAA,OAAO;AACJ,SAAA,WAAW;AACX,SAAA,OAAO,CAAC,cAAc,EAAE,GAAG;AAC3B,SAAA,OAAO,CAAC,UAAU,EAAE,EAAE;AACtB,SAAA,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;AAC3B;AAWA;;;AAGG;AACG,SAAU,qBAAqB,CAAC,OAA8B,EAAA;IAClE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,OAAO;IAEjD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC;AAC/C,IAAA,MAAM,aAAa,GAAG,0BAA0B,CAAC,QAAQ,CAAC;AAC1D,IAAA,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC;;;IAG/C,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC;;;AAGhD,IAAA,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;IACvF,MAAM,MAAM,GAAG,qBAAqB,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC;;AAGhE,IAAA,MAAM,aAAa,GAA4B;QAC7C,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,SAAS;AACtB,QAAA,IAAI,EAAE,QAAQ;QACd,aAAa;AACb,QAAA,aAAa,EAAE,MAAM;KACtB;;;;AAKD,IAAA,aAAa,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,QAAQ,KAAK,SAAS,GAAG,QAAQ,GAAG,QAAQ,EAAE;;IAG5E,aAAa,CAAC,OAAO,GAAG;AACtB,QAAA,MAAM,EAAE,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,GAAG,QAAQ,GAAG,QAAQ;KAC7E;;AAGD,IAAA,MAAM,mBAAmB,GAA2B;AAClD,QAAA,IAAI,EAAE,cAAc;AACpB,QAAA,IAAI,EAAE,cAAc;AACpB,QAAA,GAAG,EAAE,aAAa;AAClB,QAAA,GAAG,EAAE,aAAa;KACnB;AACD,IAAA,MAAM,UAAU,GAAG,WAAW,CAAC;AAC7B,UAAE,mBAAmB,CAAC,WAAW,CAAC,cAAc;UAC9C,SAAS;IACb,IAAI,UAAU,EAAE;AACd,QAAA,aAAa,CAAC,UAAU,GAAG,CAAC,UAAU,CAAC;IACzC;AAEA,IAAA,OAAO,gBAAgB,CAAC;QACtB,IAAI;AACJ,QAAA,QAAQ,EAAE;YACR,OAAO,EAAE,iBAAiB,EAAE;AAC5B,YAAA,KAAK,EAAE,aAAa;AACpB,YAAA,SAAS,EAAE,UAAU;AACrB,YAAA,SAAS,EAAE,EAAE;AACd,SAAA;AACD,QAAA,QAAQ,EAAE;YACR,CAAC,SAAS,GAAG,aAAa;AAC3B,SAAA;AACF,KAAA,CAAC;AACJ;AAEA;;AAEG;AACG,SAAU,YAAY,CAAC,MAA+B,EAAA;AAC1D,IAAA,OAAOA,SAAa,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAC/D;AAEA;;;AAGG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAE,gBAAwB,EAAA;IACvE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAAE,QAAA,OAAO,KAAK;IAEhD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC;AAC9C,IAAA,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;AAAE,QAAA,OAAO,KAAK;IAEzC,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC;;;;;AAMnD,IAAA,MAAM,SAAS,GAAG,CAAC,GAAW,KAAI;AAChC,QAAA,IAAI,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE;;QAE3B,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC;QACvD,IAAI,QAAQ,EAAE;AACZ,YAAA,UAAU,GAAG,CAAA,QAAA,EAAW,QAAQ,CAAC,CAAC,CAAC,CAAA,CAAA,EAAI,QAAQ,CAAC,CAAC,CAAC,CAAA,CAAE;QACtD;AACA,QAAA,OAAO;AACJ,aAAA,OAAO,CAAC,QAAQ,EAAE,EAAE;AACpB,aAAA,OAAO,CAAC,KAAK,EAAE,EAAE;AACjB,aAAA,WAAW,EAAE;AAClB,IAAA,CAAC;AAED,IAAA,MAAM,YAAY,GAAG,SAAS,CAAC,gBAAgB,CAAC;;IAGhD,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,iBAAiB,CAAC;AACrD,IAAA,IAAI,CAAC,UAAU;AAAE,QAAA,OAAO,KAAK;AAE7B,IAAA,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,KAAI;AAC9B,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;AACjD,QAAA,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,YAAY;AACxC,IAAA,CAAC,CAAC;AACJ;AAEA;;;AAGG;AACG,SAAU,kBAAkB,CAAC,MAAqB,EAAE,GAAW,EAAA;;IAEnE,IAAI,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;AAC7C,QAAA,OAAO,GAAG;IACZ;;IAGA,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC;IACxC,IAAI,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;AAChD,QAAA,OAAO,MAAM;IACf;;AAGA,IAAA,OAAO,MAAM;AACf;;;;"}

package/dist/config.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Configuration loader — reads agent-orchestrator.yaml and validates with Zod.
+ *
+ * Minimal config that just works:
+ *   projects:
+ *     my-app:
+ *       repo: org/repo
+ *       path: ~/my-app
+ *
+ * Everything else has sensible defaults.
+ */
+import { type ExternalPluginEntryRef, type LoadedConfig, type OrchestratorConfig } from "./types.js";
+/**
+ * Collect external plugin configs from tracker, scm, and notifier inline configs.
+ * These will be auto-added to config.plugins for loading.
+ *
+ * Also sets a temporary plugin name on configs that only have package/path,
+ * so that resolvePlugins() can look up the plugin by name.
+ *
+ * IMPORTANT: Only sets expectedPluginName when user explicitly specified `plugin`.
+ * When plugin is auto-generated, expectedPluginName is left undefined so that
+ * any manifest.name is accepted and the config is updated with it.
+ */
+export declare function collectExternalPluginConfigs(config: OrchestratorConfig): ExternalPluginEntryRef[];
+/**
+ * Sentinel string for the default `bugbot-comments` reaction message.
+ * The lifecycle dispatcher replaces this exact value with a formatted listing
+ * of the actual automated comments + correct-API guidance (see #895). If a
+ * project customizes the message in their YAML, the dispatcher leaves it alone.
+ */
+export declare const DEFAULT_BUGBOT_COMMENTS_MESSAGE = "Automated review comments found on your PR. Fix the issues flagged by the bot.";
+/**
+ * Search for config file in standard locations.
+ *
+ * Search order:
+ * 1. AO_CONFIG_PATH environment variable (if set)
+ * 2. Search up directory tree from CWD (like git)
+ * 3. Explicit startDir (if provided)
+ * 4. Home directory locations
+ */
+export declare function findConfigFile(startDir?: string): string | null;
+/** Find config file path (exported for use in hash generation) */
+export declare function findConfig(startDir?: string): string | null;
+/** Load and validate config from a YAML file */
+export declare function loadConfig(configPath?: string): LoadedConfig;
+/** Load config and return both config and resolved path */
+export declare function loadConfigWithPath(configPath?: string): {
+    config: LoadedConfig;
+    path: string;
+};
+/** Validate a raw config object */
+export declare function validateConfig(raw: unknown): OrchestratorConfig;
+/** Get the default config (useful for first-run setup) */
+export declare function getDefaultConfig(): OrchestratorConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AA6cpB;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,kBAAkB,GAAG,sBAAsB,EAAE,CAwCjG;AA2HD;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,mFACsC,CAAC;AAiFnF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkE/D;AAoGD,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CA+B5D;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG;IACvD,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,CA6BA;AAED,mCAAmC;AACnC,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAqB/D;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,IAAI,kBAAkB,CAIrD"}