@bpmsoftwaresolutions/ai-engine-client 1.1.70 → 1.1.71

package/README.md

@@ -654,7 +654,7 @@ Generated scripts are ephemeral helpers, not source-of-truth. The server keeps S
 
 ### Governed Implementation
 
-Current package version: `1.0.0-beta.13`.
+Current package version: `1.1.71`.
 
 | Method | Description |
 |---|---|
@@ -763,6 +763,7 @@ Engine returns the required gate and next action.
 | `getPortfolioProject(projectId)` | Project detail via portfolio. |
 | `getPortfolioReport()` | Full portfolio report. |
 | `getPortfolioBundle()` | Portfolio bundle. |
+| `getPortfolioClosureReadiness({ projectLimit, includeInactive, includeLogaPortfolioProjection, includeLogaRoadmapProjections })` | Read-only portfolio readiness view that composes bundle, project list, roadmap summaries, active items, and open task counts into a conservative closure-ready flag. |
 
 ### Self-Learning
 | Method | Description |

package/package.json

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

package/src/index.js

@@ -5767,6 +5767,130 @@ export class AIEngineClient {
     return this._request('/api/operator/portfolio/bundle');
   }
 
+  async getPortfolioClosureReadiness({
+    projectLimit = 25,
+    includeInactive = false,
+    includeLogaPortfolioProjection = false,
+    includeLogaRoadmapProjections = false,
+  } = {}) {
+    const portfolioBundle = await this.getPortfolioBundle();
+    const projectListPayload = await this.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,
+    };
+  }
+
   // ─── Self-Learning ─────────────────────────────────────────────────────────
 
   async getSelfLearningPosture({ workflowRunId, limit } = {}) {