Skip to content

fix: cognitive-load UX polish — credential notices, country dropdown, dimension hints#22

Merged
nodrel-dev merged 1 commit into
mainfrom
fix/cognitive-load-ux-polish
Jun 20, 2026
Merged

fix: cognitive-load UX polish — credential notices, country dropdown, dimension hints#22
nodrel-dev merged 1 commit into
mainfrom
fix/cognitive-load-ux-polish

Conversation

@nodrel-dev

Copy link
Copy Markdown
Owner

Summary

  • Add per-resource notices explaining which credential type each resource needs — makes the red credential indicator self-explanatory instead of a silent dead end (Track ↔ Shipping separate-keys trap, ADR-0004)
  • Replace Country Code free-text with a ~250-country dropdown (default US) — removes ISO-3166 recall work
  • Repeat the all-or-nothing dimensions hint on Width and Height fields (was only on Length)
  • Add description to Label Stock Type; add cost notice to Create surfacing real-money / sandbox-free fact up front

Changes

  • nodes/Fedex/Fedex.node.ts — two notice properties (one per resource) explaining credential type mismatch
  • nodes/Fedex/countries.ts — new file: COUNTRY_OPTIONS array (~250 ISO 3166-1 alpha-2 entries)
  • nodes/Fedex/fields.ts — Country field → type: 'options', Width/Height get dimension hint, Label Stock Type gets description
  • nodes/Fedex/resources/shipping/create.ts — cost notice added at top of Create fields
  • docs/audits/cognitive-load-* — both audit files marked Status: Fixed

Test plan

  • Type check passes (pnpm tsc --noEmit)
  • All tests pass (pnpm test)
  • Build passes (pnpm build)
  • Lint passes (pnpm lint)
  • Manual: Create panel shows cost notice; Country fields render as dropdowns defaulting to US; credential mismatch notice visible when resource selected

🤖 Generated with Claude Code

… dimension hints

- Add per-resource notices in the main node explaining which credential type
  each resource needs and why a mismatched credential shows a red indicator
  (Track ↔ Shipping separate-keys trap, ADR-0004)
- Convert Country Code free-text to a dropdown (COUNTRY_OPTIONS, ~250 countries,
  default US) — removes ISO-3166 recall work for the common case
- Repeat the all-or-nothing dimensions hint on Width and Height (was only on Length)
- Add description to Label Stock Type field
- Add cost-notice to Create: surfaces real-money / sandbox-free fact up front
- Mark both cognitive-load audit files Status: Fixed

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@nodrel-dev nodrel-dev merged commit bd2a14a into main Jun 20, 2026
1 of 2 checks passed
@nodrel-dev nodrel-dev deleted the fix/cognitive-load-ux-polish branch June 20, 2026 04:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants