@lyupro/skillforge-mcp 1.1.0

package/dist/installers/atomic-write.js

@@ -0,0 +1,98 @@
+/**
+ * Atomic JSON / TOML helpers with .backup snapshots.
+ *
+ * Read helpers return null on missing file, throw on corrupt content.
+ * Write helpers go via <path>.tmp + fs.rename and snapshot the previous
+ * content into <path>.backup before overwriting. On rename failure the
+ * backup is restored.
+ */
+import { readFile, writeFile, rename, mkdir, access, copyFile, unlink } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import toml from '@iarna/toml';
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readJsonSafe(path) {
+    if (!(await fileExists(path)))
+        return null;
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch (err) {
+        throw new Error(`atomic-write: failed to read "${path}": ${String(err)}`);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`atomic-write: invalid JSON in "${path}": ${String(err)}`);
+    }
+}
+export async function readTomlSafe(path) {
+    if (!(await fileExists(path)))
+        return null;
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch (err) {
+        throw new Error(`atomic-write: failed to read "${path}": ${String(err)}`);
+    }
+    try {
+        return toml.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`atomic-write: invalid TOML in "${path}": ${String(err)}`);
+    }
+}
+async function backupAndRename(target, tmpPath) {
+    const backupPath = `${target}.backup`;
+    const had = await fileExists(target);
+    if (had) {
+        await copyFile(target, backupPath);
+    }
+    try {
+        await rename(tmpPath, target);
+    }
+    catch (err) {
+        // Best-effort restore from backup on rename failure.
+        if (had) {
+            try {
+                await copyFile(backupPath, target);
+            }
+            catch {
+                // Restore failed — leave both .backup and original in place for operator recovery.
+            }
+        }
+        // Clean up the .tmp if it survives.
+        try {
+            await unlink(tmpPath);
+        }
+        catch {
+            // ignore
+        }
+        throw err;
+    }
+}
+export async function writeJsonAtomic(path, data) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmpPath = `${path}.tmp`;
+    const contents = `${JSON.stringify(data, null, 2)}\n`;
+    await writeFile(tmpPath, contents, 'utf8');
+    await backupAndRename(path, tmpPath);
+}
+export async function writeTomlAtomic(path, data) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmpPath = `${path}.tmp`;
+    const contents = toml.stringify(data);
+    await writeFile(tmpPath, contents, 'utf8');
+    await backupAndRename(path, tmpPath);
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/installers/atomic-write.js.map

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

package/dist/installers/claude-installer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Claude Code installer — edits ~/.claude.json mcpServers.skillforge.
+ *
+ * Claude Code stores its host-level MCP server registry in a single JSON
+ * file at ~/.claude.json across all OSes. The installer detects presence
+ * of either the `claude` binary or that file, then merges the SkillForge
+ * entry under `mcpServers.skillforge`.
+ */
+import type { Installer, InstallOptions, InstallResult, PreviewResult, UninstallResult } from './types.js';
+export interface ClaudeInstallerPathOverrides {
+    configPath?: string;
+    binaryPath?: string;
+    binaryProbe?: () => boolean;
+}
+export declare class ClaudeInstaller implements Installer {
+    #private;
+    readonly name = "claude";
+    constructor(overrides?: ClaudeInstallerPathOverrides);
+    detect(): Promise<boolean>;
+    install(opts: InstallOptions): Promise<InstallResult>;
+    uninstall(): Promise<UninstallResult>;
+    preview(opts: InstallOptions & {
+        action: 'install' | 'uninstall';
+    }): Promise<PreviewResult>;
+}
+//# sourceMappingURL=claude-installer.d.ts.map

package/dist/installers/claude-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-installer.d.ts","sourceRoot":"","sources":["../../src/installers/claude-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B;AAuCD,qBAAa,eAAgB,YAAW,SAAS;;IAC/C,QAAQ,CAAC,IAAI,YAAY;gBAKb,SAAS,GAAE,4BAAiC;IAMlD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAK1B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBrD,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAerC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CA4BlG"}

package/dist/installers/claude-installer.js

@@ -0,0 +1,118 @@
+/**
+ * Claude Code installer — edits ~/.claude.json mcpServers.skillforge.
+ *
+ * Claude Code stores its host-level MCP server registry in a single JSON
+ * file at ~/.claude.json across all OSes. The installer detects presence
+ * of either the `claude` binary or that file, then merges the SkillForge
+ * entry under `mcpServers.skillforge`.
+ */
+import { spawnSync } from 'node:child_process';
+import { access } from 'node:fs/promises';
+import { readJsonSafe, writeJsonAtomic } from './atomic-write.js';
+import { claudeConfigPath, defaultBinaryPath } from './paths.js';
+const SKILL_KEY = 'skillforge';
+const NPX_PKG = '@lyupro/skillforge-mcp';
+function buildEntry(opts, binaryFallback) {
+    if (opts.entry === 'npx') {
+        return { command: 'npx', args: ['-y', NPX_PKG] };
+    }
+    const binary = opts.binaryPath ?? binaryFallback;
+    return { command: 'node', args: [binary] };
+}
+function probeClaudeBinary() {
+    try {
+        const result = spawnSync('claude', ['--version'], { stdio: 'ignore' });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class ClaudeInstaller {
+    name = 'claude';
+    #configPath;
+    #binaryFallback;
+    #probe;
+    constructor(overrides = {}) {
+        this.#configPath = overrides.configPath ?? claudeConfigPath();
+        this.#binaryFallback = overrides.binaryPath ?? defaultBinaryPath();
+        this.#probe = overrides.binaryProbe ?? probeClaudeBinary;
+    }
+    async detect() {
+        if (this.#probe())
+            return true;
+        return fileExists(this.#configPath);
+    }
+    async install(opts) {
+        const existing = (await readJsonSafe(this.#configPath)) ?? {};
+        const servers = existing.mcpServers ?? {};
+        const entry = buildEntry(opts, this.#binaryFallback);
+        if (servers[SKILL_KEY] !== undefined && opts.force !== true) {
+            return {
+                tool: this.name,
+                status: 'already-installed',
+                configPath: this.#configPath,
+                message: `SkillForge entry already present; pass --force to overwrite`,
+            };
+        }
+        const next = {
+            ...existing,
+            mcpServers: { ...servers, [SKILL_KEY]: entry },
+        };
+        await writeJsonAtomic(this.#configPath, next);
+        const status = servers[SKILL_KEY] !== undefined ? 'updated' : 'installed';
+        return { tool: this.name, status, configPath: this.#configPath };
+    }
+    async uninstall() {
+        const existing = (await readJsonSafe(this.#configPath));
+        if (existing === null || existing.mcpServers === undefined || existing.mcpServers[SKILL_KEY] === undefined) {
+            return {
+                tool: this.name,
+                status: 'not-installed',
+                configPath: this.#configPath,
+            };
+        }
+        const { [SKILL_KEY]: _drop, ...rest } = existing.mcpServers;
+        const next = { ...existing, mcpServers: rest };
+        await writeJsonAtomic(this.#configPath, next);
+        return { tool: this.name, status: 'uninstalled', configPath: this.#configPath };
+    }
+    async preview(opts) {
+        const existing = (await readJsonSafe(this.#configPath));
+        const before = existing === null ? null : JSON.stringify(existing, null, 2);
+        let nextValue;
+        if (opts.action === 'install') {
+            const base = existing ?? {};
+            const servers = base.mcpServers ?? {};
+            const entry = buildEntry(opts, this.#binaryFallback);
+            nextValue = { ...base, mcpServers: { ...servers, [SKILL_KEY]: entry } };
+        }
+        else {
+            if (existing === null || existing.mcpServers === undefined) {
+                nextValue = existing ?? {};
+            }
+            else {
+                const { [SKILL_KEY]: _drop, ...rest } = existing.mcpServers;
+                nextValue = { ...existing, mcpServers: rest };
+            }
+        }
+        return {
+            tool: this.name,
+            configPath: this.#configPath,
+            willCreate: existing === null,
+            before,
+            after: JSON.stringify(nextValue, null, 2),
+            action: opts.action,
+        };
+    }
+}
+//# sourceMappingURL=claude-installer.js.map

package/dist/installers/claude-installer.js.map

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

package/dist/installers/codex-installer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Codex CLI installer — edits ~/.codex/config.toml [mcp_servers.skillforge].
+ *
+ * Codex stores MCP servers in TOML at ~/.codex/config.toml under a
+ * `[mcp_servers.<name>]` table. SkillForge's table shape is:
+ *
+ *   [mcp_servers.skillforge]
+ *   command = "npx"
+ *   args = ["-y", "@lyupro/skillforge-mcp"]
+ *
+ * Per the Codex MCP reference (developers.openai.com/codex/mcp).
+ */
+import type { Installer, InstallOptions, InstallResult, PreviewResult, UninstallResult } from './types.js';
+export interface CodexInstallerPathOverrides {
+    configPath?: string;
+    binaryPath?: string;
+    binaryProbe?: () => boolean;
+}
+export declare class CodexInstaller implements Installer {
+    #private;
+    readonly name = "codex";
+    constructor(overrides?: CodexInstallerPathOverrides);
+    detect(): Promise<boolean>;
+    install(opts: InstallOptions): Promise<InstallResult>;
+    uninstall(): Promise<UninstallResult>;
+    preview(opts: InstallOptions & {
+        action: 'install' | 'uninstall';
+    }): Promise<PreviewResult>;
+}
+//# sourceMappingURL=codex-installer.d.ts.map

package/dist/installers/codex-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-installer.d.ts","sourceRoot":"","sources":["../../src/installers/codex-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B;AA4CD,qBAAa,cAAe,YAAW,SAAS;;IAC9C,QAAQ,CAAC,IAAI,WAAW;gBAKZ,SAAS,GAAE,2BAAgC;IAMjD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAK1B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBrD,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAerC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CA4BlG"}

package/dist/installers/codex-installer.js

@@ -0,0 +1,125 @@
+/**
+ * Codex CLI installer — edits ~/.codex/config.toml [mcp_servers.skillforge].
+ *
+ * Codex stores MCP servers in TOML at ~/.codex/config.toml under a
+ * `[mcp_servers.<name>]` table. SkillForge's table shape is:
+ *
+ *   [mcp_servers.skillforge]
+ *   command = "npx"
+ *   args = ["-y", "@lyupro/skillforge-mcp"]
+ *
+ * Per the Codex MCP reference (developers.openai.com/codex/mcp).
+ */
+import { spawnSync } from 'node:child_process';
+import { access } from 'node:fs/promises';
+import { readTomlSafe, writeTomlAtomic } from './atomic-write.js';
+import { codexConfigPath, defaultBinaryPath } from './paths.js';
+const SKILL_KEY = 'skillforge';
+const NPX_PKG = '@lyupro/skillforge-mcp';
+function buildEntry(opts, binaryFallback) {
+    if (opts.entry === 'npx') {
+        return { command: 'npx', args: ['-y', NPX_PKG] };
+    }
+    return { command: 'node', args: [opts.binaryPath ?? binaryFallback] };
+}
+function probeCodexBinary() {
+    try {
+        const result = spawnSync('codex', ['--version'], { stdio: 'ignore' });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+import toml from '@iarna/toml';
+function tomlStringify(obj) {
+    return toml.stringify(obj);
+}
+export class CodexInstaller {
+    name = 'codex';
+    #configPath;
+    #binaryFallback;
+    #probe;
+    constructor(overrides = {}) {
+        this.#configPath = overrides.configPath ?? codexConfigPath();
+        this.#binaryFallback = overrides.binaryPath ?? defaultBinaryPath();
+        this.#probe = overrides.binaryProbe ?? probeCodexBinary;
+    }
+    async detect() {
+        if (this.#probe())
+            return true;
+        return fileExists(this.#configPath);
+    }
+    async install(opts) {
+        const existing = (await readTomlSafe(this.#configPath)) ?? {};
+        const servers = (existing.mcp_servers ?? {});
+        const entry = buildEntry(opts, this.#binaryFallback);
+        if (servers[SKILL_KEY] !== undefined && opts.force !== true) {
+            return {
+                tool: this.name,
+                status: 'already-installed',
+                configPath: this.#configPath,
+                message: `SkillForge entry already present; pass --force to overwrite`,
+            };
+        }
+        const next = {
+            ...existing,
+            mcp_servers: { ...servers, [SKILL_KEY]: entry },
+        };
+        await writeTomlAtomic(this.#configPath, next);
+        const status = servers[SKILL_KEY] !== undefined ? 'updated' : 'installed';
+        return { tool: this.name, status, configPath: this.#configPath };
+    }
+    async uninstall() {
+        const existing = (await readTomlSafe(this.#configPath));
+        if (existing === null || existing.mcp_servers === undefined || existing.mcp_servers[SKILL_KEY] === undefined) {
+            return {
+                tool: this.name,
+                status: 'not-installed',
+                configPath: this.#configPath,
+            };
+        }
+        const { [SKILL_KEY]: _drop, ...rest } = existing.mcp_servers;
+        const next = { ...existing, mcp_servers: rest };
+        await writeTomlAtomic(this.#configPath, next);
+        return { tool: this.name, status: 'uninstalled', configPath: this.#configPath };
+    }
+    async preview(opts) {
+        const existing = (await readTomlSafe(this.#configPath));
+        const before = existing === null ? null : tomlStringify(existing);
+        let nextValue;
+        if (opts.action === 'install') {
+            const base = (existing ?? {});
+            const servers = (base.mcp_servers ?? {});
+            const entry = buildEntry(opts, this.#binaryFallback);
+            nextValue = { ...base, mcp_servers: { ...servers, [SKILL_KEY]: entry } };
+        }
+        else {
+            if (existing === null || existing.mcp_servers === undefined) {
+                nextValue = (existing ?? {});
+            }
+            else {
+                const { [SKILL_KEY]: _drop, ...rest } = existing.mcp_servers;
+                nextValue = { ...existing, mcp_servers: rest };
+            }
+        }
+        return {
+            tool: this.name,
+            configPath: this.#configPath,
+            willCreate: existing === null,
+            before,
+            after: tomlStringify(nextValue),
+            action: opts.action,
+        };
+    }
+}
+//# sourceMappingURL=codex-installer.js.map

package/dist/installers/codex-installer.js.map

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

package/dist/installers/cursor-installer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cursor installer — edits Cursor's settings.json mcp.servers.skillforge.
+ *
+ * Cursor stores its global settings JSON at an OS-specific path:
+ *   Windows: %APPDATA%/Cursor/User/settings.json
+ *   macOS:   ~/Library/Application Support/Cursor/User/settings.json
+ *   Linux:   ~/.config/Cursor/User/settings.json
+ *
+ * The MCP server registry lives under `mcp.servers.<name>` with the same
+ * { command, args, env? } shape used by Claude Code.
+ */
+import type { Installer, InstallOptions, InstallResult, PreviewResult, UninstallResult } from './types.js';
+export interface CursorInstallerPathOverrides {
+    configPath?: string;
+    binaryPath?: string;
+    binaryProbe?: () => boolean;
+}
+export declare class CursorInstaller implements Installer {
+    #private;
+    readonly name = "cursor";
+    constructor(overrides?: CursorInstallerPathOverrides);
+    detect(): Promise<boolean>;
+    install(opts: InstallOptions): Promise<InstallResult>;
+    uninstall(): Promise<UninstallResult>;
+    preview(opts: InstallOptions & {
+        action: 'install' | 'uninstall';
+    }): Promise<PreviewResult>;
+}
+//# sourceMappingURL=cursor-installer.d.ts.map

package/dist/installers/cursor-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-installer.d.ts","sourceRoot":"","sources":["../../src/installers/cursor-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B;AA0DD,qBAAa,eAAgB,YAAW,SAAS;;IAC/C,QAAQ,CAAC,IAAI,YAAY;gBAKb,SAAS,GAAE,4BAAiC;IAMlD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAK1B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBrD,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAUrC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAsBlG"}

package/dist/installers/cursor-installer.js

@@ -0,0 +1,126 @@
+/**
+ * Cursor installer — edits Cursor's settings.json mcp.servers.skillforge.
+ *
+ * Cursor stores its global settings JSON at an OS-specific path:
+ *   Windows: %APPDATA%/Cursor/User/settings.json
+ *   macOS:   ~/Library/Application Support/Cursor/User/settings.json
+ *   Linux:   ~/.config/Cursor/User/settings.json
+ *
+ * The MCP server registry lives under `mcp.servers.<name>` with the same
+ * { command, args, env? } shape used by Claude Code.
+ */
+import { spawnSync } from 'node:child_process';
+import { access } from 'node:fs/promises';
+import { readJsonSafe, writeJsonAtomic } from './atomic-write.js';
+import { cursorSettingsPath, defaultBinaryPath } from './paths.js';
+const SKILL_KEY = 'skillforge';
+const NPX_PKG = '@lyupro/skillforge-mcp';
+function buildEntry(opts, binaryFallback) {
+    if (opts.entry === 'npx') {
+        return { command: 'npx', args: ['-y', NPX_PKG] };
+    }
+    return { command: 'node', args: [opts.binaryPath ?? binaryFallback] };
+}
+function probeCursorBinary() {
+    try {
+        const result = spawnSync('cursor', ['--version'], { stdio: 'ignore' });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readSkillforge(cfg) {
+    return cfg.mcp?.servers?.[SKILL_KEY];
+}
+function mergeInstall(existing, entry) {
+    const mcp = existing.mcp ?? {};
+    const servers = mcp.servers ?? {};
+    return {
+        ...existing,
+        mcp: { ...mcp, servers: { ...servers, [SKILL_KEY]: entry } },
+    };
+}
+function mergeUninstall(existing) {
+    const mcp = existing.mcp;
+    if (mcp === undefined || mcp.servers === undefined)
+        return existing;
+    const { [SKILL_KEY]: _drop, ...rest } = mcp.servers;
+    return { ...existing, mcp: { ...mcp, servers: rest } };
+}
+export class CursorInstaller {
+    name = 'cursor';
+    #configPath;
+    #binaryFallback;
+    #probe;
+    constructor(overrides = {}) {
+        this.#configPath = overrides.configPath ?? cursorSettingsPath();
+        this.#binaryFallback = overrides.binaryPath ?? defaultBinaryPath();
+        this.#probe = overrides.binaryProbe ?? probeCursorBinary;
+    }
+    async detect() {
+        if (this.#probe())
+            return true;
+        return fileExists(this.#configPath);
+    }
+    async install(opts) {
+        const existing = (await readJsonSafe(this.#configPath)) ?? {};
+        const entry = buildEntry(opts, this.#binaryFallback);
+        const prior = readSkillforge(existing);
+        if (prior !== undefined && opts.force !== true) {
+            return {
+                tool: this.name,
+                status: 'already-installed',
+                configPath: this.#configPath,
+                message: `SkillForge entry already present; pass --force to overwrite`,
+            };
+        }
+        const next = mergeInstall(existing, entry);
+        await writeJsonAtomic(this.#configPath, next);
+        return {
+            tool: this.name,
+            status: prior !== undefined ? 'updated' : 'installed',
+            configPath: this.#configPath,
+        };
+    }
+    async uninstall() {
+        const existing = (await readJsonSafe(this.#configPath));
+        if (existing === null || readSkillforge(existing) === undefined) {
+            return { tool: this.name, status: 'not-installed', configPath: this.#configPath };
+        }
+        const next = mergeUninstall(existing);
+        await writeJsonAtomic(this.#configPath, next);
+        return { tool: this.name, status: 'uninstalled', configPath: this.#configPath };
+    }
+    async preview(opts) {
+        const existing = (await readJsonSafe(this.#configPath));
+        const before = existing === null ? null : JSON.stringify(existing, null, 2);
+        let nextValue;
+        if (opts.action === 'install') {
+            const base = existing ?? {};
+            const entry = buildEntry(opts, this.#binaryFallback);
+            nextValue = mergeInstall(base, entry);
+        }
+        else {
+            nextValue = existing === null ? {} : mergeUninstall(existing);
+        }
+        return {
+            tool: this.name,
+            configPath: this.#configPath,
+            willCreate: existing === null,
+            before,
+            after: JSON.stringify(nextValue, null, 2),
+            action: opts.action,
+        };
+    }
+}
+//# sourceMappingURL=cursor-installer.js.map

package/dist/installers/cursor-installer.js.map

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

package/dist/installers/paths.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OS-specific config path helpers for host tools.
+ *
+ * Per repo convention, all SkillForge config paths use `os.homedir()`
+ * exclusively — no platform branching. Cursor is the exception: its
+ * `settings.json` location is third-party (Cursor app), out of our
+ * control, so the platform-specific dispatch here is rubric-exempt.
+ */
+export interface PathOverrides {
+    claudeConfigPath: string;
+    codexConfigPath: string;
+    cursorSettingsPath: string;
+    defaultBinaryPath: string;
+}
+export declare function claudeConfigPath(): string;
+export declare function codexConfigPath(): string;
+export declare function cursorSettingsPath(): string;
+export declare function defaultBinaryPath(): string;
+export declare function defaultPaths(): PathOverrides;
+//# sourceMappingURL=paths.d.ts.map

package/dist/installers/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/installers/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD,wBAAgB,kBAAkB,IAAI,MAAM,CAU3C;AAKD,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED,wBAAgB,YAAY,IAAI,aAAa,CAO5C"}