ssc.env.example

# Server Scripts CLI Configuration
#
# ssc sources ~/.config/ssc/ssc.env at startup, before it reads any of the
# variables below. A variable already set in your environment wins over the
# file. Because sourcing executes the file, ssc skips it when it is not owned
# by you or when group or others can write it.
#
# Usage:
#   mkdir -p ~/.config/ssc
#   cp config/ssc.env.example ~/.config/ssc/ssc.env
#   chmod 600 ~/.config/ssc/ssc.env

# ============================================================================
# Manifest Configuration
# ============================================================================

# Manifest file location (default: manifest.yaml in the repository root)
# SSC_MANIFEST_FILE="/path/to/custom/manifest.yaml"

# Repository root (default: git rev-parse --show-toplevel, else the directory
# of ssc.sh). Script paths in the manifest are resolved against it.
# SSC_REPO_ROOT="/path/to/repository"

# ============================================================================
# Output Configuration
# ============================================================================

# Log level: debug, info, warning, error (default: info)
# Filters the status messages of ssc itself. The tables printed by list, info
# and status are data and always go out. 'debug' adds resolved paths and the
# exact command behind 'ssc run', on stderr.
SSC_LOG_LEVEL="info"

# Colored output: auto, always, never (default: auto)
# auto colors when stdout is a terminal.
SSC_COLOR="auto"

# ============================================================================
# systemd Integration (Optional)
# ============================================================================

# Enable systemd queries: true, false (default: true)
# false makes 'ssc status' and 'ssc logs' report the switch and return without
# calling systemctl or journalctl. Useful on hosts without systemd.
SSC_SYSTEMD_ENABLED="true"

# ============================================================================
# Execution
# ============================================================================

# Script execution timeout in seconds for 'ssc run' (default: 0 = no timeout)
# Requires the 'timeout' binary from coreutils; ssc warns and runs without it
# when it is missing. A killed script exits 124.
# SSC_EXEC_TIMEOUT=300

# Strict validation: true, false (default: false)
# true makes 'ssc validate' check status, type, deployment, service and
# requires_root of every entry against docs/MANIFEST_SCHEMA.md, and count each
# mismatch towards the exit code.
# SSC_STRICT_VALIDATION="false"