nomoreide 0.1.69 → 0.1.70

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>;

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>;