openlore 2.0.1 → 2.0.3

package/dist/cli/install/adapters/claude-code.js

@@ -0,0 +1,184 @@
+/**
+ * claude-code adapter — appends the OpenLore instruction block to CLAUDE.md
+ * (creating it if absent) and adds a SessionStart hook + MCP server
+ * registration to `.claude/settings.json`.
+ */
+import { mkdir, readFile, writeFile, unlink } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { applyMarkdownBlock, uninstallMarkdownBlock } from './markdown-block.js';
+import { mergeEntries, readMeta, removeManaged, isHandEdited } from '../json-managed.js';
+import { previewCreate, previewDiff } from '../diff.js';
+const MD_FILE = 'CLAUDE.md';
+const SETTINGS_PATH = '.claude/settings.json';
+const MCP_ENTRY = {
+    command: 'npx',
+    args: ['--yes', 'openlore', 'mcp'],
+};
+/**
+ * Our SessionStart entry is marked with `_openlore: true` so we can identify
+ * (and replace, or remove on uninstall) just our group without touching any
+ * other SessionStart hooks the user may have configured. Claude Code ignores
+ * unknown fields on matcher groups.
+ */
+const ORIENT_COMMAND = 'npx --yes openlore orient --json';
+const SESSION_HOOK = {
+    matcher: '',
+    _openlore: true,
+    hooks: [
+        {
+            type: 'command',
+            command: ORIENT_COMMAND,
+        },
+    ],
+};
+function isOurSessionEntry(entry) {
+    if (!entry || typeof entry !== 'object')
+        return false;
+    return entry._openlore === true;
+}
+function mergeSessionStart(existing) {
+    const arr = Array.isArray(existing) ? existing : [];
+    const withoutOurs = arr.filter((e) => !isOurSessionEntry(e));
+    return [...withoutOurs, SESSION_HOOK];
+}
+function stripOurSessionStart(existing) {
+    const arr = Array.isArray(existing) ? existing : [];
+    return arr.filter((e) => !isOurSessionEntry(e));
+}
+async function readJsonOrEmpty(path) {
+    try {
+        const raw = await readFile(path, 'utf8');
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+async function fileExists(path) {
+    try {
+        await readFile(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export const claudeCodeAdapter = {
+    name: 'claude-code',
+    async apply(ctx) {
+        const mdResult = await applyMarkdownBlock(ctx, {
+            fileName: MD_FILE,
+            createIfMissing: true,
+            blockBody: ctx.instructionTemplate,
+        });
+        const settingsPath = join(ctx.root, SETTINGS_PATH);
+        const existing = await readJsonOrEmpty(settingsPath);
+        const had = await fileExists(settingsPath);
+        const prevMeta = readMeta(existing);
+        if (prevMeta && isHandEdited(existing, prevMeta) && !ctx.force) {
+            mdResult.changes.push({
+                path: settingsPath,
+                kind: 'noop',
+                summary: `${SETTINGS_PATH}: refused to overwrite hand-edited OpenLore entries (use --force)`,
+            });
+            mdResult.warnings.push(`${SETTINGS_PATH} has hand-edits in OpenLore-managed paths — pass --force to overwrite`);
+            mdResult.conflict = true;
+            return mdResult;
+        }
+        // SessionStart is computed imperatively (preserving any user-defined
+        // entries) and written through mergeEntries, but only mcpServers.openlore
+        // is tracked in our meta — we identify our SessionStart entry by its
+        // `_openlore: true` marker, not by claiming the whole array.
+        const currentSessionStart = existing.hooks?.SessionStart ?? [];
+        const nextSessionStart = mergeSessionStart(currentSessionStart);
+        const { next, action } = mergeEntries(existing, [
+            { path: 'mcpServers.openlore', value: MCP_ENTRY },
+        ]);
+        // Apply the SessionStart update outside the managed-paths set.
+        if (!next.hooks || typeof next.hooks !== 'object')
+            next.hooks = {};
+        next.hooks.SessionStart = nextSessionStart;
+        // Re-derive action: if existing already had identical SessionStart + meta noop, it's noop.
+        const sessionChanged = JSON.stringify(currentSessionStart) !== JSON.stringify(nextSessionStart);
+        const finalAction = action === 'noop' && !sessionChanged ? 'noop' : action === 'created' ? 'created' : 'updated';
+        const before = had ? JSON.stringify(existing, null, 2) + '\n' : '';
+        const after = JSON.stringify(next, null, 2) + '\n';
+        const change = {
+            path: settingsPath,
+            kind: !had ? 'create' : finalAction === 'noop' ? 'noop' : 'update',
+            summary: !had
+                ? `create ${SETTINGS_PATH} with SessionStart hook + mcpServers.openlore`
+                : finalAction === 'noop'
+                    ? `${SETTINGS_PATH}: already up to date`
+                    : `update SessionStart hook + mcpServers.openlore in ${SETTINGS_PATH}`,
+            preview: !had
+                ? previewCreate(settingsPath, after)
+                : finalAction === 'noop'
+                    ? undefined
+                    : previewDiff(settingsPath, before, after),
+        };
+        if (!ctx.dryRun && (finalAction !== 'noop' || !had)) {
+            await mkdir(dirname(settingsPath), { recursive: true });
+            await writeFile(settingsPath, JSON.stringify(next, null, 2) + '\n', 'utf8');
+        }
+        mdResult.changes.push(change);
+        return mdResult;
+    },
+    async uninstall(ctx) {
+        const md = await uninstallMarkdownBlock(ctx, MD_FILE, false);
+        const settingsPath = join(ctx.root, SETTINGS_PATH);
+        let parsed;
+        try {
+            parsed = JSON.parse(await readFile(settingsPath, 'utf8'));
+        }
+        catch {
+            return md;
+        }
+        // Strip our SessionStart entry first (it's identified by _openlore marker,
+        // not by the managed-paths meta).
+        const hooksObj = parsed.hooks;
+        if (hooksObj && Array.isArray(hooksObj.SessionStart)) {
+            const filtered = stripOurSessionStart(hooksObj.SessionStart);
+            if (filtered.length === 0) {
+                delete hooksObj.SessionStart;
+                if (Object.keys(hooksObj).length === 0)
+                    delete parsed.hooks;
+            }
+            else {
+                hooksObj.SessionStart = filtered;
+            }
+        }
+        const { next, removed } = removeManaged(parsed);
+        if (!removed && parsed.hooks === undefined) {
+            // We may have only stripped a SessionStart entry — that still counts as work.
+        }
+        else if (!removed) {
+            return md;
+        }
+        // If file is now empty (only had our entries), delete it.
+        const isEmpty = Object.keys(next).length === 0;
+        if (isEmpty) {
+            if (!ctx.dryRun)
+                await unlink(settingsPath);
+            md.changes.push({
+                path: settingsPath,
+                kind: 'delete',
+                summary: `remove ${SETTINGS_PATH} (was OpenLore-only)`,
+            });
+        }
+        else {
+            if (!ctx.dryRun)
+                await writeFile(settingsPath, JSON.stringify(next, null, 2) + '\n', 'utf8');
+            md.changes.push({
+                path: settingsPath,
+                kind: 'update',
+                summary: `strip OpenLore entries from ${SETTINGS_PATH}`,
+            });
+        }
+        return md;
+    },
+};
+//# sourceMappingURL=claude-code.js.map

package/dist/cli/install/adapters/claude-code.js.map

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

package/dist/cli/install/adapters/cline.d.ts

@@ -0,0 +1,6 @@
+/**
+ * cline adapter — appends the OpenLore instruction block to `.clinerules`.
+ */
+import type { Adapter } from './types.js';
+export declare const clineAdapter: Adapter;
+//# sourceMappingURL=cline.d.ts.map

package/dist/cli/install/adapters/cline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cline.d.ts","sourceRoot":"","sources":["../../../../src/cli/install/adapters/cline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,YAAY,CAAC;AAIxD,eAAO,MAAM,YAAY,EAAE,OAY1B,CAAC"}

package/dist/cli/install/adapters/cline.js

@@ -0,0 +1,19 @@
+/**
+ * cline adapter — appends the OpenLore instruction block to `.clinerules`.
+ */
+import { applyMarkdownBlock, uninstallMarkdownBlock } from './markdown-block.js';
+const FILE_NAME = '.clinerules';
+export const clineAdapter = {
+    name: 'cline',
+    async apply(ctx) {
+        return applyMarkdownBlock(ctx, {
+            fileName: FILE_NAME,
+            createIfMissing: true,
+            blockBody: ctx.instructionTemplate,
+        });
+    },
+    async uninstall(ctx) {
+        return uninstallMarkdownBlock(ctx, FILE_NAME, true);
+    },
+};
+//# sourceMappingURL=cline.js.map

package/dist/cli/install/adapters/cline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cline.js","sourceRoot":"","sources":["../../../../src/cli/install/adapters/cline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGjF,MAAM,SAAS,GAAG,aAAa,CAAC;AAEhC,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,IAAI,EAAE,OAAO;IACb,KAAK,CAAC,KAAK,CAAC,GAAiB;QAC3B,OAAO,kBAAkB,CAAC,GAAG,EAAE;YAC7B,QAAQ,EAAE,SAAS;YACnB,eAAe,EAAE,IAAI;YACrB,SAAS,EAAE,GAAG,CAAC,mBAAmB;SACnC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,SAAS,CAAC,GAAiB;QAC/B,OAAO,sBAAsB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;CACF,CAAC"}

package/dist/cli/install/adapters/continue.d.ts

@@ -0,0 +1,13 @@
+/**
+ * continue adapter — adds an "/orient" slash command entry to
+ * `.continue/config.json`. The Continue config schema accepts a top-level
+ * `slashCommands` array; we add (or replace) an entry whose `name === 'orient'`.
+ *
+ * Continue's MCP integration path differs across recent versions; rather than
+ * guess and silently write to the wrong key, we leave a TODO and warn the user
+ * (per spec-01 "do not guess" rule). MCP server registration for Continue is
+ * gated behind a follow-up TODO.
+ */
+import type { Adapter } from './types.js';
+export declare const continueAdapter: Adapter;
+//# sourceMappingURL=continue.d.ts.map

package/dist/cli/install/adapters/continue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continue.d.ts","sourceRoot":"","sources":["../../../../src/cli/install/adapters/continue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,OAAO,EAA4C,MAAM,YAAY,CAAC;AAUpF,eAAO,MAAM,eAAe,EAAE,OAyG7B,CAAC"}

package/dist/cli/install/adapters/continue.js

@@ -0,0 +1,119 @@
+/**
+ * continue adapter — adds an "/orient" slash command entry to
+ * `.continue/config.json`. The Continue config schema accepts a top-level
+ * `slashCommands` array; we add (or replace) an entry whose `name === 'orient'`.
+ *
+ * Continue's MCP integration path differs across recent versions; rather than
+ * guess and silently write to the wrong key, we leave a TODO and warn the user
+ * (per spec-01 "do not guess" rule). MCP server registration for Continue is
+ * gated behind a follow-up TODO.
+ */
+import { mkdir, readFile, writeFile, unlink } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { mergeEntries, readMeta, removeManaged, isHandEdited } from '../json-managed.js';
+import { previewCreate, previewDiff } from '../diff.js';
+const CONFIG_PATH = '.continue/config.json';
+const SLASH_COMMAND = {
+    name: 'orient',
+    description: 'Call openlore orient() for the current task context',
+    run: 'npx --yes openlore orient --json',
+};
+export const continueAdapter = {
+    name: 'continue',
+    async apply(ctx) {
+        const configPath = join(ctx.root, CONFIG_PATH);
+        let had = true;
+        let existing;
+        try {
+            existing = JSON.parse(await readFile(configPath, 'utf8'));
+        }
+        catch {
+            existing = {};
+            had = false;
+        }
+        const prevMeta = readMeta(existing);
+        if (prevMeta && isHandEdited(existing, prevMeta) && !ctx.force) {
+            return {
+                changes: [
+                    {
+                        path: configPath,
+                        kind: 'noop',
+                        summary: `${CONFIG_PATH}: refused to overwrite hand-edited OpenLore entries (use --force)`,
+                    },
+                ],
+                warnings: [`${CONFIG_PATH} has hand-edits in OpenLore-managed paths — pass --force to overwrite`],
+                conflict: true,
+            };
+        }
+        // Preserve any non-OpenLore slashCommands already present.
+        const existingSlash = Array.isArray(existing.slashCommands) ? existing.slashCommands : [];
+        const otherSlash = existingSlash.filter((c) => c?.name !== 'orient');
+        const nextSlash = [...otherSlash, SLASH_COMMAND];
+        const { next, action } = mergeEntries(existing, [
+            { path: 'slashCommands', value: nextSlash },
+        ]);
+        const before = had ? JSON.stringify(existing, null, 2) + '\n' : '';
+        const after = JSON.stringify(next, null, 2) + '\n';
+        const change = {
+            path: configPath,
+            kind: !had ? 'create' : action === 'noop' ? 'noop' : 'update',
+            summary: !had
+                ? `create ${CONFIG_PATH} with /orient slash command`
+                : action === 'noop'
+                    ? `${CONFIG_PATH}: already up to date`
+                    : `add /orient slash command to ${CONFIG_PATH}`,
+            preview: !had
+                ? previewCreate(configPath, after)
+                : action === 'noop'
+                    ? undefined
+                    : previewDiff(configPath, before, after),
+        };
+        const warnings = [
+            // TODO(openlore-spec-01): verify Continue MCP server registration path; not written here.
+            'continue: MCP server registration is not yet wired (path varies by Continue version) — slash command only',
+        ];
+        if (!ctx.dryRun && (action !== 'noop' || !had)) {
+            await mkdir(dirname(configPath), { recursive: true });
+            await writeFile(configPath, JSON.stringify(next, null, 2) + '\n', 'utf8');
+        }
+        return { changes: [change], warnings, conflict: false };
+    },
+    async uninstall(ctx) {
+        const configPath = join(ctx.root, CONFIG_PATH);
+        let parsed;
+        try {
+            parsed = JSON.parse(await readFile(configPath, 'utf8'));
+        }
+        catch {
+            return { changes: [], warnings: [], conflict: false };
+        }
+        const beforeSlash = Array.isArray(parsed.slashCommands) ? parsed.slashCommands : [];
+        const filteredSlash = beforeSlash.filter((c) => c?.name !== 'orient');
+        if (filteredSlash.length === beforeSlash.length && !readMeta(parsed)) {
+            return { changes: [], warnings: [], conflict: false };
+        }
+        parsed.slashCommands = filteredSlash;
+        const { next } = removeManaged(parsed);
+        if (Array.isArray(next.slashCommands) && next.slashCommands.length === 0) {
+            delete next.slashCommands;
+        }
+        const isEmpty = Object.keys(next).length === 0;
+        if (isEmpty) {
+            if (!ctx.dryRun)
+                await unlink(configPath);
+            return {
+                changes: [{ path: configPath, kind: 'delete', summary: `remove ${CONFIG_PATH} (was OpenLore-only)` }],
+                warnings: [],
+                conflict: false,
+            };
+        }
+        if (!ctx.dryRun)
+            await writeFile(configPath, JSON.stringify(next, null, 2) + '\n', 'utf8');
+        return {
+            changes: [{ path: configPath, kind: 'update', summary: `strip OpenLore entries from ${CONFIG_PATH}` }],
+            warnings: [],
+            conflict: false,
+        };
+    },
+};
+//# sourceMappingURL=continue.js.map

package/dist/cli/install/adapters/continue.js.map

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

package/dist/cli/install/adapters/cursor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * cursor adapter — writes an OpenLore-managed block to `.cursorrules`, a
+ * companion `.cursor/rules/openlore.mdc` file describing the orient() workflow,
+ * and registers the OpenLore MCP server in `.cursor/mcp.json`.
+ */
+import type { Adapter } from './types.js';
+export declare const cursorAdapter: Adapter;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/cli/install/adapters/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../../src/cli/install/adapters/cursor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,OAAO,EAA4C,MAAM,YAAY,CAAC;AAoCpF,eAAO,MAAM,aAAa,EAAE,OA0J3B,CAAC"}

package/dist/cli/install/adapters/cursor.js

@@ -0,0 +1,195 @@
+/**
+ * cursor adapter — writes an OpenLore-managed block to `.cursorrules`, a
+ * companion `.cursor/rules/openlore.mdc` file describing the orient() workflow,
+ * and registers the OpenLore MCP server in `.cursor/mcp.json`.
+ */
+import { mkdir, readFile, writeFile, unlink } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { applyMarkdownBlock, uninstallMarkdownBlock } from './markdown-block.js';
+import { fingerprint } from '../block.js';
+import { mergeEntries, readMeta, removeManaged, isHandEdited } from '../json-managed.js';
+import { previewCreate, previewDiff } from '../diff.js';
+const RULES_FILE = '.cursorrules';
+const MDC_FILE = '.cursor/rules/openlore.mdc';
+const MCP_FILE = '.cursor/mcp.json';
+const MCP_ENTRY = {
+    command: 'npx',
+    args: ['--yes', 'openlore', 'mcp'],
+};
+async function loadMdcTemplate() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        // adapters/ → ../templates/cursor-openlore.mdc (dist + tsx run share this layout)
+        join(here, '..', 'templates', 'cursor-openlore.mdc'),
+        // tsx fallback if for any reason we're not co-located with templates
+        join(here, '..', '..', '..', '..', 'src', 'cli', 'install', 'templates', 'cursor-openlore.mdc'),
+    ];
+    for (const p of candidates) {
+        try {
+            return await readFile(p, 'utf8');
+        }
+        catch {
+            /* try next */
+        }
+    }
+    throw new Error('cursor adapter: could not locate cursor-openlore.mdc template');
+}
+async function renderMdc(instructions) {
+    const tmpl = await loadMdcTemplate();
+    return tmpl
+        .replace('{{fingerprint}}', fingerprint(instructions.trimEnd()))
+        .replace('{{instructions}}', instructions.trimEnd());
+}
+export const cursorAdapter = {
+    name: 'cursor',
+    async apply(ctx) {
+        const rulesResult = await applyMarkdownBlock(ctx, {
+            fileName: RULES_FILE,
+            createIfMissing: true,
+            blockBody: ctx.instructionTemplate,
+        });
+        const mdcPath = join(ctx.root, MDC_FILE);
+        const desired = await renderMdc(ctx.instructionTemplate);
+        let existing = null;
+        try {
+            existing = await readFile(mdcPath, 'utf8');
+        }
+        catch {
+            existing = null;
+        }
+        if (existing === desired) {
+            rulesResult.changes.push({
+                path: mdcPath,
+                kind: 'noop',
+                summary: `${MDC_FILE}: already up to date`,
+            });
+            return rulesResult;
+        }
+        const isOurs = existing === null ||
+            /^openlore-fingerprint:/m.test(existing);
+        if (existing !== null && !isOurs && !ctx.force) {
+            rulesResult.changes.push({
+                path: mdcPath,
+                kind: 'noop',
+                summary: `${MDC_FILE}: refused to overwrite non-OpenLore file (use --force)`,
+            });
+            rulesResult.warnings.push(`${MDC_FILE} exists but was not written by OpenLore`);
+            rulesResult.conflict = true;
+            return rulesResult;
+        }
+        const change = {
+            path: mdcPath,
+            kind: existing === null ? 'create' : 'update',
+            summary: existing === null ? `create ${MDC_FILE}` : `update ${MDC_FILE}`,
+            preview: existing === null
+                ? previewCreate(mdcPath, desired)
+                : previewDiff(mdcPath, existing, desired),
+        };
+        if (!ctx.dryRun) {
+            await mkdir(dirname(mdcPath), { recursive: true });
+            await writeFile(mdcPath, desired, 'utf8');
+        }
+        rulesResult.changes.push(change);
+        // MCP server registration via .cursor/mcp.json (standard Cursor path).
+        const mcpPath = join(ctx.root, MCP_FILE);
+        let mcpExisting = {};
+        let mcpHad = true;
+        try {
+            const parsed = JSON.parse(await readFile(mcpPath, 'utf8'));
+            mcpExisting =
+                parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+                    ? parsed
+                    : {};
+        }
+        catch {
+            mcpHad = false;
+        }
+        const mcpMeta = readMeta(mcpExisting);
+        if (mcpMeta && isHandEdited(mcpExisting, mcpMeta) && !ctx.force) {
+            rulesResult.changes.push({
+                path: mcpPath,
+                kind: 'noop',
+                summary: `${MCP_FILE}: refused to overwrite hand-edited OpenLore entries (use --force)`,
+            });
+            rulesResult.warnings.push(`${MCP_FILE} has hand-edits in OpenLore-managed paths — pass --force to overwrite`);
+            rulesResult.conflict = true;
+            return rulesResult;
+        }
+        const { next: nextMcp, action: mcpAction } = mergeEntries(mcpExisting, [
+            { path: 'mcpServers.openlore', value: MCP_ENTRY },
+        ]);
+        const beforeMcp = mcpHad ? JSON.stringify(mcpExisting, null, 2) + '\n' : '';
+        const afterMcp = JSON.stringify(nextMcp, null, 2) + '\n';
+        rulesResult.changes.push({
+            path: mcpPath,
+            kind: !mcpHad ? 'create' : mcpAction === 'noop' ? 'noop' : 'update',
+            summary: !mcpHad
+                ? `create ${MCP_FILE} with mcpServers.openlore`
+                : mcpAction === 'noop'
+                    ? `${MCP_FILE}: already up to date`
+                    : `update mcpServers.openlore in ${MCP_FILE}`,
+            preview: !mcpHad
+                ? previewCreate(mcpPath, afterMcp)
+                : mcpAction === 'noop'
+                    ? undefined
+                    : previewDiff(mcpPath, beforeMcp, afterMcp),
+        });
+        if (!ctx.dryRun && (mcpAction !== 'noop' || !mcpHad)) {
+            await mkdir(dirname(mcpPath), { recursive: true });
+            await writeFile(mcpPath, JSON.stringify(nextMcp, null, 2) + '\n', 'utf8');
+        }
+        return rulesResult;
+    },
+    async uninstall(ctx) {
+        const rules = await uninstallMarkdownBlock(ctx, RULES_FILE, true);
+        const mdcPath = join(ctx.root, MDC_FILE);
+        try {
+            const raw = await readFile(mdcPath, 'utf8');
+            if (/^openlore-fingerprint:/m.test(raw)) {
+                if (!ctx.dryRun)
+                    await unlink(mdcPath);
+                rules.changes.push({
+                    path: mdcPath,
+                    kind: 'delete',
+                    summary: `remove ${MDC_FILE}`,
+                });
+            }
+        }
+        catch {
+            /* not present, nothing to do */
+        }
+        // Strip our MCP entry from .cursor/mcp.json.
+        const mcpPath = join(ctx.root, MCP_FILE);
+        try {
+            const parsed = JSON.parse(await readFile(mcpPath, 'utf8'));
+            const { next, removed } = removeManaged(parsed);
+            if (removed) {
+                const isEmpty = Object.keys(next).length === 0;
+                if (isEmpty) {
+                    if (!ctx.dryRun)
+                        await unlink(mcpPath);
+                    rules.changes.push({
+                        path: mcpPath,
+                        kind: 'delete',
+                        summary: `remove ${MCP_FILE} (was OpenLore-only)`,
+                    });
+                }
+                else {
+                    if (!ctx.dryRun)
+                        await writeFile(mcpPath, JSON.stringify(next, null, 2) + '\n', 'utf8');
+                    rules.changes.push({
+                        path: mcpPath,
+                        kind: 'update',
+                        summary: `strip OpenLore entries from ${MCP_FILE}`,
+                    });
+                }
+            }
+        }
+        catch {
+            /* not present, nothing to do */
+        }
+        return rules;
+    },
+};
+//# sourceMappingURL=cursor.js.map

package/dist/cli/install/adapters/cursor.js.map

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

package/dist/cli/install/adapters/markdown-block.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared helper for adapters that append/update a managed markdown block in
+ * a single file at the project root (CLAUDE.md, AGENTS.md, .cursorrules,
+ * .clinerules). Centralises the read/upsert/write logic so each adapter is
+ * just a one-liner.
+ */
+import type { ApplyContext, ApplyResult } from './types.js';
+export interface MarkdownBlockOptions {
+    /** File name, relative to ctx.root. */
+    fileName: string;
+    /** Whether the file should be created if it doesn't yet exist. */
+    createIfMissing: boolean;
+    /** Optional adapter-specific prefix added above the template (e.g. heading). */
+    blockBody: string;
+}
+export declare function applyMarkdownBlock(ctx: ApplyContext, opts: MarkdownBlockOptions): Promise<ApplyResult>;
+export declare function uninstallMarkdownBlock(ctx: ApplyContext, fileName: string, 
+/** If true, delete the file when removing the block empties it. */
+deleteIfBlockOnly: boolean): Promise<ApplyResult>;
+//# sourceMappingURL=markdown-block.d.ts.map

package/dist/cli/install/adapters/markdown-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-block.d.ts","sourceRoot":"","sources":["../../../../src/cli/install/adapters/markdown-block.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,eAAe,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,WAAW,CAAC,CAqEtB;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,MAAM;AAChB,mEAAmE;AACnE,iBAAiB,EAAE,OAAO,GACzB,OAAO,CAAC,WAAW,CAAC,CAkCtB"}