Function keyGuidance

src/setup/key-guidance.ts:37–47

(env: string)

/** One-key guidance block: where to get it + the three ways to set it. PURE. */
export function keyGuidance(env: string): string {
  const k = findServiceKey(env);
  const from = k ? `Get a key at ${k.url}${k.freeTier ? ' (free tier available)' : ''} — it unlocks ${k.unlocks}.` : `This needs the ${env} environment variable.`;
  return [
    from,
    'Then any of:',
    `  • paste the key here in chat — I'll store it safely (~/.qodex/.env, chmod 600) and continue your task`,
    `  • add \`${env}=<key>\` to ~/.qodex/.env yourself`,
    `  • or \`export ${env}=<key>\` in your shell`,
  ].join('\n');
}

/** Which web keys are set / missing, given an env-like map. PURE. */
export function webKeyStatus(env: Record<string, string | undefined>): { set: ServiceKey[]; missing: ServiceKey[] } {