@equinor/fusion-framework-cli 11.0.0-next.1 → 11.0.0-next.11

package/bin/build/cli.js

@@ -4,22 +4,28 @@ import { readPackageUpSync } from 'read-package-up';
 import { createCommand, createOption, InvalidOptionArgumentError, Command } from 'commander';
 import 'node:fs';
 import chalk from 'chalk';
-import 'pretty-bytes';
-import { S as Spinner, b as buildApplication, a as bundleApp, F as FusionEnv, r as resolveDefaultEnv, f as resolveProjectPackage, h as resolveAppManifest, i as initializeFramework, p as publishAppConfig, g as generateApplicationConfig, j as formatPath, H as HttpJsonResponseError, k as loadAppManifest, s as startAppDevServer, m as fileExistsSync, N as NoAccountsError, n as createDevServer, l as loadPortalManifest, o as loadPortalSchema, w as writeFile$1, c as buildPortal, d as bundlePortal } from './portal-pack-CAsnV44B.js';
+import { S as Spinner, b as buildApplication, a as bundleApp, F as FusionEnv, r as resolveDefaultEnv, i as resolveProjectPackage, j as resolveAppManifest, k as initializeFramework, p as publishAppConfig, g as generateApplicationConfig, m as formatPath, H as HttpJsonResponseError, n as loadAppManifest, s as startAppDevServer, o as fileExistsSync, N as NoAccountsError, q as resolvePortalManifest, t as resolvePortalConfig, u as createDevServer, l as loadPortalManifest, v as getDefaultExportFromCjs, w as loadPortalSchema, x as writeFile$1, c as buildPortal, d as bundlePortal, f as publishPortalConfig, e as generatePortalConfig } from './portal-config-publish-ezU_DFki.js';
 import { importJSON } from '@equinor/fusion-imports';
-import 'lodash.mergewith';
 import '@equinor/fusion-framework-dev-server';
 import 'vite';
 import { mkdir, writeFile } from 'node:fs/promises';
 import 'node:assert';
 import 'node:child_process';
+import 'zod';
 import AdmZip from 'adm-zip';
 import { stdout } from 'node:process';
-import '@azure/msal-node';
-import 'open';
+import 'http';
+import 'https';
+import 'crypto';
+import 'buffer';
+import 'stream';
+import 'util';
+import 'fs';
+import 'path';
 import 'node:http';
-import 'zod';
-import 'is-ci';
+import 'node:buffer';
+import 'node:util';
+import 'node:os';
 import 'ora';
 
 // ConsoleLogger provides a unified interface for logging and spinner-based feedback in CLI tools.
@@ -157,12 +163,19 @@ class ConsoleLogger {
  *
  * @see buildApplication for build implementation details
  */
-const command$o = createCommand('build')
-    .description([
-    'Build the application using a manifest file and environment-specific configuration.',
-    'If no manifest is provided, the command will search for a default app.manifest.[ts|js|json] in the current directory.',
+const command$p = createCommand('build')
+    .description('Build the application using a manifest file and environment-specific configuration.')
+    .addHelpText('after', [
+    'Builds the application using a manifest file and environment-specific configuration.',
+    'If no manifest is provided, searches for a default app.manifest.[ts|js|json] in the current directory.',
     'You can use environment variables to customize the build process.',
     '',
+    'Arguments:',
+    '  [manifest]   Manifest file to use for building (e.g., app.manifest.ts)',
+    '',
+    'Options:',
+    '  -d, --debug  Enable debug mode for verbose logging (default: false)',
+    '',
     'Examples:',
     '  $ fusion build',
     '  $ fusion build app.manifest.dev.ts --debug',
@@ -174,11 +187,7 @@ const command$o = createCommand('build')
     await buildApplication({ log, manifest });
 });
 
-function getDefaultExportFromCjs (x) {
-	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
-}
-
-const defaultArchive = 'app-bundle.zip';
+const DEFAULT_ARCHIVE = 'app-bundle.zip';
 /**
  * CLI command: `pack`
  *
@@ -207,20 +216,27 @@ const defaultArchive = 'app-bundle.zip';
  *
  * @see bundleApp for implementation details
  */
-const command$n = createCommand('pack')
-    .description([
-    'Create a distributable app bundle of the application.',
-    'The bundle includes all necessary files for deployment.',
-    'You can specify the output filename and directory.',
-    'Optionally, provide a manifest file to customize the bundle.',
-    'If no manifest is provided, the command will look for a default app.manifest.[ts|js|json] in the current directory.',
-    'For more details, see the Fusion Framework documentation.',
+const command$o = createCommand('pack')
+    .description('Create a distributable app bundle of the application.')
+    .addHelpText('after', [
+    'Creates a distributable app bundle of the application.',
+    'Bundles all necessary files for deployment.',
+    'You can specify the output filename and directory, and optionally provide a manifest file.',
+    'If no manifest is provided, defaults to app.manifest.[ts|js|json] in the current directory.',
+    '',
+    'Arguments:',
+    '  [manifest]   Manifest file to use for bundling (e.g., app.manifest.ts)',
+    '',
+    'Options:',
+    '  -a, --archive        Name of the output archive file (default: app-bundle.zip)',
+    '  -o, --output         Directory where the archive will be saved (default: current working directory)',
+    '  -d, --debug          Enable debug mode for verbose logging',
     '',
     'Examples:',
     '  $ fusion pack',
     '  $ fusion pack app.manifest.dev.ts --archive my-app.zip --output ./dist',
 ].join('\n'))
-    .option('-a, --archive [string]', 'Name of the output archive file (default: app-bundle.zip)', defaultArchive)
+    .option('-a, --archive [string]', 'Name of the output archive file (default: app-bundle.zip)', DEFAULT_ARCHIVE)
     .option('-o, --output [string]', 'Directory where the archive will be saved (default: current working directory)', process.cwd())
     .option('-d, --debug', 'Enable debug mode for verbose logging', false)
     .argument('[manifest]', 'Manifest file to use for bundling (e.g., app.manifest.ts)')
@@ -441,11 +457,21 @@ const checkApp = async (options) => {
  *
  * @see checkApp for implementation details
  */
-const command$m = withAuthOptions(createCommand('check')
-    .description([
-    'Check if application is registered in Fusion app store',
-    'This command verifies the registration status of your application in the Fusion app store.',
-    "It can help identify issues with your app's registration or configuration.",
+const command$n = withAuthOptions(createCommand('check')
+    .description('Check if application is registered in Fusion app store.')
+    .addHelpText('after', [
+    'Checks if the application is registered in the Fusion app store.',
+    'Verifies the registration status of your application in the Fusion app store.',
+    'Helps identify issues with app registration or configuration.',
+    'Supports authentication and environment options. Provides a debug mode for verbose logging.',
+    '',
+    'Options:',
+    '  -d, --debug         Enable debug mode for verbose logging (default: false)',
+    '  --environment <env> Specify the environment (see available environments)',
+    '  --token <token>     Provide an authentication token (if required)',
+    '',
+    'Examples:',
+    '  $ fusion check --environment prod --debug',
 ].join('\n'))
     .option('-d, --debug', 'debug mode', false)
     .addOption(createEnvOption({ allowDev: false }))
@@ -621,16 +647,21 @@ const uploadApplication = async (opt) => {
  *
  * @see uploadApplication for implementation details
  */
-const command$l = withAuthOptions(createCommand('upload')
-    .description([
-    'Upload a Fusion application bundle to the Fusion App Store.',
+const command$m = withAuthOptions(createCommand('upload')
+    .description('Upload a Fusion application bundle to the Fusion App Store.')
+    .addHelpText('after', [
     '',
-    'This command uploads a distributable application bundle (e.g., app-bundle.zip) to the Fusion app registry, making it available for deployment and management.',
+    'Uploads a Fusion application bundle to the Fusion App Store.',
+    'Uploads a distributable application bundle (e.g., app-bundle.zip) to the Fusion app registry.',
+    'Supports specifying application key, environment, and debug mode.',
+    '',
+    'Arguments:',
+    '  [bundle]   Application bundle to upload (default: app-bundle.zip)',
     '',
     'Options:',
-    '  --appKey <string>   Specify the application key (if omitted, resolved from manifest)',
-    '  --env <env>         Target environment (production, staging, etc.)',
-    '  --debug             Enable verbose logging for troubleshooting',
+    '  -k, --appKey <string> Application key (if not provided, resolved from manifest)',
+    '  -e, --env <env>      Target environment',
+    '  -d, --debug          Enable debug mode for verbose logging',
     '',
     'Examples:',
     '  $ fusion upload',
@@ -640,7 +671,7 @@ const command$l = withAuthOptions(createCommand('upload')
     .option('-d, --debug [boolean]', 'Enable debug mode for verbose logging', false)
     .option('-k, --appKey <string>', 'Application key (if not provided, resolved from manifest)')
     .addOption(createEnvOption({ allowDev: false }))
-    .argument('[bundle]', 'Application bundle to upload (default: app-bundle.zip)', defaultArchive)
+    .argument('[bundle]', 'Application bundle to upload (default: app-bundle.zip)', DEFAULT_ARCHIVE)
     .action(async (bundle, options) => {
     const log = new ConsoleLogger('portal:upload', {
         debug: options.debug,
@@ -692,25 +723,37 @@ const command$l = withAuthOptions(createCommand('upload')
  *   -o, --output <stdout|path> Output to stdout or a file (default: stdout)
  *
  * Example:
- *   $ fusion config app.config.ts
- *   $ fusion config app.config.prod.ts --output ./dist/app.config.json
- *   $ fusion config --publish --manifest app.manifest.ts --env prod
+ *   $ fusion-framework-cli config app.config.ts
+ *   $ fusion-framework-cli config app.config.prod.ts --output ./dist/app.config.json
+ *   $ fusion-framework-cli config --publish --manifest app.manifest.ts --env prod
  *
  * @see generateApplicationConfig, publishAppConfig for implementation details
  */
-const command$k = withAuthOptions(createCommand('config')
-    .description([
+const command$l = withAuthOptions(createCommand('config')
+    .description('Generate or publish the Fusion application configuration file.')
+    .addHelpText('after', [
     'Generate and/or publish the application configuration for Fusion apps.',
     '',
     'By default, outputs the generated config to stdout or a file. Use --publish to upload the config to the Fusion app registry.',
     'Options [token, tenant, client, manifest] are only relevant when --publish is used.',
     'Option [-e, --env] cannot be set to dev when --publish is used.',
     '',
+    'Arguments:',
+    '  [config]   Config build file to use (e.g., app.config[.env]?.[ts,js,json])',
+    '',
+    'Options:',
+    '  --debug              Enable debug mode for verbose logging',
+    '  --silent             Silent mode, suppresses output except errors',
+    '  --publish            Publish config to Fusion app registry',
+    '  --manifest <path>    Path to the app manifest file (required with --publish)',
+    '  -e, --env <env>      Target environment',
+    '  -o, --output <stdout|path> Output to stdout or a file (default: stdout)',
+    '',
     'Examples:',
-    '  $ fusion config app.config.ts',
-    '  $ fusion config app.config.prod.ts --output ./dist/app.config.json',
-    '  $ fusion config --publish --manifest app.manifest.ts --env prod',
-    '  $ fusion config --env prod my-custom.config.ts',
+    '  $ fusion-framework-cli config app.config.ts',
+    '  $ fusion-framework-cli config app.config.prod.ts --output ./dist/app.config.json',
+    '  $ fusion-framework-cli config --publish --manifest app.manifest.ts --env prod',
+    '  $ fusion-framework-cli config --env prod my-custom.config.ts',
 ].join('\n'))
     .option('--debug', 'Enable debug mode for verbose logging')
     .option('--silent', 'Silent mode, suppresses output except errors')
@@ -865,14 +908,26 @@ const tagApplication = async (options) => {
  *
  * @see tagApplication for implementation details
  */
-const command$j = withAuthOptions(createCommand('tag')
-    .description([
-    'Tag your Fusion application with a specific version or preview in the Fusion app registry.',
+const command$k = withAuthOptions(createCommand('tag')
+    .description('Tag your Fusion application with a specific version or preview.')
+    .addHelpText('after', [
     '',
-    'This command applies a tag to the specified application version, making it easy to manage releases and previews.',
-    'You can provide the app key and version directly, or let the command resolve them from the manifest file.',
+    'Tags a Fusion application with a specific version or preview in the Fusion app registry.',
+    'Applies a tag to the specified application version for release management.',
+    'App key and version can be provided or resolved from the manifest file.',
     'Supports environment selection, debug, and silent modes.',
     '',
+    'Arguments:',
+    '  <tag>   Tag to apply (latest | preview | stable)',
+    '',
+    'Options:',
+    '  --appKey <string>    Application key (if not provided, resolved from manifest)',
+    '  -v, --version <string> Version to tag (if not provided, resolved from manifest)',
+    '  -m, --manifest <string> Manifest file to use for resolving app key and version',
+    '  --debug              Enable debug mode for verbose logging',
+    '  --silent             Silent mode, suppresses output except errors',
+    '  -e, --env <env>      Target environment',
+    '',
     'Examples:',
     '  $ fusion tag latest',
     '  $ fusion tag preview --env prod --manifest app.manifest.prod.ts',
@@ -954,12 +1009,18 @@ const command$j = withAuthOptions(createCommand('tag')
  *
  * @see startAppDevServer for implementation details
  */
-const command$i = createCommand('dev')
-    .description([
-    'Start the application in development mode.',
+const command$j = createCommand('dev')
+    .description('Start the application in development mode.')
+    .addHelpText('after', [
     '',
-    'This command launches the development server for your application.',
-    'You can specify a custom manifest or config file, set the runtime environment, and choose the port.',
+    'Starts the application in development mode with a local dev server.',
+    '',
+    'Options:',
+    '  --debug              Enable debug mode',
+    '  --manifest <path>    Path to the app manifest file (app.manifest[.env]?.[ts,js,json])',
+    '  --config <path>      Path to the app config file (app.config[.env]?.[ts,js,json])',
+    '  --env <environment>  Runtime environment for the dev server (default: local)',
+    '  --port <port>        Port for the development server (default: 3000)',
     '',
     'Examples:',
     '  $ fusion app dev',
@@ -1012,14 +1073,23 @@ const command$i = createCommand('dev')
  *
  * @see loadAppManifest for implementation details
  */
-const command$h = createCommand('manifest')
-    .description([
-    'Build and output the application manifest for Fusion apps.',
+const command$i = createCommand('manifest')
+    .description('Build and output the application manifest for Fusion apps.')
+    .addHelpText('after', [
     '',
-    'By default, the manifest is printed to stdout. Use --output to write it to a file.',
+    'Builds and outputs the application manifest for Fusion apps.',
+    'By default, prints the manifest to stdout. Use --output to write to a file.',
     'You can specify a custom manifest build file or use the default (app.manifest[.env]?.[ts,js,json]).',
     'Supports debug and silent modes for flexible output.',
     '',
+    'Arguments:',
+    '  [manifest]   Manifest build file to use (e.g., app.manifest[.env]?.[ts,js,json])',
+    '',
+    'Options:',
+    '  -d, --debug          Enable debug mode for verbose logging',
+    '  -o, --output         Write manifest to the specified file (default: stdout)',
+    '  -s, --silent         Silent mode, suppresses output except errors',
+    '',
     'Examples:',
     '  $ fusion manifest',
     '  $ fusion manifest app.manifest.prod.ts --output ./dist/app.manifest.json',
@@ -1077,12 +1147,23 @@ const command$h = createCommand('manifest')
  *
  * @see uploadApplication, tagApplication for implementation details
  */
-const command$g = withAuthOptions(createCommand('publish')
-    .description([
-    'Build, upload, and tag your Fusion application for deployment to the Fusion portal.',
+const command$h = withAuthOptions(createCommand('publish')
+    .description('Build, upload, and tag your Fusion application for deployment.')
+    .addHelpText('after', [
+    '',
+    'Builds, uploads, and tags a Fusion application for deployment to the Fusion portal.',
+    'Bundles the app, uploads it to the Fusion app store, and applies a tag for versioning.',
+    'Supports specifying environment, manifest file, and tag.',
+    'Debug mode and authentication options are supported.',
     '',
-    'This command bundles your app, uploads it to the Fusion app store, and applies a tag for versioning.',
-    'You can specify the environment, manifest file, and tag to use. Debug mode and authentication options are supported.',
+    'Arguments:',
+    '  [bundle]   Path to the app bundle to upload',
+    '',
+    'Options:',
+    '  -d, --debug          Enable debug mode for verbose logging (default: false)',
+    '  -e, --env <env>      Target environment',
+    '  -m, --manifest       Manifest file to use for bundling (e.g., app.manifest.ts)',
+    '  -t, --tag            Tag to apply to the published app (latest | preview)',
     '',
     'Examples:',
     '  $ fusion publish',
@@ -1163,30 +1244,30 @@ const command$g = withAuthOptions(createCommand('publish')
  * Each alias maps an old "build-*" command to its new equivalent, providing warnings and guidance for users.
  * These aliases help maintain backward compatibility and inform users about updated command usage.
  */
-command$n.alias('build-pack').hook('preAction', (thisCommand) => {
+command$o.alias('build-pack').hook('preAction', (thisCommand) => {
     if (process.argv[3] === 'build-pack') {
         console.warn(chalk.bgRedBright.bold('The command "build-pack" is deprecated. Please use "pack" instead.'));
         if (!thisCommand.getOptionValue('archive')) {
-            thisCommand.setOptionValue('archive', defaultArchive);
+            thisCommand.setOptionValue('archive', DEFAULT_ARCHIVE);
         }
     }
 });
-command$l.alias('build-upload').hook('preAction', (thisCommand) => {
+command$m.alias('build-upload').hook('preAction', (thisCommand) => {
     if (process.argv[3] === 'build-upload') {
         console.warn(chalk.bgRedBright.bold('The command "build-upload" is deprecated. Please use "upload" instead.'));
         if (thisCommand.getOptionValue('service')) {
             throw new Error('The --service option is deprecated. Please use --env instead.');
         }
-        const bundle = thisCommand.getOptionValue('bundle') ?? defaultArchive;
+        const bundle = thisCommand.getOptionValue('bundle') ?? DEFAULT_ARCHIVE;
         process.argv[4] = bundle;
     }
 });
-command$h.alias('build-manifest').hook('preAction', (thisCommand) => {
+command$i.alias('build-manifest').hook('preAction', () => {
     if (process.argv[3] === 'build-manifest') {
         console.warn(chalk.bgRedBright.bold('The command "build-manifest" is deprecated. Please use "manifest" instead.'));
     }
 });
-command$g.alias('build-publish').hook('preAction', (thisCommand) => {
+command$h.alias('build-publish').hook('preAction', (thisCommand) => {
     if (process.argv[3] === 'build-publish') {
         console.warn(chalk.bgRedBright.bold('The command "build-publish" is deprecated. Please use "publish" instead.'));
     }
@@ -1195,8 +1276,26 @@ command$g.alias('build-publish').hook('preAction', (thisCommand) => {
     }
 });
 
-const command$f = createCommand('app')
-    .description('Develop and deploy Fusion applications')
+const command$g = createCommand('app')
+    .description('Develop, build, configure, and deploy Fusion applications from your workspace root.')
+    .addHelpText('after', [
+    '',
+    'The "app" command is your main entry point for managing Fusion applications in this workspace.',
+    '',
+    'It provides access to subcommands for every stage of the application lifecycle, including development, building, packaging, configuration, deployment, and release management.',
+    '',
+    'All available subcommands are listed below automatically. For details and options for a specific subcommand, run:',
+    '  fusion app <subcommand> --help',
+    '',
+    'Typical usage:',
+    '  - Run and test your app locally with the dev subcommand',
+    '  - Build, bundle, and configure your app for deployment',
+    '  - Upload, publish, and tag releases to the Fusion App Store',
+    '  - Check registration and generate manifests as needed',
+    '',
+    'This command should be run from your app root directory.',
+].join('\n'))
+    .addCommand(command$p)
     .addCommand(command$o)
     .addCommand(command$n)
     .addCommand(command$m)
@@ -1204,30 +1303,33 @@ const command$f = createCommand('app')
     .addCommand(command$k)
     .addCommand(command$j)
     .addCommand(command$i)
-    .addCommand(command$h)
-    .addCommand(command$g);
+    .addCommand(command$h);
 
 /**
  * Command to authenticate and log in to Fusion Framework using interactive browser-based authentication.
  *
  * This command initializes the Fusion Framework and opens a browser window for secure login.
  * Supports custom tenant, client, and scope options for advanced authentication scenarios.
- *
- * @example
- *   $ fusion login
- *   $ fusion login --tenant my-tenant --client my-client-id --scope api://my-app/.default
  */
 const DEFAULT_SERVER_PORT = 49741;
-const command$e = createCommand('login')
-    .description([
+const command$f = createCommand('login')
+    .description('Authenticate and log in to Fusion Framework using interactive browser-based authentication.')
+    .addHelpText('after', [
+    '',
     'Authenticate and log in to Fusion Framework using interactive browser-based authentication.',
     '',
     'This command initializes the Fusion Framework and opens a browser window for secure login.',
     'Supports custom tenant, client, and scope options for advanced authentication scenarios.',
     '',
+    'Options:',
+    '  --tenant <tenantId>   Specify the tenant ID',
+    '  --client <clientId>   Specify the client ID',
+    '  --scope <scope>       Specify the scope(s) for authentication',
+    '  --debug               Enable debug mode for verbose logging',
+    '',
     'Examples:',
-    '  $ fusion login',
-    '  $ fusion login --tenant my-tenant --client my-client-id --scope api://my-app/.default',
+    '  $ fusion-framework-cli login',
+    '  $ fusion-framework-cli login --tenant my-tenant --client my-client-id --scope api://my-app/.default',
 ].join('\n'))
     .action(async (options) => {
     const log = new ConsoleLogger('auth:login', { debug: options.debug });
@@ -1264,7 +1366,7 @@ const command$e = createCommand('login')
  * Adds authentication options to the login command.
  * @see withAuthOptions
  */
-withAuthOptions(command$e, {
+withAuthOptions(command$f, {
     includeScope: true,
     excludeToken: true,
 });
@@ -1274,21 +1376,24 @@ withAuthOptions(command$e, {
  *
  * This command removes your current authentication state from the Fusion Framework CLI.
  * Supports custom tenant and client options for advanced scenarios.
- *
- * @example
- *   $ fusion logout
- *   $ fusion logout --tenant my-tenant --client my-client-id
  */
-const command$d = createCommand('logout')
-    .description([
+const command$e = createCommand('logout')
+    .description('Log out from Fusion Framework and clear your authentication session.')
+    .addHelpText('after', [
+    '',
     'Log out from Fusion Framework and clear your authentication session.',
     '',
     'This command removes your current authentication state from the Fusion Framework CLI.',
     'Supports custom tenant and client options for advanced scenarios.',
     '',
+    'Options:',
+    '  --tenant <tenantId>   Specify the tenant ID',
+    '  --client <clientId>   Specify the client ID',
+    '  --debug               Enable debug mode for verbose logging',
+    '',
     'Examples:',
-    '  $ fusion logout',
-    '  $ fusion logout --tenant my-tenant --client my-client-id',
+    '  $ fusion-framework-cli logout',
+    '  $ fusion-framework-cli logout --tenant my-tenant --client my-client-id',
 ].join('\n'))
     .action(async (options) => {
     const log = new ConsoleLogger('auth:logout', { debug: options.debug });
@@ -1314,7 +1419,7 @@ const command$d = createCommand('logout')
  * Adds authentication options to the logout command.
  * @see withAuthOptions
  */
-withAuthOptions(command$d, {
+withAuthOptions(command$e, {
     excludeToken: true,
     includeScope: false,
 });
@@ -1324,23 +1429,27 @@ withAuthOptions(command$d, {
  *
  * This command retrieves an access token for the specified scopes, tenant, and client.
  * Supports debug and silent modes for flexible output.
- *
- * @example
- *   $ fusion token
- *   $ fusion token --scope api://my-app/.default
- *   $ fusion token --tenant my-tenant --client my-client-id --silent
  */
-const command$c = createCommand('token')
-    .description([
+const command$d = createCommand('token')
+    .description('Acquire and print an access token for Fusion APIs using your current authentication context.')
+    .addHelpText('after', [
+    '',
     'Acquire and print an access token for Fusion APIs using your current authentication context.',
     '',
     'This command retrieves an access token for the specified scopes, tenant, and client.',
     'Supports debug and silent modes for flexible output.',
     '',
+    'Options:',
+    '  --tenant <tenantId>   Specify the tenant ID',
+    '  --client <clientId>   Specify the client ID',
+    '  --scope <scope>       Specify the scope(s) for authentication',
+    '  --debug               Enable debug mode for verbose logging',
+    '  --silent              Only output the token (no extra logging)',
+    '',
     'Examples:',
-    '  $ fusion token',
-    '  $ fusion token --scope api://my-app/.default',
-    '  $ fusion token --tenant my-tenant --client my-client-id --silent',
+    '  $ fusion-framework-cli token',
+    '  $ fusion-framework-cli token --scope api://my-app/.default',
+    '  $ fusion-framework-cli token --tenant my-tenant --client my-client-id --silent',
 ].join('\n'))
     .option('-d, --debug', 'Enable debug mode for verbose logging', false)
     .option('--silent', 'Only output the token (no extra logging)')
@@ -1383,14 +1492,26 @@ const command$c = createCommand('token')
  * Adds authentication options to the token command.
  * @see withAuthOptions
  */
-withAuthOptions(command$c, {
+withAuthOptions(command$d, {
     includeScope: true,
 });
 
-const command$b = new Command('auth').description('Authenticate with Fusion Framework CLI');
-command$b.addCommand(command$e, { isDefault: true });
-command$b.addCommand(command$d);
-command$b.addCommand(command$c);
+const command$c = new Command('auth')
+    .description('Authenticate with Fusion Framework CLI')
+    .addHelpText('after', [
+    '',
+    'Authentication commands for Fusion Framework CLI.',
+    '',
+    'Use these commands to log in, log out, or acquire tokens for Fusion APIs.',
+    '',
+    'Examples:',
+    '  $ fusion-framework-cli auth login',
+    '  $ fusion-framework-cli auth logout',
+    '  $ fusion-framework-cli auth token --scope api://my-app/.default',
+].join('\n'));
+command$c.addCommand(command$f, { isDefault: true });
+command$c.addCommand(command$e);
+command$c.addCommand(command$d);
 
 /**
  * The `resolve` command resolves and displays information about a service registered in Fusion service discovery.
@@ -1399,13 +1520,6 @@ command$b.addCommand(command$c);
  *
  * Supports environment selection and authentication options.
  *
- * ## Examples
- *
- * ```sh
- * $ fusion resolve my-service
- * $ fusion resolve my-service --env prod
- * ```
- *
  * @command resolve
  * @description Resolve and display information about a service registered in Fusion service discovery.
  * @argument {string} service - Name of the service to resolve in Fusion service discovery.
@@ -1415,16 +1529,20 @@ command$b.addCommand(command$c);
  * @option {string} --clientId - Client ID for authentication.
  * @returns {Promise<void>} Prints the resolved service details to the console.
  */
-const command$a = withAuthOptions(createCommand('resolve')
-    .description([
+const command$b = withAuthOptions(createCommand('resolve')
+    .description('Resolve and display information about a service registered in Fusion service discovery.')
+    .addHelpText('after', [
+    '',
     'Resolve and display information about a service registered in Fusion service discovery.',
     '',
     'This command looks up a service by name and prints its discovery details using the current authentication and environment.',
-    'Supports environment selection and authentication options.',
     '',
     'Examples:',
-    '  $ fusion resolve my-service',
-    '  $ fusion resolve my-service --env prod',
+    '  $ fusion-framework-cli resolve my-service',
+    '  $ fusion-framework-cli resolve my-service --env prod',
+    '  $ fusion-framework-cli resolve my-service --env test --tenantId my-tenant --clientId my-client-id',
+    '',
+    'The command will print the resolved service details to the console.',
 ].join('\n'))
     .addOption(createEnvOption({ allowDev: false }))
     .argument('<service>', 'Name of the service to resolve in Fusion service discovery')
@@ -1447,8 +1565,8 @@ const command$a = withAuthOptions(createCommand('resolve')
     console.debug(appClient);
 }));
 
-const command$9 = createCommand('disco').description('Service discovery operations');
-command$9.addCommand(command$a);
+const command$a = createCommand('disco').description('Service discovery operations');
+command$a.addCommand(command$b);
 
 /**
  * Starts the portal development server for local development and testing.
@@ -1463,7 +1581,7 @@ command$9.addCommand(command$a);
  */
 const startPortalDevServer = async (options) => {
     const { log } = options ?? {};
-    // Resolve the application's package.json for root and metadata
+    // Resolve the portals's package.json for root and metadata
     const pkg = await resolveProjectPackage(log);
     // Setup the runtime environment for the dev server
     const env = {
@@ -1473,22 +1591,11 @@ const startPortalDevServer = async (options) => {
         mode: 'development', // Force development mode
         command: 'serve', // Command is always 'serve' for dev
     };
-    // @todo - replace with resolvePortalManifest
-    // Dummy implementation for resolving the portal manifest
-    const resolvePortalManifest = async (...args) => {
-        // Returns a dummy manifest for development; replace with real logic as needed
-        return {
-            id: 'dev-portal-dummy',
-            build: {
-                entrypoint: resolve$1(env.root || '', 'src/index.ts'),
-                // if this is portal - portal-template-manifest
-                template: {},
-            },
-        };
-    };
-    const portalManifest = await resolvePortalManifest();
-    // Dummy implementation for resolving the portal config
-    const resolvePortalConfig = async (...args) => ({ foo: 'bar' });
+    // Resolve the portal manifest using the environment and manifest path
+    const portalManifest = await resolvePortalManifest(env, pkg, {
+        log,
+        manifestPath: options?.manifest,
+    });
     // Resolve the portal config (replace with real logic as needed)
     const portalConfig = await resolvePortalConfig(env, { log, config: options?.config });
     log?.start('Starting app development server...');
@@ -1496,15 +1603,19 @@ const startPortalDevServer = async (options) => {
     const devServer = await createDevServer(env, {
         template: {
             portal: {
-                id: portalManifest.id,
+                id: portalManifest.name,
             },
         },
         portal: {
             manifest: portalManifest,
             config: portalConfig,
         },
+    }, {
         server: {
             port: options?.server?.port,
+            fs: {
+                allow: [pkg.root], // Allow access to the root directory
+            },
         },
     });
     await devServer.listen();
@@ -1514,16 +1625,19 @@ const startPortalDevServer = async (options) => {
     return devServer;
 };
 
-const command$8 = createCommand('dev')
-    .description([
-    'Start the Fusion portal in development mode with live reloading and custom port support.',
+const command$9 = createCommand('dev')
+    .description('Start a local development server for the Fusion portal.')
+    .addHelpText('after', [
     '',
-    'This command launches a local development server for the portal, enabling rapid development and testing.',
-    'You can specify the port and enable debug mode for verbose logging.',
+    'Starts a local development server for your Fusion portal.',
+    '',
+    'Options:',
+    '  -p, --port   Port to run the development server on (default: 3000)',
+    '  -d, --debug  Enable debug mode for verbose logging',
     '',
     'Examples:',
-    '  $ fusion portal dev',
-    '  $ fusion portal dev --port 4000 --debug',
+    '  $ fusion-framework-cli portal dev',
+    '  $ fusion-framework-cli portal dev --port 4000 --debug',
 ].join('\n'))
     .option('-p, --port <number>', 'Port to run the development server on', '3000')
     .option('-d, --debug', 'Enable debug mode for verbose logging')
@@ -1534,18 +1648,21 @@ const command$8 = createCommand('dev')
     log.succeed('Development server started successfully.');
 });
 
-const command$7 = createCommand('manifest')
-    .description([
-    'Build and output the portal manifest for Fusion apps.',
+const command$8 = createCommand('manifest')
+    .description('Generate or validate a Fusion portal manifest file.')
+    .addHelpText('after', [
+    'Generates or validates a Fusion portal manifest file.',
     '',
-    'By default, the manifest is printed to stdout. Use --output to write it to a file.',
-    'You can specify a custom manifest build file or use the default (app.manifest[.env]?.[ts,js,json]).',
-    'Supports debug and silent modes for flexible output.',
+    'If no manifest is provided, a default portal.manifest.[ts|js|json] is used from the current directory.',
+    '',
+    'Options:',
+    '  -o, --output   Write manifest to the specified file (default: stdout)',
+    '  -d, --debug    Enable debug mode for verbose logging',
+    '  -s, --silent   Silent mode, suppresses output except errors',
     '',
     'Examples:',
-    '  $ fusion portal manifest',
-    '  $ fusion portal manifest app.manifest.prod.ts --output ./dist/portal.manifest.json',
-    '  $ fusion portal manifest --debug',
+    '  $ fusion-framework-cli portal manifest',
+    '  $ fusion-framework-cli portal manifest portal.manifest.prod.ts --output ./dist/portal.manifest.json',
 ].join('\n'))
     .option('-d, --debug', 'Enable debug mode for verbose logging', false)
     .option('-o, --output <string>', 'Write manifest to the specified file', 'stdout')
@@ -9351,18 +9468,20 @@ function require_2020 () {
 var _2020Exports = require_2020();
 var Ajv2020 = /*@__PURE__*/getDefaultExportFromCjs(_2020Exports);
 
-const command$6 = createCommand('schema')
-    .description([
-    'Generate and validate the JSON schema for the Fusion portal application.',
+const command$7 = createCommand('schema')
+    .description('Generate or validate a Fusion portal schema file.')
+    .addHelpText('after', [
+    'Generates or validates a Fusion portal schema file.',
     '',
-    'This command generates a schema file for your portal app, optionally writes it to a file, and can validate a JSON file against the generated schema.',
-    'Supports environment selection, debug mode, and output to stdout or file.',
+    'Options:',
+    '  -o, --output   Output file name (default: stdout)',
+    '  -v, --validate Validate the generated schema against a JSON file',
+    '  -d, --debug    Enable debug mode for verbose logging',
     '',
     'Examples:',
-    '  $ fusion portal schema',
-    '  $ fusion portal schema --output portal.schema.json',
-    '  $ fusion portal schema --validate my-config.json',
-    '  $ fusion portal schema portal.schema.prod.ts --debug',
+    '  $ fusion-framework-cli portal schema',
+    '  $ fusion-framework-cli portal schema --output portal.schema.json',
+    '  $ fusion-framework-cli portal schema --validate my-config.json',
 ].join('\n'))
     .addOption(createEnvOption({ allowDev: true }))
     .option('-o, --output <string>', 'Output file name (default: stdout)', 'stdout')
@@ -9411,40 +9530,50 @@ const command$6 = createCommand('schema')
     }
 });
 
-const command$5 = createCommand('build')
-    .description([
-    'Build the Fusion portal using a manifest file and environment-specific configuration.',
+const command$6 = createCommand('build')
+    .description('Build the Fusion portal from a manifest file with environment-specific settings.')
+    .addHelpText('after', [
+    'Builds the Fusion portal using a manifest file and environment-specific configuration.',
     '',
-    'If no manifest is provided, the command will search for a default app.manifest.[ts|js|json] in the current directory.',
-    'You can use environment variables to customize the build process.',
+    'If no manifest is provided, the command will search for a default portal.manifest.[ts|js|json] in the current directory.',
+    'You can use environment variables to customize the build process (e.g., NODE_ENV, FUSION_PORTAL_*).',
+    '',
+    'Options:',
+    '  -d, --debug     Enable debug mode for verbose logging',
     '',
     'Examples:',
-    '  $ fusion portal build',
-    '  $ fusion portal build app.manifest.prod.ts --debug',
+    '  $ fusion-framework-cli portal build',
+    '  $ fusion-framework-cli portal build portal.manifest.prod.ts --debug',
+    '',
 ].join('\n'))
     .option('-d, --debug', 'Enable debug mode for verbose logging', false)
-    .argument('[manifest]', 'Manifest build file to use for building (e.g., app.manifest[.env]?.[ts,js,json])')
+    .argument('[manifest]', 'Manifest build file to use for building (e.g., portal.manifest[.env]?.[ts,js,json])')
     .action(async (manifest, opt) => {
     const log = new ConsoleLogger('portal:build', { debug: opt.debug });
     await buildPortal({ log, manifest });
 });
 
-const command$4 = createCommand('pack')
-    .description([
-    'Create a distributable bundle of the Fusion portal application for deployment.',
+const command$5 = createCommand('pack')
+    .description('Bundle the Fusion portal into a deployable archive.')
+    .addHelpText('after', [
+    'Bundles the Fusion portal using the provided manifest and schema into a zip archive for deployment.',
     '',
-    'This command packages the portal app, allowing you to specify the output archive, manifest, and schema files.',
-    'Supports debug mode for verbose logging.',
+    'If no manifest is provided, a default portal.manifest.[ts|js|json] is used from the current directory.',
+    '',
+    'Options:',
+    '  -a, --archive   Name of the output archive file (default: out/bundle.zip)',
+    '  --schema       Schema file to use for validation',
+    '  -d, --debug    Enable debug mode for verbose logging',
     '',
     'Examples:',
-    '  $ fusion portal pack',
-    '  $ fusion portal pack --archive my-portal.zip --schema portal.schema.json',
-    '  $ fusion portal pack app.manifest.prod.ts --debug',
+    '  $ fusion-framework-cli portal pack',
+    '  $ fusion-framework-cli portal pack --archive my-portal.zip --schema portal.schema.json',
+    '  $ fusion-framework-cli portal pack portal.manifest.prod.ts --debug',
 ].join('\n'))
     .option('-a, --archive [string]', 'Name of the output archive file (default: out/bundle.zip)', 'out/bundle.zip')
     .option('-d, --debug [boolean]', 'Enable debug mode for verbose logging', false)
     .option('--schema [string]', 'Schema file to use for validation')
-    .argument('[manifest]', 'Manifest file to use for bundling (e.g., app.manifest[.env]?.[ts,js,json])')
+    .argument('[manifest]', 'Manifest file to use for bundling (e.g., portal.manifest[.env]?.[ts,js,json])')
     .action(async (manifest, options) => {
     const log = new ConsoleLogger('portal:pack', {
         debug: options.debug,
@@ -9554,17 +9683,18 @@ const uploadPortalBundle = async (opt) => {
     }
 };
 
-const command$3 = withAuthOptions(createCommand('upload')
-    .description([
-    'Upload a Fusion portal bundle to the Fusion portal registry for deployment.',
+const command$4 = withAuthOptions(createCommand('upload')
+    .description('Upload a Fusion portal bundle to the portal registry.')
+    .addHelpText('after', [
+    'Uploads a distributable Fusion portal bundle to the portal registry for deployment.',
     '',
-    'This command uploads a distributable portal bundle to the Fusion portal registry using the current authentication and environment.',
-    'Supports debug mode and custom environment selection.',
+    'Options:',
+    '  --env      Target environment',
+    '  -d, --debug    Enable debug mode for verbose logging',
     '',
     'Examples:',
-    '  $ fusion portal upload my-portal-bundle.zip',
-    '  $ fusion portal upload my-portal-bundle.zip --env prod',
-    '  $ fusion portal upload my-portal-bundle.zip --debug',
+    '  $ fusion-framework-cli portal upload my-portal-bundle.zip',
+    '  $ fusion-framework-cli portal upload my-portal-bundle.zip --env prod',
 ].join('\n'))
     .option('-d, --debug [boolean]', 'Enable debug mode for verbose logging', false)
     .addOption(createEnvOption({ allowDev: false }))
@@ -9679,18 +9809,22 @@ const tagPortal = async (options) => {
     }
 };
 
-const command$2 = withAuthOptions(createCommand('tag')
-    .description([
-    'Tag your Fusion portal application with a specific version or preview in the Fusion portal registry.',
+const command$3 = withAuthOptions(createCommand('tag')
+    .description('Tag your Fusion portal with a specific version or label.')
+    .addHelpText('after', [
+    'Tags your Fusion portal with a specific version or label in the portal registry.',
     '',
-    'This command applies a tag to the specified portal version, making it easy to manage releases and previews.',
-    'You can provide the portal name and version directly, or let the command resolve them from the manifest file.',
-    'Supports environment selection, debug, and silent modes.',
+    'Options:',
+    '  -n, --name      Portal name (if not provided, resolved from manifest)',
+    '  -m, --manifest  Manifest file to use for resolving portal name and version',
+    '  -v, --version   Version to tag (if not provided, resolved from manifest)',
+    '  --env          Target environment',
+    '  -d, --debug    Enable debug mode for verbose logging',
+    '  --silent       Silent mode, suppresses output except errors',
     '',
     'Examples:',
-    '  $ fusion portal tag latest',
-    '  $ fusion portal tag preview --env prod --manifest portal.manifest.prod.ts',
-    '  $ fusion portal tag stable --name my-portal --version 1.2.3',
+    '  $ fusion-framework-cli portal tag latest',
+    '  $ fusion-framework-cli portal tag preview --env prod --manifest portal.manifest.prod.ts',
 ].join('\n'))
     .addOption(createEnvOption({ allowDev: false }))
     .option('-n, --name <string>', 'Portal name (if not provided, resolved from manifest)')
@@ -9740,18 +9874,21 @@ const command$2 = withAuthOptions(createCommand('tag')
     });
 }));
 
-const command$1 = withAuthOptions(createCommand('publish')
-    .description([
-    'Build, upload, and tag your Fusion portal bundle for deployment to the Fusion portal registry.',
+const command$2 = withAuthOptions(createCommand('publish')
+    .description('Build, upload, and tag your Fusion portal bundle for deployment.')
+    .addHelpText('after', [
+    'Builds, uploads, and tags your Fusion portal bundle for deployment to the portal registry.',
     '',
-    'This command bundles the portal, uploads it to the registry, and applies a tag for versioning.',
-    'You can specify the environment, manifest file, schema, and tag. Debug mode and authentication options are supported.',
+    'Options:',
+    '  --env         Target environment',
+    '  -m, --manifest  Manifest file to use for bundling',
+    '  --schema      Schema file to use for validation',
+    '  -t, --tag     Tag to apply to the published portal',
+    '  -d, --debug   Enable debug mode for verbose logging',
     '',
     'Examples:',
-    '  $ fusion portal publish',
-    '  $ fusion portal publish --env prod --manifest portal.manifest.prod.ts',
-    '  $ fusion portal publish --tag latest --debug',
-    '  $ fusion portal publish --schema portal.schema.json',
+    '  $ fusion-framework-cli portal publish',
+    '  $ fusion-framework-cli portal publish --env prod --manifest portal.manifest.prod.ts',
 ].join('\n'))
     .option('-d, --debug', 'Enable debug mode for verbose logging', false)
     .addOption(createEnvOption({ allowDev: false }))
@@ -9803,8 +9940,102 @@ const command$1 = withAuthOptions(createCommand('publish')
     log.succeed('🏷️ Tagging completed');
 }));
 
+/**
+ * CLI command: `portal config`
+ *
+ * Generates and/or publishes the portal configuration for Fusion portals.
+ *
+ * Features:
+ * - Outputs the generated config to stdout or a file.
+ * - Use --publish to upload the config to the Fusion portal registry.
+ * - Options [token, tenant, client, config, identifier, env, output] are only relevant when --publish is used.
+ * - Option [--env] cannot be set to dev when --publish is used.
+ *
+ * Usage:
+ *   $ fusion-framework-cli portal config --identifier <portal@version> [options]
+ *
+ * Options:
+ *   --debug                      Enable debug mode for verbose logging
+ *   --silent                     Silent mode, suppresses output except errors
+ *   --publish                    Publish config to Fusion portal registry
+ *   --identifier <name@version>  Identifier of the portal, example my-portal@1.2.3 (required with --publish)
+ *   -o, --output <stdout|path>   Output to stdout or a file (default: stdout)
+ *   <config>                     Path to the portal config file (e.g., portal.config[.env]?.[ts,js,json])
+ *   --env <env>                  Target environment
+ *
+ * Examples:
+ *   $ fusion-framework-cli portal config --identifier my-portal@1.2.3 -o stdout portal.config.ts
+ *   $ fusion-framework-cli portal config --identifier my-portal@1.2.3 -o ./dist/portal.config.json portal.config.prod.ts
+ *   $ fusion-framework-cli portal config --publish --env prod --identifier my-portal@1.2.3 portal.config.ts
+ *
+ * @see generatePortalConfig, publishPortalConfig for implementation details
+ */
+const command$1 = withAuthOptions(createCommand('config')
+    .description('Generate or publish the Fusion portal configuration file.')
+    .addHelpText('after', [
+    'Generates and/or publishes the Fusion portal configuration.',
+    '',
+    'By default, outputs the config to stdout or a file. Use --publish to upload to the portal registry.',
+    '',
+    'Options:',
+    '  --publish         Publish config to Fusion portal registry',
+    '  --identifier      Portal identifier (required with --publish)',
+    '  -o, --output      Output to stdout or a file (default: stdout)',
+    '  --env             Target environment',
+    '  --debug           Enable debug mode for verbose logging',
+    '',
+    'Examples:',
+    '  $ fusion-framework-cli portal config --identifier my-portal@1.2.3 -o stdout portal.config.ts',
+    '  $ fusion-framework-cli portal config --publish --env prod --identifier my-portal@1.2.3 portal.config.ts',
+].join('\n'))
+    .option('--debug', 'Enable debug mode for verbose logging')
+    .option('--silent', 'Silent mode, suppresses output except errors')
+    .option('--publish <name@version>', 'Publish config to Fusion portal registry, Identifier of the portal, example my-portal@1.2.3')
+    .addOption(createEnvOption({ allowDev: true }))
+    .option('-o, --output <stdout|path>', 'Output the result to stdout or a file (ignored with --publish, default: stdout)', 'stdout')
+    .argument('[config]', 'Path to the portal config file (e.g., portal.config[.env]?.[ts,js,json])')
+    .action(async (config, options) => {
+    const log = options.silent
+        ? null
+        : new ConsoleLogger('portal:config', { debug: !!options.debug });
+    // Validate env for publish (no dev allowed)
+    if (options.publish) {
+        const [name, version] = options.publish.split('@') || [];
+        if (!name || !version) {
+            log?.fail('🤪', 'Portal identifier is required when using', chalk.blue('--publish'));
+            log?.info('Example: fusion-framework-cli portal config --publish my-portal@1.2.3');
+            process.exit(1);
+        }
+        if (options.env === 'dev') {
+            log?.fail('🤪', chalk.blue('--env'), 'cannot be "dev" when', chalk.blue('--publish'), ' is used');
+            process.exit(1);
+        }
+        return publishPortalConfig({
+            config: options.config,
+            portal: {
+                name,
+                version,
+            },
+            environment: options.env,
+            auth: 'token' in options ? { token: options.token } : options,
+            debug: options.debug,
+        });
+    }
+    // Generate config
+    const { config: portalConfig } = await generatePortalConfig({
+        log,
+        config,
+        env: { environment: options.env },
+        output: options.output === 'stdout' ? undefined : options.output,
+    });
+    if (options.output === 'stdout') {
+        stdout.write(JSON.stringify(portalConfig, null, 2));
+    }
+}));
+
 const command = createCommand('portal')
     .description('Develop and deploy portal templates')
+    .addCommand(command$9)
     .addCommand(command$8)
     .addCommand(command$7)
     .addCommand(command$6)
@@ -9815,9 +10046,9 @@ const command = createCommand('portal')
     .addCommand(command$1);
 
 var registerCommands = (program) => {
-    program.addCommand(command$f);
-    program.addCommand(command$b);
-    program.addCommand(command$9);
+    program.addCommand(command$g);
+    program.addCommand(command$c);
+    program.addCommand(command$a);
     program.addCommand(command);
 };