@dahch/muninn 0.0.0-stage → 0.2.0

package/dist/setup/portable.js

@@ -0,0 +1,365 @@
+/**
+ * Portable MCP configuration setup.
+ *
+ * Iteration 1 of the setup feature owns exactly one destination:
+ * `{home}/.muninn/mcp.json`, using the standard `mcpServers` container. The
+ * portable entry never pins a project path; project-scoped destinations are
+ * handled by later setup iterations.
+ *
+ * Everything here is deliberately dependency-free and uses the same path-safety
+ * helper as the rest of Muninn. Reads and writes are per-file, writes are
+ * atomic, and a no-op keeps the original bytes untouched.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import { randomBytes } from "node:crypto";
+import { checkDocPath, lstatOrUndefined } from "../util/path-safety.js";
+export function canonicalPortableEntry() {
+    return { command: "muninn", args: ["mcp", "run"] };
+}
+export function resolvePortablePaths(homeDir) {
+    const selectedHome = resolve(homeDir ?? os.homedir());
+    return {
+        homeDir: selectedHome,
+        configPath: join(selectedHome, ".muninn", "mcp.json"),
+        legacyPath: join(selectedHome, ".huginn", "mcp.json"),
+    };
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasOwn(target, key) {
+    return Object.prototype.hasOwnProperty.call(target, key);
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+/**
+ * A syntactically usable Muninn entry. It may still differ from the canonical
+ * command line; that is classified as a conflict, not malformed input.
+ */
+function isUsableEntry(entry) {
+    if (hasOwn(entry, "command") && typeof entry.command !== "string")
+        return false;
+    if (hasOwn(entry, "args") && !isStringArray(entry.args))
+        return false;
+    return true;
+}
+function isCanonicalEntry(entry) {
+    if (!isPlainObject(entry))
+        return false;
+    const keys = Object.keys(entry).sort();
+    if (keys.length !== 2 || keys[0] !== "args" || keys[1] !== "command")
+        return false;
+    return (entry.command === "muninn" &&
+        Array.isArray(entry.args) &&
+        entry.args.length === 2 &&
+        entry.args[0] === "mcp" &&
+        entry.args[1] === "run");
+}
+function classifyRoot(data) {
+    if (!isPlainObject(data)) {
+        return { state: "malformed", error: "JSON root must be an object" };
+    }
+    if (!hasOwn(data, "mcpServers"))
+        return { state: "absent" };
+    const servers = data.mcpServers;
+    if (!isPlainObject(servers)) {
+        return { state: "malformed", error: "`mcpServers` must be an object" };
+    }
+    if (!hasOwn(servers, "muninn"))
+        return { state: "absent" };
+    const entry = servers.muninn;
+    if (!isPlainObject(entry)) {
+        return { state: "malformed", error: "`mcpServers.muninn` must be an object" };
+    }
+    if (!isUsableEntry(entry)) {
+        return {
+            state: "malformed",
+            error: "`mcpServers.muninn` must use a string `command` and a string-array `args`",
+        };
+    }
+    return { state: isCanonicalEntry(entry) ? "registered" : "conflict" };
+}
+function inspectPortable(options = {}) {
+    const paths = resolvePortablePaths(options.homeDir ?? options.home);
+    const errors = [];
+    const configCheck = checkDocPath(paths.configPath, {
+        label: "portable MCP configuration",
+        action: "read or write",
+    });
+    if (!configCheck.ok) {
+        return {
+            paths,
+            state: "malformed",
+            legacyPresent: false,
+            error: configCheck.reason,
+            errors: [configCheck.reason],
+        };
+    }
+    let legacyPresent = false;
+    const legacyCheck = checkDocPath(paths.legacyPath, {
+        label: "legacy MCP configuration",
+        action: "read",
+    });
+    if (legacyCheck.ok) {
+        legacyPresent = lstatOrUndefined(legacyCheck.path) !== undefined;
+    }
+    else {
+        errors.push(legacyCheck.reason);
+    }
+    const configStat = lstatOrUndefined(configCheck.path);
+    if (configStat === undefined) {
+        return {
+            paths,
+            state: legacyPresent ? "legacy" : "absent",
+            legacyPresent,
+            errors,
+        };
+    }
+    if (!configStat.isFile()) {
+        const error = `Portable MCP configuration ${paths.configPath} is not a regular file`;
+        return {
+            paths,
+            state: "malformed",
+            legacyPresent,
+            error,
+            errors: [...errors, error],
+        };
+    }
+    let raw;
+    try {
+        raw = fs.readFileSync(configCheck.path, "utf8");
+    }
+    catch (err) {
+        const error = `Cannot read portable MCP configuration ${paths.configPath}: ${err.message}`;
+        return {
+            paths,
+            state: "malformed",
+            legacyPresent,
+            error,
+            errors: [...errors, error],
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const error = `Malformed JSON in ${paths.configPath}: ${err.message}`;
+        return {
+            paths,
+            state: "malformed",
+            legacyPresent,
+            raw,
+            error,
+            errors: [...errors, error],
+        };
+    }
+    const classified = classifyRoot(parsed);
+    if (classified.state === "malformed") {
+        const error = `Malformed portable MCP configuration ${paths.configPath}: ${classified.error}`;
+        return {
+            paths,
+            state: "malformed",
+            legacyPresent,
+            raw,
+            error,
+            errors: [...errors, error],
+        };
+    }
+    const state = classified.state === "absent" && legacyPresent ? "legacy" : classified.state;
+    return {
+        paths,
+        state,
+        legacyPresent,
+        raw,
+        data: parsed,
+        errors,
+    };
+}
+/** Read-only diagnostic used by `muninn setup --status`. */
+export function getPortableStatus(options = {}) {
+    const inspected = inspectPortable(options);
+    return {
+        path: inspected.paths.configPath,
+        legacyPath: inspected.paths.legacyPath,
+        state: inspected.state,
+        legacyPresent: inspected.legacyPresent,
+        changed: false,
+        error: inspected.error,
+        errors: inspected.errors,
+    };
+}
+export function indentFrom(raw) {
+    if (!raw)
+        return "  ";
+    const match = raw.match(/\n([ \t]+)"/);
+    return match?.[1] ?? "  ";
+}
+export function renderConfig(data, raw) {
+    const body = JSON.stringify(data, null, indentFrom(raw));
+    if (raw === undefined)
+        return `${body}\n`;
+    // Preserve the original trailing-newline convention when updating a file.
+    return raw.endsWith("\n") ? `${body}\n` : body;
+}
+function buildUpdatedConfig(data) {
+    const next = { ...data };
+    const currentServers = isPlainObject(data.mcpServers) ? data.mcpServers : {};
+    next.mcpServers = {
+        ...currentServers,
+        muninn: canonicalPortableEntry(),
+    };
+    return next;
+}
+export function safeWriteAtomic(targetPath, content, mode) {
+    const directory = dirname(targetPath);
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const temporaryPath = join(directory, `.${basename(targetPath)}.${process.pid}.${randomBytes(8).toString("hex")}.tmp`);
+    let fd;
+    try {
+        fd = fs.openSync(temporaryPath, "wx", mode);
+        fs.writeFileSync(fd, content, "utf8");
+        // `openSync` honours umask on some platforms; make the intended mode explicit.
+        fs.fchmodSync(fd, mode);
+        fs.fsyncSync(fd);
+        fs.closeSync(fd);
+        fd = undefined;
+        fs.renameSync(temporaryPath, targetPath);
+    }
+    catch (err) {
+        if (fd !== undefined) {
+            try {
+                fs.closeSync(fd);
+            }
+            catch {
+                // ignore cleanup failure
+            }
+        }
+        try {
+            fs.unlinkSync(temporaryPath);
+        }
+        catch {
+            // temporary file may not have been created
+        }
+        throw err;
+    }
+}
+/**
+ * Apply (or, with `dryRun`, only plan) the portable configuration update.
+ *
+ * Returns a structured report. Malformed input and protected paths are reported
+ * as `failed` with `error` set; callers turn that into exit code 1. A conflicting
+ * entry without `--force` is a nonfatal `skipped`.
+ */
+export function setupPortable(options = {}) {
+    const inspected = inspectPortable(options);
+    const dryRun = options.dryRun === true;
+    const base = {
+        path: inspected.paths.configPath,
+        legacyPath: inspected.paths.legacyPath,
+        state: inspected.state,
+        legacyPresent: inspected.legacyPresent,
+        dryRun,
+        errors: inspected.errors,
+    };
+    if (inspected.state === "malformed") {
+        return {
+            ...base,
+            outcome: "failed",
+            changed: false,
+            error: inspected.error,
+        };
+    }
+    // A protected legacy path is still a fatal setup error even though normal
+    // setup never modifies the legacy file.
+    if (inspected.errors.length > 0) {
+        return {
+            ...base,
+            outcome: "failed",
+            changed: false,
+            error: inspected.errors[0],
+        };
+    }
+    if (inspected.state === "registered") {
+        return {
+            ...base,
+            outcome: "present",
+            changed: false,
+        };
+    }
+    if (inspected.state === "conflict" && options.force !== true) {
+        return {
+            ...base,
+            outcome: "skipped",
+            changed: false,
+        };
+    }
+    const updated = buildUpdatedConfig(inspected.data ?? {});
+    const content = renderConfig(updated, inspected.raw);
+    if (dryRun) {
+        return {
+            ...base,
+            outcome: "written",
+            changed: true,
+        };
+    }
+    const configCheck = checkDocPath(inspected.paths.configPath, {
+        label: "portable MCP configuration",
+        action: "write",
+    });
+    if (!configCheck.ok) {
+        return {
+            ...base,
+            outcome: "failed",
+            changed: false,
+            error: configCheck.reason,
+            errors: [...inspected.errors, configCheck.reason],
+        };
+    }
+    // Re-check immediately before writing so a path swapped for a symlink between
+    // inspection and the write is still refused.
+    const existing = lstatOrUndefined(configCheck.path);
+    if (existing?.isSymbolicLink()) {
+        const error = `Portable MCP configuration ${inspected.paths.configPath} is a symlink; refusing to write through it`;
+        return {
+            ...base,
+            outcome: "failed",
+            changed: false,
+            error,
+            errors: [...inspected.errors, error],
+        };
+    }
+    if (existing !== undefined && !existing.isFile()) {
+        const error = `Portable MCP configuration ${inspected.paths.configPath} is not a regular file`;
+        return {
+            ...base,
+            outcome: "failed",
+            changed: false,
+            error,
+            errors: [...inspected.errors, error],
+        };
+    }
+    const mode = existing === undefined ? 0o600 : existing.mode & 0o777;
+    try {
+        safeWriteAtomic(configCheck.path, content, mode);
+    }
+    catch (err) {
+        const error = `Cannot write portable MCP configuration ${inspected.paths.configPath}: ${err.message}`;
+        return {
+            ...base,
+            outcome: "failed",
+            changed: false,
+            error,
+            errors: [...inspected.errors, error],
+        };
+    }
+    return {
+        ...base,
+        outcome: "written",
+        changed: true,
+    };
+}
+//# sourceMappingURL=portable.js.map

package/dist/setup/portable.js.map

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

package/dist/setup/registry.d.ts

@@ -0,0 +1,54 @@
+export type AgentFormat = "mcpServers" | "opencode" | "toml";
+export type AgentId = "cursor" | "claude" | "opencode" | "devin" | "qwen" | "codex" | "agy" | "kimi" | "pi" | "commandcode" | "omp" | "mcode" | "mimo";
+export interface AgentTarget {
+    id: AgentId;
+    label: string;
+    format: AgentFormat;
+    /** Path templates; `{project}`, `{home}` and `{opencodeConfigDir}` expand. */
+    mcpPaths: string[];
+    /** Rules-file path relative to the project root. */
+    rulesFile: string;
+    /**
+     * CLI binary used only for the nonfatal `not installed` diagnostic.
+     * `null` means the target has no meaningful local executable (for example an
+     * IDE or web-hosted agent), so the warning is not applicable.
+     */
+    executable: string | null;
+}
+export interface ResolveMcpPathsOptions {
+    projectPath?: string;
+    homeDir?: string;
+    opencodeConfigDir?: string;
+    env?: Record<string, string | undefined>;
+}
+export declare const AGENT_REGISTRY: Record<AgentId, AgentTarget>;
+export declare const AGENT_IDS: AgentId[];
+/**
+ * Explicit executable name used only for the nonfatal `not installed`
+ * diagnostic. It is intentionally declared per catalog entry and never inferred
+ * from the agent ID or from whether a config file exists. `null` means the
+ * target has no applicable local executable and must not warn.
+ */
+export declare function agentExecutable(id: AgentId): string | null;
+export declare function isAgentId(value: string): value is AgentId;
+/**
+ * Resolve a target's MCP config paths. A nonempty
+ * `MUNINN_AGENT_<ID>_MCP_PATH` replaces the catalog paths; empty segments are
+ * ignored and an override that resolves to no paths is rejected.
+ */
+export declare function resolveMcpPaths(target: AgentId | AgentTarget, options?: ResolveMcpPathsOptions): string[];
+/** Rules path under the selected project root (or the catalog path without one). */
+export declare function resolveRulesPath(target: AgentId | AgentTarget, options?: Pick<ResolveMcpPathsOptions, "projectPath">): string;
+export type AgentSelection = {
+    ok: true;
+    ids: AgentId[];
+} | {
+    ok: false;
+    unknown: string[];
+    valid: AgentId[];
+};
+/** Parse one ID, `all`, or a comma-separated list; deduplicate in catalog order. */
+export declare function parseAgentSelection(value: string): AgentSelection;
+/** True only when `child` is inside (or equal to) `root`, using path.relative. */
+export declare function isProjectContained(child: string, root: string): boolean;
+//# sourceMappingURL=registry.d.ts.map

package/dist/setup/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/setup/registry.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;AAE7D,MAAM,MAAM,OAAO,GACf,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,OAAO,GACP,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,IAAI,GACJ,aAAa,GACb,KAAK,GACL,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,CA6GvD,CAAC;AAEF,eAAO,MAAM,SAAS,EAAkC,OAAO,EAAE,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,CAEzD;AAgDD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,GAAG,WAAW,EAC7B,OAAO,GAAE,sBAA2B,GACnC,MAAM,EAAE,CAgBV;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,OAAO,GAAG,WAAW,EAC7B,OAAO,GAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAM,GACxD,MAAM,CAKR;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,OAAO,EAAE,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AAEvD,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAgBjE;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvE"}

package/dist/setup/registry.js

@@ -0,0 +1,225 @@
+/**
+ * Catalog of supported agent destinations.
+ *
+ * The routes and formats are the Huginn integrator reference's definitions,
+ * reproduced here without importing Huginn. Paths are templates so callers can
+ * inject a home directory, project root, OpenCode config directory, or an
+ * environment override.
+ */
+import { homedir } from "node:os";
+import { isAbsolute, join, normalize, relative, resolve } from "node:path";
+export const AGENT_REGISTRY = {
+    cursor: {
+        id: "cursor",
+        label: "Cursor",
+        format: "mcpServers",
+        mcpPaths: ["{project}/.cursor/mcp.json", "{home}/.cursor/mcp.json"],
+        rulesFile: ".cursorrules",
+        executable: null,
+    },
+    claude: {
+        id: "claude",
+        label: "Claude Code / Desktop",
+        format: "mcpServers",
+        mcpPaths: [
+            "{project}/.mcp.json",
+            "{home}/.claude.json",
+            "{home}/.claude/claude_desktop_config.json",
+        ],
+        rulesFile: "CLAUDE.md",
+        executable: "claude",
+    },
+    opencode: {
+        id: "opencode",
+        label: "OpenCode",
+        format: "opencode",
+        mcpPaths: ["{opencodeConfigDir}/opencode.json"],
+        rulesFile: "AGENTS.md",
+        executable: "opencode",
+    },
+    devin: {
+        id: "devin",
+        label: "Devin",
+        format: "mcpServers",
+        mcpPaths: ["{project}/.devin/mcp_config.json", "{home}/.config/devin/mcp_config.json"],
+        rulesFile: ".windsurf/rules/muninn.md",
+        executable: null,
+    },
+    qwen: {
+        id: "qwen",
+        label: "Qwen Code",
+        format: "mcpServers",
+        mcpPaths: ["{home}/.qwen/settings.json"],
+        rulesFile: "QWEN.md",
+        executable: "qwen",
+    },
+    codex: {
+        id: "codex",
+        label: "OpenAI Codex CLI",
+        format: "toml",
+        mcpPaths: ["{home}/.codex/config.toml"],
+        rulesFile: "AGENTS.md",
+        executable: "codex",
+    },
+    agy: {
+        id: "agy",
+        label: "Antigravity CLI (agy)",
+        format: "mcpServers",
+        mcpPaths: ["{home}/.gemini/config/mcp_config.json", "{project}/.agents/mcp_config.json"],
+        rulesFile: "AGENTS.md",
+        executable: "agy",
+    },
+    kimi: {
+        id: "kimi",
+        label: "Kimi Code CLI",
+        format: "mcpServers",
+        mcpPaths: ["{home}/.kimi-code/mcp.json", "{project}/.kimi/mcp.json"],
+        rulesFile: "AGENTS.md",
+        executable: "kimi",
+    },
+    pi: {
+        id: "pi",
+        label: "Pi coding agent",
+        format: "mcpServers",
+        mcpPaths: ["{home}/.pi/agent/mcp.json", "{project}/.pi/mcp.json"],
+        rulesFile: "AGENTS.md",
+        executable: "pi",
+    },
+    commandcode: {
+        id: "commandcode",
+        label: "Command Code",
+        format: "mcpServers",
+        mcpPaths: ["{home}/.commandcode/mcp.json", "{project}/.mcp.json"],
+        rulesFile: "AGENTS.md",
+        executable: "commandcode",
+    },
+    omp: {
+        id: "omp",
+        label: "Oh My Pi",
+        format: "mcpServers",
+        mcpPaths: ["{home}/.omp/mcp.json", "{project}/.omp/mcp.json"],
+        rulesFile: "AGENTS.md",
+        executable: "omp",
+    },
+    mcode: {
+        id: "mcode",
+        label: "MiniMax Code",
+        format: "mcpServers",
+        mcpPaths: ["{project}/.mcp.json"],
+        rulesFile: "AGENTS.md",
+        executable: "mcode",
+    },
+    mimo: {
+        id: "mimo",
+        label: "MiMo Code",
+        format: "opencode",
+        mcpPaths: ["{home}/.config/mimocode/mimocode.json"],
+        rulesFile: "AGENTS.md",
+        executable: "mimo",
+    },
+};
+export const AGENT_IDS = Object.keys(AGENT_REGISTRY);
+/**
+ * Explicit executable name used only for the nonfatal `not installed`
+ * diagnostic. It is intentionally declared per catalog entry and never inferred
+ * from the agent ID or from whether a config file exists. `null` means the
+ * target has no applicable local executable and must not warn.
+ */
+export function agentExecutable(id) {
+    return AGENT_REGISTRY[id].executable;
+}
+export function isAgentId(value) {
+    return Object.prototype.hasOwnProperty.call(AGENT_REGISTRY, value);
+}
+function envFor(options) {
+    return options.env ?? process.env;
+}
+function opencodeConfigDirFor(options) {
+    if (options.opencodeConfigDir)
+        return resolve(options.opencodeConfigDir);
+    const env = envFor(options);
+    const fromEnv = env.MUNINN_OPENCODE_CONFIG_DIR ?? env.HUGINN_OPENCODE_CONFIG_DIR;
+    if (fromEnv && fromEnv.trim().length > 0)
+        return resolve(fromEnv);
+    return join(options.homeDir ?? homedir(), ".config", "opencode");
+}
+function expandTemplate(template, options) {
+    const homeDir = options.homeDir ?? homedir();
+    const projectPath = options.projectPath === undefined ? undefined : resolve(options.projectPath);
+    let expanded = template
+        .replaceAll("{home}", homeDir)
+        .replaceAll("{opencodeConfigDir}", opencodeConfigDirFor(options));
+    if (projectPath !== undefined)
+        expanded = expanded.replaceAll("{project}", projectPath);
+    return normalize(expanded);
+}
+/**
+ * Split a colon-separated override without breaking a Windows drive letter
+ * (`C:\path:D:\path`). Empty segments are ignored.
+ */
+function splitOverride(value) {
+    const raw = value.split(":");
+    const out = [];
+    for (let i = 0; i < raw.length; i++) {
+        const entry = raw[i];
+        if (/^[A-Za-z]$/.test(entry) && i + 1 < raw.length) {
+            const next = raw[i + 1];
+            if (next.startsWith("\\") || next.startsWith("/")) {
+                out.push(`${entry}:${next}`);
+                i++;
+                continue;
+            }
+        }
+        out.push(entry);
+    }
+    return out.map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+}
+/**
+ * Resolve a target's MCP config paths. A nonempty
+ * `MUNINN_AGENT_<ID>_MCP_PATH` replaces the catalog paths; empty segments are
+ * ignored and an override that resolves to no paths is rejected.
+ */
+export function resolveMcpPaths(target, options = {}) {
+    const spec = typeof target === "string" ? AGENT_REGISTRY[target] : target;
+    const env = envFor(options);
+    const override = env[`MUNINN_AGENT_${spec.id.toUpperCase()}_MCP_PATH`] ??
+        env[`HUGINN_AGENT_${spec.id.toUpperCase()}_MCP_PATH`];
+    const templates = override !== undefined && override.trim().length > 0
+        ? splitOverride(override)
+        : spec.mcpPaths;
+    if (templates.length === 0) {
+        throw new Error(`MUNINN_AGENT_${spec.id.toUpperCase()}_MCP_PATH contains no usable paths`);
+    }
+    return templates.map((template) => expandTemplate(template, options));
+}
+/** Rules path under the selected project root (or the catalog path without one). */
+export function resolveRulesPath(target, options = {}) {
+    const spec = typeof target === "string" ? AGENT_REGISTRY[target] : target;
+    return options.projectPath === undefined
+        ? spec.rulesFile
+        : normalize(join(resolve(options.projectPath), spec.rulesFile));
+}
+/** Parse one ID, `all`, or a comma-separated list; deduplicate in catalog order. */
+export function parseAgentSelection(value) {
+    const requested = value
+        .split(",")
+        .map((entry) => entry.trim().toLowerCase())
+        .filter((entry) => entry.length > 0);
+    if (requested.length === 0) {
+        return { ok: false, unknown: [value.trim() || "<empty>"], valid: [...AGENT_IDS] };
+    }
+    const unknown = requested.filter((entry) => entry !== "all" && !isAgentId(entry));
+    if (unknown.length > 0) {
+        return { ok: false, unknown: [...new Set(unknown)], valid: [...AGENT_IDS] };
+    }
+    if (requested.includes("all")) {
+        return { ok: true, ids: [...AGENT_IDS] };
+    }
+    return { ok: true, ids: AGENT_IDS.filter((id) => requested.includes(id)) };
+}
+/** True only when `child` is inside (or equal to) `root`, using path.relative. */
+export function isProjectContained(child, root) {
+    const rel = relative(resolve(root), resolve(child));
+    return rel === "" || (rel !== ".." && !rel.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) && !isAbsolute(rel));
+}
+//# sourceMappingURL=registry.js.map