/wizard

Você (Claude) é quem vai conduzir o wizard usando AskUserQuestion — não precisa do prefixo ! nem de terminal real. Fluxo:

1. Primeiro, leia o estado atual pra mostrar defaults:

node "${CLAUDE_PLUGIN_ROOT}/scripts/qwen-review.mjs" status

Anote apiKey (mascarada se já existe), baseUrl, model, mode.

2. Faça as 4 perguntas via AskUserQuestion (em uma única chamada batched — máximo 4 questions). Cada uma com defaults derivados do status:

• Base URL — header: "Base URL", 4 options:

  1. DashScope International (description: https://dashscope-intl.aliyuncs.com/compatible-mode/v1)
  2. DashScope China (description: https://dashscope.aliyuncs.com/compatible-mode/v1)
  3. OpenRouter (description: https://openrouter.ai/api/v1)
  4. Custom (description: cola URL OpenAI-compat de qualquer provider) Marque o atual como (atual) no label se bater com um preset.

• Model — header: "Modelo", 3 options:

  • qwen3-max (DashScope)
  • qwen/qwen3-max (OpenRouter)
  • Custom (outro nome) Marque o atual.

• Mode — header: "Modo de review", 2 options:

  • fast (1024 tok, 3-15s, sem thinking) — pro dia-a-dia (Recommended se atual é fast)
  • thinking (8192 tok, 60-180s, enable_thinking=true) — review profundo (Recommended se atual é thinking)

• API key — header: "API key", 2 options:

  • Se envOk: true (já tem chave): primeira opção Manter a chave atual (Recommended), segunda opção Substituir por uma nova
  • Se envOk: false: primeira opção Configurar agora (Recommended), segunda opção Salvar config e configurar a chave depois

⚠️ CRÍTICO: NUNCA passe a string mascarada (ex: sk-•••efd) do /status output como --api-key=.... O status sempre mascara — não é o valor real. Se "Manter", use --keep-key. Se "Substituir" OU "Configurar agora", siga o passo 3 pra coletar a chave real.

3. Casos que exigem segunda interação:

• "Custom" base URL OU "Custom" model: faça SEGUNDA AskUserQuestion com option Other pra capturar texto livre.

• "Substituir por uma nova" (envOk=true) OU "Configurar agora" (envOk=false): peça a chave no chat normal (não use AskUserQuestion pra secrets em formato livre):

  "Cole sua API key Qwen aqui (geralmente começa com sk- e tem 30+ chars). Não usarei a chave em nenhum lugar exceto pra escrever em ~/.claude/settings.json com mode 0o600."

  Quando ele colar, valide antes de usar:

  • ≥ 20 chars
  • Não contém • nem substring REDACTED
  • Se vier curta/inválida, peça pra colar de novo.

• "Salvar config e configurar a chave depois" (envOk=false): segue pro summary normalmente, mas usa --skip-key no apply-config (passo 5c). Base URL / model / mode ficam salvos; chave fica em branco até ele rodar wizard de novo ou editar settings.json.

4. Mostre summary curto pro usuário:

Vou escrever em ~/.claude/settings.json:
  QWEN_API_KEY      = sk-•••XXX
  QWEN_BASE_URL     = https://...
  QWEN_MODEL        = qwen3-max
  QWEN_REVIEW_MODE  = fast

Pergunte via AskUserQuestion "Confirmar?" com options Sim, salvar / Não, cancelar.

5. Se confirmado, invoque o apply-config. Escolha exatamente UMA das 3 formas (mutuamente exclusivas):

5a. Manteve a chave atual (envOk=true + escolheu "Manter"):

node "${CLAUDE_PLUGIN_ROOT}/scripts/qwen-review.mjs" apply-config \
  --keep-key \
  --base-url="<url-escolhida>" \
  --model="<modelo-escolhido>" \
  --mode="<fast|thinking>"

5b. Setou chave nova (envOk=true + "Substituir" OU envOk=false + "Configurar agora", colou no passo 3):

node "${CLAUDE_PLUGIN_ROOT}/scripts/qwen-review.mjs" apply-config \
  --api-key="<CHAVE-REAL-COLADA-PELO-USUARIO>" \
  --base-url="<url-escolhida>" \
  --model="<modelo-escolhido>" \
  --mode="<fast|thinking>"

5c. Configurou tudo menos a chave (envOk=false + "Salvar e configurar depois"):

node "${CLAUDE_PLUGIN_ROOT}/scripts/qwen-review.mjs" apply-config \
  --skip-key \
  --base-url="<url-escolhida>" \
  --model="<modelo-escolhido>" \
  --mode="<fast|thinking>"

⚠️ --api-key, --keep-key, --skip-key são mutuamente exclusivos — passe exatamente UMA. ⚠️ NUNCA passe valor mascarado em --api-key (com •, *, ou substring REDACTED). O comando rejeita com exit 2 e mensagem clara.

O comando devolve JSON com ok: true + written + env (apiKey mascarada na saída pra log seguro). Reporte ao usuário:

• ✓ Salvo com sucesso
• Lembre dos próximos passos do JSON nextSteps:
  • /reload-plugins
  • /qwen-review:setup --enable
  • /qwen-review:status

Tratamento de erro: se apply-config exit 2 com stderr missing required ..., mostre a mensagem e pergunte se quer tentar de novo.

---

Alternativa terminal (se o usuário preferir o wizard interativo de readline tradicional):

! node "${CLAUDE_PLUGIN_ROOT}/scripts/qwen-review.mjs" wizard

Mas via AskUserQuestion (fluxo principal acima) é mais ergonômico — funciona dentro do Claude Code direto, sem precisar de !.