feat(channels)!: rename accounts to channels (v0.4.0)

[ord669]

Monorepo Phase 116 renames Account to Channel as the canonical noun for a WhatsApp connection (industry standard: Twilio, Intercom, Front, Zendesk). This CLI rename lands in lockstep.

Summary

• `commands/accounts.ts` → `commands/channels.ts` (6 subcommands renamed: `list`, `show`, `connect`, `disconnect`, `enable`, `disable`)
• `registerAccountsCommand` → `registerChannelsCommand`
• `runAccountsConnect` → `runChannelsConnect` (post-login wizard entry)
• `resolveAccount` → `resolveChannel` (shared helper)
• API URLs `/meta/accounts` → `/meta/channels` across webhook, token, env, health commands
• `hookmyapp login --next accounts` → `--next channels`
• `hookmyapp workspace current` now reads `channelCount` from the API and prints `Channels:` label
• 5 test files updated (`tests/channels.test.ts` renamed; webhook/env/workspace/login refs flipped)
• Nyquist Dim-3 boundary test added: `accounts list` must exit with unknown-command error (proves absence, not just presence of the rename)
• Version 0.3.0 → 0.4.0 (breaking — no alias, hard-rename per CONTEXT)
• `CHANGELOG.md` created

Not renamed (intentionally)

• `README.md` "WhatsApp Business account" — Meta product name (not our model)
• OAuth redirect URI `${appUrl}/cli/callback` — not a `/dashboard/accounts/*` path

Release flow

Per CONTEXT: monorepo PR lands FIRST (Phase 116 backend + frontend + workers serve `/meta/channels/*`), then this CLI PR merges and tag `v0.4.0` ships. Short window of broken v0.3.0 CLI is acceptable pre-prod.

Test plan

• `pnpm test` green (277/278 — pre-existing env-profiles WorkOS client ID test failure on `main` unrelated to rename, will be fixed in a separate CLI-scoped PR)
• `pnpm exec tsc --noEmit` EXIT 0
• Merge + tag `v0.4.0` triggers `publish.yml`; `@gethookmyapp/cli@0.4.0` on npm with provenance badge
• Clean-machine `npm install -g @gethookmyapp/cli@0.4.0 && hookmyapp channels --help` works
• Clean-machine `hookmyapp accounts --help` errors with "unknown command"

Summary by CodeRabbit

• Breaking Changes

  • Renamed accounts command group to channels (includes list, show, connect, disconnect, enable, disable subcommands)
  • Updated --next accounts flag to --next channels
  • Migrated API endpoints from /meta/accounts to /meta/channels
  • Old accounts command no longer available; no aliases provided

• Documentation

  • Added CHANGELOG.md with migration instructions for users

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This pull request performs a breaking version update (0.3.0 → 0.4.0) that renames the CLI "accounts" command group to "channels" across the codebase. All related functionality, API endpoints (/meta/accounts/* → /meta/channels/*), test cases, and user-facing text have been updated to reflect this terminology change.

Changes

Cohort / File(s)	Summary
Release Management CHANGELOG.md, package.json	Version bump to 0.4.0 with release notes documenting breaking changes: accounts command renamed to channels, accounts flag in login becomes channels, and workspace output field changes from accountCount to channelCount.
Command Implementations - Channel Resolution src/commands/channels.ts, src/commands/env.ts, src/commands/health.ts, src/commands/token.ts, src/commands/webhook.ts	Refactored account-based logic to channel-based: replaced resolveAccount() with resolveChannel(), updated API endpoints from /meta/accounts to /meta/channels, changed resolver function names and exports, and updated command descriptions and error messages.
Workspace & Infrastructure Commands src/commands/workspace.ts, src/commands/sandbox-listen/index.ts, src/config/env-profiles.ts	Updated workspace current output label from "Accounts" to "Channels"; removed local env-detection helpers and centralized via resolveEnv(); updated workosClientId in local env profile.
CLI Core & Authentication src/index.ts, src/auth/login.ts	Replaced accounts command registration with channels; updated CLI descriptions and help text; modified WizardOpts.next type to accept 'channels' instead of 'accounts' and wired --next channels to delegate to runChannelsConnectFlow().
Test Suite - Core Command Tests src/__tests__/channels.test.ts, src/__tests__/env.test.ts, src/__tests__/webhook.test.ts, src/__tests__/workspace.test.ts	Updated test fixtures and mocks: renamed fakeAccounts to fakeChannels, switched API mock calls from /meta/accounts/* to /meta/channels/*, updated error message assertions, and added validation that old "accounts" command is unknown.
Test Suite - Authentication & Infrastructure src/auth/__tests__/login.test.ts, src/commands/__tests__/sandbox-listen-env.test.ts	Updated login tests to mock channels module instead of accounts; added new sandbox-listen-env test suite validating resolveEnv() behavior with HOOKMYAPP_ENV and HOOKMYAPP_API_URL environment variables.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~30 minutes

Poem

🐰 Hop hop, the accounts have gone away,
Now channels lead the WhatsApp day!
Endpoints dance from /meta/accounts free,
To /meta/channels is where they'll be,
A breaking change, but oh so clean! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 33.33% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and specifically summarizes the main change: a breaking rename of the CLI surface from 'accounts' to 'channels' for v0.4.0, which is reflected throughout all major file changes (commands, tests, API endpoints, configuration).

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch phase-116/rename-accounts-to-channels

---

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