Usage

ubc features explorative help pages. Add -h/--help to any command to see the available options. Many commands directly show the help page when executed without any options and arguments.

The following sections show all available (sub-)commands.

Somes notes upfront:

  • ubc check shows warnings for individual files while ubc build index reports warnings for the whole project, so it can also consider needs graph problems, such as duplicate IDs across multiple files.

  • ubc build index builds a project index including caches just like ubCode . Therefore it makes sense to keep ubCode and ubc versions in sync.

ubc

ubc Usage: ubc [OPTIONS] COMMAND [ARGS]... CLI for the ubcode project ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--versionShow the version and exit│ │--install-completionInstall completion for the current shell.│ │--show-completionShow completion for the current shell, to copy it  │ │or customize the installation.                     │ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ────────────────────────────────────────────────────────────────────────╮ │check      Run linting checks on individual files or directories.              │ │format     Run formatting on individual files or directories.                  │ │clean      Clear any caches in the directory and any subdirectories            │ │config     Show the nearest configuration in JSON format, resolving any extends│ │and defaults.                                                       │ │script     Run a script defined in ubproject.toml.                             │ │quickstart Create an example ubcode project.                                   │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Sub-menus ───────────────────────────────────────────────────────────────────────╮ │build      Commands for building projects                                      │ │license    Commands for managing licenses                                      │ │diff       Commands for diff and impact analysis                               │ ╰───────────────────────────────────────────────────────────────────────────────────╯

check

check Usage: ubc check [OPTIONS] FILES... Run linting checks on individual files or directories. Each file file will be processed against its nearest configuration file, or the  default configuration if no configuration file is found. ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │*filesFILES...Files or directories to run checks on[required]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Config Overrides ────────────────────────────────────────────────────────────────╮ │--extend-ignoreComma-separatedComma-separated list of additional       │ │diagnostic codes to ignore               │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Configuration ───────────────────────────────────────────────────────────────────╮ │--isolatedDo not read any configuration files, use only the default│ │configuration                                            │ │--configPATHThe path to a specific configuration file to use for all │ │files                                                    │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Processing ──────────────────────────────────────────────────────────────────────╮ │--parallel--no-parallelParallel process, if it might be    │ │faster.                             │ │[default: parallel]                 │ │--force-parallel--no-force-parallelForce parallel processing.  │ │[default: no-force-parallel]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ License ─────────────────────────────────────────────────────────────────────────╮ │--license-keyTEXT    Use a specific license key.  │ │[env var: UBCODE_LICENSE_KEY]│ │--license-userTEXT    Use a specific license user.  │ │[env var: UBCODE_LICENSE_USER]│ │--license-stageprod|devUse a specific license stage   │ │[env var: UBCODE_LICENSE_STAGE]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯

format

format Usage: ubc format [OPTIONS] FILES... Run formatting on individual files or directories. Each file file will be processed against its nearest configuration file, or the  default configuration if no configuration file is found. ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │*filesFILES...Files or directories to run formatting on[required]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--check--no-checkAvoid writing any formatted files back; instead,  │ │exit with a non-zero status code if any files     │ │would have been modified, and zero otherwise      │ │[default: no-check]                               │ │--preview--no-previewActivate this command in preview mode.│ │[default: no-preview]                 │ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Configuration ───────────────────────────────────────────────────────────────────╮ │--isolated--no-isolatedDo not read any configuration files, use    │ │only the default configuration              │ │[default: no-isolated]                      │ │--configPATHThe path to a specific configuration file to│ │use for all files                           │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Processing ──────────────────────────────────────────────────────────────────────╮ │--parallel--no-parallelParallel process, if it might be    │ │faster.                             │ │[default: parallel]                 │ │--force-parallel--no-force-parallelForce parallel processing.  │ │[default: no-force-parallel]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ License ─────────────────────────────────────────────────────────────────────────╮ │--license-keyTEXT    Use a specific license key.  │ │[env var: UBCODE_LICENSE_KEY]│ │--license-userTEXT    Use a specific license user.  │ │[env var: UBCODE_LICENSE_USER]│ │--license-stageprod|devUse a specific license stage   │ │[env var: UBCODE_LICENSE_STAGE]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯

clean

clean Usage: ubc clean [OPTIONS] [PATH] Clear any caches in the directory and any subdirectories ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │path[PATH]The path to the directory to clean│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯

config

config Usage: ubc config [OPTIONS] [PATH] Show the nearest configuration in JSON format, resolving any extends and defaults. ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │path[PATH]The path to start the config search from.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--indent-iINTEGERNumber of spaces to indent JSON.│ │[default: 0]                    │ │--default--no-defaultShow the default configuration instead.│ │[default: no-default]                  │ │--schema--no-schemaShow the configuration schema instead.│ │[default: no-schema]                  │ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Config ──────────────────────────────────────────────────────────────────────────╮ │--config-nameFILENAMEName of the configuration file to look for│ │[default: ubproject.toml]                 │ ╰───────────────────────────────────────────────────────────────────────────────────╯

script

script Usage: ubc script [OPTIONS] KEY Run a script defined in ubproject.toml. ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │*keyTEXTThe script key to execute.[default: None][required]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--pathPATHThe path to the project root│ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Config ──────────────────────────────────────────────────────────────────────────╮ │--config-nameFILENAMEName of the configuration file to look for│ │[default: ubproject.toml]                 │ ╰───────────────────────────────────────────────────────────────────────────────────╯

quickstart

quickstart Usage: ubc quickstart [OPTIONS] [PATH] Create an example ubcode project. ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │path[PATH]The path to write to│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--overwrite-oOverwrite existing files│ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯

build

build Usage: ubc build [OPTIONS] COMMAND [ARGS]... Commands for building projects ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ────────────────────────────────────────────────────────────────────────╮ │list-documents Print out a list of the documents that would be indexed for this│ │project.                                                        │ │index          Index the project and report warnings.                          │ │needs          Build the needs index and output to a file.                     │ │validate-json  Validate a needs.json file.                                     │ │json-to-kuzu   Convert a needs.json file to a Kuzu database.                   │ │targets        Build the reference targets index and output to a file          │ │(experimental).                                                 │ ╰───────────────────────────────────────────────────────────────────────────────────╯

list-documents

list-documents Usage: ubc build list-documents [OPTIONS] [PATH] Print out a list of the documents that would be indexed for this project. ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │path[PATH]The path to the project root│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ License ─────────────────────────────────────────────────────────────────────────╮ │--license-keyTEXT    Use a specific license key.  │ │[env var: UBCODE_LICENSE_KEY]│ │--license-userTEXT    Use a specific license user.  │ │[env var: UBCODE_LICENSE_USER]│ │--license-stageprod|devUse a specific license stage   │ │[env var: UBCODE_LICENSE_STAGE]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Config ──────────────────────────────────────────────────────────────────────────╮ │--config-nameFILENAMEName of the configuration file to look for│ │[default: ubproject.toml]                 │ ╰───────────────────────────────────────────────────────────────────────────────────╯

index

index Usage: ubc build index [OPTIONS] [PATH] Index the project and report warnings. Returns a non-zero exit code if warnings are found. ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │path[PATH]The path to the project root│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--show-warnings-wShow warnings during the build process│ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Config Overrides ────────────────────────────────────────────────────────────────╮ │--lint-extend-ignoreComma-separatedComma-separated list of additional  │ │diagnostic codes to ignore          │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Processing ──────────────────────────────────────────────────────────────────────╮ │--parallel--no-parallelParallel process, if it might be    │ │faster.                             │ │[default: parallel]                 │ │--force-parallel--no-force-parallelForce parallel processing.  │ │[default: no-force-parallel]│ │--cache--no-cacheUse on-disk cache reads│ │[default: cache]       │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ License ─────────────────────────────────────────────────────────────────────────╮ │--license-keyTEXT    Use a specific license key.  │ │[env var: UBCODE_LICENSE_KEY]│ │--license-userTEXT    Use a specific license user.  │ │[env var: UBCODE_LICENSE_USER]│ │--license-stageprod|devUse a specific license stage   │ │[env var: UBCODE_LICENSE_STAGE]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Config ──────────────────────────────────────────────────────────────────────────╮ │--config-nameFILENAMEName of the configuration file to look for│ │[default: ubproject.toml]                 │ ╰───────────────────────────────────────────────────────────────────────────────────╯

needs

needs Usage: ubc build needs [OPTIONS] [PATH] Build the needs index and output to a file. ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │path[PATH]The path to the project root│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--format-f[json|parquet|kuzu]The output format│ │[default: json]  │ │--outpath-oPATH               The path to the      │ │output file          │ │--source-maps--no-source-mapsInclude source map   │ │information for each │ │need                 │ │[default:            │ │source-maps]         │ │--helpShow this message and│ │exit.                │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Processing ──────────────────────────────────────────────────────────────────────╮ │--parallel--no-parallelParallel process, if it might be    │ │faster.                             │ │[default: parallel]                 │ │--force-parallel--no-force-parallelForce parallel processing.  │ │[default: no-force-parallel]│ │--cache--no-cacheUse on-disk cache reads│ │[default: cache]       │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ License ─────────────────────────────────────────────────────────────────────────╮ │--license-keyTEXT    Use a specific license key.  │ │[env var: UBCODE_LICENSE_KEY]│ │--license-userTEXT    Use a specific license user.  │ │[env var: UBCODE_LICENSE_USER]│ │--license-stageprod|devUse a specific license stage   │ │[env var: UBCODE_LICENSE_STAGE]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Config ──────────────────────────────────────────────────────────────────────────╮ │--config-nameFILENAMEName of the configuration file to look for│ │[default: ubproject.toml]                 │ ╰───────────────────────────────────────────────────────────────────────────────────╯

validate-json

validate-json Usage: ubc build validate-json [OPTIONS] PATH [ID]... Validate a needs.json file. ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │*pathPATH   The path to the needs.json file[required]│ │ids [ID]...Only validate certain need IDs│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ ╰───────────────────────────────────────────────────────────────────────────────────╯

json-to-kuzu

json-to-kuzu Usage: ubc build json-to-kuzu [OPTIONS] INPUT Convert a needs.json file to a Kuzu database. Note this requires a new-style needs.json, that includes a needs_schema. ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │*inputPATHThe path to the needs.json file[required]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--output-oPATHThe path to the output Kuzu DB directory│ │[default: needs.kuzu]                   │ │--overwrite--no-overwrite[default: no-overwrite]│ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ ╰───────────────────────────────────────────────────────────────────────────────────╯

targets

targets Usage: ubc build targets [OPTIONS] [PATH] Build the reference targets index and output to a file (experimental). ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │path[PATH]The path to the project root│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--format-f[inv]The output format[default: inv]│ │--outpath-oPATH The path to the output file│ │--compress--no-compressWhether to compress inv file with zlib│ │[default: compress]                   │ │--srcdirPATH The source directory to relativize paths │ │to (defaults to the project.srcdir)      │ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Processing ──────────────────────────────────────────────────────────────────────╮ │--parallel--no-parallelParallel process, if it might be    │ │faster.                             │ │[default: parallel]                 │ │--force-parallel--no-force-parallelForce parallel processing.  │ │[default: no-force-parallel]│ │--cache--no-cacheUse on-disk cache reads│ │[default: cache]       │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ License ─────────────────────────────────────────────────────────────────────────╮ │--license-keyTEXT    Use a specific license key.  │ │[env var: UBCODE_LICENSE_KEY]│ │--license-userTEXT    Use a specific license user.  │ │[env var: UBCODE_LICENSE_USER]│ │--license-stageprod|devUse a specific license stage   │ │[env var: UBCODE_LICENSE_STAGE]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Config ──────────────────────────────────────────────────────────────────────────╮ │--config-nameFILENAMEName of the configuration file to look for│ │[default: ubproject.toml]                 │ ╰───────────────────────────────────────────────────────────────────────────────────╯

license

license Usage: ubc license [OPTIONS] COMMAND [ARGS]... Commands for managing licenses ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ────────────────────────────────────────────────────────────────────────╮ │activate Activate the current license.                                         │ │clean    Clear the ublicense cache.                                            │ │hash     Show hash for a given user e-mail.                                    │ │show     Show information for the current license.                             │ ╰───────────────────────────────────────────────────────────────────────────────────╯

activate

activate Usage: ubc license activate [OPTIONS] Activate the current license. ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--key-kTEXTThe license key to activate, otherwise look in     │ │configuration.                                     │ │[env var: UBCODE_LICENSE_KEY]                      │ │--user-uTEXTThe license user to activate, otherwise look in    │ │configuration.                                     │ │[env var: UBCODE_LICENSE_USER]                     │ │--dev--no-devUse the development product│ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯

clean

clean Usage: ubc license clean [OPTIONS] Clear the ublicense cache. This is useful to refresh the license activation before going offline for a while. ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯

hash

hash Usage: ubc license hash [OPTIONS] Show hash for a given user e-mail. ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--user-uTEXTUser e-mail to hash. If not provided, look in              │ │configuration.                                             │ │[env var: UBCODE_LICENSE_USER]                             │ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯

show

show Usage: ubc license show [OPTIONS] Show information for the current license. ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--key-kTEXTThe license key to show       │ │information for, otherwise    │ │look in configuration.        │ │[env var: UBCODE_LICENSE_KEY] │ │--dev--no-devUse the development product│ │--json--no-jsonPrint output as JSON. Implies │ │--quiet.                      │ │--show-activated--no-show-activatedShow activated machines│ │--helpShow this message and exit.│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯

diff

diff Usage: ubc diff [OPTIONS] COMMAND [ARGS]... Commands for diff and impact analysis ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--needs-nPATH                    Needs.json file path (can │ │be used twice for         │ │comparison)               │ │[default: None]           │ │--project-pPATH                    Project path (can be used │ │twice for comparison)     │ │[default: None]           │ │--impactEnable impact analysis│ │--impact-depthINTEGER                 Set impact analysis link  │ │depth                     │ │[default: 1]              │ │--impact-direction[outgoing|incoming|both]Set impact analysis       │ │direction                 │ │[default: both]           │ │--impact-max-chainsINTEGER                 Maximum number of impact  │ │chains per changed need (0│ │= unlimited)              │ │[default: 20]             │ │--allow-typeTEXT                    Allow-filter for need     │ │types [multiple]          │ │--deny-typeTEXT                    Deny-filter for need types│ │[multiple]                │ │--allow-coreTEXT                    Allow-filter for core     │ │fields [multiple]         │ │--deny-coreTEXT                    Deny-filter for core      │ │fields [multiple]         │ │--allow-extraTEXT                    Allow-filter for extra    │ │fields [multiple]         │ │--deny-extraTEXT                    Deny-filter for extra     │ │fields [multiple]         │ │--allow-linkTEXT                    Allow-filter for link     │ │types [multiple]          │ │--deny-linkTEXT                    Deny-filter for link types│ │[multiple]                │ │--format-f[html|console]Output format     │ │[default: console]│ │--outpath-oPATH                    Output file path (for HTML│ │format)                   │ │[default: None]           │ │--html-theme[dark|light|auto]HTML theme for output│ │[default: auto]      │ │--helpShow this message and     │ │exit.                     │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Processing ──────────────────────────────────────────────────────────────────────╮ │--parallel--no-parallelParallel process, if it might be    │ │faster.                             │ │[default: parallel]                 │ │--force-parallel--no-force-parallelForce parallel processing.  │ │[default: no-force-parallel]│ │--cache--no-cacheUse on-disk cache reads│ │[default: cache]       │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ License ─────────────────────────────────────────────────────────────────────────╮ │--license-keyTEXT    Use a specific license key.  │ │[env var: UBCODE_LICENSE_KEY]│ │--license-userTEXT    Use a specific license user.  │ │[env var: UBCODE_LICENSE_USER]│ │--license-stageprod|devUse a specific license stage   │ │[env var: UBCODE_LICENSE_STAGE]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ────────────────────────────────────────────────────────────────────────╮ │git Git-based diff and impact analysis                                         │ ╰───────────────────────────────────────────────────────────────────────────────────╯

git

git Usage: ubc diff git [OPTIONS] [REF1] [REF2] Git-based diff and impact analysis ╭─ Arguments ───────────────────────────────────────────────────────────────────────╮ │ref1[REF1]First git reference (branch/tag/commit)[default: None]│ │ref2[REF2]Second git reference (branch/tag/commit)[default: None]│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ─────────────────────────────────────────────────────────────────────────╮ │--project-pPATH                    Project path. Defaults to │ │current working directory.│ │--needs-nPATH                    Needs.json file path in   │ │the repository.           │ │--stagedCompare staging area with │ │HEAD                      │ │--impactEnable impact analysis│ │--impact-depthINTEGER                 Set impact analysis link  │ │depth                     │ │[default: 1]              │ │--impact-direction[outgoing|incoming|both]Set impact analysis       │ │direction                 │ │[default: both]           │ │--impact-max-chainsINTEGER                 Maximum number of impact  │ │chains per changed need (0│ │= unlimited)              │ │[default: 20]             │ │--allow-typeTEXT                    Allow-filter for need     │ │types [multiple]          │ │--deny-typeTEXT                    Deny-filter for need types│ │[multiple]                │ │--allow-coreTEXT                    Allow-filter for core     │ │fields [multiple]         │ │--deny-coreTEXT                    Deny-filter for core      │ │fields [multiple]         │ │--allow-extraTEXT                    Allow-filter for extra    │ │fields [multiple]         │ │--deny-extraTEXT                    Deny-filter for extra     │ │fields [multiple]         │ │--allow-linkTEXT                    Allow-filter for link     │ │types [multiple]          │ │--deny-linkTEXT                    Deny-filter for link types│ │[multiple]                │ │--format-f[html|console]Output format     │ │[default: console]│ │--outpath-oPATH                    Output file path (for HTML│ │format)                   │ │[default: None]           │ │--html-theme[dark|light|auto]HTML theme for output│ │[default: auto]      │ │--helpShow this message and     │ │exit.                     │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Processing ──────────────────────────────────────────────────────────────────────╮ │--parallel--no-parallelParallel process, if it might be    │ │faster.                             │ │[default: parallel]                 │ │--force-parallel--no-force-parallelForce parallel processing.  │ │[default: no-force-parallel]│ │--cache--no-cacheUse on-disk cache reads│ │[default: cache]       │ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ Logging ─────────────────────────────────────────────────────────────────────────╮ │--verbose-vShow debug information│ │--quiet-qOnly show errors and warnings│ ╰───────────────────────────────────────────────────────────────────────────────────╯ ╭─ License ─────────────────────────────────────────────────────────────────────────╮ │--license-keyTEXT    Use a specific license key.  │ │[env var: UBCODE_LICENSE_KEY]│ │--license-userTEXT    Use a specific license user.  │ │[env var: UBCODE_LICENSE_USER]│ │--license-stageprod|devUse a specific license stage   │ │[env var: UBCODE_LICENSE_STAGE]│ ╰───────────────────────────────────────────────────────────────────────────────────╯