[purpshell]

What changed

• add commands for Customers enablement, list filters, profiles, archive, and restore
• add commands for assigned Numbers, events, pairing links, and confirmed Number transfers
• require project context, confirmation, and idempotency keys at the relevant command boundaries
• preserve cursor metadata in JSON output and the one-time pairing-link URL in human output
• pin the CLI to the reviewed Customers SDK commit
• document every Customer command

Verification

• npm run verify
• 232 tests passed
• package dry run passed
• production dependency audit found no vulnerabilities
• CodeRabbit exact-commit review: no findings

No package was published.

---

^{Need help on this PR? Tag @codesmith with what you need. Autofix is disabled.}

Summary by CodeRabbit

• New Features

  • Added comprehensive customer management commands, including status, enablement, creation, viewing, listing, updating, archiving, and restoring customers.
  • Added customer number and event listing, number transfers, and pairing-link creation, listing, and revocation.
  • Added filtering, pagination, search, confirmation prompts, and idempotency support for applicable operations.

• Documentation

  • Documented customer command usage, required options, supported operations, response behavior, and pairing-link workflows.

• Tests

  • Added integration coverage for customer workflows, validation, pagination, request payloads, and idempotency behavior.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Essentials

Run ID: 418829cc-fcc6-4a9a-b61d-93a60b2d819f

📥 Commits

Reviewing files that changed from the base of the PR and between 3c88860 and bca9b39.

⛔ Files ignored due to path filters (1)

• package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (19)

• README.md
• docs/command-research/customers.md
• package.json
• src/commands/customer/archive.ts
• src/commands/customer/create.ts
• src/commands/customer/enable.ts
• src/commands/customer/event/list.ts
• src/commands/customer/list.ts
• src/commands/customer/number/list.ts
• src/commands/customer/number/transfer.ts
• src/commands/customer/pairing-link/create.ts
• src/commands/customer/pairing-link/list.ts
• src/commands/customer/pairing-link/revoke.ts
• src/commands/customer/restore.ts
• src/commands/customer/status.ts
• src/commands/customer/update.ts
• src/commands/customer/view.ts
• src/services/customers.ts
• test/commands/customers.test.ts

Included review availability: 4 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 5 reviews per hour.

---

📝 Walkthrough

Walkthrough

Added customer management services and CLI commands for lifecycle operations, Numbers, events, pairing links, and transfers. Added command metadata, documentation, response rendering, validation, idempotency support, and integration tests.

Changes

Customer management

Layer / File(s)	Summary
Customer service foundation src/services/customers.ts, package.json	Added typed service wrappers, project validation, response metadata normalization, and renderers for customers and related resources. Updated the SDK reference.
Customer lifecycle commands src/commands/customer/{status,enable,list,create,view,update,archive,restore}.ts, package.json, test/commands/customers.test.ts, README.md, docs/command-research/customers.md	Added customer lifecycle commands with project selection, idempotency keys, confirmation flags, filtering, field clearing, rendering, command topics, documentation, and integration coverage.
Customer resources and transfers src/commands/customer/{event,number,pairing-link}/**, test/commands/customers.test.ts	Added event, Number, pairing-link, and Number transfer commands with request validation, confirmation handling, rendering, fixtures, and HTTP integration tests.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant CustomerCreate
  participant CustomerService
  participant PlatformClient
  CustomerCreate->>CustomerService: createCustomer(project, fields, idempotencyKey)
  CustomerService->>PlatformClient: Create customer request
  PlatformClient-->>CustomerService: Customer response and metadata
  CustomerService-->>CustomerCreate: Render CustomerResult

Loading

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 30 functions across 16 files. (3 skipped: …	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely summarizes the main change: adding the complete Customers CLI workflow.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Docstring Coverage

Explanation

Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 30 functions across 16 files. (3 skipped: 3 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

---

_{Comment @coderabbitai help to get the list of available commands.}

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-09-04T15:14:10.726376Z	bca9b39	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.