opencode-knowledge 0.5.0 → 0.5.1

package/README.md

@@ -150,9 +150,33 @@ Your knowledge content here...
 | `tags`               | Yes      | Array of searchable tags                                             |
 | `description`        | Yes      | Brief summary (used in search results)                               |
 | `category`           | Yes      | Category for organization (e.g., `frontend`, `backend`, `standards`) |
-| `required_knowledge` | No       | Other packages that should be loaded first                           |
+| `required_knowledge` | No       | Other packages that should be loaded automatically before this one (supports recursive dependencies)   |
 | `file_patterns`      | No       | File patterns where this knowledge applies (not yet implemented)     |
 
+### Dependency Loading
+
+The `required_knowledge` field enables automatic dependency loading. When you load a package, the plugin automatically loads all its dependencies first, recursively.
+
+**Example:**
+
+```markdown
+<!-- vault/personal/blog-writing.md -->
+---
+tags: [blog, writing]
+description: Blog writing guidelines
+category: personal
+required_knowledge:
+  - personal/author-context
+---
+```
+
+When AI loads `personal/blog-writing.md`, the plugin:
+1. Detects the `required_knowledge` dependency
+2. Automatically loads `personal/author-context.md` first
+3. Then loads `personal/blog-writing.md`
+
+This ensures the AI always has complete context without manual tracking. Dependencies can be nested (Package A requires B, B requires C), and the plugin handles circular dependencies gracefully.
+
 ---
 
 ## Directory Structure

package/dist/index.js

@@ -12713,19 +12713,53 @@ _...and ${results.length - 10} more results_`;
 import { readFileSync as readFileSync3, existsSync as existsSync5 } from "fs";
 import { join as join4 } from "path";
 var VAULT_DIR2 = ".opencode/knowledge/vault";
+function resolveDependencies(packagePath, vaultDir, loaded = new Set) {
+  if (loaded.has(packagePath)) {
+    return [];
+  }
+  loaded.add(packagePath);
+  const result = [];
+  const normalizedPath = packagePath.endsWith(".md") ? packagePath : `${packagePath}.md`;
+  const fullPath = join4(vaultDir, normalizedPath);
+  if (!existsSync5(fullPath)) {
+    return [];
+  }
+  try {
+    const content = readFileSync3(fullPath, "utf-8");
+    const { frontmatter } = parseFrontmatter(content);
+    if (frontmatter.required_knowledge && Array.isArray(frontmatter.required_knowledge)) {
+      for (const dep of frontmatter.required_knowledge) {
+        const depPath = dep.endsWith(".md") ? dep : `${dep}.md`;
+        const depPackages = resolveDependencies(depPath, vaultDir, loaded);
+        result.push(...depPackages);
+      }
+    }
+    result.push(normalizedPath);
+  } catch {
+    return [];
+  }
+  return result;
+}
 var knowledgeLoadTool = tool({
   description: "Load one or more knowledge packages from the vault into the current session context. The package content will be available for reference in subsequent responses.",
   args: {
     paths: tool.schema.string().describe("Comma-separated package paths relative to vault (e.g., 'standards/code-conventions.md,frontend/react-patterns.md')")
   },
   async execute(args) {
-    const packagePaths = args.paths.split(",").map((p) => p.trim()).filter(Boolean);
-    if (packagePaths.length === 0) {
+    const requestedPaths = args.paths.split(",").map((p) => p.trim()).filter(Boolean);
+    if (requestedPaths.length === 0) {
       return "No package paths provided";
     }
+    const allPackagePaths = new Set;
+    const loadedTracker = new Set;
+    for (const path2 of requestedPaths) {
+      const resolved = resolveDependencies(path2, VAULT_DIR2, loadedTracker);
+      resolved.forEach((p) => allPackagePaths.add(p));
+    }
     const loaded = [];
     const failed = [];
-    for (const packagePath of packagePaths) {
+    const packageArray = Array.from(allPackagePaths);
+    for (const packagePath of packageArray) {
       const fullPath = join4(VAULT_DIR2, packagePath);
       if (!existsSync5(fullPath)) {
         failed.push(`\u26A0\uFE0F  Package not found: ${packagePath}`);
@@ -12742,9 +12776,18 @@ ${content}`);
     }
     let output = "";
     if (loaded.length > 0) {
-      output += `\u2705 Loaded ${loaded.length}/${packagePaths.length} packages:
+      const totalCount = packageArray.length;
+      const requestedCount = requestedPaths.length;
+      const depsCount = totalCount - requestedCount;
+      if (depsCount > 0) {
+        output += `\u2705 Loaded ${loaded.length}/${totalCount} packages (${requestedCount} requested + ${depsCount} dependencies):
 
 `;
+      } else {
+        output += `\u2705 Loaded ${loaded.length}/${totalCount} packages:
+
+`;
+      }
       output += loaded.join(`
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-knowledge",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "An OpenCode plugin",
   "author": {
     "name": "msegoviadev",