Skip to content

feat(cdp): support custom CDP ports via .env for multi-instance setups (#93) - #234

Draft
dgomez407 wants to merge 10 commits into
tokyoweb3:mainfrom
dgomez407:feat/custom-cdp-port-via-env
Draft

feat(cdp): support custom CDP ports via .env for multi-instance setups (#93)#234
dgomez407 wants to merge 10 commits into
tokyoweb3:mainfrom
dgomez407:feat/custom-cdp-port-via-env

Conversation

@dgomez407

@dgomez407 dgomez407 commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Summary

Closes #93

While PR #114 introduced account config parsing utilities, low-level CDP candidate port scanning across CdpService, AntigravityLauncher, and CLI commands (doctor, open, setup) still defaulted to the static DEFAULT_CDP_PORTS array.

This PR enables dynamic candidate port resolution prioritizing custom environment overrides (CDP_PORT and ANTIGRAVITY_ACCOUNTS) while gracefully falling back to standard default ports.


Key Changes

  1. Dynamic Candidate Port Resolution (src/utils/cdpPorts.ts)

    • Added getCdpCandidatePorts(accountsEnv?, singlePortEnv?) helper with integer boundary validation (1..65535) and Set<number> deduplication.
    • Refactored getConfiguredCdpPorts() to delegate directly to getCdpCandidatePorts().
  2. Core Service & Process Launcher Wiring

    • Updated CdpService.resolveAccountPorts() to call getCdpCandidatePorts().
    • Updated AntigravityLauncher (startAntigravity, stopAntigravity, ensureAntigravityRunning) to iterate over dynamic candidate ports.
  3. CLI Commands & Diagnostics

    • Updated port probing and diagnostic output in doctor.ts, open.ts, and setup.ts to scan configured candidate ports.
  4. Documentation & Environment Template

    • Added CDP_PORT and ANTIGRAVITY_ACCOUNTS example entries to .env.example.
    • Updated README.md configuration guide and candidate port scanning tip.
  5. Tests & Verification

    • Added unit test cases in tests/utils/cdpPorts.test.ts covering custom single ports, multi-account mappings, defaults, and malformed input handling.
    • Added live HTTP integration test in tests/services/customPortLive.test.ts.

Verification

  • npm run build — 0 TypeScript compilation errors
  • npx jest tests/utils/cdpPorts.test.ts — 7/7 tests passed
  • npx jest tests/services/customPortLive.test.ts — 1/1 test passed

@coderabbitai

coderabbitai Bot commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 27e02579-a54e-408e-abec-9534d43e048a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

@dgomez407
dgomez407 force-pushed the feat/custom-cdp-port-via-env branch 2 times, most recently from 255f3dd to 835a868 Compare August 8, 2026 21:08
…d i18n (tokyoweb3#147)

### Audit Summary Matrix: Issue tokyoweb3#147

| # | Item Description | Initial Audit | Resolution Status | Technical Action Taken |
|---|---|:---:|:---:|---|
| 1 | Type Safety in interactionCreateHandler.ts | Still Present | Fixed & Verified | Removed (interaction as any).channelId and (interaction as any).channel?.threads casts; refactored targetChannel checks to use typed sendableChannel in src/events/interactionCreateHandler.ts. |
| 2 | Dependency Injection (ArtifactService) | Still Present | Fixed & Verified | Replaced new ArtifactService() inline instantiation with deps.artifactService || new ArtifactService() in src/events/interactionCreateHandler.ts. |
| 3 | API Consistency (artifactRenderMode?) | Resolved | Confirmed | Verified UserPreferenceRecord.artifactRenderMode is optional (?) in src/database/userPreferenceRepository.ts. |
| 4 | Encoding Robustness (encodeSelectValue) | Still Present | Fixed & Verified | Replaced numeric filename hash with an 8-character hex SHA-256 hash segment of conversationId + filename in src/services/artifactService.ts. |
| 5 | i18n Integration (artifactsUi.ts) | Still Present | Fixed & Verified | Replaced unlocalized strings with t() i18n helper function across UI elements in src/ui/artifactsUi.ts. |

### Technical Details
- Type Safety: Cleaned up interactionCreateHandler.ts by using typed channel property guards and interaction.channelId directly.
- Dependency Injection: Injected artifactService into interactionCreateHandler for testability and architectural consistency.
- Encoding Robustness: Updated ArtifactService.encodeSelectValue to compute sha256(conversationId + ':' + filename).slice(0, 8).
- Internationalization: Wrapped artifactsUi.ts strings with t() helper function.
- Tests: Added TDD unit assertions in artifactService.test.ts and interactionCreateHandler.test.ts.

Rebased against doc/docstring-cleanup.
Full test suite passing (115 test suites, 1549 tests).
…r precedence, and negative test assertions

### Audit Summary Matrix: Final Review Resolution

| # | Item Description | Initial Audit | Resolution Status | Technical Action Taken |
|---|---|:---:|:---:|---|
| 1 | Type Safety in interactionCreateHandler.ts | Still Present | Fixed & Verified | Created SendableChannel type guard in src/utils/discordChannelUtils.ts; removed inline `{ send: Function }` and `(interaction.channel as any).send` casts across all fallback send paths. |
| 2 | Process Log Buffer Consolidation | Still Present | Fixed & Verified | Exported createDefaultProcessLogBuffer() factory in src/utils/processLogBuffer.ts to centralize log buffer configuration across Discord and Telegram message handlers. |
| 3 | Title Parsing & Separator Precedence | Still Present | Fixed & Verified | Refined parseProjectNameFromTitle in src/services/cdpService.ts with a 3-tier separator hierarchy (Product Suffix > Em/En Dash > Hyphen). |
| 4 | Negative Test Coverage (decodeSelectValue) | Still Present | Fixed & Verified | Added explicit test case for same 8-char short prefix collision rejection in tests/services/artifactService.test.ts. |
| 5 | Regression Test (sendableChannel) | Still Present | Fixed & Verified | Added unit test asserting SendableChannel target channel dispatching in tests/events/interactionCreateHandler.test.ts. |

### Technical Details
- Type Safety: Isolated Discord sendable channel narrowing into src/utils/discordChannelUtils.ts with isSendableChannel predicate.
- Process Log Buffering: Standardized maxChars, maxEntries, and maxEntryLength tuning via createDefaultProcessLogBuffer().
- Title Parsing: Prioritized em-dash (—) and en-dash (–) over plain hyphens (-) when extracting project names from titles.
- Test Coverage: Added SendableChannel dispatching test in interactionCreateHandler.test.ts and prefix collision test in artifactService.test.ts.

Full test suite passing (115 test suites, 1559 tests).
tokyoweb3#93)

Add support for resolving custom CDP debugging ports from environment variables (CDP_PORT and ANTIGRAVITY_ACCOUNTS) alongside default candidates.

Key changes:
- Implement getCdpCandidatePorts() in src/utils/cdpPorts.ts with strict integer parsing (1..65535) and set-based deduplication.
- Wire dynamic port candidate scanning into CdpService.resolveAccountPorts(), AntigravityLauncher, and CLI commands (doctor, open, setup).
- Update .env.example and README.md with configuration usage examples.
- Add unit and live HTTP integration tests for custom port resolution.

Closes tokyoweb3#93
@dgomez407
dgomez407 force-pushed the feat/custom-cdp-port-via-env branch from 835a868 to f908585 Compare August 10, 2026 11:59
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.

feat: support custom CDP ports via .env for multi-instance Antigravity setups

1 participant