Collections

What you'll accomplish: Use and create curated package collections for quick onboarding.

What is a collection?

A collection is a curated, self-contained set of packages. Installing a collection gives you everything needed for a specific use case — no manual dependency hunting.

Installing a collection

hoziron-cli collection install insurance-starter
# Installs all packages, skipping any already installed

Collections are additive — install multiple, overlapping packages are deduplicated.

COLLECTION.toml format

name = "insurance-starter"
display_name = "Insurance Starter Kit"
description = "Everything needed to start processing claims"
version = "1.0.0"
license = "MIT"
featured = true
tags = ["insurance", "claims", "starter"]
icon = "shield-check"

[author]
name = "Hoziron Team"

[[packages]]
name = "claims-intake"
version = "1.2.0"
package_type = "competency"
is_dependency = false

[[packages]]
name = "document-ocr"
version = "1.4.0"
package_type = "skill"
is_dependency = true

[[packages]]
name = "claims-core-adapter"
version = "2.1.0"
package_type = "integration"
is_dependency = true

Closure invariant

A collection must include ALL transitive dependencies of every package it contains. Installing a collection never requires fetching packages outside the collection.

This is validated during collection creation — if a dependency is missing, you'll get a clear error indicating which package is missing which dependency.

Creating a collection

# 1. Scaffold a COLLECTION.toml in the current directory
hoziron-cli collection init insurance-starter

# 2. Edit COLLECTION.toml — list all packages, mark shared deps with is_dependency = true

# 3. Validate the closure invariant locally, before publishing
hoziron-cli collection validate .

# 4. Inspect what you're about to publish (packages, deps)
hoziron-cli collection inspect insurance-starter

# 5. Publish
hoziron-cli collection publish .

hoziron-cli collection publish requires catalog:manage (Admin/Operator) — a step up from installing a package, since it writes to the registry's collection index.

Package fields

Next steps

• Browsing and installing packages
• Publishing packages
• Private registries

Related:

• Browsing and installing
• Private registries
• Catalog internals