MUH. IQRAM BAHRING
25df5e6a9d
Introduce AGENTS.md (root, primary agent instruction file) documenting six hard-won fixes with explicit DO NOT / WHY, plus executable enforcement so a future AI cannot delete or reintroduce them: 1. package-lock.json must be generated with npm 10 (Docker's npm 10.9.8). npm 11 drops the top-level @emnapi/core + @emnapi/runtime entries npm 10 needs, breaking the tag-triggered Docker build at `npm ci` (happened on v1.0.14). Add scripts/verify-lockfile-npm10.mjs + .npmrc + a Dockerfile fail-fast check + a CI step + tests/unit/lockfile-npm10-guard.test.js. Also re-fix the lockfile itself (regenerated with npm 10.9.8). 2. Tests must never write to the real ~/.9router DB (isolateDataDir). 3. Hidden providers must not leak into Usage (usageProviders !p.hidden). 4. codebuddy-intl connection test + OAuth identity. 5. Fork-only features that must survive upstream syncs. 6. Upstream sync procedure. Each marker cross-references AGENTS.md and the covering test. CLAUDE.md now points to AGENTS.md at the top. Verified: build ok, guard script passes, full suite leaves the real DB count unchanged (38), 0 new regressions.
9Router MIBP Version
A local AI routing gateway with provider fallback and token-saving features. This is a fork of decolua/9router.
Installation
Option 1: Docker
Pull the image:
docker pull mhiqrambhrng/9router-mibp-version:latest
Run the container:
mkdir -p 9router-data
docker run -d \
--name 9router \
-p 20128:20128 \
-v 9router-data:/app/data \
-e DATA_DIR=/app/data \
-e PORT=20128 \
-e HOSTNAME=0.0.0.0 \
-e NODE_ENV=production \
-e JWT_SECRET=<generate-with-openssl-rand-hex-32> \
-e INITIAL_PASSWORD=<your-dashboard-password> \
-e API_KEY_SECRET=<generate-with-openssl-rand-hex-32> \
-e MACHINE_ID_SALT=<generate-with-openssl-rand-hex-32> \
mhiqrambhrng/9router-mibp-version:latest
Or using Docker Compose (a docker-compose.yml is included in this repo):
cp .env.example .env # fill in JWT_SECRET, INITIAL_PASSWORD, API_KEY_SECRET, MACHINE_ID_SALT
docker compose up -d
Dashboard opens at http://localhost:20128/dashboard.
Option 2: Manual (from source)
Requirements: Node.js 22 or newer.
git clone https://github.com/mhiqrambg/9router-mibp-version.git
cd 9router-mibp-version
cp .env.example .env
# Edit .env: set JWT_SECRET, INITIAL_PASSWORD, API_KEY_SECRET, MACHINE_ID_SALT
npm install
# Development server
npm run dev
# Or production build
npm run build
npm run start
Dashboard opens at http://localhost:20128/dashboard.
More Information
- Upstream project: https://github.com/decolua/9router
- Upstream docs: DOCKER.md • ARCHITECTURE.md