.env.example

# Server
PORT=8080
LOG_LEVEL=info

# Mode flags
DEMO_MODE=false
ENABLE_PR_FLOW=false

# Product repo (code-investigation target + docs source of truth)
# Dev: absolute path to a local clone. The api reads both the code (for
#      investigation) and <PRODUCT_REPO_PATH>/docs/*.md (for RAG).
# Prod: leave PRODUCT_REPO_PATH empty and set PRODUCT_REPO_URL;
#       the entrypoint clones the repo at boot.
PRODUCT_REPO_PATH=
PRODUCT_REPO_URL=
# Base branch the openFixPR worktree forks from when proposing a fix.
# Defaults to "main". Override when the trunk lives on a non-default
# branch (common during early development). PRs target this branch too.
PRODUCT_REPO_BASE_BRANCH=main

# RAG overrides - leave unset to use <PRODUCT_REPO_PATH>/docs + data/rag-index.json
DOCS_DIR=
RAG_CACHE_PATH=

# SQLite session store. Defaults to data/sessions.db (next to data/rag-index.json).
# Sessions persist across api restarts. Set to ":memory:" for ephemeral mode.
DATABASE_PATH=

# Demo fixtures dir. Empty = no canned demo responses; the agent's mock
# fallback returns a generic "running in demo mode" reply. Cloud-Run
# deploys point this at a product-specific fixtures folder so visitors see
# the full pipeline flow without burning live LLM tokens.
FIXTURES_DIR=

# CORS
WIDGET_ALLOWED_ORIGINS=
DASHBOARD_ORIGIN=

# Shortcut - if SHORTCUT_API_TOKEN is unset, the api uses the mock client.
# Get a token at https://app.shortcut.com/settings/account/api-tokens
# SHORTCUT_WORKSPACE_SLUG is the workspace identifier in the user-facing
# URL (e.g. https://app.shortcut.com/<slug>/...). The mock client uses it
# to render realistic ticket URLs in screencasts.
# SHORTCUT_WORKFLOW_STATE_ID is the numeric id of the workflow state new
# bug tickets should land in (often "Ready for Dev"). Find it via:
#   GET https://api.app.shortcut.com/api/v3/workflows
SHORTCUT_API_TOKEN=
SHORTCUT_BASE_URL=https://api.app.shortcut.com/api/v3
SHORTCUT_WORKSPACE_SLUG=
SHORTCUT_WORKFLOW_STATE_ID=

# GitHub - if unset OR ENABLE_PR_FLOW=false, uses mock PR client
GITHUB_TOKEN=
GITHUB_REPO=