# Kam Project Environment Variables
# Copy this file to .env to use it.
# Variables defined here will be loaded during `kam build` and accessible in hooks.
#
# Note: Most KAM_* variables are automatically set by Kam during build.
# You only need to set variables here if you want to override defaults or provide
# additional configuration for hooks and build processes.

# ============================================================================
# Build Control Variables
# ============================================================================
# These variables control build behavior. Most are automatically set by command flags,
# but you can override them here if needed.

# Enable debug output in hooks (0 or 1)
# Set to 1 to enable verbose logging and debugging information
# KAM_DEBUG=1

# Enable version bump during build (0 or 1)
# Usually set automatically by `kam build --bump`
# KAM_BUMP_ENABLED=1

# Enable release creation during build (0 or 1)
# Usually set automatically by `kam build --release`
# KAM_RELEASE_ENABLED=1

# Enable signing during build (0 or 1)
# Usually set automatically by `kam build --sign`
# KAM_SIGN_ENABLED=1

# Enable pre-release mode (0 or 1)
# Usually set automatically by `kam build --pre-release`
# KAM_PRE_RELEASE=1

# Enable immutable release mode (0 or 1)
# Usually set automatically by `kam build --immutable-release`
# If set to 1, existing releases will not be modified
# KAM_IMMUTABLE_RELEASE=1

# Enable interactive mode (0 or 1)
# Usually set automatically by `kam build --interactive`
# KAM_INTERACTIVE=1

# Force non-interactive mode (0 or 1)
# Set to 1 to disable all interactive prompts (useful for CI/CD)
# KAM_NONINTERACTIVE=1

# ============================================================================
# Signing Configuration
# ============================================================================

# Private key for signing (PEM format)
# Alternative to using `kam secret` - you can provide the key directly
# Note: This is sensitive information - never commit this to version control!
# KAM_SIGN_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"

# Passphrase for encrypted private key
# Required if your private key is encrypted with a passphrase
# Note: This is sensitive information - never commit this to version control!
# KAM_SIGN_PASSPHRASE="your_passphrase_here"

# Enable/disable Sigstore signing (0 or 1)
# Set to 0 to disable Sigstore attestation generation
# Default: 1 (enabled)
# KAM_SIGN_SIGSTORE=1

# ============================================================================
# Template Configuration
# ============================================================================

# Template cache directory
# Override the default template cache location (~/.kam/templates)
# KAM_TEMPLATE_CACHE_DIR="/path/to/template/cache"

# ============================================================================
# Author Information
# ============================================================================

# Author email address
# Used by `kam about` command to display contact information
# KAM_AUTHOR_EMAIL="author@example.com"

# ============================================================================
# CI/CD Environment Variables
# ============================================================================
# These are typically set automatically by CI/CD systems, but you can set them
# manually for local testing

# GitHub repository (format: owner/repo)
# Automatically detected from kam.toml or git remote
# GITHUB_REPOSITORY="owner/repo"

# GitHub branch or tag reference
# Automatically detected from git or CI environment
# GITHUB_REF="refs/heads/main"

# Generic CI environment flag
# Set by most CI systems automatically
# CI=true

# GitHub Actions environment flag
# Set automatically when running in GitHub Actions
# GITHUB_ACTIONS=true

# ============================================================================
# Automatically Set Variables (Read-only)
# ============================================================================
# The following variables are automatically set by Kam during build.
# You do NOT need to set these in .env - they are provided for reference only.
#
# KAM_PROJECT_ROOT          - Absolute path to project root
# KAM_HOOKS_ROOT            - Absolute path to hooks directory
# KAM_MODULE_ROOT           - Absolute path to module source directory
# KAM_WEB_ROOT              - Absolute path to webroot directory
# KAM_DIST_DIR              - Absolute path to build output directory
# KAM_MODULE_ID             - Module ID from kam.toml
# KAM_MODULE_VERSION        - Module version
# KAM_MODULE_VERSION_CODE   - Module version code
# KAM_MODULE_NAME           - Module name
# KAM_MODULE_AUTHOR         - Module author
# KAM_MODULE_DESCRIPTION    - Module description
# KAM_MODULE_UPDATE_JSON    - Update JSON URL
# KAM_STAGE                 - Current build stage (pre-build or post-build)
# KAM_GIT_REPO              - Git repository URL from kam.toml
# KAM_GITHUB_REPO           - GitHub repository (detected)
# KAM_REPO                  - Repository URL (same as KAM_GITHUB_REPO)
# KAM_REPO_REF              - Repository branch/tag reference
# KAM_RELEASE_TAG           - Release tag (usually version)
# KAM_PROP_*                - All prop.* fields from kam.toml (e.g., KAM_PROP_ID)
# KAM_TMPL_<NAME>           - Template variables (e.g., KAM_TMPL_FEATURE_X)
# KAM_<PATH>                - All flattened kam.toml keys (e.g., KAM_MMRL_REPO_REPOSITORY)
#
# For more information, see: https://github.com/MemDeco-WG/Kam
