@atbas/m-mcp 0.1.0

package/dist/install/cli.js

@@ -0,0 +1,274 @@
+import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { createInterface } from 'node:readline/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { packageRoot } from '../paths.js';
+import { SERVER_NAME } from '../version.js';
+import { HARNESSES, findHarness, readJsonMcpServer, tomlHasMcpServer, upsertJsonMcpServer, upsertTomlMcpServer, } from './harnesses.js';
+export function parseArguments(argv) {
+    const targets = [];
+    let all = false;
+    let list = false;
+    let remove = false;
+    let dryRun = false;
+    let name = SERVER_NAME;
+    let help = false;
+    for (const argument of argv) {
+        if (argument === '--all')
+            all = true;
+        else if (argument === '--list')
+            list = true;
+        else if (argument === '--remove' || argument === '--uninstall')
+            remove = true;
+        else if (argument === '--dry-run')
+            dryRun = true;
+        else if (argument === '--help' || argument === '-h')
+            help = true;
+        else if (argument.startsWith('--target='))
+            targets.push(...argument.slice('--target='.length).split(','));
+        else if (argument.startsWith('--name='))
+            name = argument.slice('--name='.length);
+    }
+    return { targets: targets.map((value) => value.trim()).filter(Boolean), all, list, remove, dryRun, name, help };
+}
+const USAGE = `
+Register the JazzCash MCP server with your AI harness.
+
+  npm run deploy                        pick interactively
+  npm run deploy -- --list              show what is detected and what is installed
+  npm run deploy -- --all               install into every detected harness
+  npm run deploy -- --target=claude,codex
+  npm run deploy -- --remove --all      uninstall
+  npm run deploy -- --dry-run --all     show the changes without writing
+
+Harnesses: ${HARNESSES.map((harness) => harness.id).join(', ')}
+
+Credentials are optional. 13 of the 17 tools — documentation, code generation,
+hash checking, validation, diagnosis — need none. The four that call the gateway
+read them from the process environment: set them in your harness's own "env"
+block, or point JAZZCASH_CREDENTIALS_FILE at a file kept outside any repository.
+`;
+export function inspect(harness, name) {
+    const present = harness.configPaths().filter((path) => existsSync(path));
+    const installed = present.some((path) => {
+        try {
+            const contents = readFileSync(path, 'utf8');
+            return harness.format === 'json'
+                ? readJsonMcpServer(contents, name) !== undefined
+                : tomlHasMcpServer(contents, name);
+        }
+        catch {
+            return false;
+        }
+    });
+    return { harness, present, installed };
+}
+function serverEntry() {
+    // Absolute, forward-slashed: every harness accepts it and it avoids the
+    // backslash-escaping differences between JSON and TOML.
+    const entry = join(packageRoot(), 'dist', 'index.js').replace(/\\/g, '/');
+    return { command: process.execPath.replace(/\\/g, '/'), args: [entry] };
+}
+function backup(path) {
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const target = `${path}.jazzcash-backup-${stamp}`;
+    // The copy is byte-for-byte, so it carries the `env` blocks of every other
+    // server in the file — API tokens included. It is therefore created readable
+    // and writable by its owner only. Windows ignores the mode bits; there the
+    // backup inherits the ACL of the directory the original already sits in.
+    writeFileSync(target, readFileSync(path), { mode: 0o600 });
+    return target;
+}
+/**
+ * Replace a file's contents without ever leaving it half-written.
+ *
+ * The target holds every other MCP server the user has configured. Overwriting
+ * it in place turns an interrupted write into a truncated, unparseable config;
+ * writing a sibling temporary file and renaming it over the target makes the
+ * replacement atomic on POSIX and on Windows alike.
+ */
+function writeAtomically(path, contents) {
+    const temporaryPath = `${path}.jazzcash-tmp-${String(process.pid)}`;
+    try {
+        writeFileSync(temporaryPath, contents, 'utf8');
+        renameSync(temporaryPath, path);
+    }
+    catch (error) {
+        rmSync(temporaryPath, { force: true });
+        throw error;
+    }
+}
+export function applyToFile(harness, path, name, entry, dryRun) {
+    const exists = existsSync(path);
+    if (!exists && !harness.createIfMissing) {
+        return { path, action: 'skipped', reason: 'configuration file not found; is the harness installed?' };
+    }
+    const current = exists ? readFileSync(path, 'utf8') : '';
+    const updated = harness.format === 'json' ? upsertJsonMcpServer(current, name, entry) : upsertTomlMcpServer(current, name, entry);
+    if (updated === current) {
+        return { path, action: 'skipped', reason: 'already up to date' };
+    }
+    if (dryRun) {
+        return { path, action: 'would-write' };
+    }
+    const backupPath = exists ? backup(path) : undefined;
+    mkdirSync(dirname(path), { recursive: true });
+    writeAtomically(path, updated);
+    return backupPath === undefined ? { path, action: 'written' } : { path, action: 'written', backupPath };
+}
+export function apply(state, name, remove, dryRun) {
+    const entry = remove ? undefined : serverEntry();
+    const paths = state.present.length > 0
+        ? state.present
+        : state.harness.createIfMissing
+            ? [state.harness.configPaths()[0] ?? '']
+            : [];
+    if (paths.length === 0) {
+        return [{ path: state.harness.configPaths()[0] ?? '(unknown)', action: 'skipped', reason: 'harness not detected' }];
+    }
+    return paths.map((path) => applyToFile(state.harness, path, name, entry, dryRun));
+}
+async function chooseInteractively(states) {
+    if (!process.stdin.isTTY) {
+        throw new Error('No terminal available for the interactive picker. Use --target=<ids>, --all or --list.');
+    }
+    process.stdout.write('\nWhich harnesses should the JazzCash MCP server be installed into?\n\n');
+    states.forEach((state, index) => {
+        const detected = state.present.length > 0 ? 'detected' : 'not detected';
+        const installed = state.installed ? ', already installed' : '';
+        process.stdout.write(`  ${String(index + 1)}. ${state.harness.label} (${detected}${installed})\n`);
+    });
+    process.stdout.write('  a. all detected\n\n');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = (await rl.question('Select (e.g. 1,3 or a): ')).trim().toLowerCase();
+        if (answer === 'a' || answer === 'all') {
+            return states.filter((state) => state.present.length > 0).map((state) => state.harness.id);
+        }
+        return answer
+            .split(',')
+            .map((token) => Number.parseInt(token.trim(), 10))
+            .filter((index) => Number.isInteger(index) && index >= 1 && index <= states.length)
+            .map((index) => states[index - 1]?.harness.id ?? '')
+            .filter(Boolean);
+    }
+    finally {
+        rl.close();
+    }
+}
+function reportList(states, name) {
+    process.stdout.write(`\nMCP server name: ${name}\n`);
+    process.stdout.write(`Server entry:    ${serverEntry().command} ${serverEntry().args.join(' ')}\n\n`);
+    for (const state of states) {
+        const detected = state.present.length > 0;
+        process.stdout.write(`  ${state.harness.label.padEnd(14)} ${detected ? 'detected' : 'not detected'}`);
+        process.stdout.write(state.installed ? '  [installed]\n' : '\n');
+        for (const path of state.present) {
+            process.stdout.write(`      ${path}\n`);
+        }
+        if (!detected) {
+            process.stdout.write(`      would create ${state.harness.configPaths()[0] ?? ''}\n`);
+        }
+    }
+    process.stdout.write('\n');
+}
+async function main() {
+    const options = parseArguments(process.argv.slice(2));
+    if (options.help) {
+        process.stdout.write(USAGE);
+        return;
+    }
+    const distEntry = join(packageRoot(), 'dist', 'index.js');
+    if (!existsSync(distEntry)) {
+        throw new Error(`${distEntry} does not exist. Run "npm run build" first.`);
+    }
+    const states = HARNESSES.map((harness) => inspect(harness, options.name));
+    if (options.list) {
+        reportList(states, options.name);
+        return;
+    }
+    let selected;
+    if (options.all) {
+        selected = states.map((state) => state.harness.id);
+    }
+    else if (options.targets.length > 0) {
+        const unknown = options.targets.filter((target) => findHarness(target) === undefined);
+        if (unknown.length > 0) {
+            throw new Error(`Unknown harness: ${unknown.join(', ')}. Known: ${HARNESSES.map((h) => h.id).join(', ')}.`);
+        }
+        selected = options.targets;
+    }
+    else {
+        selected = await chooseInteractively(states);
+    }
+    if (selected.length === 0) {
+        process.stdout.write('Nothing selected. No changes made.\n');
+        return;
+    }
+    const verb = options.remove ? 'Removing' : 'Installing';
+    process.stdout.write(`\n${verb} "${options.name}"${options.dryRun ? ' (dry run)' : ''}\n\n`);
+    let changed = 0;
+    let backedUp = 0;
+    for (const id of selected) {
+        const state = states.find((candidate) => candidate.harness.id === id);
+        if (state === undefined) {
+            continue;
+        }
+        process.stdout.write(`  ${state.harness.label}\n`);
+        for (const outcome of apply(state, options.name, options.remove, options.dryRun)) {
+            if (outcome.action === 'skipped') {
+                process.stdout.write(`    - skipped: ${outcome.reason ?? ''}\n`);
+                continue;
+            }
+            changed += 1;
+            process.stdout.write(`    ${outcome.action === 'written' ? 'updated' : 'would update'} ${outcome.path}\n`);
+            if (outcome.backupPath !== undefined) {
+                backedUp += 1;
+                process.stdout.write(`      backup: ${outcome.backupPath}\n`);
+            }
+        }
+        if (!options.dryRun && !options.remove) {
+            process.stdout.write(`    ${state.harness.reloadHint}\n`);
+        }
+    }
+    process.stdout.write(changed === 0
+        ? '\nNo changes were needed.\n'
+        : `\n${String(changed)} file(s) ${options.dryRun ? 'would be ' : ''}updated.\n`);
+    if (backedUp > 0) {
+        process.stdout.write('\nThe backups listed above are complete copies of the previous configuration,\n' +
+            "so they can contain other servers' credentials. Nothing prunes them: delete\n" +
+            'them yourself once the new configuration is working.\n');
+    }
+    if (!options.remove && !options.dryRun) {
+        process.stdout.write('\nCredentials are optional: 13 of 17 tools work without any. Configure them only\n' +
+            'when you want to call the gateway — see docs/mcp/CONFIGURATION.md.\n');
+    }
+}
+/**
+ * True when this file was started as a script rather than imported.
+ *
+ * `npm run deploy` runs it directly; the tests import it to exercise the file
+ * transforms, and a bare `main()` at module scope would rewrite the developer's
+ * own harness configuration the moment the suite loaded the module. Both sides
+ * are resolved through `realpathSync` so a symlinked bin shim, and Windows'
+ * indifference to path casing, still compare equal.
+ */
+function invokedAsScript() {
+    const entry = process.argv[1];
+    if (entry === undefined) {
+        return false;
+    }
+    try {
+        return realpathSync.native(entry) === realpathSync.native(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (invokedAsScript()) {
+    main().catch((error) => {
+        process.stderr.write(`\ndeploy failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/install/cli.js.map

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

package/dist/install/harnesses.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Harness registration.
+ *
+ * Each supported AI harness stores MCP server definitions in its own place and
+ * its own format. The transforms below are pure so they can be unit-tested
+ * without touching a real configuration file, and every one of them preserves
+ * unrelated content: these files hold the user's other servers and settings, and
+ * a deploy script that clobbers them would be worse than no deploy script.
+ *
+ * That guarantee extends to this server's own entry. Re-registering updates the
+ * `command` and `args` and nothing else, because the surrounding `env` block is
+ * where the harness passes the merchant's JAZZCASH_* credentials in — a
+ * re-deploy that dropped it would silently deconfigure the gateway tools.
+ */
+export declare const HARNESS_IDS: readonly ["claude", "codex", "antigravity"];
+export type HarnessId = (typeof HARNESS_IDS)[number];
+/** A stdio MCP server definition. */
+export interface ServerEntry {
+    readonly command: string;
+    readonly args: readonly string[];
+}
+export type ConfigFormat = 'json' | 'toml';
+export interface HarnessDescriptor {
+    readonly id: HarnessId;
+    readonly label: string;
+    readonly format: ConfigFormat;
+    /**
+     * Candidate configuration paths, most canonical first.
+     *
+     * Several harnesses keep more than one; writing to all that already exist is
+     * more reliable than guessing which the installed build reads.
+     */
+    configPaths(home?: string): readonly string[];
+    /**
+     * Whether a missing file should be created.
+     *
+     * True where the file is the documented location and its absence just means
+     * the user has never added a server.
+     */
+    readonly createIfMissing: boolean;
+    /** How the harness is told to reload. Shown after a successful write. */
+    readonly reloadHint: string;
+}
+export declare const HARNESSES: readonly HarnessDescriptor[];
+export declare function findHarness(id: string): HarnessDescriptor | undefined;
+/**
+ * Add, update or remove a server in a `{ "mcpServers": { … } }` document.
+ *
+ * An existing entry is merged, not replaced: only `command` and `args` are
+ * rewritten, so an `env` block and any other key the harness understands survive
+ * a re-deploy. Unrelated keys and unrelated servers are preserved exactly. An
+ * empty or whitespace-only document is treated as `{}` so a fresh file can be
+ * created.
+ */
+export declare function upsertJsonMcpServer(contents: string, name: string, entry: ServerEntry | undefined): string;
+/** Read the current definition of one server from a JSON document, if present. */
+export declare function readJsonMcpServer(contents: string, name: string): unknown;
+/**
+ * Add, update or remove `[mcp_servers.<name>]` in a TOML document.
+ *
+ * The table and any sub-tables (such as an `.env` block) are lifted out, each
+ * stopping at the next table header so neighbouring servers survive. An update
+ * puts back everything it lifted apart from `command` and `args`, so the
+ * merchant's credentials outlive a re-deploy; a removal keeps none of it.
+ *
+ * Only the lifted table is rewritten. The rest of the document is passed through
+ * line for line — deliberately, since a blank line inside a `"""…"""` value is
+ * content, and the table's own trailing blank lines leave with it, so there is
+ * nothing left to tidy up afterwards.
+ */
+export declare function upsertTomlMcpServer(contents: string, name: string, entry: ServerEntry | undefined): string;
+/** True when the TOML document already declares this server. */
+export declare function tomlHasMcpServer(contents: string, name: string): boolean;
+//# sourceMappingURL=harnesses.d.ts.map

package/dist/install/harnesses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harnesses.d.ts","sourceRoot":"","sources":["../../src/install/harnesses.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,WAAW,6CAA8C,CAAC;AAEvE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;;;OAKG;IACH,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,SAAS,EAAE,SAAS,iBAAiB,EA4BjD,CAAC;AAEF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAErE;AAaD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAgC1G;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAczE;AA8FD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAqD1G;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAExE"}

package/dist/install/harnesses.js

@@ -0,0 +1,263 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Harness registration.
+ *
+ * Each supported AI harness stores MCP server definitions in its own place and
+ * its own format. The transforms below are pure so they can be unit-tested
+ * without touching a real configuration file, and every one of them preserves
+ * unrelated content: these files hold the user's other servers and settings, and
+ * a deploy script that clobbers them would be worse than no deploy script.
+ *
+ * That guarantee extends to this server's own entry. Re-registering updates the
+ * `command` and `args` and nothing else, because the surrounding `env` block is
+ * where the harness passes the merchant's JAZZCASH_* credentials in — a
+ * re-deploy that dropped it would silently deconfigure the gateway tools.
+ */
+export const HARNESS_IDS = ['claude', 'codex', 'antigravity'];
+export const HARNESSES = [
+    {
+        id: 'claude',
+        label: 'Claude Code',
+        format: 'json',
+        configPaths: (home = homedir()) => [join(home, '.claude.json')],
+        createIfMissing: false,
+        reloadHint: 'Restart Claude Code, or run /mcp to check the connection.',
+    },
+    {
+        id: 'codex',
+        label: 'OpenAI Codex',
+        format: 'toml',
+        configPaths: (home = homedir()) => [join(home, '.codex', 'config.toml')],
+        createIfMissing: true,
+        reloadHint: 'Restart Codex. Verify with /mcp inside the CLI.',
+    },
+    {
+        id: 'antigravity',
+        label: 'Antigravity',
+        format: 'json',
+        configPaths: (home = homedir()) => [
+            join(home, '.gemini', 'antigravity', 'mcp_config.json'),
+            join(home, '.gemini', 'mcp_config.json'),
+        ],
+        createIfMissing: true,
+        reloadHint: 'Restart Antigravity, or reload the MCP servers from its settings panel.',
+    },
+];
+export function findHarness(id) {
+    return HARNESSES.find((harness) => harness.id === id);
+}
+// ---------------------------------------------------------------------------
+// JSON transforms
+// ---------------------------------------------------------------------------
+/** A shallow copy of a plain JSON object, or an empty one for anything else. */
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? { ...value }
+        : {};
+}
+/**
+ * Add, update or remove a server in a `{ "mcpServers": { … } }` document.
+ *
+ * An existing entry is merged, not replaced: only `command` and `args` are
+ * rewritten, so an `env` block and any other key the harness understands survive
+ * a re-deploy. Unrelated keys and unrelated servers are preserved exactly. An
+ * empty or whitespace-only document is treated as `{}` so a fresh file can be
+ * created.
+ */
+export function upsertJsonMcpServer(contents, name, entry) {
+    const trimmed = contents.trim();
+    let document;
+    if (trimmed === '') {
+        document = {};
+    }
+    else {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new Error('Expected the configuration file to contain a JSON object.');
+        }
+        document = { ...parsed };
+    }
+    const servers = asRecord(document['mcpServers']);
+    if (entry === undefined) {
+        // Removing a server that was never there is a no-op, not an error: `deploy
+        // --remove` should be safe to run twice. Handing back the untouched text
+        // rather than a re-serialised `{"mcpServers":{}}` also stops `--remove`
+        // creating a configuration file the user never had, matching the TOML side.
+        if (!Object.hasOwn(servers, name)) {
+            return contents;
+        }
+        delete servers[name];
+    }
+    else {
+        servers[name] = { ...asRecord(servers[name]), command: entry.command, args: [...entry.args] };
+    }
+    document['mcpServers'] = servers;
+    return `${JSON.stringify(document, null, 2)}\n`;
+}
+/** Read the current definition of one server from a JSON document, if present. */
+export function readJsonMcpServer(contents, name) {
+    const trimmed = contents.trim();
+    if (trimmed === '') {
+        return undefined;
+    }
+    const parsed = JSON.parse(trimmed);
+    if (typeof parsed !== 'object' || parsed === null) {
+        return undefined;
+    }
+    const servers = parsed['mcpServers'];
+    if (typeof servers !== 'object' || servers === null) {
+        return undefined;
+    }
+    return servers[name];
+}
+// ---------------------------------------------------------------------------
+// TOML transforms
+// ---------------------------------------------------------------------------
+/**
+ * Quote a TOML value.
+ *
+ * Literal single-quoted strings need no escaping, which keeps Windows paths
+ * readable. A value containing a quote falls back to a basic string, for which
+ * JSON escaping is compatible with TOML.
+ */
+function tomlString(value) {
+    return value.includes("'") ? JSON.stringify(value) : `'${value}'`;
+}
+function tomlArray(values) {
+    return `[${values.map(tomlString).join(', ')}]`;
+}
+/** A bare key where the name allows one, quoted where it does not. */
+function tomlKey(name) {
+    return /^[A-Za-z0-9_-]+$/.test(name) ? name : JSON.stringify(name);
+}
+/**
+ * Split a dotted TOML key into its segments, unquoting each one.
+ *
+ * `[mcp_servers.m-mcp]` and `[mcp_servers."m-mcp"]` name the same table.
+ * Comparing the raw text would miss the quoted spelling — which a hand edit or
+ * another tool may well have written — and append a second table for a key that
+ * already exists, leaving the user with a config no harness can parse.
+ */
+function tomlKeySegments(key) {
+    const segments = [];
+    let current = '';
+    let quote;
+    for (const character of key) {
+        if (quote !== undefined) {
+            if (character === quote) {
+                quote = undefined;
+            }
+            else {
+                current += character;
+            }
+        }
+        else if (character === '"' || character === "'") {
+            quote = character;
+        }
+        else if (character === '.') {
+            segments.push(current.trim());
+            current = '';
+        }
+        else {
+            current += character;
+        }
+    }
+    segments.push(current.trim());
+    return segments;
+}
+/** How a line relates to `mcp_servers.<name>`: its own table, a sub-table, or neither. */
+function ownedTableKind(line, name) {
+    const match = /^\s*\[([^\]]+)\]\s*$/.exec(line);
+    if (match === null) {
+        return 'none';
+    }
+    const segments = tomlKeySegments(match[1] ?? '');
+    if (segments[0] !== 'mcp_servers' || segments[1] !== name) {
+        return 'none';
+    }
+    return segments.length === 2 ? 'root' : 'sub';
+}
+function isTableHeader(line) {
+    return /^\s*\[/.test(line);
+}
+/** True when a line assigns one of the two keys this module owns. */
+function isManagedKey(line) {
+    return /^\s*["']?(?:command|args)["']?\s*=/.test(line);
+}
+/** Drop the blank lines at both ends of a captured block. */
+function trimBlankEdges(lines) {
+    const trimmed = [...lines];
+    while (trimmed.length > 0 && (trimmed[0] ?? '').trim() === '') {
+        trimmed.shift();
+    }
+    while (trimmed.length > 0 && (trimmed.at(-1) ?? '').trim() === '') {
+        trimmed.pop();
+    }
+    return trimmed;
+}
+/**
+ * Add, update or remove `[mcp_servers.<name>]` in a TOML document.
+ *
+ * The table and any sub-tables (such as an `.env` block) are lifted out, each
+ * stopping at the next table header so neighbouring servers survive. An update
+ * puts back everything it lifted apart from `command` and `args`, so the
+ * merchant's credentials outlive a re-deploy; a removal keeps none of it.
+ *
+ * Only the lifted table is rewritten. The rest of the document is passed through
+ * line for line — deliberately, since a blank line inside a `"""…"""` value is
+ * content, and the table's own trailing blank lines leave with it, so there is
+ * nothing left to tidy up afterwards.
+ */
+export function upsertTomlMcpServer(contents, name, entry) {
+    const lines = contents.split(/\r?\n/);
+    const kept = [];
+    const carriedKeys = [];
+    const subTables = [];
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index] ?? '';
+        const kind = ownedTableKind(line, name);
+        if (kind === 'none') {
+            kept.push(line);
+            continue;
+        }
+        // Take the table's body: everything up to the next table header.
+        const tableBody = [];
+        index += 1;
+        while (index < lines.length) {
+            const bodyLine = lines[index] ?? '';
+            if (isTableHeader(bodyLine)) {
+                break;
+            }
+            tableBody.push(bodyLine);
+            index += 1;
+        }
+        index -= 1;
+        if (kind === 'root') {
+            carriedKeys.push(...trimBlankEdges(tableBody.filter((bodyLine) => !isManagedKey(bodyLine))));
+        }
+        else {
+            subTables.push([line.trim(), ...trimBlankEdges(tableBody)]);
+        }
+    }
+    const body = kept.join('\n').replace(/\s+$/, '');
+    if (entry === undefined) {
+        return body === '' ? '' : `${body}\n`;
+    }
+    const block = [
+        `[mcp_servers.${tomlKey(name)}]`,
+        `command = ${tomlString(entry.command)}`,
+        `args = ${tomlArray(entry.args)}`,
+        ...carriedKeys,
+    ];
+    for (const subTable of subTables) {
+        block.push('', ...subTable);
+    }
+    const rendered = block.join('\n');
+    return body === '' ? `${rendered}\n` : `${body}\n\n${rendered}\n`;
+}
+/** True when the TOML document already declares this server. */
+export function tomlHasMcpServer(contents, name) {
+    return contents.split(/\r?\n/).some((line) => ownedTableKind(line, name) !== 'none');
+}
+//# sourceMappingURL=harnesses.js.map

package/dist/install/harnesses.js.map

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