Add simple doctor and launcher workflow

README.md

@@ -34,10 +34,15 @@ The public pack includes registry entries for three optional Apache-2.0 models:
 
 ## Offline Use
 
-1. Serve this repository locally with `python -m http.server 4173 --bind 127.0.0.1`.
-2. Start a local OpenAI-compatible runtime for the selected model on loopback.
-3. Open `http://127.0.0.1:4173/`.
-4. Use **TEST LOCAL RUNTIME** and then **START BOUNDED REVIEW**.
+Install Node.js 20+ and run:
+
+```bash
+npm install
+npm run doctor
+npm start
+```
+
+Then open `http://127.0.0.1:4173/`. The doctor reports missing optional runtimes as warnings instead of hiding them. Import a model pack from the Model Lanes panel and use **START / TEST RUNTIME**.
 
 See `runtime/README.md` and `models/manifest.json` for the adapter contract and model configuration. AIDE does not apply model-generated patches automatically.
 

package.json

@@ -5,13 +5,15 @@
   "description": "Local-first sovereign development workbench",
   "type": "module",
   "scripts": {
-    "test": "node tests/smoke.mjs && node harness/test-orchestrator.mjs && node daemon/test-model-manager.mjs && node daemon/test-community-store.mjs && node daemon/test-lsp-manager.mjs && node daemon/test-dap-manager.mjs && node daemon/test-workspace-manager.mjs && node daemon/test-training-manager.mjs && node daemon/test-replay-store.mjs && node benchmarks/test-run.mjs && node benchmarks/test-arena.mjs && node capsules/test-create.mjs && node scripts/e2e.mjs",
+    "test": "node tests/smoke.mjs && node harness/test-orchestrator.mjs && node daemon/test-model-manager.mjs && node daemon/test-community-store.mjs && node daemon/test-lsp-manager.mjs && node daemon/test-dap-manager.mjs && node daemon/test-workspace-manager.mjs && node daemon/test-training-manager.mjs && node daemon/test-replay-store.mjs && node daemon/test-agent-policy.mjs && node benchmarks/test-run.mjs && node benchmarks/test-arena.mjs && node capsules/test-create.mjs && node scripts/e2e.mjs",
     "check": "node --check app.js && node --check daemon/server.mjs && node --check harness/orchestrator.mjs && node --check harness/checks.mjs",
     "veritas": "node harness/run-veritas.mjs",
     "benchmarks": "node benchmarks/run.mjs",
     "arena": "node benchmarks/arena.mjs",
     "e2e": "node scripts/e2e.mjs",
     "capsule": "node capsules/create.mjs",
+    "doctor": "node scripts/doctor.mjs",
+    "start": "node scripts/start.mjs",
     "desktop:dev": "tauri dev --config desktop/tauri.conf.json",
     "desktop:prepare": "node desktop/prepare.mjs",
     "desktop:build": "npm run desktop:prepare && tauri build --config desktop/tauri.conf.json"

scripts/doctor.mjs

@@ -0,0 +1,23 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+
+const root = path.resolve(process.cwd());
+const checks = [];
+const pass = (name, detail) => checks.push({ name, detail, ok: true });
+const warn = (name, detail) => checks.push({ name, detail, ok: true, warning: true });
+const fail = (name, detail) => checks.push({ name, detail, ok: false });
+
+if (Number(process.versions.node.split('.')[0]) >= 20) pass('Node.js', process.version); else fail('Node.js', 'Node 20 or newer is required');
+for (const file of ['models/manifest.json', 'community/node-manifest.json', 'training/manifest.json']) {
+  try { JSON.parse(await fs.readFile(path.join(root, file), 'utf8')); pass(file, 'valid JSON'); } catch { fail(file, 'missing or invalid JSON'); }
+}
+try { await fs.access(path.join(root, 'daemon/server.mjs')); pass('Local daemon', 'available'); } catch { fail('Local daemon', 'daemon/server.mjs missing'); }
+try { await fs.access(process.env.AIDE_LLAMA_SERVER || '/root/runtime/llama-b10333/llama-server'); pass('llama.cpp', 'runtime binary found'); } catch { warn('llama.cpp', 'install a local llama-server runtime before starting models'); }
+const manifest = JSON.parse(await fs.readFile(path.join(root, 'models/manifest.json'), 'utf8'));
+const ready = manifest.models.filter(model => model.status === 'ready').length;
+if (ready) pass('Model packs', `${ready} ready pack(s)`); else warn('Model packs', 'import at least one model pack');
+console.log('\nAIDE Doctor\n');
+for (const check of checks) console.log(`${check.ok ? (check.warning ? 'WARN' : 'OK') : 'FAIL'}  ${check.name}: ${check.detail}`);
+const failures = checks.filter(check => !check.ok).length;
+console.log(`\n${failures ? 'Preflight failed' : 'Preflight passed'}: ${checks.length - failures}/${checks.length} checks\n`);
+if (failures) process.exitCode = 1;

scripts/start.mjs

@@ -0,0 +1,22 @@
+import http from 'node:http';
+import { createReadStream } from 'node:fs';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const port = Number(process.env.AIDE_UI_PORT || 4173);
+const daemon = spawn(process.execPath, ['daemon/server.mjs'], { cwd: root, env: { ...process.env, AIDE_WORKSPACE: root }, stdio: 'inherit' });
+const types = { '.html': 'text/html', '.js': 'text/javascript', '.css': 'text/css', '.json': 'application/json', '.md': 'text/plain' };
+const server = http.createServer(async (request, response) => {
+  const requested = decodeURIComponent((request.url || '/').split('?')[0]);
+  const relative = requested === '/' ? 'index.html' : requested.replace(/^\//, '');
+  const file = path.resolve(root, relative);
+  if (!file.startsWith(`${root}${path.sep}`)) return response.writeHead(403).end();
+  try { await fs.access(file); response.writeHead(200, { 'Content-Type': types[path.extname(file)] || 'application/octet-stream' }); createReadStream(file).pipe(response); }
+  catch { response.writeHead(404).end('Not found'); }
+});
+server.listen(port, '127.0.0.1', () => console.log(`AIDE running at http://127.0.0.1:${port}`));
+const stop = () => { server.close(); daemon.kill('SIGTERM'); };
+process.on('SIGINT', stop); process.on('SIGTERM', stop); daemon.on('exit', code => { if (code && code !== 143) console.error(`daemon exited with ${code}`); });