This release makes AI configuration explicit (a breaking change if you use AI), promotes Analytics out of Labs, and fixes Shortcut status sync.
Breaking change: AI now requires explicit configuration
AI features are off until fully configured. Previously, Quackback assumed OpenAI's endpoint while hardcoding gateway-style model names, so a self-hoster with just an API key got an error on every AI call (#180).
To enable AI, set all four variables:
OPENAI_API_KEY=sk-...
# Any OpenAI-compatible endpoint, declared explicitly. Examples:
# Direct OpenAI: https://api.openai.com/v1
# OpenRouter: https://openrouter.ai/api/v1
# Cloudflare AI Gateway: https://gateway.ai.cloudflare.com/v1/<account>/<gateway>/openai
OPENAI_BASE_URL=https://api.openai.com/v1
# Model ids your endpoint accepts (direct OpenAI examples shown)
AI_CHAT_MODEL=gpt-4o-mini # summaries, sentiment, triage, duplicate checks
AI_EMBEDDING_MODEL=text-embedding-3-small # duplicate detection, semantic searchUpgrading from v0.11.0 or earlier: if you had OPENAI_API_KEY set, add OPENAI_BASE_URL and the two model variables to keep AI working. Until you do, AI features stay off and a warning is logged at startup.
Each feature can also use its own model via AI_SUMMARY_MODEL, AI_SENTIMENT_MODEL, AI_EXTRACTION_MODEL, AI_QUALITY_GATE_MODEL, AI_INTERPRETATION_MODEL, and AI_MERGE_MODEL. Set one to off to disable just that feature. See .env.example for the full reference.
Features
- Analytics is now generally available. The dashboard is out of Labs and on for every workspace, with period-over-period trends on each metric, a clearer activity chart, and full mobile and tablet support. (#198)
- Integration credentials from the environment. OAuth app credentials for integrations can be supplied via
INTEGRATION_<PROVIDER>_*environment variables by settingPLATFORM_CREDENTIALS_SOURCE=env. The default (database, managed in the admin UI) is unchanged. (#209)
Bug fixes
- Shortcut status sync now works. Moving a linked story to a new workflow state updates the feedback post's status; previously the webhook arrived but the status never changed. (#204)
- Webhook signing secret shown in settings. Shortcut and Azure DevOps now display the signing secret needed to finish manual webhook setup, next to the webhook URL. (#204)
- Complete translations. Portal sign-in screens are now translated, and every locale was backfilled to full parity with English. (#202, #203)
Full Changelog: v0.11.0...v0.12.0