registry-cli

registry-cli

A CLI tool for building TS11-compliant Catalogue of Attestations sites from credential schemas discovered across GitHub repositories.

Overview

registry-cli discovers credential type metadata (VCTMs) from configured source repositories, validates them against the TS11 schema-meta model, and produces a static site with:

• Per-credential detail pages with TS11 metadata
• Rendered rulebooks (from co-located rulebook.md)
• A JSON API (/api/v1/schemas.json) with per-schema endpoints
• An OpenAPI specification
• Optional JWS signing of all API responses

Installation

go install github.com/sirosfoundation/registry-cli/cmd/registry-cli@latest

Usage

Build a site

registry-cli build \
  --sources sources.yaml \
  --output dist \
  --base-url https://registry.siros.org \
  --templates templates-go \
  --static static

Sign API responses (requires PKCS#11 or dev key)

registry-cli sign \
  --input dist/api/v1 \
  --key-mode dev

Sources manifest

The sources.yaml file declares where to find credential repositories:

defaults:
  branch: vctm

sources:
  # Auto-discover by GitHub topic
  - "github:topic/vctm?org=sirosfoundation"

  # Explicit repository
  - "git:https://github.com/org/repo.git"

Schema-meta

Each credential can have a co-located .schema-meta.yaml file providing TS11 metadata:

attestation_los: substantial
binding_type: cnf
version: "1.0"

These are discovered automatically from the vctm branch of each repository.

Packages

License

See LICENSE.