openlore 2.0.1 → 2.0.2

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

package/dist/cli/install/index.js

@@ -0,0 +1,133 @@
+/**
+ * `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 { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { Command } from 'commander';
+import { logger } from '../../utils/logger.js';
+import { detect, ALL_AGENTS } from './detect.js';
+import { agentsMdAdapter } from './adapters/agents-md.js';
+import { claudeCodeAdapter } from './adapters/claude-code.js';
+import { cursorAdapter } from './adapters/cursor.js';
+import { clineAdapter } from './adapters/cline.js';
+import { continueAdapter } from './adapters/continue.js';
+const ADAPTERS = {
+    'agents-md': agentsMdAdapter,
+    'claude-code': claudeCodeAdapter,
+    cursor: cursorAdapter,
+    cline: clineAdapter,
+    continue: continueAdapter,
+};
+async function loadTemplate() {
+    // Template lives next to this file in the source tree, but at runtime we
+    // resolve via the compiled dist path.
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(here, 'templates', 'agent-instructions.md'),
+        // tsx / source-run fallback
+        join(here, '..', '..', '..', 'src', 'cli', 'install', 'templates', 'agent-instructions.md'),
+    ];
+    for (const p of candidates) {
+        try {
+            return await readFile(p, 'utf8');
+        }
+        catch {
+            /* try next */
+        }
+    }
+    throw new Error('openlore install: could not locate agent-instructions.md template (looked in dist + src)');
+}
+export async function runInstall(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const template = await loadTemplate();
+    let surfaces;
+    if (opts.agent) {
+        if (!ALL_AGENTS.includes(opts.agent)) {
+            logger.error(`Unknown agent surface "${opts.agent}". Known: ${ALL_AGENTS.join(', ')}`);
+            return 2;
+        }
+        surfaces = [{ agent: opts.agent, root: cwd, markers: ['(explicit --agent)'] }];
+    }
+    else {
+        surfaces = await detect(cwd);
+    }
+    logger.discovery(`${opts.uninstall ? 'Uninstalling' : 'Installing'} for ${surfaces.length} surface(s): ${surfaces
+        .map((s) => s.agent)
+        .join(', ')}`);
+    let conflict = false;
+    const allChanges = [];
+    const allWarnings = [];
+    for (const surface of surfaces) {
+        const adapter = ADAPTERS[surface.agent];
+        const ctx = {
+            root: surface.root,
+            instructionTemplate: template,
+            dryRun: !!opts.dryRun,
+            force: !!opts.force,
+        };
+        const result = opts.uninstall
+            ? await adapter.uninstall(ctx)
+            : await adapter.apply(ctx);
+        if (result.conflict)
+            conflict = true;
+        allChanges.push(...result.changes);
+        allWarnings.push(...result.warnings);
+    }
+    printSummary(allChanges, allWarnings, !!opts.dryRun, !!opts.uninstall);
+    if (conflict) {
+        logger.error('Hand-edited OpenLore block(s) detected. Re-run with --force to overwrite, or revert your edits.');
+        return 1;
+    }
+    return 0;
+}
+function printSummary(changes, warnings, dryRun, uninstall) {
+    const verb = dryRun ? 'would' : 'did';
+    for (const c of changes) {
+        const tag = c.kind === 'create'
+            ? `[${verb} create]`
+            : c.kind === 'update'
+                ? `[${verb} update]`
+                : c.kind === 'delete'
+                    ? `[${verb} delete]`
+                    : '[noop]';
+        if (c.kind === 'noop')
+            logger.discovery(`${tag} ${c.summary}`);
+        else
+            logger.success(`${tag} ${c.summary}`);
+        if (dryRun && c.preview) {
+            const indented = c.preview
+                .split('\n')
+                .map((l) => '    ' + l)
+                .join('\n');
+            process.stderr.write(indented + '\n');
+        }
+    }
+    for (const w of warnings)
+        logger.warning(w);
+    if (dryRun) {
+        logger.discovery('Dry run — no files were written.');
+    }
+    else if (!uninstall) {
+        logger.success('OpenLore install complete.');
+    }
+    else {
+        logger.success('OpenLore uninstall complete.');
+    }
+}
+export const installCommand = new Command('install')
+    .description('Auto-configure agent surfaces to call orient() (Claude Code, Cursor, Cline, Continue, AGENTS.md).')
+    .option('--agent <name>', 'Install only for a specific surface (claude-code, cursor, cline, continue, agents-md)')
+    .option('--dry-run', 'Print the planned changes without writing any files', false)
+    .option('--force', 'Overwrite OpenLore-managed blocks even if hand-edited', false)
+    .option('--uninstall', 'Remove OpenLore-managed blocks and entries', false)
+    .action(async (opts) => {
+    const code = await runInstall(opts);
+    if (code !== 0)
+        process.exit(code);
+});
+//# sourceMappingURL=index.js.map

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

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

package/dist/cli/install/json-managed.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Safe merge of an OpenLore-managed entry into a JSON config file.
+ *
+ * We store our additions under a top-level `_openlore` key for bookkeeping
+ * (fingerprint of the merged subtree, version), while writing the actual
+ * config under whatever path the host tool reads (e.g. `mcpServers.openlore`,
+ * `hooks.SessionStart`). The fingerprint lets us detect hand-edits.
+ */
+export interface ManagedJsonMeta {
+    managed: true;
+    version: number;
+    fingerprint: string;
+    /**
+     * Dotted paths into the JSON document that OpenLore manages. Used by
+     * `--uninstall` to remove only what we added.
+     */
+    paths: string[];
+}
+export declare function canonicalJsonHash(value: unknown): string;
+export interface ManagedEntry {
+    /** Dotted path into the JSON document (e.g. "mcpServers.openlore"). */
+    path: string;
+    /** Value to write at that path. */
+    value: unknown;
+}
+export interface MergeResult {
+    next: Record<string, unknown>;
+    action: 'created' | 'updated' | 'noop';
+    /** If the existing meta fingerprint didn't match what was on disk. */
+    handEdited: boolean;
+}
+export declare function readMeta(doc: Record<string, unknown>): ManagedJsonMeta | null;
+/**
+ * Verify the meta fingerprint still matches the values we previously wrote.
+ * If not, the user has hand-edited one of our managed paths.
+ */
+export declare function isHandEdited(doc: Record<string, unknown>, meta: ManagedJsonMeta): boolean;
+export declare function mergeEntries(existing: Record<string, unknown>, entries: ManagedEntry[]): MergeResult;
+export declare function removeManaged(doc: Record<string, unknown>): {
+    next: Record<string, unknown>;
+    removed: boolean;
+};
+//# sourceMappingURL=json-managed.d.ts.map

package/dist/cli/install/json-managed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-managed.d.ts","sourceRoot":"","sources":["../../../src/cli/install/json-managed.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAExD;AAeD,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,GAAG,IAAI,CAW7E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAOzF;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,YAAY,EAAE,GACtB,WAAW,CA4Bb;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC3D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB,CAOA"}

package/dist/cli/install/json-managed.js

@@ -0,0 +1,137 @@
+/**
+ * Safe merge of an OpenLore-managed entry into a JSON config file.
+ *
+ * We store our additions under a top-level `_openlore` key for bookkeeping
+ * (fingerprint of the merged subtree, version), while writing the actual
+ * config under whatever path the host tool reads (e.g. `mcpServers.openlore`,
+ * `hooks.SessionStart`). The fingerprint lets us detect hand-edits.
+ */
+import { createHash } from 'node:crypto';
+const META_KEY = '_openlore';
+const META_VERSION = 1;
+export function canonicalJsonHash(value) {
+    return createHash('sha256').update(canonicalize(value), 'utf8').digest('hex').slice(0, 16);
+}
+function canonicalize(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return '[' + value.map(canonicalize).join(',') + ']';
+    const keys = Object.keys(value).sort();
+    return ('{' +
+        keys
+            .map((k) => JSON.stringify(k) + ':' + canonicalize(value[k]))
+            .join(',') +
+        '}');
+}
+export function readMeta(doc) {
+    const meta = doc[META_KEY];
+    if (!meta || typeof meta !== 'object')
+        return null;
+    const m = meta;
+    if (m.managed !== true || typeof m.fingerprint !== 'string')
+        return null;
+    return {
+        managed: true,
+        version: typeof m.version === 'number' ? m.version : 1,
+        fingerprint: m.fingerprint,
+        paths: Array.isArray(m.paths) ? m.paths.filter((p) => typeof p === 'string') : [],
+    };
+}
+/**
+ * Verify the meta fingerprint still matches the values we previously wrote.
+ * If not, the user has hand-edited one of our managed paths.
+ */
+export function isHandEdited(doc, meta) {
+    const subset = {};
+    for (const path of meta.paths) {
+        const value = getPath(doc, path);
+        if (value !== undefined)
+            setPath(subset, path, value);
+    }
+    return canonicalJsonHash(subset) !== meta.fingerprint;
+}
+export function mergeEntries(existing, entries) {
+    const next = structuredClone(existing);
+    const prevMeta = readMeta(next);
+    const handEdited = prevMeta ? isHandEdited(next, prevMeta) : false;
+    for (const e of entries)
+        setPath(next, e.path, e.value);
+    const subset = {};
+    for (const e of entries)
+        setPath(subset, e.path, e.value);
+    const newMeta = {
+        managed: true,
+        version: META_VERSION,
+        fingerprint: canonicalJsonHash(subset),
+        paths: entries.map((e) => e.path),
+    };
+    next[META_KEY] = newMeta;
+    // Did anything actually change vs `existing`?
+    const before = canonicalize(existing);
+    const after = canonicalize(next);
+    const action = prevMeta
+        ? before === after
+            ? 'noop'
+            : 'updated'
+        : 'created';
+    return { next, action, handEdited };
+}
+export function removeManaged(doc) {
+    const meta = readMeta(doc);
+    if (!meta)
+        return { next: doc, removed: false };
+    const next = structuredClone(doc);
+    for (const path of meta.paths)
+        deletePath(next, path);
+    delete next[META_KEY];
+    return { next, removed: true };
+}
+// ---------- path helpers ----------
+function getPath(obj, path) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (const p of parts) {
+        if (cur === null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+function setPath(obj, path, value) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const k = parts[i];
+        const next = cur[k];
+        if (next === null || typeof next !== 'object' || Array.isArray(next)) {
+            cur[k] = {};
+        }
+        cur = cur[k];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
+function deletePath(obj, path) {
+    const parts = path.split('.');
+    const chain = [];
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const k = parts[i];
+        const next = cur[k];
+        if (next === null || typeof next !== 'object' || Array.isArray(next))
+            return;
+        chain.push({ container: cur, key: k });
+        cur = next;
+    }
+    delete cur[parts[parts.length - 1]];
+    // Prune empty parent objects we walked through.
+    for (let i = chain.length - 1; i >= 0; i--) {
+        const { container, key } = chain[i];
+        const child = container[key];
+        if (Object.keys(child).length === 0)
+            delete container[key];
+        else
+            break;
+    }
+}
+//# sourceMappingURL=json-managed.js.map

package/dist/cli/install/json-managed.js.map

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

package/dist/cli/install/templates/agent-instructions.md

@@ -0,0 +1,12 @@
+This project uses OpenLore for persistent architectural memory.
+
+ALWAYS call `orient()` (via the openlore MCP server, or `npx openlore orient --json`)
+before reading source files when starting a new task. This returns the relevant
+functions, callers, spec sections, and insertion points for the task at hand and
+saves you 15,000–50,000 tokens of file-by-file rediscovery.
+
+Re-orient whenever the Epistemic Lease indicates staleness (you'll see a prefix
+on tool responses telling you to do so).
+
+For the MCP setup, ensure `openlore mcp` is configured as an MCP server.
+See https://github.com/clay-good/OpenLore for details.

package/dist/cli/install/templates/cursor-openlore.mdc

@@ -0,0 +1,7 @@
+---
+description: OpenLore orient() workflow
+alwaysApply: true
+openlore-fingerprint: {{fingerprint}}
+---
+
+{{instructions}}

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

@@ -0,0 +1,42 @@
+/**
+ * Compute the set of source files that have changed since the graph was built.
+ *
+ * Two paths:
+ *
+ *  1. `--since <git-ref>` (CI-friendly) — `git diff --name-only <ref>...HEAD`
+ *     plus uncommitted modifications. The merge-base form is intentional:
+ *     it captures every file the PR touched, not just the latest commit.
+ *
+ *  2. No `--since` flag — fall back to comparing file mtimes against
+ *     `fingerprint.json.computedAt`. Slower but works without git history.
+ *
+ * Either path returns paths relative to the repo root. Non-source files
+ * (anything not tracked by the analyzer's language config) are filtered out
+ * by the caller via the node table.
+ */
+export interface DiffResult {
+    /** Repo-relative paths of files that may have changed since graph build. */
+    changed: string[];
+    /** Which mechanism produced the list. */
+    mechanism: 'git' | 'mtime';
+    /** Any non-fatal warnings (e.g. "no .git found, used mtime"). */
+    warnings: string[];
+    /** The short commit hash of HEAD at the moment of the check, if available. */
+    workingCommit: string | null;
+}
+export interface DiffOptions {
+    repoRoot: string;
+    /** Iso8601 timestamp the graph was built — used by mtime fallback. */
+    graphBuiltAt: string | null;
+    /** Optional git ref to diff against (e.g. "origin/main"). */
+    since?: string;
+}
+export declare function hasGitDirectory(repoRoot: string): Promise<boolean>;
+export declare function refExists(repoRoot: string, ref: string): Promise<boolean>;
+export declare function computeDiff(opts: DiffOptions): Promise<DiffResult>;
+/** Read `fingerprint.json` if present. */
+export declare function readGraphFingerprint(repoRoot: string): Promise<{
+    computedAt: string | null;
+    fileCount: number | null;
+} | null>;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/cli/preflight/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE;AAOD,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/E;AAsED,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAwCxE;AAED,0CAA0C;AAC1C,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACpE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,IAAI,CAAC,CAYR"}