BridgeSwarm/native-host/vendor/bare-discord-js/PLAN.md

bare-discord-js Production Implementation Plan

This file mirrors the approved execution plan and is tracked in-repo as the implementation contract.

Goal

• Provide require('bare-discord-js') and import ... from 'bare-discord-js' parity with official discord.js 14.27+ inside Bare.
• Ensure end users install only one package and do not configure aliases/import maps manually.
• Gate releases on strict parity verification.

Architecture

• Internal bootstrap loads bare-node-runtime/global and import mappings automatically.
• Dual entrypoints (src/index.js [CJS], src/index.mjs [ESM]) re-export official discord.js.
• Compatibility adapters isolate runtime differences (WebSocket, TLS/HTTPS, zlib, crypto).
• Patch manifest and automation scripts track upstream drift and compatibility work.

Delivery Phases

1. Baseline inventory scripts for dependency and builtin mapping.
2. Bootstrap loader and import-map encapsulation.
3. Adapter and patch infrastructure.
4. Build/packaging workflow (npm + optional bare-pack).
5. Parity test harness (Node vs Bare behavior checks).
6. Release verification and upstream sync automation.

Repro Command Set

npm install
npm run analyze
npm run verify-bootstrap-load
npm run generate-patches
npm run apply-patches
npm run test:parity
npm run release:verify

Strict Parity Policy

• Any observed runtime incompatibility blocks GA.
• Voice/gateway/rest paths are all required unless explicitly re-scoped.