@bpmsoftwaresolutions/ai-engine-client 1.0.0-beta.12 → 1.0.0-beta.13

package/README.md

@@ -112,6 +112,10 @@ console.log(logaRoadmap.projectionType, logaRoadmap.projectionVersion);
 console.log(logaRoadmap.provenance.sourceTruth, logaRoadmap.correlationId);
 console.log(logaRoadmap.text);
 
+const logaRoadmapItem = await client.getLogaRoadmapItemProjection(projectId, 'execute-scope-1');
+console.log(logaRoadmapItem.projectionType, logaRoadmapItem.provenance.sourceVersion);
+console.log(logaRoadmapItem.text);
+
 const audio = await client.downloadExternalAudioRender(audioRenderRunId);
 await fs.promises.writeFile('render.mp3', Buffer.from(audio.arrayBuffer));
 ```
@@ -374,6 +378,7 @@ Low-level compatibility methods:
 | `getLogaOperatorHomeProjection()` | `GET /api/operator/projections/home` | Governed operator home runtime markdown document. |
 | `getLogaProjectCatalogProjection()` | `GET /api/operator/projections/project-catalog` | Governed project catalog runtime markdown document. |
 | `getLogaProjectRoadmapProjection(projectId)` | `GET /api/operator/projections/projects/:projectId/roadmap.md` | Governed project roadmap runtime markdown document. |
+| `getLogaRoadmapItemProjection(projectId, itemKey)` | `GET /api/operator/projections/projects/:projectId/roadmap/items/:itemKey` | Governed roadmap item runtime markdown document with item-level navigation, related documents, actions, and evidence. |
 | `getLogaWorkflowRunProjection(workflowRunId)` | `GET /api/operator/projections/workflow-runs/:workflowRunId` | Governed workflow run runtime markdown document. |
 | `getLogaEvidencePacketProjection(packetKey)` | `GET /api/operator/projections/evidence-packets/:packetKey` | Governed evidence packet runtime markdown document. |
 
@@ -506,6 +511,9 @@ These methods return markdown as `text` and expose projection headers as top-lev
 | `completeImplementationTask(taskId, { completedBy })` | Mark complete. |
 
 ### Governed Implementation
+
+Current package version: `1.0.0-beta.13`.
+
 | Method | Description |
 |---|---|
 | `importImplementationPacket(body)` | Import an implementation packet. |
@@ -521,6 +529,26 @@ These methods return markdown as `text` and expose projection headers as top-lev
 | `getWorkflowImplementationRoadmap(workflowId)` | Workflow-linked roadmap. |
 | `getWorkflowResumeContext(workflowId)` | Resume context. |
 
+Governed roadmap item mutations must carry claim context. Include the active
+claim in the request body:
+
+```js
+await client.updateImplementationItemStatus(itemId, {
+  status: 'done',
+  status_reason: 'Evidence attached and gates passed.',
+  updated_by: 'operator:loga',
+  claimed_item_id: itemId,
+  agent_session_id: 'agent-session-id',
+  claim_workflow_run_id: 'workflow-run-id',
+});
+```
+
+The same claim envelope applies to `addImplementationItemEvidence()`,
+`addImplementationItemActivity()`, and `updateAcceptanceCheckStatus()`. If the
+claim is missing, AI Engine returns `409` with `error:
+missing_governed_claim`. If the claim exists but unresolved gates remain, AI
+Engine returns the required gate and next action.
+
 ### Skills
 | Method | Description |
 |---|---|

package/package.json

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

package/src/index.js

@@ -765,6 +765,10 @@ export class AIEngineClient {
     return this._requestLogaProjection(`/api/operator/projections/projects/${projectId}/roadmap.md`);
   }
 
+  async getLogaRoadmapItemProjection(projectId, itemKey) {
+    return this._requestLogaProjection(`/api/operator/projections/projects/${projectId}/roadmap/items/${itemKey}`);
+  }
+
   async getLogaWorkflowRunProjection(workflowRunId) {
     return this._requestLogaProjection(`/api/operator/projections/workflow-runs/${workflowRunId}`);
   }