onlymcp 0.9.1 → 0.11.0

package/dist/install.js

@@ -1,30 +1,27 @@
-import { join } from 'node:path';
-/** Das npm-Paket, das sowohl `onlymcp` als auch `onlymcp-mcp` mitbringt. */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { CLIENTS } from './registry/index.js';
+/** The npm package that ships both `onlymcp` and `onlymcp-mcp`. */
 export const PACKAGE = 'onlymcp';
-// Gestartet wird ueber npx und nicht als blosser Binaername `onlymcp-mcp`.
-// Die Startseite bewirbt `npx onlymcp install`, und npx fuehrt ein Paket
-// einmal aus, ohne irgendetwas auf dem PATH zu hinterlassen. Ein Eintrag mit
-// nacktem `onlymcp-mcp` waere also erfolgreich geschrieben und beim naechsten
-// Start des Clients trotzdem tot - der Fehler faellt genau dann auf, wenn der
-// Nutzer laengst weitergezogen ist. `-p onlymcp` ist dabei Pflicht, weil der
-// Binaername vom Paketnamen abweicht; ohne das sucht npx ein Paket namens
-// `onlymcp-mcp`, das es nicht gibt.
+// Started through npx, never as a bare `onlymcp-mcp` binary name: the home
+// page advertises `npx onlymcp install`, and npx runs a package once without
+// leaving anything on the PATH. A bare `onlymcp-mcp` entry would be written
+// successfully and only fail the next time the client starts, which is the
+// worst moment to find out. `-p onlymcp` is required because the binary
+// name differs from the package name; without it npx looks for a package
+// literally called `onlymcp-mcp`, which does not exist.
 //
-// Bewusst ohne feste Version: der Server spricht mit einer Cloud-API, die sich
-// weiterbewegt, und darf nicht auf einem Stand einfrieren, den danach niemand
-// mehr anfasst.
+// Deliberately unpinned: the server talks to a cloud API that keeps moving,
+// and must not freeze on a version nobody touches again afterwards.
 const COMMAND = 'npx';
 const ARGS = ['-y', '-p', PACKAGE, 'onlymcp-mcp'];
-// TOML-Basic-Strings deuten den Rueckwaertsschraegstrich als Escape. Ein
-// Windows-Heimatpfad wuerde ohne diese Behandlung eine kaputte Datei
-// erzeugen, ein Anfuehrungszeichen im Pfad ebenso.
+// TOML basic strings treat a backslash as an escape. A Windows home path
+// would produce a broken file without this, and so would a quote in the path.
 function tomlString(value) {
     return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
 }
 function jsonSnippet(env) {
-    const server = env
-        ? { command: COMMAND, args: ARGS, env }
-        : { command: COMMAND, args: ARGS };
+    const server = env ? { command: COMMAND, args: ARGS, env } : { command: COMMAND, args: ARGS };
     return JSON.stringify({ mcpServers: { onlymcp: server } }, null, 2);
 }
 function tomlSnippet(env) {
@@ -33,50 +30,131 @@ function tomlSnippet(env) {
         `command = ${tomlString(COMMAND)}`,
         `args = [${ARGS.map(tomlString).join(', ')}]`,
     ];
-    // Inline-Tabelle statt eigenem [mcp_servers.onlymcp.env]-Abschnitt: der
-    // Schnipsel wird an eine bestehende Datei angehaengt, und ein zweiter
-    // Abschnitt wuerde jede spaeter angehaengte Tabelle in ihn hineinziehen.
+    // An inline table instead of a separate [mcp_servers.onlymcp.env] section:
+    // the snippet gets appended to an existing file, and a second section
+    // would pull in whatever gets appended after it.
     for (const [k, v] of Object.entries(env ?? {})) {
         lines.push(`env = { ${k} = ${tomlString(v)} }`);
     }
     return `${lines.join('\n')}\n`;
 }
-// `home` ist ein Parameter und nicht homedir(), damit jeder Test gegen einen
-// Wegwerf-Ordner laeuft. Die Leitplanke aus Spec Abschnitt 13 ist damit im
-// Typ verankert und nicht bloss eine Absicht.
-export function targets(home) {
-    // Geprueft an Codex 0.147.0: ~/.codex/skills wird direkt gescannt.
-    const codexStubs = join(home, '.codex', 'skills');
-    return [
-        {
-            id: 'claude',
-            label: 'Claude Code',
-            configPath: join(home, '.claude.json'),
-            // Die Stubs setzt bei Claude Code die Plugin-Installation ueber
-            // CLAUDE_PLUGIN_ROOT, nicht dieser Befehl.
-            stubDir: null,
-            snippet: jsonSnippet(),
-        },
-        {
-            id: 'codex',
-            label: 'Codex',
-            configPath: join(home, '.codex', 'config.toml'),
-            stubDir: codexStubs,
-            // Ohne ONLYMCP_STUB_DIRS im Eintrag selbst faellt stubDirs() auf
-            // ~/.claude/onlymcp/plugin zurueck: die Stubs landen dann an einer
-            // Stelle, die Codex nie liest, und ~/.codex/skills bleibt leer. Die
-            // Variable gehoert deshalb in die Konfiguration und nicht bloss als
-            // Hinweis in die Ausgabe.
-            snippet: tomlSnippet({ ONLYMCP_STUB_DIRS: codexStubs }),
-        },
-        {
-            id: 'gemini',
-            label: 'Gemini CLI',
-            configPath: join(home, '.gemini', 'settings.json'),
-            // Kein eigener Skill-Begriff: laeuft ueber instructions und list_skills.
-            stubDir: null,
-            snippet: jsonSnippet(),
-        },
-    ];
+/**
+ * Old CLI spellings, kept so instructions written before the registry
+ * existed keep working. `codex` needs no alias: it was always spelled the
+ * same as the registry's client id.
+ */
+const ALIASES = { claude: 'claude-code', gemini: 'gemini-cli' };
+function installableClients() {
+    return CLIENTS.filter((c) => c.install !== null);
+}
+const INSTALLABLE_IDS = new Set(installableClients().map((c) => c.id));
+/** Resolves an alias or a registry id to a registry id; undefined if neither. */
+export function resolveClientId(id) {
+    const aliased = ALIASES[id];
+    if (aliased)
+        return aliased;
+    return INSTALLABLE_IDS.has(id) ? id : undefined;
+}
+function resolveHome(path, home) {
+    return path.startsWith('~/') ? join(home, path.slice(2)) : path;
+}
+/**
+ * Every client the registry can write a config for, resolved against `home`.
+ *
+ * `home` is a parameter and not `homedir()` so every test runs against a
+ * throwaway directory: the guardrail from spec §13 sits in the type itself,
+ * not merely in intent.
+ */
+export function installTargets(home) {
+    return installableClients().map((c) => {
+        const configPath = resolveHome(c.install.configPath, home);
+        const stubDir = c.install.stubDir ? resolveHome(c.install.stubDir, home) : null;
+        // `stubDir` is always `<root>/skills` (see paths.ts, `stubDirs()`): the
+        // env var the server reads carries the root, because `writeStubs`
+        // appends `skills/` itself. Pointing it at the skills dir directly wrote
+        // into `<root>/skills/skills`.
+        const stubRoot = stubDir ? dirname(stubDir) : null;
+        const snippet = c.install.format === 'toml'
+            ? tomlSnippet(stubRoot ? { ONLYMCP_STUB_DIRS: stubRoot } : undefined)
+            : jsonSnippet();
+        return { id: c.id, name: c.name, configPath, format: c.install.format, stubDir, stubRoot, snippet };
+    });
+}
+/**
+ * Merges one MCP server entry into an existing JSON config, without
+ * touching anything else already in the file.
+ *
+ * `writeFileSync` alone would replace the whole file (e.g. `~/.claude.json`
+ * or `~/.gemini/settings.json`), throwing away every other setting stored
+ * there. An existing but broken file is never silently overwritten either:
+ * better an error than quiet data loss.
+ */
+export function mergeJsonServer(path, key, value) {
+    let existing = {};
+    if (existsSync(path)) {
+        const raw = readFileSync(path, 'utf8').trim();
+        if (raw) {
+            try {
+                existing = JSON.parse(raw);
+            }
+            catch {
+                throw new Error(`${path} contains invalid JSON. Nothing written.`);
+            }
+        }
+    }
+    const mcpServers = existing.mcpServers ?? {};
+    existing.mcpServers = { ...mcpServers, [key]: value };
+    writeFileSync(path, `${JSON.stringify(existing, null, 2)}\n`, 'utf8');
+}
+/**
+ * Appends the TOML snippet, unless it is already there.
+ *
+ * Appended, not replaced: a second run would otherwise add a second
+ * `[mcp_servers.onlymcp]` table, and two identical tables make the file
+ * invalid for most TOML parsers.
+ */
+export function appendTomlServer(path, snippet) {
+    const already = existsSync(path) && readFileSync(path, 'utf8').includes('[mcp_servers.onlymcp]');
+    if (already)
+        return 'already-present';
+    appendFileSync(path, `\n${snippet}`);
+    return 'written';
+}
+/** Pure given the filesystem: same inputs, same decision, every time. */
+export function planInstall(home, opts) {
+    const targets = installTargets(home);
+    if (opts.all) {
+        if (opts.client)
+            return { kind: 'conflicting-options' };
+        const present = targets.filter((t) => existsSync(t.configPath));
+        const skipped = targets.filter((t) => !existsSync(t.configPath));
+        if (present.length === 0)
+            return { kind: 'none-present-for-all', targets };
+        return { kind: 'all', present, skipped };
+    }
+    if (!opts.client)
+        return { kind: 'missing-client', targets };
+    const id = resolveClientId(opts.client);
+    const target = id ? targets.find((x) => x.id === id) : undefined;
+    if (!target)
+        return { kind: 'unknown-client', targets };
+    return { kind: 'single', target };
+}
+/** Writes one target's snippet into its config file, creating directories as needed. */
+export function writeInstallTarget(target) {
+    mkdirSync(dirname(target.configPath), { recursive: true });
+    const result = target.format === 'toml'
+        ? appendTomlServer(target.configPath, target.snippet)
+        : (() => {
+            const parsed = JSON.parse(target.snippet);
+            const entry = Object.entries(parsed.mcpServers)[0];
+            if (!entry)
+                throw new Error(`${target.name}: empty mcpServers snippet.`);
+            mergeJsonServer(target.configPath, entry[0], entry[1]);
+            return 'written';
+        })();
+    if (target.stubDir)
+        mkdirSync(target.stubDir, { recursive: true });
+    return result;
 }
 //# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/instructions.d.ts

@@ -1,2 +1,4 @@
 export declare const INSTRUCTIONS_BUDGET = 1800;
-export declare function buildInstructions(skills: string[], agents: string[]): string;
+export declare function buildInstructions(skills: string[], agents: string[], opts?: {
+    brainvault?: boolean;
+}): string;

package/dist/instructions.js

@@ -16,6 +16,20 @@ const PREAMBLE = [
     'skill_write, agent_write and the matching *_delete tools; connection_create',
     'adds another MCP server to this account.',
 ].join(' ');
+/**
+ * Der BrainVault-Ablauf in drei Saetzen (Spec 7), wortgleich mit dem der
+ * gehosteten Oberflaeche (packages/api/src/mcp/instructions.ts). Zwei
+ * Fassungen desselben Satzes waeren zwei Gewohnheiten.
+ *
+ * Je Konto abschaltbar: wer OnlyMCP als reinen Skill-Speicher benutzt, will
+ * keinen Ablauf und will die Zeichen fuer Namen zurueck.
+ */
+const BRAINVAULT = [
+    'Memory is a vault, not a scratch file: read MEMORY.md first, it is the index.',
+    'After finishing a task, write one solutions/sol-*.md for what was not obvious',
+    'and one entry in history/YYYY-MM-DD.md. Link related files with [[name]];',
+    "memory_links(path) says which of a file's links point nowhere yet.",
+].join(' ');
 function section(label, tool, names, used) {
     if (names.length === 0)
         return '';
@@ -34,8 +48,11 @@ function section(label, tool, names, used) {
     const tail = rest > 0 ? ` (+${rest} more, call ${tool})` : '';
     return `\n\n${label}: ${kept.join(', ')}${tail}`;
 }
-export function buildInstructions(skills, agents) {
-    let out = PREAMBLE;
+export function buildInstructions(skills, agents, opts = {}) {
+    // Vor den Namenslisten und nach der Anleitung: abgeschnitten wird der
+    // Schluss, also steht vorn, was ueberleben muss - und ein halb angekommener
+    // Ablauf ist schlimmer als gar keiner.
+    let out = opts.brainvault === false ? PREAMBLE : `${PREAMBLE} ${BRAINVAULT}`;
     // Platz fuer die Agents-Zeile zuruecklegen, BEVOR die Skills ihn aufbrauchen.
     // Ohne diese Reserve frisst eine lange Skill-Liste das ganze Budget, die
     // Agents-Zeile wird trotzdem angehaengt, und das Feld ueberschreitet 1800.

package/dist/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,sEAAsE;AACtE,0EAA0E;AAC1E,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,MAAM,QAAQ,GAAG;IACf,6EAA6E;IAC7E,qEAAqE;IACrE,0DAA0D;IAC1D,8EAA8E;IAC9E,gEAAgE;IAChE,wEAAwE;IACxE,6EAA6E;IAC7E,0CAA0C;CAC3C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,SAAS,OAAO,CAAC,KAAa,EAAE,IAAY,EAAE,KAAe,EAAE,IAAY;IACzE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,eAAe,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;QAClE,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,mBAAmB;YAAE,MAAM;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,KAAK,UAAU,IAAI,EAAE,CAAC;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,eAAe,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,OAAO,OAAO,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAgB,EAAE,MAAgB;IAClE,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,8EAA8E;IAC9E,yEAAyE;IACzE,2EAA2E;IAC3E,6EAA6E;IAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;IACtE,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5D,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,sEAAsE;AACtE,0EAA0E;AAC1E,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,MAAM,QAAQ,GAAG;IACf,6EAA6E;IAC7E,qEAAqE;IACrE,0DAA0D;IAC1D,8EAA8E;IAC9E,gEAAgE;IAChE,wEAAwE;IACxE,6EAA6E;IAC7E,0CAA0C;CAC3C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ;;;;;;;GAOG;AACH,MAAM,UAAU,GAAG;IACjB,+EAA+E;IAC/E,+EAA+E;IAC/E,2EAA2E;IAC3E,oEAAoE;CACrE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,SAAS,OAAO,CAAC,KAAa,EAAE,IAAY,EAAE,KAAe,EAAE,IAAY;IACzE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,eAAe,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;QAClE,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,mBAAmB;YAAE,MAAM;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,KAAK,UAAU,IAAI,EAAE,CAAC;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,eAAe,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,OAAO,OAAO,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAgB,EAChB,MAAgB,EAChB,OAAiC,EAAE;IAEnC,sEAAsE;IACtE,4EAA4E;IAC5E,uCAAuC;IACvC,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC;IAC7E,8EAA8E;IAC9E,yEAAyE;IACzE,2EAA2E;IAC3E,6EAA6E;IAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;IACtE,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5D,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/memorySync.d.ts

@@ -0,0 +1,28 @@
+import type { ApiClient } from './apiClient.js';
+export type MemorySyncResult = {
+    written: number;
+    /** Paths the server sent that this command refused to turn into a file. */
+    refused: string[];
+    /** A team file whose path a personal file already took. */
+    collisions: string[];
+    failures: {
+        what: string;
+        code: string;
+    }[];
+};
+/**
+ * Write every memory file this account can read into one directory, folder
+ * structure included (package 03 task 12, spec 8.5).
+ *
+ * Two independent checks stand between a path from the server and a write on
+ * the disk, and they are not redundant: `isSafeMemoryPath` is the rule the
+ * server enforces on the way in, and the prefix check below is the one that
+ * holds even if that rule is ever loosened, if a path arrives from a wrongly
+ * configured ONLYMCP_API_URL, or if `resolve` and the regexp disagree about
+ * some encoding. Nothing outside `dir` is ever written.
+ *
+ * Archived rows are included on purpose. The archive is exactly the state in
+ * which somebody wants their notes back on their own disk, and spec 8a calls
+ * leaving them out a shortcoming, not a feature.
+ */
+export declare function syncMemoryToDisk(api: ApiClient, dir: string): Promise<MemorySyncResult>;

package/dist/memorySync.js

@@ -0,0 +1,56 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve, sep } from 'node:path';
+import { isSafeMemoryPath } from './memoryPath.js';
+/**
+ * Write every memory file this account can read into one directory, folder
+ * structure included (package 03 task 12, spec 8.5).
+ *
+ * Two independent checks stand between a path from the server and a write on
+ * the disk, and they are not redundant: `isSafeMemoryPath` is the rule the
+ * server enforces on the way in, and the prefix check below is the one that
+ * holds even if that rule is ever loosened, if a path arrives from a wrongly
+ * configured ONLYMCP_API_URL, or if `resolve` and the regexp disagree about
+ * some encoding. Nothing outside `dir` is ever written.
+ *
+ * Archived rows are included on purpose. The archive is exactly the state in
+ * which somebody wants their notes back on their own disk, and spec 8a calls
+ * leaving them out a shortcoming, not a feature.
+ */
+export async function syncMemoryToDisk(api, dir) {
+    const base = resolve(dir);
+    await mkdir(base, { recursive: true });
+    const result = { written: 0, refused: [], collisions: [], failures: [] };
+    const { files } = await api.listMemory();
+    // Personal first, so a path claimed by both scopes belongs to the file this
+    // account owns. The team file is then reported rather than quietly dropped;
+    // a directory per scope is the export's job (task 12a), not this one's.
+    const ordered = [...files].sort((a, b) => a.scope === b.scope ? a.path.localeCompare(b.path) : a.scope === 'personal' ? -1 : 1);
+    const taken = new Set();
+    for (const f of ordered) {
+        if (!isSafeMemoryPath(f.path)) {
+            result.refused.push(f.path);
+            continue;
+        }
+        const dest = resolve(base, ...f.path.split('/'));
+        if (!dest.startsWith(base + sep)) {
+            result.refused.push(f.path);
+            continue;
+        }
+        if (taken.has(dest)) {
+            result.collisions.push(f.path);
+            continue;
+        }
+        try {
+            const file = await api.readMemory(f.path);
+            await mkdir(dirname(dest), { recursive: true });
+            await writeFile(dest, file.content, 'utf8');
+            taken.add(dest);
+            result.written += 1;
+        }
+        catch (e) {
+            result.failures.push({ what: f.path, code: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=memorySync.js.map

package/dist/memorySync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorySync.js","sourceRoot":"","sources":["../src/memorySync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAWnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAc,EAAE,GAAW;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,MAAM,GAAqB,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC3F,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;IAEzC,4EAA4E;IAC5E,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACvC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACrF,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChB,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/paths.d.ts

@@ -1,2 +1,14 @@
 export declare function cacheDir(): string;
+/**
+ * Die Ordner, in die Stubs geschrieben werden.
+ *
+ * Zurueck kommt jeweils die WURZEL eines Clients, nicht sein `skills`-Ordner:
+ * writeStubs legt darunter `skills/` und `agents/` an, weil beide Scanner
+ * nebeneinander stehen. Bis Aufgabe 12 gab ONLYMCP_STUB_DIRS `~/.codex/skills`
+ * zurueck und die Stubs landeten in `~/.codex/skills/skills` - also an einer
+ * Stelle, die Codex nie liest.
+ *
+ * Mehrzahl, weil mehrere Clients gleichzeitig auf demselben Geraet laufen
+ * koennen und jeder einen anderen Ordner scannt.
+ */
 export declare function stubDirs(): string[];

package/dist/paths.js

@@ -1,28 +1,54 @@
+import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
+// ONLYMCP_HOME wird an zwei Stellen unterschiedlich gelesen, und das ist
+// Absicht: hier unten als Ersatz fuer ~/.claude/onlymcp (der eigene Ordner
+// dieses Werkzeugs), in clientHome() als Ersatz fuer das Heimatverzeichnis
+// (so wie install.ts es liest). Ein Test setzt die Variable auf einen
+// Wegwerf-Ordner und trifft damit beides, ohne je ein echtes ~/.claude
+// anzufassen.
 function base() {
     return process.env.ONLYMCP_HOME ?? join(homedir(), '.claude', 'onlymcp');
 }
+function clientHome() {
+    return process.env.ONLYMCP_HOME ?? homedir();
+}
 export function cacheDir() {
     return join(base(), 'cache');
 }
+/**
+ * Die Ordner, in die Stubs geschrieben werden.
+ *
+ * Zurueck kommt jeweils die WURZEL eines Clients, nicht sein `skills`-Ordner:
+ * writeStubs legt darunter `skills/` und `agents/` an, weil beide Scanner
+ * nebeneinander stehen. Bis Aufgabe 12 gab ONLYMCP_STUB_DIRS `~/.codex/skills`
+ * zurueck und die Stubs landeten in `~/.codex/skills/skills` - also an einer
+ * Stelle, die Codex nie liest.
+ *
+ * Mehrzahl, weil mehrere Clients gleichzeitig auf demselben Geraet laufen
+ * koennen und jeder einen anderen Ordner scannt.
+ */
 export function stubDirs() {
-    // Mehrzahl, weil mehrere Clients gleichzeitig auf demselben Geraet laufen
-    // koennen und jeder einen anderen Ordner scannt.
     const dirs = [];
     // Claude Code setzt CLAUDE_PLUGIN_ROOT, wenn es den MCP-Server aus dem
-    // Plugin heraus startet. Nur dort liegen Stubs an einer Stelle, die der
-    // Skill- und Agent-Scanner ueberhaupt liest.
+    // Plugin heraus startet. Dort liegen Stubs an einer Stelle, die der Skill-
+    // und Agent-Scanner ohnehin liest.
     if (process.env.CLAUDE_PLUGIN_ROOT)
         dirs.push(process.env.CLAUDE_PLUGIN_ROOT);
-    // Alle uebrigen Clients mit eigenem Scanner, gesetzt von `onlymcp install`
-    // (heute Codex mit ~/.codex/skills). Mehrere durch Doppelpunkt getrennt wie
-    // PATH: ein Client mehr ist ein Eintrag mehr, keine Codeaenderung.
+    // Alle uebrigen Clients mit eigenem Scanner, gesetzt von `onlymcp install`.
+    // Mehrere durch Doppelpunkt getrennt wie PATH: ein Client mehr ist ein
+    // Eintrag mehr, keine Codeaenderung.
     for (const d of (process.env.ONLYMCP_STUB_DIRS ?? '').split(':')) {
         if (d)
             dirs.push(d);
     }
-    // Rueckfall fuer CLI und Tests ohne jeden Client-Kontext.
+    // Was ohne jede Konfiguration da ist. Geprueft, nicht angelegt: wer kein
+    // Codex installiert hat, soll durch `onlymcp sync` kein ~/.codex bekommen.
+    for (const d of [join(clientHome(), '.claude'), join(clientHome(), '.codex')]) {
+        if (existsSync(d) && !dirs.includes(d))
+            dirs.push(d);
+    }
+    // Letzter Rueckfall fuer CLI und Tests ohne jeden Client-Kontext.
     return dirs.length > 0 ? dirs : [join(base(), 'plugin')];
 }
 //# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,SAAS,IAAI;IACX,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,0EAA0E;IAC1E,iDAAiD;IACjD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,uEAAuE;IACvE,wEAAwE;IACxE,6CAA6C;IAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC9E,2EAA2E;IAC3E,4EAA4E;IAC5E,mEAAmE;IACnE,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,IAAI,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IACD,0DAA0D;IAC1D,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,yEAAyE;AACzE,2EAA2E;AAC3E,2EAA2E;AAC3E,sEAAsE;AACtE,uEAAuE;AACvE,cAAc;AACd,SAAS,IAAI;IACX,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ;IACtB,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,uEAAuE;IACvE,2EAA2E;IAC3E,mCAAmC;IACnC,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC9E,4EAA4E;IAC5E,uEAAuE;IACvE,qCAAqC;IACrC,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,IAAI,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IACD,yEAAyE;IACzE,2EAA2E;IAC3E,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC9E,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,kEAAkE;IAClE,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/registry/caveats.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The caveat sentences, in the four languages the product carries.
+ *
+ * A caveat is a client fact like the command next to it, and two places state
+ * it: the Connect view of the dashboard and the generated client sections of
+ * the public documentation (packages/api/src/docs/generated.ts). Each kept its
+ * own copy until packages 07 and 09 met, and 17 of the 24 sentences already
+ * differed. `ClientRecord.caveats` names an entry by its key.
+ */
+export type CaveatLanguage = 'en' | 'de' | 'fr' | 'it';
+export declare const CAVEATS: Record<string, Record<CaveatLanguage, string>>;
+/**
+ * The sentence for one key. An unknown language reads English, and an unknown
+ * key comes back as it is, so a typo shows on the first read instead of
+ * vanishing.
+ */
+export declare function caveatText(key: string, language: string): string;

package/dist/registry/caveats.js

@@ -0,0 +1,50 @@
+export const CAVEATS = {
+    'clients.caveat.chatgptDeveloperMode': {
+        en: 'Custom MCP connectors live in ChatGPT’s developer mode on the web, and need a paid plan.',
+        de: 'Eigene MCP-Connectors gibt es in ChatGPT nur im Entwicklermodus im Web, und sie brauchen ein bezahltes Abo.',
+        fr: 'Les connecteurs MCP personnalisés se trouvent dans le mode développeur de ChatGPT sur le web et demandent un abonnement payant.',
+        it: 'I connettori MCP personalizzati si trovano nella modalità sviluppatore di ChatGPT sul web e richiedono un piano a pagamento.',
+    },
+    'clients.caveat.geminiAppSpark': {
+        en: 'Custom connectors are limited to Gemini Spark and are not available in every country.',
+        de: 'Eigene Connectors gibt es nur für Gemini Spark, und nicht in jedem Land.',
+        fr: 'Les connecteurs personnalisés sont réservés à Gemini Spark et ne sont pas disponibles dans tous les pays.',
+        it: 'I connettori personalizzati sono riservati a Gemini Spark e non sono disponibili in tutti i paesi.',
+    },
+    'clients.caveat.claudeHeaderBeta': {
+        en: 'Claude connects through OAuth. Static headers exist only in a limited beta.',
+        de: 'Claude verbindet sich über OAuth. Feste Header gibt es nur in einer beschränkten Beta.',
+        fr: 'Claude se connecte via OAuth. Les en-têtes fixes n’existent que dans une bêta limitée.',
+        it: 'Claude si connette tramite OAuth. Gli header statici esistono solo in una beta limitata.',
+    },
+    'clients.caveat.copilotPolicy': {
+        en: 'Business and Enterprise tenants must enable the MCP policy first.',
+        de: 'In Business- und Enterprise-Organisationen muss zuerst die MCP-Richtlinie eingeschaltet werden.',
+        fr: 'Les organisations Business et Enterprise doivent d’abord activer la stratégie MCP.',
+        it: 'Nelle organizzazioni Business ed Enterprise va prima attivata la policy MCP.',
+    },
+    'clients.caveat.windsurfAllowlist': {
+        en: 'An admin allowlist can block servers that are not listed.',
+        de: 'Eine Freigabeliste der Administration kann Server sperren, die nicht darauf stehen.',
+        fr: 'Une liste d’autorisation définie par un administrateur peut bloquer les serveurs qui n’y figurent pas.',
+        it: 'Una lista di autorizzazione dell’amministratore può bloccare i server che non vi compaiono.',
+    },
+    'clients.caveat.codexTokenEnv': {
+        en: 'Codex reads ONLYMCP_TOKEN from the environment every time it starts. Put the export line in your shell profile, not just the current terminal session.',
+        de: 'Codex liest ONLYMCP_TOKEN bei jedem Start aus der Umgebung. Schreib die export-Zeile in dein Shell-Profil, nicht nur in die aktuelle Terminal-Sitzung.',
+        fr: 'Codex lit ONLYMCP_TOKEN dans l’environnement à chaque démarrage. Mets la ligne export dans le profil de ton shell, pas seulement dans la session de terminal en cours.',
+        it: 'Codex legge ONLYMCP_TOKEN dall’ambiente a ogni avvio. Metti la riga export nel profilo della tua shell, non solo nella sessione di terminale attuale.',
+    },
+};
+/**
+ * The sentence for one key. An unknown language reads English, and an unknown
+ * key comes back as it is, so a typo shows on the first read instead of
+ * vanishing.
+ */
+export function caveatText(key, language) {
+    const entry = CAVEATS[key];
+    if (!entry)
+        return key;
+    return entry[language.slice(0, 2)] ?? entry.en ?? key;
+}
+//# sourceMappingURL=caveats.js.map

package/dist/registry/caveats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caveats.js","sourceRoot":"","sources":["../../src/registry/caveats.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,OAAO,GAAmD;IACrE,qCAAqC,EAAE;QACrC,EAAE,EAAE,0FAA0F;QAC9F,EAAE,EAAE,6GAA6G;QACjH,EAAE,EAAE,iIAAiI;QACrI,EAAE,EAAE,8HAA8H;KACnI;IACD,+BAA+B,EAAE;QAC/B,EAAE,EAAE,uFAAuF;QAC3F,EAAE,EAAE,0EAA0E;QAC9E,EAAE,EAAE,2GAA2G;QAC/G,EAAE,EAAE,oGAAoG;KACzG;IACD,iCAAiC,EAAE;QACjC,EAAE,EAAE,6EAA6E;QACjF,EAAE,EAAE,wFAAwF;QAC5F,EAAE,EAAE,wFAAwF;QAC5F,EAAE,EAAE,0FAA0F;KAC/F;IACD,8BAA8B,EAAE;QAC9B,EAAE,EAAE,mEAAmE;QACvE,EAAE,EAAE,iGAAiG;QACrG,EAAE,EAAE,oFAAoF;QACxF,EAAE,EAAE,8EAA8E;KACnF;IACD,kCAAkC,EAAE;QAClC,EAAE,EAAE,2DAA2D;QAC/D,EAAE,EAAE,qFAAqF;QACzF,EAAE,EAAE,wGAAwG;QAC5G,EAAE,EAAE,6FAA6F;KAClG;IACD,8BAA8B,EAAE;QAC9B,EAAE,EAAE,wJAAwJ;QAC5J,EAAE,EAAE,wJAAwJ;QAC5J,EAAE,EAAE,wKAAwK;QAC5K,EAAE,EAAE,uJAAuJ;KAC5J;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,QAAgB;IACtD,MAAM,KAAK,GAAuC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IACvB,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,IAAI,GAAG,CAAC;AACxD,CAAC"}

package/dist/registry/clients.d.ts

@@ -0,0 +1,11 @@
+import type { ClientId, ClientRecord, RemoteContext, Snippet } from './types.js';
+export declare const CLIENTS: readonly ClientRecord[];
+export declare function clientById(id: ClientId): ClientRecord | undefined;
+export declare function remoteSnippets(id: ClientId, ctx: RemoteContext): Snippet[] | null;
+/**
+ * The local-install command for a client `npx onlymcp install` can set up,
+ * or null for every other one. Spec 07 §3.4: always with `npx`, always with
+ * `--client`, because the CLI without `--client` only lists the targets and
+ * exits 2.
+ */
+export declare function installCommand(id: ClientId): string | null;