Skip to content

rai cartridge

Manage knowledge cartridges — packaged, versioned bundles of domain knowledge that RaiSE loads into the knowledge graph. Cartridges can be built locally, published to a registry, and installed into a project.

Validation

rai cartridge check

Run validation gates against a cartridge directory. Reports errors and warnings.

rai cartridge check
rai cartridge check ./my-cartridge

rai cartridge validate

Validate cartridge metadata and schema without running full gate checks.

rai cartridge validate ./my-cartridge

Local Lifecycle

rai cartridge init

Scaffold a new cartridge directory with the required structure and metadata files.

rai cartridge init my-domain-cartridge

rai cartridge list

List cartridges installed in the current project.

rai cartridge list

rai cartridge pack

Package a cartridge directory into a distributable archive (.cartridge file).

rai cartridge pack ./my-cartridge
rai cartridge pack ./my-cartridge --output dist/

rai cartridge clean

Remove build artifacts and temporary files from a cartridge directory.

rai cartridge clean
rai cartridge clean ./my-cartridge

Registry Operations

rai cartridge publish

Publish a packed cartridge to the configured cartridge registry.

rai cartridge publish my-domain-cartridge-1.0.0.cartridge

rai cartridge install

Install a cartridge from the registry or a local path into the current project.

# Install from registry
rai cartridge install org/domain-cartridge

# Install specific version
rai cartridge install org/[email protected]

# Install from local archive
rai cartridge install ./dist/my-cartridge-1.0.0.cartridge

rai cartridge uninstall

Remove an installed cartridge from the current project.

rai cartridge uninstall org/domain-cartridge

rai cartridge extract

Extract a packed cartridge archive to a directory for inspection or editing.

rai cartridge extract my-cartridge-1.0.0.cartridge
rai cartridge extract my-cartridge-1.0.0.cartridge --output ./extracted/

rai cartridge extract-server

Extract cartridge data from a connected RaiSE server into a local directory.

rai cartridge extract-server org/domain-cartridge

rai cartridge update

Update installed cartridges to their latest published versions.

# Update all cartridges
rai cartridge update

# Update a specific cartridge
rai cartridge update org/domain-cartridge

Knowledge Operations

rai cartridge query

Query knowledge nodes within an installed cartridge.

rai cartridge query "authentication flow"
rai cartridge query "deployment" --cartridge org/infra-cartridge

rai cartridge catalog

List all available cartridges in the configured registry.

rai cartridge catalog
rai cartridge catalog --format json

rai cartridge curate

Interactively review and curate knowledge nodes in a cartridge — approve, reject, or edit entries.

rai cartridge curate ./my-cartridge

rai cartridge sync

Sync installed cartridge data with the connected RaiSE server's knowledge graph.

rai cartridge sync
rai cartridge sync --cartridge org/domain-cartridge

Enable / Disable

rai cartridge enable

Enable a previously disabled cartridge in the current project.

rai cartridge enable org/domain-cartridge

rai cartridge disable

Disable a cartridge without uninstalling it. Disabled cartridges are excluded from graph queries.

rai cartridge disable org/domain-cartridge

Audit

rai cartridge audit

Audit installed cartridges for freshness, coverage gaps, and schema compliance.

rai cartridge audit
rai cartridge audit --format json

See also: rai graph, rai pattern