@aifabrix/builder 2.54.1 → 2.55.0

package/lib/role-assistant/test-runner-respond-body.js

@@ -0,0 +1,36 @@
+/**
+ * Keep human.respond bodies on the OpenAPI request shape.
+ * WaitPayload.prompt is server-owned and must not be echoed.
+ * @fileoverview Strip extra wait fields from RA respond payloads
+ */
+
+'use strict';
+
+const HUMAN_RESPOND_KEYS = [
+  'respondIdempotencyKey',
+  'answerType',
+  'value',
+  'evidenceRef',
+  'declined',
+  'selectedOptionId',
+  'approvalDecision',
+  'proposedPatch',
+  'requestVersion',
+  'stateVersionRef',
+  'requestFingerprint'
+];
+
+function pickHumanRespondBody(payload) {
+  const out = {};
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+    return out;
+  }
+  for (const key of HUMAN_RESPOND_KEYS) {
+    if (payload[key] !== undefined) {
+      out[key] = payload[key];
+    }
+  }
+  return out;
+}
+
+module.exports = { pickHumanRespondBody };

package/lib/role-assistant/test-runner-search.js

@@ -9,6 +9,7 @@
 'use strict';
 
 const { getWorkSkills, searchWork } = require('../api/work-search.api');
+const { resourceTypesMap } = require('../search/search-skills');
 const { roleAssistantSystemKey } = require('../utils/role-assistant-paths');
 const {
   resolveInput,
@@ -32,11 +33,6 @@ function operationKeys(spec) {
   return keys;
 }
 
-function resourceTypesMap(skillsPayload) {
-  const rts = skillsPayload && skillsPayload.search && skillsPayload.search.resourceTypes;
-  return rts && typeof rts === 'object' && !Array.isArray(rts) ? rts : {};
-}
-
 function pickResourceType(skillsPayload, operation) {
   const rts = resourceTypesMap(skillsPayload);
   const keys = Object.keys(rts);
@@ -73,6 +69,24 @@ function assignOptionalNumber(args, input, key) {
   }
 }
 
+function assignGraphFields(args, input) {
+  if (input.graph === true) {
+    args.graph = { depth: 1 };
+  } else if (input.graph && typeof input.graph === 'object' && !Array.isArray(input.graph)) {
+    args.graph = { depth: 1 };
+  }
+  if (typeof input.query === 'string' && input.query.trim()) {
+    args.query = input.query.trim();
+  }
+  if (!Array.isArray(input.knowledgeKeys) || !input.knowledgeKeys.length) {
+    return;
+  }
+  const keys = input.knowledgeKeys.map((item) => String(item || '').trim()).filter(Boolean);
+  if (keys.length) {
+    args.knowledgeKeys = keys;
+  }
+}
+
 function buildSearchArguments(roleRef, input, skillsPayload) {
   const args = { roleRef };
   const resourceType =
@@ -91,6 +105,7 @@ function buildSearchArguments(roleRef, input, skillsPayload) {
   if (Array.isArray(input.fields) && input.fields.length) {
     args.fields = input.fields;
   }
+  assignGraphFields(args, input);
   return args;
 }
 

package/lib/role-assistant/test-runner-start-payload.js

@@ -37,6 +37,16 @@ function resolveInputMessage(testCase) {
   return '';
 }
 
+function applyObjectiveField(payload, message) {
+  if (message) {
+    payload.objective = message;
+    return;
+  }
+  if (typeof payload.content === 'string' && payload.content.trim()) {
+    payload.objective = payload.content.trim();
+  }
+}
+
 function applyStartPayloadOptionalFields(payload, input) {
   const mappedFields = [
     ['activationId', 'activationId'],
@@ -58,34 +68,77 @@ function buildStartPayloadSourceMetadata(roleKey, testCase, input) {
   };
 }
 
-function buildStartIntentPayload(roleKey, testCase) {
-  const input = resolveInputObject(testCase);
-  const message = resolveInputMessage(testCase);
-  const hasContent = typeof input.content !== 'undefined';
+function resolveCaseMetadata(testCase) {
+  if (testCase && typeof testCase.metadata === 'object' && testCase.metadata) {
+    return testCase.metadata;
+  }
+  return {};
+}
+
+function resolveLearningLevel(metadata) {
+  if (typeof metadata.learningLevel === 'string' && metadata.learningLevel.trim()) {
+    return metadata.learningLevel.trim();
+  }
+  return null;
+}
+
+function assertHasStartContent(testCase, hasContent, message) {
   if (!hasContent && !message) {
     throw new Error(
       `Role assistant test case "${testCase.caseId}" is missing input.message or input.content for runtime execution.`
     );
   }
-  const payload = {
+}
+
+function resolveComVocabulary(input) {
+  if (Array.isArray(input.comVocabulary) && input.comVocabulary.length > 0) {
+    return input.comVocabulary.map((row) => String(row));
+  }
+  return ['objective', 'entity', 'action'];
+}
+
+function buildStartIntentBasePayload(roleKey, testCase, input, message, hasContent) {
+  return {
     submissionId: String(input.submissionId || buildRuntimeId(`ra-${roleKey}`)),
     content: hasContent ? input.content : message,
     comModelRef: String(input.comModelRef || 'aifabrix.com/intent/default'),
     comModelVersion: String(input.comModelVersion || '1.0'),
-    comVocabulary:
-      Array.isArray(input.comVocabulary) && input.comVocabulary.length > 0
-        ? input.comVocabulary.map((row) => String(row))
-        : ['objective', 'entity', 'action'],
+    comVocabulary: resolveComVocabulary(input),
     sourceType: String(input.sourceType || 'api'),
     sourceLanguage: String(input.sourceLanguage || 'en'),
     responseLanguage: String(input.responseLanguage || input.sourceLanguage || 'en'),
     sourceMetadata: buildStartPayloadSourceMetadata(roleKey, testCase, input)
   };
-  applyStartPayloadOptionalFields(payload, input);
+}
+
+function applyLearningLevel(payload, learningLevel) {
+  if (learningLevel === null) {
+    return;
+  }
+  payload.learningLevel = learningLevel;
+  payload.sourceMetadata = {
+    ...(payload.sourceMetadata || {}),
+    learningLevel
+  };
+}
+
+function applyStartAttachments(payload, testCase) {
   const attachments = buildStartAttachments(testCase);
   if (attachments && attachments.length > 0) {
     payload.attachments = attachments;
   }
+}
+
+function buildStartIntentPayload(roleKey, testCase) {
+  const input = resolveInputObject(testCase);
+  const message = resolveInputMessage(testCase);
+  const hasContent = typeof input.content !== 'undefined';
+  assertHasStartContent(testCase, hasContent, message);
+  const payload = buildStartIntentBasePayload(roleKey, testCase, input, message, hasContent);
+  applyObjectiveField(payload, message);
+  applyStartPayloadOptionalFields(payload, input);
+  applyLearningLevel(payload, resolveLearningLevel(resolveCaseMetadata(testCase)));
+  applyStartAttachments(payload, testCase);
   return payload;
 }
 

package/lib/role-assistant/test-runner-workhub-answers.js

@@ -11,6 +11,7 @@ const {
   resolveSuiteRunId,
   loadCaseBidDocument
 } = require('./test-runner-bid-document');
+const { pickHumanRespondBody } = require('./test-runner-respond-body');
 
 function resolveWorkHubAnswerValue(answer) {
   if (answer === null || answer === undefined) {
@@ -31,24 +32,41 @@ function resolveWorkHubAnswerValue(answer) {
   return undefined;
 }
 
+function asPlainObject(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return {};
+  }
+  return value;
+}
+
+function firstNormalizedKey(candidates) {
+  for (const part of candidates) {
+    const text = String(part || '').trim().toLowerCase();
+    if (text) {
+      return text;
+    }
+  }
+  return '';
+}
+
+function waitQuestionKey(wait) {
+  const row = asPlainObject(wait);
+  const objectRef = asPlainObject(row.objectRef);
+  return firstNormalizedKey([row.questionKey, row.requestKey, objectRef.capabilityKey]);
+}
+
+function answerWhenKey(entry) {
+  const when = asPlainObject(asPlainObject(entry).when);
+  return firstNormalizedKey([when.questionKey, when.requestKey, when.key]);
+}
+
 function pickAnswerForWait(answers, wait) {
-  const questionKey = String(wait.questionKey || wait.requestKey || '').trim().toLowerCase();
+  const questionKey = waitQuestionKey(wait);
   if (!questionKey) {
     return null;
   }
-  for (const entry of answers) {
-    if (!entry || typeof entry !== 'object') {
-      continue;
-    }
-    const when = entry.when && typeof entry.when === 'object' ? entry.when : {};
-    const matchKey = String(when.questionKey || when.requestKey || when.key || '')
-      .trim()
-      .toLowerCase();
-    if (matchKey && matchKey === questionKey) {
-      return entry;
-    }
-  }
-  return null;
+  const list = Array.isArray(answers) ? answers : [];
+  return list.find((entry) => answerWhenKey(entry) === questionKey) || null;
 }
 
 function parseFieldsFromPrompt(prompt) {
@@ -423,14 +441,25 @@ function buildRespondPayload(peId, wait, testCase, statusRow, interactions, obje
   };
   if (answerType === 'approval') {
     payload.approvalDecision = 'approved';
-    return payload;
+    return pickHumanRespondBody(payload);
   }
   const value = resolveRespondValue(testCase, wait, statusRow, objective);
   if (value === undefined) {
     return null;
   }
+  const choiceIds = Array.isArray(wait.allowedChoiceIds) ? wait.allowedChoiceIds : [];
+  const isChoice =
+    String(wait.interactionKind || '').toLowerCase() === 'choice' || choiceIds.length > 0;
+  if (isChoice) {
+    const selected = typeof value === 'string' ? value.trim() : '';
+    if (!selected) {
+      return null;
+    }
+    payload.selectedOptionId = selected;
+    return pickHumanRespondBody(payload);
+  }
   payload.value = value;
-  return payload;
+  return pickHumanRespondBody(payload);
 }
 
 module.exports = {

package/lib/role-assistant/test-runner-workhub.js

@@ -14,8 +14,7 @@ const {
   approveWorkTask,
   getWorkExecutionStatus,
   respondWorkExecution,
-  continueWorkExecution,
-  getWorkExecutionResult
+  continueWorkExecution
 } = require('../api/work.api');
 const {
   synthesizeWaitAnswer,
@@ -367,16 +366,9 @@ async function pollWorkHubTask(dataplaneUrl, authConfig, taskId, testCase, optio
   };
 }
 
-async function fetchBusinessResult(dataplaneUrl, authConfig, processExecutionId) {
-  try {
-    const workResult = await getWorkExecutionResult(dataplaneUrl, authConfig, processExecutionId, {
-      requestedDepth: 'business',
-      format: 'json'
-    });
-    return { workResult, workResultError: null };
-  } catch (error) {
-    return { workResult: null, workResultError: error.message || String(error) };
-  }
+async function fetchBusinessResult(dataplaneUrl, authConfig, processExecutionId, options = {}) {
+  const { fetchWorkHubResult } = require('./test-runner-debug');
+  return fetchWorkHubResult(dataplaneUrl, authConfig, processExecutionId, options);
 }
 
 function buildWorkHubLifecycleResult(roleKey, testCase, started, pollState, peBundle) {
@@ -406,6 +398,38 @@ function buildWorkHubLifecycleResult(roleKey, testCase, started, pollState, peBu
   };
 }
 
+async function finishWorkHubAfterPoll(args) {
+  const {
+    roleKey,
+    testCase,
+    started,
+    pollState,
+    dataplaneUrl,
+    authConfig,
+    options
+  } = args;
+  const processExecutionId = extractPeFromTask(pollState.finalTask);
+  if (!processExecutionId) {
+    throw new Error(`Work Hub task ${started.taskId} finished without processExecutionId.`);
+  }
+  const { persistRoleAssistantDebugLog } = require('./test-runner-debug');
+  const peBundle = {
+    processExecutionId,
+    ...(await fetchBusinessResult(dataplaneUrl, authConfig, processExecutionId, options))
+  };
+  await persistRoleAssistantDebugLog(
+    roleKey,
+    {
+      processExecutionId,
+      requestedDepth: options && options.debug === true ? 'technical' : 'business',
+      workResult: peBundle.workResult,
+      workResultError: peBundle.workResultError
+    },
+    options
+  );
+  return buildWorkHubLifecycleResult(roleKey, testCase, started, pollState, peBundle);
+}
+
 async function runWorkHubCaseLifecycle(roleKey, testCase, runtimeContext, options = {}) {
   const { startWorkHubOrSoftClarify } = require('./test-runner-workhub-soft');
   const dataplaneUrl = runtimeContext?.dataplaneUrl;
@@ -440,15 +464,15 @@ async function runWorkHubCaseLifecycle(roleKey, testCase, runtimeContext, option
     testCase,
     options
   );
-  const processExecutionId = extractPeFromTask(pollState.finalTask);
-  if (!processExecutionId) {
-    throw new Error(`Work Hub task ${started.taskId} finished without processExecutionId.`);
-  }
-  const peBundle = {
-    processExecutionId,
-    ...(await fetchBusinessResult(dataplaneUrl, authConfig, processExecutionId))
-  };
-  return buildWorkHubLifecycleResult(roleKey, testCase, started, pollState, peBundle);
+  return finishWorkHubAfterPoll({
+    roleKey,
+    testCase,
+    started,
+    pollState,
+    dataplaneUrl,
+    authConfig,
+    options
+  });
 }
 
 module.exports = {

package/lib/role-assistant/test-runner.js

@@ -24,6 +24,7 @@ const {
   resolveInputObject,
   resolveInputMessage
 } = require('./test-runner-start-payload');
+const { pickHumanRespondBody } = require('./test-runner-respond-body');
 const TERMINAL_STATUSES = new Set(['completed', 'stopped']);
 const WAITING_STATUS = 'waiting';
 
@@ -74,6 +75,7 @@ function isExecutableRoleAssistantCase(testCase) {
 
 function extractProcessExecutionId(startResponse) {
   const candidates = [
+    startResponse?.work?.processExecutionId,
     startResponse?.intent?.processExecutionId,
     startResponse?.processExecutionId,
     startResponse?.status?.processExecutionId
@@ -111,6 +113,8 @@ function collectWaitMatchTokens(wait) {
     add(wait.objectRef.name);
     add(wait.objectRef.type);
     add(wait.objectRef.id);
+    add(wait.objectRef.capabilityKey);
+    add(wait.objectRef.resourceType);
   }
   if (wait.safeProjection && typeof wait.safeProjection === 'object') {
     add(wait.safeProjection.capabilityKey);
@@ -197,22 +201,40 @@ function applyWaitVersioningFields(payload, wait) {
   applyOptionalStringField(payload, wait.requestFingerprint, 'requestFingerprint');
 }
 
+function waitIsChoice(wait) {
+  const ids = wait && Array.isArray(wait.allowedChoiceIds) ? wait.allowedChoiceIds : [];
+  return String((wait && wait.interactionKind) || '').toLowerCase() === 'choice' || ids.length > 0;
+}
+
+function choiceIdFromAnswer(answerEntry, respond) {
+  if (typeof respond.selectedOptionId === 'string' && respond.selectedOptionId.trim()) {
+    return respond.selectedOptionId.trim();
+  }
+  if (typeof answerEntry?.value === 'string' && answerEntry.value.trim()) {
+    return answerEntry.value.trim();
+  }
+  return '';
+}
+
 function buildAskRespondPayload(answerEntry, wait) {
   const respond = answerEntry && typeof answerEntry.respond === 'object' && answerEntry.respond
     ? answerEntry.respond
     : {};
   const payload = {
     respondIdempotencyKey: buildRuntimeId('ra-answer'),
-    answerType: 'ask',
-    value: resolveAskRespondValue(respond)
+    answerType: 'ask'
   };
-  applyOptionalStringField(payload, respond.selectedOptionId, 'selectedOptionId');
-  applyOptionalStringField(payload, respond.evidenceRef, 'evidenceRef');
+  if (waitIsChoice(wait)) {
+    applyOptionalStringField(payload, choiceIdFromAnswer(answerEntry, respond), 'selectedOptionId');
+  } else {
+    payload.value = resolveAskRespondValue(Object.keys(respond).length ? respond : answerEntry);
+    applyOptionalStringField(payload, respond.evidenceRef, 'evidenceRef');
+  }
   if (respond.declined === true) {
     payload.declined = true;
   }
   applyWaitVersioningFields(payload, wait);
-  return payload;
+  return pickHumanRespondBody(payload);
 }
 
 function buildApprovalRespondPayload(approvalEntry, wait) {
@@ -228,7 +250,7 @@ function buildApprovalRespondPayload(approvalEntry, wait) {
     approvalDecision: decision
   };
   applyWaitVersioningFields(payload, wait);
-  return payload;
+  return pickHumanRespondBody(payload);
 }
 
 function buildStatusSnapshot(statusRow) {
@@ -247,7 +269,8 @@ function buildRunnerOptions(options = {}) {
   return {
     maxStatusPolls: Number.isFinite(maxStatusPolls) && maxStatusPolls > 0 ? maxStatusPolls : 20,
     statusPollIntervalMs:
-      Number.isFinite(statusPollIntervalMs) && statusPollIntervalMs >= 0 ? statusPollIntervalMs : 750
+      Number.isFinite(statusPollIntervalMs) && statusPollIntervalMs >= 0 ? statusPollIntervalMs : 750,
+    debug: options.debug === true
   };
 }
 
@@ -270,6 +293,18 @@ function finalizeWaitingAdvanceStatus(respondResult, continueResult) {
     : afterRespondStatus;
 }
 
+async function continueAfterRespond(dataplaneUrl, authConfig, processExecutionId) {
+  try {
+    return await continueWorkExecution(dataplaneUrl, authConfig, processExecutionId, {});
+  } catch (error) {
+    const text = String(error && error.message ? error.message : error);
+    if (/already terminal/i.test(text)) {
+      return getWorkExecutionStatus(dataplaneUrl, authConfig, processExecutionId);
+    }
+    throw error;
+  }
+}
+
 async function advanceApprovalWaitingExecution(context, approvals, wait) {
   const { dataplaneUrl, authConfig, processExecutionId, usedApprovalIndexes } = context;
   const match = findMatchingEntry(approvals, usedApprovalIndexes, wait);
@@ -279,7 +314,7 @@ async function advanceApprovalWaitingExecution(context, approvals, wait) {
   usedApprovalIndexes.add(match.index);
   const payload = buildApprovalRespondPayload(match.entry, wait);
   const respondResult = await respondWorkExecution(dataplaneUrl, authConfig, processExecutionId, payload);
-  const continueResult = await continueWorkExecution(dataplaneUrl, authConfig, processExecutionId, {});
+  const continueResult = await continueAfterRespond(dataplaneUrl, authConfig, processExecutionId);
   return {
     status: finalizeWaitingAdvanceStatus(respondResult, continueResult),
     matched: true,
@@ -297,7 +332,7 @@ async function advanceAskWaitingExecution(context, answers, wait) {
   usedAnswerIndexes.add(match.index);
   const payload = buildAskRespondPayload(match.entry, wait);
   const respondResult = await respondWorkExecution(dataplaneUrl, authConfig, processExecutionId, payload);
-  const continueResult = await continueWorkExecution(dataplaneUrl, authConfig, processExecutionId, {});
+  const continueResult = await continueAfterRespond(dataplaneUrl, authConfig, processExecutionId);
   return {
     status: finalizeWaitingAdvanceStatus(respondResult, continueResult),
     matched: true,
@@ -344,7 +379,11 @@ async function pollCaseExecutionStatus(dataplaneUrl, authConfig, processExecutio
         type: advanced.interactionType,
         waitReason: wait.waitReason || wait.answerType || wait.interactionKind || null,
         matched: advanced.matched === true,
-        questionKey: wait.questionKey || wait.requestKey || null
+        questionKey:
+          wait.questionKey ||
+          wait.requestKey ||
+          (wait.objectRef && wait.objectRef.capabilityKey) ||
+          null
       });
       if (!advanced.matched || !advanced.status) {
         break;
@@ -451,6 +490,7 @@ function lifecycleVerdictFromCaseExecution(executionResult, fallbackVerdict) {
 module.exports = {
   isExecutableRoleAssistantCase,
   buildStartIntentPayload,
+  buildRunnerOptions,
   runRoleAssistantCaseLifecycle,
   mergeCaseExecutionIntoLifecycleResult,
   lifecycleVerdictFromCaseExecution

package/lib/schema/external-datasource.schema.json

@@ -7,12 +7,12 @@
          "key":"external-datasource-schema",
          "name":"External Data Source Configuration Schema",
          "description":"JSON schema for validating ExternalDataSource configuration files",
-     "version":"2.9.9",
+     "version":"2.9.11",
          "type":"schema",
          "category":"integration",
          "author":"AI Fabrix Team",
          "createdAt":"2024-01-01T00:00:00Z",
-         "updatedAt":"2026-08-27T00:00:00Z",
+         "updatedAt":"2026-08-30T00:00:00Z",
          "compatibility":{
             "minVersion":"1.0.0",
             "maxVersion":"3.0.0",
@@ -31,6 +31,22 @@
          "external-system.schema.json"
       ],
       "changelog":[
+         {
+            "version":"2.9.11",
+            "date":"2026-08-30T00:00:00Z",
+            "changes":[
+               "Documented fieldMappings.attributes.expression closed pipe-function allow-list (toLower, toUpper, trim, substring, replace, default, coalesce, join, split, normalizeWhitespace, index). CIP $defs unchanged (543 visual N/A)."
+            ],
+            "breaking":false
+         },
+         {
+            "version":"2.9.10",
+            "date":"2026-08-29T00:00:00Z",
+            "changes":[
+               "Added optional sync.incrementalKey (CIP list fetch.query filter already on the list operation) and optional sync.incrementalSchedule (only when incrementalKey is set). schedule is the full-set (sync all) cron. CIP $defs unchanged (543 visual N/A)."
+            ],
+            "breaking":false
+         },
          {
             "version":"2.9.9",
             "date":"2026-08-27T00:00:00Z",
@@ -623,7 +639,7 @@
                         "properties":{
                            "expression":{
                               "type":"string",
-                              "description":"Pipe-based DSL expression. Allowed roots: raw.<path>, fk.<fk>.metadata.<field>, fk.<fk>.dimension.<dimension>[.label], dimension.<dimension>[.label]. FK traversal in DSL is one-hop only.",
+                              "description":"Pipe-based DSL expression. Allowed roots: raw.<path>, fk.<fk>.metadata.<field>, fk.<fk>.dimension.<dimension>[.label], dimension.<dimension>[.label]. FK traversal in DSL is one-hop only. Closed pipe functions: toLower, toUpper, trim, substring, replace, default, coalesce, join, split, normalizeWhitespace, index.",
                               "maxLength":512,
                               "pattern":"^\\s*\\{\\{(raw\\.[a-zA-Z0-9_\\[\\].]+|fk\\.[a-z][a-zA-Z0-9]*\\.metadata\\.[a-z][a-zA-Z0-9]*|fk\\.[a-z][a-zA-Z0-9]*\\.dimension\\.[a-zA-Z0-9_]+(\\.label)?|dimension\\.[a-zA-Z0-9_]+(\\.label)?)\\}\\}(\\s*\\|\\s*[a-zA-Z0-9_]+(\\([^)]*\\))?)*\\s*$"
                            },
@@ -857,7 +873,7 @@
             },
             "schedule":{
                "type":"string",
-               "description":"Cron schedule for sync execution. Supports 5-field cron syntax or @hourly/@daily/@weekly/@monthly.",
+               "description":"Cron for full-set (sync all) jobs. Supports 5-field cron syntax or @hourly/@daily/@weekly/@monthly.",
                "pattern":"^(@hourly|@daily|@weekly|@monthly|([0-9*/,-]+\\s+){4}[0-9*/,-]+)$"
             },
             "batchSize":{
@@ -865,8 +881,23 @@
                "minimum":1,
                "maximum":10000,
                "default":500
+            },
+            "incrementalKey":{
+               "type":"string",
+               "description":"Name of the list CIP fetch.query filter already authored on the list operation. Must map to a metadataSchema field of type date, date-time, or integer (unix time). Incremental jobs bind lastSyncedAt into that key. Never inferred from field names.",
+               "pattern":"^[a-zA-Z_$][a-zA-Z0-9_$]*$"
+            },
+            "incrementalSchedule":{
+               "type":"string",
+               "description":"Optional cron for incremental jobs. Allowed only when incrementalKey is set. schedule remains the full-set (sync all) cron.",
+               "pattern":"^(@hourly|@daily|@weekly|@monthly|([0-9*/,-]+\\s+){4}[0-9*/,-]+)$"
             }
          },
+         "dependentRequired":{
+            "incrementalSchedule":[
+               "incrementalKey"
+            ]
+         },
          "additionalProperties":false
       },
       "openapi":{
@@ -3004,7 +3035,7 @@
                      "description":"Optional inline mapping overrides { normalizedField -> expression }.",
                      "additionalProperties":{
                         "type":"string",
-                        "description":"Pipe-based DSL expression overriding fieldMappings expression."
+                        "description":"Pipe-based DSL expression overriding fieldMappings expression. Same closed function allow-list as fieldMappings.attributes.expression."
                      }
                   }
                },

package/lib/schema/external-system.schema.json

@@ -7,12 +7,12 @@
       "key": "external-system-schema",
       "name": "External System Configuration Schema",
       "description": "JSON schema for validating ExternalSystem configuration files",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "type": "schema",
       "category": "integration",
       "author": "AI Fabrix Team",
       "createdAt": "2024-01-01T00:00:00Z",
-      "updatedAt": "2026-08-23T00:00:00Z",
+      "updatedAt": "2026-08-28T00:00:00Z",
       "compatibility": {
          "minVersion": "1.4.0",
          "maxVersion": "2.0.0",
@@ -27,6 +27,14 @@
       ],
       "dependencies": [],
       "changelog": [
+         {
+            "version": "1.17.0",
+            "date": "2026-08-28T00:00:00Z",
+            "changes": [
+               "Added optional channel.status (visible | hide | coming-soon) for Channel Definition catalog and install. Omit for visible. hide: omitted from catalog and refused for new install. coming-soon: catalog read-only, new install refused."
+            ],
+            "breaking": false
+         },
          {
             "version": "1.16.0",
             "date": "2026-08-23T00:00:00Z",
@@ -1789,6 +1797,16 @@
                "type": "boolean",
                "default": false
             },
+            "status": {
+               "type": "string",
+               "enum": [
+                  "visible",
+                  "hide",
+                  "coming-soon"
+               ],
+               "default": "visible",
+               "description": "Channel catalog and install availability. Omit or visible: listed and installable. hide: omitted from the catalog; new install is refused (CLI and API). coming-soon: listed read-only with a coming-soon indication; new install is refused (CLI and API). Does not disable existing installations. Distinct from experimental (opt-in CLI)."
+            },
             "maxInstances": {
                "type": "integer",
                "minimum": 1,