npm - @bhooai/nexus-cli - Versions diffs - 0.1.5 → 2.0.1 - Mend

@bhooai/nexus-cli 0.1.5 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (112) hide show

package/package.json +26 -27
package/src/commands/add.ts +274 -0
package/src/commands/build.ts +91 -0
package/src/commands/db.ts +241 -0
package/src/commands/dev.ts +149 -186
package/src/commands/doctor.ts +102 -184
package/src/commands/init.ts +204 -958
package/src/commands/maintenance-commands.ts +40 -0
package/src/commands/plugin.ts +233 -0
package/src/commands/queue.ts +145 -0
package/src/commands/test.ts +34 -0
package/src/dispatcher.ts +98 -0
package/src/generators.ts +102 -0
package/src/index.ts +32 -90
package/src/make/generators.ts +431 -0
package/src/ports.ts +85 -0
package/src/prompts.ts +68 -0
package/src/templating/render.ts +109 -0
package/src/util.ts +74 -112
package/templates/base/Dockerfile.ejs +68 -0
package/templates/base/README.md.ejs +62 -0
package/templates/base/apps/admin/index.html.ejs +12 -0
package/templates/base/apps/admin/nginx.conf.ejs +16 -0
package/templates/base/apps/admin/package.json.ejs +15 -0
package/templates/base/apps/admin/src/main.tsx.ejs +7 -0
package/templates/base/apps/admin/vite.config.ts.ejs +22 -0
package/templates/base/apps/ai-server/main.py.ejs +30 -0
package/templates/base/apps/ai-server/requirements.txt +4 -0
package/templates/base/apps/backend/src/main.ts +14 -0
package/templates/base/apps/backend/src/routes/index.ts.ejs +11 -0
package/templates/base/apps/frontend/index.html.ejs +12 -0
package/templates/base/apps/frontend/nginx.conf.ejs +33 -0
package/templates/base/apps/frontend/package.json.ejs +11 -0
package/templates/base/apps/frontend/src/main.tsx.ejs +16 -0
package/templates/base/apps/frontend/vite.config.ts.ejs +22 -0
package/templates/base/docker-compose.yml.ejs +93 -0
package/templates/base/dockerignore +21 -0
package/templates/base/gitignore +43 -0
package/templates/base/nexus.config.ts.ejs +97 -0
package/templates/base/package.json.ejs +40 -0
package/templates/{tsconfig.json → base/tsconfig.json} +2 -3
package/tsconfig.json +5 -4
package/PLAN.md +0 -141
package/README.md +0 -34
package/src/commands/cluster.ts +0 -133
package/src/commands/node.ts +0 -106
package/src/commands/pysetup.ts +0 -142
package/src/commands/sync.ts +0 -116
package/src/commands/uninstall.ts +0 -287
package/src/config-sync.ts +0 -384
package/src/dotenv.ts +0 -39
package/src/supervisor.ts +0 -394
package/src/wizard.ts +0 -149
package/templates/Dockerfile +0 -60
package/templates/README.md +0 -69
package/templates/apps/admin/index.html +0 -12
package/templates/apps/admin/package.json +0 -22
package/templates/apps/admin/postcss.config.js +0 -3
package/templates/apps/admin/src/main.tsx +0 -10
package/templates/apps/admin/src/vite-env.d.ts +0 -18
package/templates/apps/admin/tailwind.config.js +0 -9
package/templates/apps/admin/tsconfig.json +0 -17
package/templates/apps/admin/vite.config.ts +0 -64
package/templates/apps/ai-server/main.py +0 -43
package/templates/apps/ai-server/providers/__init__.py +0 -3
package/templates/apps/ai-server/providers/base.py +0 -111
package/templates/apps/ai-server/requirements.txt +0 -3
package/templates/apps/ai-server/routers/__init__.py +0 -3
package/templates/apps/ai-server/routers/chat.py +0 -47
package/templates/apps/ai-server/routers/embeddings.py +0 -30
package/templates/apps/ai-server/routers/lint.py +0 -167
package/templates/apps/ai-server/routers/models.py +0 -23
package/templates/apps/ai-server/routers/preflight.py +0 -169
package/templates/apps/ai-server/settings.py +0 -48
package/templates/apps/backend/package.json +0 -34
package/templates/apps/backend/src/main.ts +0 -375
package/templates/apps/backend/src/modules/admin/adminRoutes.ts +0 -732
package/templates/apps/backend/src/modules/admin/clusterRoutes.ts +0 -391
package/templates/apps/backend/src/modules/admin/databaseRoutes.ts +0 -161
package/templates/apps/backend/src/modules/admin/lintProxy.ts +0 -89
package/templates/apps/backend/src/modules/admin/preflightProxy.ts +0 -242
package/templates/apps/backend/src/modules/admin/roleCatalog.ts +0 -78
package/templates/apps/backend/src/modules/admin/schemaRoutes.ts +0 -449
package/templates/apps/backend/src/modules/ai/aiProxy.ts +0 -265
package/templates/apps/backend/src/modules/auth/authRoutes.ts +0 -220
package/templates/apps/backend/src/modules/payments/paymentRoutes.ts +0 -100
package/templates/apps/backend/src/modules/payments/paymentStore.ts +0 -172
package/templates/apps/backend/src/modules/requests/requestLog.ts +0 -175
package/templates/apps/backend/src/modules/users/userGraph.ts +0 -83
package/templates/apps/backend/src/modules/users/userModel.ts +0 -88
package/templates/apps/backend/src/plugins/CronScheduler.ts +0 -69
package/templates/apps/backend/src/plugins/loadPlugins.ts +0 -107
package/templates/apps/backend/tsconfig.json +0 -14
package/templates/apps/frontend/index.html +0 -12
package/templates/apps/frontend/package.json +0 -20
package/templates/apps/frontend/postcss.config.js +0 -3
package/templates/apps/frontend/src/index.css +0 -44
package/templates/apps/frontend/src/main.tsx +0 -65
package/templates/apps/frontend/tailwind.config.js +0 -9
package/templates/apps/frontend/vite.config.ts +0 -72
package/templates/bin/nexus.js +0 -35
package/templates/bin/serve-all.mjs +0 -45
package/templates/dockerignore +0 -15
package/templates/gitignore +0 -12
package/templates/nexus.config.ts +0 -69
package/templates/package.json +0 -47
package/tests/cli.test.ts +0 -52
package/tests/config-sync.test.ts +0 -201
package/tests/dotenv.test.ts +0 -51
package/vitest.config.ts +0 -9
package/vitest.config.ts.timestamp-1786095205351-444061f6ff5c58.mjs +0 -13
/package/templates/{uploads → base/apps/backend/storage}/.gitkeep +0 -0

package/templates/base/apps/frontend/index.html.ejs ADDED Viewed

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <title><%= name %></title>
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="/src/main.tsx"></script>
+</body>
+</html>

package/templates/base/apps/frontend/nginx.conf.ejs ADDED Viewed

@@ -0,0 +1,33 @@
+server {
+  listen 80;
+  server_name _;
+  root /usr/share/nginx/html;
+  index index.html;
+  # SPA fallback: every non-file GET → index.html
+  location / {
+    try_files $uri $uri/ /index.html;
+  }
+  # API and WebSocket proxies — targets picked up from env at container boot
+  location /api/ {
+    proxy_pass http://backend:<%= backendPort %>/;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+  }
+  location /uploads/ {
+    proxy_pass http://backend:<%= backendPort %>/uploads/;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+  }
+  location /ws {
+    proxy_pass http://backend:<%= backendPort %>/ws;
+    proxy_http_version 1.1;
+    proxy_set_header Upgrade $http_upgrade;
+    proxy_set_header Connection "upgrade";
+    proxy_set_header Host $host;
+  }
+}

package/templates/base/apps/frontend/package.json.ejs ADDED Viewed

@@ -0,0 +1,11 @@
+{
+  "name": "@<%= nameSlug %>/frontend",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite --port <%= frontendPort %>",
+    "build": "vite build",
+    "preview": "vite preview"
+  }
+}

package/templates/base/apps/frontend/src/main.tsx.ejs ADDED Viewed

@@ -0,0 +1,16 @@
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+function App() {
+  return (
+    <main style={{ fontFamily: 'system-ui', padding: '2rem' }}>
+      <h1>Welcome to <%= name %></h1>
+      <p>Your Nexus app is up. Edit <code>apps/frontend/src/main.tsx</code> to get started.</p>
+    </main>
+  );
+}
+const rootEl = document.getElementById('root');
+if (rootEl) {
+  createRoot(rootEl).render(<App />);
+}

package/templates/base/apps/frontend/vite.config.ts.ejs ADDED Viewed

@@ -0,0 +1,22 @@
+import { defineConfig } from 'vite';
+export default defineConfig({
+  server: {
+    port: <%= frontendPort %>,
+    proxy: {
+      '/api': {
+        target: 'http://localhost:<%= backendPort %>',
+        changeOrigin: true,
+        rewrite: (p: string) => p.replace(/^\/api/, ''),
+      },
+      '/uploads': {
+        target: 'http://localhost:<%= backendPort %>',
+        changeOrigin: true,
+      },
+      '/ws': {
+        target: 'ws://localhost:<%= backendPort %>',
+        ws: true,
+      },
+    },
+  },
+});

package/templates/base/docker-compose.yml.ejs ADDED Viewed

@@ -0,0 +1,93 @@
+version: "3.9"
+name: <%= nameSlug %>
+services:
+  backend:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: backend-base
+    ports:
+      - "<%= backendPort %>:<%= backendPort %>"
+    env_file: .env
+    environment:
+      NODE_ENV: production
+      NEXUS_DB_URI: ${NEXUS_DB_URI:-mongodb://mongo:27017/<%= nameSlug %>}
+      NEXUS_REDIS_URL: ${NEXUS_REDIS_URL:-redis://redis:6379}
+    volumes:
+      - ./apps/backend/storage:/app/apps/backend/storage
+    depends_on:
+      mongo:
+        condition: service_healthy
+      redis:
+        condition: service_started
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://localhost:<%= backendPort %>/health"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+  frontend:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: frontend
+    ports:
+      - "<%= frontendPort %>:80"
+    depends_on:
+      - backend
+    restart: unless-stopped
+  admin:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: admin
+    ports:
+      - "<%= adminPort %>:80"
+    depends_on:
+      - backend
+    restart: unless-stopped
+  ai-server:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: ai-server
+    profiles: ["ai"]
+    ports:
+      - "<%= aiPort %>:<%= aiPort %>"
+    restart: unless-stopped
+  mongo:
+    image: mongo:7
+    restart: unless-stopped
+    volumes:
+      - mongo-data:/data/db
+    healthcheck:
+      test: ["CMD", "mongosh", "--quiet", "--eval", "db.runCommand('ping').ok"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    ports:
+      - "27017:27017"
+  redis:
+    image: redis:7-alpine
+    restart: unless-stopped
+    command: redis-server --appendonly yes
+    volumes:
+      - redis-data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 3s
+      retries: 5
+    ports:
+      - "6379:6379"
+volumes:
+  mongo-data:
+  redis-data:

package/templates/base/dockerignore ADDED Viewed

@@ -0,0 +1,21 @@
+node_modules
+dist
+build
+.nexus-down
+.nexus-ports.json
+.env
+.env.local
+logs/
+certs/
+apps/*/storage/
+.venv/
+venv/
+__pycache__/
+*.pyc
+.vscode/
+.idea/
+coverage/
+.nyc_output/
+playwright-report/
+test-results/
+.cache/

package/templates/base/gitignore ADDED Viewed

@@ -0,0 +1,43 @@
+# Dependencies
+node_modules/
+# Build output
+dist/
+build/
+*.tsbuildinfo
+# Runtime
+.env
+.env.local
+nexus.runtime.json
+# Generated
+logs/
+certs/
+!certs/.gitkeep
+# Per-backend storage (apps/<backend>/storage/)
+apps/*/storage/*
+!apps/*/storage/.gitkeep
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+.pytest_cache/
+# Editor / OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+# Test / coverage
+coverage/
+.nyc_output/
+playwright-report/
+test-results/
+# Maintenance mode flag
+.nexus-down

package/templates/base/nexus.config.ts.ejs ADDED Viewed

@@ -0,0 +1,97 @@
+import type { NexusConfig } from '@bhooai/nexus-core';
+/**
+ * Nexus config for <%= name %>.
+ *
+ * Precedence (low to high): code defaults < this file < nexus.runtime.json
+ * < NEXUS_* env vars < CLI flags.
+ *
+ * Secrets live in .env; do NOT commit them here.
+ */
+const config: Partial<NexusConfig> = {
+  env: 'development',
+  server: {
+    port: <%= backendPort %>,
+    host: '127.0.0.1',
+    https: false,
+    trustProxy: false,
+    bodyLimit: 12 * 1024 * 1024,
+  },
+  uploads: {
+    dir: 'storage/uploads',
+    path: '/uploads',
+    maxFileSize: 10 * 1024 * 1024,
+    maxFiles: 20,
+    allowedTypes: [],
+  },
+  db: {
+    uri: process.env.NEXUS_DB_URI ?? '<%= mongoUri %>',
+    maxPoolSize: 10,
+    autoIndex: true,
+  },
+  redis: {
+    url: process.env.NEXUS_REDIS_URL ?? '<%= redisUrl %>',
+    keyPrefix: '<%= nameSlug %>:',
+  },
+  graphql: {
+    path: '/graphql',
+    federation: 'in-process',
+    subscriptions: true,
+    introspection: true,
+  },
+  ws: {
+    path: '/ws',
+    heartbeatMs: 30_000,
+    requireCsrf: true,
+  },
+  auth: {
+    jwt: {
+      accessTtl: 60 * 15,
+      refreshTtl: 60 * 60 * 24 * 30,
+      issuer: '<%= nameSlug %>',
+      audience: '<%= nameSlug %>-client',
+    },
+    cookieName: '<%= nameSlug %>_sid',
+    refreshCookieName: '<%= nameSlug %>_rid',
+    requireEmailVerification: false,
+  },
+  payments: {
+    webhookPath: '/payments/webhook/:provider',
+    currency: 'INR',
+    razorpay: { enabled: false, sandbox: true },
+    paypal:   { enabled: false, sandbox: true },
+  },
+  email: { provider: 'log', from: 'no-reply@<%= nameSlug %>.local' },
+  certs: { dir: 'certs', keyType: 'rsa', rsaModulus: 2048, ecCurve: 'prime256v1', validityDays: 365 },
+  ads: { enabled: false, developerToken: '', clientId: '', clientSecret: '', refreshToken: '', customerId: '' },
+  webrtc: { rtcMinPort: 40000, rtcMaxPort: 40100, announceIp: '127.0.0.1' },
+  ai: {
+    serverUrl: `http://localhost:${process.env.AI_PORT ?? <%= aiPort %>}`,
+    timeoutMs: 60_000,
+    defaultProvider: 'auto',
+    schemaModel: 'llama3:latest',
+  },
+  logging: { level: 'info', format: 'pretty', console: true, dir: 'logs', maxFileSize: 10 * 1024 * 1024, maxFiles: 7 },
+  plugins: { dir: 'plugins', entries: [] },
+  frontend: { port: <%= frontendPort %>, host: 'localhost', enabled: true },
+  admin:    { port: <%= adminPort %>, host: 'localhost', enabled: true },
+};
+export default config;

package/templates/base/package.json.ejs ADDED Viewed

@@ -0,0 +1,40 @@
+{
+  "name": "<%= nameSlug %>",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "workspaces": [
+    "apps/*"
+  ],
+  "scripts": {
+    "dev": "nexus dev",
+    "build": "nexus build",
+    "test": "nexus test",
+    "doctor": "nexus doctor",
+    "down": "nexus down",
+    "up": "nexus up"
+  },
+  "dependencies": {
+    "@bhooai/nexus-core": "^2.0.0",
+    "@bhooai/nexus-auth": "^2.0.0",
+    "@bhooai/nexus-data": "^2.0.0",
+    "@bhooai/nexus-cache": "^2.0.0",
+    "@bhooai/nexus-realtime": "^2.0.0",
+    "@bhooai/nexus-payments": "^2.0.0",
+    "@bhooai/nexus-email": "^2.0.0",
+    "@bhooai/nexus-ai-client": "^2.0.0",
+    "@bhooai/nexus-graphql": "^2.0.0",
+    "@bhooai/nexus-telemetry": "^2.0.0",
+    "tsx": "^4.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.5.0",
+    "typescript": "^5.6.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "vite": "^5.4.10",
+    "tailwindcss": "^3.4.14"
+  }
+}

package/templates/{tsconfig.json → base/tsconfig.json} RENAMED Viewed

@@ -10,8 +10,7 @@
     "skipLibCheck": true,
     "resolveJsonModule": true,
     "allowImportingTsExtensions": true,
-    "noEmit": true,
-    "types": ["node"]
+    "noEmit": true
   },
   "include": ["apps/**/*", "nexus.config.ts"]
-}
+}

package/tsconfig.json CHANGED Viewed

@@ -1,9 +1,10 @@
 {
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
-    "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "dist",
+    "rootDir": "src",
+    "composite": false
   },
   "include": ["src/**/*"],
-  "references": [{ "path": "../nexus-core" }]
-}
+  "exclude": ["dist/**", "node_modules/**"]
+}

package/PLAN.md DELETED Viewed

@@ -1,141 +0,0 @@
-# Plan: `nexus init` — all-in-one setup wizard
-## Goal
-Turn `nexus init` into a single interactive command that, when it finishes, leaves a
-fully bootable stack: Node backend, frontend, admin, Python AI server, Mongo + Redis
-wired, JWT secret, AI provider keys, and the cluster token. After running it once,
-`npm run dev` starts everything.
-## Current state (source of truth)
-`nexus init` (`packages/nexus-cli/src/commands/init.ts`) today:
-1. Scaffolds templates (`listFiles(TEMPLATES)` -> write each)
-2. `wireFrameworkDependency()` — workspace paths + `file:` dep + Vite/Tailwind patching
-3. `allocateProjectPorts()` — auto-pick free ports for server/frontend/admin/ai/lb/agent
-4. `ensureJwtSecret()` — generate `NEXUS_AUTH_JWT_SECRET`, add empty AI/payment env keys
-5. `chooseKind()` — interactive root/node prompt (the only wizard step today)
-6. `applyClusterConfig()` — write cluster section into `nexus.config.ts`
-7. `installDependencies()` — `npm install`
-8. `printSetup()` — onboarding text
-Gaps that prevent "everything at once":
-- Python deps never installed (separate `nexus pysetup` command, forgotten by users)
-- No Mongo/Redis reachability check before scaffolding -> silent failures at `npm run dev`
-- No way to customize DB URI / Redis URL / AI provider keys during init (empty placeholders only)
-- No final verification that the scaffolded project actually loads
-- `.env` doesn't get `MONGODB_URI`/`REDIS_URL` (Python AI server can't connect)
-`pysetup.ts` is non-interactive (one-shot pip install). `doctor.ts` has reusable check
-logic (`tcpReachable`, `versionOf`, `parseHostPort`) but it's a monolithic `doctor()`
-function, not exported helpers.
-## Wizard flow (interactive when stdin is a TTY; flag-driven otherwise)
-```
-nexus init [target] [--as=root|node] [--no-interactive] [--no-venv] [--no-install] [--skip-mongo-check]
-```
-| # | Step | Interactive prompt | Non-interactive fallback |
-|---|------|--------------------|--------------------------|
-| 0 | Banner — "BhooAI Nexus — project setup wizard" + what it'll do | shown | shown |
-| 1 | Prerequisite scan — detect node, npm, python, git, Mongo TCP, Redis TCP. Blocks on missing node/python (critical); warns on missing Mongo/Redis (asks to continue) | shown, "Continue anyway?" if Mongo/Redis down | `--skip-mongo-check` skips; missing node/python -> exit 1 |
-| 2 | Project name -> `package.json` name + Mongo db name | prompt, default = dir basename | `--name <x>` or dir basename |
-| 3 | Server kind root/node (existing `chooseKind`) | prompt | `--as=root\|node` |
-| 4 | Cluster role + port (if node) | prompt role, default `backend` | `--role` `--port` |
-| 5 | Ports — auto-allocate (existing) OR custom | "Auto-allocate free ports? Y/n" | auto (existing) |
-| 6 | Mongo URI — confirm or edit, DB name from step 2 | prompt, default `mongodb://localhost:27017/<name>` | `--mongo-uri` |
-| 7 | Redis URL — confirm or edit | prompt, default `redis://localhost:6379` | `--redis-url` |
-| 8 | AI providers — multi-select (openai/ollama/anthropic/google/groq/...), then enter API key for each selected (written to `.env`). Ollama/lmstudio need no key. | multi-select + per-key prompt | `--ai-providers openai,ollama` (keys via env or `--ai-key <id>=<val>`) |
-| 9 | Python venv — "Create a virtualenv for the AI server? Y/n" | prompt | `--no-venv` skips; `--venv` forces |
-| 10 | Review summary — table of all chosen values; "Proceed? Y/n" | shown | proceeds |
-| 11 | Scaffold templates (existing) | — | — |
-| 12 | Wire framework (existing) | — | — |
-| 13 | Allocate ports (existing) | — | — |
-| 14 | Write config — patch `nexus.config.ts` with chosen Mongo URI / Redis URL / AI serverUrl + `applyClusterConfig` (existing) | — | — |
-| 15 | Generate `.env` — JWT secret (existing) + `MONGODB_URI` + `REDIS_URL` + AI provider keys from step 8 + cluster token + payment placeholders (existing) | — | — |
-| 16 | npm install (existing) | — | — |
-| 17 | Python setup — invoke `pysetup(['--venv'\|--no-venv])` -> creates `apps/ai-server/.venv` + `pip install -r requirements.txt` | — | — |
-| 18 | Verify — run an in-process mini-doctor on the new project: load `nexus.config.ts`, TCP-check Mongo/Redis, check backend/frontend/admin/ai ports free, sign+verify a JWT. Print pass/fail table. | — | — |
-| 19 | Next steps — print URLs (backend `:port/health`, frontend, admin, ai `127.0.0.1:port`), pairing token, and `npm run dev` | shown | shown |
-## Files to change (8)
-### Framework — CLI
-1. **`packages/nexus-cli/src/wizard.ts`** (NEW) — shared wizard primitives used by `init`
-   and `pysetup`:
-   - `isInteractive()` — `process.stdin.isTTY && !process.env.CI`
-   - `prompt(q, default?)`, `confirm(q, default?)`, `select(q, options)`, `multiSelect(q, options)`
-   - `banner(title, lines)`, `summaryTable(rows)`, `statusIcon(ok)`
-   - Built on `node:readline/promises` (already used by `chooseKind`)
-   - No new deps
-2. **`packages/nexus-cli/src/commands/init.ts`** (rewrite) — orchestrate the 20-step flow
-   above. Keep existing helpers (`wireFrameworkDependency`, `allocateProjectPorts`,
-   `ensureJwtSecret`, `applyClusterConfig`, `installDependencies`, `printSetup`); insert
-   prerequisite scan, prompts (steps 2/6/7/8/9), review, pysetup call, verify. Extract
-   `ensureJwtSecret`'s env-key writing into a reusable `writeEnv(target, entries)` so the
-   new `.env` step is one call. Add flags: `--name`, `--mongo-uri`, `--redis-url`,
-   `--ai-providers`, `--ai-key`, `--venv`/`--no-venv`, `--no-interactive`,
-   `--skip-mongo-check`.
-3. **`packages/nexus-cli/src/commands/pysetup.ts`** (extend) — accept an `--interactive`
-   flag that, when set and TTY, prompts for venv y/n + python path before installing.
-   Expose `pysetup(args)` so `init` can call it programmatically (already exported). No
-   behavior change for direct `nexus pysetup` invocation unless `--interactive` passed.
-4. **`packages/nexus-cli/src/commands/doctor.ts`** (refactor) — extract the reusable
-   prerequisite scan into exported helpers in `util.ts` so `init` step 1 reuses them:
-   `scanRuntimes()` (node/npm/python/git versions), `scanServices(cfg)` (Mongo/Redis/AI
-   TCP + port-free checks). `doctor()` becomes a thin renderer over these. No output change.
-5. **`packages/nexus-cli/src/util.ts`** — add `scanRuntimes()`, `scanServices(cfg)`,
-   `tcpReachable` (exists), `versionOf` (exists). Move the runtime + service check logic
-   out of `doctor.ts` so both `doctor` and `init` share one implementation.
-6. **`packages/nexus-cli/src/index.ts`** — update `init` help line to list new flags; no
-   dispatch change (init already wired at `index.ts:20`).
-### Framework — templates
-7. **`packages/nexus-cli/templates/package.json`** — add `"pysetup": "nexus pysetup"`
-   script so users can re-run it easily. (Optional; the wizard runs it automatically.)
-8. **`packages/nexus-cli/templates/nexus.config.ts`** — no structural change, but the
-   wizard patches it at step 14 with the chosen Mongo URI / Redis URL / AI serverUrl.
-   (Patch logic lives in `init.ts`, not the template.)
-## Security / correctness invariants
-- **Python AI server binds `127.0.0.1`** — wizard writes `AI_HOST=127.0.0.1` into `.env`
-  and the template `settings.py` reads it (pairs with the `/py-server` plan; if that plan
-  hasn't run yet, the wizard still sets the env so a future `settings.py` picks it up).
-- **`.env` is the single secrets sink** — JWT secret, Mongo URI, Redis URL, AI keys,
-  cluster token all land there. `nexus.config.ts` stays clean (no secrets), matching the
-  existing precedence comment.
-- **No external exposure of Python** — only Node binds `0.0.0.0`; AI server stays
-  loopback. Wizard's verify step asserts `ai.serverUrl` host is `127.0.0.1` or `localhost`.
-- **Idempotent** — re-running `nexus init .` in an existing project updates config +
-  `.env` without clobbering secrets (existing `ensureJwtSecret` pattern preserved).
-## Verification (after execution)
-1. `nexus init test-app` (interactive) -> walk through prompts -> all 20 steps complete.
-2. `cd test-app && npm run doctor` -> all green.
-3. `cd test-app && npm run dev` -> backend, frontend, admin, AI server all start;
-   `http://localhost:<port>/health` returns ok.
-4. `nexus init test-app --no-interactive --name ci-app --mongo-uri mongodb://localhost:27017/ci-app --ai-providers ollama --venv`
-   -> fully non-interactive, exit 0.
-5. Re-run `nexus init .` inside `test-app` -> secrets preserved, config updated.
-6. Existing `cli.test.ts` (`run('init', [dir, '--skip-install'])`) still exits 0 and
-   scaffolds the four-terminal tree (non-interactive mode, no pysetup).
-## Decisions (confirmed)
-- Wizard interactivity auto-detected via TTY + `!CI`; `--no-interactive` forces flags-only.
-- Mongo/Redis down at init -> warn + "Continue anyway?" (default yes). Hard requirement
-  only for node/python.
-- AI provider keys typed inline during the wizard (hidden echo). Left blank = fill later.
-- Python venv default **yes** (deps don't pollute global site-packages).
-- `--skip-install` skips BOTH npm install and pysetup (so tests/CI don't hang on pip).
-- Plan saved here at `packages/nexus-cli/PLAN.md` (matches repo `PLAN.md` convention).

package/README.md DELETED Viewed

@@ -1,34 +0,0 @@
-# @bhooai/nexus-cli
-The `nexus` CLI: `init`, `dev`, `doctor`, and a multi-process supervisor.
-## Commands
-| command | what it does |
-| --- | --- |
-| `init [target] [--force]` | scaffold a new Nexus project from `templates/` |
-| `dev [--only a,b]` | start backend + frontend + AI + admin under the supervisor |
-| `doctor` | verify node/python versions and mongo/redis reachability (advisory) |
-| `build` / `test` / `plugin` / `add` | reserved/forwarded to the workspace tools |
-## Templates
-`templates/` holds the real project files copied by `init` — a runnable backend
-(boots `NexusServer` with the security stack + `/health`, `/csrf-token`, `/echo`),
-a React+Vite frontend, a Python FastAPI AI server, an admin shell, and the CLI
-`bin/nexus.js` shim. `init` is idempotent (skips existing files unless `--force`).
-## Supervisor
-`Supervisor` owns the four child processes, streams prefixed logs, handles
-graceful Ctrl-C, and exposes a localhost HTTP control API (start/stop/restart/
-status/logs-tail) that the admin app consumes — decoupling admin from
-OS-specific process management.
-## Usage
-```bash
-node bin/nexus.js init ./my-app
-node bin/nexus.js doctor
-node bin/nexus.js dev
-```