@olorehq/olore 0.3.1 → 0.4.0

package/README.md

@@ -7,17 +7,17 @@
 ██║   ██║██║     ██║   ██║██╔══██╗██╔══╝
 ╚██████╔╝███████╗╚██████╔╝██║  ██║███████╗
  ╚═════╝ ╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝
-        O(pen) Lore for AI Agents
+         Stop the hallucinations.
 ```
 
-Documentation package manager for AI coding agents. Local-first. Offline-ready.
+Version-pinned docs for AI coding agents. Local-first. Offline-ready.
 
 ## Quick Start
 
 ```bash
 npm install -g @olorehq/olore
 olore install prisma
-olore inject
+olore inject prisma
 ```
 
 That's it. Your agent now has Prisma docs. No hallucinations.
@@ -28,7 +28,7 @@ Your AI coding agent makes decisions about which tools to invoke. Sometimes it d
 
 **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.
+`olore inject` writes a skill reference table into your `AGENTS.md` / `CLAUDE.md`. Agents see which docs are available and invoke skills when needed — no guessing, no network calls.
 
 - **Version-pinned** — same docs, every run, every machine
 - **Offline** — works on planes, in CI, behind firewalls
@@ -37,26 +37,29 @@ Your AI coding agent makes decisions about which tools to invoke. Sometimes it d
 
 ## Available Packages
 
-`prisma` · `nextjs` · `zod` · `drizzle` · `langchain` · `tanstack-query` · `claude-code` · `codex` · `opencode` · `cargo` · `agentskills`
+`a2a` · `agentskills` · `astro` · `axiom` · `azure-sdk-js` · `cargo` · `checkly` · `claude-code` · `clerk` · `cloudflare` · `codex` · `convex` · `drizzle` · `github-actions` · `hono` · `langchain` · `lucia` · `neon` · `neverthrow` · `nextjs` · `openclaw` · `opencode` · `opennext` · `partykit` · `partyserver` · `posthog` · `prettier` · `prisma` · `rhf` · `sentry` · `supabase` · `t3-env` · `tanstack-query` · `trpc` · `tsf` · `turso` · `vitest` · `xstate` · `zod`
 
-More on the [registry](https://github.com/olorehq/olore). Contributions welcome.
+Browse all with `olore search`. Contributions welcome on [GitHub](https://github.com/olorehq/olore).
 
 ## Supported Agents
 
-- **Claude Code** — injects into `CLAUDE.md`
-- **Codex** — injects into `AGENTS.md`
-- **OpenCode** — injects into `AGENTS.md`
+- **Claude Code** — skills in `~/.claude/skills/`
+- **Codex** — skills in `~/.codex/skills/`
+- **OpenCode** — skills in `~/.config/opencode/skills/`
 
 ## Commands
 
 | Command | Description |
 |---|---|
 | `olore install <pkg>` | Install a documentation package |
-| `olore inject` | Inject doc indexes into AGENTS.md / CLAUDE.md |
+| `olore inject <pkg...>` | Write skill reference table into AGENTS.md / CLAUDE.md |
 | `olore inject --remove` | Remove injected content |
+| `olore init` | Auto-detect project deps and install matching docs |
+| `olore search [query]` | Browse available packages |
 | `olore list` | List installed packages |
 | `olore remove <pkg>` | Remove a package |
-| `olore search` | Browse available packages |
+| `olore link <path>` | Link a local package for development |
+| `olore prune` | Clean up dangling symlinks and orphaned packages |
 | `olore doctor` | Diagnose issues |
 
 ## Links

package/dist/cli.js

@@ -25,7 +25,8 @@ import fs from "fs-extra";
 import * as tar from "tar";
 
 // src/core/constants.ts
-var REGISTRY_URL = "https://olore.dev/registry";
+var REGISTRY_URL = "https://github.com/olorehq/olore/releases/download/registry/registry.json";
+var REGISTRY_FALLBACK_URL = "https://olore.dev/registry";
 var DOWNLOAD_TIMEOUT = 6e4;
 var USER_AGENT = "olore-cli/0.1.0";
 
@@ -925,8 +926,23 @@ async function fetchWithTimeout(url, timeout = DOWNLOAD_TIMEOUT) {
     clearTimeout(timeoutId);
   }
 }
-async function fetchPackageIndex() {
-  const url = `${REGISTRY_URL}/index.json`;
+var cachedRegistry = null;
+async function fetchCombinedRegistry() {
+  if (cachedRegistry) {
+    return cachedRegistry;
+  }
+  try {
+    const response2 = await fetchWithTimeout(REGISTRY_URL);
+    if (response2.ok) {
+      const data = await response2.json();
+      if (data.version === 2) {
+        cachedRegistry = data;
+        return cachedRegistry;
+      }
+    }
+  } catch {
+  }
+  const url = `${REGISTRY_FALLBACK_URL}/index.json`;
   const response = await fetchWithTimeout(url);
   if (response.status === 404) {
     throw new RegistryError("Registry not found", "NOT_FOUND");
@@ -934,15 +950,58 @@ async function fetchPackageIndex() {
   if (!response.ok) {
     throw new RegistryError(`Failed to fetch registry: ${response.status}`, "NETWORK_ERROR");
   }
+  let index;
   try {
-    const data = await response.json();
-    return data;
+    index = await response.json();
   } catch {
     throw new RegistryError("Invalid registry response", "INVALID_RESPONSE");
   }
+  const packages = {};
+  for (const [name, entry] of Object.entries(index.packages)) {
+    packages[name] = {
+      description: entry.description,
+      latest: entry.latest,
+      versions: {}
+      // populated on demand in fetchPackageVersions
+    };
+  }
+  cachedRegistry = {
+    version: 2,
+    updated: index.updated,
+    packages
+  };
+  return cachedRegistry;
+}
+async function fetchPackageIndex() {
+  const combined = await fetchCombinedRegistry();
+  const packages = {};
+  for (const [name, entry] of Object.entries(combined.packages)) {
+    packages[name] = {
+      description: entry.description,
+      latest: entry.latest,
+      versions: Object.keys(entry.versions).length > 0 ? Object.keys(entry.versions) : [entry.latest]
+    };
+  }
+  return {
+    version: combined.version,
+    updated: combined.updated,
+    packages
+  };
 }
 async function fetchPackageVersions(name) {
-  const url = `${REGISTRY_URL}/packages/${name}.json`;
+  const combined = await fetchCombinedRegistry();
+  const entry = combined.packages[name];
+  if (!entry) {
+    throw new RegistryError(`Package "${name}" not found in registry`, "NOT_FOUND");
+  }
+  if (Object.keys(entry.versions).length > 0) {
+    return {
+      name,
+      description: entry.description,
+      versions: entry.versions
+    };
+  }
+  const url = `${REGISTRY_FALLBACK_URL}/packages/${name}.json`;
   const response = await fetchWithTimeout(url);
   if (response.status === 404) {
     throw new RegistryError(`Package "${name}" not found in registry`, "NOT_FOUND");
@@ -952,7 +1011,9 @@ async function fetchPackageVersions(name) {
   }
   try {
     const data = await response.json();
-    return data;
+    const versions = data;
+    entry.versions = versions.versions;
+    return versions;
   } catch {
     throw new RegistryError("Invalid package response", "INVALID_RESPONSE");
   }
@@ -980,16 +1041,20 @@ import pc4 from "picocolors";
 // package.json
 var package_default = {
   name: "@olorehq/olore",
-  version: "0.3.1",
-  description: "Universal documentation for any AI coding agent",
+  version: "0.4.0",
+  description: "Version-pinned docs for AI coding agents. Offline. Local-first.",
   keywords: [
     "ai",
     "documentation",
     "claude",
     "codex",
+    "opencode",
     "coding-assistant",
     "context",
-    "llm"
+    "llm",
+    "skills",
+    "agents-md",
+    "claude-md"
   ],
   license: "MIT",
   author: "olorehq",
@@ -1746,7 +1811,7 @@ function truncate(str, maxLen) {
 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", `
+program.name("olore").description("Version-pinned docs for AI coding agents").version(version).addHelpText("after", `
 ${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 {

package/package.json

@@ -1,15 +1,19 @@
 {
   "name": "@olorehq/olore",
-  "version": "0.3.1",
-  "description": "Universal documentation for any AI coding agent",
+  "version": "0.4.0",
+  "description": "Version-pinned docs for AI coding agents. Offline. Local-first.",
   "keywords": [
     "ai",
     "documentation",
     "claude",
     "codex",
+    "opencode",
     "coding-assistant",
     "context",
-    "llm"
+    "llm",
+    "skills",
+    "agents-md",
+    "claude-md"
   ],
   "license": "MIT",
   "author": "olorehq",