@bpmsoftwaresolutions/ai-engine-client 1.0.0-beta.0 → 1.0.0-beta.1

package/README.md

@@ -86,6 +86,20 @@ const client = AIEngineClient.fromEnv();
 | `getSymbolDefinition({ symbolName, qualifiedName, ... })` | Symbol/code definition lookup. |
 | `getRelatedCode({ symbolKey, qualifiedName, relationshipType, ... })` | Related code lookup. |
 
+### Repo Inventory
+| Method | Description |
+|---|---|
+| `listRepositories({ limit })` | List inventoried repositories. |
+| `getRepository(repositoryId)` | Get repository detail. |
+| `listProjects({ repositoryId, repoKey, limit })` | List inventoried projects. |
+| `getProject(projectId)` | Get project detail. |
+| `listCodeFiles({ repositoryId, projectId, language, pathPrefix, page, pageSize })` | Page through inventoried code files. |
+| `getCodeFile(fileId)` | Get file detail. |
+| `listCodeSymbolsByFile(fileId, { limit })` | List symbols discovered in a file. |
+| `getCodeSymbol(symbolId, { includeCode, maxLines })` | Get symbol detail. |
+| `searchSymbols({ query, projectScope, maxResults })` | Search inventoried symbols. |
+| `getSymbolRelationships(symbolId, { relationshipType, depth })` | Read symbol relationships from the inventory graph. |
+
 ### Retrieval Management
 | Method | Description |
 |---|---|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.0.0-beta.0",
+  "version": "1.0.0-beta.1",
   "description": "Thin npm client for the AI Engine operator and retrieval APIs",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -126,6 +126,69 @@ export class AIEngineClient {
     });
   }
 
+  // ─── Repo Inventory ───────────────────────────────────────────────────────
+
+  async listRepositories({ limit } = {}) {
+    return this._request('/api/repo/repositories', {
+      query: { limit },
+    });
+  }
+
+  async getRepository(repositoryId) {
+    return this._request(`/api/repo/repositories/${repositoryId}`);
+  }
+
+  async listProjects({ repositoryId, repoKey, limit } = {}) {
+    return this._request('/api/repo/projects', {
+      query: { repository_id: repositoryId, repo_key: repoKey, limit },
+    });
+  }
+
+  async getProject(projectId) {
+    return this._request(`/api/repo/projects/${projectId}`);
+  }
+
+  async listCodeFiles({ repositoryId, projectId, language, pathPrefix, page = 1, pageSize = 50 } = {}) {
+    return this._request('/api/repo/files', {
+      query: {
+        repository_id: repositoryId,
+        project_id: projectId,
+        language,
+        path_prefix: pathPrefix,
+        page,
+        page_size: pageSize,
+      },
+    });
+  }
+
+  async getCodeFile(fileId) {
+    return this._request(`/api/repo/files/${fileId}`);
+  }
+
+  async listCodeSymbolsByFile(fileId, { limit = 500 } = {}) {
+    return this._request(`/api/repo/files/${fileId}/symbols`, {
+      query: { limit },
+    });
+  }
+
+  async getCodeSymbol(symbolId, { includeCode = false, maxLines = 120 } = {}) {
+    return this._request(`/api/repo/symbols/${symbolId}`, {
+      query: { include_code: includeCode, max_lines: maxLines },
+    });
+  }
+
+  async searchSymbols({ query, projectScope, maxResults = 10 } = {}) {
+    return this._request('/api/repo/symbols/search', {
+      query: { query, project_scope: projectScope, max_results: maxResults },
+    });
+  }
+
+  async getSymbolRelationships(symbolId, { relationshipType, depth = 1 } = {}) {
+    return this._request(`/api/repo/symbols/${symbolId}/relationships`, {
+      query: { relationship_type: relationshipType, depth },
+    });
+  }
+
   // ─── Retrieval Management ──────────────────────────────────────────────────
 
   async getRetrievalStatus() {