nomoreide 0.1.68 → 0.1.70

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

@@ -0,0 +1,234 @@
+/**
+ * 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 { readAllAgentConfigs, AGENT_NAMES, } from "./agent-env/index.js";
+import { addMcp, copySkill, moveSkill, removeMcp, removeSkill, snapshotAgentConfig, } from "./agent-env-writers.js";
+const agentNameSchema = z.enum(["claude", "codex", "antigravity"]);
+const scopeSchema = z.enum(["user", "project"]);
+/** One staged mutation. `name` is the MCP key or the skill directory name. */
+export const pendingChangeSchema = z.object({
+    category: z.enum(["mcp", "skill"]),
+    action: z.enum(["copy", "move", "remove"]),
+    name: z.string().min(1),
+    sourceAgent: agentNameSchema,
+    sourceScope: scopeSchema.default("user"),
+    targetAgent: agentNameSchema.optional(),
+    targetScope: scopeSchema.optional(),
+});
+export const pendingChangesSchema = z.array(pendingChangeSchema).min(1).max(50);
+const AGENT_LABELS = {
+    claude: "Claude Code",
+    codex: "Codex CLI",
+    antigravity: "Antigravity",
+};
+export async function previewChanges(options) {
+    const configs = await readAllAgentConfigs(options);
+    const byAgent = new Map(configs.map((config) => [config.agent, config]));
+    const items = options.changes.map((change) => previewOne(change, byAgent));
+    const agents = AGENT_NAMES.map((agent) => ({
+        agent,
+        add: [],
+        remove: [],
+    }));
+    const diffFor = (agent) => agents.find((entry) => entry.agent === agent);
+    for (const item of items) {
+        if (!item.ok)
+            continue;
+        const { change } = item;
+        const label = `${change.category} "${change.name}"`;
+        if (change.action !== "remove" && change.targetAgent) {
+            diffFor(change.targetAgent).add.push(label);
+        }
+        if (change.action !== "copy") {
+            diffFor(change.sourceAgent).remove.push(label);
+        }
+    }
+    return {
+        valid: items.every((item) => item.ok),
+        items,
+        agents: agents.filter((entry) => entry.add.length > 0 || entry.remove.length > 0),
+    };
+}
+function previewOne(change, byAgent) {
+    const warnings = [];
+    const fail = (error) => ({
+        change,
+        ok: false,
+        summary: describeChange(change),
+        warnings,
+        error,
+    });
+    const source = byAgent.get(change.sourceAgent);
+    if (!source)
+        return fail(`Unknown agent "${change.sourceAgent}".`);
+    if (change.action !== "remove") {
+        if (!change.targetAgent)
+            return fail(`A ${change.action} needs a target agent.`);
+        const targetScope = change.targetScope ?? "user";
+        if (change.targetAgent === change.sourceAgent && targetScope === change.sourceScope) {
+            return fail(`Source and target are the same; nothing to ${change.action}.`);
+        }
+        if (change.category === "skill" && targetScope === "project" && change.targetAgent !== "claude") {
+            return fail(`${AGENT_LABELS[change.targetAgent]} has no project-scoped skills; only Claude reads .claude/skills/.`);
+        }
+    }
+    else if (change.targetAgent) {
+        return fail("A remove cannot have a target agent.");
+    }
+    if (change.category === "mcp") {
+        const { entry, remoteEntry } = findMcp(source, change.name, change.sourceScope);
+        if (!entry && !remoteEntry) {
+            return fail(`MCP "${change.name}" not found in ${AGENT_LABELS[change.sourceAgent]} ${change.sourceScope} scope.`);
+        }
+        if (change.targetAgent) {
+            const target = byAgent.get(change.targetAgent);
+            const targetScope = change.targetScope ?? "user";
+            if (target) {
+                const existing = findMcp(target, change.name, targetScope);
+                if (existing.entry || existing.remoteEntry) {
+                    warnings.push(`${AGENT_LABELS[change.targetAgent]} already has an MCP named "${change.name}"; it will be overwritten.`);
+                }
+            }
+            if (change.targetAgent === "codex" &&
+                targetScope === "user" &&
+                remoteEntry &&
+                (remoteEntry.headers || remoteEntry.transport === "sse")) {
+                warnings.push("Codex config only stores a URL for remote MCPs; transport and headers will be dropped.");
+            }
+        }
+    }
+    else {
+        const skill = source.skills.find((candidate) => candidate.name === change.name && candidate.scope === change.sourceScope);
+        if (!skill) {
+            return fail(`Skill "${change.name}" not found in ${AGENT_LABELS[change.sourceAgent]} ${change.sourceScope} scope.`);
+        }
+        if (skill.kind === "plugin") {
+            return fail(`"${change.name}" is a plugin managed by ${AGENT_LABELS[change.sourceAgent]}; install it through the plugin marketplace instead of copying files.`);
+        }
+        if (change.targetAgent) {
+            const target = byAgent.get(change.targetAgent);
+            const targetScope = change.targetScope ?? "user";
+            const collision = target?.skills.some((candidate) => candidate.name === change.name && candidate.scope === targetScope);
+            if (collision) {
+                warnings.push(`${AGENT_LABELS[change.targetAgent]} already has a skill named "${change.name}"; it will be replaced.`);
+            }
+        }
+    }
+    return { change, ok: true, summary: describeChange(change), warnings };
+}
+export function describeChange(change) {
+    const kind = change.category === "mcp" ? "MCP" : "skill";
+    const from = `${AGENT_LABELS[change.sourceAgent]} (${change.sourceScope})`;
+    if (change.action === "remove") {
+        return `Remove ${kind} "${change.name}" from ${from}`;
+    }
+    const targetScope = change.targetScope ?? "user";
+    const target = change.targetAgent ? AGENT_LABELS[change.targetAgent] : "?";
+    const verb = change.action === "copy" ? "Copy" : "Move";
+    return `${verb} ${kind} "${change.name}" from ${from} to ${target} (${targetScope})`;
+}
+/**
+ * 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 async function applyChanges(options) {
+    const preview = await previewChanges(options);
+    if (!preview.valid) {
+        return {
+            ok: false,
+            applied: 0,
+            failed: preview.items.filter((item) => !item.ok).length,
+            results: preview.items.map((item) => ({
+                change: item.change,
+                ok: false,
+                summary: item.summary,
+                backups: [],
+                error: item.error ?? "Not applied — another staged change failed validation.",
+            })),
+            backups: [],
+        };
+    }
+    const configs = await readAllAgentConfigs(options);
+    const byAgent = new Map(configs.map((config) => [config.agent, config]));
+    const results = [];
+    for (const change of options.changes) {
+        const summary = describeChange(change);
+        try {
+            const outcome = await applyOne(change, byAgent, options);
+            results.push({ change, ok: true, summary, backups: outcome.backups });
+        }
+        catch (error) {
+            results.push({
+                change,
+                ok: false,
+                summary,
+                backups: [],
+                error: error instanceof Error ? error.message : String(error),
+            });
+            break; // stop the batch on the first write failure
+        }
+    }
+    const applied = results.filter((result) => result.ok).length;
+    return {
+        ok: applied === options.changes.length,
+        applied,
+        failed: results.length - applied,
+        results,
+        backups: results.flatMap((result) => result.backups),
+    };
+}
+async function applyOne(change, byAgent, options) {
+    const base = { cwd: options.cwd, homeDir: options.homeDir };
+    if (change.category === "mcp") {
+        const source = byAgent.get(change.sourceAgent);
+        const { entry, remoteEntry } = findMcp(source, change.name, change.sourceScope);
+        if (change.action === "remove") {
+            return removeMcp({ ...base, agent: change.sourceAgent, key: change.name, scope: change.sourceScope });
+        }
+        const added = await addMcp({
+            ...base,
+            agent: change.targetAgent,
+            key: change.name,
+            entry,
+            remoteEntry,
+            scope: change.targetScope ?? "user",
+        });
+        if (change.action === "copy")
+            return added;
+        const removed = await removeMcp({
+            ...base,
+            agent: change.sourceAgent,
+            key: change.name,
+            scope: change.sourceScope,
+        });
+        return { backups: [...added.backups, ...removed.backups] };
+    }
+    const source = { agent: change.sourceAgent, skillName: change.name, scope: change.sourceScope };
+    if (change.action === "remove") {
+        return removeSkill({ ...base, location: source });
+    }
+    const target = {
+        agent: change.targetAgent,
+        skillName: change.name,
+        scope: (change.targetScope ?? "user"),
+    };
+    return change.action === "copy"
+        ? copySkill({ ...base, source, target })
+        : moveSkill({ ...base, source, target });
+}
+function findMcp(config, name, scope) {
+    const local = scope === "project" ? config.projectMcpServers : config.mcpServers;
+    const remote = scope === "project" ? config.projectRemoteMcpServers : config.remoteMcpServers;
+    return { entry: local[name], remoteEntry: remote[name] };
+}
+/** Back up an agent's live config file (`<file>.bak.<ts>`) before bulk edits. */
+export async function snapshotAgent(options) {
+    const outcome = await snapshotAgentConfig(options);
+    return { agent: options.agent, backups: outcome.backups };
+}
+//# sourceMappingURL=agent-env-actions.js.map

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

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

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

@@ -0,0 +1,46 @@
+import { type AgentMcpEntry, type AgentName, type RemoteMcpEntry } from "./agent-env/index.js";
+export type AgentEnvScope = "user" | "project";
+export interface WriterOptions {
+    cwd: string;
+    /** Injectable for tmpdir tests, like the readers. */
+    homeDir?: string;
+}
+/** Paths of `.bak.*` copies created before the mutation (empty for fresh files). */
+export interface WriteOutcome {
+    backups: string[];
+}
+export declare function formatTimestamp(): string;
+export interface McpMutationOptions extends WriterOptions {
+    agent: AgentName;
+    key: string;
+    scope: AgentEnvScope;
+}
+export interface AddMcpOptions extends McpMutationOptions {
+    entry?: AgentMcpEntry;
+    remoteEntry?: RemoteMcpEntry;
+}
+export declare function addMcp(options: AddMcpOptions): Promise<WriteOutcome>;
+export declare function removeMcp(options: McpMutationOptions): Promise<WriteOutcome>;
+export interface SkillLocation {
+    agent: AgentName;
+    skillName: string;
+    scope: AgentEnvScope;
+}
+/**
+ * Resolve the directory holding a skill's SKILL.md. Project scope is
+ * Claude-only — Codex and Antigravity have no project-skills concept.
+ */
+export declare function getSkillDir(location: SkillLocation, cwd: string, homeDir?: string): string;
+export interface CopySkillOptions extends WriterOptions {
+    source: SkillLocation;
+    target: SkillLocation;
+}
+export declare function copySkill(options: CopySkillOptions): Promise<WriteOutcome>;
+export interface RemoveSkillOptions extends WriterOptions {
+    location: SkillLocation;
+}
+export declare function removeSkill(options: RemoveSkillOptions): Promise<WriteOutcome>;
+export declare function moveSkill(options: CopySkillOptions): Promise<WriteOutcome>;
+export declare function snapshotAgentConfig(options: WriterOptions & {
+    agent: AgentName;
+}): Promise<WriteOutcome>;

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

@@ -0,0 +1,385 @@
+/**
+ * Agent Environments low-level writers — the ONLY code that mutates coding
+ * agents' config files. Ported from brainctl's agent-config-service (ROR-61).
+ * Kept separate from the read-safe `core/agent-env/` module, mirroring the
+ * GitManager/GitActions and DbPeek/DbWrite splits; callers go through the
+ * staged preview → apply flow in `agent-env-actions.ts`.
+ *
+ * Every mutation backs up the touched file to a timestamped sibling
+ * (`<file>.bak.<ts>`) and writes atomically (temp file + rename). Skill
+ * directory removals are backed up under
+ * `<home>/.config/nomoreide/agent-env-backups/` first.
+ */
+import { constants } from "node:fs";
+import { copyFile, cp, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { readAntigravityConfig, readCodexConfig, } from "./agent-env/index.js";
+export function formatTimestamp() {
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+}
+async function backupFile(filePath) {
+    const base = `${filePath}.bak.${formatTimestamp()}`;
+    // COPYFILE_EXCL + suffix loop: two writes within the same second (e.g. the
+    // add+remove halves of a move) must not overwrite each other's backup.
+    for (let attempt = 0; attempt < 10; attempt++) {
+        const backupPath = attempt === 0 ? base : `${base}-${attempt}`;
+        try {
+            await copyFile(filePath, backupPath, constants.COPYFILE_EXCL);
+            return backupPath;
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === "EEXIST")
+                continue;
+            return null; // source file does not exist yet — nothing to back up
+        }
+    }
+    return null;
+}
+async function atomicWrite(filePath, content) {
+    const tmpPath = `${filePath}.tmp.${Date.now()}`;
+    await writeFile(tmpPath, content, "utf8");
+    await rename(tmpPath, filePath);
+}
+async function atomicWriteJson(filePath, data) {
+    await atomicWrite(filePath, JSON.stringify(data, null, 2) + "\n");
+}
+export async function addMcp(options) {
+    const { agent, key, entry, remoteEntry, scope } = options;
+    if (!entry && !remoteEntry) {
+        throw new Error(`MCP "${key}" has neither a command nor a URL; nothing to add.`);
+    }
+    if (agent === "claude") {
+        return mutateClaudeConfig(options, scope, (servers) => {
+            servers[key] = remoteEntry ? toClaudeRemoteEntry(remoteEntry) : toClaudeEntry(entry);
+        });
+    }
+    if (scope === "project") {
+        // Codex and Antigravity have no native per-project config; brainctl's
+        // `.brainctl/project-mcps.json` convention is kept for compatibility.
+        return mutateBrainctlProjectMcps(options, agent, (servers) => {
+            servers[key] = remoteEntry
+                ? { transport: remoteEntry.transport, url: remoteEntry.url }
+                : {
+                    command: entry.command,
+                    ...(entry.args ? { args: entry.args } : {}),
+                    ...(entry.env ? { env: entry.env } : {}),
+                };
+        });
+    }
+    if (agent === "codex") {
+        return mutateCodexConfig(options, (state) => {
+            delete state.mcpServers[key];
+            delete state.remoteMcpServers[key];
+            if (remoteEntry)
+                state.remoteMcpServers[key] = remoteEntry;
+            else
+                state.mcpServers[key] = entry;
+        });
+    }
+    return mutateAntigravityConfig(options, (servers) => {
+        servers[key] = remoteEntry ? toAntigravityRemoteEntry(remoteEntry) : toAntigravityEntry(entry);
+    });
+}
+export async function removeMcp(options) {
+    const { agent, key, scope } = options;
+    if (agent === "claude") {
+        return mutateClaudeConfig(options, scope, (servers) => {
+            delete servers[key];
+        });
+    }
+    if (scope === "project") {
+        return mutateBrainctlProjectMcps(options, agent, (servers) => {
+            delete servers[key];
+        });
+    }
+    if (agent === "codex") {
+        return mutateCodexConfig(options, (state) => {
+            delete state.mcpServers[key];
+            delete state.remoteMcpServers[key];
+        });
+    }
+    return mutateAntigravityConfig(options, (servers) => {
+        delete servers[key];
+    });
+}
+/* ---- Claude: ~/.claude.json with top-level and projects[cwd] mcpServers ---- */
+async function mutateClaudeConfig(options, scope, mutate) {
+    const homeDir = options.homeDir ?? homedir();
+    const configPath = path.join(homeDir, ".claude.json");
+    const backups = [];
+    let existing = {};
+    try {
+        existing = JSON.parse(await readFile(configPath, "utf8"));
+        const backup = await backupFile(configPath);
+        if (backup)
+            backups.push(backup);
+    }
+    catch {
+        // fresh config
+    }
+    if (scope === "user") {
+        const servers = (existing.mcpServers ?? {});
+        mutate(servers);
+        existing.mcpServers = servers;
+    }
+    else {
+        const projects = (existing.projects ?? {});
+        const projectConfig = (projects[options.cwd] ?? {});
+        const servers = (projectConfig.mcpServers ?? {});
+        mutate(servers);
+        projectConfig.mcpServers = servers;
+        projects[options.cwd] = projectConfig;
+        existing.projects = projects;
+    }
+    await atomicWriteJson(configPath, existing);
+    return { backups };
+}
+function toClaudeEntry(entry) {
+    return {
+        type: "stdio",
+        command: entry.command,
+        args: entry.args ?? [],
+        ...(entry.env ? { env: entry.env } : {}),
+    };
+}
+function toClaudeRemoteEntry(entry) {
+    return {
+        type: entry.transport === "sse" ? "sse" : "http",
+        url: entry.url,
+        ...(entry.headers ? { headers: entry.headers } : {}),
+    };
+}
+/* ---- Codex: [mcp_servers.*] TOML sections in ~/.codex/config.toml ---- */
+async function mutateCodexConfig(options, mutate) {
+    const homeDir = options.homeDir ?? homedir();
+    const configPath = path.join(homeDir, ".codex", "config.toml");
+    const backups = [];
+    let existingContent = "";
+    try {
+        existingContent = await readFile(configPath, "utf8");
+        const backup = await backupFile(configPath);
+        if (backup)
+            backups.push(backup);
+    }
+    catch {
+        // fresh config
+    }
+    const current = await readCodexConfig({ cwd: options.cwd, homeDir });
+    const state = {
+        mcpServers: { ...current.mcpServers },
+        remoteMcpServers: { ...current.remoteMcpServers },
+    };
+    mutate(state);
+    // Rebuild the file: everything that isn't an mcp_servers section, then ours.
+    const nonMcp = stripCodexMcpSections(existingContent).trim();
+    const mcpToml = buildCodexMcpToml(state);
+    const final = [nonMcp, mcpToml].filter((part) => part.length > 0).join("\n\n");
+    await mkdir(path.dirname(configPath), { recursive: true });
+    await atomicWrite(configPath, final + "\n");
+    return { backups };
+}
+function stripCodexMcpSections(content) {
+    const lines = content.split("\n");
+    const result = [];
+    let inMcp = false;
+    for (const line of lines) {
+        if (/^\[mcp_servers[\].]/.test(line)) {
+            inMcp = true;
+            continue;
+        }
+        if (inMcp && /^\[/.test(line) && !/^\[mcp_servers[\].]/.test(line)) {
+            inMcp = false;
+        }
+        if (!inMcp)
+            result.push(line);
+    }
+    return result.join("\n");
+}
+function buildCodexMcpToml(state) {
+    const lines = [];
+    for (const [name, entry] of Object.entries(state.mcpServers)) {
+        lines.push(`[mcp_servers.${name}]`);
+        lines.push(`command = ${tomlStr(entry.command)}`);
+        if (entry.args && entry.args.length > 0) {
+            lines.push(`args = [${entry.args.map(tomlStr).join(", ")}]`);
+        }
+        if (entry.env && Object.keys(entry.env).length > 0) {
+            lines.push("");
+            lines.push(`[mcp_servers.${name}.env]`);
+            for (const [key, value] of Object.entries(entry.env)) {
+                lines.push(`${key} = ${tomlStr(value)}`);
+            }
+        }
+        lines.push("");
+    }
+    // Codex TOML only carries a URL for remote servers; transport/headers are
+    // Claude/Antigravity concepts and are dropped (preview warns about this).
+    for (const [name, entry] of Object.entries(state.remoteMcpServers)) {
+        lines.push(`[mcp_servers.${name}]`);
+        lines.push(`url = ${tomlStr(entry.url)}`);
+        lines.push("");
+    }
+    return lines.join("\n").trim();
+}
+function tomlStr(value) {
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+/* ---- Antigravity: JSON mcpServers at the live candidate path ---- */
+async function mutateAntigravityConfig(options, mutate) {
+    const homeDir = options.homeDir ?? homedir();
+    // Antigravity has shipped several config locations; write to whichever one
+    // is live (the reader resolves it), falling back to the current default.
+    const live = await readAntigravityConfig({ cwd: options.cwd, homeDir });
+    const configPath = live.configPath;
+    const backups = [];
+    let existing = {};
+    try {
+        const source = await readFile(configPath, "utf8");
+        if (source.trim().length > 0) {
+            existing = JSON.parse(source);
+        }
+        const backup = await backupFile(configPath);
+        if (backup)
+            backups.push(backup);
+    }
+    catch {
+        // fresh config
+    }
+    const servers = (existing.mcpServers ?? {});
+    mutate(servers);
+    existing.mcpServers = servers;
+    await mkdir(path.dirname(configPath), { recursive: true });
+    await atomicWriteJson(configPath, existing);
+    return { backups };
+}
+function toAntigravityEntry(entry) {
+    return {
+        command: entry.command,
+        args: entry.args ?? [],
+        ...(entry.env ? { env: entry.env } : {}),
+    };
+}
+function toAntigravityRemoteEntry(entry) {
+    return {
+        ...(entry.transport === "http" ? { httpUrl: entry.url } : { url: entry.url }),
+        ...(entry.headers ? { headers: entry.headers } : {}),
+        ...(entry.env ? { env: entry.env } : {}),
+    };
+}
+/* ---- brainctl-compat project MCPs: <cwd>/.brainctl/project-mcps.json ---- */
+async function mutateBrainctlProjectMcps(options, agent, mutate) {
+    const filePath = path.join(options.cwd, ".brainctl", "project-mcps.json");
+    const backups = [];
+    let data = {};
+    try {
+        data = JSON.parse(await readFile(filePath, "utf8"));
+        const backup = await backupFile(filePath);
+        if (backup)
+            backups.push(backup);
+    }
+    catch {
+        // fresh file
+    }
+    const agentData = (data[agent] ?? {});
+    const servers = (agentData.mcpServers ?? {});
+    mutate(servers);
+    agentData.mcpServers = servers;
+    data[agent] = agentData;
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await atomicWriteJson(filePath, data);
+    return { backups };
+}
+/**
+ * Resolve the directory holding a skill's SKILL.md. Project scope is
+ * Claude-only — Codex and Antigravity have no project-skills concept.
+ */
+export function getSkillDir(location, cwd, homeDir) {
+    const { agent, scope } = location;
+    const safeName = path.basename(location.skillName);
+    if (scope === "project") {
+        if (agent !== "claude") {
+            throw new Error(`Project-scoped skills are not supported for ${agent}; only Claude reads .claude/skills/ from the workspace.`);
+        }
+        return path.join(cwd, ".claude", "skills", safeName);
+    }
+    const home = homeDir ?? homedir();
+    const agentDir = { claude: ".claude", codex: ".codex", antigravity: ".gemini" }[agent];
+    return path.join(home, agentDir, "skills", safeName);
+}
+export async function copySkill(options) {
+    const sourceDir = getSkillDir(options.source, options.cwd, options.homeDir);
+    const targetDir = getSkillDir(options.target, options.cwd, options.homeDir);
+    try {
+        await stat(sourceDir);
+    }
+    catch {
+        throw new Error(`Skill "${options.source.skillName}" not found for ${options.source.agent} at ${sourceDir}.`);
+    }
+    await mkdir(path.dirname(targetDir), { recursive: true });
+    await rm(targetDir, { recursive: true, force: true });
+    await cp(sourceDir, targetDir, { recursive: true });
+    return { backups: [] };
+}
+export async function removeSkill(options) {
+    const skillDir = getSkillDir(options.location, options.cwd, options.homeDir);
+    const backup = await backupSkillDir(options, skillDir);
+    await rm(skillDir, { recursive: true, force: true });
+    return { backups: backup ? [backup] : [] };
+}
+export async function moveSkill(options) {
+    const sourceDir = getSkillDir(options.source, options.cwd, options.homeDir);
+    const targetDir = getSkillDir(options.target, options.cwd, options.homeDir);
+    try {
+        await stat(sourceDir);
+    }
+    catch {
+        // Idempotent: source already gone but destination present → done.
+        try {
+            await stat(targetDir);
+            return { backups: [] };
+        }
+        catch {
+            throw new Error(`Skill "${options.source.skillName}" not found for ${options.source.agent} at ${sourceDir}.`);
+        }
+    }
+    await mkdir(path.dirname(targetDir), { recursive: true });
+    await rm(targetDir, { recursive: true, force: true });
+    await cp(sourceDir, targetDir, { recursive: true });
+    const backup = await backupSkillDir(options, sourceDir);
+    await rm(sourceDir, { recursive: true, force: true });
+    return { backups: backup ? [backup] : [] };
+}
+/**
+ * Copy a skill dir that is about to be deleted into the central backup area.
+ * Deliberately NOT a sibling `.bak.*` directory — the readers would list that
+ * as a new skill.
+ */
+async function backupSkillDir(options, skillDir) {
+    try {
+        await stat(skillDir);
+    }
+    catch {
+        return null;
+    }
+    const homeDir = options.homeDir ?? homedir();
+    const backupDir = path.join(homeDir, ".config", "nomoreide", "agent-env-backups", `${path.basename(skillDir)}.${formatTimestamp()}`);
+    await mkdir(path.dirname(backupDir), { recursive: true });
+    await cp(skillDir, backupDir, { recursive: true });
+    return backupDir;
+}
+/* ---- Snapshot: back up an agent's config file before bulk operations ---- */
+export async function snapshotAgentConfig(options) {
+    const homeDir = options.homeDir ?? homedir();
+    const configPath = options.agent === "claude"
+        ? path.join(homeDir, ".claude.json")
+        : options.agent === "codex"
+            ? path.join(homeDir, ".codex", "config.toml")
+            : (await readAntigravityConfig({ cwd: options.cwd, homeDir })).configPath;
+    const backup = await backupFile(configPath);
+    return { backups: backup ? [backup] : [] };
+}
+//# sourceMappingURL=agent-env-writers.js.map