@aifabrix/builder 2.52.0 → 2.53.0

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

@@ -0,0 +1,112 @@
+/**
+ * Role Assistant suite discovery for multi-case CLI runs.
+ * @fileoverview Discover YAML cases under tests/ra-* / package tests/
+ */
+
+'use strict';
+
+const path = require('path');
+const fs = require('../internal/fs-real-sync');
+const { bareRoleKey, roleAssistantSystemKey } = require('../utils/role-assistant-paths');
+
+/**
+ * Candidate case roots (first existing wins).
+ * 1. tests/<ra-key>/<role-key>/
+ * 2. tests/role-assistant/<ra-key>/ (legacy)
+ * 3. role-assistant/<ra-key>/tests/
+ * @param {string} roleKey
+ * @param {string} cwd
+ * @returns {string[]}
+ */
+function listCasesRootCandidates(roleKey, cwd) {
+  const bare = bareRoleKey(roleKey);
+  const raKey = roleAssistantSystemKey(bare);
+  return [
+    path.join(cwd, 'tests', raKey, bare),
+    path.join(cwd, 'tests', 'role-assistant', raKey),
+    path.join(cwd, 'role-assistant', raKey, 'tests')
+  ];
+}
+
+/**
+ * Resolve cases root for a role.
+ * @param {string} roleKey
+ * @param {{ casesRoot?: string, cwd?: string }} [options]
+ * @returns {string}
+ */
+function resolveCasesRoot(roleKey, options = {}) {
+  if (options.casesRoot) {
+    return path.resolve(String(options.casesRoot));
+  }
+  const cwd = options.cwd || process.cwd();
+  const candidates = listCasesRootCandidates(roleKey, cwd);
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  // Prefer package path in errors — primary authoring location when repo-root tests/ is absent.
+  return candidates[candidates.length - 1];
+}
+
+/**
+ * @param {string} casesRoot
+ * @param {{ suite?: string }} [options]
+ * @returns {Array<{ suite: string, file: string, absPath: string, caseIdHint: string }>}
+ */
+function discoverSuiteCaseFiles(casesRoot, options = {}) {
+  if (!fs.existsSync(casesRoot)) {
+    return [];
+  }
+  const suiteFilter = options.suite ? String(options.suite).trim() : '';
+  const rows = [];
+  for (const ent of fs.readdirSync(casesRoot, { withFileTypes: true })) {
+    if (!ent.isDirectory() || String(ent.name).startsWith('.')) {
+      continue;
+    }
+    if (suiteFilter && ent.name !== suiteFilter) {
+      continue;
+    }
+    const suitePath = path.join(casesRoot, ent.name);
+    for (const fileEnt of fs.readdirSync(suitePath, { withFileTypes: true })) {
+      const name = fileEnt.name;
+      if (!fileEnt.isFile() || !/\.(ya?ml)$/i.test(name)) {
+        continue;
+      }
+      const absPath = path.join(suitePath, name);
+      rows.push({
+        suite: ent.name,
+        file: name,
+        absPath,
+        caseIdHint: path.basename(name, path.extname(name))
+      });
+    }
+  }
+  return rows.sort((a, b) => a.absPath.localeCompare(b.absPath));
+}
+
+/**
+ * Filter discovered rows by --case id or basename.
+ * @param {Array<{ absPath: string, caseIdHint: string, file: string }>} rows
+ * @param {string} caseSel
+ * @returns {Array}
+ */
+function filterDiscoveredCases(rows, caseSel) {
+  const sel = String(caseSel || '').trim();
+  if (!sel) {
+    return rows;
+  }
+  return rows.filter((row) => {
+    if (row.absPath === path.resolve(sel) || row.file === sel) {
+      return true;
+    }
+    return row.caseIdHint === sel || row.caseIdHint.endsWith(`-${sel}`) || sel === row.caseIdHint;
+  });
+}
+
+module.exports = {
+  listCasesRootCandidates,
+  resolveCasesRoot,
+  discoverSuiteCaseFiles,
+  filterDiscoveredCases
+};

package/lib/schema/application-schema.json

@@ -7,12 +7,12 @@
     "key": "application-schema",
     "name": "Application Configuration Schema",
     "description": "JSON schema for validating AI Fabrix application configuration files",
-    "version": "1.6.1",
+    "version": "1.6.2",
     "type": "schema",
     "category": "infrastructure",
     "author": "AI Fabrix Team",
     "createdAt": "2024-01-01T00:00:00Z",
-    "updatedAt": "2026-08-03T00:00:00Z",
+    "updatedAt": "2026-08-06T00:00:00Z",
     "compatibility": {
       "minVersion": "1.0.0",
       "maxVersion": "2.0.0",
@@ -30,6 +30,14 @@
       "external-datasource.schema.json"
     ],
     "changelog": [
+      {
+        "version": "1.6.2",
+        "date": "2026-08-06T00:00:00Z",
+        "changes": [
+          "portalInput.options items may be plain strings (including empty for env-default) or {label, value} objects (matches miso-ui Configuration tab and miso-controller types)."
+        ],
+        "breaking": false
+      },
       {
         "version": "1.6.1",
         "date": "2026-08-03T00:00:00Z",
@@ -281,9 +289,30 @@
               },
               "options": {
                 "type": "array",
-                "description": "Options for select fields",
+                "description": "Options for select fields (plain string or {label, value}; empty string allowed for env-default)",
                 "items": {
-                  "type": "string"
+                  "oneOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "object",
+                      "required": [
+                        "label",
+                        "value"
+                      ],
+                      "properties": {
+                        "label": {
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "value": {
+                          "type": "string"
+                        }
+                      },
+                      "additionalProperties": false
+                    }
+                  ]
                 }
               }
             },
@@ -399,9 +428,30 @@
                     },
                     "options": {
                       "type": "array",
-                      "description": "Options for select fields",
+                      "description": "Options for select fields (plain string or {label, value}; empty string allowed for env-default)",
                       "items": {
-                        "type": "string"
+                        "oneOf": [
+                          {
+                            "type": "string"
+                          },
+                          {
+                            "type": "object",
+                            "required": [
+                              "label",
+                              "value"
+                            ],
+                            "properties": {
+                              "label": {
+                                "type": "string",
+                                "minLength": 1
+                              },
+                              "value": {
+                                "type": "string"
+                              }
+                            },
+                            "additionalProperties": false
+                          }
+                        ]
                       }
                     }
                   },

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.5",
+     "version":"2.9.6",
          "type":"schema",
          "category":"integration",
          "author":"AI Fabrix Team",
          "createdAt":"2024-01-01T00:00:00Z",
-         "updatedAt":"2026-07-31T00:00:00Z",
+         "updatedAt":"2026-08-07T00:00:00Z",
          "compatibility":{
             "minVersion":"1.0.0",
             "maxVersion":"3.0.0",
@@ -390,6 +390,12 @@
          "enum":["documentStorage","vectorStore","recordStorage","messageService","serviceContract","none"],
          "description":"Entity type identifier. Defines storage semantics and behavior: 'documentStorage' (creates document storage service with vector-storage), 'vectorStore' (external vector storage system), 'recordStorage' (creates record-based system with metadata sync and access rights), 'messageService' (message service for notifications - Slack, Teams, Email), 'serviceContract' (normalized executable service adapter without persistence — requires metadataSchema, fieldMappings, exposed), 'none' (orchestration/composition only). Required field. Canonical values are camelCase."
       },
+      "storageType":{
+         "type":"string",
+         "enum":["table","view"],
+         "default":"table",
+         "description":"recordStorage persistence mode. 'table' (default) is ordinary synced record storage. 'view' is calculated read-only CIP perspectives with fetch.source viewpoint SQL; not a permanent PostgreSQL VIEW object."
+      },
       "resourceType":{
          "type":"string",
          "pattern":"^[a-z0-9-]+$",
@@ -1307,6 +1313,33 @@
             ]
          }
       },
+      {
+         "if":{
+            "properties":{
+               "storageType":{
+                  "const":"view"
+               }
+            },
+            "required":[
+               "storageType"
+            ]
+         },
+         "then":{
+            "properties":{
+               "entityType":{
+                  "const":"recordStorage"
+               },
+               "execution":{
+                  "type":"object",
+                  "properties":{
+                     "engine":{
+                        "const":"cip"
+                     }
+                  }
+               }
+            }
+         }
+      },
       {
          "if":{
             "properties":{
@@ -2498,11 +2531,12 @@
                   "source":{
                      "type":"string",
                      "enum":[
-                        "openapi",
+                       "openapi",
                        "http",
-                       "datasource"
+                       "datasource",
+                       "viewpoint"
                      ],
-                    "description":"If 'openapi', refer to openapi.operations.*. If 'http', use explicit method/path. If 'datasource', execute another datasource operation."
+                    "description":"If 'openapi', refer to openapi.operations.*. If 'http', use explicit method/path. If 'datasource', execute another datasource operation. If 'viewpoint', execute saved SQL in fetch.query against records storage (storageType view)."
                   },
                   "openapiRef":{
                      "type":"string",
@@ -2555,16 +2589,7 @@
                     "description":"When true, append fetch items to the pipeline accumulator for a following merge step."
                  },
                   "query":{
-                     "type":"object",
-                     "description":"Static query parameters. ABAC/runtime can still override or append at runtime.",
-                     "additionalProperties":{
-                        "type":[
-                           "string",
-                           "number",
-                           "boolean",
-                           "null"
-                        ]
-                     }
+                     "description":"When source is openapi/http/datasource: static query parameter object. When source is viewpoint: non-empty SQL SELECT string. ABAC/runtime may still append supported filters at execution for viewpoint."
                   },
                   "bodyTemplate":{
                      "description":"Optional static request body or template for POST/PUT/PATCH fetches.",
@@ -2606,7 +2631,20 @@
                                  "operationId"
                               ]
                            }
-                        ]
+                        ],
+                        "properties":{
+                           "query":{
+                              "type":"object",
+                              "additionalProperties":{
+                                 "type":[
+                                    "string",
+                                    "number",
+                                    "boolean",
+                                    "null"
+                                 ]
+                              }
+                           }
+                        }
                      }
                   },
                   {
@@ -2621,7 +2659,20 @@
                         "required":[
                            "method",
                            "path"
-                        ]
+                        ],
+                        "properties":{
+                           "query":{
+                              "type":"object",
+                              "additionalProperties":{
+                                 "type":[
+                                    "string",
+                                    "number",
+                                    "boolean",
+                                    "null"
+                                 ]
+                              }
+                           }
+                        }
                      }
                  },
                  {
@@ -2637,9 +2688,44 @@
                           "datasource":{
                              "type":"string",
                              "description":"Target child datasource key. Omitted when parent manifest composition.datasources has two or more entries; runtime resolves via selector input."
+                          },
+                          "query":{
+                             "type":"object",
+                             "additionalProperties":{
+                                "type":[
+                                   "string",
+                                   "number",
+                                   "boolean",
+                                   "null"
+                                ]
+                             }
                           }
                        }
                     }
+                  },
+                  {
+                     "if":{
+                        "properties":{
+                           "source":{
+                              "const":"viewpoint"
+                           }
+                        },
+                        "required":[
+                           "source"
+                        ]
+                     },
+                     "then":{
+                        "required":[
+                           "query"
+                        ],
+                        "properties":{
+                           "query":{
+                              "type":"string",
+                              "minLength":1,
+                              "description":"Saved read-only SQL SELECT for viewpoint fetch. Parameter-free in first implementation."
+                           }
+                        }
+                     }
                   }
                ],
                "additionalProperties":false

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.13.1",
+      "version": "1.14.0",
       "type": "schema",
       "category": "integration",
       "author": "AI Fabrix Team",
       "createdAt": "2024-01-01T00:00:00Z",
-      "updatedAt": "2026-07-22T00:00:00Z",
+      "updatedAt": "2026-08-07T00:00:00Z",
       "compatibility": {
          "minVersion": "1.4.0",
          "maxVersion": "2.0.0",
@@ -27,6 +27,14 @@
       ],
       "dependencies": [],
       "changelog": [
+         {
+            "version": "1.14.0",
+            "date": "2026-08-07T00:00:00Z",
+            "changes": [
+               "Added authentication.authType system for platform-managed downstream auth (no credential/apiProvider; ownership only — not autonomous system actor)."
+            ],
+            "breaking": false
+         },
          {
             "version": "1.13.1",
             "date": "2026-07-22T00:00:00Z",
@@ -806,6 +814,7 @@
                "enum": [
                   "credential",
                   "apiProvider",
+                  "system",
                   "none"
                ]
             },
@@ -845,6 +854,36 @@
                      "apiProvider"
                   ]
                }
+            },
+            {
+               "if": {
+                  "properties": {
+                     "authType": {
+                        "const": "system"
+                     }
+                  }
+               },
+               "then": {
+                  "properties": {
+                     "credential": false,
+                     "apiProvider": false
+                  }
+               }
+            },
+            {
+               "if": {
+                  "properties": {
+                     "authType": {
+                        "const": "none"
+                     }
+                  }
+               },
+               "then": {
+                  "properties": {
+                     "credential": false,
+                     "apiProvider": false
+                  }
+               }
             }
          ]
       }
@@ -1039,7 +1078,7 @@
          "default": false
       },
       "authentication": {
-         "description": "Nested authentication: authType credential (local template), apiProvider (Miso delegated), or none. Deprecated — prefer authentications[] with usage.",
+         "description": "Nested authentication: authType credential (local template), apiProvider (Miso delegated), system (platform-managed downstream auth ownership), or none (downstream anonymous). Deprecated — prefer authentications[] with usage.",
          "oneOf": [
             {
                "type": "object",
@@ -1073,6 +1112,18 @@
                },
                "additionalProperties": false
             },
+            {
+               "type": "object",
+               "required": [
+                  "authType"
+               ],
+               "properties": {
+                  "authType": {
+                     "const": "system"
+                  }
+               },
+               "additionalProperties": false
+            },
             {
                "type": "object",
                "required": [

package/lib/schema/integration-definition.schema.json

@@ -0,0 +1,195 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "aifabrix://schema/integration-definition.schema.json",
+  "title": "AI Fabrix Builder Integration Definition (BID)",
+  "description": "Canonical BT → Builder integration definition. Schema name aifabrix.builder.integrationDefinition v1.0.0.",
+  "metadata": {
+    "key": "integration-definition-schema",
+    "name": "Builder Integration Definition",
+    "version": "1.0.0",
+    "schemaName": "aifabrix.builder.integrationDefinition",
+    "type": "schema",
+    "category": "integration",
+    "author": "AI Fabrix Team",
+    "createdAt": "2026-08-04T00:00:00Z",
+    "updatedAt": "2026-08-04T00:00:00Z"
+  },
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaName",
+    "schemaVersion",
+    "definitionId",
+    "definitionHash",
+    "meta",
+    "packageIdentity",
+    "system",
+    "datasources",
+    "relationships",
+    "sync",
+    "capabilities",
+    "authority",
+    "acceptance"
+  ],
+  "properties": {
+    "schemaName": {
+      "type": "string",
+      "const": "aifabrix.builder.integrationDefinition"
+    },
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "BID schema semver; implementers must accept 1.0.0."
+    },
+    "definitionId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "definitionHash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "SHA-256 of canonicalized BID body excluding this field."
+    },
+    "meta": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["suiteRunId", "producedAt", "btAssistantKey"],
+      "properties": {
+        "suiteRunId": { "type": "string", "minLength": 1 },
+        "producedAt": { "type": "string", "format": "date-time" },
+        "btAssistantKey": { "type": "string", "minLength": 1 },
+        "answerFingerprint": { "type": "string" },
+        "knowledgePackRefs": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "humanAnswerRefs": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "replaceSystemKey": { "type": "boolean", "default": false }
+      }
+    },
+    "packageIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["systemKey", "packageVersion", "displayName"],
+      "properties": {
+        "systemKey": { "type": "string", "pattern": "^[a-z0-9-]+$", "minLength": 3 },
+        "packageVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+        "displayName": { "type": "string", "minLength": 1 }
+      }
+    },
+    "system": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["key", "systemKind", "connectionRefs"],
+      "properties": {
+        "key": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+        "displayName": { "type": "string" },
+        "description": { "type": "string" },
+        "systemKind": { "type": "string", "minLength": 1 },
+        "type": { "type": "string", "enum": ["openapi", "mcp", "custom"] },
+        "connectionRefs": {
+          "type": "object",
+          "description": "kv:// or credential key refs only — no plaintext secrets.",
+          "additionalProperties": { "type": "string", "minLength": 1 }
+        },
+        "openapiSourceRef": { "type": "string" }
+      }
+    },
+    "datasources": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["key", "displayName", "entityType", "resourceType"],
+        "properties": {
+          "key": { "type": "string", "pattern": "^[a-z0-9-]+$", "minLength": 3 },
+          "displayName": { "type": "string", "minLength": 1 },
+          "entityType": {
+            "type": "string",
+            "enum": [
+              "documentStorage",
+              "vectorStore",
+              "recordStorage",
+              "messageService",
+              "serviceContract",
+              "none"
+            ]
+          },
+          "resourceType": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+          "capabilityKeys": {
+            "type": "array",
+            "items": { "type": "string", "pattern": "^[a-z][a-zA-Z0-9]*$" }
+          },
+          "propertyKeys": {
+            "type": "array",
+            "description": "Vendor property names to sync/index (CRM objects → CIP query.properties + fieldMappings).",
+            "items": { "type": "string", "pattern": "^[a-zA-Z][a-zA-Z0-9_]*$", "minLength": 1 }
+          },
+          "openapiSourceRef": { "type": "string" }
+        }
+      }
+    },
+    "relationships": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["from", "to", "kind"],
+        "properties": {
+          "from": { "type": "string", "minLength": 1 },
+          "to": { "type": "string", "minLength": 1 },
+          "kind": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "sync": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["mode"],
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["incremental"],
+          "description": "Incremental sync is mandatory for CRM profile datasources."
+        },
+        "datasources": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z0-9-]+$" }
+        }
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string", "pattern": "^[a-z][a-zA-Z0-9]*$" }
+      },
+      "description": "Map of datasource key → capability keys (must include named write for company DS)."
+    },
+    "authority": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["writeRequiresUserAuthority"],
+      "properties": {
+        "writeRequiresUserAuthority": { "type": "boolean" },
+        "notes": { "type": "string" }
+      }
+    },
+    "acceptance": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["gates"],
+      "properties": {
+        "gates": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}