@bpmsoftwaresolutions/ai-engine-client 1.1.19 → 1.1.21

package/README.md

@@ -378,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. |
+| `getLogaProjectPortfolioProjection()` | `GET /api/operator/projections/project-portfolio` | Governed portfolio rollup runtime markdown document with SQL-backed completion metrics and project buckets. |
 | `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. |
@@ -385,6 +386,8 @@ Low-level compatibility methods:
 | `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. |
+| `appendUxRemediationTicketNote(remediationId, body)` / `client.loga.appendUxRemediationTicketNote(...)` | `POST /api/loga/ux-gate-remediations/:remediationId/notes` | Append a governed downstream-facing remediation note to a UX gate remediation ticket. |
+| `listUxRemediationTicketNotes(remediationId)` / `client.loga.listUxRemediationTicketNotes(...)` | `GET /api/loga/ux-gate-remediations/:remediationId/notes` | List governed remediation notes for a UX gate remediation ticket. |
 | `promoteUxGateRemediationImplementationCandidate(remediationId, { promotedBy })` / `client.loga.promoteUxGateRemediationImplementationCandidate(...)` | `POST /api/loga/ux-gate-remediations/:remediationId/implementation-candidate` | Promote a governed UX remediation ticket into a durable implementation packet candidate. |
 | `getLogaUxGateRemediationProjection(remediationId)` / `client.loga.getUxGateRemediationProjection(...)` | `GET /api/operator/projections/ux-gate-remediations/:remediationId` | Review a governed UX remediation ticket and its linked implementation candidate as a LOGA runtime document. |
 

package/package.json

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

package/src/index.js

@@ -1,5 +1,5 @@
 const DEFAULT_TIMEOUT_MS = 30000;
-export const AI_ENGINE_CLIENT_VERSION = '1.1.19';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.21';
 export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
   'executeVerifiedMutation',
   'post_mutation_verification',
@@ -165,6 +165,8 @@ export class AIEngineClient {
       submitUxGateRemediation: (payload) => this.submitUxGateRemediation(payload),
       listUxGateRemediations: (query) => this.listUxGateRemediations(query),
       getUxGateRemediation: (remediationId) => this.getUxGateRemediation(remediationId),
+      appendUxRemediationTicketNote: (remediationId, payload) => this.appendUxRemediationTicketNote(remediationId, payload),
+      listUxRemediationTicketNotes: (remediationId) => this.listUxRemediationTicketNotes(remediationId),
       promoteUxGateRemediationImplementationCandidate: (remediationId, payload) =>
         this.promoteUxGateRemediationImplementationCandidate(remediationId, payload),
       getUxGateRemediationProjection: (remediationId) => this.getLogaUxGateRemediationProjection(remediationId),
@@ -939,6 +941,10 @@ export class AIEngineClient {
     return this._requestLogaProjection('/api/operator/projections/project-catalog');
   }
 
+  async getLogaProjectPortfolioProjection() {
+    return this._requestLogaProjection('/api/operator/projections/project-portfolio');
+  }
+
   async getLogaProjectRoadmapProjection(projectId) {
     return this._requestLogaProjection(`/api/operator/projections/projects/${projectId}/roadmap.md`);
   }
@@ -990,6 +996,31 @@ export class AIEngineClient {
     return this._request(`/api/loga/ux-gate-remediations/${remediationId}`);
   }
 
+  async appendUxRemediationTicketNote(remediationId, {
+    noteKind,
+    body,
+    visibility,
+    authorActorId,
+    evidenceRefs,
+    metadata,
+  } = {}) {
+    return this._request(`/api/loga/ux-gate-remediations/${remediationId}/notes`, {
+      method: 'POST',
+      body: {
+        noteKind,
+        body,
+        visibility,
+        authorActorId,
+        evidenceRefs,
+        metadata,
+      },
+    });
+  }
+
+  async listUxRemediationTicketNotes(remediationId) {
+    return this._request(`/api/loga/ux-gate-remediations/${remediationId}/notes`);
+  }
+
   async promoteUxGateRemediationImplementationCandidate(remediationId, { promotedBy } = {}) {
     return this._request(`/api/loga/ux-gate-remediations/${remediationId}/implementation-candidate`, {
       method: 'POST',