plexus-agent-config 0.0.1

package/node_modules/plexus-agent-config-core/dist/agents/adapters/json-mcp.js

@@ -0,0 +1,182 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { AGENT_PATHS, PLEXUS_PATHS } from "../../store/paths.js";
+import { emptyResult, ensureDir, placeFileSymlink, placeLinkOrCopy, } from "./base.js";
+/**
+ * Generic JSON-MCP + skill-directory adapter.
+ *
+ * Used by Claude Code, Cursor, Gemini CLI, Qwen Code, Factory Droid (and any future agent that
+ * stores MCP as `{ "mcpServers": {...} }` JSON and skills as a directory).
+ *
+ * Two MCP write modes (chosen by AGENT_PATHS[agent].mcpFileMode):
+ *
+ *  - "exclusive": Plexus owns the agent's MCP file. We render a canonical
+ *    JSON to ~/.config/plexus/.cache/mcp/<agent>.json and symlink the
+ *    agent's path to that cache. Editing the agent's path is editing the
+ *    same Plexus-owned file. This is appropriate for agents whose MCP
+ *    file holds nothing else (Cursor, Factory Droid).
+ *
+ *  - "shared" (default): the agent's file holds many other unrelated keys
+ *    (for example Claude Code's ~/.claude.json carries auth/history/settings). We
+ *    partial-write only the `mcpServers` section in place and never replace
+ *    the whole file.
+ *
+ * Skills are always symlink-first via placeLinkOrCopy.
+ */
+export function makeJsonMcpAdapter(agentId) {
+    return {
+        id: agentId,
+        async apply(ctx) {
+            const result = emptyResult(agentId);
+            const caps = AGENT_PATHS[agentId];
+            // ── MCP ─────────────────────────────────────────────
+            if (caps.mcp) {
+                const mode = caps.mcpFileMode ?? "shared";
+                try {
+                    await ensureDir(path.dirname(caps.mcpPath));
+                    const enabledForAgent = ctx.mcp.filter((s) => s.enabledAgents.includes(agentId));
+                    if (mode === "exclusive") {
+                        await writeExclusive(agentId, ctx.mcp, enabledForAgent, ctx.syncStrategy);
+                    }
+                    else {
+                        await writeShared(caps.mcpPath, ctx.mcp, enabledForAgent);
+                    }
+                    result.applied.mcp = enabledForAgent.length;
+                }
+                catch (err) {
+                    result.errors.push(`MCP write failed: ${err.message}`);
+                }
+            }
+            // ── Skills ──────────────────────────────────────────
+            if (caps.skills) {
+                try {
+                    await ensureDir(caps.skillsDir);
+                    const filtered = ctx.skills.filter((s) => s.enabledAgents.includes(agentId));
+                    const disabledManagedSkillIds = new Set(ctx.skills.filter((s) => !s.enabledAgents.includes(agentId)).map((s) => s.id));
+                    // Remove Plexus-managed skill dirs that are now disabled for this agent.
+                    for (const id of disabledManagedSkillIds) {
+                        const dir = path.join(caps.skillsDir, id);
+                        await safeRemoveDir(dir);
+                    }
+                    for (const skill of filtered) {
+                        const sourcePath = ctx.skillSourcePaths.get(skill.id);
+                        if (!sourcePath) {
+                            result.warnings.push(`No source path for skill: ${skill.id}`);
+                            continue;
+                        }
+                        const destDir = path.join(caps.skillsDir, skill.id);
+                        try {
+                            await placeLinkOrCopy(sourcePath, destDir, ctx.syncStrategy);
+                            result.applied.skills += 1;
+                        }
+                        catch (err) {
+                            result.errors.push(`Skill ${skill.id} sync failed: ${err.message}`);
+                        }
+                    }
+                }
+                catch (err) {
+                    result.errors.push(`Skills sync failed: ${err.message}`);
+                }
+            }
+            return result;
+        },
+    };
+}
+/**
+ * Symlink-safe directory removal. fs.rm(recursive) on a symlink behaves
+ * inconsistently across OS versions — explicitly handle the symlink case
+ * by unlinking the link itself, never the target.
+ */
+async function safeRemoveDir(p) {
+    try {
+        const lst = await fs.lstat(p);
+        if (lst.isSymbolicLink()) {
+            await fs.unlink(p);
+        }
+        else {
+            await fs.rm(p, { recursive: true, force: true });
+        }
+    }
+    catch {
+        // best-effort
+    }
+}
+/** Partial-write: rewrite mcpServers section only, preserve everything else. */
+async function writeShared(filePath, managed, enabledForAgent) {
+    const enabledIds = new Set(enabledForAgent.map((s) => s.id));
+    const allManagedIds = new Set(managed.map((s) => s.id));
+    let existing = {};
+    try {
+        const raw = await fs.readFile(filePath, "utf8");
+        existing = JSON.parse(raw);
+    }
+    catch {
+        // first write
+    }
+    const existingMcp = existing.mcpServers ?? {};
+    // Preserve user-added (ids Plexus does not manage) and drop ones we now disown.
+    const preserved = {};
+    for (const [k, v] of Object.entries(existingMcp)) {
+        if (allManagedIds.has(k))
+            continue; // either re-written below or removed
+        preserved[k] = v;
+    }
+    const written = { ...preserved };
+    for (const s of enabledForAgent) {
+        written[s.id] = serializeMcp(s);
+    }
+    void enabledIds;
+    const merged = { ...existing, mcpServers: written };
+    await fs.writeFile(filePath, JSON.stringify(merged, null, 2), "utf8");
+}
+/**
+ * Exclusive: Plexus owns the file. Render canonical to .cache/mcp/<agent>.json,
+ * symlink agent path to it. We still preserve user-added entries by reading
+ * the agent's current file first (resolving through the symlink).
+ */
+async function writeExclusive(agentId, managed, enabledForAgent, syncStrategy) {
+    const caps = AGENT_PATHS[agentId];
+    await ensureDir(PLEXUS_PATHS.mcpCache);
+    const cacheFile = path.join(PLEXUS_PATHS.mcpCache, `${agentId}.json`);
+    const allManagedIds = new Set(managed.map((s) => s.id));
+    // Read current content (could be the agent's old regular file, or our
+    // existing cache via the symlink — either way, fs.readFile follows links).
+    let existing = {};
+    try {
+        const raw = await fs.readFile(caps.mcpPath, "utf8");
+        existing = JSON.parse(raw);
+    }
+    catch {
+        // first sync — fine
+    }
+    const existingMcp = existing.mcpServers ?? {};
+    const preserved = {};
+    for (const [k, v] of Object.entries(existingMcp)) {
+        if (allManagedIds.has(k))
+            continue;
+        preserved[k] = v;
+    }
+    const written = { ...preserved };
+    for (const s of enabledForAgent) {
+        written[s.id] = serializeMcp(s);
+    }
+    // For exclusive files we deliberately drop any non-mcpServers keys —
+    // by definition the file is dedicated to MCP config.
+    const canonical = { mcpServers: written };
+    await fs.writeFile(cacheFile, JSON.stringify(canonical, null, 2), "utf8");
+    // Now symlink the agent's path to the cache file. If the agent's file
+    // already points here, this is a no-op. Otherwise it's removed and
+    // replaced (caller has already snapshotted via the backup module).
+    await placeFileSymlink(cacheFile, caps.mcpPath, syncStrategy);
+}
+function serializeMcp(s) {
+    return {
+        ...(s.command ? { command: s.command } : {}),
+        ...(s.args ? { args: s.args } : {}),
+        ...(s.env ? { env: s.env } : {}),
+        ...(s.url ? { url: s.url } : {}),
+        ...(s.httpUrl ? { httpUrl: s.httpUrl } : {}),
+        ...(s.headers ? { headers: s.headers } : {}),
+    };
+}
+//# sourceMappingURL=json-mcp.js.map

package/node_modules/plexus-agent-config-core/dist/agents/adapters/json-mcp.js.map

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

package/node_modules/plexus-agent-config-core/dist/agents/catalog.d.ts

@@ -0,0 +1,15 @@
+export type AgentCatalogSupport = "full" | "instructions-only" | "manual";
+export interface AgentCatalogEntry {
+    id: string;
+    displayName: string;
+    support: AgentCatalogSupport;
+    managed: boolean;
+    installed: boolean;
+    rootDir?: string;
+    instructionFile?: string;
+    mcpPath?: string;
+    skillsDir?: string;
+    note: string;
+}
+export declare function listAgentCatalog(): AgentCatalogEntry[];
+//# sourceMappingURL=catalog.d.ts.map

package/node_modules/plexus-agent-config-core/dist/agents/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/agents/catalog.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,mBAAmB,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAsID,wBAAgB,gBAAgB,IAAI,iBAAiB,EAAE,CAsBtD"}

package/node_modules/plexus-agent-config-core/dist/agents/catalog.js

@@ -0,0 +1,153 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { AGENT_DISPLAY_NAMES, AGENT_PATHS, AGENT_ROOTS, ALL_AGENTS } from "../store/paths.js";
+import { isAgentInstalled } from "./detect.js";
+const home = os.homedir();
+function exists(p) {
+    return p ? fs.existsSync(p) : false;
+}
+function vscodeUserDir() {
+    if (process.platform === "darwin") {
+        return path.join(home, "Library", "Application Support", "Code", "User");
+    }
+    if (process.platform === "win32") {
+        return path.join(process.env.APPDATA ?? home, "Code", "User");
+    }
+    return path.join(home, ".config", "Code", "User");
+}
+function globalStorageDir(extensionId) {
+    return path.join(vscodeUserDir(), "globalStorage", extensionId);
+}
+function zedUserDir() {
+    if (process.platform === "darwin") {
+        return path.join(home, "Library", "Application Support", "Zed");
+    }
+    return path.join(home, ".config", "zed");
+}
+const MANUAL_PRESETS = [
+    {
+        id: "windsurf",
+        displayName: "Windsurf Cascade",
+        support: "manual",
+        managed: false,
+        rootDir: path.join(home, ".codeium", "windsurf"),
+        mcpPath: path.join(home, ".codeium", "windsurf", "mcp_config.json"),
+        instructionFile: path.join(home, ".codeium", "windsurf", "AGENTS.md"),
+        note: "Catalog only for now. Windsurf uses its own Rules surface; add as custom if you want Plexus to track one instruction file.",
+    },
+    {
+        id: "kiro",
+        displayName: "Kiro",
+        support: "manual",
+        managed: false,
+        rootDir: path.join(home, ".kiro"),
+        mcpPath: path.join(home, ".kiro", "settings", "mcp.json"),
+        instructionFile: path.join(home, ".kiro", "steering", "plexus.md"),
+        note: "Catalog only for now. Kiro has user-level MCP and steering files, but Plexus does not write them yet.",
+    },
+    {
+        id: "vscode-copilot",
+        displayName: "VS Code / GitHub Copilot",
+        support: "manual",
+        managed: false,
+        rootDir: vscodeUserDir(),
+        mcpPath: path.join(vscodeUserDir(), "mcp.json"),
+        instructionFile: path.join(vscodeUserDir(), "AGENTS.md"),
+        note: "VS Code stores user MCP separately from repo instructions. Add as custom if you keep a user instruction file.",
+    },
+    {
+        id: "cline",
+        displayName: "Cline",
+        support: "manual",
+        managed: false,
+        rootDir: globalStorageDir("saoudrizwan.claude-dev"),
+        instructionFile: path.join(globalStorageDir("saoudrizwan.claude-dev"), "AGENTS.md"),
+        note: "VS Code extension storage varies by editor profile; use custom paths if yours differs.",
+    },
+    {
+        id: "roo-code",
+        displayName: "Roo Code",
+        support: "manual",
+        managed: false,
+        rootDir: globalStorageDir("rooveterinaryinc.roo-cline"),
+        instructionFile: path.join(globalStorageDir("rooveterinaryinc.roo-cline"), "AGENTS.md"),
+        note: "VS Code extension storage varies by editor profile; use custom paths if yours differs.",
+    },
+    {
+        id: "kilo-code",
+        displayName: "Kilo Code",
+        support: "manual",
+        managed: false,
+        rootDir: path.join(home, ".config", "kilo"),
+        mcpPath: path.join(home, ".config", "kilo", "kilo.jsonc"),
+        instructionFile: path.join(home, ".config", "kilo", "AGENTS.md"),
+        note: "Kilo uses JSONC and extension/project scopes; catalog entry is manual until Plexus can round-trip JSONC.",
+    },
+    {
+        id: "continue",
+        displayName: "Continue",
+        support: "manual",
+        managed: false,
+        rootDir: path.join(home, ".continue"),
+        instructionFile: path.join(home, ".continue", "AGENTS.md"),
+        note: "Continue configuration is flexible and often project-specific; add a custom instruction file if you use one.",
+    },
+    {
+        id: "aider",
+        displayName: "Aider",
+        support: "instructions-only",
+        managed: false,
+        instructionFile: path.join(home, ".aider.conf.yml"),
+        note: "Aider is config-file based. Plexus can track a file, but does not translate MCP or skills for Aider.",
+    },
+    {
+        id: "amp",
+        displayName: "Amp",
+        support: "manual",
+        managed: false,
+        rootDir: path.join(home, ".config", "amp"),
+        instructionFile: path.join(home, ".config", "amp", "AGENTS.md"),
+        note: "Amp supports agent instruction files, but local config layout can vary.",
+    },
+    {
+        id: "openhands",
+        displayName: "OpenHands",
+        support: "manual",
+        managed: false,
+        rootDir: path.join(home, ".openhands"),
+        instructionFile: path.join(home, ".openhands", "AGENTS.md"),
+        note: "OpenHands is usually project/container configured. Use custom paths for your local setup.",
+    },
+    {
+        id: "zed-ai",
+        displayName: "Zed AI",
+        support: "manual",
+        managed: false,
+        rootDir: zedUserDir(),
+        instructionFile: path.join(zedUserDir(), "AGENTS.md"),
+        note: "Catalog only. Zed and extension settings vary across platforms.",
+    },
+];
+export function listAgentCatalog() {
+    const builtIn = ALL_AGENTS.map((id) => {
+        const caps = AGENT_PATHS[id];
+        return {
+            id,
+            displayName: AGENT_DISPLAY_NAMES[id],
+            support: "full",
+            managed: true,
+            installed: isAgentInstalled(id),
+            rootDir: AGENT_ROOTS[id],
+            mcpPath: caps.mcpPath,
+            skillsDir: caps.skillsDir,
+            note: "Built-in adapter. Plexus can sync Rules, MCP servers, and Skills.",
+        };
+    });
+    const manual = MANUAL_PRESETS.map((entry) => ({
+        ...entry,
+        installed: exists(entry.mcpPath) || exists(entry.instructionFile),
+    }));
+    return [...builtIn, ...manual];
+}
+//# sourceMappingURL=catalog.js.map

package/node_modules/plexus-agent-config-core/dist/agents/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/agents/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAiB/C,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;AAE1B,SAAS,MAAM,CAAC,CAAU;IACxB,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACtC,CAAC;AAED,SAAS,aAAa;IACpB,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,cAAc,GAAgD;IAClE;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC;QAChD,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC;QACnE,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC;QACrE,IAAI,EAAE,4HAA4H;KACnI;IACD;QACE,EAAE,EAAE,MAAM;QACV,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;QACjC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC;QACzD,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC;QAClE,IAAI,EAAE,uGAAuG;KAC9G;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,aAAa,EAAE;QACxB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,UAAU,CAAC;QAC/C,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,WAAW,CAAC;QACxD,IAAI,EAAE,+GAA+G;KACtH;IACD;QACE,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,gBAAgB,CAAC,wBAAwB,CAAC;QACnD,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,EAAE,WAAW,CAAC;QACnF,IAAI,EAAE,wFAAwF;KAC/F;IACD;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,UAAU;QACvB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,gBAAgB,CAAC,4BAA4B,CAAC;QACvD,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,4BAA4B,CAAC,EAAE,WAAW,CAAC;QACvF,IAAI,EAAE,wFAAwF;KAC/F;IACD;QACE,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,WAAW;QACxB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC;QAC3C,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC;QACzD,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC;QAChE,IAAI,EAAE,0GAA0G;KACjH;IACD;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,UAAU;QACvB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QACrC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC;QAC1D,IAAI,EAAE,8GAA8G;KACrH;IACD;QACE,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,mBAAmB;QAC5B,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC;QACnD,IAAI,EAAE,sGAAsG;KAC7G;IACD;QACE,EAAE,EAAE,KAAK;QACT,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC;QAC1C,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC;QAC/D,IAAI,EAAE,yEAAyE;KAChF;IACD;QACE,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,WAAW;QACxB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;QACtC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,CAAC;QAC3D,IAAI,EAAE,2FAA2F;KAClG;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,UAAU,EAAE;QACrB,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,WAAW,CAAC;QACrD,IAAI,EAAE,iEAAiE;KACxE;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAqB,EAAE;QACvD,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAC7B,OAAO;YACL,EAAE;YACF,WAAW,EAAE,mBAAmB,CAAC,EAAE,CAAC;YACpC,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,gBAAgB,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,mEAAmE;SAC1E,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5C,GAAG,KAAK;QACR,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC;KAClE,CAAC,CAAC,CAAC;IAEJ,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;AACjC,CAAC"}

package/node_modules/plexus-agent-config-core/dist/agents/detect.d.ts

@@ -0,0 +1,14 @@
+import type { AgentDescriptor, AgentId } from "../types.js";
+/**
+ * Detect which AI agents appear to be installed.
+ *
+ * Heuristic: any durable local signal exists:
+ * - native config root / MCP file / skill directory
+ * - known macOS app bundle for GUI-first agents
+ * - known CLI shim on PATH
+ *
+ * We never execute the agent binary; PATH checks only inspect file metadata.
+ */
+export declare function detectAgents(): AgentDescriptor[];
+export declare function isAgentInstalled(id: AgentId): boolean;
+//# sourceMappingURL=detect.d.ts.map

package/node_modules/plexus-agent-config-core/dist/agents/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/agents/detect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,eAAe,EAAE,CAQhD;AAqCD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAOrD"}

package/node_modules/plexus-agent-config-core/dist/agents/detect.js

@@ -0,0 +1,92 @@
+import { constants, accessSync, existsSync, statSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { AGENT_DISPLAY_NAMES, AGENT_PATHS, AGENT_ROOTS, ALL_AGENTS } from "../store/paths.js";
+/**
+ * Detect which AI agents appear to be installed.
+ *
+ * Heuristic: any durable local signal exists:
+ * - native config root / MCP file / skill directory
+ * - known macOS app bundle for GUI-first agents
+ * - known CLI shim on PATH
+ *
+ * We never execute the agent binary; PATH checks only inspect file metadata.
+ */
+export function detectAgents() {
+    return ALL_AGENTS.map((id) => ({
+        id,
+        displayName: AGENT_DISPLAY_NAMES[id],
+        rootDir: AGENT_ROOTS[id],
+        installed: isAgentInstalled(id),
+        capabilities: AGENT_PATHS[id],
+    }));
+}
+const home = os.homedir();
+const APP_PATH_HINTS = {
+    "claude-code": [],
+    cursor: process.platform === "darwin"
+        ? ["/Applications/Cursor.app", path.join(home, "Applications", "Cursor.app")]
+        : [],
+    codex: process.platform === "darwin"
+        ? ["/Applications/Codex.app", path.join(home, "Applications", "Codex.app")]
+        : [],
+    "gemini-cli": [],
+    "qwen-code": [],
+    "factory-droid": [],
+};
+const COMMAND_HINTS = {
+    "claude-code": ["claude"],
+    cursor: ["cursor"],
+    codex: ["codex"],
+    "gemini-cli": ["gemini"],
+    "qwen-code": ["qwen"],
+    "factory-droid": ["factory-droid", "droid"],
+};
+function metadataPathHints(id) {
+    const caps = AGENT_PATHS[id];
+    return [AGENT_ROOTS[id], caps.mcpPath, caps.skillsDir];
+}
+function useConfigOnlyDetection() {
+    return process.env.PLEXUS_DETECT_CONFIG_ONLY === "1";
+}
+export function isAgentInstalled(id) {
+    if (useConfigOnlyDetection()) {
+        return metadataPathHints(id).some((p) => existsSync(p));
+    }
+    if (APP_PATH_HINTS[id].some((p) => existsSync(p)))
+        return true;
+    return COMMAND_HINTS[id].some((cmd) => commandExistsOnPath(cmd));
+}
+function commandExistsOnPath(command) {
+    const pathValue = process.env.PATH;
+    if (!pathValue)
+        return false;
+    const extensions = process.platform === "win32" ? (process.env.PATHEXT ?? ".EXE;.CMD;.BAT;.COM").split(";") : [""];
+    for (const dir of pathValue.split(path.delimiter)) {
+        if (!dir)
+            continue;
+        for (const ext of extensions) {
+            const candidate = path.join(dir, `${command}${ext}`);
+            try {
+                const stat = statSync(candidate);
+                if (stat.isFile()) {
+                    return process.platform === "win32" || canExecute(candidate);
+                }
+            }
+            catch {
+                // keep scanning PATH
+            }
+        }
+    }
+    return false;
+}
+function canExecute(candidate) {
+    try {
+        accessSync(candidate, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=detect.js.map

package/node_modules/plexus-agent-config-core/dist/agents/detect.js.map

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

package/node_modules/plexus-agent-config-core/dist/agents/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./detect.js";
+export * from "./catalog.js";
+export * from "./adapters/index.js";
+export * from "./inspect.js";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/plexus-agent-config-core/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}

package/node_modules/plexus-agent-config-core/dist/agents/index.js

@@ -0,0 +1,5 @@
+export * from "./detect.js";
+export * from "./catalog.js";
+export * from "./adapters/index.js";
+export * from "./inspect.js";
+//# sourceMappingURL=index.js.map

package/node_modules/plexus-agent-config-core/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}

package/node_modules/plexus-agent-config-core/dist/agents/inspect.d.ts

@@ -0,0 +1,74 @@
+import type { AgentId } from "../types.js";
+/**
+ * "Agent inspector": everything the dashboard needs to render the
+ * /agents/<id> detail page in one read.
+ *
+ * Returns enough context for the UI to:
+ *  - Show whether the MCP file is a Plexus symlink, a regular file, or
+ *    missing entirely. If a symlink, where it points.
+ *  - List the skill folders the agent currently exposes, with whether
+ *    each one is symlinked or a real directory (i.e. "still owned by the
+ *    agent" vs "managed by Plexus").
+ *  - Surface "instruction" files Plexus does NOT yet manage but which
+ *    users commonly hand-edit:
+ *       Claude Code → ~/.claude/CLAUDE.md
+ *       Cursor       → ~/.cursor/AGENTS.md (and per-project .cursorrules)
+ *       Codex        → ~/.codex/AGENTS.md
+ *       Gemini CLI  → ~/.gemini/GEMINI.md
+ *       Qwen Code   → ~/.qwen/QWEN.md
+ *       Factory Droid → ~/.factory/AGENTS.md (if user keeps one)
+ *    These are simple read/write so the dashboard can offer a textarea.
+ */
+export interface FileStatus {
+    path: string;
+    exists: boolean;
+    isSymlink: boolean;
+    /** If symlink, the resolved target path. */
+    linkTarget?: string;
+    /** Size in bytes (resolved through any symlink). */
+    size?: number;
+    /** Last modification time. */
+    mtime?: string;
+}
+export interface SkillEntry {
+    id: string;
+    /** Path in the agent's skills directory. */
+    path: string;
+    isSymlink: boolean;
+    linkTarget?: string;
+    /** Whether SKILL.md exists inside. */
+    hasSkillMd: boolean;
+}
+export interface InstructionFile {
+    /** Display label shown in the UI. */
+    label: string;
+    /** Convention (e.g. "CLAUDE.md", "AGENTS.md"). */
+    filename: string;
+    status: FileStatus;
+}
+export interface AgentInspection {
+    id: AgentId;
+    displayName: string;
+    rootDir: string;
+    installed: boolean;
+    mcpFile: FileStatus;
+    /** "exclusive" → Plexus owns the whole file; "shared" → partial-write. */
+    mcpFileMode: "exclusive" | "shared";
+    /** Agent skill directory (if any). */
+    skillsDir: FileStatus;
+    /** Per-skill folder entries. */
+    skills: SkillEntry[];
+    /** Instruction files the user might want to edit. */
+    instructionFiles: InstructionFile[];
+}
+export declare function instructionsForAgent(agentId: AgentId): Array<{
+    label: string;
+    filename: string;
+    abs: string;
+}>;
+export declare function inspectAgent(agentId: AgentId): Promise<AgentInspection>;
+/** Read a file (small text; the UI only enables editing for instruction files & SKILL.md). */
+export declare function readTextFile(absPath: string): Promise<string>;
+/** Write a file, creating parent dir as needed. (Caller is responsible for backup if it cares.) */
+export declare function writeTextFile(absPath: string, content: string): Promise<void>;
+//# sourceMappingURL=inspect.d.ts.map

package/node_modules/plexus-agent-config-core/dist/agents/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/agents/inspect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;IACpB,0EAA0E;IAC1E,WAAW,EAAE,WAAW,GAAG,QAAQ,CAAC;IACpC,sCAAsC;IACtC,SAAS,EAAE,UAAU,CAAC;IACtB,gCAAgC;IAChC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,qDAAqD;IACrD,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC;AAoED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,GACf,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAoDzD;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CA+B7E;AAED,8FAA8F;AAC9F,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAED,mGAAmG;AACnG,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF"}