@bpmsoftwaresolutions/ai-engine-client 1.0.0-beta.4 → 1.0.0-beta.6

package/README.md

@@ -76,6 +76,7 @@ const client = AIEngineClient.fromEnv();
 | `currentSecurityGovernanceStatus({ environment, topN })` | Security governance findings. |
 | `currentCodebaseShapeStatus()` | Codebase shape analysis. |
 | `getLatestMemoryProjection()` | Current SQL memory projection (startup hydration source). |
+| `currentProjectStatus({ projectId })` | Current project status projection from SQL memory. |
 | `getDashboard()` | Operator dashboard payload. |
 
 ### Retrieval Wrapper
@@ -172,6 +173,11 @@ const client = AIEngineClient.fromEnv();
 | `createProjectCharter({ projectName, objective, businessContext, successCriteria, priority, constraints, inScope, outOfScope, assumptions, linkedWorkflows, testingStrategy, initialContext, requestedBy })` | Charter a project (writes to durable SQL memory). |
 | `listProjects({ limit, includeInactive, processStatus, charterStatus })` | List projects. |
 | `getProject(projectId)` | Get project detail. |
+| `getProjectCharterReport(projectId)` | Get the SQL-backed charter report payload for a project. |
+| `createProjectMarkdownDownload(projectId, { reportType, includeMarkdown })` | Create a markdown download descriptor for `charter` or `implementation_roadmap`. |
+| `downloadProjectMarkdownReport(projectId, reportType)` | Download a rendered markdown report as text plus filename metadata. |
+| `downloadProjectCharterReportMarkdown(projectId)` | Download the charter markdown report. |
+| `getProjectBundle(projectId)` | Get current status, charter report, and roadmap report in one payload. |
 
 ### Roadmaps
 | Method | Description |
@@ -180,6 +186,8 @@ const client = AIEngineClient.fromEnv();
 | `getProjectRoadmap(projectId)` | Get full roadmap for a project. |
 | `getProjectRoadmapSummary(projectId)` | Roadmap summary. |
 | `getProjectRoadmapActiveItem(projectId)` | Current active roadmap item. |
+| `getProjectImplementationRoadmapReport(projectId)` | Get the SQL-backed implementation roadmap report payload. |
+| `downloadProjectImplementationRoadmapReportMarkdown(projectId)` | Download the implementation roadmap markdown report. |
 | `ensureProjectRoadmapTaskSurface(projectId, { requestedBy, assignedTo, createAcceptanceSubtasks })` | Materialize the active roadmap item's parent task and acceptance subtasks. |
 | `listProjectOpenTasks(projectId)` | Open tasks for a project. |
 | `getProjectPerformanceMetrics(projectId, { workflowId, workflowRunId, sinceUtc })` | Performance metrics. |

package/package.json

@@ -1,28 +1,28 @@
-{
-  "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.0.0-beta.4",
-  "description": "Thin npm client for the AI Engine operator and retrieval APIs",
-  "type": "module",
-  "main": "./src/index.js",
-  "exports": {
-    ".": "./src/index.js"
-  },
-  "files": [
-    "src",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "ai-engine",
-    "sdk",
-    "client",
-    "retrieval",
-    "workflow"
-  ],
-  "license": "UNLICENSED",
-  "publishConfig": {
-    "access": "public"
-  }
+{
+  "name": "@bpmsoftwaresolutions/ai-engine-client",
+  "version": "1.0.0-beta.6",
+  "description": "Thin npm client for the AI Engine operator and retrieval APIs",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "ai-engine",
+    "sdk",
+    "client",
+    "retrieval",
+    "workflow"
+  ],
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/src/index.js

@@ -20,6 +20,14 @@ async function readJson(response) {
   return { message: text };
 }
 
+function parseContentDispositionFilename(headerValue) {
+  const value = String(headerValue || '');
+  const quotedMatch = value.match(/filename="([^"]+)"/i);
+  if (quotedMatch) return quotedMatch[1];
+  const plainMatch = value.match(/filename=([^;]+)/i);
+  return plainMatch ? plainMatch[1].trim() : null;
+}
+
 export class AIEngineClient {
   constructor({ baseUrl, apiKey, actorId, fetchImpl, timeoutMs } = {}) {
     if (!baseUrl) throw new Error('baseUrl is required.');
@@ -80,6 +88,12 @@ export class AIEngineClient {
     return this._request('/api/operator/latest-memory-projection');
   }
 
+  async currentProjectStatus({ projectId } = {}) {
+    return this._request('/api/operator/current-project-status', {
+      query: { project_id: projectId },
+    });
+  }
+
   async getDashboard() {
     return this._request('/api/dashboard');
   }
@@ -472,6 +486,29 @@ export class AIEngineClient {
     return this._request(`/api/operator/projects/${projectId}`);
   }
 
+  async getProjectCharterReport(projectId) {
+    return this._request(`/api/operator/projects/${projectId}/charter/report`);
+  }
+
+  async createProjectMarkdownDownload(projectId, { reportType, includeMarkdown = false } = {}) {
+    return this._request(`/api/operator/projects/${projectId}/markdown-report-downloads`, {
+      method: 'POST',
+      body: { report_type: reportType, include_markdown: includeMarkdown },
+    });
+  }
+
+  async downloadProjectMarkdownReport(projectId, reportType) {
+    return this._requestText(`/api/operator/projects/${projectId}/markdown-reports/${reportType}/download`);
+  }
+
+  async downloadProjectCharterReportMarkdown(projectId) {
+    return this.downloadProjectMarkdownReport(projectId, 'charter');
+  }
+
+  async getProjectBundle(projectId) {
+    return this._request(`/api/operator/projects/${projectId}/bundle`);
+  }
+
   // ─── Roadmaps ──────────────────────────────────────────────────────────────
 
   async listProjectRoadmaps({ includeInactive } = {}) {
@@ -492,6 +529,14 @@ export class AIEngineClient {
     return this._request(`/api/operator/projects/${projectId}/implementation-roadmap/active-item`);
   }
 
+  async getProjectImplementationRoadmapReport(projectId) {
+    return this._request(`/api/operator/projects/${projectId}/implementation-roadmap/report`);
+  }
+
+  async downloadProjectImplementationRoadmapReportMarkdown(projectId) {
+    return this.downloadProjectMarkdownReport(projectId, 'implementation_roadmap');
+  }
+
   async ensureProjectRoadmapTaskSurface(projectId, {
     requestedBy,
     assignedTo,
@@ -1092,6 +1137,44 @@ export class AIEngineClient {
       clearTimeout(timeoutHandle);
     }
   }
+
+  async _requestText(path, { method = 'GET', query, headers, body } = {}) {
+    const url = appendQuery(`${this.baseUrl}${path}`, query);
+    const controller = new AbortController();
+    const timeoutHandle = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const response = await this.fetchImpl(url, {
+        method,
+        headers: {
+          accept: 'text/markdown, text/plain;q=0.9, application/json;q=0.8',
+          'content-type': body ? 'application/json' : undefined,
+          'x-actor-id': this.actorId,
+          authorization: this.apiKey ? `Bearer ${this.apiKey}` : undefined,
+          ...headers,
+        },
+        body: body ? JSON.stringify(body) : undefined,
+        signal: controller.signal,
+      });
+      const contentType = response.headers.get('content-type') || '';
+      const contentDisposition = response.headers.get('content-disposition') || '';
+      if (!response.ok) {
+        const payload = contentType.includes('application/json')
+          ? await response.json()
+          : { message: await response.text() };
+        const error = new Error(payload?.message || payload?.error || `Request failed with status ${response.status}.`);
+        error.status = response.status;
+        error.payload = payload;
+        throw error;
+      }
+      return {
+        text: await response.text(),
+        contentType,
+        fileName: parseContentDispositionFilename(contentDisposition),
+      };
+    } finally {
+      clearTimeout(timeoutHandle);
+    }
+  }
 }
 
 export function createAIEngineClient(options) {