@tacuchi/agent-workflow-cli 4.6.0 → 5.0.0

package/dist/application/hub-init-service.d.ts

@@ -0,0 +1,47 @@
+import type { EnvPort } from "../ports/env.js";
+import type { FileSystemPort } from "../ports/file-system.js";
+import { type MultirootError, type MultirootResult } from "./multiroot-service.js";
+import type { PathsService } from "./paths-service.js";
+import { type ProjectMdUpsertError, type ProjectMdUpsertOutput } from "./project-md-upsert-service.js";
+export interface HubInitFuente {
+    alias: string;
+    path: string;
+}
+export interface HubInitInput {
+    proyecto: string;
+    fuentes: HubInitFuente[];
+    workingBranches: Record<string, string>;
+    mainBranch?: string;
+    workspace?: string;
+    skipAttach?: boolean;
+    dryRun?: boolean;
+}
+export interface HubInitProjectMdPreview {
+    dry_run_preview: {
+        fuentes: number;
+        mode: "hub";
+    };
+}
+export interface HubInitAttachSkipped {
+    skipped: true;
+    reason: string;
+}
+export interface HubInitAttachPreview {
+    dry_run_preview: {
+        paths: string[];
+        workspace: string;
+    };
+}
+export interface HubInitResult {
+    ok: boolean;
+    dry_run: boolean;
+    workspace: string;
+    project_md: ProjectMdUpsertOutput | ProjectMdUpsertError | HubInitProjectMdPreview;
+    attach_multiroot: MultirootResult | MultirootError | HubInitAttachSkipped | HubInitAttachPreview;
+}
+export interface HubInitInputError {
+    error: string;
+    hint?: string;
+}
+export declare function runHubInit(fs: FileSystemPort, env: EnvPort, paths: PathsService, input: HubInitInput): Promise<HubInitResult | HubInitInputError>;
+//# sourceMappingURL=hub-init-service.d.ts.map

package/dist/application/hub-init-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-init-service.d.ts","sourceRoot":"","sources":["../../src/application/hub-init-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAgB,MAAM,wBAAwB,CAAC;AACjG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAE3B,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,qBAAqB,GAAG,oBAAoB,GAAG,uBAAuB,CAAC;IACnF,gBAAgB,EAAE,eAAe,GAAG,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;CAClG;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,UAAU,CAC9B,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,aAAa,GAAG,iBAAiB,CAAC,CAgE5C"}

package/dist/application/hub-init-service.js

@@ -0,0 +1,92 @@
+import { resolve } from "node:path";
+import { runMultiroot } from "./multiroot-service.js";
+import { runProjectMdUpsertWrite, } from "./project-md-upsert-service.js";
+export async function runHubInit(fs, env, paths, input) {
+    const validation = validateInput(input);
+    if (validation)
+        return validation;
+    const workspace = input.workspace ? resolve(input.workspace) : resolve(env.cwd());
+    if (input.dryRun) {
+        return {
+            ok: true,
+            dry_run: true,
+            workspace,
+            project_md: { dry_run_preview: { fuentes: input.fuentes.length, mode: "hub" } },
+            attach_multiroot: input.skipAttach
+                ? { skipped: true, reason: "skip-attach flag" }
+                : {
+                    dry_run_preview: { paths: input.fuentes.map((f) => f.path), workspace },
+                },
+        };
+    }
+    const targetEnv = workspace !== resolve(env.cwd()) ? overrideCwd(env, workspace) : env;
+    const projectMd = await runProjectMdUpsertWrite(fs, targetEnv, paths, {
+        op: "init",
+        mode: "hub",
+        proyecto: input.proyecto,
+        fuentes: input.fuentes.map((f) => ({ alias: f.alias, path: f.path })),
+        workingBranches: input.workingBranches,
+        ...(input.mainBranch !== undefined ? { mainBranch: input.mainBranch } : {}),
+        verbose: true,
+    });
+    if ("error" in projectMd) {
+        return {
+            ok: false,
+            dry_run: false,
+            workspace,
+            project_md: projectMd,
+            attach_multiroot: { skipped: true, reason: "project_md_failed" },
+        };
+    }
+    if (input.skipAttach) {
+        return {
+            ok: projectMd.ok,
+            dry_run: false,
+            workspace,
+            project_md: projectMd,
+            attach_multiroot: { skipped: true, reason: "skip-attach flag" },
+        };
+    }
+    const attach = await runMultiroot(fs, targetEnv, paths, "attach", {
+        fromSources: true,
+        workspace,
+    });
+    const attachOk = !("error" in attach);
+    return {
+        ok: projectMd.ok && attachOk,
+        dry_run: false,
+        workspace,
+        project_md: projectMd,
+        attach_multiroot: attach,
+    };
+}
+function overrideCwd(env, cwd) {
+    return {
+        get: (k) => env.get(k),
+        homeDir: () => env.homeDir(),
+        cwd: () => cwd,
+    };
+}
+function validateInput(input) {
+    if (!input.proyecto || input.proyecto.trim().length === 0) {
+        return { error: "missing_proyecto", hint: "--proyecto es obligatorio" };
+    }
+    if (!input.fuentes || input.fuentes.length < 2) {
+        return {
+            error: "insufficient_fuentes",
+            hint: "hub-init requiere mínimo 2 fuentes (--fuente alias:path repetible)",
+        };
+    }
+    const aliases = new Set();
+    for (const f of input.fuentes) {
+        if (!f.alias || !f.path) {
+            return { error: "invalid_fuente", hint: `fuente sin alias o path: ${JSON.stringify(f)}` };
+        }
+        if (aliases.has(f.alias)) {
+            return { error: "duplicate_alias", hint: `alias duplicado: ${f.alias}` };
+        }
+        aliases.add(f.alias);
+    }
+    return null;
+}
+//# sourceMappingURL=hub-init-service.js.map

package/dist/application/hub-init-service.js.map

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

package/dist/application/mcp-doctor-service.d.ts

@@ -0,0 +1,23 @@
+import { type McpDriftReport, type McpHost, type McpInstance } from "../domain/mcp-entry.js";
+import type { EnvPort } from "../ports/env.js";
+import type { PathsService } from "./paths-service.js";
+export interface McpDoctorInput {
+    hosts: McpHost[];
+    instances: McpInstance[];
+    scope: "workspace" | "global";
+    workspace?: string;
+}
+export interface McpDoctorResult {
+    scope: "workspace" | "global";
+    scope_dir: string;
+    reports: McpDriftReport[];
+    summary: {
+        ok: number;
+        missing_mcp: number;
+        dsn_mismatch: number;
+        missing_dsn: number;
+        extra: number;
+    };
+}
+export declare function runMcpDoctor(env: EnvPort, paths: PathsService, input: McpDoctorInput): McpDoctorResult;
+//# sourceMappingURL=mcp-doctor-service.d.ts.map

package/dist/application/mcp-doctor-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-doctor-service.d.ts","sourceRoot":"","sources":["../../src/application/mcp-doctor-service.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,KAAK,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,cAAc,GACpB,eAAe,CAoBjB"}

package/dist/application/mcp-doctor-service.js

@@ -0,0 +1,123 @@
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { buildMcpEntry, } from "../domain/mcp-entry.js";
+import { dsnKeyForInstance, readBootstrapDsn } from "./dsn-reader-service.js";
+import { readMcpEntry } from "./mcp-host-reader.js";
+export function runMcpDoctor(env, paths, input) {
+    const scopeDir = resolveScopeDir(env, input);
+    const dsn = readBootstrapDsn(paths);
+    const reports = [];
+    for (const host of input.hosts) {
+        for (const instance of input.instances) {
+            reports.push(buildReport(host, instance, scopeDir, dsn, input.scope));
+        }
+    }
+    const summary = {
+        ok: reports.filter((r) => r.status === "ok").length,
+        missing_mcp: reports.filter((r) => r.status === "missing-mcp").length,
+        dsn_mismatch: reports.filter((r) => r.status === "dsn-mismatch").length,
+        missing_dsn: reports.filter((r) => r.status === "missing-dsn").length,
+        extra: reports.filter((r) => r.status === "extra-entry").length,
+    };
+    return { scope: input.scope, scope_dir: scopeDir, reports, summary };
+}
+function buildReport(host, instance, scopeDir, dsn, scope) {
+    const entry = buildMcpEntry(instance);
+    const snapshot = readMcpEntry(host, scopeDir, entry.name);
+    const dsnKey = dsnKeyForInstance(instance);
+    const dsnPresent = dsn.exists && Boolean(dsn.values[dsnKey]);
+    const dsnInfo = {
+        path: dsn.path,
+        exists: dsn.exists,
+        key: dsnKey,
+        present: dsnPresent,
+    };
+    if (!snapshot.exists) {
+        return {
+            host,
+            instance,
+            scope,
+            target: snapshot.target,
+            dsn: dsnInfo,
+            mcp: { name: entry.name, present: false, matches: false },
+            status: dsnPresent ? "missing-mcp" : "missing-dsn",
+            detail: dsnPresent
+                ? `Falta entrada MCP '${entry.name}' en ${snapshot.target}`
+                : `Ni DSN ni MCP registrados para ${instance}`,
+        };
+    }
+    const matches = matchesEntry(snapshot, entry);
+    if (!dsnPresent) {
+        return {
+            host,
+            instance,
+            scope,
+            target: snapshot.target,
+            dsn: dsnInfo,
+            mcp: { name: entry.name, present: true, matches },
+            status: "dsn-mismatch",
+            detail: `MCP '${entry.name}' registrado pero ${dsnKey} no está en ${dsn.path}`,
+        };
+    }
+    if (!matches) {
+        return {
+            host,
+            instance,
+            scope,
+            target: snapshot.target,
+            dsn: dsnInfo,
+            mcp: { name: entry.name, present: true, matches: false },
+            status: "extra-entry",
+            detail: `Entrada '${entry.name}' difiere del shape esperado (command/args/env)`,
+        };
+    }
+    return {
+        host,
+        instance,
+        scope,
+        target: snapshot.target,
+        dsn: dsnInfo,
+        mcp: { name: entry.name, present: true, matches: true },
+        status: "ok",
+    };
+}
+function matchesEntry(snapshot, entry) {
+    if (snapshot.command !== entry.command)
+        return false;
+    if (!arraysEqual(snapshot.args ?? [], entry.args))
+        return false;
+    if (!recordsEqual(snapshot.env ?? {}, entry.env))
+        return false;
+    return true;
+}
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i += 1) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+function recordsEqual(a, b) {
+    const keysA = Object.keys(a).sort();
+    const keysB = Object.keys(b).sort();
+    if (keysA.length !== keysB.length)
+        return false;
+    for (let i = 0; i < keysA.length; i += 1) {
+        if (keysA[i] !== keysB[i])
+            return false;
+        const k = keysA[i] ?? "";
+        if (a[k] !== b[k])
+            return false;
+    }
+    return true;
+}
+function resolveScopeDir(env, input) {
+    if (input.scope === "global")
+        return homedir();
+    if (input.workspace)
+        return resolve(input.workspace);
+    return resolve(env.cwd());
+}
+//# sourceMappingURL=mcp-doctor-service.js.map

package/dist/application/mcp-doctor-service.js.map

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

package/dist/application/mcp-host-reader.d.ts

@@ -0,0 +1,13 @@
+import type { McpHost } from "../domain/mcp-entry.js";
+export interface McpEntrySnapshot {
+    host: McpHost;
+    target: string;
+    name: string;
+    exists: boolean;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    raw?: unknown;
+}
+export declare function readMcpEntry(host: McpHost, scopeDir: string, name: string): McpEntrySnapshot;
+//# sourceMappingURL=mcp-host-reader.d.ts.map

package/dist/application/mcp-host-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-host-reader.d.ts","sourceRoot":"","sources":["../../src/application/mcp-host-reader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAG5F"}

package/dist/application/mcp-host-reader.js

@@ -0,0 +1,89 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseToml } from "smol-toml";
+export function readMcpEntry(host, scopeDir, name) {
+    if (host === "claude")
+        return readClaudeMcpEntry(scopeDir, name);
+    return readCodexMcpEntry(scopeDir, name);
+}
+function readClaudeMcpEntry(scopeDir, name) {
+    const target = join(scopeDir, ".claude", "settings.json");
+    if (!existsSync(target)) {
+        return { host: "claude", target, name, exists: false };
+    }
+    const text = readFileSync(target, "utf-8");
+    if (text.trim().length === 0) {
+        return { host: "claude", target, name, exists: false };
+    }
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        return { host: "claude", target, name, exists: false };
+    }
+    const mcpServers = (data.mcpServers ?? {});
+    const entry = mcpServers[name];
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+        return { host: "claude", target, name, exists: false };
+    }
+    const e = entry;
+    return {
+        host: "claude",
+        target,
+        name,
+        exists: true,
+        ...(typeof e.command === "string" ? { command: e.command } : {}),
+        ...(Array.isArray(e.args)
+            ? { args: e.args.filter((x) => typeof x === "string") }
+            : {}),
+        ...(typeof e.env === "object" && e.env !== null ? { env: toStringRecord(e.env) } : {}),
+        raw: e,
+    };
+}
+function readCodexMcpEntry(scopeDir, name) {
+    const target = join(scopeDir, ".codex", "config.toml");
+    if (!existsSync(target)) {
+        return { host: "codex", target, name, exists: false };
+    }
+    const text = readFileSync(target, "utf-8");
+    if (text.trim().length === 0) {
+        return { host: "codex", target, name, exists: false };
+    }
+    let data;
+    try {
+        data = parseToml(text);
+    }
+    catch {
+        return { host: "codex", target, name, exists: false };
+    }
+    const mcpServers = (data.mcp_servers ?? {});
+    const entry = mcpServers[name];
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+        return { host: "codex", target, name, exists: false };
+    }
+    const e = entry;
+    return {
+        host: "codex",
+        target,
+        name,
+        exists: true,
+        ...(typeof e.command === "string" ? { command: e.command } : {}),
+        ...(Array.isArray(e.args)
+            ? { args: e.args.filter((x) => typeof x === "string") }
+            : {}),
+        ...(typeof e.env === "object" && e.env !== null ? { env: toStringRecord(e.env) } : {}),
+        raw: e,
+    };
+}
+function toStringRecord(obj) {
+    const out = {};
+    if (!obj || typeof obj !== "object")
+        return out;
+    for (const [k, v] of Object.entries(obj)) {
+        if (typeof v === "string")
+            out[k] = v;
+    }
+    return out;
+}
+//# sourceMappingURL=mcp-host-reader.js.map

package/dist/application/mcp-host-reader.js.map

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

package/dist/application/mcp-host-writer.d.ts

@@ -0,0 +1,13 @@
+import type { McpEntry, McpHost, McpWriteOpts, McpWriteResult } from "../domain/mcp-entry.js";
+export interface ScopeInput {
+    scopeDir: string;
+}
+export declare class McpWriterError extends Error {
+    readonly target: string;
+    readonly cause?: string | undefined;
+    constructor(message: string, target: string, cause?: string | undefined);
+}
+export declare function writeMcpEntry(host: McpHost, entry: McpEntry, scope: ScopeInput, opts?: McpWriteOpts): McpWriteResult;
+export declare function removeCodexMcpBlocks(text: string, name: string): string;
+export declare function appendCodexMcpBlocks(text: string, entry: McpEntry): string;
+//# sourceMappingURL=mcp-host-writer.d.ts.map

package/dist/application/mcp-host-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-host-writer.d.ts","sourceRoot":"","sources":["../../src/application/mcp-host-writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,QAAQ,EACR,OAAO,EAEP,YAAY,EACZ,cAAc,EACf,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,SAAQ,KAAK;aAGrB,MAAM,EAAE,MAAM;aACL,KAAK,CAAC,EAAE,MAAM;gBAFvC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACL,KAAK,CAAC,EAAE,MAAM,YAAA;CAK1C;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE,YAAiB,GACtB,cAAc,CAGhB;AAuJD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMvE;AAeD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAe1E"}

package/dist/application/mcp-host-writer.js

@@ -0,0 +1,196 @@
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { parse as parseToml } from "smol-toml";
+export class McpWriterError extends Error {
+    target;
+    cause;
+    constructor(message, target, cause) {
+        super(message);
+        this.target = target;
+        this.cause = cause;
+        this.name = "McpWriterError";
+    }
+}
+export function writeMcpEntry(host, entry, scope, opts = {}) {
+    if (host === "claude")
+        return writeClaudeMcpEntry(entry, scope, opts);
+    return writeCodexMcpEntry(entry, scope, opts);
+}
+function writeClaudeMcpEntry(entry, scope, opts) {
+    const settingsFile = join(scope.scopeDir, ".claude", "settings.json");
+    const data = readClaudeSettings(settingsFile);
+    const mcpServers = ensureRecord(data, "mcpServers");
+    const existing = mcpServers[entry.name];
+    const expected = expectedClaudeShape(entry);
+    if (deepEqual(existing, expected)) {
+        return resultSkipped("claude", settingsFile, entry.name);
+    }
+    mcpServers[entry.name] = expected;
+    data.mcpServers = mcpServers;
+    const newJson = `${JSON.stringify(data, null, 2)}\n`;
+    const oldJson = existsSync(settingsFile) ? readFileSync(settingsFile, "utf-8") : "";
+    if (newJson === oldJson) {
+        return resultSkipped("claude", settingsFile, entry.name);
+    }
+    if (opts.dryRun) {
+        return resultDryRun("claude", settingsFile, entry.name, [
+            `mcpServers.${entry.name}: ${existing ? "update" : "add"}`,
+        ]);
+    }
+    mkdirSync(dirname(settingsFile), { recursive: true });
+    const backup = backupFile(settingsFile);
+    writeFileSync(settingsFile, newJson, "utf-8");
+    return resultWritten("claude", settingsFile, entry.name, backup);
+}
+function writeCodexMcpEntry(entry, scope, opts) {
+    const configFile = join(scope.scopeDir, ".codex", "config.toml");
+    const oldContent = existsSync(configFile) ? readFileSync(configFile, "utf-8") : "";
+    let parsed;
+    try {
+        parsed = oldContent.length > 0 ? parseToml(oldContent) : {};
+    }
+    catch (err) {
+        throw new McpWriterError(`config.toml inválido en ${configFile}`, configFile, err.message);
+    }
+    const mcpServers = (parsed.mcp_servers ?? {});
+    const existing = mcpServers[entry.name];
+    const expected = expectedCodexShape(entry);
+    if (deepEqual(existing, expected)) {
+        return resultSkipped("codex", configFile, entry.name);
+    }
+    const cleaned = removeCodexMcpBlocks(oldContent, entry.name);
+    const newContent = appendCodexMcpBlocks(cleaned, entry);
+    if (newContent === oldContent) {
+        return resultSkipped("codex", configFile, entry.name);
+    }
+    if (opts.dryRun) {
+        return resultDryRun("codex", configFile, entry.name, [
+            `[mcp_servers.${entry.name}]: ${existing ? "update" : "add"}`,
+            `[mcp_servers.${entry.name}.env]: ${existing ? "update" : "add"}`,
+        ]);
+    }
+    mkdirSync(dirname(configFile), { recursive: true });
+    const backup = backupFile(configFile);
+    writeFileSync(configFile, newContent, "utf-8");
+    return resultWritten("codex", configFile, entry.name, backup);
+}
+function readClaudeSettings(file) {
+    if (!existsSync(file))
+        return {};
+    const text = readFileSync(file, "utf-8");
+    if (text.trim().length === 0)
+        return {};
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        throw new Error("settings.json no es un objeto JSON");
+    }
+    catch (err) {
+        throw new McpWriterError(`settings.json inválido en ${file}`, file, err.message);
+    }
+}
+function ensureRecord(parent, key) {
+    const current = parent[key];
+    if (current && typeof current === "object" && !Array.isArray(current)) {
+        return current;
+    }
+    const fresh = {};
+    parent[key] = fresh;
+    return fresh;
+}
+function expectedClaudeShape(entry) {
+    return {
+        command: entry.command,
+        args: [...entry.args],
+        env: { ...entry.env },
+    };
+}
+function expectedCodexShape(entry) {
+    return {
+        command: entry.command,
+        args: [...entry.args],
+        env: { ...entry.env },
+    };
+}
+function deepEqual(a, b) {
+    return canonicalJson(a) === canonicalJson(b);
+}
+function canonicalJson(v) {
+    if (v === null || v === undefined)
+        return JSON.stringify(v ?? null);
+    if (typeof v !== "object")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return `[${v.map(canonicalJson).join(",")}]`;
+    const obj = v;
+    const keys = Object.keys(obj).sort();
+    return `{${keys.map((k) => `${JSON.stringify(k)}:${canonicalJson(obj[k])}`).join(",")}}`;
+}
+function backupFile(path) {
+    if (!existsSync(path))
+        return null;
+    const ts = Math.floor(Date.now() / 1000);
+    const backupPath = `${path}.bak.${ts}`;
+    copyFileSync(path, backupPath);
+    return backupPath;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export function removeCodexMcpBlocks(text, name) {
+    let out = text;
+    for (const header of [`[mcp_servers.${name}.env]`, `[mcp_servers.${name}]`]) {
+        out = removeBlock(out, header);
+    }
+    return out.replace(/\n{3,}/g, "\n\n");
+}
+function removeBlock(text, sectionHeader) {
+    const re = new RegExp(`^${escapeRegex(sectionHeader)}[ \\t]*$`, "m");
+    const match = re.exec(text);
+    if (!match || match.index === undefined)
+        return text;
+    const start = match.index;
+    const headerEnd = start + match[0].length;
+    const after = text.slice(headerEnd);
+    const nextRe = /\n\[/;
+    const nextMatch = nextRe.exec(after);
+    const end = nextMatch ? headerEnd + (nextMatch.index ?? 0) + 1 : text.length;
+    return text.slice(0, start) + text.slice(end);
+}
+export function appendCodexMcpBlocks(text, entry) {
+    const buffer = [];
+    let prefix = text;
+    if (prefix.length > 0 && !prefix.endsWith("\n"))
+        prefix += "\n";
+    if (prefix.length > 0 && !prefix.endsWith("\n\n"))
+        prefix += "\n";
+    buffer.push(`[mcp_servers.${entry.name}]`);
+    buffer.push(`command = ${tomlString(entry.command)}`);
+    buffer.push(`args = [${entry.args.map(tomlString).join(", ")}]`);
+    buffer.push("");
+    buffer.push(`[mcp_servers.${entry.name}.env]`);
+    for (const [k, v] of Object.entries(entry.env)) {
+        buffer.push(`${k} = ${tomlString(v)}`);
+    }
+    buffer.push("");
+    return prefix + buffer.join("\n");
+}
+function tomlString(value) {
+    // TOML basic strings share JSON escaping conventions for ASCII with \n/\t/\"/\\.
+    return JSON.stringify(value);
+}
+function resultWritten(host, target, name, backup) {
+    return action(host, target, name, "written", backup);
+}
+function resultSkipped(host, target, name) {
+    return action(host, target, name, "skipped-idempotent", null);
+}
+function resultDryRun(host, target, name, diff) {
+    return { ...action(host, target, name, "dry-run", null), diff };
+}
+function action(host, target, name, status, backup) {
+    return { host, target, name, action: status, backup };
+}
+//# sourceMappingURL=mcp-host-writer.js.map