Skip to content

fix(error-tracking): explain the source maps key prompt and link the key page - #442

Merged
ablaszkiewicz merged 1 commit into
mainfrom
fix/error-tracking-source-maps-key-prompt
Oct 27, 2026
Merged

ablaszkiewicz merged 1 commit into
mainfrom
fix/error-tracking-source-maps-key-prompt

Conversation

@ablaszkiewicz

Copy link
Copy Markdown
Contributor

Problem

wizard error-tracking asks for a personal API key with a bare "Paste your PostHog personal API key below" screen. It doesn't say the key is for source map upload or what source maps do, so at a glance it reads like an error. Its link is a <SETTINGS_URL> placeholder the wizard never fills, so the agent guesses one (/settings/user-api-keys) and the user then has to find the right preset themselves.

Changes

  • context/agents/error-tracking/credentials.md: the wizard_ask prompt now reads:

    Uploading source maps needs a PostHog personal API key. Source maps let PostHog show your original code in error stack traces, not minified code.
    
    Create a key with the right permissions here:
    <UI_HOST>/source-maps-key
    
    Then paste it below.
    

    /source-maps-key redirects to settings/user-api-keys?preset=source_map_upload, so the key form opens with the 'Source map upload' preset selected. The <SETTINGS_URL> placeholder is gone; <UI_HOST> is filled from project context like the task's other placeholders.

  • context/agents/error-tracking/report.md: the "What you still need to do" step links <UI_HOST>/source-maps-key.

wizard upload-source-maps gets the same prompt in the wizard PR, which also tells the user that a secret answer is hidden as they type and never reaches the AI agent.

Test plan

  • npm test (220 passing)
  • The prompt renders without overflow at the wizard's minimum 80x28 size (frame snapshot in the wizard PR)

🤖 Generated with Claude Code

https://claude.ai/code/session_01NtZv9mtG8rfgdcXoNSceHN

…key page

The credentials task asks for the personal API key with a prompt that says
why source map upload needs it, and links <UI_HOST>/source-maps-key, which
opens the key form with the 'Source map upload' preset selected. The report's
follow-up step links the same page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NtZv9mtG8rfgdcXoNSceHN
@ablaszkiewicz
ablaszkiewicz requested a review from a team as a code owner October 27, 2026 12:22
@github-actions

Copy link
Copy Markdown

🧙 Wizard CI

Run the Wizard CI and test your changes against wizard-workbench example apps by replying with a GitHub comment using one of the following commands:

Test all apps:

  • /wizard-ci all

Test all apps in a directory:

  • /wizard-ci ai-observability
  • /wizard-ci basic-integration
  • /wizard-ci feature-flags
  • /wizard-ci mcp-analytics
  • /wizard-ci replay-vision
  • /wizard-ci revenue
  • /wizard-ci self-driving
  • /wizard-ci warehouse
  • /wizard-ci warehouse-seeded

Test an individual app:

  • /wizard-ci ai-observability/anthropic
  • /wizard-ci ai-observability/google-adk
  • /wizard-ci ai-observability/groq
Show more apps
  • /wizard-ci ai-observability/manual-capture
  • /wizard-ci ai-observability/openai
  • /wizard-ci ai-observability/openai-agents
  • /wizard-ci ai-observability/opentelemetry
  • /wizard-ci ai-observability/vercel-ai
  • /wizard-ci basic-integration/android
  • /wizard-ci basic-integration/angular
  • /wizard-ci basic-integration/astro
  • /wizard-ci basic-integration/django
  • /wizard-ci basic-integration/fastapi
  • /wizard-ci basic-integration/flask
  • /wizard-ci basic-integration/flutter
  • /wizard-ci basic-integration/javascript-node
  • /wizard-ci basic-integration/javascript-web
  • /wizard-ci basic-integration/laravel
  • /wizard-ci basic-integration/next-js
  • /wizard-ci basic-integration/nuxt
  • /wizard-ci basic-integration/python
  • /wizard-ci basic-integration/rails
  • /wizard-ci basic-integration/react-native
  • /wizard-ci basic-integration/react-router
  • /wizard-ci basic-integration/sveltekit
  • /wizard-ci basic-integration/swift
  • /wizard-ci basic-integration/tanstack-router
  • /wizard-ci basic-integration/tanstack-start
  • /wizard-ci basic-integration/vue
  • /wizard-ci feature-flags/django
  • /wizard-ci feature-flags/next-js
  • /wizard-ci mcp-analytics/custom-dispatcher
  • /wizard-ci mcp-analytics/typescript-sdk
  • /wizard-ci replay-vision/javascript-node
  • /wizard-ci replay-vision/next-js
  • /wizard-ci replay-vision/react-vite
  • /wizard-ci revenue/stripe
  • /wizard-ci self-driving/astro
  • /wizard-ci self-driving/fastapi
  • /wizard-ci self-driving/nuxt
  • /wizard-ci self-driving/react-router
  • /wizard-ci self-driving/sveltekit
  • /wizard-ci warehouse/monorepo-env
  • /wizard-ci warehouse/multi-source-next
  • /wizard-ci warehouse/stripe-node
  • /wizard-ci warehouse/zero-source
  • /wizard-ci warehouse-seeded/next-stripe
  • /wizard-ci warehouse-seeded/next-stripe-declined

Test against a wizard branch:

  • /wizard-ci all wizard:my-branch

Add wizard:<branch> to any command above to pin the wizard branch. It defaults to main.

Results will be posted here when complete.

@ablaszkiewicz
ablaszkiewicz merged commit c88b09c into main Oct 27, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants