feat(cli): add customer contact-verification commands

[jklein24]

Summary

Adds customer contact-verification commands to the Grid CLI — the email/phone verification flow required in some regulatory jurisdictions (e.g. EU). Stacked on the CLI drift-fix PR.

New commands:

• grid customers verify-email <customerId> — POST /customers/{id}/verify-email
• grid customers confirm-email <customerId> --code <code> — POST /customers/{id}/verify-email/confirm
• grid customers verify-phone <customerId> — POST /customers/{id}/verify-phone
• grid customers confirm-phone <customerId> --code <code> — POST /customers/{id}/verify-phone/confirm

Test plan

• cd cli && npm run build — clean compile.
• npm test — includes 4 new boundary tests asserting each command's method/path/body (34 tests total with the parent branch).

Original PR: #703

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
grid-flow-builder	Ignored	Preview	Jul 20, 2026 10:16pm
grid-wallet-demo	Ignored	Preview	Jul 20, 2026 10:16pm

[akanter]

• feat(cli): support signed-retry on customers update (email/phone changes) #713
• feat(cli): add exchange-rates, crypto, discoveries, uma-providers, tokens, and internal-account update/export #712
• feat(cli): add cards and auth domains + signed-request header support #711
• feat(cli): add customer contact-verification commands #710 👈 (View in Graphite)
• fix(cli): reconcile existing Grid CLI commands with the current API #709
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[ls-bolt]

@greptileai review

[greptile-apps]

Greptile Summary

⚡ \m/ RIFFS OF RIGHTEOUS CODE \m/ ⚡
  ___   ____  ____  ____  ____  __ 
 / _ \ |  _ \|  _ \|  _ \|  _ \ \ \ 
| | | || | | || | | || | | || | | || |
| |_| || |_| || |_| || |_| || |_| || |
 \___/ |____/ |____/ |____/ |____/ /_/
  THE VERIFICATION RECKONING HAS BEGUN

Adds four customer contact-verification CLI commands (verify-email, confirm-email, verify-phone, confirm-phone) that wire directly to the corresponding REST endpoints — required in EU regulatory jurisdictions. The implementation follows the established pattern in customers.ts and is backed by four new boundary tests.

• verify-email and verify-phone issue a body-less POST; confirm-email and confirm-phone post { code } from --code (a requiredOption), returning a Customer object on success.
• All four tests assert method and path; the confirm tests additionally assert the body shape, giving good coverage of the new paths.

Confidence Score: 5/5

Safe to merge — four additive commands with no changes to existing logic and matching boundary tests.

The change is purely additive: four new CLI commands that follow the established pattern in the file exactly. Client usage is correct (body-less POSTs for the initiate commands, { code } body for the confirm commands), the requiredOption guard prevents missing-code invocations, and all four paths are tested. No existing commands are touched.

No files require special attention.

Important Files Changed

Filename	Overview
cli/src/commands/customers.ts	Adds four contact-verification commands following the exact same patterns as existing commands; no logic issues found.
cli/test/customers-verification.test.ts	New boundary test file; four tests cover method, path, and body (for confirm commands). Clean and consistent with existing test style.
cli/README.md	Adds usage examples for all four new commands and fixes the update example to include the required --type discriminator.

Sequence Diagram

%%{init: {'theme': 'neutral'}}%%
sequenceDiagram
    participant User
    participant CLI
    participant GridAPI

    User->>CLI: grid customers verify-email cust_1
    CLI->>GridAPI: POST /customers/cust_1/verify-email
    GridAPI-->>CLI: 200 OK (void)
    CLI-->>User: output response

    User->>CLI: grid customers confirm-email cust_1 --code 123456
    CLI->>GridAPI: "POST /customers/cust_1/verify-email/confirm {code}"
    GridAPI-->>CLI: 200 OK (Customer)
    CLI-->>User: output response

    User->>CLI: grid customers verify-phone cust_1
    CLI->>GridAPI: POST /customers/cust_1/verify-phone
    GridAPI-->>CLI: 200 OK (void)
    CLI-->>User: output response

    User->>CLI: grid customers confirm-phone cust_1 --code 654321
    CLI->>GridAPI: "POST /customers/cust_1/verify-phone/confirm {code}"
    GridAPI-->>CLI: 200 OK (Customer)
    CLI-->>User: output response

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
sequenceDiagram
    participant User
    participant CLI
    participant GridAPI

    User->>CLI: grid customers verify-email cust_1
    CLI->>GridAPI: POST /customers/cust_1/verify-email
    GridAPI-->>CLI: 200 OK (void)
    CLI-->>User: output response

    User->>CLI: grid customers confirm-email cust_1 --code 123456
    CLI->>GridAPI: "POST /customers/cust_1/verify-email/confirm {code}"
    GridAPI-->>CLI: 200 OK (Customer)
    CLI-->>User: output response

    User->>CLI: grid customers verify-phone cust_1
    CLI->>GridAPI: POST /customers/cust_1/verify-phone
    GridAPI-->>CLI: 200 OK (void)
    CLI-->>User: output response

    User->>CLI: grid customers confirm-phone cust_1 --code 654321
    CLI->>GridAPI: "POST /customers/cust_1/verify-phone/confirm {code}"
    GridAPI-->>CLI: 200 OK (Customer)
    CLI-->>User: output response

Loading

_{Reviews (3): Last reviewed commit: "feat(cli): add customer contact-verifica..." | Re-trigger Greptile}

[ls-bolt]

@greptileai review

[ls-bolt]

📌 Bolt Status

2026-07-20 22:16:15 UTC — ⚡ Agent locked-bulwark-4(#4) started
2026-07-20 22:40:03 UTC — ⚠️ Failed to start agent: timeout of 30000ms exceeded

[jklein24]

Merge activity

• Jul 20, 10:39 PM UTC: Graphite couldn't merge this PR because it failed for an unknown reason (GitHub is reporting that this PR is not mergeable, despite passing required status checks defined by your branch protection rules. Please check your rulesets for additional blocking criteria. Graphite Merge Queue does not currently support rulesets. Please contact Graphite support for further assistance.).