#!/bin/bash

# Artifact (distribution primitive) Commands Header
# Shows available `libreportal artifact` subcommands.

cliShowArtifactHelp()
{
    echo ""
    echo "Available Artifact Commands:"
    echo ""
    echo "  libreportal artifact index         - Fetch + verify the signed index; list what's available"
    echo "  libreportal artifact applied       - List the artifacts currently applied to this install"
    echo "  libreportal artifact apply <id>    - Apply an artifact (reversible; hotfix ops or app bundle)"
    echo "  libreportal artifact revert <id>   - Revert a previously-applied artifact (replays its undo log)"
    echo ""
    echo "An 'artifact' is anything LibrePortal pulls from the outside and applies"
    echo "reversibly — a hotfix (bounded declarative ops, no scripts) or an app"
    echo "definition bundle from the registry catalog (themes / components later)."
    echo "They share one team-signed catalog (index.json) on the same channel as the"
    echo "version check, verified against the root-owned signing key. apply/revert run"
    echo "through the task system (never a mutating API), record a precise undo, and"
    echo "auto-roll-back on failure. See docs/roadmap/updates-and-distribution.md."
    echo ""
}