sync-agents-settings 0.3.0 → 0.4.0

package/dist/reconcile.js

@@ -0,0 +1,122 @@
+import { createBackup, getFilesToBackup } from "./backup.js";
+import { runDoctor } from "./doctor.js";
+import { readClaudeMcpServers } from "./reader.js";
+import { validateServersForTargets, } from "./validation.js";
+import { isOAuthOnlyServer } from "./oauth.js";
+import { writeToGemini } from "./writers/gemini.js";
+import { writeToCodex, resolveCodexConfigPath } from "./writers/codex.js";
+import { writeToOpenCode } from "./writers/opencode.js";
+import { writeToKiro } from "./writers/kiro.js";
+import { writeToCursor } from "./writers/cursor.js";
+import { writeToKimi, resolveKimiMcpConfigPath } from "./writers/kimi.js";
+export function reconcileTargets(targets, options = {}) {
+    let servers = readClaudeMcpServers();
+    if (options.skipOAuth) {
+        servers = servers.filter((server) => !isOAuthOnlyServer(server));
+    }
+    const validation = validateServersForTargets(servers, targets, { skipOAuth: options.skipOAuth });
+    if (validation.errorCount > 0) {
+        return {
+            status: "validation_failed",
+            validation,
+            syncResults: [],
+        };
+    }
+    const doctor = runDoctor(targets, {
+        skipOAuth: options.skipOAuth,
+        codexHome: options.codexHome,
+        kimiHome: options.kimiHome,
+    });
+    if (doctor.hasErrors) {
+        return {
+            status: "doctor_failed",
+            validation,
+            doctor,
+            syncResults: [],
+        };
+    }
+    if (!doctor.hasDrift) {
+        return {
+            status: "noop",
+            validation,
+            doctor,
+            syncResults: [],
+        };
+    }
+    const mapByName = new Map(servers.map((server) => [server.name, server]));
+    const targetsToSync = [];
+    const plan = new Map();
+    const syncResults = [];
+    for (const result of doctor.results) {
+        if (result.status !== "drift" || result.missing.length === 0)
+            continue;
+        targetsToSync.push(result.target);
+        const neededServers = result.missing
+            .map((name) => mapByName.get(name))
+            .filter((server) => Boolean(server));
+        plan.set(result.target, neededServers);
+    }
+    let backupDir;
+    if (!options.dryRun && !options.skipBackup && targetsToSync.length > 0) {
+        const codexConfigPath = resolveCodexConfigPath(options.codexHome);
+        const kimiConfigPath = resolveKimiMcpConfigPath(options.kimiHome);
+        backupDir = createBackup(getFilesToBackup(targetsToSync, codexConfigPath, kimiConfigPath));
+    }
+    for (const result of doctor.results) {
+        if (result.status !== "drift" || result.missing.length === 0)
+            continue;
+        const neededServers = plan.get(result.target) ?? [];
+        const writeResult = writeTarget(result.target, neededServers, Boolean(options.dryRun), options.codexHome, options.kimiHome);
+        syncResults.push({
+            target: result.target,
+            missing: result.missing,
+            added: writeResult.added,
+            skipped: writeResult.skipped,
+        });
+    }
+    return {
+        status: "reconciled",
+        validation,
+        doctor,
+        syncResults,
+        backupDir,
+    };
+}
+function writeTarget(target, servers, dryRun, codexHome, kimiHome) {
+    if (target === "gemini") {
+        return writeToGemini(servers, dryRun);
+    }
+    if (target === "codex") {
+        const { added, skipped } = writeToCodex(servers, dryRun, codexHome);
+        return { added, skipped };
+    }
+    if (target === "opencode") {
+        return writeToOpenCode(servers, dryRun);
+    }
+    if (target === "kiro") {
+        return writeToKiro(servers, dryRun);
+    }
+    if (target === "kimi") {
+        const { added, skipped } = writeToKimi(servers, dryRun, kimiHome);
+        return { added, skipped };
+    }
+    return writeToCursor(servers, dryRun);
+}
+export function groupValidationByTarget(issues, targets) {
+    const grouped = {
+        gemini: [],
+        codex: [],
+        opencode: [],
+        kiro: [],
+        kimi: [],
+        cursor: [],
+    };
+    for (const target of targets) {
+        grouped[target] ??= [];
+    }
+    for (const issue of issues) {
+        grouped[issue.target].push(issue);
+    }
+    return grouped;
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/reconcile.js.map

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

package/dist/report-parser.d.ts

@@ -0,0 +1,81 @@
+export declare const SUPPORTED_REPORT_SCHEMA_VERSION = 1;
+type ParsedReport = {
+    schemaVersion: number;
+    command?: string;
+    [key: string]: unknown;
+};
+export type KnownReportCommand = "sync" | "diff" | "doctor" | "validate" | "reconcile" | "sync-instructions";
+export declare const KNOWN_REPORT_COMMANDS: KnownReportCommand[];
+type RequiredFieldType = "array" | "number" | "boolean" | "string";
+interface RequiredFieldSpec {
+    field: string;
+    type: RequiredFieldType;
+}
+export interface ValidateReportV1 {
+    schemaVersion: 1;
+    command: "validate";
+    issues: unknown[];
+    errorCount: number;
+    warningCount: number;
+    [key: string]: unknown;
+}
+export interface DoctorReportV1 {
+    schemaVersion: 1;
+    command: "doctor";
+    hasDrift: boolean;
+    hasErrors: boolean;
+    [key: string]: unknown;
+}
+export interface SyncReportV1 {
+    schemaVersion: 1;
+    command: "sync";
+    targets: unknown[];
+    [key: string]: unknown;
+}
+export interface DiffReportV1 {
+    schemaVersion: 1;
+    command: "diff";
+    targets: unknown[];
+    sourceNames: string[];
+    [key: string]: unknown;
+}
+export interface ReconcileReportV1 {
+    schemaVersion: 1;
+    command: "reconcile";
+    status: string;
+    syncResults: unknown[];
+    [key: string]: unknown;
+}
+export interface SyncInstructionsReportV1 {
+    schemaVersion: 1;
+    command: "sync-instructions";
+    unsupportedGlobalTargets: string[];
+    [key: string]: unknown;
+}
+export type KnownJsonReport = ValidateReportV1 | DoctorReportV1 | SyncReportV1 | DiffReportV1 | ReconcileReportV1 | SyncInstructionsReportV1;
+type ParseErrorCode = "INVALID_JSON" | "MISSING_SCHEMA_VERSION" | "UNSUPPORTED_SCHEMA_VERSION" | "INVALID_COMMAND_PAYLOAD" | "UNKNOWN_COMMAND";
+export type ParseJsonReportResult = {
+    ok: true;
+    data: ParsedReport;
+} | {
+    ok: false;
+    error: {
+        code: ParseErrorCode;
+        message: string;
+    };
+};
+export type ParseKnownJsonReportResult = {
+    ok: true;
+    data: KnownJsonReport;
+} | {
+    ok: false;
+    error: {
+        code: ParseErrorCode;
+        message: string;
+    };
+};
+export declare function parseJsonReport(raw: string): ParseJsonReportResult;
+export declare function parseKnownJsonReport(raw: string): ParseKnownJsonReportResult;
+export declare const COMMAND_REQUIRED_FIELDS: Record<KnownReportCommand, RequiredFieldSpec[]>;
+export declare const COMMAND_PAYLOAD_VALIDATORS: Record<KnownReportCommand, (report: ParsedReport) => boolean>;
+export {};

package/dist/report-parser.js

@@ -0,0 +1,129 @@
+export const SUPPORTED_REPORT_SCHEMA_VERSION = 1;
+export const KNOWN_REPORT_COMMANDS = [
+    "sync",
+    "diff",
+    "doctor",
+    "validate",
+    "reconcile",
+    "sync-instructions",
+];
+export function parseJsonReport(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return {
+            ok: false,
+            error: {
+                code: "INVALID_JSON",
+                message: "Input is not valid JSON.",
+            },
+        };
+    }
+    if (!parsed || typeof parsed !== "object") {
+        return {
+            ok: false,
+            error: {
+                code: "MISSING_SCHEMA_VERSION",
+                message: "Report must be a JSON object with schemaVersion.",
+            },
+        };
+    }
+    const schemaVersion = parsed.schemaVersion;
+    if (typeof schemaVersion !== "number") {
+        return {
+            ok: false,
+            error: {
+                code: "MISSING_SCHEMA_VERSION",
+                message: "schemaVersion is required.",
+            },
+        };
+    }
+    if (schemaVersion !== SUPPORTED_REPORT_SCHEMA_VERSION) {
+        return {
+            ok: false,
+            error: {
+                code: "UNSUPPORTED_SCHEMA_VERSION",
+                message: `Unsupported schemaVersion ${schemaVersion}. Expected ${SUPPORTED_REPORT_SCHEMA_VERSION}.`,
+            },
+        };
+    }
+    const report = parsed;
+    if (!isValidCommandPayload(report)) {
+        return {
+            ok: false,
+            error: {
+                code: "INVALID_COMMAND_PAYLOAD",
+                message: "Report payload does not match required fields for its command.",
+            },
+        };
+    }
+    return { ok: true, data: report };
+}
+export function parseKnownJsonReport(raw) {
+    const parsed = parseJsonReport(raw);
+    if (!parsed.ok) {
+        return parsed;
+    }
+    if (!isKnownReportCommand(parsed.data.command)) {
+        return {
+            ok: false,
+            error: {
+                code: "UNKNOWN_COMMAND",
+                message: `Unsupported command in report: ${String(parsed.data.command)}`,
+            },
+        };
+    }
+    return { ok: true, data: parsed.data };
+}
+function isValidCommandPayload(report) {
+    if (typeof report.command !== "string") {
+        return true;
+    }
+    if (isKnownReportCommand(report.command)) {
+        return COMMAND_PAYLOAD_VALIDATORS[report.command](report);
+    }
+    // Unknown command: keep parser forward-compatible as long as schemaVersion matches.
+    return true;
+}
+function isKnownReportCommand(value) {
+    return typeof value === "string" && KNOWN_REPORT_COMMANDS.includes(value);
+}
+export const COMMAND_REQUIRED_FIELDS = {
+    sync: [{ field: "targets", type: "array" }],
+    diff: [
+        { field: "targets", type: "array" },
+        { field: "sourceNames", type: "array" },
+    ],
+    doctor: [
+        { field: "hasDrift", type: "boolean" },
+        { field: "hasErrors", type: "boolean" },
+    ],
+    validate: [
+        { field: "errorCount", type: "number" },
+        { field: "warningCount", type: "number" },
+    ],
+    reconcile: [
+        { field: "status", type: "string" },
+        { field: "syncResults", type: "array" },
+    ],
+    "sync-instructions": [{ field: "unsupportedGlobalTargets", type: "array" }],
+};
+export const COMMAND_PAYLOAD_VALIDATORS = {
+    sync: (report) => hasRequiredFields(report, COMMAND_REQUIRED_FIELDS.sync),
+    diff: (report) => hasRequiredFields(report, COMMAND_REQUIRED_FIELDS.diff),
+    doctor: (report) => hasRequiredFields(report, COMMAND_REQUIRED_FIELDS.doctor),
+    validate: (report) => hasRequiredFields(report, COMMAND_REQUIRED_FIELDS.validate),
+    reconcile: (report) => hasRequiredFields(report, COMMAND_REQUIRED_FIELDS.reconcile),
+    "sync-instructions": (report) => hasRequiredFields(report, COMMAND_REQUIRED_FIELDS["sync-instructions"]),
+};
+function hasRequiredFields(report, specs) {
+    return specs.every((spec) => matchesFieldType(report[spec.field], spec.type));
+}
+function matchesFieldType(value, type) {
+    if (type === "array")
+        return Array.isArray(value);
+    return typeof value === type;
+}
+//# sourceMappingURL=report-parser.js.map

package/dist/report-parser.js.map

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

package/dist/report-schema-renderer.d.ts

@@ -0,0 +1,2 @@
+export declare function renderReportRequiredFieldsMarkdown(): string;
+export declare function generateReportSchemaDocument(): string;

package/dist/report-schema-renderer.js

@@ -0,0 +1,129 @@
+import { KNOWN_REPORT_COMMANDS, COMMAND_REQUIRED_FIELDS } from "./report-parser.js";
+export function renderReportRequiredFieldsMarkdown() {
+    const lines = [];
+    lines.push("## Required Fields (Generated)");
+    lines.push("");
+    lines.push("Generated from `src/report-parser.ts` `COMMAND_REQUIRED_FIELDS`.");
+    lines.push("");
+    for (const command of KNOWN_REPORT_COMMANDS) {
+        lines.push(`### \`${command}\``);
+        const specs = COMMAND_REQUIRED_FIELDS[command];
+        for (const spec of specs) {
+            lines.push(`- \`${spec.field}\` (${spec.type})`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trim() + "\n";
+}
+export function generateReportSchemaDocument() {
+    const sections = [
+        "# Report Schema",
+        "",
+        "This document defines the machine-readable JSON payloads returned by commands with `--report json`.",
+        "",
+        "## Common Contract",
+        "",
+        "- Every report payload includes `schemaVersion`.",
+        "- Current value: `schemaVersion: 1`.",
+        "- Consumers should reject unknown major schema versions.",
+        "- Use `src/report-parser.ts` (`parseJsonReport`) as the canonical parser helper for downstream integrations.",
+        "- For strict typed consumption, use `parseKnownJsonReport` + `KnownJsonReport` (discriminated union by `command`).",
+        "- Parser error codes:",
+        "  - `INVALID_JSON`",
+        "  - `MISSING_SCHEMA_VERSION`",
+        "  - `UNSUPPORTED_SCHEMA_VERSION`",
+        "  - `INVALID_COMMAND_PAYLOAD` (schema version is valid but required fields for the `command` payload are missing or wrong type)",
+        "  - `UNKNOWN_COMMAND`",
+        "- Command payload checks are implemented via a single validator map (`COMMAND_PAYLOAD_VALIDATORS`) in `src/report-parser.ts`.",
+        "",
+        "## Commands",
+        "",
+        "### `sync --report json`",
+        "",
+        "Top-level fields:",
+        "- `schemaVersion: number`",
+        '- `command: "sync"`',
+        "- `sourceCount: number`",
+        "- `dryRun: boolean`",
+        "- `skipOAuth: boolean`",
+        "- `targets: Array<{ target, added, skipped, configPath? }>`",
+        "",
+        "### `diff --report json`",
+        "",
+        "Top-level fields:",
+        "- `schemaVersion: number`",
+        '- `command: "diff"`',
+        "- `sourceCount: number`",
+        "- `sourceNames: string[]`",
+        "- `targets: Array<{ target, shared, onlyInSource, onlyInTarget, note? }>`",
+        "",
+        "### `doctor --report json`",
+        "",
+        "Top-level fields:",
+        "- `schemaVersion: number`",
+        '- `command: "doctor"`',
+        "- `resultCount: number`",
+        "- `sourceCount: number`",
+        "- `sourceNames: string[]`",
+        "- `hasDrift: boolean`",
+        "- `hasErrors: boolean`",
+        "- `results: Array<{ target, status, missing, extra, note? }>`",
+        "",
+        "Exit codes:",
+        "- `0`: no drift",
+        "- `1`: drift found",
+        "- `2`: target parse error",
+        "",
+        "### `validate --report json`",
+        "",
+        "Top-level fields:",
+        "- `schemaVersion: number`",
+        '- `command: "validate"`',
+        "- `issues: Array<{ target, server, severity, code, message }>`",
+        "- `errorCount: number`",
+        "- `warningCount: number`",
+        "",
+        "Exit codes:",
+        "- `0`: no validation errors (warnings allowed)",
+        "- `2`: validation errors found",
+        "",
+        "### `reconcile --report json`",
+        "",
+        "Top-level fields:",
+        "- `schemaVersion: number`",
+        '- `command: "reconcile"`',
+        '- `status: "validation_failed" | "doctor_failed" | "noop" | "reconciled"`',
+        "- `validation: { issues, errorCount, warningCount }`",
+        "- `doctor?: { ...doctor payload subset }`",
+        "- `syncResults: Array<{ target, missing, added, skipped }>`",
+        "- `backupDir?: string`",
+        "",
+        "### `sync-instructions --report json`",
+        "",
+        "Top-level fields:",
+        "- `schemaVersion: number`",
+        '- `command: "sync-instructions"`',
+        "- `unsupportedGlobalTargets: string[]`",
+        "- `global?: { synced, skipped, appended }`",
+        "- `local?: { synced, skipped, appended }`",
+        "",
+        "Notes:",
+        "- To keep JSON output clean in non-dry-run mode, use `--on-conflict` and `--no-backup`.",
+        "- In JSON mode, the CLI uses a non-interactive conflict strategy.",
+        "",
+        "## Minimal Examples",
+        "",
+        "```json",
+        '{ "schemaVersion": 1, "command": "validate", "issues": [], "errorCount": 0, "warningCount": 0 }',
+        "```",
+        "",
+        "```json",
+        '{ "schemaVersion": 1, "command": "doctor", "resultCount": 1, "hasDrift": false, "hasErrors": false, "results": [] }',
+        "```",
+        "",
+        renderReportRequiredFieldsMarkdown().trim(),
+        "",
+    ];
+    return sections.join("\n").trim() + "\n";
+}
+//# sourceMappingURL=report-schema-renderer.js.map

package/dist/report-schema-renderer.js.map

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

package/dist/report-schema-sync.d.ts

@@ -0,0 +1,9 @@
+type CheckReason = "ok" | "missing" | "diff";
+export interface ReportSchemaCheckResult {
+    upToDate: boolean;
+    reason: CheckReason;
+    generated: string;
+    current?: string;
+}
+export declare function checkReportSchemaUpToDate(targetPath: string): ReportSchemaCheckResult;
+export {};

package/dist/report-schema-sync.js

@@ -0,0 +1,28 @@
+import { existsSync, readFileSync } from "node:fs";
+import { generateReportSchemaDocument } from "./report-schema-renderer.js";
+export function checkReportSchemaUpToDate(targetPath) {
+    const generated = generateReportSchemaDocument();
+    if (!existsSync(targetPath)) {
+        return {
+            upToDate: false,
+            reason: "missing",
+            generated,
+        };
+    }
+    const current = readFileSync(targetPath, "utf-8");
+    if (current !== generated) {
+        return {
+            upToDate: false,
+            reason: "diff",
+            generated,
+            current,
+        };
+    }
+    return {
+        upToDate: true,
+        reason: "ok",
+        generated,
+        current,
+    };
+}
+//# sourceMappingURL=report-schema-sync.js.map

package/dist/report-schema-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-schema-sync.js","sourceRoot":"","sources":["../src/report-schema-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAW3E,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,MAAM,SAAS,GAAG,4BAA4B,EAAE,CAAC;IAEjD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,SAAS;YACjB,SAAS;SACV,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,MAAM;YACd,SAAS;YACT,OAAO;SACR,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;QACZ,SAAS;QACT,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/report.d.ts

@@ -0,0 +1,47 @@
+import type { DoctorReport } from "./doctor.js";
+import type { ReconcileResult } from "./reconcile.js";
+import type { ValidationReport } from "./validation.js";
+import type { SyncTarget } from "./types.js";
+import type { SyncInstructionsResult } from "./instructions.js";
+interface SyncTargetReport {
+    target: SyncTarget;
+    added: string[];
+    skipped: string[];
+    configPath?: string;
+}
+interface SyncReportPayload {
+    schemaVersion: number;
+    command: "sync";
+    sourceCount: number;
+    dryRun: boolean;
+    skipOAuth: boolean;
+    targets: SyncTargetReport[];
+}
+interface SyncInstructionsReportPayload {
+    schemaVersion: number;
+    command: "sync-instructions";
+    unsupportedGlobalTargets: string[];
+    global?: SyncInstructionsResult;
+    local?: SyncInstructionsResult;
+}
+interface DiffTargetReport {
+    target: string;
+    shared: string[];
+    onlyInSource: string[];
+    onlyInTarget: string[];
+    note?: string;
+}
+interface DiffReportPayload {
+    schemaVersion: number;
+    command: "diff";
+    sourceCount: number;
+    sourceNames: string[];
+    targets: DiffTargetReport[];
+}
+export declare function formatReconcileReport(result: ReconcileResult): string;
+export declare function formatDoctorReport(report: DoctorReport): string;
+export declare function formatValidationReport(report: ValidationReport): string;
+export declare function formatSyncReport(report: Omit<SyncReportPayload, "command" | "schemaVersion">): string;
+export declare function formatSyncInstructionsReport(report: Omit<SyncInstructionsReportPayload, "command" | "schemaVersion">): string;
+export declare function formatDiffReport(report: Omit<DiffReportPayload, "command" | "schemaVersion">): string;
+export {};

package/dist/report.js

@@ -0,0 +1,55 @@
+const REPORT_SCHEMA_VERSION = 1;
+export function formatReconcileReport(result) {
+    const payload = {
+        schemaVersion: REPORT_SCHEMA_VERSION,
+        command: "reconcile",
+        status: result.status,
+        validation: result.validation,
+        doctor: result.doctor,
+        syncResults: result.syncResults,
+        backupDir: result.backupDir,
+    };
+    return JSON.stringify(payload, null, 2);
+}
+export function formatDoctorReport(report) {
+    const payload = {
+        schemaVersion: REPORT_SCHEMA_VERSION,
+        command: "doctor",
+        resultCount: report.results.length,
+        ...report,
+    };
+    return JSON.stringify(payload, null, 2);
+}
+export function formatValidationReport(report) {
+    const payload = {
+        schemaVersion: REPORT_SCHEMA_VERSION,
+        command: "validate",
+        ...report,
+    };
+    return JSON.stringify(payload, null, 2);
+}
+export function formatSyncReport(report) {
+    const payload = {
+        schemaVersion: REPORT_SCHEMA_VERSION,
+        command: "sync",
+        ...report,
+    };
+    return JSON.stringify(payload, null, 2);
+}
+export function formatSyncInstructionsReport(report) {
+    const payload = {
+        schemaVersion: REPORT_SCHEMA_VERSION,
+        command: "sync-instructions",
+        ...report,
+    };
+    return JSON.stringify(payload, null, 2);
+}
+export function formatDiffReport(report) {
+    const payload = {
+        schemaVersion: REPORT_SCHEMA_VERSION,
+        command: "diff",
+        ...report,
+    };
+    return JSON.stringify(payload, null, 2);
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAMA,MAAM,qBAAqB,GAAG,CAAC,CAAC;AA+DhC,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,qBAAqB;QACpC,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,OAAO,GAAwB;QACnC,aAAa,EAAE,qBAAqB;QACpC,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;QAClC,GAAG,MAAM;KACV,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,MAAM,OAAO,GAA4B;QACvC,aAAa,EAAE,qBAAqB;QACpC,OAAO,EAAE,UAAU;QACnB,GAAG,MAAM;KACV,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAA4D;IAE5D,MAAM,OAAO,GAAsB;QACjC,aAAa,EAAE,qBAAqB;QACpC,OAAO,EAAE,MAAM;QACf,GAAG,MAAM;KACV,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,MAAwE;IAExE,MAAM,OAAO,GAAkC;QAC7C,aAAa,EAAE,qBAAqB;QACpC,OAAO,EAAE,mBAAmB;QAC5B,GAAG,MAAM;KACV,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAA4D;IAE5D,MAAM,OAAO,GAAsB;QACjC,aAAa,EAAE,qBAAqB;QACpC,OAAO,EAAE,MAAM;QACf,GAAG,MAAM;KACV,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/types.d.ts

@@ -70,4 +70,4 @@ export interface UnifiedMcpServer {
     headers?: Record<string, string>;
     oauth?: Record<string, unknown>;
 }
-export type SyncTarget = "gemini" | "codex" | "opencode" | "kiro" | "cursor";
+export type SyncTarget = "gemini" | "codex" | "opencode" | "kiro" | "cursor" | "kimi";

package/dist/validation.d.ts

@@ -0,0 +1,18 @@
+import type { SyncTarget, UnifiedMcpServer } from "./types.js";
+export type ValidationSeverity = "error" | "warning";
+export interface ValidationIssue {
+    target: SyncTarget;
+    server: string;
+    severity: ValidationSeverity;
+    code: "INVALID_STDIO_COMMAND_REQUIRED" | "INVALID_REMOTE_URL_REQUIRED" | "CODEX_UNSUPPORTED_HEADERS" | "OAUTH_MANUAL_SETUP_REQUIRED";
+    message: string;
+}
+export interface ValidationReport {
+    issues: ValidationIssue[];
+    errorCount: number;
+    warningCount: number;
+}
+export interface ValidationOptions {
+    skipOAuth?: boolean;
+}
+export declare function validateServersForTargets(servers: UnifiedMcpServer[], targets: SyncTarget[], options?: ValidationOptions): ValidationReport;