xgic-payload-cms-cli 0.2.0

XGIC CLI Payload CMS module - product commands and helpers (xgic.cli.payload).

XGIC Payload CMS CLI

XGIC Payload CMS CLI (xgic.cli.payload) provides Payload CMS–specific helpers and xgic payload … subcommands for the modular XGIC CLI.

Architecture: ADR-0005.

Publishing to PyPI: python-package-release.md
(publish after xgic-cli and xgic-dev-cli for stack releases). Tags: vX.Y.ZrcN → TestPyPI; vX.Y.Z → PyPI.

Package	Role
xgic/cli	Thin core framework (xgic)
xgic/dev-cli	Dev Container / Compose + generic lifecycle
This repo	Payload CMS product module (xgic.cli.payload)

Status

0.2.0 — B4 product commands. Library helpers + nested xgic payload command group. Transitional in-tree xde may still ship until hard cutover (B5).

Requirements

• Python 3.14+
• xgic-cli ≥ 0.2.0
• xgic-dev-cli ≥ 0.2.0

Install (development)

python -m pip install -e ../cli
python -m pip install -e ../dev-cli
python -m pip install -e ".[dev]"
xgic payload --help

Console commands

All product commands are nested under xgic payload (domain ownership; no clash with generic lifecycle).

Command	Purpose
xgic payload dev	Smart start: compose up if needed, DB check, pnpm dev
xgic payload setup [--quiet]	Ensure Payload CMS project directory
xgic payload env [--json]	Product env status (project name, .env, services)
xgic payload env --regenerate --yes	Fresh credentials in .devcontainer/.env
xgic payload schema	Run template schema generator when present
xgic payload reset	Fast targeted reset (project folder + DB volume)

Note: Generic lifecycle (xgic up / down / check / env) lives in dev-cli.
Use xgic payload env for Payload CMS credentials and product status.

Command map (transitional xde → XGIC CLI)

Today (xde)	Target
xde dev	xgic payload dev
xde setup payloadcms	xgic payload setup
xde schema	xgic payload schema
xde env --regenerate	xgic payload env --regenerate --yes
xde reset	xgic payload reset
xde up / down / …	xgic up / down / … (dev-cli)

Library API

from xgic.cli.payload import (
    ensure_payload_project,
    generate_fresh_env_content,
    make_payload_docker_controller,
    get_payload_project_name,
)

License

Apache License 2.0. See LICENSE and NOTICE.
Copyright form: Copyright 2026 XGIC.