settings

Step 1 — Read current state (resilient to broken existing config)

Run via Bash (paths quoted for spaces):

node "${CLAUDE_PLUGIN_ROOT}/skills/tango/scripts/load-config.mjs" --merge --cli '{}'

Three outcomes, each handled explicitly:

1. Exit 0 + {merged, sources} — happy path. Parse stdout. sources[k] === "user_config" means existing config.json set this key; "default" means built-in fallback. Use merged as "current state" for question descriptions.

2. Exit 2 with a recoverable user-config error — existing ~/.claude/plan-tango/config.json is malformed but the wizard exists precisely to fix it. Recovery conditions (verified against the loader):

   Recovery condition	Loader error code	Source field check
   Always recover	config_invalid_json	n/a
   Always recover	config_invalid_shape	n/a
   Always recover	config_unknown_key	n/a (loader emits this only for user_config)
   Recover only if from user-config	invalid_value	require source === "user_config" in error payload
   Recover only if from user-config	invalid_type	require source === "user_config" in error payload

   The source check on invalid_value/invalid_type is required because those same codes are also emitted for bad CLI input (which would be a wizard bug, not a recoverable user-config problem).

   Recovery flow:

   • Print warning: "⚠ Existing ~/.claude/plan-tango/config.json is invalid: <error.detail> (field=<error.field>). Wizard will use built-in defaults as current state and write a fresh replacement (the broken file is preserved on disk until Step 6 atomic rename overwrites it)."
   • Set merged to built-in defaults: {model:null, effort:"high", max_iter:6, thread_mode:"continue", final_check:"never", lenient:false, service_tier:null, codex_profile:null, extra_codex_config:[], quiet:false, severity_aware:true, verbose_report:false, update_check:true}. Set all sources[k] = "default".
   • extra_codex_config recovery: attempt to read & parse the broken config.json as raw JSON via Read tool + JSON.parse. If it parses to an array of "key=value" strings → preserve. If parse fails OR field is absent OR items don't match key=value shape → use [] and warn separately: "⚠ Could not preserve extra_codex_config from broken config — falling back to []. If you had custom -c keys, re-add them after the wizard finishes."
   • Continue to Step 2. Step 6's atomic rename overwrites the broken file with the validated candidate.

3. Exit 2 with any other error — abort wizard with the loader's {error, detail}. This bucket includes config_read_failed, cli_* codes (wizard bug), missing_mode/missing_cli (wizard bug), anything else not enumerated above. Don't attempt recovery.

File-existence flag (independent of loader behavior):

test -f ~/.claude/plan-tango/config.json && echo "exists" || echo "fresh"

Save flag config_exists for Step 4 (diff-or-create branch).