@neat.is/core 0.2.10 → 0.3.1

package/dist/neatd.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   startDaemon
-} from "./chunk-5BQWBQJR.js";
+} from "./chunk-66Z5IEFY.js";
 import {
   listProjects,
   registryPath
-} from "./chunk-JMLZOKCS.js";
+} from "./chunk-FIXKIYNF.js";
 import {
   __require
-} from "./chunk-DGUM43GV.js";
+} from "./chunk-4ASCXBZF.js";
 
 // src/neatd.ts
 import { promises as fs } from "fs";
@@ -123,6 +123,8 @@ async function cmdStart() {
   const handle = await startDaemon();
   console.log(`neatd: started, PID ${process.pid}, ${handle.slots.size} project(s)`);
   console.log(`neatd: registry at ${registryPath()}`);
+  if (handle.restAddress) console.log(`neatd: REST  \u2192 ${handle.restAddress}`);
+  if (handle.otlpAddress) console.log(`neatd: OTLP  \u2192 ${handle.otlpAddress}`);
   const skipWeb = process.env.NEAT_WEB_DISABLED === "1";
   let web = null;
   if (!skipWeb) {

package/dist/neatd.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/neatd.ts","../src/web-spawn.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `neatd` — distribution-layer daemon CLI (ADR-049).\n *\n * Subcommands:\n *   neatd start [--foreground]    boot the daemon and watch the registry\n *   neatd stop                    signal the running daemon to shut down\n *   neatd reload                  signal the running daemon to re-read the registry\n *   neatd status                  print PID + per-project last-seen timestamps\n *\n * MVP runs in foreground only. Backgrounding is the supervisor's job\n * (launchd / systemd / nohup) — `neatd start` blocks until SIGINT/SIGTERM.\n *\n * v0.2.10: also brings up the web UI on port 6328 by default (ADR-059).\n */\n\nimport { promises as fs } from 'node:fs'\nimport path from 'node:path'\nimport { startDaemon } from './daemon.js'\nimport { listProjects, registryPath } from './registry.js'\nimport { spawnWebUI, DEFAULT_WEB_PORT, type WebHandle } from './web-spawn.js'\n\nfunction neatHome(): string {\n  if (process.env.NEAT_HOME && process.env.NEAT_HOME.length > 0) {\n    return path.resolve(process.env.NEAT_HOME)\n  }\n  const home = process.env.HOME ?? process.env.USERPROFILE ?? ''\n  return path.join(home, '.neat')\n}\n\nasync function readPid(): Promise<number | null> {\n  try {\n    const raw = await fs.readFile(path.join(neatHome(), 'neatd.pid'), 'utf8')\n    const n = Number.parseInt(raw.trim(), 10)\n    return Number.isFinite(n) ? n : null\n  } catch {\n    return null\n  }\n}\n\nfunction usage(): void {\n  console.log('usage: neatd <start|stop|reload|status> [--foreground]')\n}\n\nfunction restPortFromEnv(): number {\n  const raw = process.env.PORT\n  return raw && raw.length > 0 ? Number.parseInt(raw, 10) : 8080\n}\n\nasync function cmdStart(): Promise<void> {\n  const handle = await startDaemon()\n  console.log(`neatd: started, PID ${process.pid}, ${handle.slots.size} project(s)`)\n  console.log(`neatd: registry at ${registryPath()}`)\n\n  // ADR-059 — bring up the web UI alongside the daemon. Failure here aborts\n  // start with the clear-error pattern from ADR-049 instead of silently\n  // running headless.\n  const skipWeb = process.env.NEAT_WEB_DISABLED === '1'\n  let web: WebHandle | null = null\n  if (!skipWeb) {\n    try {\n      web = await spawnWebUI(restPortFromEnv())\n    } catch (err) {\n      console.error((err as Error).message)\n      await handle.stop().catch(() => {})\n      process.exit(3)\n    }\n  } else {\n    console.log('neatd: web UI disabled (NEAT_WEB_DISABLED=1)')\n  }\n\n  console.log('neatd: SIGHUP reloads, SIGTERM/SIGINT stops')\n\n  let stopping = false\n  const shutdown = (signal: NodeJS.Signals): void => {\n    if (stopping) return\n    stopping = true\n    console.log(`neatd: ${signal} received, stopping…`)\n    void Promise.allSettled([handle.stop(), web ? web.stop() : Promise.resolve()])\n      .catch((err) => console.error(`neatd: shutdown error — ${(err as Error).message}`))\n      .finally(() => process.exit(0))\n  }\n  process.on('SIGTERM', shutdown)\n  process.on('SIGINT', shutdown)\n\n  // Block forever — supervisors keep us in the foreground.\n  await new Promise<void>(() => {})\n}\n\nasync function cmdStop(): Promise<void> {\n  const pid = await readPid()\n  if (pid === null) {\n    console.error('neatd: no running daemon found (no PID file)')\n    process.exit(1)\n  }\n  try {\n    process.kill(pid, 'SIGTERM')\n    console.log(`neatd: SIGTERM sent to PID ${pid}`)\n  } catch (err) {\n    console.error(`neatd: failed to signal PID ${pid} — ${(err as Error).message}`)\n    process.exit(1)\n  }\n}\n\nasync function cmdReload(): Promise<void> {\n  const pid = await readPid()\n  if (pid === null) {\n    console.error('neatd: no running daemon found (no PID file)')\n    process.exit(1)\n  }\n  try {\n    process.kill(pid, 'SIGHUP')\n    console.log(`neatd: SIGHUP sent to PID ${pid}`)\n  } catch (err) {\n    console.error(`neatd: failed to signal PID ${pid} — ${(err as Error).message}`)\n    process.exit(1)\n  }\n}\n\nasync function cmdStatus(): Promise<void> {\n  const pid = await readPid()\n  console.log(`pid:      ${pid ?? '(not running)'}`)\n  console.log(`registry: ${registryPath()}`)\n  const webPort = process.env.NEAT_WEB_PORT\n    ? Number.parseInt(process.env.NEAT_WEB_PORT, 10)\n    : DEFAULT_WEB_PORT\n  console.log(`web ui:   http://localhost:${webPort}`)\n  const projects = await listProjects().catch(() => [])\n  if (projects.length === 0) {\n    console.log('projects: (none)')\n    return\n  }\n  console.log('projects:')\n  for (const p of projects) {\n    const seen = p.lastSeenAt ?? 'never'\n    console.log(`  ${p.name}\\t${p.status}\\t${p.path}\\tlast-seen=${seen}`)\n  }\n}\n\nasync function main(): Promise<void> {\n  const cmd = process.argv[2]\n  if (!cmd || cmd === '-h' || cmd === '--help') {\n    usage()\n    process.exit(cmd ? 0 : 2)\n  }\n\n  if (cmd === 'start') return cmdStart()\n  if (cmd === 'stop') return cmdStop()\n  if (cmd === 'reload') return cmdReload()\n  if (cmd === 'status') return cmdStatus()\n\n  console.error(`neatd: unknown command \"${cmd}\"`)\n  usage()\n  process.exit(1)\n}\n\nconst entry = process.argv[1] ?? ''\nif (/[\\\\/]neatd\\.(?:cjs|js)$/.test(entry) || entry.endsWith('/neatd')) {\n  main().catch((err) => {\n    console.error(err)\n    process.exit(1)\n  })\n}\n","/**\n * Web UI spawn helper (ADR-059).\n *\n * `neatd start` brings up the REST API + OTel receivers, then calls\n * `spawnWebUI(restPort)` to launch the Next.js web shell as a child process.\n * Lifecycle is parent-tied: SIGTERM/SIGINT on neatd cascades to the child\n * via `stop()`.\n *\n * Default port `6328` (NEAT in T9). Override with `NEAT_WEB_PORT`.\n * Hard-fails on collision so the operator never loses track of which URL to\n * open.\n */\n\nimport { spawn, type ChildProcess } from 'node:child_process'\nimport net from 'node:net'\nimport path from 'node:path'\n\nexport const DEFAULT_WEB_PORT = 6328\n\nexport interface WebHandle {\n  child: ChildProcess\n  port: number\n  stop: () => Promise<void>\n}\n\n/**\n * Best-effort port collision check before spawning. Binds, closes, returns.\n * Race condition between the check and the actual `next start` is acceptable\n * — Next.js will then fail loudly and the parent exits.\n */\nasync function assertPortFree(port: number): Promise<void> {\n  await new Promise<void>((resolve, reject) => {\n    const tester = net.createServer()\n    tester.once('error', (err: NodeJS.ErrnoException) => {\n      if (err.code === 'EADDRINUSE') {\n        reject(\n          new Error(\n            `neatd: web UI port ${port} in use; set NEAT_WEB_PORT to override or stop the conflicting process`,\n          ),\n        )\n      } else {\n        reject(err)\n      }\n    })\n    tester.once('listening', () => {\n      tester.close(() => resolve())\n    })\n    tester.listen(port, '127.0.0.1')\n  })\n}\n\n/**\n * Resolve the web package directory. In a global install\n * (`npm install -g neat.is`) the package lives at\n * `node_modules/@neat.is/web/`; in the monorepo it's\n * `packages/web/`. `require.resolve` finds whichever one Node has on its\n * search path.\n */\nfunction resolveWebPackageDir(): string {\n  const req = (typeof require !== 'undefined'\n    ? require\n    : // ESM fallback — daemon CJS bundle has `require`, but typecheck wants this\n      (eval('require') as NodeRequire))\n  const pkgJsonPath = req.resolve('@neat.is/web/package.json')\n  return path.dirname(pkgJsonPath)\n}\n\nexport async function spawnWebUI(restPort: number): Promise<WebHandle> {\n  const portRaw = process.env.NEAT_WEB_PORT\n  const port = portRaw && portRaw.length > 0 ? Number.parseInt(portRaw, 10) : DEFAULT_WEB_PORT\n  if (!Number.isFinite(port) || port <= 0 || port > 65535) {\n    throw new Error(`neatd: invalid NEAT_WEB_PORT=\"${portRaw}\"`)\n  }\n\n  await assertPortFree(port)\n\n  const cwd = resolveWebPackageDir()\n  // ADR-059 #6 — child inherits NEAT_API_URL pointing at our REST server,\n  // unless the operator pre-configured it.\n  const env: NodeJS.ProcessEnv = {\n    ...process.env,\n    PORT: String(port),\n    NEAT_API_URL: process.env.NEAT_API_URL ?? `http://localhost:${restPort}`,\n  }\n\n  // `npm exec next start` works under both monorepo and global install.\n  // `detached: false` keeps the child in our process group so signals reach it.\n  const child = spawn('npm', ['exec', '--', 'next', 'start', '-p', String(port)], {\n    cwd,\n    env,\n    stdio: ['ignore', 'inherit', 'inherit'],\n    detached: false,\n  })\n\n  child.on('error', (err) => {\n    console.error(`neatd: web UI spawn error — ${err.message}`)\n  })\n\n  console.log(`neatd: web UI listening on http://localhost:${port}`)\n\n  let stopped = false\n  async function stop(): Promise<void> {\n    if (stopped || !child.pid) return\n    stopped = true\n    try {\n      child.kill('SIGTERM')\n    } catch {\n      /* already gone */\n    }\n    // Give the child up to 3s to exit gracefully, then SIGKILL.\n    await new Promise<void>((resolve) => {\n      const t = setTimeout(() => {\n        try {\n          child.kill('SIGKILL')\n        } catch {\n          /* gone */\n        }\n        resolve()\n      }, 3000)\n      child.once('exit', () => {\n        clearTimeout(t)\n        resolve()\n      })\n    })\n  }\n\n  return { child, port, stop }\n}\n"],"mappings":"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","names":["path","path"]}
+{"version":3,"sources":["../src/neatd.ts","../src/web-spawn.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `neatd` — distribution-layer daemon CLI (ADR-049).\n *\n * Subcommands:\n *   neatd start [--foreground]    boot the daemon and watch the registry\n *   neatd stop                    signal the running daemon to shut down\n *   neatd reload                  signal the running daemon to re-read the registry\n *   neatd status                  print PID + per-project last-seen timestamps\n *\n * MVP runs in foreground only. Backgrounding is the supervisor's job\n * (launchd / systemd / nohup) — `neatd start` blocks until SIGINT/SIGTERM.\n *\n * v0.2.10: also brings up the web UI on port 6328 by default (ADR-059).\n */\n\nimport { promises as fs } from 'node:fs'\nimport path from 'node:path'\nimport { startDaemon } from './daemon.js'\nimport { listProjects, registryPath } from './registry.js'\nimport { spawnWebUI, DEFAULT_WEB_PORT, type WebHandle } from './web-spawn.js'\n\nfunction neatHome(): string {\n  if (process.env.NEAT_HOME && process.env.NEAT_HOME.length > 0) {\n    return path.resolve(process.env.NEAT_HOME)\n  }\n  const home = process.env.HOME ?? process.env.USERPROFILE ?? ''\n  return path.join(home, '.neat')\n}\n\nasync function readPid(): Promise<number | null> {\n  try {\n    const raw = await fs.readFile(path.join(neatHome(), 'neatd.pid'), 'utf8')\n    const n = Number.parseInt(raw.trim(), 10)\n    return Number.isFinite(n) ? n : null\n  } catch {\n    return null\n  }\n}\n\nfunction usage(): void {\n  console.log('usage: neatd <start|stop|reload|status> [--foreground]')\n}\n\nfunction restPortFromEnv(): number {\n  const raw = process.env.PORT\n  return raw && raw.length > 0 ? Number.parseInt(raw, 10) : 8080\n}\n\nasync function cmdStart(): Promise<void> {\n  const handle = await startDaemon()\n  console.log(`neatd: started, PID ${process.pid}, ${handle.slots.size} project(s)`)\n  console.log(`neatd: registry at ${registryPath()}`)\n  // ADR-063 — surface the bound addresses so the operator can sanity-check\n  // the documented happy path without grepping startup logs.\n  if (handle.restAddress) console.log(`neatd: REST  → ${handle.restAddress}`)\n  if (handle.otlpAddress) console.log(`neatd: OTLP  → ${handle.otlpAddress}`)\n\n  // ADR-059 — bring up the web UI alongside the daemon. Failure here aborts\n  // start with the clear-error pattern from ADR-049 instead of silently\n  // running headless.\n  const skipWeb = process.env.NEAT_WEB_DISABLED === '1'\n  let web: WebHandle | null = null\n  if (!skipWeb) {\n    try {\n      web = await spawnWebUI(restPortFromEnv())\n    } catch (err) {\n      console.error((err as Error).message)\n      await handle.stop().catch(() => {})\n      process.exit(3)\n    }\n  } else {\n    console.log('neatd: web UI disabled (NEAT_WEB_DISABLED=1)')\n  }\n\n  console.log('neatd: SIGHUP reloads, SIGTERM/SIGINT stops')\n\n  let stopping = false\n  const shutdown = (signal: NodeJS.Signals): void => {\n    if (stopping) return\n    stopping = true\n    console.log(`neatd: ${signal} received, stopping…`)\n    void Promise.allSettled([handle.stop(), web ? web.stop() : Promise.resolve()])\n      .catch((err) => console.error(`neatd: shutdown error — ${(err as Error).message}`))\n      .finally(() => process.exit(0))\n  }\n  process.on('SIGTERM', shutdown)\n  process.on('SIGINT', shutdown)\n\n  // Block forever — supervisors keep us in the foreground.\n  await new Promise<void>(() => {})\n}\n\nasync function cmdStop(): Promise<void> {\n  const pid = await readPid()\n  if (pid === null) {\n    console.error('neatd: no running daemon found (no PID file)')\n    process.exit(1)\n  }\n  try {\n    process.kill(pid, 'SIGTERM')\n    console.log(`neatd: SIGTERM sent to PID ${pid}`)\n  } catch (err) {\n    console.error(`neatd: failed to signal PID ${pid} — ${(err as Error).message}`)\n    process.exit(1)\n  }\n}\n\nasync function cmdReload(): Promise<void> {\n  const pid = await readPid()\n  if (pid === null) {\n    console.error('neatd: no running daemon found (no PID file)')\n    process.exit(1)\n  }\n  try {\n    process.kill(pid, 'SIGHUP')\n    console.log(`neatd: SIGHUP sent to PID ${pid}`)\n  } catch (err) {\n    console.error(`neatd: failed to signal PID ${pid} — ${(err as Error).message}`)\n    process.exit(1)\n  }\n}\n\nasync function cmdStatus(): Promise<void> {\n  const pid = await readPid()\n  console.log(`pid:      ${pid ?? '(not running)'}`)\n  console.log(`registry: ${registryPath()}`)\n  const webPort = process.env.NEAT_WEB_PORT\n    ? Number.parseInt(process.env.NEAT_WEB_PORT, 10)\n    : DEFAULT_WEB_PORT\n  console.log(`web ui:   http://localhost:${webPort}`)\n  const projects = await listProjects().catch(() => [])\n  if (projects.length === 0) {\n    console.log('projects: (none)')\n    return\n  }\n  console.log('projects:')\n  for (const p of projects) {\n    const seen = p.lastSeenAt ?? 'never'\n    console.log(`  ${p.name}\\t${p.status}\\t${p.path}\\tlast-seen=${seen}`)\n  }\n}\n\nasync function main(): Promise<void> {\n  const cmd = process.argv[2]\n  if (!cmd || cmd === '-h' || cmd === '--help') {\n    usage()\n    process.exit(cmd ? 0 : 2)\n  }\n\n  if (cmd === 'start') return cmdStart()\n  if (cmd === 'stop') return cmdStop()\n  if (cmd === 'reload') return cmdReload()\n  if (cmd === 'status') return cmdStatus()\n\n  console.error(`neatd: unknown command \"${cmd}\"`)\n  usage()\n  process.exit(1)\n}\n\nconst entry = process.argv[1] ?? ''\nif (/[\\\\/]neatd\\.(?:cjs|js)$/.test(entry) || entry.endsWith('/neatd')) {\n  main().catch((err) => {\n    console.error(err)\n    process.exit(1)\n  })\n}\n","/**\n * Web UI spawn helper (ADR-059).\n *\n * `neatd start` brings up the REST API + OTel receivers, then calls\n * `spawnWebUI(restPort)` to launch the Next.js web shell as a child process.\n * Lifecycle is parent-tied: SIGTERM/SIGINT on neatd cascades to the child\n * via `stop()`.\n *\n * Default port `6328` (NEAT in T9). Override with `NEAT_WEB_PORT`.\n * Hard-fails on collision so the operator never loses track of which URL to\n * open.\n */\n\nimport { spawn, type ChildProcess } from 'node:child_process'\nimport net from 'node:net'\nimport path from 'node:path'\n\nexport const DEFAULT_WEB_PORT = 6328\n\nexport interface WebHandle {\n  child: ChildProcess\n  port: number\n  stop: () => Promise<void>\n}\n\n/**\n * Best-effort port collision check before spawning. Binds, closes, returns.\n * Race condition between the check and the actual `next start` is acceptable\n * — Next.js will then fail loudly and the parent exits.\n */\nasync function assertPortFree(port: number): Promise<void> {\n  await new Promise<void>((resolve, reject) => {\n    const tester = net.createServer()\n    tester.once('error', (err: NodeJS.ErrnoException) => {\n      if (err.code === 'EADDRINUSE') {\n        reject(\n          new Error(\n            `neatd: web UI port ${port} in use; set NEAT_WEB_PORT to override or stop the conflicting process`,\n          ),\n        )\n      } else {\n        reject(err)\n      }\n    })\n    tester.once('listening', () => {\n      tester.close(() => resolve())\n    })\n    tester.listen(port, '127.0.0.1')\n  })\n}\n\n/**\n * Resolve the web package directory. In a global install\n * (`npm install -g neat.is`) the package lives at\n * `node_modules/@neat.is/web/`; in the monorepo it's\n * `packages/web/`. `require.resolve` finds whichever one Node has on its\n * search path.\n */\nfunction resolveWebPackageDir(): string {\n  const req = (typeof require !== 'undefined'\n    ? require\n    : // ESM fallback — daemon CJS bundle has `require`, but typecheck wants this\n      (eval('require') as NodeRequire))\n  const pkgJsonPath = req.resolve('@neat.is/web/package.json')\n  return path.dirname(pkgJsonPath)\n}\n\nexport async function spawnWebUI(restPort: number): Promise<WebHandle> {\n  const portRaw = process.env.NEAT_WEB_PORT\n  const port = portRaw && portRaw.length > 0 ? Number.parseInt(portRaw, 10) : DEFAULT_WEB_PORT\n  if (!Number.isFinite(port) || port <= 0 || port > 65535) {\n    throw new Error(`neatd: invalid NEAT_WEB_PORT=\"${portRaw}\"`)\n  }\n\n  await assertPortFree(port)\n\n  const cwd = resolveWebPackageDir()\n  // ADR-059 #6 — child inherits NEAT_API_URL pointing at our REST server,\n  // unless the operator pre-configured it.\n  const env: NodeJS.ProcessEnv = {\n    ...process.env,\n    PORT: String(port),\n    NEAT_API_URL: process.env.NEAT_API_URL ?? `http://localhost:${restPort}`,\n  }\n\n  // `npm exec next start` works under both monorepo and global install.\n  // `detached: false` keeps the child in our process group so signals reach it.\n  const child = spawn('npm', ['exec', '--', 'next', 'start', '-p', String(port)], {\n    cwd,\n    env,\n    stdio: ['ignore', 'inherit', 'inherit'],\n    detached: false,\n  })\n\n  child.on('error', (err) => {\n    console.error(`neatd: web UI spawn error — ${err.message}`)\n  })\n\n  console.log(`neatd: web UI listening on http://localhost:${port}`)\n\n  let stopped = false\n  async function stop(): Promise<void> {\n    if (stopped || !child.pid) return\n    stopped = true\n    try {\n      child.kill('SIGTERM')\n    } catch {\n      /* already gone */\n    }\n    // Give the child up to 3s to exit gracefully, then SIGKILL.\n    await new Promise<void>((resolve) => {\n      const t = setTimeout(() => {\n        try {\n          child.kill('SIGKILL')\n        } catch {\n          /* gone */\n        }\n        resolve()\n      }, 3000)\n      child.once('exit', () => {\n        clearTimeout(t)\n        resolve()\n      })\n    })\n  }\n\n  return { child, port, stop }\n}\n"],"mappings":"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","names":["path","path"]}

package/dist/{otel-grpc-USFL3OI3.js → otel-grpc-J4O2SIBZ.js}

@@ -1,10 +1,10 @@
 import {
   reshapeGrpcRequest,
   startOtelGrpcReceiver
-} from "./chunk-QYUB3FQL.js";
-import "./chunk-DGUM43GV.js";
+} from "./chunk-G3PDTGOW.js";
+import "./chunk-4ASCXBZF.js";
 export {
   reshapeGrpcRequest,
   startOtelGrpcReceiver
 };
-//# sourceMappingURL=otel-grpc-USFL3OI3.js.map
+//# sourceMappingURL=otel-grpc-J4O2SIBZ.js.map

package/dist/server.cjs

@@ -4126,6 +4126,10 @@ async function readRegistry() {
   const parsed = JSON.parse(raw);
   return import_types19.RegistryFileSchema.parse(parsed);
 }
+async function getProject(name) {
+  const reg = await readRegistry();
+  return reg.projects.find((p) => p.name === name);
+}
 async function listProjects() {
   const reg = await readRegistry();
   return reg.projects;
@@ -4242,9 +4246,15 @@ function registerRoutes(scope, ctx) {
   scope.get("/health", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
     if (!proj) return;
+    const uptimeMs = Date.now() - startedAt;
     return {
-      uptime: Math.floor((Date.now() - startedAt) / 1e3),
+      ok: true,
       project: proj.name,
+      uptimeMs,
+      // Legacy fields kept additively. The web shell's StatusBar reads
+      // nodeCount / edgeCount; ADR-061's HealthResponseSchema validates
+      // the canonical triple and lets the extras pass through.
+      uptime: Math.floor(uptimeMs / 1e3),
       nodeCount: proj.graph.order,
       edgeCount: proj.graph.size,
       lastUpdated: (/* @__PURE__ */ new Date()).toISOString()
@@ -4264,7 +4274,7 @@ function registerRoutes(scope, ctx) {
       if (!proj.graph.hasNode(id)) {
         return reply.code(404).send({ error: "node not found", id });
       }
-      return proj.graph.getNodeAttributes(id);
+      return { node: proj.graph.getNodeAttributes(id) };
     }
   );
   scope.get(
@@ -4281,12 +4291,12 @@ function registerRoutes(scope, ctx) {
       return { inbound, outbound };
     }
   );
-  scope.get("/graph/node/:id/dependencies", async (req, reply) => {
+  scope.get("/graph/dependencies/:nodeId", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
     if (!proj) return;
-    const { id } = req.params;
-    if (!proj.graph.hasNode(id)) {
-      return reply.code(404).send({ error: "node not found", id });
+    const { nodeId } = req.params;
+    if (!proj.graph.hasNode(nodeId)) {
+      return reply.code(404).send({ error: "node not found", id: nodeId });
     }
     const depth = req.query.depth ? Number(req.query.depth) : TRANSITIVE_DEPENDENCIES_DEFAULT_DEPTH;
     if (!Number.isFinite(depth) || depth < 1 || depth > TRANSITIVE_DEPENDENCIES_MAX_DEPTH) {
@@ -4294,7 +4304,7 @@ function registerRoutes(scope, ctx) {
         error: `depth must be an integer in [1, ${TRANSITIVE_DEPENDENCIES_MAX_DEPTH}]`
       });
     }
-    return getTransitiveDependencies(proj.graph, id, depth);
+    return getTransitiveDependencies(proj.graph, nodeId, depth);
   });
   scope.get("/graph/divergences", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
@@ -4335,19 +4345,26 @@ function registerRoutes(scope, ctx) {
     const proj = resolveProject(registry, req, reply);
     if (!proj) return;
     const epath = errorsPathFor(proj);
-    if (!epath) return [];
-    return readErrorEvents(epath);
+    if (!epath) return { count: 0, total: 0, events: [] };
+    const events = await readErrorEvents(epath);
+    const total = events.length;
+    const limit = req.query.limit ? Number(req.query.limit) : 50;
+    const safeLimit = Number.isFinite(limit) && limit > 0 ? Math.min(limit, 200) : 50;
+    const sliced = events.slice(0, safeLimit);
+    return { count: sliced.length, total, events: sliced };
   });
-  scope.get("/incidents/stale", async (req, reply) => {
+  scope.get("/stale-events", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
     if (!proj) return;
     const spath = staleEventsPathFor(proj);
-    if (!spath) return [];
+    if (!spath) return { count: 0, total: 0, events: [] };
     const events = await readStaleEvents(spath);
     const filtered = req.query.edgeType ? events.filter((e) => e.edgeType === req.query.edgeType) : events;
     const ordered = [...filtered].reverse();
+    const total = ordered.length;
     const limit = req.query.limit ? Number(req.query.limit) : 50;
-    return ordered.slice(0, Number.isFinite(limit) && limit > 0 ? limit : 50);
+    const sliced = ordered.slice(0, Number.isFinite(limit) && limit > 0 ? limit : 50);
+    return { count: sliced.length, total, events: sliced };
   });
   scope.get(
     "/incidents/:nodeId",
@@ -4359,14 +4376,15 @@ function registerRoutes(scope, ctx) {
         return reply.code(404).send({ error: "node not found", id: nodeId });
       }
       const epath = errorsPathFor(proj);
-      if (!epath) return [];
+      if (!epath) return { count: 0, total: 0, events: [] };
       const events = await readErrorEvents(epath);
-      return events.filter(
+      const filtered = events.filter(
         (e) => e.affectedNode === nodeId || e.service === nodeId.replace(/^service:/, "")
       );
+      return { count: filtered.length, total: filtered.length, events: filtered };
     }
   );
-  scope.get("/traverse/root-cause/:nodeId", async (req, reply) => {
+  scope.get("/graph/root-cause/:nodeId", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
     if (!proj) return;
     const { nodeId } = req.params;
@@ -4386,7 +4404,7 @@ function registerRoutes(scope, ctx) {
     if (!result) return reply.code(404).send({ error: "no root cause found", id: nodeId });
     return result;
   });
-  scope.get("/traverse/blast-radius/:nodeId", async (req, reply) => {
+  scope.get("/graph/blast-radius/:nodeId", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
     if (!proj) return;
     const { nodeId } = req.params;
@@ -4496,7 +4514,7 @@ function registerRoutes(scope, ctx) {
     if (req.query.policyId) {
       violations = violations.filter((v) => v.policyId === req.query.policyId);
     }
-    return violations;
+    return { violations };
   });
   scope.post("/policies/check", async (req, reply) => {
     const proj = resolveProject(registry, req, reply);
@@ -4575,6 +4593,20 @@ async function buildApi(opts) {
       });
     }
   });
+  app.get("/projects/:project", async (req, reply) => {
+    try {
+      const entry = await getProject(req.params.project);
+      if (!entry) {
+        return reply.code(404).send({ error: "project not found", project: req.params.project });
+      }
+      return { project: entry };
+    } catch (err) {
+      return reply.code(500).send({
+        error: "failed to read project registry",
+        details: err.message
+      });
+    }
+  });
   registerRoutes(app, routeCtx);
   await app.register(
     async (scope) => {