@olorehq/olore 0.2.0 → 0.3.0

package/dist/cli.js

@@ -3,7 +3,7 @@
 // src/cli.ts
 import { createRequire } from "module";
 import { Command } from "commander";
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 
 // src/commands/doctor.ts
 import pc from "picocolors";
@@ -712,33 +712,42 @@ 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("")}`;
+function formatLibraryName(name) {
+  const specialNames = {
+    nextjs: "Next.js",
+    "nextjs-docs": "Next.js",
+    "t3-env": "T3 Env",
+    rhf: "React Hook Form",
+    "tanstack-query": "TanStack Query",
+    "tanstack-form": "TanStack Form",
+    "ms-agent-framework": "MS Agent Framework"
+  };
+  if (specialNames[name]) return specialNames[name];
+  return name.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).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) {
+  if (packages.length === 0) {
     return { content: "", count: 0 };
   }
-  const combined = [MARKER_START, COMPACT_HEADER, ...packageLines, MARKER_END].join("\n");
-  return { content: combined, count };
+  const rows = packages.map((pkg) => {
+    const library = formatLibraryName(pkg.name);
+    const version2 = pkg.version !== "latest" ? ` ${pkg.version}` : "";
+    const skillCommand = `/olore-${pkg.name}-${pkg.version}`;
+    return `| ${library}${version2} | \`${skillCommand}\` |`;
+  });
+  const lines = [
+    MARKER_START,
+    "## Documentation Reference",
+    "",
+    "Use these skill commands to access up-to-date documentation. Your training data may be outdated.",
+    "",
+    "| Library | Skill Command |",
+    "|---------|---------------|",
+    ...rows,
+    MARKER_END
+  ];
+  return { content: lines.join("\n"), count: packages.length };
 }
 function smartMerge(filePath, injectedContent) {
   if (!fs6.existsSync(filePath)) {
@@ -812,8 +821,8 @@ async function inject(options) {
       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."));
+    console.log(pc3.yellow("No installed packages found."));
+    console.log(pc3.gray("Run olore install <package> to install documentation packages."));
     return;
   }
   const filesWritten = [];
@@ -844,7 +853,7 @@ async function inject(options) {
 import path7 from "path";
 import fs7 from "fs-extra";
 import ora from "ora";
-import pc4 from "picocolors";
+import pc5 from "picocolors";
 
 // src/core/registry.ts
 var RegistryError = class extends Error {
@@ -923,6 +932,155 @@ async function resolveVersion(name, version2) {
   return versionInfo;
 }
 
+// src/core/version-check.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import pc4 from "picocolors";
+
+// package.json
+var package_default = {
+  name: "@olorehq/olore",
+  version: "0.3.0",
+  description: "Universal documentation for any AI coding agent",
+  keywords: [
+    "ai",
+    "documentation",
+    "claude",
+    "codex",
+    "coding-assistant",
+    "context",
+    "llm"
+  ],
+  license: "MIT",
+  author: "olorehq",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/olorehq/olore.git",
+    directory: "cli"
+  },
+  homepage: "https://www.olore.dev",
+  type: "module",
+  files: [
+    "dist"
+  ],
+  bin: {
+    olore: "dist/cli.js"
+  },
+  scripts: {
+    build: "tsup",
+    "build:bin": "bun build src/cli.ts --compile --outfile dist/olore",
+    "build:bin:all": "npm run build:bin:darwin-arm64 && npm run build:bin:darwin-x64 && npm run build:bin:linux-x64 && npm run build:bin:linux-arm64",
+    "build:bin:darwin-arm64": "bun build src/cli.ts --compile --target=bun-darwin-arm64 --outfile dist/olore-darwin-arm64",
+    "build:bin:darwin-x64": "bun build src/cli.ts --compile --target=bun-darwin-x64 --outfile dist/olore-darwin-x64",
+    "build:bin:linux-arm64": "bun build src/cli.ts --compile --target=bun-linux-arm64 --outfile dist/olore-linux-arm64",
+    "build:bin:linux-x64": "bun build src/cli.ts --compile --target=bun-linux-x64 --outfile dist/olore-linux-x64",
+    dev: "tsup --watch",
+    format: "prettier --write src/",
+    "format:check": "prettier --check src/",
+    lint: "eslint src/",
+    test: "vitest",
+    typecheck: "tsc --noEmit",
+    "generate-registry": "npx tsx scripts/generate-registry.ts"
+  },
+  dependencies: {
+    commander: "^12.1.0",
+    "fs-extra": "^11.3.3",
+    ora: "^9.0.0",
+    picocolors: "^1.1.1",
+    tar: "^7.4.3"
+  },
+  devDependencies: {
+    "@ianvs/prettier-plugin-sort-imports": "^4.7.0",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.10.7",
+    prettier: "^3.8.0",
+    "prettier-plugin-packagejson": "^2.5.22",
+    tsup: "^8.3.5",
+    typescript: "^5.7.3",
+    vitest: "^2.1.8"
+  },
+  engines: {
+    node: ">=18"
+  }
+};
+
+// src/core/version-check.ts
+var currentVersion = package_default.version;
+var NPM_REGISTRY = "https://registry.npmjs.org/@olorehq/olore";
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var CACHE_DIR = join(homedir(), ".olore");
+var CACHE_FILE = join(CACHE_DIR, "version-check.json");
+var FETCH_TIMEOUT = 3e3;
+function readCache() {
+  try {
+    if (existsSync(CACHE_FILE)) {
+      return JSON.parse(readFileSync(CACHE_FILE, "utf-8"));
+    }
+  } catch {
+  }
+  return null;
+}
+function writeCache(cache) {
+  try {
+    if (!existsSync(CACHE_DIR)) {
+      mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2));
+  } catch {
+  }
+}
+async function fetchLatestVersion() {
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT);
+    const response = await fetch(NPM_REGISTRY, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) return null;
+    const data = await response.json();
+    return data["dist-tags"]?.latest || null;
+  } catch {
+    return null;
+  }
+}
+function compareVersions(current, latest) {
+  const parseVersion = (v) => v.replace(/^v/, "").split(".").map((n) => parseInt(n, 10) || 0);
+  const curr = parseVersion(current);
+  const lat = parseVersion(latest);
+  for (let i = 0; i < 3; i++) {
+    if ((curr[i] || 0) < (lat[i] || 0)) return -1;
+    if ((curr[i] || 0) > (lat[i] || 0)) return 1;
+  }
+  return 0;
+}
+async function checkForUpdates() {
+  const cache = readCache();
+  const now = Date.now();
+  if (cache && now - cache.lastCheck < CHECK_INTERVAL_MS) {
+    if (cache.latestVersion && compareVersions(currentVersion, cache.latestVersion) < 0) {
+      printUpdateNotice(cache.latestVersion);
+    }
+    return;
+  }
+  const latestVersion = await fetchLatestVersion();
+  writeCache({
+    lastCheck: now,
+    latestVersion
+  });
+  if (latestVersion && compareVersions(currentVersion, latestVersion) < 0) {
+    printUpdateNotice(latestVersion);
+  }
+}
+function printUpdateNotice(latestVersion) {
+  console.log();
+  console.log(
+    pc4.yellow(`\u26A0\uFE0F  Update available: ${currentVersion} \u2192 ${latestVersion}`) + pc4.gray(` \u2014 Run `) + pc4.cyan(`npm update -g @olorehq/olore`) + pc4.gray(` to update`)
+  );
+}
+
 // src/commands/install.ts
 async function installFromLocal(localPath) {
   const fullPath = expandPath(localPath);
@@ -955,22 +1113,22 @@ async function installFromLocal(localPath) {
   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);
   }
-  console.log(pc4.bold(`
+  console.log(pc5.bold(`
 Installing ${packageName}@${packageVersion} from local path...
 `));
   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 olorePath = getOlorePackagePath(packageName, packageVersion);
@@ -978,7 +1136,7 @@ Installing ${packageName}@${packageVersion} from local path...
   await fs7.ensureDir(path7.dirname(olorePath));
   await fs7.remove(olorePath);
   await fs7.copy(fullPath, olorePath);
-  spinner.succeed(`Copied to ${pc4.gray(olorePath)}`);
+  spinner.succeed(`Copied to ${pc5.gray(olorePath)}`);
   const linkSpinner = ora("Linking to agent directories...").start();
   const linked = [];
   for (const [agent, skillsDir] of Object.entries(agentPaths)) {
@@ -986,22 +1144,23 @@ Installing ${packageName}@${packageVersion} from local path...
     await fs7.ensureDir(skillsDir);
     await fs7.remove(targetDir);
     await linkOrCopy(olorePath, targetDir);
-    linked.push(`${pc4.green("\u2713")} ${agent} ${pc4.gray("\u2192")} ${pc4.gray(targetDir)}`);
+    linked.push(`${pc5.green("\u2713")} ${agent} ${pc5.gray("\u2192")} ${pc5.gray(targetDir)}`);
   }
   linkSpinner.stop();
   linked.forEach((line) => console.log(`  ${line}`));
-  console.log(pc4.gray(`    \u2514\u2500 all linked to ${olorePath}`));
+  console.log(pc5.gray(`    \u2514\u2500 all linked to ${olorePath}`));
   console.log("");
-  console.log(pc4.green("Installation complete!"));
+  console.log(pc5.green("Installation 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)"));
+  await checkForUpdates();
 }
 async function install(pkg, options) {
   if (options.force) {
-    console.log(pc4.cyan("\n\u2728 May the Skill be with you.\n"));
+    console.log(pc5.cyan("\n\u2728 May the Skill be with you.\n"));
   }
   if (isLocalPath(pkg)) {
     await installFromLocal(pkg);
@@ -1047,7 +1206,7 @@ function findSimilarPackages(input, packages, maxResults = 3) {
 async function installFromRemote(pkg, optionsVersion) {
   const { name, version: specVersion } = parsePackageSpec(pkg);
   const requestedVersion = optionsVersion || specVersion || "latest";
-  console.log(pc4.bold(`
+  console.log(pc5.bold(`
 Installing ${name}@${requestedVersion} from registry...
 `));
   const spinner = ora("Fetching package info...").start();
@@ -1059,32 +1218,32 @@ Installing ${name}@${requestedVersion} from registry...
     spinner.fail("Failed to resolve package");
     if (error instanceof RegistryError) {
       if (error.code === "NOT_FOUND") {
-        console.log(pc4.yellow(`
+        console.log(pc5.yellow(`
 Package "${name}" not found in registry.`));
         try {
           const index = await fetchPackageIndex();
           const similar = findSimilarPackages(name, index.packages);
           if (similar.length > 0) {
-            console.log(pc4.bold("\nDid you mean?"));
+            console.log(pc5.bold("\nDid you mean?"));
             for (const pkg2 of similar) {
-              console.log(`  ${pc4.cyan(pkg2.name)}  ${pc4.gray("-")}  ${pc4.gray(pkg2.description)}`);
+              console.log(`  ${pc5.cyan(pkg2.name)}  ${pc5.gray("-")}  ${pc5.gray(pkg2.description)}`);
             }
           }
         } catch {
         }
         console.log(
-          pc4.gray("\nRun ") + pc4.cyan("olore search") + pc4.gray(" to see all available packages.")
+          pc5.gray("\nRun ") + pc5.cyan("olore search") + pc5.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(pc5.gray("\nFor local packages, use a path:"));
+        console.log(pc5.cyan(`  olore install ./vault/packages/${name}/<version>`));
         console.log("");
       } else if (error.code === "NETWORK_ERROR" || error.code === "TIMEOUT") {
-        console.log(pc4.red(`
+        console.log(pc5.red(`
 Network error: ${error.message}`));
-        console.log(pc4.gray("Please check your internet connection and try again."));
+        console.log(pc5.gray("Please check your internet connection and try again."));
       }
     } else {
-      console.log(pc4.red(`
+      console.log(pc5.red(`
 Error: ${error instanceof Error ? error.message : "Unknown error"}`));
     }
     process.exit(1);
@@ -1092,26 +1251,26 @@ Error: ${error instanceof Error ? error.message : "Unknown error"}`));
   const skillName = `olore-${name}-${versionInfo.version}`;
   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 olorePath = getOlorePackagePath(name, versionInfo.version);
   const downloadSpinner = ora("Downloading package...").start();
   try {
     await downloadAndInstall(versionInfo.downloadUrl, olorePath, versionInfo.integrity);
-    downloadSpinner.succeed(`Downloaded to ${pc4.gray(olorePath)}`);
+    downloadSpinner.succeed(`Downloaded to ${pc5.gray(olorePath)}`);
   } catch (error) {
     downloadSpinner.fail("Download failed");
     if (error instanceof DownloadError) {
       if (error.code === "CHECKSUM_MISMATCH") {
-        console.log(pc4.red("\nChecksum verification failed!"));
-        console.log(pc4.gray("The downloaded package may be corrupted or tampered with."));
+        console.log(pc5.red("\nChecksum verification failed!"));
+        console.log(pc5.gray("The downloaded package may be corrupted or tampered with."));
       } else {
-        console.log(pc4.red(`
+        console.log(pc5.red(`
 Download error: ${error.message}`));
       }
     } else {
-      console.log(pc4.red(`
+      console.log(pc5.red(`
 Error: ${error instanceof Error ? error.message : "Unknown error"}`));
     }
     process.exit(1);
@@ -1123,25 +1282,26 @@ Error: ${error instanceof Error ? error.message : "Unknown error"}`));
     await fs7.ensureDir(skillsDir);
     await fs7.remove(targetDir);
     await linkOrCopy(olorePath, targetDir);
-    linked.push(`${pc4.green("\u2713")} ${agent} ${pc4.gray("\u2192")} ${pc4.gray(targetDir)}`);
+    linked.push(`${pc5.green("\u2713")} ${agent} ${pc5.gray("\u2192")} ${pc5.gray(targetDir)}`);
   }
   linkSpinner.stop();
   linked.forEach((line) => console.log(`  ${line}`));
-  console.log(pc4.gray(`    \u2514\u2500 all linked to ${olorePath}`));
+  console.log(pc5.gray(`    \u2514\u2500 all linked to ${olorePath}`));
   console.log("");
-  console.log(pc4.green("Installation complete!"));
+  console.log(pc5.green("Installation 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)"));
+  await checkForUpdates();
 }
 
 // src/commands/link.ts
 import path8 from "path";
 import fs8 from "fs-extra";
 import ora2 from "ora";
-import pc5 from "picocolors";
+import pc6 from "picocolors";
 async function link(localPath) {
   const fullPath = expandPath(localPath);
   if (!await fs8.pathExists(fullPath)) {
@@ -1173,22 +1333,22 @@ async function link(localPath) {
   const nameMatch = skillContent.match(/^name:\s*(.+)$/m);
   const skillMdName = nameMatch ? nameMatch[1].trim() : null;
   if (skillMdName !== skillName) {
-    console.log(pc5.yellow(`
+    console.log(pc6.yellow(`
 Warning: SKILL.md name mismatch`));
-    console.log(pc5.gray(`  Expected: ${skillName}`));
-    console.log(pc5.gray(`  Found:    ${skillMdName || "(none)"}`));
-    console.log(pc5.yellow(`  Updating SKILL.md to fix...`));
+    console.log(pc6.gray(`  Expected: ${skillName}`));
+    console.log(pc6.gray(`  Found:    ${skillMdName || "(none)"}`));
+    console.log(pc6.yellow(`  Updating SKILL.md to fix...`));
     const updatedContent = skillMdName ? skillContent.replace(/^name:\s*.+$/m, `name: ${skillName}`) : skillContent.replace(/^---\n/, `---
 name: ${skillName}
 `);
     await fs8.writeFile(skillPath, updatedContent);
   }
-  console.log(pc5.bold(`
+  console.log(pc6.bold(`
 Linking ${packageName}@${packageVersion}...
 `));
   const agents = detectAgents();
   if (agents.length === 0) {
-    console.log(pc5.yellow("No agents detected. Creating directories anyway."));
+    console.log(pc6.yellow("No agents detected. Creating directories anyway."));
   }
   const agentPaths = getAgentPaths();
   const spinner = ora2(`${getLinkActionText()}...`).start();
@@ -1198,34 +1358,34 @@ Linking ${packageName}@${packageVersion}...
     await fs8.ensureDir(skillsDir);
     await fs8.remove(targetDir);
     await linkOrCopy(fullPath, targetDir);
-    linked.push(`${pc5.blue("\u26D3")} ${agent} ${pc5.gray("\u2192")} ${pc5.gray(targetDir)}`);
+    linked.push(`${pc6.blue("\u26D3")} ${agent} ${pc6.gray("\u2192")} ${pc6.gray(targetDir)}`);
   }
   spinner.stop();
   linked.forEach((line) => console.log(`  ${line}`));
-  console.log(pc5.gray(`    \u2514\u2500 ${getLinkTypeText()} ${fullPath}`));
+  console.log(pc6.gray(`    \u2514\u2500 ${getLinkTypeText()} ${fullPath}`));
   console.log("");
-  console.log(pc5.blue("Link complete!"));
+  console.log(pc6.blue("Link complete!"));
   console.log("");
-  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(pc6.gray("Skill is now available as:"));
+  console.log(pc6.cyan(`  /${skillName}`) + pc6.gray(" (Claude Code)"));
+  console.log(pc6.cyan(`  $${skillName}`) + pc6.gray(" (Codex)"));
+  console.log(pc6.cyan(`  ${skillName}`) + pc6.gray(" (OpenCode)"));
   console.log("");
-  console.log(pc5.gray(`Development mode: ${getLinkTypeText()} source (bypasses ~/.olore).`));
-  console.log(pc5.gray("Changes to source are immediately visible."));
+  console.log(pc6.gray(`Development mode: ${getLinkTypeText()} source (bypasses ~/.olore).`));
+  console.log(pc6.gray("Changes to source are immediately visible."));
   console.log(
-    pc5.gray("Use ") + pc5.cyan("olore install") + pc5.gray(" for a stable copy in ~/.olore.")
+    pc6.gray("Use ") + pc6.cyan("olore install") + pc6.gray(" for a stable copy in ~/.olore.")
   );
 }
 
 // src/commands/list.ts
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 async function list(options) {
   const packages = await getInstalledPackages();
   if (packages.length === 0) {
-    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.`);
+    console.log(pc7.yellow("\nI find your lack of skills disturbing.\n"));
+    console.log(pc7.gray("No packages installed."));
+    console.log(`Run ${pc7.cyan("olore install <package>")} to install documentation.`);
     return;
   }
   if (options.json) {
@@ -1233,29 +1393,29 @@ async function list(options) {
     console.log(JSON.stringify({ packages, issueCount: issues2.length }, null, 2));
     return;
   }
-  console.log(pc6.bold("\nInstalled packages:\n"));
+  console.log(pc7.bold("\nInstalled packages:\n"));
   console.log(
-    pc6.gray(
+    pc7.gray(
       "PACKAGE".padEnd(25) + "VERSION".padEnd(12) + "TYPE".padEnd(10) + "FILES".padStart(8) + "SIZE".padStart(12)
     )
   );
-  console.log(pc6.gray("-".repeat(67)));
+  console.log(pc7.gray("-".repeat(67)));
   for (const pkg of packages) {
-    const typeLabel = pkg.installType === "linked" ? pc6.blue("linked") : pkg.installType;
+    const typeLabel = pkg.installType === "linked" ? pc7.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(pc6.gray("-".repeat(67)));
-  console.log(pc6.gray(`Total: ${packages.length} packages`));
+  console.log(pc7.gray("-".repeat(67)));
+  console.log(pc7.gray(`Total: ${packages.length} packages`));
   console.log("");
-  console.log(pc6.gray("Types: installed = in ~/.olore, linked = dev symlink, copied = legacy"));
+  console.log(pc7.gray("Types: installed = in ~/.olore, linked = dev symlink, copied = legacy"));
   const { issues } = await diagnose();
   if (issues.length > 0) {
     console.log("");
     console.log(
-      pc6.yellow(
-        `\u26A0 ${issues.length} issue${issues.length === 1 ? "" : "s"} detected. Run ${pc6.cyan("olore doctor")} for details.`
+      pc7.yellow(
+        `\u26A0 ${issues.length} issue${issues.length === 1 ? "" : "s"} detected. Run ${pc7.cyan("olore doctor")} for details.`
       )
     );
   }
@@ -1270,21 +1430,21 @@ function formatSize(bytes) {
 import path9 from "path";
 import fs9 from "fs-extra";
 import ora3 from "ora";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 async function order66() {
-  console.log(pc7.red("\n\u26A0\uFE0F  Execute Order 66?\n"));
-  console.log(pc7.yellow("This will remove ALL installed documentation packages."));
+  console.log(pc8.red("\n\u26A0\uFE0F  Execute Order 66?\n"));
+  console.log(pc8.yellow("This will remove ALL installed documentation packages."));
   const packages = await getInstalledPackages();
   if (packages.length === 0) {
-    console.log(pc7.gray("\nNo packages to remove. The Jedi are already gone."));
+    console.log(pc8.gray("\nNo packages to remove. The Jedi are already gone."));
     return;
   }
-  console.log(pc7.gray(`
+  console.log(pc8.gray(`
 Packages to be removed: ${packages.length}`));
   for (const pkg of packages) {
-    console.log(pc7.gray(`  - ${pkg.name}@${pkg.version}`));
+    console.log(pc8.gray(`  - ${pkg.name}@${pkg.version}`));
   }
-  console.log(pc7.red('\n"It will be done, my lord."\n'));
+  console.log(pc8.red('\n"It will be done, my lord."\n'));
   const spinner = ora3("Executing Order 66...").start();
   let removedCount = 0;
   const agentPaths = getAgentPaths();
@@ -1305,21 +1465,21 @@ Packages to be removed: ${packages.length}`));
     removedCount++;
   }
   spinner.succeed(`Removed ${removedCount} packages`);
-  console.log(pc7.gray("\nThe Jedi have been eliminated."));
+  console.log(pc8.gray("\nThe Jedi have been eliminated."));
 }
 
 // src/commands/prune.ts
-import pc8 from "picocolors";
+import pc9 from "picocolors";
 async function prune(options) {
   if (!options.json) {
-    console.log(pc8.bold("\nScanning for issues...\n"));
+    console.log(pc9.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(pc8.green("Nothing to prune. Everything is clean."));
+      console.log(pc9.green("Nothing to prune. Everything is clean."));
     }
     return;
   }
@@ -1329,14 +1489,14 @@ async function prune(options) {
       return;
     }
     console.log(
-      pc8.yellow(`Would remove ${issues.length} item${issues.length === 1 ? "" : "s"}:
+      pc9.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 ${pc8.cyan("olore prune")} (without --dry-run) to remove them.`);
+Run ${pc9.cyan("olore prune")} (without --dry-run) to remove them.`);
     return;
   }
   const result = await pruneIssues(issues);
@@ -1350,7 +1510,7 @@ Run ${pc8.cyan("olore prune")} (without --dry-run) to remove them.`);
     for (const entry of result.removed) {
       totalFreed += entry.freedBytes;
       console.log(
-        `  ${pc8.green("\u2713")} ${displayPath(entry.issue.path)} (${issueLabel(entry.issue.type)})`
+        `  ${pc9.green("\u2713")} ${displayPath(entry.issue.path)} (${issueLabel(entry.issue.type)})`
       );
     }
     if (totalFreed > 0) {
@@ -1361,12 +1521,12 @@ ${formatBytes(totalFreed)} freed.`);
   if (result.failed.length > 0) {
     console.log("");
     console.log(
-      pc8.red(
+      pc9.red(
         `Failed to remove ${result.failed.length} item${result.failed.length === 1 ? "" : "s"}:`
       )
     );
     for (const entry of result.failed) {
-      console.log(`  ${pc8.red("\u2717")} ${displayPath(entry.issue.path)}: ${entry.error}`);
+      console.log(`  ${pc9.red("\u2717")} ${displayPath(entry.issue.path)}: ${entry.error}`);
     }
   }
 }
@@ -1387,9 +1547,9 @@ function issueLabel(type) {
 import path10 from "path";
 import fs10 from "fs-extra";
 import ora4 from "ora";
-import pc9 from "picocolors";
+import pc10 from "picocolors";
 async function remove(pkg) {
-  console.log(pc9.bold(`
+  console.log(pc10.bold(`
 Removing ${pkg}...
 `));
   const packages = await getInstalledPackages();
@@ -1405,20 +1565,20 @@ Removing ${pkg}...
     return p.name === name;
   });
   if (matches.length === 0) {
-    console.error(pc9.red(`Package not found: ${pkg}`));
+    console.error(pc10.red(`Package not found: ${pkg}`));
     console.log("\nInstalled packages:");
     for (const p of packages) {
-      console.log(`  ${pc9.cyan(p.name)}@${p.version}`);
+      console.log(`  ${pc10.cyan(p.name)}@${p.version}`);
     }
     process.exit(1);
   }
   if (matches.length > 1 && !version2) {
-    console.error(pc9.red(`Multiple versions found for ${name}:`));
+    console.error(pc10.red(`Multiple versions found for ${name}:`));
     for (const p of matches) {
-      console.log(`  ${pc9.cyan(p.name)}@${p.version} (${p.installType})`);
+      console.log(`  ${pc10.cyan(p.name)}@${p.version} (${p.installType})`);
     }
     console.log(`
-Specify version: ${pc9.cyan(`olore remove ${name}@<version>`)}`);
+Specify version: ${pc10.cyan(`olore remove ${name}@<version>`)}`);
     process.exit(1);
   }
   const found = matches[0];
@@ -1430,29 +1590,29 @@ Specify version: ${pc9.cyan(`olore remove ${name}@<version>`)}`);
     const skillPath = path10.join(basePath, skillName);
     if (await fs10.pathExists(skillPath)) {
       await fs10.remove(skillPath);
-      removed.push(`${pc9.green("\u2713")} ${agent}`);
+      removed.push(`${pc10.green("\u2713")} ${agent}`);
     }
   }
   if (found.installType === "installed") {
     const olorePath = getOlorePackagePath(found.name, found.version);
     if (await fs10.pathExists(olorePath)) {
       await fs10.remove(olorePath);
-      removed.push(`${pc9.green("\u2713")} ~/.olore`);
+      removed.push(`${pc10.green("\u2713")} ~/.olore`);
     }
   }
   spinner.stop();
   if (removed.length === 0) {
-    console.log(pc9.yellow("No files found to remove."));
+    console.log(pc10.yellow("No files found to remove."));
   } else {
     removed.forEach((line) => console.log(`  ${line}`));
     console.log("");
-    console.log(pc9.green(`Removed ${found.name}@${found.version}`));
+    console.log(pc10.green(`Removed ${found.name}@${found.version}`));
   }
 }
 
 // src/commands/search.ts
 import ora5 from "ora";
-import pc10 from "picocolors";
+import pc11 from "picocolors";
 async function search(query, options) {
   const spinner = ora5("Fetching package registry...").start();
   let packages;
@@ -1464,15 +1624,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(pc10.red(`
+        console.log(pc11.red(`
 Network error: ${error.message}`));
-        console.log(pc10.gray("Please check your internet connection and try again."));
+        console.log(pc11.gray("Please check your internet connection and try again."));
       } else {
-        console.log(pc10.red(`
+        console.log(pc11.red(`
 Error: ${error.message}`));
       }
     } else {
-      console.log(pc10.red(`
+      console.log(pc11.red(`
 Error: ${error instanceof Error ? error.message : "Unknown error"}`));
     }
     process.exit(1);
@@ -1486,10 +1646,10 @@ Error: ${error instanceof Error ? error.message : "Unknown error"}`));
   }
   if (entries.length === 0) {
     if (query) {
-      console.log(pc10.yellow(`
+      console.log(pc11.yellow(`
 No packages matching '${query}'`));
     } else {
-      console.log(pc10.yellow("\nNo packages available in the registry"));
+      console.log(pc11.yellow("\nNo packages available in the registry"));
     }
     return;
   }
@@ -1516,26 +1676,27 @@ No packages matching '${query}'`));
   const colName = 20;
   const colDesc = 44;
   const colVersions = 12;
-  console.log(pc10.bold("\nAvailable packages:\n"));
+  console.log(pc11.bold("\nAvailable packages:\n"));
   console.log(
-    pc10.gray(
+    pc11.gray(
       "PACKAGE".padEnd(colName) + "DESCRIPTION".padEnd(colDesc) + "VERSIONS".padEnd(colVersions) + "INSTALLED"
     )
   );
-  console.log(pc10.gray("\u2500".repeat(colName + colDesc + colVersions + 12)));
+  console.log(pc11.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 ? pc10.green(`\u2713 ${installedVersion}`) : "";
+    const status = installedVersion ? pc11.green(`\u2713 ${installedVersion}`) : "";
     console.log(
       name.padEnd(colName) + desc.padEnd(colDesc) + versions.padEnd(colVersions) + status
     );
   }
-  console.log(pc10.gray("\u2500".repeat(colName + colDesc + colVersions + 12)));
-  console.log(pc10.gray(`${entries.length} package${entries.length === 1 ? "" : "s"} available`));
+  console.log(pc11.gray("\u2500".repeat(colName + colDesc + colVersions + 12)));
+  console.log(pc11.gray(`${entries.length} package${entries.length === 1 ? "" : "s"} available`));
   console.log(`
-Install with: ${pc10.cyan("olore install <package>")}`);
+Install with: ${pc11.cyan("olore install <package>")}`);
+  await checkForUpdates();
 }
 function truncate(str, maxLen) {
   if (str.length <= maxLen) return str;
@@ -1547,12 +1708,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", `
-${pc11.gray("May the Skill be with you.")}`);
+${pc12.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(pc11.red(`Error: ${error.message}`));
+    console.error(pc12.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1560,7 +1721,7 @@ program.command("install <package>").alias("i").description("Install a documenta
   try {
     await install(pkg, options);
   } catch (error) {
-    console.error(pc11.red(`Error: ${error.message}`));
+    console.error(pc12.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1568,7 +1729,7 @@ program.command("link <path>").description("Link a local package for development
   try {
     await link(localPath);
   } catch (error) {
-    console.error(pc11.red(`Error: ${error.message}`));
+    console.error(pc12.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1576,7 +1737,7 @@ program.command("list").alias("ls").description("List installed documentation pa
   try {
     await list(options);
   } catch (error) {
-    console.error(pc11.red(`Error: ${error.message}`));
+    console.error(pc12.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1584,7 +1745,7 @@ program.command("search [query]").description("Search available packages in the
   try {
     await search(query, options);
   } catch (error) {
-    console.error(pc11.red(`Error: ${error.message}`));
+    console.error(pc12.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1592,7 +1753,7 @@ program.command("remove <package>").alias("rm").description("Remove an installed
   try {
     await remove(pkg);
   } catch (error) {
-    console.error(pc11.red(`Error: ${error.message}`));
+    console.error(pc12.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1600,7 +1761,7 @@ program.command("doctor").description("Check for issues with installed packages"
   try {
     await doctor(options);
   } catch (error) {
-    console.error(pc11.red(`Error: ${error.message}`));
+    console.error(pc12.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1608,15 +1769,15 @@ program.command("prune").description("Remove dangling symlinks, orphaned package
   try {
     await prune(options);
   } catch (error) {
-    console.error(pc11.red(`Error: ${error.message}`));
+    console.error(pc12.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) => {
+program.command("inject").description("Inject documentation skill reference table 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}`));
+    console.error(pc12.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });
@@ -1624,7 +1785,7 @@ program.command("order66").description(false).action(async () => {
   try {
     await order66();
   } catch (error) {
-    console.error(pc11.red(`Error: ${error.message}`));
+    console.error(pc12.red(`Error: ${error.message}`));
     process.exit(1);
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olorehq/olore",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Universal documentation for any AI coding agent",
   "keywords": [
     "ai",