Skip to content

v0.12.0

Latest

Choose a tag to compare

@mortondev mortondev released this 09 Jun 20:51
· 148 commits to main since this release
02de131

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 search

Upgrading 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 setting PLATFORM_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