@aifabrix/builder 2.45.0 → 2.46.0

package/lib/commands/datasource-unified-test-cli.options.js

@@ -44,6 +44,7 @@ Examples:
   $ aifabrix datasource test-e2e hubspot-users --app test-e2e-hubspot -v --debug
   $ aifabrix datasource test-e2e my-documents-ds --min-vector-hits 7 -v --debug
   $ aifabrix datasource test-e2e hubspot-users -a test-e2e-hubspot --no-async
+  $ aifabrix datasource test-e2e hubspot-users --sync --force --verify-audit -v
   $ aifabrix datasource test-e2e hubspot-users read
 
 Notes:
@@ -53,6 +54,7 @@ Notes:
       aifabrix datasource test-integration <datasourceKey>
   - For system-level E2E rollup across datasources, use:
       aifabrix test-e2e <systemKey>
+  - To prove governance audit evidence after a green E2E, add --verify-audit (see verify-audit command).
 `;
 }
 
@@ -127,6 +129,10 @@ function attachDatasourceTestCommonOptions(cmd, opts) {
       '--sync',
       'Publish local integration config to the dataplane before running the test (same as aifabrix upload <systemKey>; requires login)'
     )
+    .option(
+      '--force',
+      'With --sync, pass force to upload (bypass active-datasource schema replacement guards; same as aifabrix upload --force)'
+    )
     .option('--json', 'Print raw DatasourceTestRun JSON to stdout')
     .option('--summary', 'Print compact summary line')
     .option('--warnings-as-errors', 'Exit 1 when root status is warn')
@@ -175,11 +181,24 @@ function attachDatasourceTestE2eExclusiveOptions(cmd) {
       '--primary-key-value <value|@path>',
       'Primary key value or path to JSON file (e.g. @pk.json) for e2eOptions.primaryKeyValue'
     )
-    .option('--capability <key>', 'Capability drill-down (deprecated; use positional [capabilityKey])')
     .option(
       '--strict-capability-scope',
-      'Exit 1 if a capability drill-down is requested but the report lists more than one capabilities[] row (plan §2.3)'
-    );
+      'Exit 1 when positional [capabilityKey] is set but the report lists more than one capabilities[] row'
+    )
+    .option(
+      '--verify-audit',
+      'After successful E2E, verify the nine-row audit evidence matrix on the dataplane (requires audit:read)'
+    )
+    .option(
+      '--no-verify-audit',
+      'Skip audit evidence verification even if enabled by default in a future release'
+    )
+    .option(
+      '--audit-poll-ms <ms>',
+      'Max wait for audit rows after E2E when using --verify-audit (default 15000)',
+      '15000'
+    )
+    .option('--audit-poll-interval-ms <ms>', 'Audit poll interval when using --verify-audit (default 2000)', '2000');
 }
 
 module.exports = {

package/lib/commands/datasource-unified-test-e2e-cli-helpers.js

@@ -46,7 +46,7 @@ function exitCodeFromDatasourceTestRunEnvelope(env, options) {
     warningsAsErrors: options.warningsAsErrors === true,
     requireCert: options.requireCert === true
   });
-  const scope = analyzeCapabilityScope(env, options.capability);
+  const scope = analyzeCapabilityScope(env, options.capabilityKey);
   if (options.strictCapabilityScope === true && scope.violated) {
     code = Math.max(code, 1);
   }
@@ -62,10 +62,10 @@ function exitCodeFromDatasourceTestRunEnvelope(env, options) {
 function finalizeDatasourceTestE2ELegacyPath(data, options) {
   displayE2EResults(data, options.verbose);
   logDatasourceTestRunDebugAppendix(data.datasourceTestRun, options.debug);
-  logE2eCapabilityFocusFromEnvelope(data.datasourceTestRun, options.capability);
+  logE2eCapabilityFocusFromEnvelope(data.datasourceTestRun, options.capabilityKey);
   const env = data.datasourceTestRun;
   if (env) {
-    emitCapabilityScopeDiagnostics(env, { requestedCapabilityKey: options.capability });
+    emitCapabilityScopeDiagnostics(env, { requestedCapabilityKey: options.capabilityKey });
     const code = exitCodeFromDatasourceTestRunEnvelope(env, options);
     return code === null ? 1 : code;
   }
@@ -91,10 +91,10 @@ function displayDatasourceTestE2EEnvelopeResults(datasourceKey, env, options) {
     {
       debug: options.debug,
       runType: 'e2e',
-      requestedCapabilityKey: options.capability
+      requestedCapabilityKey: options.capabilityKey
     }
   );
-  logE2eCapabilityFocusFromEnvelope(env, options.capability);
+  logE2eCapabilityFocusFromEnvelope(env, options.capabilityKey);
 }
 
 module.exports = {

package/lib/commands/datasource-verify-audit-cli.js

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview `aifabrix datasource verify-audit` — re-run 407.1 matrix from last E2E log
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+const logger = require('../utils/logger');
+const { formatBlockingError } = require('../utils/cli-test-layout-chalk');
+const { runAuditEvidenceVerification } = require('../datasource/audit-evidence-run');
+const { loadEnvelopeFromLatestE2eLog } = require('../datasource/audit-evidence-extract');
+
+const VERIFY_AUDIT_HELP_AFTER = `
+Examples:
+  $ aifabrix datasource verify-audit test-e2e-hubspot-companies
+  $ aifabrix datasource verify-audit test-e2e-hubspot-companies --app test-e2e-hubspot -v
+  $ aifabrix datasource verify-audit test-e2e-hubspot-companies --correlation-id <testRunId>
+  $ aifabrix datasource verify-audit test-e2e-hubspot-companies --json
+
+Notes:
+  - Re-checks audit evidence from the latest test-e2e debug log (or --file) without re-running E2E.
+  - Requires audit:read on the dataplane (same login as test-e2e).
+  - Pair with: aifabrix datasource test-e2e <datasourceKey> --verify-audit
+`;
+
+/**
+ * @param {string} datasourceKey
+ * @param {Object} options
+ */
+async function verifyAuditCommandAction(datasourceKey, options) {
+  const envelope = await loadEnvelopeFromLatestE2eLog(datasourceKey, options);
+  if (!envelope) {
+    logger.error(
+      formatBlockingError('verify-audit failed:'),
+      'No test-e2e debug log found (run test-e2e with --debug first)'
+    );
+    process.exit(3);
+    return;
+  }
+  const pollMs = parseInt(String(options.auditPollMs || '15000'), 10);
+  const pollInterval = parseInt(String(options.auditPollIntervalMs || '2000'), 10);
+  const { exitCode } = await runAuditEvidenceVerification(datasourceKey, envelope, {
+    app: options.app,
+    env: options.env,
+    verbose: options.verbose,
+    json: options.json,
+    correlationId: options.correlationId,
+    executionId: options.executionId,
+    quiet: false,
+    auditPollMaxWaitMs: Number.isFinite(pollMs) ? pollMs : 15000,
+    auditPollIntervalMs: Number.isFinite(pollInterval) ? pollInterval : 2000
+  });
+  process.exit(exitCode);
+}
+
+/**
+ * @param {import('commander').Command} datasource
+ */
+function setupDatasourceVerifyAuditCommand(datasource) {
+  datasource
+    .command('verify-audit <datasourceKey>')
+    .description(
+      'Verify audit evidence matrix from latest E2E log (or --file) without re-running E2E'
+    )
+    .option(
+      '-a, --app <app>',
+      'Integration folder name (optional: resolve from cwd or datasource key if single match)'
+    )
+    .option('-e, --env <env>', 'Environment: dev, tst, or pro')
+    .option('-v, --verbose', 'Show matrix row codes and execution id count')
+    .option('--json', 'Print auditEvidenceVerification JSON block')
+    .option('-f, --file <path>', 'Path to test-e2e debug log JSON')
+    .option('--correlation-id <id>', 'Override correlation/testRunId filter')
+    .option('--execution-id <id>', 'Include execution id for sub-resource checks')
+    .option(
+      '--audit-poll-ms <ms>',
+      'Max wait for audit rows to appear (default 15000)',
+      '15000'
+    )
+    .option('--audit-poll-interval-ms <ms>', 'Poll interval (default 2000)', '2000')
+    .addHelpText('after', VERIFY_AUDIT_HELP_AFTER)
+    .action(async(datasourceKey, options) => {
+      try {
+        await verifyAuditCommandAction(datasourceKey, options);
+      } catch (error) {
+        logger.error(formatBlockingError('verify-audit failed:'), error.message);
+        process.exit(3);
+      }
+    });
+}
+
+module.exports = {
+  setupDatasourceVerifyAuditCommand,
+  verifyAuditCommandAction
+};

package/lib/commands/datasource.js

@@ -2,7 +2,7 @@
  * AI Fabrix Builder - Datasource Commands
  *
  * Handles datasource validation, listing, comparison, deployment, and online validation runs.
- * Subcommands `test`, `test-integration`, and `test-e2e` call the dataplane unified validation API; `log-test` / `log-integration` / `log-e2e` read saved debug JSON locally. Permissions are summarized in `docs/commands/permissions.md`.
+ * Subcommands `test`, `test-integration`, `test-e2e`, and `verify-trust` call the dataplane; `log-*` read saved debug JSON locally; `clean-logs` removes those files. Permissions are summarized in `docs/commands/permissions.md`.
  *
  * @fileoverview Datasource management commands for AI Fabrix Builder
  * @author AI Fabrix Team
@@ -18,11 +18,15 @@ const { listDatasources } = require('../datasource/list');
 const { compareDatasources } = require('../datasource/diff');
 const { deployDatasource } = require('../datasource/deploy');
 const { runLogViewer } = require('../datasource/log-viewer');
+const { runCleanLogs } = require('../datasource/log-cleaner');
 const {
   setupDatasourceTestCommand,
   setupDatasourceTestIntegrationCommand,
   setupDatasourceTestE2ECommand
 } = require('./datasource-unified-test-cli');
+const { setupDatasourceVerifyTrustCommand } = require('./datasource-test-trust-cli');
+const { setupDatasourceVerifyAuditCommand } = require('./datasource-verify-audit-cli');
+const { setupDatasourceLoadExportCommands } = require('./datasource-load-export-cli');
 const { setupDatasourceCapabilityCommands } = require('./datasource-capability');
 
 /**
@@ -38,10 +42,17 @@ Examples:
   $ af ds upload <datasourceKey>                    # same as: aifabrix datasource upload …
   $ af ds test <datasourceKey> --app <integrationFolder> --debug
   $ af ds test-e2e <datasourceKey> --app <integrationFolder> -v
+  $ af ds test-e2e <datasourceKey> --verify-audit
+  $ af ds verify-audit <datasourceKey>
+  $ af ds verify-trust <datasourceKey> --app <integrationFolder> -v
+  $ af ds load <datasourceKey> --app <integrationFolder> --dry-run
+  $ af ds export <datasourceKey> --app <integrationFolder> --format ndjson -v
   $ aifabrix datasource capability copy <file-or-key> --from create --as createBasicTrial --dry-run
   $ aifabrix datasource capability remove <file-or-key> --capability createTrial --dry-run
   $ aifabrix datasource capability diff ./a.json ./b.json --capability list
   $ aifabrix datasource capability edit <file-or-key> --capability create --section openapi
+  $ aifabrix datasource clean-logs --app test-e2e-hubspot --dry-run
+  $ aifabrix datasource clean-logs --all --type e2e
 
 Per-command help:  aifabrix datasource <command> --help
 Shorthand:         af ds (alias for datasource)
@@ -220,6 +231,57 @@ function setupDatasourceLogTestCommand(datasource) {
     });
 }
 
+function setupDatasourceCleanLogsCommand(datasource) {
+  datasource
+    .command('clean-logs')
+    .description('Remove saved test debug JSON under integration/<app>/logs/')
+    .option('-a, --app <app>', 'Integration folder name (system key)')
+    .option('--all', 'Clean logs under every integration/<app>/logs/ folder')
+    .option(
+      '-t, --type <type>',
+      'Log kind: test, integration, e2e, trust, or all (default: all)',
+      'all'
+    )
+    .option('--dry-run', 'List files that would be removed without deleting')
+    .option('--json', 'Machine-readable summary on stdout')
+    .action(async options => {
+      try {
+        await runCleanLogs({
+          app: options.app,
+          all: options.all,
+          type: options.type,
+          dryRun: options.dryRun,
+          json: options.json
+        });
+      } catch (error) {
+        logger.error(formatBlockingError('clean-logs failed:'), error.message);
+        process.exit(1);
+      }
+    });
+}
+
+function setupDatasourceLogTrustCommand(datasource) {
+  datasource.command('log-trust <datasourceKey>')
+    .description('Show agent trust log from datasource verify-trust (latest verify-trust-*.json or --file)')
+    .option(
+      '-a, --app <app>',
+      'Integration folder name (optional: resolve from cwd or datasource key if single match)'
+    )
+    .option('-f, --file <path>', 'Path to log file (default: latest verify-trust log in app logs folder)')
+    .action(async(datasourceKey, options) => {
+      try {
+        await runLogViewer(datasourceKey, {
+          app: options.app,
+          file: options.file,
+          logType: 'verify-trust'
+        });
+      } catch (error) {
+        logger.error(formatBlockingError('log-trust failed:'), error.message);
+        process.exit(1);
+      }
+    });
+}
+
 /**
  * Setup datasource management commands
  * @param {Command} program - Commander program instance
@@ -237,12 +299,17 @@ function setupDatasourceCommands(program) {
   setupDatasourceListCommand(datasource);
   setupDatasourceDiffCommand(datasource);
   setupDatasourceUploadCommand(datasource);
+  setupDatasourceLoadExportCommands(datasource);
   setupDatasourceTestCommand(datasource);
   setupDatasourceTestIntegrationCommand(datasource);
   setupDatasourceTestE2ECommand(datasource);
+  setupDatasourceVerifyAuditCommand(datasource);
+  setupDatasourceVerifyTrustCommand(datasource);
   setupDatasourceLogE2ECommand(datasource);
   setupDatasourceLogIntegrationCommand(datasource);
   setupDatasourceLogTestCommand(datasource);
+  setupDatasourceLogTrustCommand(datasource);
+  setupDatasourceCleanLogsCommand(datasource);
 }
 
 module.exports = { setupDatasourceCommands };

package/lib/commands/dev-show-display.js

@@ -336,6 +336,8 @@ function logConfigurationSection(p) {
   logRow('Environment', p.environment);
   logRow('Controller', p.controller);
   logRow('Format', p.formatVal);
+  logRow('Platform mode', p.setupPlatformMode);
+  logRow('Traefik', p.traefikEnabled ? 'on' : 'off');
   logRow('Scoped resources', p.scopedResourcesLabel);
   logRow('URLs registry', p.urlsLocalPath);
   if (!p.hasRemote) {
@@ -386,11 +388,12 @@ async function loadDevShowData(devIdStr) {
   const devIdNum = parseInt(devIdStr, 10);
   const ports = devConfig.getDevPorts(Number.isNaN(devIdNum) ? 0 : devIdNum);
   const [
-    environment, tlsEnabled, controller, formatRaw, useScoped, secretsRaw,
+    environment, tlsEnabled, controller, formatRaw, useScoped, secretsRaw, setupPlatformMode, traefikEnabled,
     remoteServer, dockerEndpoint, dockerTlsSkipVerify, mutagenFolder, syncSshUser, syncSshHost
   ] = await Promise.all([
     config.getCurrentEnvironment(), config.getTlsEnabled(), config.getControllerUrl(),
     config.getFormat(), config.getUseEnvironmentScopedResources(), config.getAifabrixSecretsPath(),
+    config.getSetupPlatformMode(), config.getTraefikEnabled(),
     config.getRemoteServer(), config.getDockerEndpoint(), config.getDockerTlsSkipVerify(),
     config.getUserMutagenFolder(), config.getSyncSshUser(), config.getSyncSshHost()
   ]);
@@ -410,6 +413,8 @@ async function loadDevShowData(devIdStr) {
     controller,
     formatVal: formatRaw ?? null,
     scopedResourcesLabel,
+    setupPlatformMode,
+    traefikEnabled,
     workResolved,
     homeResolved,
     secretsMain,
@@ -446,6 +451,8 @@ function renderDevShow(data) {
     tlsEnabled: data.tlsEnabled,
     controller: data.controller,
     formatVal: data.formatVal,
+    setupPlatformMode: data.setupPlatformMode,
+    traefikEnabled: data.traefikEnabled,
     scopedResourcesLabel: data.scopedResourcesLabel,
     urlsLocalPath: data.urlsLocalPath,
     hasRemote: data.hasRemote,

package/lib/commands/dimension-value.js

@@ -2,9 +2,9 @@
  * Dimension value commands (Controller).
  *
  * Commands:
- * - aifabrix dimension-value create
- * - aifabrix dimension-value list
- * - aifabrix dimension-value delete
+ * - aifabrix dimension value create
+ * - aifabrix dimension value list
+ * - aifabrix dimension value delete
  *
  * @fileoverview Dimension value CLI commands
  * @author AI Fabrix Team
@@ -25,29 +25,39 @@ const {
   deleteDimensionValue
 } = require('../api/dimension-values.api');
 
+const DIMENSION_VALUE_HELP_AFTER = `
+
+Examples:
+  $ aifabrix dimension value create customerRegion --value emea --display-name "EMEA"
+  $ aifabrix dimension value list customerRegion
+  $ aifabrix dimension value delete clx1234567890abcdef
+
+Per-command help:  aifabrix dimension value <command> --help
+`;
+
 const DIMENSION_VALUE_CREATE_HELP_AFTER = `
 
 Examples:
-  $ aifabrix dimension-value create customerRegion --value emea --display-name "EMEA"
-  $ aifabrix dimension-value create customerRegion --value na --display-name "North America"
+  $ aifabrix dimension value create customerRegion --value emea --display-name "EMEA"
+  $ aifabrix dimension value create customerRegion --value na --display-name "North America"
 
 `;
 
 const DIMENSION_VALUE_LIST_HELP_AFTER = `
 
 Examples:
-  $ aifabrix dimension-value list customerRegion
-  $ aifabrix dimension-value list customerRegion --page 1 --page-size 50
-  $ aifabrix dimension-value list customerRegion --search emea
+  $ aifabrix dimension value list customerRegion
+  $ aifabrix dimension value list customerRegion --page 1 --page-size 50
+  $ aifabrix dimension value list customerRegion --search emea
 
 `;
 
 const DIMENSION_VALUE_DELETE_HELP_AFTER = `
 
 Examples:
-  $ aifabrix dimension-value delete clx1234567890abcdef
+  $ aifabrix dimension value delete clx1234567890abcdef
 
-Tip: Find ids via "aifabrix dimension get <key>" (it prints values) or "aifabrix dimension-value list <key>".
+Tip: Find ids via "aifabrix dimension get <key>" (it prints values) or "aifabrix dimension value list <key>".
 
 `;
 
@@ -62,6 +72,17 @@ function requireNonEmpty(raw, label) {
   return s;
 }
 
+/**
+ * @param {Object} response - Controller API response
+ * @throws {Error} When response.success === false
+ */
+function throwIfApiFailed(response) {
+  if (!response || response.success !== false) {
+    return;
+  }
+  throw new Error(response.formattedError || response.error || 'Request failed');
+}
+
 async function resolveControllerAndAuth() {
   const controllerUrl = await resolveControllerUrl();
   if (!controllerUrl) {
@@ -100,6 +121,7 @@ function setupDimensionValueCreateCommand(cmd) {
           displayName: options.displayName,
           description: options.description
         });
+        throwIfApiFailed(res);
         const row = unwrapControllerData(res);
         logger.log(formatSuccessLine(`Dimension value created: ${dimKey}.${row.value}`));
       } catch (e) {
@@ -126,6 +148,7 @@ function setupDimensionValueListCommand(cmd) {
           pageSize: options.pageSize,
           search: options.search
         });
+        throwIfApiFailed(res);
         const payload = unwrapControllerData(res);
         const items = payload?.data ?? payload ?? [];
         logger.log(chalk.bold('\n🏷 Dimension values:\n'));
@@ -157,7 +180,8 @@ function setupDimensionValueDeleteCommand(cmd) {
       try {
         const { controllerUrl, authConfig } = await resolveControllerAndAuth();
         const id = requireNonEmpty(dimensionValueId, 'dimensionValueId');
-        await deleteDimensionValue(controllerUrl, authConfig, id);
+        const res = await deleteDimensionValue(controllerUrl, authConfig, id);
+        throwIfApiFailed(res);
         logger.log(formatSuccessLine(`Dimension value deleted: ${id}`));
       } catch (e) {
         logger.error(formatBlockingError(e.message));
@@ -166,8 +190,14 @@ function setupDimensionValueDeleteCommand(cmd) {
     });
 }
 
-function setupDimensionValueCommands(program) {
-  const cmd = program.command('dimension-value').description('Manage dimension values (static dimensions)');
+/**
+ * @param {import('commander').Command} dimensionCmd - Parent `dimension` command
+ */
+function setupDimensionValueCommands(dimensionCmd) {
+  const cmd = dimensionCmd
+    .command('value')
+    .description('Manage dimension values (static dimensions)')
+    .addHelpText('after', DIMENSION_VALUE_HELP_AFTER);
   setupDimensionValueCreateCommand(cmd);
   setupDimensionValueListCommand(cmd);
   setupDimensionValueDeleteCommand(cmd);

package/lib/commands/dimension.js

@@ -5,6 +5,7 @@
  * - aifabrix dimension create
  * - aifabrix dimension get
  * - aifabrix dimension list
+ * - aifabrix dimension value create|list|delete
  *
  * @fileoverview Dimension CLI commands
  * @author AI Fabrix Team
@@ -18,7 +19,7 @@ const logger = require('../utils/logger');
 const { resolveControllerUrl } = require('../utils/controller-url');
 const { normalizeControllerUrl, resolveEnvironment } = require('../core/config');
 const { getOrRefreshDeviceToken } = require('../utils/token-manager');
-const { readDimensionCreateFile } = require('../resolvers/dimension-file');
+const { readDimensionCreateFile, normalizeValueType } = require('../resolvers/dimension-file');
 const {
   formatBlockingError,
   formatSuccessLine,
@@ -31,8 +32,23 @@ const {
   createDimensionIdempotent
 } = require('../api/dimensions.api');
 const { createDimensionValue } = require('../api/dimension-values.api');
+const { setupDimensionValueCommands } = require('./dimension-value');
 
 const DIMENSION_KEY_PATTERN = /^[a-zA-Z][a-zA-Z0-9-_]*$/;
+
+/** Parent help for `aifabrix dimension -h` (leaf commands have their own Examples blocks). */
+const DIMENSION_HELP_AFTER = `
+
+Examples:
+  $ aifabrix dimension create --key customerRegion --display-name "Customer Region" --data-type string
+  $ aifabrix dimension get customerRegion
+  $ aifabrix dimension list --search region
+  $ aifabrix dimension value create customerRegion --value emea --display-name "EMEA"
+  $ aifabrix dimension value list customerRegion
+
+Per-command help:  aifabrix dimension <command> --help
+`;
+
 const DATA_TYPES = new Set(['string', 'number', 'boolean']);
 
 const DIMENSION_CREATE_HELP_AFTER = `
@@ -139,6 +155,11 @@ function buildCreatePayload(options) {
   if (options.displayName) payload.displayName = options.displayName;
   if (options.description !== undefined) payload.description = options.description;
   if (options.dataType) payload.dataType = options.dataType;
+  if (options.valueType) {
+    payload.valueType = normalizeValueType(options.valueType);
+  } else if (payload.valueType === undefined) {
+    payload.valueType = 'static';
+  }
   if (options.required !== undefined && options.required !== null) {
     payload.isRequired = Boolean(options.required);
   }
@@ -197,6 +218,7 @@ function setupDimensionCreateCommand(dim) {
     .option('--display-name <name>', 'Display name')
     .option('--description <text>', 'Description')
     .option('--data-type <type>', 'string | number | boolean')
+    .option('--value-type <mode>', 'static | dynamic | both (catalog assignment mode)')
     .option('--required', 'Mark dimension required (isRequired=true)')
     .option('--no-required', 'Mark dimension not required (isRequired=false)')
     .action(async(options) => {
@@ -206,11 +228,12 @@ function setupDimensionCreateCommand(dim) {
         const out = await createDimensionIdempotent(controllerUrl, authConfig, payload);
         const dimRow = unwrapControllerData(out.response);
         await maybeCreateValuesFromFile(controllerUrl, authConfig, payload);
+        const vt = dimRow.valueType || payload.valueType || 'static';
         if (out.created) {
-          logger.log(formatSuccessLine(`Dimension created: ${dimRow.key}`));
+          logger.log(formatSuccessLine(`Dimension created: ${dimRow.key} (valueType: ${vt})`));
           return;
         }
-        logger.log(formatSuccessLine(`Dimension exists: ${dimRow.key}`));
+        logger.log(formatSuccessLine(`Dimension exists: ${dimRow.key} (valueType: ${vt})`));
         logger.log(infoLine('No changes were needed.'));
       } catch (e) {
         logger.error(formatBlockingError(e.message));
@@ -236,6 +259,7 @@ function setupDimensionGetCommand(dim) {
         logger.log(headerKeyValue('Key:', row.key || '—'));
         logger.log(headerKeyValue('Display:', row.displayName || '—'));
         logger.log(headerKeyValue('Type:', row.dataType || '—'));
+        logger.log(headerKeyValue('Value type:', row.valueType || '—'));
         logger.log(headerKeyValue('Required:', String(row.isRequired)));
         if (row.description) {
           logger.log(headerKeyValue('Description:', row.description));
@@ -268,22 +292,25 @@ function setupDimensionListCommand(dim) {
     const KEY_WIDTH = 26;
     const DISPLAY_WIDTH = 34;
     const TYPE_WIDTH = 10;
+    const VTYPE_WIDTH = 8;
     const REQ_WIDTH = 10;
-    const SEP_LEN = KEY_WIDTH + DISPLAY_WIDTH + TYPE_WIDTH + REQ_WIDTH;
+    const SEP_LEN = KEY_WIDTH + DISPLAY_WIDTH + TYPE_WIDTH + VTYPE_WIDTH + REQ_WIDTH;
 
     const keyCol = 'Key'.padEnd(KEY_WIDTH);
     const displayCol = 'Display'.padEnd(DISPLAY_WIDTH);
     const typeCol = 'Type'.padEnd(TYPE_WIDTH);
+    const vtypeCol = 'VType'.padEnd(VTYPE_WIDTH);
     const reqCol = 'Required'.padEnd(REQ_WIDTH);
-    logger.log(chalk.gray(`${keyCol}${displayCol}${typeCol}${reqCol}`));
+    logger.log(chalk.gray(`${keyCol}${displayCol}${typeCol}${vtypeCol}${reqCol}`));
     logger.log(chalk.gray('-'.repeat(SEP_LEN)));
 
     items.forEach((d) => {
       const key = (d?.key ?? '—').toString().padEnd(KEY_WIDTH);
       const displayName = (d?.displayName ?? '—').toString().padEnd(DISPLAY_WIDTH);
       const dataType = (d?.dataType ?? '—').toString().padEnd(TYPE_WIDTH);
+      const valueType = (d?.valueType ?? '—').toString().padEnd(VTYPE_WIDTH);
       const required = (d?.isRequired ?? '—').toString().padEnd(REQ_WIDTH);
-      logger.log(`${key}${displayName}${dataType}${required}`);
+      logger.log(`${key}${displayName}${dataType}${valueType}${required}`);
     });
     logger.log('');
   }
@@ -318,10 +345,14 @@ function setupDimensionListCommand(dim) {
  * @param {import('commander').Command} program
  */
 function setupDimensionCommands(program) {
-  const dim = program.command('dimension').description('Manage the Controller Dimension Catalog');
+  const dim = program
+    .command('dimension')
+    .description('Manage the Controller Dimension Catalog')
+    .addHelpText('after', DIMENSION_HELP_AFTER);
   setupDimensionCreateCommand(dim);
   setupDimensionGetCommand(dim);
   setupDimensionListCommand(dim);
+  setupDimensionValueCommands(dim);
 }
 
 module.exports = {