@aifabrix/builder 2.46.0 → 2.47.0

package/lib/resolvers/resource-type-file.js

@@ -0,0 +1,159 @@
+/**
+ * Resource type file helpers for `aifabrix resource-type create --file`.
+ *
+ * @fileoverview Resource type file parsing
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+const path = require('path');
+const { existsSync, readFileSync } = require('../internal/fs-real-sync');
+
+/**
+ * @typedef {Object} ResourceTypeCreateInput
+ * @property {string} key
+ * @property {string} displayName
+ * @property {string} [description]
+ * @property {string} [category]
+ * @property {string} [defaultRiskLevel]
+ * @property {string} [status]
+ */
+
+const CATEGORIES = new Set([
+  'business',
+  'collaboration',
+  'governance',
+  'content',
+  'communication',
+  'people'
+]);
+
+const RISK_LEVELS = new Set(['low', 'medium', 'high', 'critical']);
+const STATUSES = new Set(['draft', 'active', 'deprecated', 'retired']);
+
+/**
+ * @param {string} filePath
+ * @returns {object}
+ */
+function loadResourceTypeJsonObject(filePath) {
+  const p = path.resolve(String(filePath || '').trim());
+  if (!p) {
+    throw new Error('--file is required');
+  }
+  if (!existsSync(p)) {
+    throw new Error(`File not found: ${p}`);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(p, 'utf8'));
+  } catch (e) {
+    throw new Error(`Invalid JSON in ${p}: ${e.message}`);
+  }
+  if (!parsed || typeof parsed !== 'object') {
+    throw new Error(`Resource type file must be a JSON object: ${p}`);
+  }
+  return parsed;
+}
+
+/**
+ * @param {object} parsed
+ * @param {string} field
+ * @param {Set<string>} allowedValues
+ * @param {string} label
+ * @returns {void}
+ */
+function applyOptionalEnumField(parsed, field, allowedValues, label) {
+  if (parsed[field] === undefined) {
+    return;
+  }
+  const value = String(parsed[field]).trim();
+  if (!allowedValues.has(value)) {
+    throw new Error(`${label} must be one of: ${[...allowedValues].join(', ')}`);
+  }
+  parsed[field] = value;
+}
+
+/**
+ * @param {object} parsed
+ * @returns {void}
+ */
+function rejectBaselineCatalogShape(parsed) {
+  if (parsed && typeof parsed === 'object' && Array.isArray(parsed.resourceTypes) && !parsed.key) {
+    throw new Error(
+      'File is a baseline catalog (resourceTypes[]). ' +
+        'Use `aifabrix resource-type import --file <path>` to seed all entries, ' +
+        'or pass a single resource type object with key and displayName.'
+    );
+  }
+}
+
+/**
+ * @param {object} row
+ * @param {number} index
+ * @returns {ResourceTypeCreateInput}
+ */
+function normalizeResourceTypeCreateRow(row, index) {
+  if (!row || typeof row !== 'object') {
+    throw new Error(`resourceTypes[${index}] must be a JSON object`);
+  }
+  const entry = { ...row };
+  applyOptionalEnumField(entry, 'category', CATEGORIES, 'category');
+  applyOptionalEnumField(entry, 'defaultRiskLevel', RISK_LEVELS, 'defaultRiskLevel');
+  applyOptionalEnumField(entry, 'status', STATUSES, 'status');
+  const key = String(entry.key || '').trim();
+  if (!key) {
+    throw new Error(`resourceTypes[${index}].key is required`);
+  }
+  const displayName = String(entry.displayName || '').trim();
+  if (!displayName) {
+    throw new Error(`resourceTypes[${index}].displayName is required`);
+  }
+  entry.key = key;
+  entry.displayName = displayName;
+  return entry;
+}
+
+/**
+ * @param {string} filePath
+ * @returns {ResourceTypeCreateInput}
+ */
+function readResourceTypeCreateFile(filePath) {
+  const parsed = loadResourceTypeJsonObject(filePath);
+  rejectBaselineCatalogShape(parsed);
+  return normalizeResourceTypeCreateRow(parsed, 0);
+}
+
+/**
+ * Read baseline catalog or array file for `resource-type import`.
+ * Accepts `baseline-resourcetypes.json` shape or a top-level JSON array.
+ *
+ * @param {string} filePath
+ * @returns {ResourceTypeCreateInput[]}
+ */
+function readResourceTypeCatalogFile(filePath) {
+  const parsed = loadResourceTypeJsonObject(filePath);
+  let rows;
+  if (Array.isArray(parsed)) {
+    rows = parsed;
+  } else if (Array.isArray(parsed.resourceTypes)) {
+    rows = parsed.resourceTypes;
+  } else {
+    throw new Error(
+      'Import file must be a baseline catalog with resourceTypes[] or a JSON array of resource types.'
+    );
+  }
+  if (rows.length === 0) {
+    throw new Error('Import file contains no resource types');
+  }
+  return rows.map((row, index) => normalizeResourceTypeCreateRow(row, index));
+}
+
+module.exports = {
+  readResourceTypeCreateFile,
+  readResourceTypeCatalogFile,
+  CATEGORIES,
+  RISK_LEVELS,
+  STATUSES
+};

package/lib/schema/application-schema.json

@@ -801,6 +801,22 @@
           "type": "string",
           "description": "When running with --reload, override the container command with this command (run from the mounted app root /app). Examples: TypeScript pnpm run reloadStart, Python make reloadStart."
         },
+        "imageRun": {
+          "type": "string",
+          "description": "Compose command when using a pulled image without bind-mount (prepended with cd /app && exec in generated compose)."
+        },
+        "worker": {
+          "type": "boolean",
+          "description": "When true, local compose and Azure companion manifests may start additional containers from the same image. Non-empty build.imageRunWorker starts <appKey>-worker; non-empty build.imageRunBeat starts <appKey>-beat. Empty imageRunWorker or imageRunBeat skips that role."
+        },
+        "imageRunWorker": {
+          "type": "string",
+          "description": "Compose/Azure startup command for the worker sidecar (<appKey>-worker) when build.worker is true. Omit or set to empty string to skip the worker role."
+        },
+        "imageRunBeat": {
+          "type": "string",
+          "description": "Compose/Azure startup command for the beat sidecar (<appKey>-beat) when build.worker is true. Omit or set to empty string to skip the beat role."
+        },
         "scripts": {
           "type": "object",
           "description": "Override CLI script commands (aifabrix test, install, lint, test-e2e, test-integration). When a key is missing, language default is used (TypeScript: pnpm test/install/lint/test:e2e/test:integration, Python: make test/install/lint/test:e2e/test-integration).",

package/lib/schema/deployment-rules.yaml

@@ -120,9 +120,10 @@ externalDataSource:
       - validation
       - quality
       - indexing
-      - context
       - documentStorage
       - capabilities
+      - authority
+      - foreignKeys
       - execution
       - config
       - openapi