openlore 2.0.1 → 2.0.2

package/README.md

@@ -65,9 +65,12 @@ npm install -g openlore
 cd /path/to/your-project
 
 openlore analyze          # build call graph, clusters, CODEBASE.md
+openlore install          # auto-configure your agent (Claude Code, Cursor, …)
 openlore mcp              # start MCP server
 ```
 
+`openlore install` auto-detects which agent surfaces are present (Claude Code, Cursor, Cline, Continue, AGENTS.md) and wires each one to call `orient()` automatically — no manual `CLAUDE.md` editing needed. See [docs/install.md](docs/install.md).
+
 Then ask your agent: **`orient("add a new payment method")`**
 
 That single call returns the relevant functions, their call neighbours, matching spec sections, and insertion-point candidates — preserving architectural continuity across sessions instead of forcing the agent to repeatedly reconstruct context from raw file reads. In practice, this often reduces orientation cost from ~30,000 exploratory tokens to ~1,000 targeted tokens.
@@ -146,6 +149,22 @@ One graph query replaces most exploratory file reads. The agent knows exactly wh
 
 ---
 
+## Use OpenLore as a Claude Code Skill
+
+OpenLore ships a canonical [Claude Code Skill](https://docs.claude.com/en/docs/claude-code/skills) at [`skills/openlore-orient/`](skills/openlore-orient/). Install it once and Claude Code will automatically call `orient()` at the start of every task — no `CLAUDE.md` editing required.
+
+```sh
+# From the OpenLore repo root:
+npm run skill:install-local           # → ~/.claude/skills/openlore-orient/
+
+# Or copy into a single project's .claude/skills/:
+cp -R skills/openlore-orient /path/to/your-project/.claude/skills/
+```
+
+The skill bundle ships a `SKILL.md` manifest, POSIX + PowerShell wrappers, a worked example, and a redacted real `orient()` JSON output so the model knows the response shape. See [`skills/openlore-orient/README.md`](skills/openlore-orient/README.md) for details.
+
+---
+
 ## Core Features
 
 **Analyze** (no API key)
@@ -162,6 +181,14 @@ Sends the analysis to an LLM in 6 structured stages: project survey → entity e
 
 Compares git changes against spec mappings in milliseconds. Detects: Gap (code changed, spec not updated), Uncovered (new file, no spec), Stale (spec references deleted files), ADR gap (code changed in an ADR-referenced domain). Installs as a pre-commit hook.
 
+**Install** (no API key)
+
+`openlore install` auto-wires the popular agent surfaces (Claude Code, Cursor, Cline, Continue, AGENTS.md) so they call `orient()` automatically — no `CLAUDE.md` editing required. Each integration uses a fingerprinted managed block so re-runs are idempotent and hand-edits are detected. `--dry-run` previews diffs; `--uninstall` cleanly removes everything. See [docs/install.md](docs/install.md).
+
+**Preflight** (no API key)
+
+`openlore preflight` is a CI staleness gate: any pull request that edits files in the graph fails the check until the graph is refreshed. Drop-in templates for GitHub Actions, GitLab CI, and generic shell live in [`examples/ci/`](examples/ci/). Weighted scoring surfaces hubs first so a one-line leaf edit doesn't fail the same way a refactor of a top-of-stack module does. See [docs/preflight.md](docs/preflight.md).
+
 **MCP** (no API key)
 
 45 graph-native tools exposed over stdio. Together they act as a persistent architectural runtime for coding agents: orientation, graph traversal, semantic retrieval, drift awareness, decision context, and structural risk analysis.
@@ -251,10 +278,12 @@ The graph and the OpenSpec spec layer are co-equal: the graph makes orientation
 |-------|-----|
 | MCP tools reference (45 tools + parameters) | [docs/mcp-tools.md](docs/mcp-tools.md) |
 | Agent setup (Claude Code, Cline, OpenCode, Vibe…) | [docs/agent-setup.md](docs/agent-setup.md) |
+| `openlore install` — auto-configure agent surfaces | [docs/install.md](docs/install.md) |
 | LLM providers + embedding config | [docs/providers.md](docs/providers.md) |
 | Drift detection in depth | [docs/drift-detection.md](docs/drift-detection.md) |
 | Spec-driven tests + spec digest | [docs/spec-tests.md](docs/spec-tests.md) |
 | CI/CD integration | [docs/ci-cd.md](docs/ci-cd.md) |
+| Preflight CI staleness gate | [docs/preflight.md](docs/preflight.md) |
 | CLI command reference | [docs/cli-reference.md](docs/cli-reference.md) |
 | Interactive graph viewer | [docs/viewer.md](docs/viewer.md) |
 | Analysis output files | [docs/output.md](docs/output.md) |

package/dist/cli/index.js

@@ -23,6 +23,8 @@ import { testCommand } from './commands/test.js';
 import { digestCommand } from './commands/digest.js';
 import { decisionsCommand } from './commands/decisions.js';
 import { telemetryCommand } from './commands/telemetry.js';
+import { installCommand } from './install/index.js';
+import { preflightCommand } from './preflight/index.js';
 import { configureLogger } from '../utils/logger.js';
 // Read version from package.json at runtime so it never drifts from the published version
 const require = createRequire(import.meta.url);
@@ -63,15 +65,17 @@ program
     .addHelpText('after', `
 Workflow:
   1. openlore init                    Detect project type, create config
-  2. openlore analyze                 Scan codebase, build dependency graph
-  3. openlore analyze --ai-configs    Generate context files (CLAUDE.md, .cursorrules…)
-  4. openlore setup                   Install workflow skills (Vibe, Cline, GSD)
-  5. openlore view                    Review visually the dependency graph
-  6. openlore generate                Create OpenSpec files using LLM
-  7. openlore verify                  Validate specs against source code
-  8. openlore drift                   Detect when code outpaces specs
-  9. openlore test                    Generate spec-driven tests or check coverage
-  10. openlore digest                  Plain-English summary of specs for human review
+  2. openlore install                 Auto-configure agent surfaces to call orient()
+  3. openlore analyze                 Scan codebase, build dependency graph
+  4. openlore analyze --ai-configs    Generate context files (CLAUDE.md, .cursorrules…)
+  5. openlore setup                   Install workflow skills (Vibe, Cline, GSD)
+  6. openlore view                    Review visually the dependency graph
+  7. openlore generate                Create OpenSpec files using LLM
+  8. openlore verify                  Validate specs against source code
+  9. openlore drift                   Detect when code outpaces specs
+  10. openlore test                    Generate spec-driven tests or check coverage
+  11. openlore digest                  Plain-English summary of specs for human review
+  12. openlore preflight               CI staleness gate: fail PRs when the graph is out of date
 
 Quick start:
   $ cd your-project
@@ -116,5 +120,7 @@ program.addCommand(testCommand);
 program.addCommand(digestCommand);
 program.addCommand(decisionsCommand);
 program.addCommand(telemetryCommand);
+program.addCommand(installCommand);
+program.addCommand(preflightCommand);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/install/adapters/agents-md.d.ts

@@ -0,0 +1,8 @@
+/**
+ * agents-md adapter — universal fallback that writes an AGENTS.md file at
+ * the project root. This is the convention OpenAI Codex (and an increasing
+ * number of other tools) read, so it's the safest "always do this" target.
+ */
+import type { Adapter } from './types.js';
+export declare const agentsMdAdapter: Adapter;
+//# sourceMappingURL=agents-md.d.ts.map

package/dist/cli/install/adapters/agents-md.d.ts.map

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

package/dist/cli/install/adapters/agents-md.js

@@ -0,0 +1,21 @@
+/**
+ * agents-md adapter — universal fallback that writes an AGENTS.md file at
+ * the project root. This is the convention OpenAI Codex (and an increasing
+ * number of other tools) read, so it's the safest "always do this" target.
+ */
+import { applyMarkdownBlock, uninstallMarkdownBlock } from './markdown-block.js';
+const FILE_NAME = 'AGENTS.md';
+export const agentsMdAdapter = {
+    name: 'agents-md',
+    async apply(ctx) {
+        return applyMarkdownBlock(ctx, {
+            fileName: FILE_NAME,
+            createIfMissing: true,
+            blockBody: ctx.instructionTemplate,
+        });
+    },
+    async uninstall(ctx) {
+        return uninstallMarkdownBlock(ctx, FILE_NAME, true);
+    },
+};
+//# sourceMappingURL=agents-md.js.map

package/dist/cli/install/adapters/agents-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../../../../src/cli/install/adapters/agents-md.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGjF,MAAM,SAAS,GAAG,WAAW,CAAC;AAE9B,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,IAAI,EAAE,WAAW;IACjB,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/claude-code.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 type { Adapter } from './types.js';
+export declare const claudeCodeAdapter: Adapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/cli/install/adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../../src/cli/install/adapters/claude-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,OAAO,EAA4C,MAAM,YAAY,CAAC;AAiEpF,eAAO,MAAM,iBAAiB,EAAE,OAyH/B,CAAC"}

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"}