@bpmsoftwaresolutions/ai-engine-client 1.1.78 → 1.1.81

package/README.md

@@ -79,6 +79,35 @@ const generatedUsability = await client.getGeneratedExecutionUsability();
 const logaUsability = await client.getLogaGeneratedExecutionUsabilityProjection();
 ```
 
+## Namespaces
+
+The client keeps the top-level compatibility methods, but the extracted domain namespaces are the preferred way to navigate the SDK:
+
+- `client.portfolio` for portfolio status and closure-readiness views
+- `client.workflowComposition` for modernization and workflow-composition helpers
+- `client.warehouse` as a legacy compatibility alias for the workflow-composition helpers
+- `client.projects`, `client.roadmaps`, `client.projectChartering`, and other domain namespaces for the thinner wrapper surfaces
+
+The legacy top-level methods still work, so existing callers can move gradually:
+
+```js
+await client.getPortfolioClosureReadiness();
+await client.workflowComposition.decideModernizationGate();
+await client.warehouse.requestModernizationWrapperExecution();
+```
+
+### Compatibility Map
+
+The post-split client intentionally keeps the legacy call styles available while exposing the normalized namespace paths:
+
+- `client.ping()` and `client.health.ping()` remain available.
+- `client.query()` and `client.gateway.query()` remain available.
+- `client.getPortfolioClosureReadiness()` and `client.portfolio.getPortfolioClosureReadiness()` remain available.
+- `client.registerModernizationAsset()` and `client.warehouse.registerModernizationAsset()` remain available.
+- `client.workflowComposition.*` is the normalized modernization namespace, with `client.warehouse.*` preserved as the compatibility alias.
+- Auth behavior remains unchanged: bearer token auth wins when `accessToken` or `tokenProvider` is configured, otherwise the client falls back to the compatibility API key headers.
+- Download helpers still return the same markdown and binary payload metadata through the top-level methods.
+
 ## Project Continuation Runtime
 
 Once you know the project identity, use `resumeProjectWork()` as the canonical startup and hydration call for project work.

package/package.json

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

package/src/client.js

@@ -40,6 +40,7 @@ import { createSkillsDomain } from './domains/skills.js';
 import { createSearchContactsDomain } from './domains/search-contacts.js';
 import { createToolRegistryDomain } from './domains/tool-registry.js';
 import { createWorkflowCompositionDomain } from './domains/workflow-composition.js';
+import { createWarehouseDomain } from './domains/warehouse.js';
 import { buildHeaders, requestBinary, requestJson, requestLogaProjection, requestText, resolveAccessToken } from './transport/index.js';
 import { normalizeEnum, trimTrailingSlash } from './utils/text.js';
 
@@ -409,7 +410,7 @@ export class AIEngineClient {
     this.reports = createReportsDomain(this);
     this.projections = createProjectionsDomain(this);
     this.workflowComposition = createWorkflowCompositionDomain(this);
-    this.warehouse = this.workflowComposition;
+    this.warehouse = createWarehouseDomain(this);
     this.actions = createActionsDomain(this);
     this.agentComms = {
       openThread: (request) => this.openCommunicationThread(request),

package/src/domains/warehouse.js

@@ -0,0 +1,11 @@
+export function createWarehouseDomain(client) {
+  return {
+    registerModernizationAsset: (request) => client.registerModernizationAsset(request),
+    classifyModernizationAsset: (request) => client.classifyModernizationAsset(request),
+    discoverSalvageCandidates: (request) => client.discoverSalvageCandidates(request),
+    createModernizationWorkPacket: (request) => client.createModernizationWorkPacket(request),
+    requestModernizationWrapperExecution: (request) => client.requestModernizationWrapperExecution(request),
+    getModernizationWrapperEvidence: (request) => client.getModernizationWrapperEvidence(request),
+    decideModernizationGate: (request) => client.decideModernizationGate(request),
+  };
+}

package/src/index.js

@@ -1,5 +1,5 @@
 export { AIEngineClient, createAIEngineClient } from './client.js';
-export const AI_ENGINE_CLIENT_VERSION = '1.1.78';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.81';
 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 {