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

package/README.md

@@ -95,10 +95,21 @@ const client = AIEngineClient.fromEnv();
 | `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.1",
+  "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

@@ -165,6 +165,12 @@ export class AIEngineClient {
     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 },
@@ -189,6 +195,64 @@ export class AIEngineClient {
     });
   }
 
+  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() {