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

package/README.md

@@ -86,6 +86,31 @@ 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. |
+| `getCodeFileContentWindow(fileId, { startLine, endLine })` | Read a bounded file content window from inventory-backed content. |
+| `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. |
+| `listCodeRelationships({ repositoryId, projectId, relationshipType, limit })` | Read repository/project scoped graph relationships. |
+| `listActionObservations({ repositoryId, projectPath, filePath, symbolId, actionKind, limit })` | Read latest action-grammar observations for a repo scope. |
+| `listCodebaseShapeFindings({ repositoryId, projectPath, filePath, severity, status, limit })` | List latest codebase-shape findings for the selected repo scope. |
+| `listObjectFlowObservations({ repositoryId, projectPath, filePath, objectKind, boundaryKind, limit })` | List latest object-flow observations for the selected repo scope. |
+| `getChangeAnalysis({ fileId, symbolId, limit })` | Aggregate relationships, findings, and structural observations for one file or symbol. |
+| `listRefactorCandidates({ repositoryRoot, limit })` | List governed refactor candidates derived from SQL-backed findings. |
+| `analyzeRefactorCandidate({ filePath, requestedBy, packetId, refactorIntent })` | Build a replayable refactor packet preview for one candidate file. |
+| `getRepoRetrievalPacket(retrievalPacketId)` | Read a retrieval packet through the repo boundary. |
+| `getRepoRetrievalPacketFragments(retrievalPacketId)` | Read the packet fragments for a retrieval packet. |
+| `evaluateProposalScope({ filePath, projectId, changeType, requestedBy, refactorIntent })` | Evaluate governance, scope, and open-task posture for a proposed refactor slice. |
+
 ### 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.2",
   "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,133 @@ 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 getCodeFileContentWindow(fileId, { startLine = 1, endLine } = {}) {
+    return this._request(`/api/repo/files/${fileId}/content-window`, {
+      query: { start_line: startLine, end_line: endLine ?? startLine },
+    });
+  }
+
+  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 },
+    });
+  }
+
+  async listCodeRelationships({ repositoryId, projectId, relationshipType, limit = 100 } = {}) {
+    return this._request('/api/repo/relationships', {
+      query: { repository_id: repositoryId, project_id: projectId, relationship_type: relationshipType, limit },
+    });
+  }
+
+  async listActionObservations({ repositoryId, projectPath, filePath, symbolId, actionKind, limit = 100 } = {}) {
+    return this._request('/api/repo/action-observations', {
+      query: { repository_id: repositoryId, project_path: projectPath, file_path: filePath, symbol_id: symbolId, action_kind: actionKind, limit },
+    });
+  }
+
+  async listCodebaseShapeFindings({ repositoryId, projectPath, filePath, severity, status, limit = 100 } = {}) {
+    return this._request('/api/repo/shape/findings', {
+      query: { repository_id: repositoryId, project_path: projectPath, file_path: filePath, severity, status, limit },
+    });
+  }
+
+  async listObjectFlowObservations({ repositoryId, projectPath, filePath, objectKind, boundaryKind, limit = 100 } = {}) {
+    return this._request('/api/repo/object-flow-observations', {
+      query: { repository_id: repositoryId, project_path: projectPath, file_path: filePath, object_kind: objectKind, boundary_kind: boundaryKind, limit },
+    });
+  }
+
+  async getChangeAnalysis({ fileId, symbolId, limit = 25 } = {}) {
+    return this._request('/api/repo/change-analysis', {
+      query: { file_id: fileId, symbol_id: symbolId, limit },
+    });
+  }
+
+  async listRefactorCandidates({ repositoryRoot, limit = 10 } = {}) {
+    return this._request('/api/repo/refactor-candidates', {
+      query: { repository_root: repositoryRoot, limit },
+    });
+  }
+
+  async analyzeRefactorCandidate({ filePath, requestedBy, packetId, refactorIntent } = {}) {
+    return this._request('/api/repo/refactor-candidate-analysis', {
+      method: 'POST',
+      body: { file_path: filePath, requested_by: requestedBy, packet_id: packetId, refactor_intent: refactorIntent },
+    });
+  }
+
+  async getRepoRetrievalPacket(retrievalPacketId) {
+    return this._request(`/api/repo/retrieval/packets/${retrievalPacketId}`);
+  }
+
+  async getRepoRetrievalPacketFragments(retrievalPacketId) {
+    return this._request(`/api/repo/retrieval/packets/${retrievalPacketId}/fragments`);
+  }
+
+  async evaluateProposalScope({ filePath, projectId, changeType = 'refactor', requestedBy, refactorIntent } = {}) {
+    return this._request('/api/repo/proposal-scope-evaluation', {
+      method: 'POST',
+      body: { file_path: filePath, project_id: projectId, change_type: changeType, requested_by: requestedBy, refactor_intent: refactorIntent },
+    });
+  }
+
   // ─── Retrieval Management ──────────────────────────────────────────────────
 
   async getRetrievalStatus() {