hoziron-cli collection

Manage collections — curated bundles of catalog packages, published and installed as a unit. This is a separate top-level command from hoziron-cli catalog, not a catalog subcommand.

Synopsis

hoziron-cli collection <subcommand> [options]

Subcommands

hoziron-cli collection init

Scaffold a COLLECTION.toml template in the current directory.

hoziron-cli collection init <name> [--json]

Example

$ hoziron-cli collection init claims-starter-pack
✓ Created COLLECTION.toml for 'claims-starter-pack'
  Edit the file to add packages, then publish with: hoziron-cli collection publish .

Generated COLLECTION.toml

# Collection manifest — see `hoziron-cli collection --help` for details.

name = "claims-starter-pack"
display_name = "Claims Starter Pack"
description = "A curated collection of packages"
version = "0.1.0"
license = "Apache-2.0"

[author]
name = "Your Name"
# email = "you@example.com"

# [[packages]]
# name = "example-tool"
# version = "1.0.0"
# is_dependency = false

tags = []
featured = false

Add one [[packages]] block per package the collection bundles. Mark supporting packages that aren't the headline offering with is_dependency = true — hoziron-cli collection validate flags a collection where every package is marked as a dependency (no clear headline package).

hoziron-cli collection list

hoziron-cli collection list [--json]

Example

$ hoziron-cli collection list
NAME                      DISPLAY NAME                   PKGS   DESCRIPTION
--------------------------------------------------------------------------------
claims-starter-pack       Claims Starter Pack            4      FNOL intake, OCR, and...
underwriting-suite        Underwriting Suite             6      Risk assessment and po...

$ hoziron-cli collection list --json
{
  "collections": [
    {
      "name": "claims-starter-pack",
      "display_name": "Claims Starter Pack",
      "description": "FNOL intake, OCR, and routing for property/auto claims",
      "package_count": 4
    }
  ]
}

hoziron-cli collection install

Install every package in a collection in one step.

hoziron-cli collection install <name> [--json]

Example

$ hoziron-cli collection install claims-starter-pack
Installing collection 'claims-starter-pack'...
✓ Installed collection 'claims-starter-pack' (4 packages)

hoziron-cli collection inspect

hoziron-cli collection inspect <name> [--json]

Example

$ hoziron-cli collection inspect claims-starter-pack
Collection: Claims Starter Pack
  Name:        claims-starter-pack
  Description: FNOL intake, OCR, and routing for property/auto claims
  Tags:        insurance, claims

Packages:
  claims-intake @1.2.0
  document-ocr @1.4.0 (dep)
  postgresql-connector @2.1.0 (dep)
  email-skill @1.3.0 (dep)

hoziron-cli collection publish

Publish a collection (its COLLECTION.toml in <path>) to the registry.

hoziron-cli collection publish <path> [--json]

Example

$ hoziron-cli collection publish .
✓ Published collection 'claims-starter-pack' v0.1.0

hoziron-cli collection validate

Validate the closure invariant locally — structural checks only (duplicate package entries, at least one non-dependency/headline package). Full dependency-closure validation against actual registry contents happens at publish time.

hoziron-cli collection validate <path> [--json]

Examples

$ hoziron-cli collection validate .
✓ Collection 'claims-starter-pack' is valid (4 packages)
  Note: Full closure validation requires registry access (use `hoziron-cli collection publish`).

# With violations
$ hoziron-cli collection validate .
✗ Duplicate package entries detected
Error: Collection validation failed

$ hoziron-cli collection validate . --json
{
  "valid": false,
  "collection": "claims-starter-pack",
  "package_count": 4,
  "violations": ["Duplicate package entries detected"]
}

See Also

• catalog.md — Individual package discovery and installation
• package.md — Authoring the packages a collection bundles