@bpmsoftwaresolutions/ai-engine-client 1.1.5 → 1.1.7

package/README.md

@@ -335,6 +335,7 @@ const packet = await client.downloadExternalWorkflowRunArtifact('run-123', 'pack
 |---|---|
 | `ping()` | Health check + current workflow name/status. |
 | `startSessionGovernance(body)` | Start a governed external session and return the `session_key` required for mutation-capable assistant turns. |
+| `claimWorkItem(body)` | Bind an oriented, claim-locked context session to a concrete work item and return the active claim envelope. |
 | `persistAssistantTurn(body)` | Persist an assistant turn to durable SQL through the API and return refreshed status projections. |
 | `createExternalAudioRender({ text, voice, model, speed, file })` | Create a client-scoped external audio render using inline text or multipart upload. |
 | `getExternalAudioRender(audioRenderRunId)` | Read external audio render status for the authenticated client. |
@@ -381,9 +382,14 @@ Low-level compatibility methods:
 | `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. |
+| `submitUxGateRemediation(body)` / `client.loga.submitUxGateRemediation(body)` | `POST /api/loga/ux-gate-remediations` | Create a governed SQL-backed remediation ticket for a UX gate failure. |
+| `listUxGateRemediations({ projectionType, status })` / `client.loga.listUxGateRemediations(...)` | `GET /api/loga/ux-gate-remediations` | List governed UX gate remediation tickets. |
+| `getUxGateRemediation(remediationId)` / `client.loga.getUxGateRemediation(...)` | `GET /api/loga/ux-gate-remediations/:remediationId` | Read one governed UX gate remediation ticket. |
 
 These methods return markdown as `text` and expose projection headers as top-level fields plus `provenance`. LOGA should render the markdown emitted by AI Engine and use these metadata fields for contract validation, refresh behavior, evidence display, and action choreography.
 
+UX gate remediation is not a generic note or implementation-item evidence path. LOGA clients should use `submitUxGateRemediation()` when a projection fails a UX gate and should include `sourceTruth: 'sql'`, the projection identity, affected finding ids, and client evidence about the failing gate.
+
 ### Retrieval Wrapper
 | Method | Description |
 |---|---|

package/package.json

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

package/src/index.js

@@ -107,6 +107,11 @@ export class AIEngineClient {
     if (typeof this.fetchImpl !== 'function') {
       throw new Error('A fetch implementation is required. Use Node 18+ or supply fetchImpl.');
     }
+    this.loga = {
+      submitUxGateRemediation: (payload) => this.submitUxGateRemediation(payload),
+      listUxGateRemediations: (query) => this.listUxGateRemediations(query),
+      getUxGateRemediation: (remediationId) => this.getUxGateRemediation(remediationId),
+    };
   }
 
   static fromEnv(options = {}) {
@@ -346,6 +351,10 @@ export class AIEngineClient {
     return this._request('/api/work/start', { method: 'POST', body });
   }
 
+  async claimWorkItem(body = {}) {
+    return this._request('/api/governance/claims/claim-work-item', { method: 'POST', body });
+  }
+
   async completeTurn(body = {}) {
     return this._request('/api/turns/complete', { method: 'POST', body });
   }
@@ -860,6 +869,41 @@ export class AIEngineClient {
     return this._requestLogaProjection(`/api/operator/projections/evidence-packets/${packetKey}`);
   }
 
+  async submitUxGateRemediation({
+    projectionType,
+    projectionId,
+    gateRunId,
+    findingIds,
+    remediationPayload,
+    sourceTruth = 'sql',
+    clientEvidence,
+    createdBy,
+  } = {}) {
+    return this._request('/api/loga/ux-gate-remediations', {
+      method: 'POST',
+      body: {
+        projectionType,
+        projectionId,
+        gateRunId,
+        findingIds,
+        remediationPayload,
+        sourceTruth,
+        clientEvidence,
+        createdBy,
+      },
+    });
+  }
+
+  async listUxGateRemediations({ projectionType, status } = {}) {
+    return this._request('/api/loga/ux-gate-remediations', {
+      query: { projectionType, status },
+    });
+  }
+
+  async getUxGateRemediation(remediationId) {
+    return this._request(`/api/loga/ux-gate-remediations/${remediationId}`);
+  }
+
   // ─── Roadmaps ──────────────────────────────────────────────────────────────
 
   async listProjectRoadmaps({ includeInactive } = {}) {