@bpmsoftwaresolutions/ai-engine-client 1.1.4 → 1.1.6

package/README.md

@@ -381,9 +381,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.4",
+  "version": "1.1.6",
   "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 = {}) {
@@ -313,6 +318,35 @@ export class AIEngineClient {
     });
   }
 
+  async startReviewGovernance({
+    intent,
+    objective,
+    readScope,
+    requiredToolKeys,
+    sessionKey,
+    workflowRunId,
+    workflowId,
+    workflowSlug,
+    turnPersisted,
+    ...rest
+  } = {}) {
+    return this._request('/api/v1/session-governance/review/startup', {
+      method: 'POST',
+      body: {
+        ...rest,
+        intent: intent ?? 'review code',
+        objective: objective ?? intent,
+        read_scope: readScope,
+        required_tool_keys: requiredToolKeys,
+        session_key: sessionKey,
+        workflow_run_id: workflowRunId,
+        workflow_id: workflowId,
+        workflow_slug: workflowSlug ?? 'code-review/read-only',
+        turn_persisted: turnPersisted,
+      },
+    });
+  }
+
   async startWork(body = {}) {
     return this._request('/api/work/start', { method: 'POST', body });
   }
@@ -831,6 +865,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 } = {}) {