@bpmsoftwaresolutions/ai-engine-client 1.1.90 → 1.1.92

package/package.json

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

package/src/client.js

@@ -2691,142 +2691,6 @@ export class AIEngineClient {
     });
   }
 
-  async getPortfolioClosureReadiness({
-    projectLimit = 25,
-    includeInactive = false,
-    includeLogaPortfolioProjection = false,
-    includeLogaRoadmapProjections = false,
-  } = {}) {
-    const portfolioBundle = await this._request('/api/operator/portfolio/bundle');
-    const projectListPayload = await this.projects.listProjects({ limit: projectLimit, includeInactive });
-
-    const bundleProjects = Array.isArray(portfolioBundle?.projects)
-      ? portfolioBundle.projects.filter((project) => isPlainObject(project))
-      : [];
-    const listedProjects = Array.isArray(projectListPayload?.projects)
-      ? projectListPayload.projects.filter((project) => isPlainObject(project))
-      : Array.isArray(projectListPayload)
-        ? projectListPayload.filter((project) => isPlainObject(project))
-        : [];
-    const activeProjects = listedProjects.length > 0 ? listedProjects : bundleProjects;
-    const logaPortfolioProjection = includeLogaPortfolioProjection
-      ? await this.getLogaProjectPortfolioProjection()
-      : null;
-    const logaRoadmapProjections = {};
-
-    const projectReadiness = [];
-    for (const project of activeProjects) {
-      const projectId = cleanText(project.project_id) || cleanText(project.projectId);
-      if (!projectId) {
-        continue;
-      }
-
-      const roadmapSummaryPayload = await this.getProjectRoadmapSummary(projectId);
-      const roadmapSummary = isPlainObject(roadmapSummaryPayload?.summary) ? roadmapSummaryPayload.summary : {};
-      const activeItemPayload = await this.getProjectRoadmapActiveItem(projectId);
-      const activeItem = isPlainObject(activeItemPayload?.active_item)
-        ? activeItemPayload.active_item
-        : isPlainObject(activeItemPayload)
-          ? activeItemPayload
-          : {};
-      const openTasksPayload = await this.listProjectOpenTasks(projectId);
-      const openTasks = Array.isArray(openTasksPayload?.tasks)
-        ? openTasksPayload.tasks.filter((task) => isPlainObject(task))
-        : Array.isArray(openTasksPayload)
-          ? openTasksPayload.filter((task) => isPlainObject(task))
-          : [];
-
-      const activeItemStatus = cleanText(activeItem.item_status) || cleanText(activeItem.status);
-      const completionPercentage = Number(
-        roadmapSummary.completion_percentage
-        ?? roadmapSummary.completion_pct
-        ?? roadmapSummary.progress_percentage
-        ?? 0,
-      );
-      const totalItems = Number(
-        roadmapSummary.total_items
-        ?? roadmapSummary.item_count
-        ?? roadmapSummary.total_count
-        ?? 0,
-      );
-      const openItems = Number(
-        roadmapSummary.open_items
-        ?? roadmapSummary.open_item_count
-        ?? roadmapSummary.remaining_items
-        ?? openTasks.length,
-      );
-      const terminalStatuses = new Set(['accepted', 'verified', 'done', 'completed', 'closed']);
-      const activeItemReady = !activeItemStatus || terminalStatuses.has(activeItemStatus.toLowerCase());
-      const projectReady = openItems === 0 && openTasks.length === 0 && activeItemReady && completionPercentage >= 100;
-      const blockingReason = projectReady
-        ? null
-        : [
-            openTasks.length > 0 ? `${openTasks.length} open task(s) remain` : null,
-            openItems > 0 ? `${openItems} roadmap item(s) remain open` : null,
-            !activeItemReady ? `active item status is ${activeItemStatus || 'missing'}` : null,
-            completionPercentage < 100 ? `completion is ${completionPercentage.toFixed(1)}%` : null,
-          ].filter(Boolean).join('; ') || 'portfolio closure readiness is not satisfied';
-
-      const roadmapCompletion = {
-        completion_percentage: completionPercentage,
-        total_items: totalItems,
-        open_items: openItems,
-        completed_items: Math.max(totalItems - openItems, 0),
-      };
-      const projectReadinessEntry = {
-        project: {
-          project_id: projectId,
-          project_name: cleanText(project.project_name) || cleanText(project.projectName) || null,
-          project_slug: cleanText(project.project_slug) || cleanText(project.projectSlug) || null,
-          process_status: cleanText(project.process_status) || cleanText(project.processStatus) || null,
-          charter_status: cleanText(project.charter_status) || cleanText(project.charterStatus) || null,
-        },
-        roadmap_completion: roadmapCompletion,
-        active_item: activeItem,
-        open_task_count: openTasks.length,
-        closure_ready: projectReady,
-        blocking_reason: blockingReason,
-      };
-      if (includeLogaRoadmapProjections) {
-        projectReadinessEntry.loga_roadmap_projection = await this.getLogaProjectRoadmapProjection(projectId);
-        logaRoadmapProjections[projectId] = projectReadinessEntry.loga_roadmap_projection;
-      }
-      projectReadiness.push(projectReadinessEntry);
-    }
-
-    const closureReady = projectReadiness.length === 0 || projectReadiness.every((project) => project.closure_ready === true);
-    const blockingProject = projectReadiness.find((project) => project.closure_ready !== true);
-
-    return {
-      portfolio_summary: isPlainObject(portfolioBundle?.summary) ? portfolioBundle.summary : {},
-      portfolio_bundle: portfolioBundle,
-      active_projects: projectReadiness,
-      closure_readiness: closureReady,
-      blocking_reason: closureReady ? null : `${cleanText(blockingProject?.project?.project_name) || cleanText(blockingProject?.project?.project_id) || 'project'}: ${blockingProject?.blocking_reason || 'closure readiness is not satisfied'}`,
-      blocking_project_id: closureReady ? null : cleanText(blockingProject?.project?.project_id),
-      blocking_project_name: closureReady ? null : cleanText(blockingProject?.project?.project_name),
-      project_count: projectReadiness.length,
-      open_task_count: projectReadiness.reduce((total, project) => total + Number(project.open_task_count || 0), 0),
-      loga_portfolio_projection: logaPortfolioProjection,
-      loga_roadmap_projections: includeLogaRoadmapProjections ? logaRoadmapProjections : null,
-    };
-  }
-
-  async getPortfolioStatus({
-    projectId,
-    project_id,
-  } = {}) {
-    return this._request('/api/operator/portfolio/status', {
-      query: {
-        project_id: cleanText(project_id) || cleanText(projectId),
-      },
-    });
-  }
-
-  async getPortfolioBundle() {
-    return this._request('/api/operator/portfolio/bundle');
-  }
-
   async getExternalProjectStatus(projectId) {
     return this._request(`/api/v1/projects/${projectId}/status`);
   }
@@ -2912,7 +2776,6 @@ export class AIEngineClient {
 export function createAIEngineClient(options) {
   return new AIEngineClient(options);
 }
-
 function defineCompatibilityMethods(proto, targetName, methodNames) {
   for (const methodName of methodNames) {
     if (Object.prototype.hasOwnProperty.call(proto, methodName)) continue;
@@ -3001,6 +2864,6 @@ function installClientCompatibilityDelegates(ClientClass) {
   defineCompatibilityMethods(proto, 'commitGovernance', ['evaluateCommitGovernance', 'checkGitShipReadiness', 'getCommitGovernanceEvaluation', 'listCommitGovernanceEvaluationsByClaim']);
   defineCompatibilityMethods(proto, 'contextSessions', ['openContextSession', 'getOrientationWindow', 'acknowledgeReminder', 'completeOrientation', 'lockContextSessionClaim', 'getContextSessionGateStatus']);
   defineCompatibilityMethods(proto, 'contextOrientation', ['conductOrientation']);
+  defineCompatibilityMethods(proto, 'portfolio', ['getPortfolioStatus', 'getPortfolioBundle', 'getPortfolioClosureReadiness']);
 }
-
 installClientCompatibilityDelegates(AIEngineClient);

package/src/domains/portfolio.js

@@ -2,12 +2,16 @@ import { cleanText, isPlainObject } from '../utils/text.js';
 
 export function createPortfolioDomain(client) {
   return {
-    getPortfolioStatus: (request) => client.getPortfolioStatus(request),
+    getPortfolioStatus: ({ projectId, project_id } = {}) => client._request('/api/operator/portfolio/status', {
+      query: {
+        project_id: cleanText(project_id) || cleanText(projectId),
+      },
+    }),
     getPortfolioSummary: () => client.getPortfolioSummary(),
     getPortfolioExceptions: () => client.getPortfolioExceptions(),
     getPortfolioProject: (projectId) => client.getPortfolioProject(projectId),
     getPortfolioReport: () => client.getPortfolioReport(),
-    getPortfolioBundle: () => client.getPortfolioBundle(),
+    getPortfolioBundle: () => client._request('/api/operator/portfolio/bundle'),
     getPortfolioClosureReadiness: async ({
       projectLimit = 25,
       includeInactive = false,

package/src/domains/warehouse.js

@@ -7,5 +7,7 @@ export function createWarehouseDomain(client) {
     requestModernizationWrapperExecution: (request) => client.requestModernizationWrapperExecution(request),
     getModernizationWrapperEvidence: (request) => client.getModernizationWrapperEvidence(request),
     decideModernizationGate: (request) => client.decideModernizationGate(request),
+    getPortfolioStatus: (request) => client.getPortfolioStatus(request),
+    getPortfolioBundle: () => client.getPortfolioBundle(),
   };
 }

package/src/index.js

@@ -1,5 +1,5 @@
 export { AIEngineClient, createAIEngineClient } from './client.js';
-export const AI_ENGINE_CLIENT_VERSION = '1.1.90';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.92';
 export { GOVERNED_MUTATION_REQUIRED_CAPABILITIES, AI_ENGINE_CLIENT_CAPABILITIES, TASK_BOUND_SUBSTRATE_EXECUTION_POLICY } from './constants/governance.js';
 export { LOGA_CONTRACT, LOGA_INTERACTION_CONTRACT, LOGA_NAVIGATION_CONTRACT, LOGA_PROJECTION_WORKFLOW } from './constants/loga.js';
 export {