@comfanion/usethis_search 3.0.0-dev.1 → 3.0.0-dev.3

package/api.ts

@@ -0,0 +1,92 @@
+/**
+ * usethis_search API
+ * 
+ * Exports internal functions for plugin-to-plugin communication.
+ * Used by Mind plugin for graph-based workspace management.
+ */
+
+import { GraphDB } from "./vectorizer/graph-db"
+
+// Global GraphDB instance (shared across the plugin)
+let graphDBInstance: GraphDB | null = null
+
+/**
+ * Initialize the API with GraphDB instance
+ */
+export function initGraphAPI(db: GraphDB): void {
+  graphDBInstance = db
+}
+
+/**
+ * Get related files for a given file path
+ * 
+ * @param filePath - File path to get relations for
+ * @param maxDepth - Maximum graph depth to traverse (default: 1)
+ * @returns Array of related files with relation type and weight
+ * 
+ * Example:
+ * ```javascript
+ * const related = await getRelatedFiles("src/auth/login.ts", 1)
+ * // Returns:
+ * [
+ *   { path: "src/types/User.ts", relation: "imports", weight: 0.9 },
+ *   { path: "src/auth/BaseAuth.ts", relation: "extends", weight: 0.95 },
+ *   { path: "src/routes/api.ts", relation: "used_by", weight: 0.8 }
+ * ]
+ * ```
+ */
+export async function getRelatedFiles(
+  filePath: string,
+  maxDepth: number = 1
+): Promise<{path: string, relation: string, weight: number}[]> {
+  if (!graphDBInstance) {
+    console.warn("[usethis_search API] GraphDB not initialized. Returning empty array.")
+    return []
+  }
+
+  try {
+    const chunkId = `file:${filePath}`
+    const related = await graphDBInstance.getRelatedFiles(chunkId, maxDepth)
+    
+    // Filter out the input file itself (it might appear in the graph)
+    const filtered = related.filter(r => r.path !== filePath)
+    
+    return filtered
+  } catch (error) {
+    console.error(`[usethis_search API] Error getting related files for ${filePath}:`, error)
+    return []
+  }
+}
+
+/**
+ * Check if graph API is available
+ */
+export function isGraphAPIAvailable(): boolean {
+  return graphDBInstance !== null
+}
+
+/**
+ * Get all graph entries for a file (both incoming and outgoing)
+ */
+export async function getGraphEntries(filePath: string) {
+  if (!graphDBInstance) {
+    return null
+  }
+
+  try {
+    const chunkId = `file:${filePath}`
+    const [outgoing, incoming] = await Promise.all([
+      graphDBInstance.getOutgoing(chunkId),
+      graphDBInstance.getIncoming(chunkId),
+    ])
+
+    return {
+      imports: outgoing.filter(t => t.predicate === "imports"),
+      extends: outgoing.filter(t => t.predicate === "extends"),
+      used_by: incoming,
+    }
+  } catch (error) {
+    console.error(`[usethis_search API] Error getting graph entries for ${filePath}:`, error)
+    return null
+  }
+}

package/file-indexer.ts

@@ -4,7 +4,7 @@ import fs from "fs/promises"
 import fsSync from "fs"
 
 import { CodebaseIndexer } from "./vectorizer/index.js"
-import { initGraphAPI } from "./api.js"
+import { initGraphAPI } from "./api"
 
 /**
  * File Indexer Plugin

package/index.ts

@@ -4,7 +4,7 @@ import search from "./tools/search"
 import codeindex from "./tools/codeindex"
 import readInterceptor from "./tools/read-interceptor"
 import FileIndexerPlugin from "./file-indexer"
-import { getRelatedFiles, getGraphEntries, isGraphAPIAvailable } from "./api.js"
+import { getRelatedFiles, getGraphEntries, isGraphAPIAvailable } from "./api"
 
 const UsethisSearchPlugin: Plugin = async (ctx) => {
   const fileIndexerHooks = await FileIndexerPlugin(ctx as any)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/usethis_search",
-  "version": "3.0.0-dev.1",
+  "version": "3.0.0-dev.3",
   "description": "OpenCode plugin: semantic search with graph-based context (v3: graph relations, 1-hop context, LSP + regex analyzers)",
   "type": "module",
   "main": "./index.ts",
@@ -12,6 +12,7 @@
   },
   "files": [
     "index.ts",
+    "api.ts",
     "file-indexer.ts",
     "tools/search.ts",
     "tools/codeindex.ts",