nomoreide 0.1.68 → 0.1.70

package/dist/core/agent-env/plugin-reader.js

@@ -0,0 +1,174 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import path from "node:path";
+/** Marketplace plugins from Claude's `~/.claude/plugins/installed_plugins.json`. */
+export async function readInstalledPlugins(installedPluginsPath) {
+    const source = await readFile(installedPluginsPath, "utf8");
+    const data = JSON.parse(source);
+    const results = [];
+    for (const [key, records] of Object.entries(data.plugins ?? {})) {
+        const [name, pluginSource] = key.split("@");
+        const installPath = records[0]?.installPath;
+        const pluginSkills = installPath ? await readPluginSkills(installPath) : [];
+        const pluginMcps = installPath ? await readPluginMcpKeys(installPath) : [];
+        const pluginAgents = installPath ? await readPluginAgentNames(installPath) : [];
+        const pluginCommands = installPath ? await readPluginCommandNames(installPath) : [];
+        results.push({
+            name,
+            source: pluginSource,
+            kind: "plugin",
+            scope: "user",
+            installPath,
+            pluginSkills,
+            ...(pluginMcps.length > 0 ? { pluginMcps } : {}),
+            ...(pluginAgents.length > 0 ? { pluginAgents } : {}),
+            ...(pluginCommands.length > 0 ? { pluginCommands } : {}),
+        });
+    }
+    return results;
+}
+/** Enabled Codex plugins declared in config.toml and materialized in the plugins cache. */
+export async function readCodexPlugins(options) {
+    let tomlSource;
+    try {
+        tomlSource = await readFile(options.configTomlPath, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    for (const { name, marketplace, enabled } of parseCodexPluginDeclarations(tomlSource)) {
+        if (!enabled)
+            continue;
+        const installPath = await resolveCodexPluginInstallPath({
+            pluginsCacheDir: options.pluginsCacheDir,
+            marketplace,
+            name,
+        });
+        if (!installPath)
+            continue;
+        const pluginSkills = await readPluginSkills(installPath);
+        const pluginMcps = await readPluginMcpKeys(installPath);
+        const pluginAgents = await readPluginAgentNames(installPath);
+        const pluginCommands = await readPluginCommandNames(installPath);
+        entries.push({
+            name,
+            source: marketplace,
+            kind: "plugin",
+            scope: "user",
+            installPath,
+            pluginSkills,
+            ...(pluginMcps.length > 0 ? { pluginMcps } : {}),
+            ...(pluginAgents.length > 0 ? { pluginAgents } : {}),
+            ...(pluginCommands.length > 0 ? { pluginCommands } : {}),
+        });
+    }
+    return entries.sort((left, right) => left.name.localeCompare(right.name));
+}
+function parseCodexPluginDeclarations(source) {
+    const results = [];
+    const lines = source.split("\n");
+    let current = null;
+    const flush = () => {
+        if (current) {
+            results.push(current);
+            current = null;
+        }
+    };
+    for (const line of lines) {
+        const trimmed = line.trim();
+        const sectionMatch = trimmed.match(/^\[plugins\."([^"@]+)@([^"]+)"\]$/);
+        if (sectionMatch) {
+            flush();
+            current = { name: sectionMatch[1], marketplace: sectionMatch[2], enabled: false };
+            continue;
+        }
+        if (/^\[/.test(trimmed)) {
+            flush();
+            continue;
+        }
+        if (!current)
+            continue;
+        const kv = trimmed.match(/^(\w+)\s*=\s*(.+)$/);
+        if (kv && kv[1] === "enabled") {
+            current.enabled = kv[2].trim() === "true";
+        }
+    }
+    flush();
+    return results;
+}
+async function resolveCodexPluginInstallPath(options) {
+    const pluginRoot = path.join(options.pluginsCacheDir, options.marketplace, options.name);
+    let versionDirs;
+    try {
+        const entries = await readdir(pluginRoot, { withFileTypes: true });
+        versionDirs = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+    }
+    catch {
+        return null;
+    }
+    if (versionDirs.length === 0)
+        return null;
+    if (versionDirs.length === 1)
+        return path.join(pluginRoot, versionDirs[0]);
+    const stats = await Promise.all(versionDirs.map(async (dir) => {
+        try {
+            const info = await stat(path.join(pluginRoot, dir));
+            return { dir, mtime: info.mtimeMs };
+        }
+        catch {
+            return { dir, mtime: 0 };
+        }
+    }));
+    stats.sort((left, right) => right.mtime - left.mtime);
+    return path.join(pluginRoot, stats[0].dir);
+}
+async function readPluginSkills(installPath) {
+    try {
+        const entries = await readdir(path.join(installPath, "skills"), { withFileTypes: true });
+        return entries
+            .filter((entry) => !entry.name.startsWith(".") && entry.isDirectory())
+            .map((entry) => entry.name)
+            .sort((left, right) => left.localeCompare(right));
+    }
+    catch {
+        return [];
+    }
+}
+async function readPluginAgentNames(installPath) {
+    try {
+        const entries = await readdir(path.join(installPath, "agents"), { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isFile() && (entry.name.endsWith(".md") || entry.name.endsWith(".toml")))
+            .map((entry) => entry.name.replace(/\.(md|toml)$/, ""))
+            .sort((left, right) => left.localeCompare(right));
+    }
+    catch {
+        return [];
+    }
+}
+async function readPluginCommandNames(installPath) {
+    try {
+        const entries = await readdir(path.join(installPath, "commands"), { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
+            .map((entry) => entry.name.replace(/\.md$/, ""))
+            .sort((left, right) => left.localeCompare(right));
+    }
+    catch {
+        return [];
+    }
+}
+export async function readPluginMcpKeys(installPath) {
+    try {
+        const source = await readFile(path.join(installPath, ".mcp.json"), "utf8");
+        const parsed = JSON.parse(source);
+        const servers = parsed.mcpServers && typeof parsed.mcpServers === "object" && !Array.isArray(parsed.mcpServers)
+            ? parsed.mcpServers
+            : parsed;
+        return Object.keys(servers).sort((left, right) => left.localeCompare(right));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=plugin-reader.js.map

package/dist/core/agent-env/plugin-reader.js.map

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

package/dist/core/agent-env/shared.d.ts

@@ -0,0 +1,25 @@
+import type { AgentMcpEntry, AgentSkillEntry, RemoteMcpEntry } from "./types.js";
+export declare function parseEnvObject(value: unknown): Record<string, string> | undefined;
+/** Read skill directories (Claude, Codex, and Antigravity share the SKILL.md dir convention). */
+export declare function readSkillDirs(skillsDir: string, scope?: "user" | "project"): Promise<AgentSkillEntry[]>;
+/**
+ * Walk from `cwd` up to the repo root (first ancestor containing `.git`, or
+ * the filesystem root) and emit skills declared in `<ancestor>/.claude/skills/`
+ * with `scope: "project"`. Only Claude reads project-scoped skills; the closer
+ * ancestor wins on name collisions.
+ */
+export declare function readProjectSkills(cwd: string): Promise<AgentSkillEntry[]>;
+export interface McpMaps {
+    mcpServers: Record<string, AgentMcpEntry>;
+    remoteMcpServers: Record<string, RemoteMcpEntry>;
+    projectMcpServers: Record<string, AgentMcpEntry>;
+    projectRemoteMcpServers: Record<string, RemoteMcpEntry>;
+}
+/** Drop MCP servers that a plugin owns — the plugin card already lists them. */
+export declare function filterPluginOwnedMcps(maps: McpMaps, skills: AgentSkillEntry[]): McpMaps;
+/**
+ * Project-scoped MCPs recorded by brainctl at `<cwd>/.brainctl/project-mcps.json`
+ * for agents without native per-project config (Codex, Antigravity). Read for
+ * compatibility so brainctl users see their full setup after migrating.
+ */
+export declare function readBrainctlProjectMcps(cwd: string, agent: "codex" | "antigravity"): Promise<Pick<McpMaps, "projectMcpServers" | "projectRemoteMcpServers">>;

package/dist/core/agent-env/shared.js

@@ -0,0 +1,115 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import path from "node:path";
+export function parseEnvObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        result[key] = String(entry);
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+/** Read skill directories (Claude, Codex, and Antigravity share the SKILL.md dir convention). */
+export async function readSkillDirs(skillsDir, scope = "user") {
+    const entries = await readdir(skillsDir, { withFileTypes: true });
+    const skills = [];
+    for (const entry of entries) {
+        if (entry.name.startsWith("."))
+            continue;
+        const installPath = path.join(skillsDir, entry.name);
+        if (entry.isDirectory()) {
+            skills.push({ name: entry.name, source: "local", kind: "skill", scope, installPath });
+        }
+        else if (entry.isSymbolicLink()) {
+            skills.push({ name: entry.name, source: "linked", kind: "skill", scope, installPath });
+        }
+    }
+    return skills;
+}
+/**
+ * Walk from `cwd` up to the repo root (first ancestor containing `.git`, or
+ * the filesystem root) and emit skills declared in `<ancestor>/.claude/skills/`
+ * with `scope: "project"`. Only Claude reads project-scoped skills; the closer
+ * ancestor wins on name collisions.
+ */
+export async function readProjectSkills(cwd) {
+    const seen = new Map();
+    let current = path.resolve(cwd);
+    const visited = new Set();
+    while (!visited.has(current)) {
+        visited.add(current);
+        const skillsDir = path.join(current, ".claude", "skills");
+        try {
+            const entries = await readSkillDirs(skillsDir, "project");
+            for (const entry of entries) {
+                if (!seen.has(entry.name))
+                    seen.set(entry.name, entry);
+            }
+        }
+        catch {
+            // no skills dir at this level
+        }
+        try {
+            await stat(path.join(current, ".git"));
+            break;
+        }
+        catch {
+            // not a repo root; continue up
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return Array.from(seen.values());
+}
+/** Drop MCP servers that a plugin owns — the plugin card already lists them. */
+export function filterPluginOwnedMcps(maps, skills) {
+    const pluginOwned = new Set(skills.flatMap((skill) => skill.pluginMcps ?? []));
+    if (pluginOwned.size === 0)
+        return maps;
+    const notOwned = ([key]) => !pluginOwned.has(key);
+    return {
+        mcpServers: Object.fromEntries(Object.entries(maps.mcpServers).filter(notOwned)),
+        remoteMcpServers: Object.fromEntries(Object.entries(maps.remoteMcpServers).filter(notOwned)),
+        projectMcpServers: Object.fromEntries(Object.entries(maps.projectMcpServers).filter(notOwned)),
+        projectRemoteMcpServers: Object.fromEntries(Object.entries(maps.projectRemoteMcpServers).filter(notOwned)),
+    };
+}
+/**
+ * Project-scoped MCPs recorded by brainctl at `<cwd>/.brainctl/project-mcps.json`
+ * for agents without native per-project config (Codex, Antigravity). Read for
+ * compatibility so brainctl users see their full setup after migrating.
+ */
+export async function readBrainctlProjectMcps(cwd, agent) {
+    try {
+        const filePath = path.join(cwd, ".brainctl", "project-mcps.json");
+        const data = JSON.parse(await readFile(filePath, "utf8"));
+        const agentData = (data[agent] ?? {});
+        const rawServers = (agentData.mcpServers ?? {});
+        const projectMcpServers = {};
+        const projectRemoteMcpServers = {};
+        for (const [name, entry] of Object.entries(rawServers)) {
+            if (typeof entry.url === "string" && entry.url) {
+                projectRemoteMcpServers[name] = {
+                    transport: entry.transport ?? "http",
+                    url: entry.url,
+                    headers: parseEnvObject(entry.headers),
+                    env: parseEnvObject(entry.env),
+                };
+            }
+            else {
+                projectMcpServers[name] = {
+                    command: String(entry.command ?? ""),
+                    args: Array.isArray(entry.args) ? entry.args.map(String) : undefined,
+                    env: parseEnvObject(entry.env),
+                };
+            }
+        }
+        return { projectMcpServers, projectRemoteMcpServers };
+    }
+    catch {
+        return { projectMcpServers: {}, projectRemoteMcpServers: {} };
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/core/agent-env/shared.js.map

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

package/dist/core/agent-env/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Agent Environments — read-only view of coding agents' live configuration
+ * (MCP servers + skills) across Claude Code, Codex CLI, and Antigravity.
+ * Ported from brainctl's sync/agent-reader layer (see ROR-59/ROR-60).
+ */
+export type AgentName = "claude" | "codex" | "antigravity";
+export declare const AGENT_NAMES: AgentName[];
+export interface AgentMcpEntry {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface RemoteMcpEntry {
+    transport: "http" | "sse";
+    url: string;
+    headers?: Record<string, string>;
+    env?: Record<string, string>;
+}
+export interface AgentSkillEntry {
+    name: string;
+    /** e.g. "claude-plugins-official", "local", "linked", or a marketplace id. */
+    source?: string;
+    kind?: "skill" | "plugin";
+    /**
+     * Where this skill lives:
+     *   - "user"    — `~/.<agent>/skills/` or a user-installed plugin
+     *   - "project" — `<repo>/.claude/skills/` (Claude only)
+     */
+    scope: "user" | "project";
+    pluginSkills?: string[];
+    pluginMcps?: string[];
+    pluginAgents?: string[];
+    pluginCommands?: string[];
+    installPath?: string;
+    managed?: boolean;
+}
+export interface AgentLiveConfig {
+    agent: AgentName;
+    configPath: string;
+    exists: boolean;
+    mcpServers: Record<string, AgentMcpEntry>;
+    remoteMcpServers: Record<string, RemoteMcpEntry>;
+    projectMcpServers: Record<string, AgentMcpEntry>;
+    projectRemoteMcpServers: Record<string, RemoteMcpEntry>;
+    skills: AgentSkillEntry[];
+}
+export interface AgentAvailability {
+    agent: AgentName;
+    available: boolean;
+    command: string;
+    resolvedPath?: string;
+}
+export interface AgentDoctorCheck {
+    label: string;
+    status: "ok" | "warn";
+    message: string;
+}
+export interface AgentDoctorResult {
+    checks: AgentDoctorCheck[];
+    hasIssues: boolean;
+}
+/** Options shared by every reader; `homeDir` is injectable for tests. */
+export interface AgentEnvReadOptions {
+    cwd: string;
+    homeDir?: string;
+}

package/dist/core/agent-env/types.js

@@ -0,0 +1,7 @@
+/**
+ * Agent Environments — read-only view of coding agents' live configuration
+ * (MCP servers + skills) across Claude Code, Codex CLI, and Antigravity.
+ * Ported from brainctl's sync/agent-reader layer (see ROR-59/ROR-60).
+ */
+export const AGENT_NAMES = ["claude", "codex", "antigravity"];
+//# sourceMappingURL=types.js.map

package/dist/core/agent-env/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/agent-env/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC"}

package/dist/core/agent-env-actions.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Agent Environments staged writes (ROR-61) — the write-guarded surface over
+ * `agent-env-writers.ts`. Mirrors the GitManager/GitActions and DbPeek/DbWrite
+ * split: `core/agent-env/` only reads; every mutation flows through this
+ * module's preview → apply gate and reports the backup files it created.
+ */
+import { z } from "zod";
+import { type AgentName } from "./agent-env/index.js";
+/** One staged mutation. `name` is the MCP key or the skill directory name. */
+export declare const pendingChangeSchema: z.ZodObject<{
+    category: z.ZodEnum<["mcp", "skill"]>;
+    action: z.ZodEnum<["copy", "move", "remove"]>;
+    name: z.ZodString;
+    sourceAgent: z.ZodEnum<["claude", "codex", "antigravity"]>;
+    sourceScope: z.ZodDefault<z.ZodEnum<["user", "project"]>>;
+    targetAgent: z.ZodOptional<z.ZodEnum<["claude", "codex", "antigravity"]>>;
+    targetScope: z.ZodOptional<z.ZodEnum<["user", "project"]>>;
+}, "strip", z.ZodTypeAny, {
+    action: "remove" | "copy" | "move";
+    name: string;
+    category: "mcp" | "skill";
+    sourceAgent: "claude" | "codex" | "antigravity";
+    sourceScope: "user" | "project";
+    targetAgent?: "claude" | "codex" | "antigravity" | undefined;
+    targetScope?: "user" | "project" | undefined;
+}, {
+    action: "remove" | "copy" | "move";
+    name: string;
+    category: "mcp" | "skill";
+    sourceAgent: "claude" | "codex" | "antigravity";
+    sourceScope?: "user" | "project" | undefined;
+    targetAgent?: "claude" | "codex" | "antigravity" | undefined;
+    targetScope?: "user" | "project" | undefined;
+}>;
+export type PendingChange = z.infer<typeof pendingChangeSchema>;
+export declare const pendingChangesSchema: z.ZodArray<z.ZodObject<{
+    category: z.ZodEnum<["mcp", "skill"]>;
+    action: z.ZodEnum<["copy", "move", "remove"]>;
+    name: z.ZodString;
+    sourceAgent: z.ZodEnum<["claude", "codex", "antigravity"]>;
+    sourceScope: z.ZodDefault<z.ZodEnum<["user", "project"]>>;
+    targetAgent: z.ZodOptional<z.ZodEnum<["claude", "codex", "antigravity"]>>;
+    targetScope: z.ZodOptional<z.ZodEnum<["user", "project"]>>;
+}, "strip", z.ZodTypeAny, {
+    action: "remove" | "copy" | "move";
+    name: string;
+    category: "mcp" | "skill";
+    sourceAgent: "claude" | "codex" | "antigravity";
+    sourceScope: "user" | "project";
+    targetAgent?: "claude" | "codex" | "antigravity" | undefined;
+    targetScope?: "user" | "project" | undefined;
+}, {
+    action: "remove" | "copy" | "move";
+    name: string;
+    category: "mcp" | "skill";
+    sourceAgent: "claude" | "codex" | "antigravity";
+    sourceScope?: "user" | "project" | undefined;
+    targetAgent?: "claude" | "codex" | "antigravity" | undefined;
+    targetScope?: "user" | "project" | undefined;
+}>, "many">;
+export interface ChangePreviewItem {
+    change: PendingChange;
+    ok: boolean;
+    /** Human-readable, e.g. `Copy MCP "linear" from Claude Code to Codex CLI (user scope)`. */
+    summary: string;
+    warnings: string[];
+    error?: string;
+}
+export interface AgentDiffSummary {
+    agent: AgentName;
+    add: string[];
+    remove: string[];
+}
+export interface ChangePreview {
+    valid: boolean;
+    items: ChangePreviewItem[];
+    agents: AgentDiffSummary[];
+}
+export interface AppliedChange {
+    change: PendingChange;
+    ok: boolean;
+    summary: string;
+    backups: string[];
+    error?: string;
+}
+export interface ApplyResult {
+    ok: boolean;
+    applied: number;
+    failed: number;
+    results: AppliedChange[];
+    /** Every backup file/directory created across all changes. */
+    backups: string[];
+}
+export interface AgentEnvActionOptions {
+    cwd: string;
+    homeDir?: string;
+}
+export declare function previewChanges(options: AgentEnvActionOptions & {
+    changes: PendingChange[];
+}): Promise<ChangePreview>;
+export declare function describeChange(change: PendingChange): string;
+/**
+ * Validate the full batch, then apply changes in order. Validation failures
+ * abort before anything is written; a mid-batch write failure stops the batch
+ * (earlier changes stay applied — their backups are in the result).
+ */
+export declare function applyChanges(options: AgentEnvActionOptions & {
+    changes: PendingChange[];
+}): Promise<ApplyResult>;
+export interface SnapshotResult {
+    agent: AgentName;
+    backups: string[];
+}
+/** Back up an agent's live config file (`<file>.bak.<ts>`) before bulk edits. */
+export declare function snapshotAgent(options: AgentEnvActionOptions & {
+    agent: AgentName;
+}): Promise<SnapshotResult>;