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

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 |
@@ -169,6 +180,7 @@ const client = AIEngineClient.fromEnv();
 | `getProjectRoadmap(projectId)` | Get full roadmap for a project. |
 | `getProjectRoadmapSummary(projectId)` | Roadmap summary. |
 | `getProjectRoadmapActiveItem(projectId)` | Current active roadmap item. |
+| `ensureProjectRoadmapTaskSurface(projectId, { requestedBy, assignedTo, createAcceptanceSubtasks })` | Materialize the active roadmap item's parent task and acceptance subtasks. |
 | `listProjectOpenTasks(projectId)` | Open tasks for a project. |
 | `getProjectPerformanceMetrics(projectId, { workflowId, workflowRunId, sinceUtc })` | Performance metrics. |
 
@@ -176,6 +188,8 @@ const client = AIEngineClient.fromEnv();
 | Method | Description |
 |---|---|
 | `createImplementationTask(implementationItemId, { title, implementationPacketId, ... })` | Create a task on a roadmap item. |
+
+`createProjectCharter()` now also accepts `linkedWorkflowSlug`, `ensureTaskSurface`, `assignedTo`, and `createAcceptanceSubtasks` so new API-chartered projects can immediately surface an attachable implementation item and durable task tree.
 | `listImplementationTasks(implementationItemId)` | List tasks. |
 | `listImplementationSubtasks(taskId)` | List subtasks. |
 | `updateImplementationTask(taskId, updates)` | Update a task. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.3",
   "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() {
@@ -361,9 +425,13 @@ export class AIEngineClient {
     outOfScope = [],
     assumptions = [],
     linkedWorkflows = [],
+    linkedWorkflowSlug,
     testingStrategy = {},
     initialContext = {},
     requestedBy,
+    ensureTaskSurface = true,
+    assignedTo,
+    createAcceptanceSubtasks = true,
   } = {}) {
     return this._request('/api/projects/charter', {
       method: 'POST',
@@ -378,9 +446,13 @@ export class AIEngineClient {
         out_of_scope: outOfScope,
         assumptions,
         linked_workflows: linkedWorkflows,
+        linked_workflow_slug: linkedWorkflowSlug,
         testing_strategy: testingStrategy,
         initial_context: initialContext,
         requested_by: requestedBy,
+        ensure_task_surface: ensureTaskSurface,
+        assigned_to: assignedTo,
+        create_acceptance_subtasks: createAcceptanceSubtasks,
       },
     });
   }
@@ -420,6 +492,21 @@ export class AIEngineClient {
     return this._request(`/api/operator/projects/${projectId}/implementation-roadmap/active-item`);
   }
 
+  async ensureProjectRoadmapTaskSurface(projectId, {
+    requestedBy,
+    assignedTo,
+    createAcceptanceSubtasks = true,
+  } = {}) {
+    return this._request(`/api/operator/projects/${projectId}/implementation-roadmap/task-surface`, {
+      method: 'POST',
+      body: {
+        requested_by: requestedBy,
+        assigned_to: assignedTo,
+        create_acceptance_subtasks: createAcceptanceSubtasks,
+      },
+    });
+  }
+
   async listProjectOpenTasks(projectId) {
     return this._request(`/api/operator/projects/${projectId}/open-tasks`);
   }