Skip to main content

repo-manager Documentation

This document provides documentation for the repo-manager command-line tool. repo-manager is a set of tools designed to manage a Compliance Engine policy repository.

repo-manager​

Set of tools to manage compliance-platform-policies repository.

repo-manager [OPTIONS] [COMMAND]

Options​

  • --[no-]auto-update
    • Manually trigger or suppress repo-manager update. By default auto-update will trigger periodically.
  • -b, --backend=BACKEND
    • API backend. Valid values: PRODUCTION, LOCAL.
    • Default: PRODUCTION
  • -c, --config=PATH
    • Path to the configuration folder.
    • Default: .ca
  • -h, --help
    • Show this help message and exit.
  • -r, --repository=PATH
    • Path to the root of repository.
    • Default: ''
  • -V, --version
    • Print version information and exit.

Subcommands​

  • auth - Authorization commands.
  • env - Shows the information about the current environment.
  • policies - Tools for working with compliance policies.
  • docs - Tools to manage auto-generated documentation from repository.
  • schema - Tools to manage schema files in the repository.
  • sections - Tools for working with frameworks and sections.
  • types - Tools for working with types form the Salesforce Org.
  • ai - Tools for working with AI and LLMs.
  • ui - Run UI for repo-manager.
  • soql - Tools for working with SOQL queries.
  • mcp - Command that starts MCP servers.
  • gen-manpage - Generates man pages for all commands in the specified directory.
  • cleanup - Cleans up generated and imported files and directories from repository.

repo-manager auth​

Authorization commands.

repo-manager auth [OPTIONS] [COMMAND]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Subcommands​

repo-manager auth activate​

Set the active profile for repo-manager to use for subsequent commands.

repo-manager auth activate [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -n, --name=NAME
    • Name of the profile to activate.
  • -V, --version
    • Print version information and exit.

repo-manager auth add​

Add auth profile.

Add a new authorization profile for repo-manager to connect to Salesforce.

repo-manager auth add [OPTIONS]

Options​

  • -a, --[no-]active
    • Sets this profile as active upon creation.
  • -h, --help
    • Show this help message and exit.
  • -n, --name=NAME
    • Name of the profile to be added.
  • -s, --[no-]sandbox
    • Set this profile for a Salesforce sandbox organization.
  • -t, --token=TOKEN
    • OAuth token obtained from Cloudaware Admin Tab.
  • -V, --version
    • Print version information and exit.

repo-manager auth list​

List all configured authorization profiles for repo-manager.

repo-manager auth list [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

repo-manager auth refresh-session​

Refreshes the current session for the active authorization profile, ensuring continued access to Salesforce.

repo-manager auth refresh-session [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

repo-manager auth remove​

Remove a configured authorization profile from repo-manager.

repo-manager auth remove [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -n, --name=NAME
    • Name of the profile to remove.
  • -V, --version
    • Print version information and exit.

repo-manager env​

Shows the information about the current environment.

repo-manager env [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

repo-manager docs​

Tools to manage auto-generated documentation from the repository.

repo-manager docs [OPTIONS] [COMMAND]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Subcommands​

  • cleanup - Cleans up documentation files from repository.
  • generate - Generates documentation for the repository.

repo-manager docs cleanup​

Cleans up generated documentation files from the repository, removing auto-generated documentation clutter.

repo-manager docs cleanup [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

repo-manager docs generate​

Generates documentation for the repository based on the current state of the code and configurations.

repo-manager docs generate [OPTIONS]

Options​

  • -f, --format=<arg1>
    • Output format.
    • Valid values: MD, MDX.
  • -h, --help
    • Show this help message and exit.
  • -r, --renderer=<arg2>
    • Renderer that will show documentation for the user.
    • Valid values: NONE, CLOUDAWARE, DOCUSAURUS.
  • -t, --threads=<arg3>
    • Number of worker threads.
    • Default: CPU_COUNT/2.
  • -V, --version
    • Print version information and exit.
  • -w, --watch
    • Watch the repository for modifications and automatically update the generated documentation files when changes are detected.

repo-manager policies​

Tools for managing and working with compliance policies within the repository.

repo-manager policies [OPTIONS] [COMMAND]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Subcommands​

  • capture-test-data - Captures the test-data.json for the specified policy from the data available in CloudAware.
  • evaluate-object - Evaluates a single object with a single policy.
  • generate - Generate BigQuery script for a policy.
  • import-stats - Imports stats for the latest runs of all policies into a file.
  • test - Run tests for a policy.

repo-manager policies capture-test-data​

Captures the test-data.json for the specified policy from the data available in CloudAware.

repo-manager policies capture-test-data [OPTIONS] <id>

Options​

  • -h, --help
    • Show this help message and exit.
  • -o, --output-file=PATH
    • Path to the output file.
    • Default: POLICY_DIR/test-data.json
  • -V, --version
    • Print version information and exit.

Arguments​

  • id
    • Policy ID/Path or Logic ID/Path.

repo-manager policies evaluate-object​

Evaluates a single object with a single policy.

repo-manager policies evaluate-object [OPTIONS] <id> <caUuid>

Options​

  • -c, --command=<arg3>
    • In case of immediate execution, command to pass the path to received script.
    • Default: node
  • -e, --execute
    • Execute the received script immediately.
    • Default: false
  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.
  • -w, --wrapper=<arg4>
    • Wrapper for received script, use __CONTENT__ to substitute script content.

Arguments​

  • id
    • Policy ID/Path or Logic ID/Path.
  • caUuid
    • CloudAware UUID of the object to test.

repo-manager policies generate​

Generates a BigQuery script for a specified compliance policy, allowing for different script types based on the provided kind.

repo-manager policies generate [OPTIONS] <kind> <id>

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Arguments​

  • kind
    • Kind of script to generate.
    • Valid values: FULL, DEBUG, CAPTURE_TEST_DATA, TESTS.
  • id
    • Policy ID or Logic ID for which to generate the script.

repo-manager policies import-stats​

Imports stats for the latest runs of all policies into a file.

repo-manager policies import-stats [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

repo-manager policies test​

Runs tests for a specified compliance policy to ensure its correctness and validity.

repo-manager policies test [OPTIONS] <id>

Options​

  • --format=<arg1>
    • Output format.
    • Valid values: NONE, JUNIT.
  • -h, --help
    • Show this help message and exit.
  • --output-dir=<arg2>
    • Output directory for reports.
    • Default: REPO/target/surefire-reports for JUNIT.
  • -t, --threads=<arg3>
    • Number of worker threads.
    • Default: 1, maximum: 5.
  • -V, --version
    • Print version information and exit.

Arguments​

  • id
    • Policy ID/Path, Logic ID/Path, Folder ID/Path, 'all' or 'unit-tests'.

repo-manager schema​

Tools for managing and updating schema files within the repository.

repo-manager schema [OPTIONS] [COMMAND]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Subcommands​

  • update - Updates schema files in the repository.

repo-manager schema update​

Updates schema files within the repository to reflect the latest data structures and definitions.

repo-manager schema update [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

repo-manager ai​

Tools for working with AI and LLMs.

repo-manager ai [OPTIONS] [COMMAND]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Subcommands​

  • context - Tools for to manage context information for LLMs.

repo-manager ai context​

Tools for to manage context information for LLMs.

repo-manager ai context [OPTIONS] [COMMAND]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Subcommands​

  • generate - Generates context information for LLMs.

repo-manager ai context generate​

Generates context information for LLMs.

repo-manager ai context generate [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -o, --output-directory=PATH
    • Path to the output file.
    • Default: 'tmp/llm-context'
  • -V, --version
    • Print version information and exit.

repo-manager ui​

Run UI for repo-manager.

repo-manager ui [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

repo-manager soql​

Tools for working with SOQL queries.

repo-manager soql [OPTIONS] [COMMAND]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Subcommands​

  • convert - Converts provided SOQL query into BigQuery query.

repo-manager soql convert​

Converts provided SOQL query into BigQuery query.

repo-manager soql convert [OPTIONS] queryText

Options​

  • -h, --help
    • Show this help message and exit.
  • -i, --input-file=<arg0>
    • Input file with query to convert
  • -o, --output-file=<arg1>
    • Output file where to store converted query
  • -V, --version
    • Print version information and exit.

Arguments​

  • queryText
    • SOQL query text to convert

repo-manager sections​

Tools for managing frameworks and sections, likely related to compliance frameworks and their sectional breakdown within the repository.

repo-manager sections [OPTIONS] [COMMAND]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Subcommands​

  • export - Exports the framework sections to a file.

repo-manager sections export​

Exports the defined framework sections to a file, allowing for data extraction in various formats.

repo-manager sections export [OPTIONS]

Options​

  • -f, --format=FORMAT
    • Format to use for export.
    • Valid values: DEFAULT_CSV, INFORMIX_UNLOAD_CSV, INFORMIX_UNLOAD, EXCEL, MONGODB_CSV, MONGODB_TSV, MYSQL, ORACLE, POSTGRESQL_CSV, POSTGRESQL_TEXT, RFC4180, TDF, BIGQUERY, JSONL.
    • Default: DEFAULT
  • -h, --help
    • Show this help message and exit.
  • -o, --output-directory=PATH
    • Path to the output file.
    • Default: 'tmp'
  • -V, --version
    • Print version information and exit.

repo-manager types​

Tools for managing Salesforce SObject types data within the repository, likely used for schema management or policy definition.

repo-manager types [OPTIONS] [COMMAND]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Subcommands​

  • delete - Remove imported Salesforce SObject types data.
  • import - Import Salesforce SObject types data.

repo-manager types delete​

Removes previously imported Salesforce SObject types data from repo-manager, allowing for a clean slate or data refresh.

repo-manager types delete [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

repo-manager types import​

Imports Salesforce SObject types data, enriching repo-manager with Salesforce schema information for policy and logic definitions.

repo-manager types import [OPTIONS]

Options​

  • --exclude-custom-fields
    • Excludes custom fields from imported types, focusing on standard Salesforce objects.
  • --exclude-custom-types
    • Excludes custom types from imported types.
  • -h, --help
    • Show this help message and exit.
  • -p, --preset=PRESET
    • One or more presets to import.
    • Valid values: REFERENCED, CLOUDAWARE, STANDARD, EXTRA.
  • -t, --type=TYPE
    • Salesforce type API name to import. Can be specified multiple times.
  • -V, --version
    • Print version information and exit.

repo-manager mcp​

Command that starts MCP servers.

repo-manager mcp [OPTIONS] [COMMAND]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Subcommands​

  • cloudaware - Starts cloudaware-mcp server with Stdio transport.

repo-manager mcp cloudaware​

Starts cloudaware-mcp server with Stdio transport.

repo-manager mcp cloudaware [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -p, --port=<arg0>
    • Port that HTTP server will listen on, if not specified server starts with stdio transport.
  • -V, --version
    • Print version information and exit.

repo-manager gen-manpage​

Generates man pages in AsciiDoc format for all repo-manager commands found within a specified directory.

repo-manager gen-manpage [OPTIONS] [@<filename>...]

Options​

  • -d, --outdir=<outdir>
    • Output directory to write the generated AsciiDoc files to.
    • If not specified, files are written to the current directory.
  • -t, --template-dir=<template-dir>
    • Optional directory to write customizable man page template files. If specified, an additional "template" file is created here for each generated manpage AsciiDoc file. Each template file contains include directives that import content from the corresponding generated manpage AsciiDoc file in the --outdir directory. Text can be added after each include to customize the resulting man page. The resulting man page will be a mixture of generated and manually edited text. These customizable templates are intended to be generated once, and afterward be manually updated and maintained.
  • -v, --verbose
    • Specify multiple -v options to increase verbosity (e.g., -v -v -v or -vvv).
  • -f, --[no-]force
    • Overwrite existing man page templates.
    • The default is --no-force, meaning processing is aborted and the process exits with status code 4 if a man page template file already exists.
  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.

Arguments​

  • @<filename>...
    • One or more argument files containing options.

Converting to Man Page Format​

Use the asciidoctor tool to convert the generated AsciiDoc files to man pages in roff format:

asciidoctor --backend=manpage --source-dir=SOURCE_DIR --destination-dir=DESTINATION *.adoc

Point the SOURCE_DIR to either the --outdir directory or the --template-dir directory. Use some other directory as the DESTINATION.

See https://asciidoctor.org/docs/user-manual/#man-pages See http://man7.org/linux/man-pages/man7/roff.7.html

repo-manager cleanup​

Cleans up generated and imported files and directories from repository.

repo-manager cleanup [OPTIONS]

Options​

  • -h, --help
    • Show this help message and exit.
  • -V, --version
    • Print version information and exit.