@bpmsoftwaresolutions/ai-engine-client 1.1.103 → 1.1.105

package/package.json

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

package/src/client.js

@@ -11,16 +11,11 @@ import { createImplementationTasksDomain } from './domains/implementation-tasks.
 import { createCurrentProjectDomain } from './domains/operator/current-project.js';
 import { createGatewayDomain } from './domains/gateway.js';
 import { createHealthDomain } from './domains/health.js';
-import { createLogaDomain } from './domains/loga.js';
 import { createNotesLabDomain } from './domains/notes-lab.js';
 import { createCommunicationTicketsDomain } from './domains/communication-tickets.js';
 import { createPortfolioDomain } from './domains/portfolio.js';
-import { createProjectReportsDomain } from './domains/project-reports.js';
-import { createProjectResumeDomain } from './domains/project-resume.js';
 import { createGovernedImplementationDomain } from './domains/governed-implementation.js';
-import { createProjectionsDomain } from './domains/projections.js';
 import { createReportsDomain } from './domains/reports.js';
-import { createRoadmapReportsDomain } from './domains/roadmap-reports.js';
 import { createPerformanceDomain } from './domains/performance.js';
 import { createImplementationArtifactsDomain } from './domains/implementation-artifacts.js';
 import { createImplementationChecksDomain } from './domains/implementation-checks.js';
@@ -29,15 +24,10 @@ import { createImplementationGatesDomain } from './domains/implementation-gates.
 import { createImplementationPacketsDomain } from './domains/implementation-packets.js';
 import { createImplementationItemsDomain } from './domains/implementation-items.js';
 import { createRepoDomain } from './domains/repo.js';
-import { createProjectCharteringDomain } from './domains/project-chartering.js';
-import { createProjectsDomain } from './domains/projects.js';
 import { createRefactoringTransfersDomain } from './domains/refactoring-transfers.js';
 import { createOperatorStatusDomain } from './domains/operator-status.js';
-import { createRoadmapsDomain } from './domains/roadmaps.js';
 import { createScriptDiscoveryDomain } from './domains/script-discovery.js';
 import { createScriptsDomain } from './domains/scripts.js';
-import { createRetrievalManagementDomain } from './domains/retrieval-management.js';
-import { createRetrievalWrapperDomain } from './domains/retrieval-wrapper.js';
 import { createSelfLearningDomain } from './domains/self-learning.js';
 import { createSelfOptimizationDomain } from './domains/self-optimization.js';
 import { createSkillGovernanceDomain } from './domains/skill-governance.js';
@@ -69,6 +59,7 @@ import { createToolRegistryDomain } from './domains/tool-registry.js';
 import { createWorkflowCompositionDomain } from './domains/workflow-composition.js';
 import { createWorkflowsDomain } from './domains/workflows.js';
 import { createWarehouseDomain } from './domains/warehouse.js';
+import { createLogaProjectionSurface, createProjectRoadmapSurface, createRetrievalSurface } from './domains/surface-groups.js';
 import { installClientCompatibilityDelegates } from './compat/aliases.js';
 import { buildHeaders, requestBinary, requestJson, requestLogaProjection, requestText, resolveAccessToken } from './transport/index.js';
 import { cleanText, isPlainObject, trimTrailingSlash } from './utils/text.js';
@@ -97,10 +88,7 @@ export class AIEngineClient {
       currentProject: createCurrentProjectDomain(this),
     };
     this.database = createDatabaseDomain(this);
-    this.projects = createProjectsDomain(this);
-    this.projectChartering = createProjectCharteringDomain(this);
-    this.projectReports = createProjectReportsDomain(this);
-    this.projectResume = createProjectResumeDomain(this);
+    Object.assign(this, createProjectRoadmapSurface(this));
     this.claims = createClaimsDomain(this);
     this.sessionGovernance = createSessionGovernanceDomain(this);
     this.executionEligibility = createExecutionEligibilityDomain(this);
@@ -113,8 +101,6 @@ export class AIEngineClient {
     this.charters = createChartersDomain(this);
     this.workStart = createWorkStartDomain(this);
     this.governedImplementation = createGovernedImplementationDomain(this);
-    this.roadmaps = createRoadmapsDomain(this);
-    this.roadmapReports = createRoadmapReportsDomain(this);
     this.implementationPackets = createImplementationPacketsDomain(this);
     this.implementationItems = createImplementationItemsDomain(this);
     this.implementationArtifacts = createImplementationArtifactsDomain(this);
@@ -129,9 +115,8 @@ export class AIEngineClient {
     this.designIntelligence = createDesignIntelligenceDomain(this);
     this.executionTelemetry = createExecutionTelemetryDomain(this);
     this.performance = createPerformanceDomain(this);
-    this.retrievalWrapper = createRetrievalWrapperDomain(this);
     this.repo = createRepoDomain(this);
-    this.retrievalManagement = createRetrievalManagementDomain(this);
+    Object.assign(this, createRetrievalSurface(this));
     this.workflows = createWorkflowsDomain(this);
     this.capabilities = createCapabilitiesDomain(this);
     this.benchmarks = createBenchmarksDomain(this);
@@ -141,10 +126,9 @@ export class AIEngineClient {
     this.searchContacts = createSearchContactsDomain(this);
     this.notesLab = createNotesLabDomain(this);
     this.portfolio = createPortfolioDomain(this);
-    this.loga = createLogaDomain(this);
     this.scripts = createScriptsDomain(this);
     this.reports = createReportsDomain(this);
-    this.projections = createProjectionsDomain(this);
+    Object.assign(this, createLogaProjectionSurface(this));
     this.workflowComposition = createWorkflowCompositionDomain(this);
     this.workflowComposition.searchCodeByIntent = (request) => this.searchCodeByIntent(request);
     this.warehouse = createWarehouseDomain(this);

package/src/domains/surface-groups.js

@@ -0,0 +1,35 @@
+import { createLogaDomain } from './loga.js';
+import { createProjectCharteringDomain } from './project-chartering.js';
+import { createProjectReportsDomain } from './project-reports.js';
+import { createProjectResumeDomain } from './project-resume.js';
+import { createProjectsDomain } from './projects.js';
+import { createProjectionsDomain } from './projections.js';
+import { createRoadmapReportsDomain } from './roadmap-reports.js';
+import { createRoadmapsDomain } from './roadmaps.js';
+import { createRetrievalManagementDomain } from './retrieval-management.js';
+import { createRetrievalWrapperDomain } from './retrieval-wrapper.js';
+
+export function createProjectRoadmapSurface(client) {
+  return {
+    projects: createProjectsDomain(client),
+    projectChartering: createProjectCharteringDomain(client),
+    projectReports: createProjectReportsDomain(client),
+    projectResume: createProjectResumeDomain(client),
+    roadmaps: createRoadmapsDomain(client),
+    roadmapReports: createRoadmapReportsDomain(client),
+  };
+}
+
+export function createLogaProjectionSurface(client) {
+  return {
+    loga: createLogaDomain(client),
+    projections: createProjectionsDomain(client),
+  };
+}
+
+export function createRetrievalSurface(client) {
+  return {
+    retrievalWrapper: createRetrievalWrapperDomain(client),
+    retrievalManagement: createRetrievalManagementDomain(client),
+  };
+}

package/src/index.js

@@ -1,6 +1,12 @@
 export { AIEngineClient, createAIEngineClient } from './client.js';
-export const AI_ENGINE_CLIENT_VERSION = '1.1.103';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.105';
 export { GOVERNED_MUTATION_REQUIRED_CAPABILITIES, AI_ENGINE_CLIENT_CAPABILITIES, TASK_BOUND_SUBSTRATE_EXECUTION_POLICY } from './constants/governance.js';
+export {
+  TASK_ACTION_VERB_REGISTRY,
+  acceptedLegacyTaskActions,
+  listTaskActionVerbInventory,
+  normalizeTaskActionVerb,
+} from './utils/task-binding.js';
 export { LOGA_CONTRACT, LOGA_INTERACTION_CONTRACT, LOGA_NAVIGATION_CONTRACT, LOGA_PROJECTION_WORKFLOW } from './constants/loga.js';
 export {
   AGENT_COMMUNICATION_CONTRACT_VERSION,

package/src/utils/task-binding.js

@@ -1,13 +1,72 @@
 import { TASK_BOUND_SUBSTRATE_EXECUTION_POLICY } from '../constants/governance.js';
 import { cleanList, cleanText, isPlainObject } from './text.js';
 
+export const TASK_ACTION_VERB_REGISTRY = {
+  add_implementation_item_activity: {
+    surface: 'implementation_item_activity',
+    acceptedLegacyVerbs: ['record_implementation_item_activity'],
+  },
+};
+
+function buildTaskActionAliasIndex(registry) {
+  const aliasToCanonical = new Map();
+  const ambiguousAliases = new Set();
+  for (const [canonicalAction, entry] of Object.entries(registry)) {
+    for (const alias of cleanList(entry.acceptedLegacyVerbs)) {
+      const existing = aliasToCanonical.get(alias);
+      if (existing && existing !== canonicalAction) {
+        ambiguousAliases.add(alias);
+        continue;
+      }
+      aliasToCanonical.set(alias, canonicalAction);
+    }
+  }
+  return { aliasToCanonical, ambiguousAliases };
+}
+
+const TASK_ACTION_ALIAS_INDEX = buildTaskActionAliasIndex(TASK_ACTION_VERB_REGISTRY);
+
+export function listTaskActionVerbInventory() {
+  return Object.entries(TASK_ACTION_VERB_REGISTRY)
+    .sort(([left], [right]) => left.localeCompare(right))
+    .map(([canonicalAction, entry]) => ({
+      canonicalAction,
+      surface: cleanText(entry.surface),
+      acceptedLegacyVerbs: cleanList(entry.acceptedLegacyVerbs),
+    }));
+}
+
+export function acceptedLegacyTaskActions(value = null) {
+  const canonicalActions = Array.isArray(value)
+    ? cleanList(value).map((action) => normalizeTaskActionVerb(action)).filter(Boolean)
+    : Object.keys(TASK_ACTION_VERB_REGISTRY);
+  const canonicalSet = new Set(canonicalActions);
+  const legacyActions = [];
+  for (const [canonicalAction, entry] of Object.entries(TASK_ACTION_VERB_REGISTRY)) {
+    if (!canonicalSet.has(canonicalAction)) continue;
+    for (const alias of cleanList(entry.acceptedLegacyVerbs)) {
+      if (!legacyActions.includes(alias)) legacyActions.push(alias);
+    }
+  }
+  return legacyActions;
+}
+
+export function normalizeTaskActionVerb(value) {
+  const text = cleanText(value);
+  if (!text) return null;
+  if (TASK_ACTION_ALIAS_INDEX.ambiguousAliases.has(text)) {
+    throw new Error(`Ambiguous task action alias "${text}"; promote or disambiguate the canonical verb registry.`);
+  }
+  return TASK_ACTION_ALIAS_INDEX.aliasToCanonical.get(text) || text;
+}
+
 export function normalizeTaskBindingPolicy(taskBinding, { expectedAction = null } = {}) {
   if (!isPlainObject(taskBinding)) return taskBinding;
   const taskId = cleanText(taskBinding.task_id || taskBinding.implementation_item_task_id);
   const roadmapItemId = cleanText(taskBinding.roadmap_item_id || taskBinding.implementation_item_id);
   const taskStatus = cleanText(taskBinding.task_status || taskBinding.status);
-  const allowedActions = cleanList(taskBinding.allowed_actions);
-  const substrateAction = cleanText(taskBinding.substrate_action) || cleanText(expectedAction);
+  const allowedActions = cleanList(taskBinding.allowed_actions).map((action) => normalizeTaskActionVerb(action)).filter(Boolean);
+  const substrateAction = normalizeTaskActionVerb(taskBinding.substrate_action) || normalizeTaskActionVerb(expectedAction);
   return {
     ...taskBinding,
     ...(taskId ? { task_id: taskId } : {}),