refactor: extract graph-viewer to packages/graph-viewer/ (ai-b2t)

Move client (Vite frontend), server (Bun backend), bin entrypoint, and
vite config from @agents/cli into a standalone @agents/graph-viewer
workspace package. CLI commands (graph-viewer serve/build/dev and
serve --web) now delegate to the new package via workspace import.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: aRustyDev

bun.lock

@@ -12,6 +12,7 @@
   },
   "dependencies": {
     "@agents/core": "workspace:*",
+    "@agents/graph-viewer": "workspace:*",
     "@agents/kg": "workspace:*",
     "@agents/sdk": "workspace:*",
     "@bomb.sh/tab": "^0.0.14",

packages/cli/package.json

@@ -1,64 +1,42 @@
 /**
  * Graph Viewer commands — serve, build, dev.
  *
+ * Delegates to the @agents/graph-viewer package.
+ *
  * Subcommands:
  *   serve - Start the Bun server (production: serves built assets)
  *   build - Build the Vite client
  *   dev   - Start both Vite dev server and Bun API server
  */
 
-import { currentDir } from '@agents/core/runtime'
 import { defineCommand } from 'citty'
 
-const serveCommand = defineCommand({
-  meta: { name: 'serve', description: 'Start the graph viewer server' },
-  args: {
-    port: { type: 'string', default: '3000', description: 'Server port' },
-  },
-  async run({ args }) {
-    process.env.GV_PORT = args.port
-    await import('../bin/graph-viewer')
-  },
-})
-
-const buildCommand = defineCommand({
-  meta: { name: 'build', description: 'Build the graph viewer client' },
-  async run() {
-    const { execSync } = await import('node:child_process')
-    const { resolve } = await import('node:path')
-    const scriptsDir = resolve(currentDir(import.meta), '../..')
-    execSync('npx vite build --config vite.graph-viewer.config.ts', {
-      cwd: scriptsDir,
-      stdio: 'inherit',
-    })
-  },
-})
-
-const devCommand = defineCommand({
-  meta: { name: 'dev', description: 'Start graph viewer in dev mode (Vite HMR + Bun API)' },
-  args: {
-    port: { type: 'string', default: '3000', description: 'API server port' },
-  },
-  async run({ args }) {
-    const { execSync } = await import('node:child_process')
-    const { resolve } = await import('node:path')
-    const scriptsDir = resolve(currentDir(import.meta), '../..')
-    process.env.GV_PORT = args.port
-    execSync(
-      `npx concurrently "bun --watch run src/bin/graph-viewer.ts" "npx vite --config vite.graph-viewer.config.ts"`,
-      {
-        cwd: scriptsDir,
-        stdio: 'inherit',
-      }
-    )
-  },
-})
-
 export default defineCommand({
   meta: { name: 'graph-viewer', description: 'Interactive graph visualization tool' },
   subCommands: {
-    serve: serveCommand,
-    build: buildCommand,
-    dev: devCommand,
+    serve: defineCommand({
+      meta: { name: 'serve', description: 'Start the graph viewer server' },
+      args: {
+        port: { type: 'string', default: '3000', description: 'Server port' },
+      },
+      async run({ args }) {
+        process.env.GV_PORT = args.port
+        await import('@agents/graph-viewer/bin')
+      },
+    }),
+    build: defineCommand({
+      meta: { name: 'build', description: 'Build the graph viewer client' },
+      async run() {
+        const { execSync } = await import('node:child_process')
+        execSync('bun run build', { cwd: 'packages/graph-viewer', stdio: 'inherit' })
+      },
+    }),
+    dev: defineCommand({
+      meta: { name: 'dev', description: 'Start dev mode' },
+      async run() {
+        const { execSync } = await import('node:child_process')
+        execSync('bun run dev', { cwd: 'packages/graph-viewer', stdio: 'inherit' })
+      },
+    }),
   },
 })

packages/cli/src/commands/graph-viewer.ts

@@ -155,6 +155,6 @@ export default defineCommand({
     // Default: delegate to graph-viewer serve (web mode)
     process.env.GV_PORT = String(port)
     out.info(`Starting graph viewer on port ${port}...`)
-    await import('../bin/graph-viewer')
+    await import('@agents/graph-viewer/bin')
   },
 })

packages/cli/src/commands/serve.ts

@@ -0,0 +1,29 @@
+{
+  "name": "@agents/graph-viewer",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "exports": {
+    "./bin": "./src/bin.ts"
+  },
+  "scripts": {
+    "serve": "bun run src/bin.ts",
+    "dev": "concurrently \"bun run src/bin.ts\" \"npx vite --config vite.config.ts\"",
+    "build": "npx vite build --config vite.config.ts"
+  },
+  "dependencies": {
+    "@agents/core": "workspace:*",
+    "@agents/kg": "workspace:*",
+    "graphology": "^0.26.0",
+    "graphology-layout": "^0.6.1",
+    "graphology-layout-forceatlas2": "^0.10.1",
+    "graphology-types": "^0.24.8",
+    "sigma": "^3.0.2",
+    "ws": "^8.19.0",
+    "concurrently": "^9.2.1",
+    "vite": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1"
+  }
+}

packages/graph-viewer/package.json

@@ -16,18 +16,18 @@ import { createServer, type IncomingMessage, type ServerResponse } from 'node:ht
 import { extname, resolve } from 'node:path'
 import { currentDir } from '@agents/core/runtime'
 import { WebSocket, WebSocketServer } from 'ws'
-import { handleGitRoute } from '../server/graph-viewer/routes/git'
-import { handleGraphsRoute, handleSchemasRoute } from '../server/graph-viewer/routes/graphs'
-import { createWatcher, type FileChangeEvent } from '../server/graph-viewer/watcher'
+import { handleGitRoute } from './server/routes/git'
+import { handleGraphsRoute, handleSchemasRoute } from './server/routes/graphs'
+import { createWatcher, type FileChangeEvent } from './server/watcher'
 
 // ---------------------------------------------------------------------------
 // Configuration
 // ---------------------------------------------------------------------------
 
 const PORT = Number(process.env.GV_PORT) || 3000
 const __dir = currentDir(import.meta)
-const DIST_DIR = resolve(__dir, '../../dist/graph-viewer')
-const GRAPHS_DIR = resolve(__dir, '../../../../.data/graphs')
+const DIST_DIR = resolve(__dir, '../dist/graph-viewer')
+const GRAPHS_DIR = resolve(__dir, '../../../.data/graphs')
 
 // ---------------------------------------------------------------------------
 // MIME types for static file serving