@bodhi-ventures/aiocs 0.1.0 → 0.1.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 jmucha
+Copyright (c) 2026 Bodhi Ventures
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -111,17 +111,15 @@ GitHub Actions publishes `@bodhi-ventures/aiocs` publicly to npm and creates the
 
 For Codex-first setup, automatic-use guidance, MCP recommendations, and subagent examples, see [docs/codex-integration.md](./docs/codex-integration.md).
 
-## Built-in sources
+## Managed sources
 
-Initial source specs are shipped in `sources/`:
+The open-source repo bundles `hyperliquid` in `sources/`. Additional machine-local source specs
+belong in `~/.aiocs/sources`.
 
-- `synthetix`
-- `hyperliquid`
-- `lighter`
-- `nado`
-- `ethereal`
+`docs init` bootstraps both managed locations, so source behavior is the same regardless of
+whether a spec lives in the repo or in `~/.aiocs/sources`.
 
-Bootstrap them in one command:
+Bootstrap managed sources in one command:
 
 ```bash
 docs init --no-fetch
@@ -416,7 +414,7 @@ Successful MCP results use an envelope:
   "ok": true,
   "data": {
     "name": "@bodhi-ventures/aiocs",
-    "version": "0.1.0"
+    "version": "0.1.1"
   }
 }
 ```

package/dist/{chunk-ID3PUSMY.js → chunk-AJ5NZDK4.js}

@@ -3208,7 +3208,7 @@ async function startDaemon(input) {
 // package.json
 var package_default = {
   name: "@bodhi-ventures/aiocs",
-  version: "0.1.0",
+  version: "0.1.1",
   license: "MIT",
   type: "module",
   description: "Local-only documentation store, fetcher, and search CLI for AI agents.",
@@ -4398,14 +4398,19 @@ async function verifyCoverage(input) {
     return verifyCoverageAgainstReferences(corpus, input.referenceFiles);
   });
 }
-async function initBuiltInSources(options) {
-  const sourceSpecDir = options?.sourceSpecDir ?? getBundledSourcesDir();
+async function initManagedSources(options) {
+  const sourceSpecDirs = uniqueResolvedPaths(
+    options?.sourceSpecDirs ?? [
+      getBundledSourcesDir(),
+      getAiocsSourcesDir()
+    ]
+  );
   const fetched = options?.fetch ?? false;
   const userSourceDir = getAiocsSourcesDir();
   return withCatalog(async ({ catalog, dataDir }) => {
     const bootstrapped = await bootstrapSourceSpecs({
       catalog,
-      sourceSpecDirs: [sourceSpecDir],
+      sourceSpecDirs,
       strictSourceSpecDirs: true
     });
     const fetchResults = [];
@@ -4429,7 +4434,7 @@ async function initBuiltInSources(options) {
       });
     }
     return {
-      sourceSpecDir,
+      sourceSpecDirs,
       userSourceDir,
       fetched,
       initializedSources: bootstrapped.sources,
@@ -4523,7 +4528,7 @@ export {
   searchCatalog,
   showChunk,
   verifyCoverage,
-  initBuiltInSources,
+  initManagedSources,
   getManagedSourceSpecDirectories,
   getDoctorReport,
   exportCatalogBackup,

package/dist/cli.js

@@ -13,7 +13,7 @@ import {
   getEmbeddingStatus,
   getManagedSourceSpecDirectories,
   importCatalogBackup,
-  initBuiltInSources,
+  initManagedSources,
   linkProjectSources,
   listSnapshotsForSource,
   listSources,
@@ -31,7 +31,7 @@ import {
   unlinkProjectSources,
   upsertSourceFromSpecFile,
   verifyCoverage
-} from "./chunk-ID3PUSMY.js";
+} from "./chunk-AJ5NZDK4.js";
 
 // src/cli.ts
 import { Command, CommanderError as CommanderError2 } from "commander";
@@ -289,21 +289,22 @@ program.command("version").description("Show the current aiocs version.").action
     human: packageVersion
   }));
 });
-program.command("init").description("Register bundled built-in source specs and optionally fetch them.").option("--fetch", "fetch built-in sources immediately").option("--no-fetch", "skip immediate fetching after bootstrapping").action(async (options, command) => {
+program.command("init").description("Register managed source specs from the bundled repo directory and ~/.aiocs/sources, then optionally fetch them.").option("--fetch", "fetch managed sources immediately").option("--no-fetch", "skip immediate fetching after bootstrapping").action(async (options, command) => {
   await executeCommand(command, "init", async () => {
-    const result = await initBuiltInSources({
+    const result = await initManagedSources({
       fetch: options.fetch ?? false
     });
     return {
       data: result,
       human: [
-        `Initialized ${result.initializedSources.length} built-in sources from ${result.sourceSpecDir}`,
+        `Initialized ${result.initializedSources.length} managed sources from ${result.sourceSpecDirs.length} directories`,
+        ...result.sourceSpecDirs.map((directory) => `Managed source dir: ${directory}`),
         `User-managed source specs live under ${getManagedSourceSpecDirectories().userSourceDir}`,
         ...result.removedSourceIds.length > 0 ? [`Removed managed sources: ${result.removedSourceIds.join(", ")}`] : [],
         ...result.fetchResults.length > 0 ? result.fetchResults.map((entry) => {
           const verb = entry.reused ? "Reused" : "Fetched";
           return `${verb} ${entry.sourceId} -> ${entry.snapshotId} (${entry.pageCount} pages)`;
-        }) : [result.fetched ? "No built-in sources were fetched." : "Skipped fetching built-in sources."]
+        }) : [result.fetched ? "No managed sources were fetched." : "Skipped fetching managed sources."]
       ]
     };
   });

package/dist/mcp-server.js

@@ -10,7 +10,7 @@ import {
   getDoctorReport,
   getEmbeddingStatus,
   importCatalogBackup,
-  initBuiltInSources,
+  initManagedSources,
   linkProjectSources,
   listSnapshotsForSource,
   listSources,
@@ -26,7 +26,7 @@ import {
   unlinkProjectSources,
   upsertSourceFromSpecFile,
   verifyCoverage
-} from "./chunk-ID3PUSMY.js";
+} from "./chunk-AJ5NZDK4.js";
 
 // src/mcp-server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -235,7 +235,7 @@ var toolHandlers = {
     version: packageVersion
   }),
   doctor: async () => getDoctorReport(),
-  init: async (args = {}) => initBuiltInSources({
+  init: async (args = {}) => initManagedSources({
     ...typeof args.fetch === "boolean" ? { fetch: args.fetch } : {}
   }),
   source_upsert: async (args = {}) => upsertSourceFromSpecFile(args.specFile),
@@ -350,12 +350,12 @@ registerAiocsTool(
   "init",
   {
     title: "Init",
-    description: "Bootstrap the bundled built-in source specs and optionally fetch them.",
+    description: "Bootstrap managed source specs from the bundled repo directory and ~/.aiocs/sources, then optionally fetch them.",
     inputSchema: z.object({
       fetch: z.boolean().optional()
     }),
     outputSchema: z.object({
-      sourceSpecDir: z.string(),
+      sourceSpecDirs: z.array(z.string()),
       userSourceDir: z.string(),
       fetched: z.boolean(),
       initializedSources: z.array(z.object({

package/docs/2026-03-28-hybrid-search-design.md

@@ -24,7 +24,7 @@ This design keeps `aiocs` as the canonical docs system:
 
 ## Why This Shape
 
-The current `aiocs` search path in [catalog.ts](/Users/jmucha/repos/mandex/aiocs/src/catalog/catalog.ts) is pure FTS5 BM25 over the latest successful snapshots. That is excellent for exact docs lookups, versioned terms, and API names. It is weaker for:
+The current `aiocs` search path in [catalog.ts](../src/catalog/catalog.ts) is pure FTS5 BM25 over the latest successful snapshots. That is excellent for exact docs lookups, versioned terms, and API names. It is weaker for:
 
 - synonym-heavy prompts
 - conceptual questions

package/docs/codex-integration.md

@@ -38,8 +38,9 @@ Codex does not automatically invoke a custom subagent just because one exists. T
 To make Codex discover `aiocs` automatically on this machine, expose the skill in the global Codex skill directory:
 
 ```bash
+AIOCS_REPO=/absolute/path/to/your/aiocs/checkout
 mkdir -p ~/.codex/skills
-ln -sfn /Users/jmucha/repos/mandex/aiocs/skills/aiocs ~/.codex/skills/aiocs
+ln -sfn "$AIOCS_REPO/skills/aiocs" ~/.codex/skills/aiocs
 ```
 
 Once that symlink exists, Codex can load the `aiocs` skill directly from the global skills catalog and prefer local docs without you explicitly calling a subagent.
@@ -49,17 +50,18 @@ Once that symlink exists, Codex can load the `aiocs` skill directly from the glo
 There are two supported subagent patterns:
 
 - Repo example for development and debugging:
-  [`docs/examples/codex-agents/aiocs-docs-specialist.example.toml`](/Users/jmucha/repos/mandex/aiocs/docs/examples/codex-agents/aiocs-docs-specialist.example.toml)
+  [`docs/examples/codex-agents/aiocs-docs-specialist.example.toml`](examples/codex-agents/aiocs-docs-specialist.example.toml)
 - Install-ready global agent definition:
-  [`/Users/jmucha/repos/ai-skills/agents/aiocs-docs-specialist.toml`](/Users/jmucha/repos/ai-skills/agents/aiocs-docs-specialist.toml)
+  `ai-skills/agents/aiocs-docs-specialist.toml` from your local `ai-skills` checkout
 
 The repo example is intentionally development-oriented and uses a checkout-local MCP command. The global agent points at the globally installed `aiocs-mcp` binary.
 
 To expose the install-ready global agent to Codex on this machine:
 
 ```bash
+AI_SKILLS_REPO=/absolute/path/to/your/ai-skills/checkout
 mkdir -p ~/.codex/agents
-ln -sfn /Users/jmucha/repos/ai-skills/agents/aiocs-docs-specialist.toml ~/.codex/agents/aiocs-docs-specialist.toml
+ln -sfn "$AI_SKILLS_REPO/agents/aiocs-docs-specialist.toml" ~/.codex/agents/aiocs-docs-specialist.toml
 ```
 
 ## Suggested Codex flows

package/docs/json-contract.md

@@ -73,7 +73,7 @@ This section documents the stable top-level `data` payload per command.
 ```json
 {
   "name": "@bodhi-ventures/aiocs",
-  "version": "0.1.0"
+  "version": "0.1.1"
 }
 ```
 
@@ -81,7 +81,11 @@ This section documents the stable top-level `data` payload per command.
 
 ```json
 {
-  "sourceSpecDir": "/absolute/path/to/aiocs/sources",
+  "sourceSpecDirs": [
+    "/absolute/path/to/aiocs/sources",
+    "<home>/.aiocs/sources"
+  ],
+  "userSourceDir": "<home>/.aiocs/sources",
   "fetched": false,
   "initializedSources": [
     {
@@ -402,7 +406,7 @@ Summary status values:
   "manifest": {
     "formatVersion": 1,
     "createdAt": "2026-03-26T10:00:00.000Z",
-    "packageVersion": "0.1.0",
+    "packageVersion": "0.1.1",
     "entries": [
       {
         "relativePath": "data/catalog.sqlite",
@@ -419,12 +423,12 @@ Summary status values:
 ```json
 {
   "inputDir": "/absolute/path/to/backup",
-  "dataDir": "/Users/example/.aiocs/data",
-  "configDir": "/Users/example/.aiocs/config",
+  "dataDir": "<home>/.aiocs/data",
+  "configDir": "<home>/.aiocs/config",
   "manifest": {
     "formatVersion": 1,
     "createdAt": "2026-03-26T10:00:00.000Z",
-    "packageVersion": "0.1.0",
+    "packageVersion": "0.1.1",
     "entries": []
   }
 }
@@ -495,7 +499,7 @@ Successful MCP tool results:
   "ok": true,
   "data": {
     "name": "@bodhi-ventures/aiocs",
-    "version": "0.1.0"
+    "version": "0.1.1"
   }
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bodhi-ventures/aiocs",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "MIT",
   "type": "module",
   "description": "Local-only documentation store, fetcher, and search CLI for AI agents.",

package/skills/aiocs/SKILL.md

@@ -17,7 +17,7 @@ Use this skill when you need authoritative local documentation search, inspectio
 
 - Prefer `aiocs` before live web browsing when the requested docs may already be in the local catalog.
 - Check `source_list` or scoped `search` before assuming a source is missing.
-- Use `aiocs` first for supported built-in sources and for any repo or machine that already relies on `~/.aiocs`.
+- Use `aiocs` first for the bundled `hyperliquid` source and for any repo or machine that already relies on `~/.aiocs`.
 - If a source is missing, only add it when it is worth curating for future reuse.
 - Prefer `refresh due <source-id>` over force `fetch <source-id>` whenever freshness is the real goal.
 - Do not use `fetch all` as a normal answering path; reserve it for explicit user requests or maintenance flows.
@@ -49,7 +49,7 @@ Validate the local runtime:
 docs --json doctor
 ```
 
-Bootstrap the bundled built-in sources:
+Bootstrap managed sources from the repo bundle and `~/.aiocs/sources`:
 
 ```bash
 docs --json init --no-fetch
@@ -170,5 +170,5 @@ The `aiocs-mcp` server exposes the same core operations without shell parsing:
 - Newly added or changed sources become due immediately, so `refresh due <source-id>` is the safe first refresh path after upsert.
 - CLI failures expose machine-readable `error.code` fields in `--json` mode.
 - MCP tool results use `{ ok, data?, error? }` envelopes, and `batch` can reduce multiple small MCP round trips.
-- For exact CLI payloads, see `/Users/jmucha/repos/mandex/aiocs/docs/json-contract.md`.
-- For Codex setup and subagent examples, see `/Users/jmucha/repos/mandex/aiocs/docs/codex-integration.md`.
+- For exact CLI payloads, see `docs/json-contract.md`.
+- For Codex setup and subagent examples, see `docs/codex-integration.md`.

package/sources/ethereal.yaml

@@ -1,20 +0,0 @@
-id: ethereal
-label: Ethereal Docs
-startUrls:
-  - https://docs.ethereal.trade/
-allowedHosts:
-  - docs.ethereal.trade
-discovery:
-  include:
-    - https://docs.ethereal.trade/**
-  exclude: []
-  maxPages: 500
-extract:
-  strategy: clipboardButton
-  interactions:
-    - action: click
-      selector: button[aria-label="Copy page"]
-normalize:
-  prependSourceComment: true
-schedule:
-  everyHours: 24

package/sources/lighter.yaml

@@ -1,24 +0,0 @@
-id: lighter
-label: Lighter Docs
-startUrls:
-  - https://apidocs.lighter.xyz/docs/get-started
-  - https://apidocs.lighter.xyz/reference/status
-allowedHosts:
-  - apidocs.lighter.xyz
-discovery:
-  include:
-    - https://apidocs.lighter.xyz/docs/**
-    - https://apidocs.lighter.xyz/reference/**
-  exclude: []
-  maxPages: 800
-extract:
-  strategy: clipboardButton
-  interactions:
-    - action: click
-      selector: 'button:has-text("Ask AI")'
-    - action: click
-      selector: 'div[role="button"]:has-text("Copy Markdown")'
-normalize:
-  prependSourceComment: true
-schedule:
-  everyHours: 24

package/sources/nado.yaml

@@ -1,22 +0,0 @@
-id: nado
-label: Nado Docs
-startUrls:
-  - https://docs.nado.xyz/
-allowedHosts:
-  - docs.nado.xyz
-discovery:
-  include:
-    - https://docs.nado.xyz/**
-  exclude: []
-  maxPages: 500
-extract:
-  strategy: clipboardButton
-  interactions:
-    - action: click
-      selector: button[aria-label="More"]
-    - action: click
-      selector: '[role="menuitem"]:has-text("Copy page")'
-normalize:
-  prependSourceComment: true
-schedule:
-  everyHours: 24

package/sources/synthetix.yaml

@@ -1,24 +0,0 @@
-id: synthetix
-label: Synthetix Docs
-startUrls:
-  - https://developers.synthetix.io/
-allowedHosts:
-  - developers.synthetix.io
-discovery:
-  include:
-    - https://developers.synthetix.io/**
-  exclude: []
-  maxPages: 500
-extract:
-  strategy: clipboardButton
-  interactions:
-    - action: hover
-      selector: .vocs_AiCtaDropdown
-    - action: click
-      selector: .vocs_AiCtaDropdown_buttonRight
-    - action: click
-      selector: '[role="menuitem"]:has-text("Copy")'
-normalize:
-  prependSourceComment: true
-schedule:
-  everyHours: 24