openlore 2.0.1 → 2.0.3

package/dist/cli/install/adapters/markdown-block.js

@@ -0,0 +1,114 @@
+/**
+ * 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 { readFile, writeFile, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { upsertBlock, extractBlock, isHandEdited, removeBlock, renderBlock, } from '../block.js';
+import { previewCreate, previewDiff } from '../diff.js';
+export async function applyMarkdownBlock(ctx, opts) {
+    const filePath = join(ctx.root, opts.fileName);
+    const warnings = [];
+    let existing = null;
+    try {
+        existing = await readFile(filePath, 'utf8');
+    }
+    catch {
+        existing = null;
+    }
+    if (existing === null && !opts.createIfMissing) {
+        return { changes: [], warnings, conflict: false };
+    }
+    const base = existing ?? '';
+    const block = existing ? extractBlock(existing) : null;
+    const handEdited = block ? isHandEdited(block) : false;
+    if (handEdited && !ctx.force) {
+        return {
+            changes: [
+                {
+                    path: filePath,
+                    kind: 'noop',
+                    summary: `${opts.fileName}: refused to overwrite hand-edited OpenLore block (use --force)`,
+                },
+            ],
+            warnings: [`${opts.fileName} has hand-edits inside the OpenLore block — pass --force to overwrite`],
+            conflict: true,
+        };
+    }
+    let next;
+    let action;
+    if (handEdited && ctx.force && block) {
+        // Force-overwrite a tampered block regardless of fingerprint match.
+        const rendered = renderBlock(opts.blockBody);
+        next = base.slice(0, block.beginIndex) + rendered + base.slice(block.endIndex);
+        action = 'updated';
+    }
+    else {
+        ({ next, action } = upsertBlock(base, opts.blockBody));
+    }
+    const change = {
+        path: filePath,
+        kind: existing === null
+            ? 'create'
+            : action === 'noop'
+                ? 'noop'
+                : 'update',
+        summary: existing === null
+            ? `create ${opts.fileName} with OpenLore block`
+            : action === 'noop'
+                ? `${opts.fileName}: already up to date`
+                : `update OpenLore block in ${opts.fileName}`,
+        preview: existing === null
+            ? previewCreate(filePath, next)
+            : action === 'noop'
+                ? undefined
+                : previewDiff(filePath, base, next),
+    };
+    if (!ctx.dryRun && action !== 'noop') {
+        await writeFile(filePath, next, 'utf8');
+    }
+    return { changes: [change], warnings, conflict: false };
+}
+export async function uninstallMarkdownBlock(ctx, fileName, 
+/** If true, delete the file when removing the block empties it. */
+deleteIfBlockOnly) {
+    const filePath = join(ctx.root, fileName);
+    let existing;
+    try {
+        existing = await readFile(filePath, 'utf8');
+    }
+    catch {
+        return { changes: [], warnings: [], conflict: false };
+    }
+    const removed = removeBlock(existing);
+    if (removed === null)
+        return { changes: [], warnings: [], conflict: false };
+    // Trim whitespace-only artifacts to decide if the file is now "empty".
+    const stripped = removed.trim();
+    if (stripped.length === 0 && deleteIfBlockOnly) {
+        if (!ctx.dryRun)
+            await unlink(filePath);
+        return {
+            changes: [{ path: filePath, kind: 'delete', summary: `remove ${fileName} (was OpenLore-only)` }],
+            warnings: [],
+            conflict: false,
+        };
+    }
+    if (!ctx.dryRun)
+        await writeFile(filePath, removed, 'utf8');
+    return {
+        changes: [
+            {
+                path: filePath,
+                kind: 'update',
+                summary: `strip OpenLore block from ${fileName}`,
+                preview: previewDiff(filePath, existing, removed),
+            },
+        ],
+        warnings: [],
+        conflict: false,
+    };
+}
+//# sourceMappingURL=markdown-block.js.map

package/dist/cli/install/adapters/markdown-block.js.map

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

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

@@ -0,0 +1,39 @@
+/**
+ * Shared types for OpenLore install adapters.
+ *
+ * An adapter knows how to plan, apply, and uninstall OpenLore's footprint on
+ * one specific agent surface. Adapters never write to disk directly when
+ * `dryRun` is true; instead they return a list of `PlannedChange` entries that
+ * the caller renders.
+ */
+import type { AgentName } from '../detect.js';
+export interface PlannedChange {
+    /** Absolute path the change applies to. */
+    path: string;
+    /** What we'd do to that file. */
+    kind: 'create' | 'update' | 'noop' | 'delete';
+    /** Short human-readable summary (one line). */
+    summary: string;
+    /** Optional unified-diff-ish preview for `--dry-run`. */
+    preview?: string;
+}
+export interface ApplyContext {
+    root: string;
+    /** Template content for the markdown instruction block. */
+    instructionTemplate: string;
+    dryRun: boolean;
+    force: boolean;
+}
+export interface ApplyResult {
+    changes: PlannedChange[];
+    /** Warnings to surface to the user (e.g. hand-edited block, unsure-of-path TODO). */
+    warnings: string[];
+    /** If true, install should exit non-zero (hand-edit conflict without --force). */
+    conflict: boolean;
+}
+export interface Adapter {
+    name: AgentName;
+    apply(ctx: ApplyContext): Promise<ApplyResult>;
+    uninstall(ctx: ApplyContext): Promise<ApplyResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/install/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC9C,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACpD"}

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

@@ -0,0 +1,10 @@
+/**
+ * Shared types for OpenLore install adapters.
+ *
+ * An adapter knows how to plan, apply, and uninstall OpenLore's footprint on
+ * one specific agent surface. Adapters never write to disk directly when
+ * `dryRun` is true; instead they return a list of `PlannedChange` entries that
+ * the caller renders.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cli/install/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/cli/install/block.d.ts

@@ -0,0 +1,53 @@
+/**
+ * OpenLore managed-block utilities.
+ *
+ * A "managed block" is a region inside an existing text file (typically Markdown)
+ * delimited by canonical comments. Re-running `openlore install` rewrites the
+ * block in place. A SHA-256 fingerprint over the canonical content lets us
+ * detect hand-edits and refuse to clobber them unless `--force` is passed.
+ */
+export declare const BLOCK_BEGIN = "<!-- BEGIN OPENLORE (managed \u2014 edits inside this block will be overwritten) -->";
+export declare const BLOCK_END = "<!-- END OPENLORE -->";
+export interface ExtractedBlock {
+    /** Index of the BEGIN marker in the source file. */
+    beginIndex: number;
+    /** Index just past the END marker. */
+    endIndex: number;
+    /** The raw text between BEGIN and END markers (excluding markers themselves). */
+    inner: string;
+    /** The fingerprint we previously wrote, if present. */
+    fingerprint: string | null;
+}
+export declare function fingerprint(content: string): string;
+/** Build the full managed block (markers + fingerprint comment + content). */
+export declare function renderBlock(content: string): string;
+export declare function extractBlock(source: string): ExtractedBlock | null;
+/**
+ * Compute the fingerprint of the *current* inner content as it would be if we
+ * had written `expectedContent`. Used to decide whether the block on disk
+ * still matches what we last wrote.
+ */
+export declare function blockMatchesExpected(block: ExtractedBlock, expectedContent: string): boolean;
+export interface UpsertResult {
+    /** The file contents to write back. */
+    next: string;
+    /** What happened: 'created' (file/block was new), 'updated' (re-rendered), 'noop' (already matched). */
+    action: 'created' | 'updated' | 'noop';
+}
+/**
+ * Upsert the managed block in `existing`. If a block exists, replace it; otherwise
+ * append. If the existing block's fingerprint matches the new content, do nothing.
+ *
+ * Caller is responsible for the `--force` / hand-edit check (use `isHandEdited`).
+ */
+export declare function upsertBlock(existing: string, content: string): UpsertResult;
+/**
+ * True iff a block exists on disk and its inner contents no longer hash to its
+ * fingerprint (i.e. someone edited inside the markers).
+ */
+export declare function isHandEdited(block: ExtractedBlock): boolean;
+/**
+ * Remove the managed block from `existing`. Returns null if no block was present.
+ */
+export declare function removeBlock(existing: string): string | null;
+//# sourceMappingURL=block.d.ts.map

package/dist/cli/install/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../src/cli/install/block.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,WAAW,yFAC2D,CAAC;AACpF,eAAO,MAAM,SAAS,0BAA0B,CAAC;AAKjD,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAgBlE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAG5F;AAED,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,wGAAwG;IACxG,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAiB3E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAO3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS3D"}

package/dist/cli/install/block.js

@@ -0,0 +1,106 @@
+/**
+ * OpenLore managed-block utilities.
+ *
+ * A "managed block" is a region inside an existing text file (typically Markdown)
+ * delimited by canonical comments. Re-running `openlore install` rewrites the
+ * block in place. A SHA-256 fingerprint over the canonical content lets us
+ * detect hand-edits and refuse to clobber them unless `--force` is passed.
+ */
+import { createHash } from 'node:crypto';
+export const BLOCK_BEGIN = '<!-- BEGIN OPENLORE (managed — edits inside this block will be overwritten) -->';
+export const BLOCK_END = '<!-- END OPENLORE -->';
+const FINGERPRINT_PREFIX = '<!-- openlore-fingerprint: ';
+const FINGERPRINT_SUFFIX = ' -->';
+export function fingerprint(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex').slice(0, 16);
+}
+/** Build the full managed block (markers + fingerprint comment + content). */
+export function renderBlock(content) {
+    const trimmed = content.trimEnd();
+    const fp = fingerprint(trimmed);
+    return [
+        BLOCK_BEGIN,
+        `${FINGERPRINT_PREFIX}${fp}${FINGERPRINT_SUFFIX}`,
+        trimmed,
+        BLOCK_END,
+    ].join('\n');
+}
+export function extractBlock(source) {
+    const beginIndex = source.indexOf(BLOCK_BEGIN);
+    if (beginIndex === -1)
+        return null;
+    const endMarkerIndex = source.indexOf(BLOCK_END, beginIndex + BLOCK_BEGIN.length);
+    if (endMarkerIndex === -1)
+        return null;
+    const endIndex = endMarkerIndex + BLOCK_END.length;
+    const inner = source.slice(beginIndex + BLOCK_BEGIN.length, endMarkerIndex);
+    const fpMatch = inner.match(/<!-- openlore-fingerprint: ([0-9a-f]+) -->/);
+    return {
+        beginIndex,
+        endIndex,
+        inner,
+        fingerprint: fpMatch ? fpMatch[1] : null,
+    };
+}
+/**
+ * Compute the fingerprint of the *current* inner content as it would be if we
+ * had written `expectedContent`. Used to decide whether the block on disk
+ * still matches what we last wrote.
+ */
+export function blockMatchesExpected(block, expectedContent) {
+    if (!block.fingerprint)
+        return false;
+    return block.fingerprint === fingerprint(expectedContent.trimEnd());
+}
+/**
+ * Upsert the managed block in `existing`. If a block exists, replace it; otherwise
+ * append. If the existing block's fingerprint matches the new content, do nothing.
+ *
+ * Caller is responsible for the `--force` / hand-edit check (use `isHandEdited`).
+ */
+export function upsertBlock(existing, content) {
+    const rendered = renderBlock(content);
+    const block = extractBlock(existing);
+    if (!block) {
+        const sep = existing.length === 0 || existing.endsWith('\n') ? '' : '\n';
+        const leading = existing.length === 0 ? '' : '\n';
+        return { next: `${existing}${sep}${leading}${rendered}\n`, action: 'created' };
+    }
+    if (blockMatchesExpected(block, content)) {
+        return { next: existing, action: 'noop' };
+    }
+    const before = existing.slice(0, block.beginIndex);
+    const after = existing.slice(block.endIndex);
+    return { next: `${before}${rendered}${after}`, action: 'updated' };
+}
+/**
+ * True iff a block exists on disk and its inner contents no longer hash to its
+ * fingerprint (i.e. someone edited inside the markers).
+ */
+export function isHandEdited(block) {
+    if (!block.fingerprint)
+        return false;
+    const innerWithoutFingerprintLine = block.inner
+        .replace(/<!-- openlore-fingerprint: [0-9a-f]+ -->\n?/, '')
+        .replace(/^\n+/, '')
+        .trimEnd();
+    return fingerprint(innerWithoutFingerprintLine) !== block.fingerprint;
+}
+/**
+ * Remove the managed block from `existing`. Returns null if no block was present.
+ */
+export function removeBlock(existing) {
+    const block = extractBlock(existing);
+    if (!block)
+        return null;
+    const before = existing.slice(0, block.beginIndex).replace(/\n+$/, '');
+    const after = existing.slice(block.endIndex).replace(/^\n+/, '');
+    if (before.length === 0 && after.length === 0)
+        return '';
+    if (before.length === 0)
+        return after.endsWith('\n') ? after : after + '\n';
+    if (after.length === 0)
+        return before + '\n';
+    return `${before}\n\n${after}`;
+}
+//# sourceMappingURL=block.js.map

package/dist/cli/install/block.js.map

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

package/dist/cli/install/detect.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Detect which agent surfaces are present in a project tree.
+ *
+ * We walk up from `cwd` checking up to 3 parent directories for marker files.
+ * The first directory that has any marker becomes the "project root" for that
+ * surface. `agents-md` is the universal fallback and is always included.
+ */
+export type AgentName = 'claude-code' | 'cursor' | 'cline' | 'continue' | 'agents-md';
+export declare const ALL_AGENTS: AgentName[];
+export interface DetectedSurface {
+    agent: AgentName;
+    /** Absolute path to the directory we will treat as the project root. */
+    root: string;
+    /** Which marker(s) triggered detection (for the dry-run summary). */
+    markers: string[];
+}
+/**
+ * Detect surfaces by walking up from `startDir` up to PARENTS_TO_CHECK levels.
+ * Each surface is reported at most once, anchored at the deepest dir where its
+ * marker was found. `agents-md` is always appended last as a universal fallback.
+ */
+export declare function detect(startDir: string): Promise<DetectedSurface[]>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/cli/install/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/cli/install/detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAEtF,eAAO,MAAM,UAAU,EAAE,SAAS,EAMjC,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAqED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAkBzE"}

package/dist/cli/install/detect.js

@@ -0,0 +1,115 @@
+/**
+ * Detect which agent surfaces are present in a project tree.
+ *
+ * We walk up from `cwd` checking up to 3 parent directories for marker files.
+ * The first directory that has any marker becomes the "project root" for that
+ * surface. `agents-md` is the universal fallback and is always included.
+ */
+import { access, stat, readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+export const ALL_AGENTS = [
+    'claude-code',
+    'cursor',
+    'cline',
+    'continue',
+    'agents-md',
+];
+const PARENTS_TO_CHECK = 3;
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function isDir(p) {
+    try {
+        return (await stat(p)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function hasClineSettings(p) {
+    const settings = join(p, '.vscode', 'settings.json');
+    if (!(await exists(settings)))
+        return false;
+    try {
+        const raw = await readFile(settings, 'utf8');
+        return /"cline\./.test(raw);
+    }
+    catch {
+        return false;
+    }
+}
+async function detectInDir(dir) {
+    const found = [];
+    // claude-code
+    {
+        const markers = [];
+        if (await isDir(join(dir, '.claude')))
+            markers.push('.claude/');
+        if (await exists(join(dir, 'CLAUDE.md')))
+            markers.push('CLAUDE.md');
+        if (markers.length)
+            found.push({ agent: 'claude-code', root: dir, markers });
+    }
+    // cursor
+    {
+        const markers = [];
+        if (await isDir(join(dir, '.cursor')))
+            markers.push('.cursor/');
+        if (await exists(join(dir, '.cursorrules')))
+            markers.push('.cursorrules');
+        if (markers.length)
+            found.push({ agent: 'cursor', root: dir, markers });
+    }
+    // cline
+    {
+        const markers = [];
+        if (await exists(join(dir, '.clinerules')))
+            markers.push('.clinerules');
+        if (await hasClineSettings(dir))
+            markers.push('.vscode/settings.json (cline.*)');
+        if (markers.length)
+            found.push({ agent: 'cline', root: dir, markers });
+    }
+    // continue
+    {
+        const markers = [];
+        if (await isDir(join(dir, '.continue')))
+            markers.push('.continue/');
+        if (markers.length)
+            found.push({ agent: 'continue', root: dir, markers });
+    }
+    return found;
+}
+/**
+ * Detect surfaces by walking up from `startDir` up to PARENTS_TO_CHECK levels.
+ * Each surface is reported at most once, anchored at the deepest dir where its
+ * marker was found. `agents-md` is always appended last as a universal fallback.
+ */
+export async function detect(startDir) {
+    const seen = new Set();
+    const out = [];
+    let dir = resolve(startDir);
+    for (let i = 0; i <= PARENTS_TO_CHECK; i++) {
+        for (const s of await detectInDir(dir)) {
+            if (seen.has(s.agent))
+                continue;
+            seen.add(s.agent);
+            out.push(s);
+        }
+        const parent = resolve(dir, '..');
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Universal fallback — anchored at the first detected root, or cwd.
+    const fallbackRoot = out[0]?.root ?? resolve(startDir);
+    out.push({ agent: 'agents-md', root: fallbackRoot, markers: ['(fallback)'] });
+    return out;
+}
+//# sourceMappingURL=detect.js.map

package/dist/cli/install/detect.js.map

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

package/dist/cli/install/diff.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tiny line-oriented diff helper used to populate `--dry-run` previews.
+ *
+ * This is not a full Myers diff — it's the cheapest output that still lets a
+ * user see what `openlore install --dry-run` would do without us shelling out
+ * to `diff(1)`. Lines that match are skipped (with a `...` separator if there
+ * are unchanged runs between hunks); changed lines are prefixed with `+` /
+ * `-`. The result is meant for human eyeballing, not machine consumption.
+ */
+export declare function previewCreate(filePath: string, content: string): string;
+export declare function previewDiff(filePath: string, before: string, after: string): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/cli/install/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/cli/install/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAiCnF"}

package/dist/cli/install/diff.js

@@ -0,0 +1,51 @@
+/**
+ * Tiny line-oriented diff helper used to populate `--dry-run` previews.
+ *
+ * This is not a full Myers diff — it's the cheapest output that still lets a
+ * user see what `openlore install --dry-run` would do without us shelling out
+ * to `diff(1)`. Lines that match are skipped (with a `...` separator if there
+ * are unchanged runs between hunks); changed lines are prefixed with `+` /
+ * `-`. The result is meant for human eyeballing, not machine consumption.
+ */
+const MAX_PREVIEW_LINES = 60;
+export function previewCreate(filePath, content) {
+    const lines = content.split('\n');
+    const truncated = lines.length > MAX_PREVIEW_LINES;
+    const shown = truncated ? lines.slice(0, MAX_PREVIEW_LINES) : lines;
+    const body = shown.map((l) => `+ ${l}`).join('\n');
+    const suffix = truncated ? `\n  ... (${lines.length - MAX_PREVIEW_LINES} more lines)` : '';
+    return `--- (new file) ${filePath}\n${body}${suffix}`;
+}
+export function previewDiff(filePath, before, after) {
+    const a = before.split('\n');
+    const b = after.split('\n');
+    // Trim common prefix and suffix so we focus on the changed region.
+    let prefix = 0;
+    while (prefix < a.length && prefix < b.length && a[prefix] === b[prefix])
+        prefix++;
+    let suffix = 0;
+    while (suffix < a.length - prefix &&
+        suffix < b.length - prefix &&
+        a[a.length - 1 - suffix] === b[b.length - 1 - suffix])
+        suffix++;
+    const removed = a.slice(prefix, a.length - suffix);
+    const added = b.slice(prefix, b.length - suffix);
+    const truncatedRemoved = removed.length > MAX_PREVIEW_LINES;
+    const truncatedAdded = added.length > MAX_PREVIEW_LINES;
+    const shownRemoved = truncatedRemoved ? removed.slice(0, MAX_PREVIEW_LINES) : removed;
+    const shownAdded = truncatedAdded ? added.slice(0, MAX_PREVIEW_LINES) : added;
+    const header = `--- ${filePath} @ line ${prefix + 1}`;
+    const minus = shownRemoved.map((l) => `- ${l}`).join('\n');
+    const plus = shownAdded.map((l) => `+ ${l}`).join('\n');
+    const parts = [header];
+    if (minus)
+        parts.push(minus);
+    if (truncatedRemoved)
+        parts.push(`  ... (${removed.length - MAX_PREVIEW_LINES} more removed lines)`);
+    if (plus)
+        parts.push(plus);
+    if (truncatedAdded)
+        parts.push(`  ... (${added.length - MAX_PREVIEW_LINES} more added lines)`);
+    return parts.join('\n');
+}
+//# sourceMappingURL=diff.js.map

package/dist/cli/install/diff.js.map

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

package/dist/cli/install/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `openlore install` — auto-configure popular agent surfaces so they call
+ * `orient()` automatically.
+ *
+ * Dispatches to one or more adapters depending on `--agent` / detection,
+ * supports `--dry-run`, `--force`, and `--uninstall`.
+ */
+import { Command } from 'commander';
+import { type AgentName } from './detect.js';
+export interface InstallOptions {
+    agent?: AgentName;
+    dryRun?: boolean;
+    force?: boolean;
+    uninstall?: boolean;
+    cwd?: string;
+}
+export declare function runInstall(opts: InstallOptions): Promise<number>;
+export declare const installCommand: Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/install/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/install/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAsB,KAAK,SAAS,EAAwB,MAAM,aAAa,CAAC;AAqCvF,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDtE;AAsCD,eAAO,MAAM,cAAc,SASvB,CAAC"}