compend 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to Compend will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2026-06-28
+
+### Removed
+- opencode.json auto-discovery from `getIndexPaths()`. Compend no longer
+  reads opencode.json for `skills.paths` or `instructions[]`. All index
+  paths now come from `~/.compend/config.json` → `index.paths`. If you
+  previously relied on auto-discovery, add your paths to the compend
+  config file.
+
+### Changed
+- `getIndexPaths()` reads only `~/.compend/config.json` — zero tool
+  dependencies. Compend works identically with Claude, Copilot, openCode,
+  Codex, or standalone.
+
 ## [1.0.0] - 2026-06-27
 
 ### Added
@@ -20,11 +34,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 7 extensible concept types: skill, agent, instruction, prompt, workflow, reference, knowledge
 - Type schemas in config.js with per-type status validation (matching Hemisphere's kind schema pattern)
 - OKF frontmatter parsing (YAML + markdown body) with automatic type inference
-- Auto-index on first run from opencode.json `skills.paths` + `instructions`
+- Auto-index on first run from ~/.compend/config.json `index.paths`
 - Parent/child concept resolution via slug hierarchy (file path convention)
 - Dependency resolution from OKF frontmatter `dependencies` field
 - `~/.compend/config.json` config with env var overrides (`COMPEND_PORT`, `COMPEND_DB_PATH`)
-- Index paths from opencode.json auto-discovery + `~/.compend/config.json` overrides
+- Index paths from `~/.compend/config.json` `index.paths`
 
 ## [0.0.1] - 2026-06-27
 

package/README.md

@@ -95,7 +95,7 @@ npm link  # creates global compend command
 
 Find your exact path with `npm root -g` — append `/compend/index.js`.
 
-Concepts are discovered automatically from your opencode.json `skills.paths` and `instructions` directories. Add custom project knowledge bundles via `~/.compend/config.json`.
+Concepts are discovered from paths configured in `~/.compend/config.json` → `index.paths`. Add custom project knowledge bundles and skill directories there.
 
 ## Updating
 
@@ -261,7 +261,7 @@ Create an optional JSON config file to customize operational settings. All keys
 | `dashboard.paginationLimit` | number | `50` | Default page size for dashboard API |
 | `dashboard.maxLimit` | number | `200` | Hard cap on API page size |
 | `schemas.default.types` | object | built-in set | Type definitions with `statuses` and `defaults` |
-| `index.paths` | string[] | `[]` | Additional paths to scan for `.md` files (appended to opencode auto-discovered paths) |
+| `index.paths` | string[] | `[]` | Paths to scan for `.md` files. These are the only paths Compend indexes. Add skill directories, knowledge bundles, and convention files here. |
 
 ### Environment Variables
 
@@ -272,21 +272,25 @@ Create an optional JSON config file to customize operational settings. All keys
 
 ### Path Discovery
 
-Compend auto-discovers filesystem paths from your opencode.json:
-
-1. `skills.paths` — skill directories (scanned recursively for `*.md`)
-2. `instructions` — instruction files (indexed directly)
-
-Additional paths can be added via `index.paths` in `~/.compend/config.json`. This is where you add project OKF knowledge bundles:
+Compend indexes only paths configured in `~/.compend/config.json` →
+`index.paths`. No tool configs are read — Compend is tool-agnostic and
+works identically with any AI client.
 
 ```json
 {
   "index": {
-    "paths": ["/home/user/projects/my-project/knowledge"]
+    "paths": [
+      "/home/user/.github/skills",
+      "/home/user/projects/my-project/knowledge"
+    ]
   }
 }
 ```
 
+Each path is scanned recursively for `.md` files on `compend_index`.
+Add skill directories, OKF knowledge bundles, and convention file
+directories here.
+
 ## Architecture
 
 ### Embedding

package/config.js

@@ -106,32 +106,6 @@ export function resolveTypeSchema(type) {
 export function getIndexPaths() {
   const paths = [];
 
-  try {
-    const opencodePaths = [
-      join(homedir(), '.config', 'opencode', 'opencode.json'),
-    ];
-    for (const p of opencodePaths) {
-      if (existsSync(p)) {
-        const raw = readFileSync(p, 'utf-8').trim();
-        if (raw) {
-          const cfg = JSON.parse(raw);
-          if (cfg.skills && Array.isArray(cfg.skills.paths)) {
-            for (const sp of cfg.skills.paths) {
-              paths.push(resolveTilde(sp));
-            }
-          }
-          if (cfg.instructions && Array.isArray(cfg.instructions)) {
-            for (const ip of cfg.instructions) {
-              paths.push(resolveTilde(ip));
-            }
-          }
-        }
-      }
-    }
-  } catch (e) {
-    console.warn('Compend: could not read opencode.json:', e.message);
-  }
-
   try {
     const compendCfg = readConfigFile();
     if (compendCfg.index && Array.isArray(compendCfg.index.paths)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "compend",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A reference engine for AI agents. Index your Markdown skills with hybrid search and dynamic context.",
   "author": "Hector Jarquin",
   "type": "module",