@olorehq/olore 0.1.4 → 0.2.0

package/README.md

@@ -0,0 +1,74 @@
+# olore
+
+```
+ ██████╗ ██╗      ██████╗ ██████╗ ███████╗
+██╔═══██╗██║     ██╔═══██╗██╔══██╗██╔════╝
+██║   ██║██║     ██║   ██║██████╔╝█████╗
+██║   ██║██║     ██║   ██║██╔══██╗██╔══╝
+╚██████╔╝███████╗╚██████╔╝██║  ██║███████╗
+ ╚═════╝ ╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝
+        O(pen) Lore for AI Agents
+```
+
+Documentation package manager for AI coding agents. Local-first. Offline-ready.
+
+## Quick Start
+
+```bash
+npm install -g @olorehq/olore
+olore install prisma
+olore inject
+```
+
+That's it. Your agent now has Prisma docs. No hallucinations.
+
+## Why olore?
+
+Your AI coding agent makes decisions about which tools to invoke. Sometimes it decides wrong — it skips the tool, hallucinates an API, or calls it with bad arguments.
+
+**Passive context beats skills.** Vercel's agentic coding eval showed agents with passive documentation context scored **100%** vs **53%** with tool-based retrieval. The difference: passive context is always there. The agent doesn't have to decide to look it up.
+
+`olore inject` embeds a compact documentation index directly into your `AGENTS.md` / `CLAUDE.md`. The agent reads it automatically on every session — no invocation decision needed. No network. No retrieval pipeline.
+
+- **Version-pinned** — same docs, every run, every machine
+- **Offline** — works on planes, in CI, behind firewalls
+- **Local-first** — docs live in your project, not on someone's server
+- **Any agent** — Claude Code, Codex, OpenCode, anything that reads markdown
+
+## Available Packages
+
+`prisma` · `nextjs` · `zod` · `drizzle` · `langchain` · `tanstack-query` · `claude-code` · `codex` · `opencode` · `cargo` · `agentskills`
+
+More on the [registry](https://github.com/olorehq/olore). Contributions welcome.
+
+## Supported Agents
+
+- **Claude Code** — injects into `CLAUDE.md`
+- **Codex** — injects into `AGENTS.md`
+- **OpenCode** — injects into `AGENTS.md`
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `olore install <pkg>` | Install a documentation package |
+| `olore inject` | Inject doc indexes into AGENTS.md / CLAUDE.md |
+| `olore inject --remove` | Remove injected content |
+| `olore list` | List installed packages |
+| `olore remove <pkg>` | Remove a package |
+| `olore search` | Browse available packages |
+| `olore doctor` | Diagnose issues |
+
+## Links
+
+- [GitHub](https://github.com/olorehq/olore)
+- [Website](https://www.olore.dev)
+- [Contributing](https://github.com/olorehq/olore/blob/main/CONTRIBUTING.md)
+
+## License
+
+MIT
+
+---
+
+> *"May the Skill be with you."*

package/dist/cli.js

@@ -3,7 +3,7 @@
 // src/cli.ts
 import { createRequire } from "module";
 import { Command } from "commander";
-import pc10 from "picocolors";
+import pc11 from "picocolors";
 
 // src/commands/doctor.ts
 import pc from "picocolors";
@@ -705,11 +705,146 @@ Initialized olore package: `) + pc2.cyan(fullName));
   console.log("");
 }
 
-// src/commands/install.ts
+// src/commands/inject.ts
+import fs6 from "fs";
 import path6 from "path";
-import fs6 from "fs-extra";
-import ora from "ora";
 import pc3 from "picocolors";
+var MARKER_START = "<!-- olore:start -->";
+var MARKER_END = "<!-- olore:end -->";
+var TARGET_FILES = ["AGENTS.md", "CLAUDE.md"];
+var COMPACT_HEADER = "[olore docs]|STOP. Read these docs before answering \u2014 your training data may be outdated.|Format: keywords=path. For dir paths (ending /), list dir then read files.";
+function extractSectionLines(content) {
+  return content.split("\n").filter((line) => line.startsWith("@")).filter((line) => line.length > 0);
+}
+function renderCompactBlock(sectionLines, name, version2, rootPath) {
+  return `[${name}@${version2} root:${rootPath}]${sectionLines.join("")}`;
+}
+async function buildInjectedContent() {
+  const packages = await getInstalledPackages();
+  const packageLines = [];
+  let count = 0;
+  for (const pkg of packages) {
+    const indexPath = path6.join(pkg.path, "INDEX.md");
+    if (!fs6.existsSync(indexPath)) continue;
+    const rawContent = fs6.readFileSync(indexPath, "utf-8");
+    const sectionLines = extractSectionLines(rawContent);
+    if (sectionLines.length === 0) continue;
+    const resolvedBase = fs6.realpathSync(pkg.path);
+    const rootPath = path6.join(resolvedBase, "contents");
+    packageLines.push(renderCompactBlock(sectionLines, pkg.name, pkg.version, rootPath));
+    count++;
+  }
+  if (count === 0) {
+    return { content: "", count: 0 };
+  }
+  const combined = [MARKER_START, COMPACT_HEADER, ...packageLines, MARKER_END].join("\n");
+  return { content: combined, count };
+}
+function smartMerge(filePath, injectedContent) {
+  if (!fs6.existsSync(filePath)) {
+    fs6.writeFileSync(filePath, injectedContent + "\n", "utf-8");
+    return;
+  }
+  const existing = fs6.readFileSync(filePath, "utf-8");
+  const startIdx = existing.indexOf(MARKER_START);
+  const endIdx = existing.indexOf(MARKER_END);
+  if (startIdx !== -1 && endIdx !== -1) {
+    const before = existing.slice(0, startIdx);
+    const after = existing.slice(endIdx + MARKER_END.length);
+    fs6.writeFileSync(filePath, before + injectedContent + after, "utf-8");
+  } else {
+    const separator = existing.endsWith("\n") ? "\n" : "\n\n";
+    fs6.writeFileSync(filePath, existing + separator + injectedContent + "\n", "utf-8");
+  }
+}
+function removeSection(filePath) {
+  if (!fs6.existsSync(filePath)) return false;
+  const content = fs6.readFileSync(filePath, "utf-8");
+  const startIdx = content.indexOf(MARKER_START);
+  const endIdx = content.indexOf(MARKER_END);
+  if (startIdx === -1 || endIdx === -1) return false;
+  const before = content.slice(0, startIdx);
+  const after = content.slice(endIdx + MARKER_END.length);
+  const result = (before + after).replace(/\n{3,}/g, "\n\n").trim();
+  if (result.length === 0) {
+    fs6.unlinkSync(filePath);
+  } else {
+    fs6.writeFileSync(filePath, result + "\n", "utf-8");
+  }
+  return true;
+}
+async function inject(options) {
+  const cwd = process.cwd();
+  if (options.remove) {
+    const filesRemoved = [];
+    for (const fileName of TARGET_FILES) {
+      const filePath = path6.join(cwd, fileName);
+      if (removeSection(filePath)) {
+        filesRemoved.push(fileName);
+      }
+    }
+    if (options.json) {
+      const result = {
+        packagesFound: 0,
+        packagesInjected: 0,
+        filesWritten: filesRemoved,
+        removed: true
+      };
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (filesRemoved.length === 0) {
+      console.log(pc3.yellow("No olore sections found in project files."));
+    } else {
+      console.log(pc3.green(`Removed olore sections from: ${filesRemoved.join(", ")}`));
+    }
+    return;
+  }
+  const { content, count } = await buildInjectedContent();
+  if (count === 0) {
+    if (options.json) {
+      const result = {
+        packagesFound: 0,
+        packagesInjected: 0,
+        filesWritten: [],
+        removed: false
+      };
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(pc3.yellow("No installed packages have INDEX.md files."));
+    console.log(pc3.gray("Build packages with the latest templates to generate INDEX.md."));
+    return;
+  }
+  const filesWritten = [];
+  for (const fileName of TARGET_FILES) {
+    const filePath = path6.join(cwd, fileName);
+    smartMerge(filePath, content);
+    filesWritten.push(fileName);
+  }
+  if (options.json) {
+    const result = {
+      packagesFound: count,
+      packagesInjected: count,
+      filesWritten,
+      removed: false
+    };
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(
+    pc3.green(
+      `Injected ${count} package${count === 1 ? "" : "s"} into: ${filesWritten.join(", ")}`
+    )
+  );
+  console.log(pc3.gray("Run olore inject --remove to clean up."));
+}
+
+// src/commands/install.ts
+import path7 from "path";
+import fs7 from "fs-extra";
+import ora from "ora";
+import pc4 from "picocolors";
 
 // src/core/registry.ts
 var RegistryError = class extends Error {
@@ -791,22 +926,22 @@ async function resolveVersion(name, version2) {
 // src/commands/install.ts
 async function installFromLocal(localPath) {
   const fullPath = expandPath(localPath);
-  if (!await fs6.pathExists(fullPath)) {
+  if (!await fs7.pathExists(fullPath)) {
     throw new Error(`Path not found: ${fullPath}`);
   }
-  const stat = await fs6.stat(fullPath);
+  const stat = await fs7.stat(fullPath);
   if (!stat.isDirectory()) {
     throw new Error(`Not a directory: ${fullPath}`);
   }
-  const lockPath = path6.join(fullPath, "olore-lock.json");
-  if (!await fs6.pathExists(lockPath)) {
+  const lockPath = path7.join(fullPath, "olore-lock.json");
+  if (!await fs7.pathExists(lockPath)) {
     throw new Error(`Missing olore-lock.json in ${fullPath}`);
   }
-  const skillPath = path6.join(fullPath, "SKILL.md");
-  if (!await fs6.pathExists(skillPath)) {
+  const skillPath = path7.join(fullPath, "SKILL.md");
+  if (!await fs7.pathExists(skillPath)) {
     throw new Error(`Missing SKILL.md in ${fullPath}. Run /generate-agent-skills first.`);
   }
-  const lock = await fs6.readJson(lockPath);
+  const lock = await fs7.readJson(lockPath);
   const packageName = lock.name;
   const packageVersion = lock.version;
   if (!packageName) {
@@ -816,57 +951,57 @@ async function installFromLocal(localPath) {
     throw new Error(`Invalid olore-lock.json: missing "version" field`);
   }
   const skillName = `olore-${packageName}-${packageVersion}`;
-  const skillContent = await fs6.readFile(skillPath, "utf-8");
+  const skillContent = await fs7.readFile(skillPath, "utf-8");
   const nameMatch = skillContent.match(/^name:\s*(.+)$/m);
   const skillMdName = nameMatch ? nameMatch[1].trim() : null;
   if (skillMdName !== skillName) {
-    console.log(pc3.yellow(`
+    console.log(pc4.yellow(`
 Warning: SKILL.md name mismatch`));
-    console.log(pc3.gray(`  Expected: ${skillName}`));
-    console.log(pc3.gray(`  Found:    ${skillMdName || "(none)"}`));
-    console.log(pc3.yellow(`  Updating SKILL.md to fix...`));
+    console.log(pc4.gray(`  Expected: ${skillName}`));
+    console.log(pc4.gray(`  Found:    ${skillMdName || "(none)"}`));
+    console.log(pc4.yellow(`  Updating SKILL.md to fix...`));
     const updatedContent = skillMdName ? skillContent.replace(/^name:\s*.+$/m, `name: ${skillName}`) : skillContent.replace(/^---\n/, `---
 name: ${skillName}
 `);
-    await fs6.writeFile(skillPath, updatedContent);
+    await fs7.writeFile(skillPath, updatedContent);
   }
-  console.log(pc3.bold(`
+  console.log(pc4.bold(`
 Installing ${packageName}@${packageVersion} from local path...
 `));
   const agents = detectAgents();
   if (agents.length === 0) {
-    console.log(pc3.yellow("No agents detected. Creating directories anyway."));
+    console.log(pc4.yellow("No agents detected. Creating directories anyway."));
   }
   const agentPaths = getAgentPaths();
   const olorePath = getOlorePackagePath(packageName, packageVersion);
   const spinner = ora("Copying to ~/.olore...").start();
-  await fs6.ensureDir(path6.dirname(olorePath));
-  await fs6.remove(olorePath);
-  await fs6.copy(fullPath, olorePath);
-  spinner.succeed(`Copied to ${pc3.gray(olorePath)}`);
+  await fs7.ensureDir(path7.dirname(olorePath));
+  await fs7.remove(olorePath);
+  await fs7.copy(fullPath, olorePath);
+  spinner.succeed(`Copied to ${pc4.gray(olorePath)}`);
   const linkSpinner = ora("Linking to agent directories...").start();
   const linked = [];
   for (const [agent, skillsDir] of Object.entries(agentPaths)) {
-    const targetDir = path6.join(skillsDir, skillName);
-    await fs6.ensureDir(skillsDir);
-    await fs6.remove(targetDir);
+    const targetDir = path7.join(skillsDir, skillName);
+    await fs7.ensureDir(skillsDir);
+    await fs7.remove(targetDir);
     await linkOrCopy(olorePath, targetDir);
-    linked.push(`${pc3.green("\u2713")} ${agent} ${pc3.gray("\u2192")} ${pc3.gray(targetDir)}`);
+    linked.push(`${pc4.green("\u2713")} ${agent} ${pc4.gray("\u2192")} ${pc4.gray(targetDir)}`);
   }
   linkSpinner.stop();
   linked.forEach((line) => console.log(`  ${line}`));
-  console.log(pc3.gray(`    \u2514\u2500 all linked to ${olorePath}`));
+  console.log(pc4.gray(`    \u2514\u2500 all linked to ${olorePath}`));
   console.log("");
-  console.log(pc3.green("Installation complete!"));
+  console.log(pc4.green("Installation complete!"));
   console.log("");
-  console.log(pc3.gray("Skill is now available as:"));
-  console.log(pc3.cyan(`  /${skillName}`) + pc3.gray(" (Claude Code)"));
-  console.log(pc3.cyan(`  $${skillName}`) + pc3.gray(" (Codex)"));
-  console.log(pc3.cyan(`  ${skillName}`) + pc3.gray(" (OpenCode)"));
+  console.log(pc4.gray("Skill is now available as:"));
+  console.log(pc4.cyan(`  /${skillName}`) + pc4.gray(" (Claude Code)"));
+  console.log(pc4.cyan(`  $${skillName}`) + pc4.gray(" (Codex)"));
+  console.log(pc4.cyan(`  ${skillName}`) + pc4.gray(" (OpenCode)"));
 }
 async function install(pkg, options) {
   if (options.force) {
-    console.log(pc3.cyan("\n\u2728 May the Skill be with you.\n"));
+    console.log(pc4.cyan("\n\u2728 May the Skill be with you.\n"));
   }
   if (isLocalPath(pkg)) {
     await installFromLocal(pkg);
@@ -884,10 +1019,35 @@ function parsePackageSpec(spec) {
   }
   return { name: spec };
 }
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+function findSimilarPackages(input, packages, maxResults = 3) {
+  const results = [];
+  for (const [name, entry] of Object.entries(packages)) {
+    const distance = levenshtein(input.toLowerCase(), name.toLowerCase());
+    const isSubstring = name.toLowerCase().includes(input.toLowerCase()) || input.toLowerCase().includes(name.toLowerCase());
+    if (distance <= 3 || isSubstring) {
+      results.push({ name, description: entry.description, distance });
+    }
+  }
+  results.sort((a, b) => a.distance - b.distance);
+  return results.slice(0, maxResults).map(({ name, description }) => ({ name, description }));
+}
 async function installFromRemote(pkg, optionsVersion) {
   const { name, version: specVersion } = parsePackageSpec(pkg);
   const requestedVersion = optionsVersion || specVersion || "latest";
-  console.log(pc3.bold(`
+  console.log(pc4.bold(`
 Installing ${name}@${requestedVersion} from registry...
 `));
   const spinner = ora("Fetching package info...").start();
@@ -899,18 +1059,32 @@ Installing ${name}@${requestedVersion} from registry...
     spinner.fail("Failed to resolve package");
     if (error instanceof RegistryError) {
       if (error.code === "NOT_FOUND") {
-        console.log(pc3.yellow(`
+        console.log(pc4.yellow(`
 Package "${name}" not found in registry.`));
-        console.log(pc3.gray("\nFor local packages, use a path:"));
-        console.log(pc3.cyan(`  olore install ./vault/packages/${name}/<version>`));
+        try {
+          const index = await fetchPackageIndex();
+          const similar = findSimilarPackages(name, index.packages);
+          if (similar.length > 0) {
+            console.log(pc4.bold("\nDid you mean?"));
+            for (const pkg2 of similar) {
+              console.log(`  ${pc4.cyan(pkg2.name)}  ${pc4.gray("-")}  ${pc4.gray(pkg2.description)}`);
+            }
+          }
+        } catch {
+        }
+        console.log(
+          pc4.gray("\nRun ") + pc4.cyan("olore search") + pc4.gray(" to see all available packages.")
+        );
+        console.log(pc4.gray("\nFor local packages, use a path:"));
+        console.log(pc4.cyan(`  olore install ./vault/packages/${name}/<version>`));
         console.log("");
       } else if (error.code === "NETWORK_ERROR" || error.code === "TIMEOUT") {
-        console.log(pc3.red(`
+        console.log(pc4.red(`
 Network error: ${error.message}`));
-        console.log(pc3.gray("Please check your internet connection and try again."));
+        console.log(pc4.gray("Please check your internet connection and try again."));
       }
     } else {
-      console.log(pc3.red(`
+      console.log(pc4.red(`
 Error: ${error instanceof Error ? error.message : "Unknown error"}`));
     }
     process.exit(1);
@@ -918,26 +1092,26 @@ Error: ${error instanceof Error ? error.message : "Unknown error"}`));
   const skillName = `olore-${name}-${versionInfo.version}`;
   const agents = detectAgents();
   if (agents.length === 0) {
-    console.log(pc3.yellow("No agents detected. Creating directories anyway."));
+    console.log(pc4.yellow("No agents detected. Creating directories anyway."));
   }
   const agentPaths = getAgentPaths();
   const olorePath = getOlorePackagePath(name, versionInfo.version);
   const downloadSpinner = ora("Downloading package...").start();
   try {
     await downloadAndInstall(versionInfo.downloadUrl, olorePath, versionInfo.integrity);
-    downloadSpinner.succeed(`Downloaded to ${pc3.gray(olorePath)}`);
+    downloadSpinner.succeed(`Downloaded to ${pc4.gray(olorePath)}`);
   } catch (error) {
     downloadSpinner.fail("Download failed");
     if (error instanceof DownloadError) {
       if (error.code === "CHECKSUM_MISMATCH") {
-        console.log(pc3.red("\nChecksum verification failed!"));
-        console.log(pc3.gray("The downloaded package may be corrupted or tampered with."));
+        console.log(pc4.red("\nChecksum verification failed!"));
+        console.log(pc4.gray("The downloaded package may be corrupted or tampered with."));
       } else {
-        console.log(pc3.red(`
+        console.log(pc4.red(`
 Download error: ${error.message}`));
       }
     } else {
-      console.log(pc3.red(`
+      console.log(pc4.red(`
 Error: ${error instanceof Error ? error.message : "Unknown error"}`));
     }
     process.exit(1);
@@ -945,47 +1119,47 @@ Error: ${error instanceof Error ? error.message : "Unknown error"}`));
   const linkSpinner = ora("Linking to agent directories...").start();
   const linked = [];
   for (const [agent, skillsDir] of Object.entries(agentPaths)) {
-    const targetDir = path6.join(skillsDir, skillName);
-    await fs6.ensureDir(skillsDir);
-    await fs6.remove(targetDir);
+    const targetDir = path7.join(skillsDir, skillName);
+    await fs7.ensureDir(skillsDir);
+    await fs7.remove(targetDir);
     await linkOrCopy(olorePath, targetDir);
-    linked.push(`${pc3.green("\u2713")} ${agent} ${pc3.gray("\u2192")} ${pc3.gray(targetDir)}`);
+    linked.push(`${pc4.green("\u2713")} ${agent} ${pc4.gray("\u2192")} ${pc4.gray(targetDir)}`);
   }
   linkSpinner.stop();
   linked.forEach((line) => console.log(`  ${line}`));
-  console.log(pc3.gray(`    \u2514\u2500 all linked to ${olorePath}`));
+  console.log(pc4.gray(`    \u2514\u2500 all linked to ${olorePath}`));
   console.log("");
-  console.log(pc3.green("Installation complete!"));
+  console.log(pc4.green("Installation complete!"));
   console.log("");
-  console.log(pc3.gray("Skill is now available as:"));
-  console.log(pc3.cyan(`  /${skillName}`) + pc3.gray(" (Claude Code)"));
-  console.log(pc3.cyan(`  $${skillName}`) + pc3.gray(" (Codex)"));
-  console.log(pc3.cyan(`  ${skillName}`) + pc3.gray(" (OpenCode)"));
+  console.log(pc4.gray("Skill is now available as:"));
+  console.log(pc4.cyan(`  /${skillName}`) + pc4.gray(" (Claude Code)"));
+  console.log(pc4.cyan(`  $${skillName}`) + pc4.gray(" (Codex)"));
+  console.log(pc4.cyan(`  ${skillName}`) + pc4.gray(" (OpenCode)"));
 }
 
 // src/commands/link.ts
-import path7 from "path";
-import fs7 from "fs-extra";
+import path8 from "path";
+import fs8 from "fs-extra";
 import ora2 from "ora";
-import pc4 from "picocolors";
+import pc5 from "picocolors";
 async function link(localPath) {
   const fullPath = expandPath(localPath);
-  if (!await fs7.pathExists(fullPath)) {
+  if (!await fs8.pathExists(fullPath)) {
     throw new Error(`Path not found: ${fullPath}`);
   }
-  const stat = await fs7.stat(fullPath);
+  const stat = await fs8.stat(fullPath);
   if (!stat.isDirectory()) {
     throw new Error(`Not a directory: ${fullPath}`);
   }
-  const lockPath = path7.join(fullPath, "olore-lock.json");
-  if (!await fs7.pathExists(lockPath)) {
+  const lockPath = path8.join(fullPath, "olore-lock.json");
+  if (!await fs8.pathExists(lockPath)) {
     throw new Error(`Missing olore-lock.json in ${fullPath}`);
   }
-  const skillPath = path7.join(fullPath, "SKILL.md");
-  if (!await fs7.pathExists(skillPath)) {
+  const skillPath = path8.join(fullPath, "SKILL.md");
+  if (!await fs8.pathExists(skillPath)) {
     throw new Error(`Missing SKILL.md in ${fullPath}. Run /build-docs first.`);
   }
-  const lock = await fs7.readJson(lockPath);
+  const lock = await fs8.readJson(lockPath);
   const packageName = lock.name;
   const packageVersion = lock.version;
   if (!packageName) {
@@ -995,63 +1169,63 @@ async function link(localPath) {
     throw new Error(`Invalid olore-lock.json: missing "version" field`);
   }
   const skillName = `olore-${packageName}-${packageVersion}`;
-  const skillContent = await fs7.readFile(skillPath, "utf-8");
+  const skillContent = await fs8.readFile(skillPath, "utf-8");
   const nameMatch = skillContent.match(/^name:\s*(.+)$/m);
   const skillMdName = nameMatch ? nameMatch[1].trim() : null;
   if (skillMdName !== skillName) {
-    console.log(pc4.yellow(`
+    console.log(pc5.yellow(`
 Warning: SKILL.md name mismatch`));
-    console.log(pc4.gray(`  Expected: ${skillName}`));
-    console.log(pc4.gray(`  Found:    ${skillMdName || "(none)"}`));
-    console.log(pc4.yellow(`  Updating SKILL.md to fix...`));
+    console.log(pc5.gray(`  Expected: ${skillName}`));
+    console.log(pc5.gray(`  Found:    ${skillMdName || "(none)"}`));
+    console.log(pc5.yellow(`  Updating SKILL.md to fix...`));
     const updatedContent = skillMdName ? skillContent.replace(/^name:\s*.+$/m, `name: ${skillName}`) : skillContent.replace(/^---\n/, `---
 name: ${skillName}
 `);
-    await fs7.writeFile(skillPath, updatedContent);
+    await fs8.writeFile(skillPath, updatedContent);
   }
-  console.log(pc4.bold(`
+  console.log(pc5.bold(`
 Linking ${packageName}@${packageVersion}...
 `));
   const agents = detectAgents();
   if (agents.length === 0) {
-    console.log(pc4.yellow("No agents detected. Creating directories anyway."));
+    console.log(pc5.yellow("No agents detected. Creating directories anyway."));
   }
   const agentPaths = getAgentPaths();
   const spinner = ora2(`${getLinkActionText()}...`).start();
   const linked = [];
   for (const [agent, skillsDir] of Object.entries(agentPaths)) {
-    const targetDir = path7.join(skillsDir, skillName);
-    await fs7.ensureDir(skillsDir);
-    await fs7.remove(targetDir);
+    const targetDir = path8.join(skillsDir, skillName);
+    await fs8.ensureDir(skillsDir);
+    await fs8.remove(targetDir);
     await linkOrCopy(fullPath, targetDir);
-    linked.push(`${pc4.blue("\u26D3")} ${agent} ${pc4.gray("\u2192")} ${pc4.gray(targetDir)}`);
+    linked.push(`${pc5.blue("\u26D3")} ${agent} ${pc5.gray("\u2192")} ${pc5.gray(targetDir)}`);
   }
   spinner.stop();
   linked.forEach((line) => console.log(`  ${line}`));
-  console.log(pc4.gray(`    \u2514\u2500 ${getLinkTypeText()} ${fullPath}`));
+  console.log(pc5.gray(`    \u2514\u2500 ${getLinkTypeText()} ${fullPath}`));
   console.log("");
-  console.log(pc4.blue("Link complete!"));
+  console.log(pc5.blue("Link complete!"));
   console.log("");
-  console.log(pc4.gray("Skill is now available as:"));
-  console.log(pc4.cyan(`  /${skillName}`) + pc4.gray(" (Claude Code)"));
-  console.log(pc4.cyan(`  $${skillName}`) + pc4.gray(" (Codex)"));
-  console.log(pc4.cyan(`  ${skillName}`) + pc4.gray(" (OpenCode)"));
+  console.log(pc5.gray("Skill is now available as:"));
+  console.log(pc5.cyan(`  /${skillName}`) + pc5.gray(" (Claude Code)"));
+  console.log(pc5.cyan(`  $${skillName}`) + pc5.gray(" (Codex)"));
+  console.log(pc5.cyan(`  ${skillName}`) + pc5.gray(" (OpenCode)"));
   console.log("");
-  console.log(pc4.gray(`Development mode: ${getLinkTypeText()} source (bypasses ~/.olore).`));
-  console.log(pc4.gray("Changes to source are immediately visible."));
+  console.log(pc5.gray(`Development mode: ${getLinkTypeText()} source (bypasses ~/.olore).`));
+  console.log(pc5.gray("Changes to source are immediately visible."));
   console.log(
-    pc4.gray("Use ") + pc4.cyan("olore install") + pc4.gray(" for a stable copy in ~/.olore.")
+    pc5.gray("Use ") + pc5.cyan("olore install") + pc5.gray(" for a stable copy in ~/.olore.")
   );
 }
 
 // src/commands/list.ts
-import pc5 from "picocolors";
+import pc6 from "picocolors";
 async function list(options) {
   const packages = await getInstalledPackages();
   if (packages.length === 0) {
-    console.log(pc5.yellow("\nI find your lack of skills disturbing.\n"));
-    console.log(pc5.gray("No packages installed."));
-    console.log(`Run ${pc5.cyan("olore install <package>")} to install documentation.`);
+    console.log(pc6.yellow("\nI find your lack of skills disturbing.\n"));
+    console.log(pc6.gray("No packages installed."));
+    console.log(`Run ${pc6.cyan("olore install <package>")} to install documentation.`);
     return;
   }
   if (options.json) {
@@ -1059,29 +1233,29 @@ async function list(options) {
     console.log(JSON.stringify({ packages, issueCount: issues2.length }, null, 2));
     return;
   }
-  console.log(pc5.bold("\nInstalled packages:\n"));
+  console.log(pc6.bold("\nInstalled packages:\n"));
   console.log(
-    pc5.gray(
+    pc6.gray(
       "PACKAGE".padEnd(25) + "VERSION".padEnd(12) + "TYPE".padEnd(10) + "FILES".padStart(8) + "SIZE".padStart(12)
     )
   );
-  console.log(pc5.gray("-".repeat(67)));
+  console.log(pc6.gray("-".repeat(67)));
   for (const pkg of packages) {
-    const typeLabel = pkg.installType === "linked" ? pc5.blue("linked") : pkg.installType;
+    const typeLabel = pkg.installType === "linked" ? pc6.blue("linked") : pkg.installType;
     console.log(
       pkg.name.padEnd(25) + pkg.version.padEnd(12) + typeLabel.padEnd(10) + String(pkg.files).padStart(8) + formatSize(pkg.size).padStart(12)
     );
   }
-  console.log(pc5.gray("-".repeat(67)));
-  console.log(pc5.gray(`Total: ${packages.length} packages`));
+  console.log(pc6.gray("-".repeat(67)));
+  console.log(pc6.gray(`Total: ${packages.length} packages`));
   console.log("");
-  console.log(pc5.gray("Types: installed = in ~/.olore, linked = dev symlink, copied = legacy"));
+  console.log(pc6.gray("Types: installed = in ~/.olore, linked = dev symlink, copied = legacy"));
   const { issues } = await diagnose();
   if (issues.length > 0) {
     console.log("");
     console.log(
-      pc5.yellow(
-        `\u26A0 ${issues.length} issue${issues.length === 1 ? "" : "s"} detected. Run ${pc5.cyan("olore doctor")} for details.`
+      pc6.yellow(
+        `\u26A0 ${issues.length} issue${issues.length === 1 ? "" : "s"} detected. Run ${pc6.cyan("olore doctor")} for details.`
       )
     );
   }
@@ -1093,59 +1267,59 @@ function formatSize(bytes) {
 }
 
 // src/commands/order66.ts
-import path8 from "path";
-import fs8 from "fs-extra";
+import path9 from "path";
+import fs9 from "fs-extra";
 import ora3 from "ora";
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 async function order66() {
-  console.log(pc6.red("\n\u26A0\uFE0F  Execute Order 66?\n"));
-  console.log(pc6.yellow("This will remove ALL installed documentation packages."));
+  console.log(pc7.red("\n\u26A0\uFE0F  Execute Order 66?\n"));
+  console.log(pc7.yellow("This will remove ALL installed documentation packages."));
   const packages = await getInstalledPackages();
   if (packages.length === 0) {
-    console.log(pc6.gray("\nNo packages to remove. The Jedi are already gone."));
+    console.log(pc7.gray("\nNo packages to remove. The Jedi are already gone."));
     return;
   }
-  console.log(pc6.gray(`
+  console.log(pc7.gray(`
 Packages to be removed: ${packages.length}`));
   for (const pkg of packages) {
-    console.log(pc6.gray(`  - ${pkg.name}@${pkg.version}`));
+    console.log(pc7.gray(`  - ${pkg.name}@${pkg.version}`));
   }
-  console.log(pc6.red('\n"It will be done, my lord."\n'));
+  console.log(pc7.red('\n"It will be done, my lord."\n'));
   const spinner = ora3("Executing Order 66...").start();
   let removedCount = 0;
   const agentPaths = getAgentPaths();
   for (const pkg of packages) {
     const skillName = `olore-${pkg.name}-${pkg.version}`;
     for (const [, basePath] of Object.entries(agentPaths)) {
-      const skillPath = path8.join(basePath, skillName);
-      if (await fs8.pathExists(skillPath)) {
-        await fs8.remove(skillPath);
+      const skillPath = path9.join(basePath, skillName);
+      if (await fs9.pathExists(skillPath)) {
+        await fs9.remove(skillPath);
       }
     }
     if (pkg.installType === "installed") {
       const olorePath = getOlorePackagePath(pkg.name, pkg.version);
-      if (await fs8.pathExists(olorePath)) {
-        await fs8.remove(olorePath);
+      if (await fs9.pathExists(olorePath)) {
+        await fs9.remove(olorePath);
       }
     }
     removedCount++;
   }
   spinner.succeed(`Removed ${removedCount} packages`);
-  console.log(pc6.gray("\nThe Jedi have been eliminated."));
+  console.log(pc7.gray("\nThe Jedi have been eliminated."));
 }
 
 // src/commands/prune.ts
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 async function prune(options) {
   if (!options.json) {
-    console.log(pc7.bold("\nScanning for issues...\n"));
+    console.log(pc8.bold("\nScanning for issues...\n"));
   }
   const { issues } = await diagnose();
   if (issues.length === 0) {
     if (options.json) {
       console.log(JSON.stringify({ removed: [], failed: [] }, null, 2));
     } else {
-      console.log(pc7.green("Nothing to prune. Everything is clean."));
+      console.log(pc8.green("Nothing to prune. Everything is clean."));
     }
     return;
   }
@@ -1155,14 +1329,14 @@ async function prune(options) {
       return;
     }
     console.log(
-      pc7.yellow(`Would remove ${issues.length} item${issues.length === 1 ? "" : "s"}:
+      pc8.yellow(`Would remove ${issues.length} item${issues.length === 1 ? "" : "s"}:
 `)
     );
     for (const issue of issues) {
       console.log(`  ${issueLabel(issue.type)}  ${displayPath(issue.path)}`);
     }
     console.log(`
-Run ${pc7.cyan("olore prune")} (without --dry-run) to remove them.`);
+Run ${pc8.cyan("olore prune")} (without --dry-run) to remove them.`);
     return;
   }
   const result = await pruneIssues(issues);
@@ -1176,7 +1350,7 @@ Run ${pc7.cyan("olore prune")} (without --dry-run) to remove them.`);
     for (const entry of result.removed) {
       totalFreed += entry.freedBytes;
       console.log(
-        `  ${pc7.green("\u2713")} ${displayPath(entry.issue.path)} (${issueLabel(entry.issue.type)})`
+        `  ${pc8.green("\u2713")} ${displayPath(entry.issue.path)} (${issueLabel(entry.issue.type)})`
       );
     }
     if (totalFreed > 0) {
@@ -1187,12 +1361,12 @@ ${formatBytes(totalFreed)} freed.`);
   if (result.failed.length > 0) {
     console.log("");
     console.log(
-      pc7.red(
+      pc8.red(
         `Failed to remove ${result.failed.length} item${result.failed.length === 1 ? "" : "s"}:`
       )
     );
     for (const entry of result.failed) {
-      console.log(`  ${pc7.red("\u2717")} ${displayPath(entry.issue.path)}: ${entry.error}`);
+      console.log(`  ${pc8.red("\u2717")} ${displayPath(entry.issue.path)}: ${entry.error}`);
     }
   }
 }
@@ -1210,12 +1384,12 @@ function issueLabel(type) {
 }
 
 // src/commands/remove.ts
-import path9 from "path";
-import fs9 from "fs-extra";
+import path10 from "path";
+import fs10 from "fs-extra";
 import ora4 from "ora";
-import pc8 from "picocolors";
+import pc9 from "picocolors";
 async function remove(pkg) {
-  console.log(pc8.bold(`
+  console.log(pc9.bold(`
 Removing ${pkg}...
 `));
   const packages = await getInstalledPackages();
@@ -1231,20 +1405,20 @@ Removing ${pkg}...
     return p.name === name;
   });
   if (matches.length === 0) {
-    console.error(pc8.red(`Package not found: ${pkg}`));
+    console.error(pc9.red(`Package not found: ${pkg}`));
     console.log("\nInstalled packages:");
     for (const p of packages) {
-      console.log(`  ${pc8.cyan(p.name)}@${p.version}`);
+      console.log(`  ${pc9.cyan(p.name)}@${p.version}`);
     }
     process.exit(1);
   }
   if (matches.length > 1 && !version2) {
-    console.error(pc8.red(`Multiple versions found for ${name}:`));
+    console.error(pc9.red(`Multiple versions found for ${name}:`));
     for (const p of matches) {
-      console.log(`  ${pc8.cyan(p.name)}@${p.version} (${p.installType})`);
+      console.log(`  ${pc9.cyan(p.name)}@${p.version} (${p.installType})`);
     }
     console.log(`
-Specify version: ${pc8.cyan(`olore remove ${name}@<version>`)}`);
+Specify version: ${pc9.cyan(`olore remove ${name}@<version>`)}`);
     process.exit(1);
   }
   const found = matches[0];
@@ -1253,32 +1427,32 @@ Specify version: ${pc8.cyan(`olore remove ${name}@<version>`)}`);
   const removed = [];
   const agentPaths = getAgentPaths();
   for (const [agent, basePath] of Object.entries(agentPaths)) {
-    const skillPath = path9.join(basePath, skillName);
-    if (await fs9.pathExists(skillPath)) {
-      await fs9.remove(skillPath);
-      removed.push(`${pc8.green("\u2713")} ${agent}`);
+    const skillPath = path10.join(basePath, skillName);
+    if (await fs10.pathExists(skillPath)) {
+      await fs10.remove(skillPath);
+      removed.push(`${pc9.green("\u2713")} ${agent}`);
     }
   }
   if (found.installType === "installed") {
     const olorePath = getOlorePackagePath(found.name, found.version);
-    if (await fs9.pathExists(olorePath)) {
-      await fs9.remove(olorePath);
-      removed.push(`${pc8.green("\u2713")} ~/.olore`);
+    if (await fs10.pathExists(olorePath)) {
+      await fs10.remove(olorePath);
+      removed.push(`${pc9.green("\u2713")} ~/.olore`);
     }
   }
   spinner.stop();
   if (removed.length === 0) {
-    console.log(pc8.yellow("No files found to remove."));
+    console.log(pc9.yellow("No files found to remove."));
   } else {
     removed.forEach((line) => console.log(`  ${line}`));
     console.log("");
-    console.log(pc8.green(`Removed ${found.name}@${found.version}`));
+    console.log(pc9.green(`Removed ${found.name}@${found.version}`));
   }
 }
 
 // src/commands/search.ts
 import ora5 from "ora";
-import pc9 from "picocolors";
+import pc10 from "picocolors";
 async function search(query, options) {
   const spinner = ora5("Fetching package registry...").start();
   let packages;
@@ -1290,15 +1464,15 @@ async function search(query, options) {
     spinner.fail("Failed to fetch registry");
     if (error instanceof RegistryError) {
       if (error.code === "NETWORK_ERROR" || error.code === "TIMEOUT") {
-        console.log(pc9.red(`
+        console.log(pc10.red(`
 Network error: ${error.message}`));
-        console.log(pc9.gray("Please check your internet connection and try again."));
+        console.log(pc10.gray("Please check your internet connection and try again."));
       } else {
-        console.log(pc9.red(`
+        console.log(pc10.red(`
 Error: ${error.message}`));
       }
     } else {
-      console.log(pc9.red(`
+      console.log(pc10.red(`
 Error: ${error instanceof Error ? error.message : "Unknown error"}`));
     }
     process.exit(1);
@@ -1312,10 +1486,10 @@ Error: ${error instanceof Error ? error.message : "Unknown error"}`));
   }
   if (entries.length === 0) {
     if (query) {
-      console.log(pc9.yellow(`
+      console.log(pc10.yellow(`
 No packages matching '${query}'`));
     } else {
-      console.log(pc9.yellow("\nNo packages available in the registry"));
+      console.log(pc10.yellow("\nNo packages available in the registry"));
     }
     return;
   }
@@ -1342,26 +1516,26 @@ No packages matching '${query}'`));
   const colName = 20;
   const colDesc = 44;
   const colVersions = 12;
-  console.log(pc9.bold("\nAvailable packages:\n"));
+  console.log(pc10.bold("\nAvailable packages:\n"));
   console.log(
-    pc9.gray(
+    pc10.gray(
       "PACKAGE".padEnd(colName) + "DESCRIPTION".padEnd(colDesc) + "VERSIONS".padEnd(colVersions) + "INSTALLED"
     )
   );
-  console.log(pc9.gray("\u2500".repeat(colName + colDesc + colVersions + 12)));
+  console.log(pc10.gray("\u2500".repeat(colName + colDesc + colVersions + 12)));
   for (const [name, info] of entries.sort(([a], [b]) => a.localeCompare(b))) {
     const desc = truncate(info.description, colDesc - 2);
     const versions = info.versions.join(", ");
     const installedVersion = installedVersions.get(name);
-    const status = installedVersion ? pc9.green(`\u2713 ${installedVersion}`) : "";
+    const status = installedVersion ? pc10.green(`\u2713 ${installedVersion}`) : "";
     console.log(
       name.padEnd(colName) + desc.padEnd(colDesc) + versions.padEnd(colVersions) + status
     );
   }
-  console.log(pc9.gray("\u2500".repeat(colName + colDesc + colVersions + 12)));
-  console.log(pc9.gray(`${entries.length} package${entries.length === 1 ? "" : "s"} available`));
+  console.log(pc10.gray("\u2500".repeat(colName + colDesc + colVersions + 12)));
+  console.log(pc10.gray(`${entries.length} package${entries.length === 1 ? "" : "s"} available`));
   console.log(`
-Install with: ${pc9.cyan("olore install <package>")}`);
+Install with: ${pc10.cyan("olore install <package>")}`);
 }
 function truncate(str, maxLen) {
   if (str.length <= maxLen) return str;
@@ -1373,12 +1547,12 @@ var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 var program = new Command();
 program.name("olore").description("Universal documentation for any AI coding agent").version(version).addHelpText("after", `
-${pc10.gray("May the Skill be with you.")}`);
+${pc11.gray("May the Skill be with you.")}`);
 program.command("init").description("Initialize a documentation package in the current directory").option("-n, --name <name>", "Package name (default: folder name)").option("-v, --version <version>", "Package version (default: latest)").option("-y, --yes", "Skip prompts, use defaults").action(async (options) => {
   try {
     await init(options);
   } catch (error) {
-    console.error(pc10.red(`Error: ${error.message}`));
+    console.error(pc11.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1386,7 +1560,7 @@ program.command("install <package>").alias("i").description("Install a documenta
   try {
     await install(pkg, options);
   } catch (error) {
-    console.error(pc10.red(`Error: ${error.message}`));
+    console.error(pc11.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1394,7 +1568,7 @@ program.command("link <path>").description("Link a local package for development
   try {
     await link(localPath);
   } catch (error) {
-    console.error(pc10.red(`Error: ${error.message}`));
+    console.error(pc11.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1402,7 +1576,7 @@ program.command("list").alias("ls").description("List installed documentation pa
   try {
     await list(options);
   } catch (error) {
-    console.error(pc10.red(`Error: ${error.message}`));
+    console.error(pc11.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1410,7 +1584,7 @@ program.command("search [query]").description("Search available packages in the
   try {
     await search(query, options);
   } catch (error) {
-    console.error(pc10.red(`Error: ${error.message}`));
+    console.error(pc11.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1418,7 +1592,7 @@ program.command("remove <package>").alias("rm").description("Remove an installed
   try {
     await remove(pkg);
   } catch (error) {
-    console.error(pc10.red(`Error: ${error.message}`));
+    console.error(pc11.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1426,7 +1600,7 @@ program.command("doctor").description("Check for issues with installed packages"
   try {
     await doctor(options);
   } catch (error) {
-    console.error(pc10.red(`Error: ${error.message}`));
+    console.error(pc11.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1434,7 +1608,15 @@ program.command("prune").description("Remove dangling symlinks, orphaned package
   try {
     await prune(options);
   } catch (error) {
-    console.error(pc10.red(`Error: ${error.message}`));
+    console.error(pc11.red(`Error: ${error.message}`));
+    process.exit(1);
+  }
+});
+program.command("inject").description("Inject compressed doc indexes into AGENTS.md and CLAUDE.md").option("--remove", "Remove injected content from project files").option("--json", "Output as JSON").action(async (options) => {
+  try {
+    await inject(options);
+  } catch (error) {
+    console.error(pc11.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1442,7 +1624,7 @@ program.command("order66").description(false).action(async () => {
   try {
     await order66();
   } catch (error) {
-    console.error(pc10.red(`Error: ${error.message}`));
+    console.error(pc11.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olorehq/olore",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Universal documentation for any AI coding agent",
   "keywords": [
     "ai",
@@ -11,14 +11,14 @@
     "context",
     "llm"
   ],
-  "license": "AGPL-3.0",
+  "license": "MIT",
   "author": "olorehq",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/olorehq/olore.git",
     "directory": "cli"
   },
-  "homepage": "https://github.com/olorehq/olore",
+  "homepage": "https://www.olore.dev",
   "type": "module",
   "files": [
     "dist"