mirror of
https://github.com/hyperdxio/hyperdx
synced 2026-04-21 13:37:15 +00:00
6e8ddd3736
## Summary - Isolate dev, E2E, and integration test environments so multiple git worktrees can run all three simultaneously without port conflicts - Each worktree gets a deterministic slot (0-99) with unique port ranges: dev (30100-31199), E2E (20320-21399), CI integration (14320-40098) - Dev portal dashboard (http://localhost:9900) auto-discovers all running stacks, streams logs, and provides a History tab for past run logs ## Port Isolation | Environment | Port Range | Project Name | |---|---|---| | Dev stack | 30100-31199 | `hdx-dev-<slot>` | | E2E tests | 20320-21399 | `e2e-<slot>` | | CI integration | 14320-40098 | `int-<slot>` | All three can run simultaneously from the same worktree with zero port conflicts. ## Dev Portal Features **Live tab:** - Auto-discovers dev, E2E, and integration Docker containers + local services (API, App) - Groups all environments for the same worktree into a single card - SSE log streaming with ANSI color rendering, capped at 5000 lines - Auto-starts in background from `make dev`, `make dev-e2e`, `make dev-int` **History tab:** - Logs archived to `~/.config/hyperdx/dev-slots/<slot>/history/` on exit (instead of deleted) - Each archived run includes `meta.json` with worktree/branch metadata - Grouped by worktree with collapsible cards, search by worktree/branch - View any past log file in the same log panel, delete individual runs or clear all - Custom dark-themed confirm modal (no native browser dialogs) ## What Changed - **`scripts/dev-env.sh`** — Slot-based port assignments, portal auto-start, log archival on exit - **`scripts/test-e2e.sh`** — E2E port range (20320-21399), log capture via `tee`, portal auto-start, log archival - **`scripts/ensure-dev-portal.sh`** — Shared singleton portal launcher (works sourced or executed) - **`scripts/dev-portal/server.js`** — Discovery for dev/E2E/CI containers, history API (list/read/delete), local service port probing - **`scripts/dev-portal/index.html`** — Live/History tabs, worktree-grouped cards, search, collapse/expand, custom confirm modal, ANSI color log rendering - **`docker-compose.dev.yml`** — Parameterized ports/volumes/project name with `hdx.dev.*` labels - **`packages/app/tests/e2e/docker-compose.yml`** — Updated to new E2E port defaults - **`Makefile`** — `dev-int`/`dev-e2e` targets with log capture + portal auto-start; `dev-portal-stop`; `dev-clean` stops everything + wipes slot data - **`.env` files** — Ports use `${VAR:-default}` syntax across dev, E2E, and CI environments - **`agent_docs/development.md`** — Full documentation for isolation, port tables, E2E/CI port ranges ## How to Use ```bash # Start dev stack (auto-starts portal) make dev # Run E2E tests (auto-starts portal, separate ports) make dev-e2e FILE=navigation # Run integration tests (auto-starts portal, separate ports) make dev-int FILE=alerts # All three can run simultaneously from the same worktree # Portal at http://localhost:9900 shows everything # Stop portal make dev-portal-stop # Clean up everything (all stacks + portal + history) make dev-clean ``` ## Dev Portal <img width="1692" height="944" alt="image" src="https://github.com/user-attachments/assets/6ed388a3-43bc-4552-aa8d-688077b79fb7" /> <img width="1689" height="935" alt="image" src="https://github.com/user-attachments/assets/8677a138-0a40-4746-93ed-3b355c8bd45e" /> ## Test Plan - [x] Run `make dev` — verify services start with slot-assigned ports - [x] Run `make dev` in a second worktree — verify different ports, no conflicts - [x] Run `make dev-e2e` and `make dev-int` simultaneously — no port conflicts - [x] Open http://localhost:9900 — verify all stacks grouped by worktree - [x] Click a service to view logs — verify ANSI colors render correctly - [x] Stop a stack — verify logs archived to History tab with correct worktree - [x] History tab — search, collapse/expand, view archived logs, delete - [x] `make dev-clean` — stops everything, wipes slot data and history
83 lines
3.7 KiB
JSON
83 lines
3.7 KiB
JSON
{
|
|
"name": "hyperdx",
|
|
"private": true,
|
|
"version": "2.0.0",
|
|
"license": "MIT",
|
|
"workspaces": [
|
|
"packages/*"
|
|
],
|
|
"devDependencies": {
|
|
"@changesets/cli": "^2.26.2",
|
|
"@dotenvx/dotenvx": "^1.51.1",
|
|
"@eslint/js": "^9.39.1",
|
|
"@types/ungap__structured-clone": "^1.2.0",
|
|
"@ungap/structured-clone": "^1.3.0",
|
|
"babel-plugin-react-compiler": "^1.0.0",
|
|
"concurrently": "^9.1.2",
|
|
"dotenv": "^16.4.7",
|
|
"dotenv-cli": "^8.0.0",
|
|
"dotenv-expand": "^12.0.1",
|
|
"eslint": "^9.39.1",
|
|
"eslint-config-prettier": "^9.1.0",
|
|
"eslint-plugin-n": "^16.4.0",
|
|
"eslint-plugin-prettier": "^5.2.1",
|
|
"eslint-plugin-security": "^3.0.1",
|
|
"eslint-plugin-simple-import-sort": "^12.1.1",
|
|
"husky": "^8.0.3",
|
|
"knip": "^6.0.1",
|
|
"lint-staged": "^13.1.2",
|
|
"nx": "21.3.11",
|
|
"prettier": "3.3.3",
|
|
"tslib": "^2.6.0",
|
|
"typescript-eslint": "^8.46.0"
|
|
},
|
|
"scripts": {
|
|
"setup": "yarn install && husky install",
|
|
"build:common-utils": "nx run @hyperdx/common-utils:dev:build",
|
|
"app:dev": "concurrently -k -n 'API,APP,ALERTS-TASK,COMMON-UTILS' -c 'green.bold,blue.bold,yellow.bold,magenta' 'nx run @hyperdx/api:dev 2>&1 | tee ${HDX_DEV_LOGS_DIR:+\"$HDX_DEV_LOGS_DIR/api.log\"}' 'nx run @hyperdx/app:dev 2>&1 | tee ${HDX_DEV_LOGS_DIR:+\"$HDX_DEV_LOGS_DIR/app.log\"}' 'nx run @hyperdx/api:dev-task check-alerts 2>&1 | tee ${HDX_DEV_LOGS_DIR:+\"$HDX_DEV_LOGS_DIR/alerts.log\"}' 'nx run @hyperdx/common-utils:dev 2>&1 | tee ${HDX_DEV_LOGS_DIR:+\"$HDX_DEV_LOGS_DIR/common-utils.log\"}'",
|
|
"app:dev:local": "concurrently -k -n 'APP,COMMON-UTILS' -c 'blue.bold,magenta' 'nx run @hyperdx/app:dev:local' 'nx run @hyperdx/common-utils:dev'",
|
|
"app:lint": "nx run @hyperdx/app:ci:lint",
|
|
"app:storybook": "nx run @hyperdx/app:storybook",
|
|
"build:clickhouse": "nx run @hyperdx/common-utils:build && nx run @hyperdx/app:build:clickhouse",
|
|
"run:clickhouse": "nx run @hyperdx/app:run:clickhouse",
|
|
"dev": "sh -c '. ./scripts/dev-env.sh && yarn build:common-utils && dotenvx run --convention=nextjs -- docker compose -p \"$HDX_DEV_PROJECT\" -f docker-compose.dev.yml up -d && yarn app:dev; dotenvx run --convention=nextjs -- docker compose -p \"$HDX_DEV_PROJECT\" -f docker-compose.dev.yml down'",
|
|
"dev:local": "IS_LOCAL_APP_MODE='DANGEROUSLY_is_local_app_mode💀' yarn dev",
|
|
"dev:down": "sh -c '. ./scripts/dev-env.sh && docker compose -p \"$HDX_DEV_PROJECT\" -f docker-compose.dev.yml down && sh ./scripts/dev-kill-ports.sh'",
|
|
"dev:compose": "sh -c '. ./scripts/dev-env.sh && docker compose -p \"$HDX_DEV_PROJECT\" -f docker-compose.dev.yml'",
|
|
"knip": "knip",
|
|
"knip:ci": "knip --reporter json",
|
|
"lint": "npx nx run-many -t ci:lint",
|
|
"version": "make version",
|
|
"release": "npx changeset tag && npx changeset publish"
|
|
},
|
|
"lint-staged": {
|
|
"packages/api/src/routers/external-api/**/*.ts": [
|
|
"prettier --write --ignore-unknown",
|
|
"eslint --flag v10_config_lookup_from_file --fix --quiet",
|
|
"sh -c 'cd packages/api && yarn run lint:openapi && git add openapi.json'"
|
|
],
|
|
"**/*.{ts,tsx}": [
|
|
"prettier --write --ignore-unknown",
|
|
"eslint --flag v10_config_lookup_from_file --fix --quiet"
|
|
],
|
|
"**/*.{mdx,json,yml}": [
|
|
"prettier --write --ignore-unknown"
|
|
]
|
|
},
|
|
"packageManager": "yarn@4.5.1",
|
|
"resolutions": {
|
|
"@types/react": "19.0.7",
|
|
"@types/react-dom": "19.0.3",
|
|
"@types/express": "4.17.21",
|
|
"@types/express-serve-static-core": "4.17.43",
|
|
"express": "^4.20.0",
|
|
"send": "^0.19.0",
|
|
"serve-static": "^1.16.0",
|
|
"cookie": "^0.7.0",
|
|
"brace-expansion": "^2.0.2",
|
|
"diff": "^5.2.2",
|
|
"on-headers": "^1.1.0",
|
|
"fast-xml-parser": "^4.5.4",
|
|
"systeminformation": "^5.24.0"
|
|
}
|
|
}
|