oh-my-second-brain 0.1.8 → 0.2.0

package/dist/install/claude-marketplace.js

@@ -0,0 +1,89 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { isRecord, runExternal } from "./common.js";
+/**
+ * Published marketplace source used when the running install has no repo
+ * checkout on disk. The npm package ships `adapters/` but not
+ * `.claude-plugin/marketplace.json`, so a released install resolves the
+ * marketplace from GitHub rather than from a local path.
+ */
+const PUBLISHED_MARKETPLACE_REPO = "GoBeromsu/oh-my-second-brain";
+/**
+ * Marketplace name published in `.claude-plugin/marketplace.json`. Only used
+ * when that manifest is not readable locally; a local checkout always wins so
+ * a renamed marketplace cannot drift from the commands OMS prints.
+ */
+const PUBLISHED_MARKETPLACE_NAME = "oms";
+const MARKETPLACE_MANIFEST = path.join(".claude-plugin", "marketplace.json");
+/**
+ * Claude leaves `autoUpdate` off for third-party marketplaces, and
+ * `claude plugin marketplace add` writes the `extraKnownMarketplaces` entry
+ * itself. OMS therefore never touches that key: enabling background updates
+ * for a third-party source stays an explicit user decision.
+ */
+export const MARKETPLACE_AUTO_UPDATE_MESSAGE = "Claude keeps autoUpdate off for third-party marketplaces. To let this marketplace update itself, set " +
+    '`extraKnownMarketplaces.<name>.autoUpdate` to true in ~/.claude/settings.json; otherwise run ' +
+    "`claude plugin marketplace update` when you want a refresh. OMS does not change this setting for you.";
+/**
+ * Reads the marketplace name a repo root declares. Returns null when the
+ * manifest is missing, unreadable, or declares no string `name`, so callers can
+ * fall back instead of printing a command with a guessed marketplace id.
+ */
+export async function readMarketplaceName(repoRoot) {
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(path.join(repoRoot, MARKETPLACE_MANIFEST), "utf-8"));
+    }
+    catch {
+        return null;
+    }
+    if (!isRecord(parsed))
+        return null;
+    const name = parsed["name"];
+    return typeof name === "string" && name.length > 0 ? name : null;
+}
+/**
+ * Resolves the marketplace Claude should add. A repo checkout containing the
+ * manifest above `adapters/` is preferred (dev and offline installs); otherwise
+ * the published GitHub repo is used.
+ */
+export async function resolveClaudeMarketplaceSource(pluginPath) {
+    const repoRoot = path.resolve(pluginPath, "..", "..");
+    const localName = await readMarketplaceName(repoRoot);
+    if (localName !== null) {
+        return { kind: "local", source: repoRoot, marketplaceName: localName };
+    }
+    return {
+        kind: "github",
+        source: PUBLISHED_MARKETPLACE_REPO,
+        marketplaceName: PUBLISHED_MARKETPLACE_NAME,
+    };
+}
+/**
+ * Installs the plugin through the marketplace, falling back to the local plugin
+ * path whenever the marketplace flow does not complete (offline, private
+ * checkout, or a Claude build without the marketplace surface). The fallback is
+ * the pre-marketplace behavior and must stay reachable.
+ */
+export function runClaudePluginInstall(plan) {
+    const messages = [];
+    const addResult = runExternal("claude", ["plugin", "marketplace", "add", plan.marketplace.source]);
+    messages.push(addResult.ok
+        ? `Executed: ${addResult.message}`
+        : "Claude marketplace add failed [claude_marketplace_add_failed]; falling back to the local plugin path.");
+    if (addResult.ok) {
+        const pluginId = `oms@${plan.marketplace.marketplaceName}`;
+        const installResult = runExternal("claude", ["plugin", "install", pluginId]);
+        if (installResult.ok) {
+            messages.push(`Executed: ${installResult.message}`);
+            return { installed: true, messages };
+        }
+        messages.push(`Claude marketplace install of ${pluginId} failed [claude_marketplace_install_failed]; falling back to the local plugin path.`);
+    }
+    const fallbackResult = runExternal("claude", ["plugin", "install", plan.pluginPath]);
+    messages.push(fallbackResult.ok
+        ? `Executed: ${fallbackResult.message} (local plugin path fallback).`
+        : plan.describeFailure(fallbackResult));
+    return { installed: fallbackResult.ok, messages };
+}
+//# sourceMappingURL=claude-marketplace.js.map

package/dist/install/claude-marketplace.js.map

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

package/dist/install/claude.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessHostSurface } from "../harness/surface-registry.js";
+import type { HostOperationOptions, HostOperationResult } from "./types.js";
+export declare function installClaude(options: HostOperationOptions, host: HarnessHostSurface): Promise<HostOperationResult>;
+export declare function uninstallClaude(options: HostOperationOptions): Promise<HostOperationResult>;

package/dist/install/claude.js

@@ -0,0 +1,216 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveHostAdapterSource } from "./adapter-source.js";
+import { commandExists, hostHome, isRecord, runExternal } from "./common.js";
+import { removeClaudeHooks, replaceRootJsonPropertyPreservingBytes, upsertClaudeHooks } from "./claude-hooks.js";
+import { MARKETPLACE_AUTO_UPDATE_MESSAGE, resolveClaudeMarketplaceSource, runClaudePluginInstall, } from "./claude-marketplace.js";
+const CLAUDE_MCP_SCOPES = ["local", "project", "user"];
+function claudeMcpRemoveCommand(scope) {
+    return `claude mcp remove oms --scope ${scope}`;
+}
+function classifyCleanupResult(scope, result) {
+    const manualCommand = claudeMcpRemoveCommand(scope);
+    if (result.ok) {
+        return { scope, status: "removed", reasonCode: "legacy_removed", manualCommand };
+    }
+    const stderr = result.stderr;
+    const localNotFound = scope === "local" && /No local mcp server found with name:\s*oms/i.test(stderr);
+    const projectNotFound = scope === "project" &&
+        /No MCP server found with name:\s*oms/i.test(stderr) &&
+        /\.mcp\.json|project/i.test(stderr);
+    if (localNotFound || projectNotFound) {
+        return { scope, status: "not_found", reasonCode: "legacy_not_found", manualCommand };
+    }
+    return { scope, status: "failed", reasonCode: "legacy_cleanup_failed", manualCommand };
+}
+function cleanupMessage(result) {
+    if (result.status === "removed") {
+        return `Claude MCP cleanup (${result.scope}): removed stale oms registration.`;
+    }
+    if (result.status === "not_found") {
+        return `Claude MCP cleanup (${result.scope}): no stale oms registration found.`;
+    }
+    return `WARNING: Claude MCP cleanup (${result.scope}) failed [${result.reasonCode}]. Install continued. Manual step: ${result.manualCommand}`;
+}
+function plannedCleanupMessages(dryRun) {
+    const prefix = dryRun ? "dry-run: would execute" : "planned external cleanup";
+    return CLAUDE_MCP_SCOPES.map((scope) => `Claude MCP cleanup (${scope}): ${prefix} ${claudeMcpRemoveCommand(scope)}.`);
+}
+function externalLifecycleFailure(action, result) {
+    const reasonCode = result.exitCode === null ? "claude_cli_spawn_failed" : `claude_plugin_${action}_failed`;
+    return `WARNING: Claude plugin ${action} failed [${reasonCode}]. Plugin-owned MCP activation remains a manual step.`;
+}
+function runClaudeMcpCleanup(options) {
+    if (options.dryRun) {
+        return { results: [], messages: plannedCleanupMessages(true), changed: false };
+    }
+    if (!options.executeExternal) {
+        return {
+            results: [],
+            messages: [
+                "Claude MCP cleanup was not executed; pass --execute to remove stale registrations through the Claude CLI.",
+                ...plannedCleanupMessages(false),
+            ],
+            changed: false,
+        };
+    }
+    if (!commandExists("claude")) {
+        const results = CLAUDE_MCP_SCOPES.map((scope) => ({
+            scope,
+            status: "failed",
+            reasonCode: "claude_cli_unavailable",
+            manualCommand: claudeMcpRemoveCommand(scope),
+        }));
+        return {
+            results,
+            messages: results.map(cleanupMessage),
+            changed: false,
+        };
+    }
+    const results = CLAUDE_MCP_SCOPES.map((scope) => {
+        const result = runExternal("claude", ["mcp", "remove", "oms", "--scope", scope]);
+        return classifyCleanupResult(scope, result);
+    });
+    return {
+        results,
+        messages: results.map(cleanupMessage),
+        changed: results.some((result) => result.status === "removed"),
+    };
+}
+async function removeClaudeMcp(options, claudeDir) {
+    const mcpPath = path.join(claudeDir, "mcp.json");
+    let raw;
+    try {
+        raw = await readFile(mcpPath, "utf-8");
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            return { changed: false };
+        return { changed: false, message: `WARNING: Could not read ${mcpPath}; direct MCP cleanup skipped. Remove stale oms manually.` };
+    }
+    let data;
+    try {
+        const parsed = JSON.parse(raw);
+        if (!isRecord(parsed)) {
+            return { changed: false, message: `WARNING: ${mcpPath} is not a JSON object; direct MCP cleanup skipped.` };
+        }
+        data = parsed;
+    }
+    catch {
+        return { changed: false, message: `WARNING: ${mcpPath} is malformed JSON; direct MCP cleanup skipped.` };
+    }
+    const existingServers = data["mcpServers"];
+    if (existingServers !== undefined && !isRecord(existingServers)) {
+        return { changed: false, message: `WARNING: ${mcpPath} has unsupported mcpServers metadata; direct MCP cleanup skipped.` };
+    }
+    if (!isRecord(existingServers) || !("oms" in existingServers)) {
+        return { changed: false };
+    }
+    delete existingServers["oms"];
+    const next = replaceRootJsonPropertyPreservingBytes(raw, "mcpServers", existingServers);
+    if (next === null) {
+        return { changed: false, message: `WARNING: Could not preserve unmanaged MCP config bytes in ${mcpPath}; direct cleanup skipped.` };
+    }
+    if (!options.dryRun) {
+        try {
+            await writeFile(mcpPath, next, "utf-8");
+        }
+        catch {
+            return { changed: false, message: `WARNING: Could not write ${mcpPath}; direct MCP cleanup skipped. Remove stale oms manually.` };
+        }
+    }
+    return { changed: !options.dryRun };
+}
+export async function installClaude(options, host) {
+    const claudeDir = hostHome(options.homeDir, ".claude", "OMS_CLAUDE_HOME");
+    const pluginPath = resolveHostAdapterSource(options.adapterRoot, host);
+    const marketplace = await resolveClaudeMarketplaceSource(pluginPath);
+    const commands = [
+        ...CLAUDE_MCP_SCOPES.map(claudeMcpRemoveCommand),
+        `claude plugin marketplace add ${marketplace.source}`,
+        `claude plugin install oms@${marketplace.marketplaceName}`,
+        `claude plugin install ${pluginPath}`,
+    ];
+    const messages = [
+        "Claude Code adapter is installed through the plugin-owned MCP surface declared in .mcp.json.",
+        `Claude marketplace source: ${marketplace.source} (${marketplace.kind}); the local plugin path stays available as an offline fallback.`,
+        MARKETPLACE_AUTO_UPDATE_MESSAGE,
+    ];
+    const directCleanup = await removeClaudeMcp(options, claudeDir);
+    let changed = directCleanup.changed;
+    if (directCleanup.changed)
+        messages.push("Removed stale direct oms MCP registration from Claude local config.");
+    if (directCleanup.message)
+        messages.push(directCleanup.message);
+    let pluginInstalled = false;
+    const cleanup = runClaudeMcpCleanup(options);
+    messages.push(...cleanup.messages);
+    changed = cleanup.changed || changed;
+    if (options.executeExternal) {
+        if (!commandExists("claude")) {
+            messages.push("Claude CLI was not found; no plugin or MCP activation was performed. Run the listed plugin command manually.");
+        }
+        else if (!options.dryRun) {
+            const install = runClaudePluginInstall({
+                marketplace,
+                pluginPath,
+                describeFailure: (result) => externalLifecycleFailure("install", result),
+            });
+            messages.push(...install.messages);
+            changed = changed || install.installed;
+            pluginInstalled = install.installed;
+        }
+    }
+    if (!pluginInstalled)
+        messages.push("Claude plugin was not installed; plugin-owned MCP activation remains a manual step.");
+    const hookResult = await upsertClaudeHooks(options, claudeDir);
+    changed = hookResult.changed || changed;
+    messages.push(...hookResult.messages);
+    return {
+        runtime: "claude",
+        action: "install",
+        changed: changed && !options.dryRun,
+        skipped: false,
+        paths: [pluginPath, path.join(claudeDir, "settings.json")],
+        commands,
+        messages,
+        cleanup: cleanup.results,
+    };
+}
+export async function uninstallClaude(options) {
+    const claudeDir = hostHome(options.homeDir, ".claude", "OMS_CLAUDE_HOME");
+    const commands = [
+        ...CLAUDE_MCP_SCOPES.map(claudeMcpRemoveCommand),
+        "claude plugin uninstall oms",
+    ];
+    const messages = ["Claude Code uninstall removes the Oh My Second Brain MCP entry and, when requested, asks Claude CLI to uninstall the plugin."];
+    const directCleanup = await removeClaudeMcp(options, claudeDir);
+    let changed = directCleanup.changed;
+    if (directCleanup.message)
+        messages.push(directCleanup.message);
+    const cleanup = runClaudeMcpCleanup(options);
+    messages.push(...cleanup.messages);
+    changed = cleanup.changed || changed;
+    const hookResult = await removeClaudeHooks(options, claudeDir);
+    changed = hookResult.changed || changed;
+    messages.push(...hookResult.messages);
+    if (options.executeExternal && commandExists("claude") && !options.dryRun) {
+        const externalCommands = [["claude", "plugin", "uninstall", "oms"]];
+        for (const [command, ...args] of externalCommands) {
+            const result = runExternal(command, args);
+            messages.push(result.ok ? `Executed: ${result.message}` : externalLifecycleFailure("uninstall", result));
+            changed = changed || result.ok;
+        }
+    }
+    return {
+        runtime: "claude",
+        action: "uninstall",
+        changed: changed && !options.dryRun,
+        skipped: false,
+        paths: [path.join(claudeDir, "mcp.json")],
+        commands,
+        messages,
+        cleanup: cleanup.results,
+    };
+}
+//# sourceMappingURL=claude.js.map

package/dist/install/claude.js.map

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

package/dist/install/codex.d.ts

@@ -0,0 +1,24 @@
+import type { HarnessHostSurface } from "../harness/surface-registry.js";
+import type { HostOperationOptions, HostOperationResult } from "./types.js";
+export declare class CodexSkillNamespaceError extends Error {
+    readonly skillDir: string;
+    readonly prefix: string;
+    constructor(skillDir: string, prefix: string);
+}
+/**
+ * Codex install stays file-copy based on purpose.
+ *
+ * `codex plugin marketplace add <repo>` does consume the same root
+ * `.claude-plugin/marketplace.json` (verified against codex-cli 0.147.0: the
+ * marketplace resolves as `oms` and `codex plugin add oms@oms` succeeds), but
+ * the manifest's plugin entry declares `"source": "./"`, so Codex caches the
+ * whole repository and finds no `rules/` or `skills/` at the cached root —
+ * those live under `adapters/codex/`. A marketplace install would therefore
+ * register a plugin that delivers none of the Codex-native surfaces this
+ * function installs, on top of the managed MCP block it already writes.
+ *
+ * Wiring Codex to the shared manifest needs a Codex-native descriptor whose
+ * source points at `adapters/codex`; that is a follow-up, not this change.
+ */
+export declare function installCodex(options: HostOperationOptions, host: HarnessHostSurface): Promise<HostOperationResult>;
+export declare function uninstallCodex(options: HostOperationOptions): Promise<HostOperationResult>;

package/dist/install/codex.js

@@ -0,0 +1,193 @@
+import { existsSync } from "node:fs";
+import { cp, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveHostAdapterSource } from "./adapter-source.js";
+import { hostHome, jsonString, mcpArgs, replaceDirectory } from "./common.js";
+const MANAGED_CODEX_START = "# BEGIN OMS MANAGED MCP";
+const MANAGED_CODEX_END = "# END OMS MANAGED MCP";
+const CODEX_SKILL_PREFIX = "oms-";
+const CODEX_RULE_FILENAME = "oms.md";
+export class CodexSkillNamespaceError extends Error {
+    skillDir;
+    prefix;
+    constructor(skillDir, prefix) {
+        super(`Codex skill directory must be namespaced ${prefix}*: ${skillDir}`);
+        this.name = "CodexSkillNamespaceError";
+        this.skillDir = skillDir;
+        this.prefix = prefix;
+    }
+}
+function codexManagedBlock(options) {
+    const args = mcpArgs(options).map(jsonString).join(", ");
+    return [
+        MANAGED_CODEX_START,
+        "# OMS MCP hookup for Codex CLI. Managed by `oms install/uninstall`.",
+        "# Codex-native rules live in ~/.codex/rules/oms.md; skills live in ~/.codex/skills/oms-*.",
+        "[mcp_servers.oms]",
+        'command = "oms"',
+        `args = [${args}]`,
+        "",
+        "[mcp_servers.oms.env]",
+        'OMS_AGENT_RUNTIME = "codex"',
+        MANAGED_CODEX_END,
+        "",
+    ].join("\n");
+}
+function isCodexOMSTable(line) {
+    return line === "[mcp_servers.oms]" || line.startsWith("[mcp_servers.oms.");
+}
+function removeManagedCodexBlock(content) {
+    const start = MANAGED_CODEX_START.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const end = MANAGED_CODEX_END.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const markerPattern = new RegExp(`\\n?${start}[\\s\\S]*?${end}\\n?`, "g");
+    const withoutMarkers = content.replace(markerPattern, "\n");
+    const markerRemoved = withoutMarkers !== content;
+    const lines = withoutMarkers.split(/\r?\n/);
+    const output = [];
+    let removedLegacy = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        const trimmed = line.trim();
+        if (isCodexOMSTable(trimmed)) {
+            removedLegacy = true;
+            i++;
+            while (i < lines.length) {
+                const next = (lines[i] ?? "").trim();
+                const isTable = /^\[[^\]]+\]$/.test(next);
+                if (isTable && !isCodexOMSTable(next)) {
+                    i--;
+                    break;
+                }
+                i++;
+            }
+            continue;
+        }
+        if (line.includes("OMS MCP hookup for Codex CLI")) {
+            removedLegacy = true;
+            continue;
+        }
+        output.push(line);
+    }
+    return { content: `${output.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd()}\n`, removed: markerRemoved || removedLegacy };
+}
+async function installCodexNativeArtifacts(codexDir, options, adapterSource) {
+    const paths = [];
+    const rulesSource = path.join(adapterSource, "rules", CODEX_RULE_FILENAME);
+    const rulesTarget = path.join(codexDir, "rules", CODEX_RULE_FILENAME);
+    const skillsSource = path.join(adapterSource, "skills");
+    const skillsTargetRoot = path.join(codexDir, "skills");
+    if (!options.dryRun) {
+        await mkdir(path.dirname(rulesTarget), { recursive: true });
+        await cp(rulesSource, rulesTarget);
+        await mkdir(skillsTargetRoot, { recursive: true });
+        const entries = await readdir(skillsSource, { withFileTypes: true });
+        const desired = new Set(entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name));
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const target = path.join(skillsTargetRoot, entry.name);
+            if (!entry.name.startsWith(CODEX_SKILL_PREFIX)) {
+                throw new CodexSkillNamespaceError(entry.name, CODEX_SKILL_PREFIX);
+            }
+            await replaceDirectory(path.join(skillsSource, entry.name), target, false);
+            paths.push(target);
+        }
+        const installed = await readdir(skillsTargetRoot, { withFileTypes: true });
+        for (const entry of installed) {
+            if (entry.isDirectory() && entry.name.startsWith(CODEX_SKILL_PREFIX) && !desired.has(entry.name)) {
+                await rm(path.join(skillsTargetRoot, entry.name), { recursive: true, force: true });
+            }
+        }
+    }
+    else {
+        paths.push(path.join(skillsTargetRoot, `${CODEX_SKILL_PREFIX}setup`));
+    }
+    return [rulesTarget, ...paths];
+}
+/**
+ * Codex install stays file-copy based on purpose.
+ *
+ * `codex plugin marketplace add <repo>` does consume the same root
+ * `.claude-plugin/marketplace.json` (verified against codex-cli 0.147.0: the
+ * marketplace resolves as `oms` and `codex plugin add oms@oms` succeeds), but
+ * the manifest's plugin entry declares `"source": "./"`, so Codex caches the
+ * whole repository and finds no `rules/` or `skills/` at the cached root —
+ * those live under `adapters/codex/`. A marketplace install would therefore
+ * register a plugin that delivers none of the Codex-native surfaces this
+ * function installs, on top of the managed MCP block it already writes.
+ *
+ * Wiring Codex to the shared manifest needs a Codex-native descriptor whose
+ * source points at `adapters/codex`; that is a follow-up, not this change.
+ */
+export async function installCodex(options, host) {
+    const codexDir = hostHome(options.homeDir, ".codex", "OMS_CODEX_HOME");
+    const pluginSource = resolveHostAdapterSource(options.adapterRoot, host);
+    const pluginTarget = path.join(codexDir, "plugins", "oms");
+    const configPath = path.join(codexDir, "config.toml");
+    const original = existsSync(configPath) ? await readFile(configPath, "utf-8") : "";
+    const stripped = removeManagedCodexBlock(original).content;
+    const next = `${stripped.trimEnd()}\n\n${codexManagedBlock(options)}`;
+    let nativePaths = [];
+    if (!options.dryRun) {
+        await mkdir(path.dirname(configPath), { recursive: true });
+        await writeFile(configPath, next, "utf-8");
+        await replaceDirectory(pluginSource, pluginTarget, false);
+        nativePaths = await installCodexNativeArtifacts(codexDir, options, pluginSource);
+    }
+    else {
+        nativePaths = [
+            path.join(codexDir, "rules", CODEX_RULE_FILENAME),
+            path.join(codexDir, "skills", `${CODEX_SKILL_PREFIX}setup`),
+        ];
+    }
+    return {
+        runtime: "codex",
+        action: "install",
+        changed: !options.dryRun,
+        skipped: false,
+        paths: [configPath, pluginTarget, ...nativePaths],
+        commands: [`Codex MCP config: ${configPath}`],
+        messages: ["Installed Codex-native Oh My Second Brain rules, namespaced skills, plugin assets, and managed MCP/env config."],
+    };
+}
+export async function uninstallCodex(options) {
+    const codexDir = hostHome(options.homeDir, ".codex", "OMS_CODEX_HOME");
+    const pluginTarget = path.join(codexDir, "plugins", "oms");
+    const configPath = path.join(codexDir, "config.toml");
+    const ruleTarget = path.join(codexDir, "rules", CODEX_RULE_FILENAME);
+    const skillsRoot = path.join(codexDir, "skills");
+    let changed = false;
+    if (existsSync(configPath)) {
+        const original = await readFile(configPath, "utf-8");
+        const removed = removeManagedCodexBlock(original);
+        changed = removed.removed;
+        if (removed.removed && !options.dryRun)
+            await writeFile(configPath, removed.content, "utf-8");
+    }
+    for (const target of [pluginTarget, ruleTarget]) {
+        if (existsSync(target)) {
+            changed = true;
+            if (!options.dryRun)
+                await rm(target, { recursive: true, force: true });
+        }
+    }
+    if (existsSync(skillsRoot)) {
+        for (const entry of await readdir(skillsRoot, { withFileTypes: true })) {
+            if (entry.isDirectory() && entry.name.startsWith(CODEX_SKILL_PREFIX)) {
+                changed = true;
+                if (!options.dryRun)
+                    await rm(path.join(skillsRoot, entry.name), { recursive: true, force: true });
+            }
+        }
+    }
+    return {
+        runtime: "codex",
+        action: "uninstall",
+        changed: changed && !options.dryRun,
+        skipped: !changed,
+        paths: [configPath, pluginTarget, ruleTarget, path.join(skillsRoot, `${CODEX_SKILL_PREFIX}*`)],
+        commands: [],
+        messages: ["Removed Codex managed MCP block, Oh My Second Brain rule, namespaced Oh My Second Brain skills, and plugin assets."],
+    };
+}
+//# sourceMappingURL=codex.js.map

package/dist/install/codex.js.map

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

package/dist/install/common.d.ts

@@ -0,0 +1,34 @@
+import type { HostOperationOptions } from "./types.js";
+export declare class InstallTargetSymlinkError extends Error {
+    readonly target: string;
+    constructor(target: string);
+}
+export declare function commandExists(command: string): boolean;
+export declare function hostHome(homeDir: string | undefined, dirname: string, envName: string): string;
+export declare function mcpArgs(options: HostOperationOptions): string[];
+export declare function jsonString(value: string): string;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function readJsonObject(file: string): Promise<Record<string, unknown>>;
+export declare function writeJsonObject(file: string, data: Record<string, unknown>, dryRun: boolean): Promise<boolean>;
+export type YamlEntryEdit = {
+    readonly kind: "set";
+    readonly value: Record<string, unknown>;
+} | {
+    readonly kind: "delete";
+};
+/**
+ * Applies one `section.key` edit to a YAML file while leaving every other byte,
+ * comment, and key ordering the document already had in place.
+ */
+export declare function editYamlEntryPreservingComments(file: string, entryPath: readonly [string, string], edit: YamlEntryEdit): Promise<boolean>;
+export declare function mcpServerEntry(options: HostOperationOptions): Record<string, unknown>;
+export interface ExternalCommandResult {
+    readonly ok: boolean;
+    readonly exitCode: number | null;
+    readonly signal: NodeJS.Signals | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly message: string;
+}
+export declare function runExternal(command: string, args: string[]): ExternalCommandResult;
+export declare function replaceDirectory(source: string, target: string, dryRun: boolean): Promise<boolean>;