.env.example

# Copy this file to .env and fill in your values.
# Never commit .env — it is gitignored.

# ── Google / BigQuery ──────────────────────────────────────────────────
# OAuth2 token JSON (from generate_readonly_token.py or gcloud ADC).
# Required by: read_google_docs, write_google_docs, summarize_google_docs,
#              analyze_customer_feedback (Gmail), fetch_nps_data, fetch_churn_data
GOOGLE_OAUTH_TOKEN=

# ── Metabase ───────────────────────────────────────────────────────────
# API key for your Metabase instance.
# Required by: analyze_customer_feedback (NPS & churn), answer_pricing
METABASE_API_KEY=

# ── Pricing projection (answer_pricing) ────────────────────────────────
# Rate constants for the cost projector. No values ship in the repo — set
# the variables relevant to your pricing model. CLI flags override all of these.
#
# Seat-based
SEAT_PRICE=                    # price per seat per month
SEATS=                         # current (POC) seat count
TARGET_SEATS=                  # target seat count for scaling
#
# Usage-based / metered
USAGE_UNIT_NAME=               # human-readable unit ("API calls", "compute-hours", "GB")
USAGE_UNIT_PRICE=              # price per unit
PRICE_PER_1K_UNITS=            # price per 1,000 units (alternative to per-unit)
#
# Hybrid (seat + overage)
INCLUDED_UNITS_PER_SEAT=       # units bundled per seat before overage kicks in
OVERAGE_UNIT_PRICE=            # price per unit above the included allowance
#
# Sensitivity grid — optional comma-separated values to compare scenarios
PRICE_GRID=
USAGE_GRID=

# ── Grain ──────────────────────────────────────────────────────────────
# Personal Access Token or Workspace Access Token for the Grain REST API.
# Required by: votc_insights
GRAIN_TOKEN=

# ── Notion ─────────────────────────────────────────────────────────────
# Internal integration token for your Notion workspace.
# Required by: weekly_wynk, write_notion
NOTION_API_KEY=

# ── Slack ──────────────────────────────────────────────────────────────
# Incoming webhook URL for the Slack channel you want to post to.
# Required by: post_to_slack, weekly_wynk
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/WEBHOOK/URL

# ── Warp / Oz ──────────────────────────────────────────────────────────────
# API key used by the fix_p0_issues skill to spawn cloud coding agents.
# Required by: fix_p0_issues
WARP_API_KEY=

# ── Email ──────────────────────────────────────────────────────────────────
# The email address used to filter feedback emails in Gmail.
# Required by: analyze_customer_feedback (fetch_gmail_feedback.py)
# Replace with your own feedback inbox address.
FEEDBACK_EMAIL=feedback@your-company.com