openlore 2.0.10 → 2.0.12

package/dist/pi/extension.js

@@ -0,0 +1,508 @@
+/**
+ * openlore Pi extension — src/pi/extension.ts
+ *
+ * Compiled to dist/pi/extension.js and declared in package.json "pi" field so
+ * `pi install npm:openlore` drops it into the Pi extension registry automatically.
+ *
+ * Two halves:
+ *   C — context injection (before_agent_start): model starts grounded with the
+ *       architecture digest + spec index + task-grounded orient call, so weak
+ *       tool-callers benefit even without calling a tool.
+ *   B — native tools (registerTool): navigation surface for on-demand structural
+ *       queries, each round-tripping to the warm daemon via fetch.
+ *
+ * Uses ctx.mode (0.78.1+): full injection in tui/rpc (interactive), none in
+ * json/print (one-shot). rpc = headless interactive over stdin/stdout (IDE,
+ * custom UI) — same injection needs as tui.
+ *
+ * Config onboarding: runs on first session when .openlore/config.json is absent;
+ * also available anytime via the openlore_configure tool.
+ */
+import { StringEnum } from '@earendil-works/pi-ai';
+import { Type } from 'typebox';
+import { spawn } from 'node:child_process';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const OPENLORE_DIR = '.openlore';
+/** Treat a config as absent unless it has the minimum viable fields. */
+export function isUsableConfig(raw) {
+    return !!raw && typeof raw === 'object' && typeof raw.generation?.provider === 'string';
+}
+export async function readConfig(cwd) {
+    try {
+        const raw = JSON.parse(await readFile(join(cwd, OPENLORE_DIR, 'config.json'), 'utf-8'));
+        return isUsableConfig(raw) ? raw : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function writeConfig(cwd, config) {
+    await mkdir(join(cwd, OPENLORE_DIR), { recursive: true });
+    await writeFile(join(cwd, OPENLORE_DIR, 'config.json'), JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+const PROVIDERS = [
+    'anthropic', 'openai', 'openai-compat', 'gemini',
+    'copilot', 'claude-code', 'gemini-cli', 'mistral-vibe', 'cursor-agent',
+];
+const PROVIDER_MODEL_DEFAULTS = {
+    anthropic: 'claude-sonnet-4-6',
+    openai: 'gpt-4o',
+    'openai-compat': '',
+    gemini: 'gemini-2.0-flash',
+    copilot: 'gpt-4o',
+    'claude-code': 'claude-sonnet-4-6',
+    'gemini-cli': 'gemini-2.0-flash',
+    'mistral-vibe': 'codestral-latest',
+    'cursor-agent': '',
+};
+const SYSTEM_AUTH_PROVIDERS = new Set(['copilot', 'claude-code', 'gemini-cli', 'mistral-vibe', 'cursor-agent']);
+const PROVIDER_ENV_VARS = {
+    anthropic: 'ANTHROPIC_API_KEY',
+    openai: 'OPENAI_API_KEY',
+    'openai-compat': 'OPENAI_COMPAT_API_KEY',
+    copilot: 'COPILOT_API_KEY',
+};
+/**
+ * Build the `/v1/models` URL for a provider base URL, tolerating a trailing
+ * slash and an already-present `/v1` segment (e.g. https://api.mistral.ai/v1/).
+ */
+export function modelsUrl(baseUrl) {
+    const base = baseUrl.replace(/\/+$/, '').replace(/\/v1$/, '');
+    return `${base}/v1/models`;
+}
+/** Strip the trailing " *" current-value marker added to select-list entries. */
+export function stripMarker(label) {
+    return label.replace(/ \*$/, '');
+}
+async function fetchModels(baseUrl, apiKey) {
+    try {
+        const res = await fetch(modelsUrl(baseUrl), {
+            headers: apiKey ? { Authorization: `Bearer ${apiKey}` } : {},
+            signal: AbortSignal.timeout(1500),
+        });
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        return data.data?.map((m) => m.id).sort() ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Config wizard ─────────────────────────────────────────────────────────────
+async function configureGeneration(ui, existing) {
+    const existingProvider = existing?.provider;
+    const providerList = existingProvider
+        ? [`${existingProvider} *`, ...PROVIDERS.filter((p) => p !== existingProvider)]
+        : PROVIDERS;
+    const selectedProvider = await ui.select('LLM provider', providerList) ?? providerList[0];
+    const provider = stripMarker(selectedProvider);
+    let baseUrl = existing?.openaiCompatBaseUrl;
+    let skipSslVerify = existing?.skipSslVerify ?? false;
+    let apiKey;
+    if (provider === 'openai-compat') {
+        const urlTitle = baseUrl ? `Base URL (current: ${baseUrl})` : 'Base URL';
+        const rawUrl = await ui.input(urlTitle, 'http://localhost:11434');
+        baseUrl = rawUrl || baseUrl || '';
+        skipSslVerify = await ui.confirm('Skip SSL verification?', 'Only enable for local servers with self-signed certificates (e.g. Ollama on localhost). Do NOT enable for remote/cloud endpoints.');
+    }
+    if (!SYSTEM_AUTH_PROVIDERS.has(provider) && PROVIDER_ENV_VARS[provider]) {
+        apiKey = process.env[PROVIDER_ENV_VARS[provider]];
+        if (!apiKey) {
+            ui.notify(`API key: set ${PROVIDER_ENV_VARS[provider]} in your shell environment`, 'warning');
+        }
+    }
+    let model;
+    const apiBase = provider === 'openai' ? 'https://api.openai.com' : (baseUrl ?? '');
+    const models = apiBase ? await fetchModels(apiBase, apiKey) : null;
+    if (models && models.length > 0) {
+        const currentModel = existing?.model;
+        const modelList = currentModel && models.includes(currentModel)
+            ? [`${currentModel} *`, ...models.filter((m) => m !== currentModel)]
+            : models;
+        const selectedModel = await ui.select('Model', modelList) ?? modelList[0];
+        model = stripMarker(selectedModel);
+    }
+    else {
+        const existingModel = existing?.model ?? PROVIDER_MODEL_DEFAULTS[provider] ?? '';
+        const modelTitle = existing?.model ? `Model (current: ${existing.model})` : 'Model';
+        model = (await ui.input(modelTitle, PROVIDER_MODEL_DEFAULTS[provider] ?? '')) || existingModel;
+    }
+    return {
+        provider,
+        model,
+        ...(baseUrl ? { openaiCompatBaseUrl: baseUrl } : {}),
+        ...(skipSslVerify ? { skipSslVerify: true } : {}),
+    };
+}
+async function configureEmbedding(ui, existing) {
+    const embedUrl = (await ui.input(existing?.baseUrl ? `Embedding base URL (current: ${existing.baseUrl})` : 'Embedding base URL', existing?.baseUrl ?? 'http://localhost:11434')) || existing?.baseUrl || '';
+    if (!embedUrl)
+        return undefined;
+    const embedSsl = await ui.confirm('Skip SSL verification for embedding?', 'Only enable for local servers with self-signed certificates (e.g. Ollama on localhost). Do NOT enable for remote/cloud endpoints.');
+    const embedModels = await fetchModels(embedUrl);
+    let embedModel;
+    if (embedModels && embedModels.length > 0) {
+        const currentEmbedModel = existing?.model;
+        const embedModelList = currentEmbedModel && embedModels.includes(currentEmbedModel)
+            ? [`${currentEmbedModel} *`, ...embedModels.filter((m) => m !== currentEmbedModel)]
+            : embedModels;
+        const selectedEmbedModel = await ui.select('Embedding model', embedModelList) ?? embedModelList[0];
+        embedModel = stripMarker(selectedEmbedModel);
+    }
+    else {
+        const existingModel = existing?.model ?? '';
+        embedModel = (await ui.input(existing?.model ? `Embedding model (current: ${existing.model})` : 'Embedding model', '')) || existingModel;
+    }
+    const embedApiKey = process.env['OPENLORE_EMBEDDING_API_KEY'];
+    if (!embedApiKey) {
+        ui.notify('Embedding API key: set OPENLORE_EMBEDDING_API_KEY in your shell environment (leave unset for Ollama/local endpoints)', 'info');
+    }
+    return {
+        baseUrl: embedUrl,
+        model: embedModel,
+        ...(embedSsl ? { skipSslVerify: true } : {}),
+    };
+}
+async function runConfigWizard(ctx, existing) {
+    const { ui } = ctx;
+    // Mutable working copy — sections update independently until "Save".
+    let generation = existing?.generation ?? {};
+    let embedding = existing?.embedding;
+    let maxFiles = existing?.analysis?.maxFiles ?? 500;
+    // Pi never persists API keys (they belong in env vars). If an older config
+    // written by the CLI carried an embedding apiKey, drop it on save and tell the
+    // user — keeps behaviour consistent whether or not they edit the embedding.
+    if (embedding?.apiKey) {
+        embedding = { baseUrl: embedding.baseUrl, model: embedding.model, ...(embedding.skipSslVerify ? { skipSslVerify: true } : {}) };
+        ui.notify('Removed stored embedding API key from config — set OPENLORE_EMBEDDING_API_KEY in your shell instead.', 'warning');
+    }
+    // Menu loop — user picks which section to edit, repeats until Done.
+    while (true) {
+        const genLabel = generation.provider
+            ? `Generation  ${generation.provider} · ${generation.model ?? '—'}${generation.openaiCompatBaseUrl ? ' · ' + generation.openaiCompatBaseUrl : ''}`
+            : 'Generation  (not configured)';
+        const embedLabel = embedding
+            ? `Embedding   ${embedding.baseUrl} · ${embedding.model || '—'}`
+            : 'Embedding   (not configured)';
+        const analysisLabel = `Analysis    maxFiles=${maxFiles}`;
+        const choice = await ui.select('openlore config — what to change?', [
+            genLabel,
+            embedLabel,
+            analysisLabel,
+            'Save & close',
+        ]);
+        if (!choice)
+            return; // escaped — discard all changes
+        if (choice === 'Save & close')
+            break;
+        if (choice === genLabel) {
+            generation = await configureGeneration(ui, generation);
+        }
+        else if (choice === embedLabel) {
+            embedding = await configureEmbedding(ui, embedding);
+        }
+        else if (choice === analysisLabel) {
+            const raw = await ui.input(`Max files to analyze (current: ${maxFiles})`, '500');
+            maxFiles = parseInt(raw ?? '', 10) || maxFiles;
+        }
+    }
+    const config = {
+        version: existing?.version ?? '1.0.0',
+        projectType: existing?.projectType ?? 'unknown',
+        openspecPath: existing?.openspecPath ?? 'openspec',
+        analysis: {
+            maxFiles,
+            includePatterns: existing?.analysis?.includePatterns ?? [],
+            excludePatterns: existing?.analysis?.excludePatterns ?? [],
+        },
+        generation,
+        ...(embedding ? { embedding } : {}),
+        createdAt: existing?.createdAt ?? new Date().toISOString(),
+        lastRun: existing?.lastRun ?? null,
+    };
+    await writeConfig(ctx.cwd, config);
+    ui.notify('Configuration saved.', 'info');
+    const runNow = await ui.confirm('Run openlore analyze now?', 'Builds the structural index required for navigation tools (~30s–2min depending on codebase size)');
+    if (runNow) {
+        ui.notify('Running openlore analyze…', 'info');
+        const [exitCode, errText] = await new Promise((resolve) => {
+            // Try `openlore` in PATH; fall back to `npx openlore` if not found.
+            const trySpawn = (cmd, args) => new Promise((res) => {
+                const chunks = [];
+                const proc = spawn(cmd, args, { cwd: ctx.cwd, stdio: ['ignore', 'ignore', 'pipe'] });
+                proc.stderr?.on('data', (d) => chunks.push(d));
+                proc.on('close', (code) => res([code ?? 1, Buffer.concat(chunks).toString().trim()]));
+                proc.on('error', () => res(null));
+            });
+            trySpawn('openlore', ['analyze']).then((r) => {
+                if (r !== null)
+                    return resolve(r);
+                return trySpawn('npx', ['openlore', 'analyze']).then((r2) => resolve(r2 ?? [1, 'openlore not found in PATH']));
+            });
+        });
+        if (exitCode === 0) {
+            ui.notify('Analysis complete — openlore tools are ready.', 'info');
+        }
+        else {
+            ui.notify(`openlore analyze failed — run it manually. ${errText ? '(' + errText.slice(0, 120) + ')' : ''}`.trim(), 'error');
+        }
+    }
+}
+const HEALTH_TIMEOUT_MS = 8000;
+const HEALTH_POLL_MS = 150;
+const RESULT_MAX = 50_000;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function readDescriptor(cwd) {
+    try {
+        return JSON.parse(await readFile(join(cwd, OPENLORE_DIR, 'serve.json'), 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+async function healthy(desc) {
+    try {
+        const res = await fetch(`http://${desc.host}:${desc.port}/health`, { signal: AbortSignal.timeout(1000) });
+        if (!res.ok)
+            return false;
+        return (await res.json().catch(() => null))?.ok === true;
+    }
+    catch {
+        return false;
+    }
+}
+async function ensureDaemon(cwd) {
+    const existing = await readDescriptor(cwd);
+    if (existing && (await healthy(existing)))
+        return { baseUrl: `http://${existing.host}:${existing.port}`, token: existing.token };
+    try {
+        spawn('openlore', ['serve', '--directory', cwd], { detached: true, stdio: 'ignore' }).unref();
+    }
+    catch {
+        return null;
+    }
+    const deadline = Date.now() + HEALTH_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        await sleep(HEALTH_POLL_MS);
+        const desc = await readDescriptor(cwd);
+        if (desc && (await healthy(desc)))
+            return { baseUrl: `http://${desc.host}:${desc.port}`, token: desc.token };
+    }
+    return null;
+}
+async function callTool(daemon, name, args, cwd, signal) {
+    const headers = { 'content-type': 'application/json' };
+    if (daemon.token)
+        headers['x-openlore-token'] = daemon.token;
+    try {
+        const res = await fetch(`${daemon.baseUrl}/tool/${encodeURIComponent(name)}`, {
+            method: 'POST', headers, body: JSON.stringify({ directory: cwd, args }), signal,
+        });
+        const body = await res.json().catch(() => ({ error: `non-JSON (${res.status})` }));
+        if (!res.ok)
+            return { error: body.error ?? `HTTP ${res.status}` };
+        return body;
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ── Context injection helpers ─────────────────────────────────────────────────
+function truncate(s, max) {
+    return s.length <= max ? s : s.slice(0, max) + `\n… (truncated, ${s.length - max} more chars)`;
+}
+async function readDigest(cwd) {
+    try {
+        return await readFile(join(cwd, OPENLORE_DIR, 'analysis', 'CODEBASE.md'), 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+async function readSpecIndex(cwd) {
+    try {
+        const { readdir } = await import('node:fs/promises');
+        const dirs = (await readdir(join(cwd, 'openspec', 'specs'), { withFileTypes: true }))
+            .filter((d) => d.isDirectory()).map((d) => d.name);
+        if (dirs.length === 0)
+            return '';
+        return ['## openlore spec domains', ...dirs.map((d) => `- ${d}`)].join('\n');
+    }
+    catch {
+        return '';
+    }
+}
+const NAV_TOOLS = [
+    {
+        name: 'orient',
+        label: 'openlore orient',
+        description: 'START HERE on any new task. Returns relevant functions, files, spec domains, call neighbours, and insertion points in one call.',
+        guideline: 'Use openlore_orient FIRST on any new task before reading files.',
+        parameters: Type.Object({ task: Type.String({ description: 'Natural-language task description' }), limit: Type.Optional(Type.Number()) }),
+    },
+    {
+        name: 'search_code',
+        label: 'openlore search_code',
+        description: 'Semantic + keyword search for functions by meaning or name.',
+        guideline: 'Use openlore_search_code to find where a concept lives instead of grepping.',
+        parameters: Type.Object({ query: Type.String(), limit: Type.Optional(Type.Number()), language: Type.Optional(Type.String()) }),
+    },
+    {
+        name: 'get_subgraph',
+        label: 'openlore get_subgraph',
+        description: 'Call topology around a function (callers/callees) to a given depth.',
+        guideline: 'Use openlore_get_subgraph to see blast radius before changing a function.',
+        parameters: Type.Object({ functionName: Type.String(), direction: Type.Optional(StringEnum(['downstream', 'upstream', 'both'])), maxDepth: Type.Optional(Type.Number()) }),
+    },
+    {
+        name: 'trace_execution_path',
+        label: 'openlore trace_execution_path',
+        description: 'Find call paths from an entry function to a target function.',
+        guideline: 'Use openlore_trace_execution_path to answer "how does X reach Y".',
+        parameters: Type.Object({ entryFunction: Type.String(), targetFunction: Type.String(), maxDepth: Type.Optional(Type.Number()) }),
+    },
+    {
+        name: 'analyze_impact',
+        label: 'openlore analyze_impact',
+        description: 'Blast radius of changing a symbol (transitive dependents).',
+        guideline: 'Use openlore_analyze_impact before editing a shared/hub symbol.',
+        parameters: Type.Object({ symbol: Type.String(), depth: Type.Optional(Type.Number()) }),
+    },
+    {
+        name: 'suggest_insertion_points',
+        label: 'openlore suggest_insertion_points',
+        description: 'Where to add a feature — ranked file/function insertion candidates.',
+        guideline: 'Use openlore_suggest_insertion_points when planning where new code goes.',
+        parameters: Type.Object({ description: Type.String(), limit: Type.Optional(Type.Number()) }),
+    },
+    {
+        name: 'get_function_skeleton',
+        label: 'openlore get_function_skeleton',
+        description: 'Compact skeleton of a file: signatures + control flow, noise stripped.',
+        guideline: 'Use openlore_get_function_skeleton to read a file cheaply before opening it.',
+        parameters: Type.Object({ filePath: Type.String() }),
+    },
+];
+function toolResult(text, details = null) {
+    return { content: [{ type: 'text', text }], details };
+}
+// ── Extension entry point ─────────────────────────────────────────────────────
+export default function openlore(pi) {
+    const daemons = new Map();
+    // Negative cache: when a daemon can't be reached, remember the failure for a
+    // short window so we don't pay the full 8s spawn-and-poll on every call in a
+    // repo that simply isn't analyzed yet. Transient failures recover after TTL.
+    const failedUntil = new Map();
+    const DAEMON_RETRY_COOLDOWN_MS = 30_000;
+    const primed = new Set();
+    let sessionCwd = process.cwd();
+    let sessionMode = 'tui';
+    async function getDaemon(cwd) {
+        const cached = daemons.get(cwd);
+        if (cached)
+            return cached;
+        if ((failedUntil.get(cwd) ?? 0) > Date.now())
+            return null;
+        const d = await ensureDaemon(cwd);
+        if (d) {
+            daemons.set(cwd, d);
+            failedUntil.delete(cwd);
+        }
+        else {
+            failedUntil.set(cwd, Date.now() + DAEMON_RETRY_COOLDOWN_MS);
+        }
+        return d;
+    }
+    // ── B: navigation tools ──
+    for (const tool of NAV_TOOLS) {
+        pi.registerTool({
+            name: `openlore_${tool.name}`,
+            label: tool.label,
+            description: tool.description,
+            promptSnippet: tool.description,
+            promptGuidelines: [tool.guideline],
+            parameters: tool.parameters,
+            async execute(_id, params, signal, _onUpdate, ctx) {
+                const daemon = await getDaemon(ctx.cwd);
+                if (!daemon)
+                    return toolResult('openlore daemon unavailable — run `openlore analyze` then retry.');
+                const result = await callTool(daemon, tool.name, params, ctx.cwd, signal ?? undefined);
+                const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+                return toolResult(truncate(text, RESULT_MAX), result);
+            },
+        });
+    }
+    // ── Config tool ──
+    pi.registerTool({
+        name: 'openlore_configure',
+        label: 'openlore configure',
+        description: 'Open the openlore configuration wizard to set provider, model, embedding, and analysis settings.',
+        promptSnippet: 'Configure openlore settings (provider, model, API key, embedding).',
+        promptGuidelines: ['Use openlore_configure to change the LLM provider, model, or embedding settings.'],
+        parameters: Type.Object({}),
+        async execute(_id, _params, _signal, _onUpdate, ctx) {
+            if (!ctx.hasUI)
+                return toolResult('Config wizard requires an interactive session (tui or rpc mode).');
+            const existing = await readConfig(ctx.cwd);
+            await runConfigWizard(ctx, existing);
+            return toolResult('Configuration saved to .openlore/config.json.');
+        },
+    });
+    // ── /configure slash command ──
+    pi.registerCommand('openlore', {
+        description: 'Open the openlore configuration wizard',
+        async handler(_args, ctx) {
+            if (!ctx.hasUI) {
+                ctx.ui.notify('Config wizard requires an interactive session.', 'error');
+                return;
+            }
+            const existing = await readConfig(ctx.cwd);
+            await runConfigWizard(ctx, existing);
+        },
+    });
+    // ── session_start: onboarding + daemon warmup ──
+    pi.on('session_start', async (_event, ctx) => {
+        sessionCwd = ctx.cwd;
+        sessionMode = ctx.mode;
+        if (ctx.hasUI && !(await readConfig(ctx.cwd))) {
+            await runConfigWizard(ctx, null);
+        }
+        if (ctx.mode !== 'json' && ctx.mode !== 'print') {
+            await getDaemon(ctx.cwd);
+        }
+    });
+    // ── C: context injection on the first turn ──
+    pi.on('before_agent_start', async (event, _ctx) => {
+        if (sessionMode === 'json' || sessionMode === 'print')
+            return;
+        if (primed.has(sessionCwd))
+            return;
+        primed.add(sessionCwd);
+        const blocks = [];
+        const digest = await readDigest(sessionCwd);
+        if (digest)
+            blocks.push('# Codebase architecture (openlore)\n\n' + truncate(digest, 8000));
+        const specIndex = await readSpecIndex(sessionCwd);
+        if (specIndex)
+            blocks.push(specIndex);
+        const daemon = await getDaemon(sessionCwd);
+        if (daemon && event.prompt) {
+            const oriented = await callTool(daemon, 'orient', { task: event.prompt }, sessionCwd);
+            if (oriented && typeof oriented === 'object' && !('error' in oriented)) {
+                blocks.push('# openlore orientation for this task\n\n' + truncate(JSON.stringify(oriented, null, 2), 6000));
+            }
+        }
+        const suffix = blocks.length > 0
+            ? blocks.join('\n\n')
+            : '[openlore: no analysis found — run `openlore analyze` to enable structural context.]';
+        return { systemPrompt: event.systemPrompt + '\n\n' + suffix };
+    });
+}
+export const installPaths = {
+    project: (cwd) => join(cwd, '.pi', 'extensions', 'openlore.js'),
+    global: () => join(homedir(), '.pi', 'agent', 'extensions', 'openlore.js'),
+};
+//# sourceMappingURL=extension.js.map

package/dist/pi/extension.js.map

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

package/examples/pi/README.md

@@ -0,0 +1,98 @@
+# openlore × Pi
+
+A [Pi](https://pi.dev) extension that brings openlore's deterministic structural
+context into Pi — built for local models (Qwen, Gemma, …) that are strong at
+using injected context but weaker at tool-calling.
+
+It does **not** use MCP. It talks to a warm `openlore serve` HTTP daemon over
+loopback, so tool calls hit warm caches and the analysis stays continuously
+fresh while you edit.
+
+## What you get
+
+- **Context injection** (no tool call needed): each session starts grounded with
+  the architecture digest (`CODEBASE.md`), the spec-domain index, and a
+  task-specific `orient` on your first message.
+- **Native tools**: the navigation surface as Pi tools —
+  `openlore_orient`, `openlore_search_code`, `openlore_get_subgraph`,
+  `openlore_trace_execution_path`, `openlore_analyze_impact`,
+  `openlore_suggest_insertion_points`, `openlore_get_function_skeleton`.
+- **Config wizard**: interactive setup on first run, or anytime via `/openlore`
+  slash command or `openlore_configure` tool.
+
+## Prerequisites
+
+```bash
+npm i -g openlore         # `openlore` must be on PATH
+cd your-project
+openlore analyze          # build the structural index at least once
+```
+
+## Install
+
+### Recommended — Pi gallery
+
+```bash
+pi install npm:openlore
+```
+
+Pi discovers the extension automatically via the `"pi"` field in openlore's
+`package.json`. On first session it launches the config wizard.
+
+### Alternative — openlore setup
+
+```bash
+openlore setup --tools pi            # → .pi/extensions/openlore.js (this project)
+openlore setup --tools pi --global   # → ~/.pi/agent/extensions/openlore.js (all projects)
+```
+
+> Requires Pi ≥ 0.78.1. The extension uses `ctx.mode` (0.78.1+) for injection
+> depth: full in `tui`/`rpc` (interactive), none in `json`/`print` (one-shot).
+
+## Configuration
+
+On first session (no `.openlore/config.json`) the wizard runs automatically.
+Re-open anytime:
+
+```
+/openlore          # slash command in any Pi session
+```
+
+or ask Pi to call `openlore_configure`.
+
+API keys are never stored in config — set them as environment variables:
+
+| Provider | Env var |
+|----------|---------|
+| `anthropic` | `ANTHROPIC_API_KEY` |
+| `openai` | `OPENAI_API_KEY` |
+| `openai-compat` | `OPENAI_COMPAT_API_KEY` |
+| Embedding | `OPENLORE_EMBEDDING_API_KEY` |
+
+## How it works
+
+On `session_start` the extension looks for `.openlore/serve.json`; if no healthy
+daemon is announced it spawns `openlore serve` detached and waits for `/health`.
+The daemon:
+
+- serves the `navigation` tool preset over `127.0.0.1`,
+- keeps signatures/vector fresh live, and
+- re-analyzes the call graph (debounced) after each edit burst — so what the
+  model sees never silently diverges from the code.
+
+The extension never kills a daemon it didn't start; it may be serving other
+clients (another Pi session, an editor).
+
+## Verify
+
+```bash
+# daemon is reachable
+curl 127.0.0.1:$(jq .port .openlore/serve.json)/health
+
+# a tool round-trips
+curl -XPOST 127.0.0.1:$(jq .port .openlore/serve.json)/tool/orient \
+  -d '{"args":{"task":"add rate limiting"}}'
+```
+
+Then run Pi in the project and confirm the session opens with openlore context
+and that `openlore_orient` is callable.