plankit-cli 1.4.0 → 1.6.0

package/src/server/server.js

@@ -0,0 +1,155 @@
+import http from 'node:http';
+import fs from 'node:fs';
+import path from 'node:path';
+import { URL } from 'node:url';
+import { loadDashboardData } from '../dashboard/dashboard.js';
+import { runAnalysis } from '../analyzer/engine.js';
+import { getClientHtml } from './clientHtml.js';
+import { safeJoin } from '../config.js';
+
+/**
+ * Native, zero-dependency HTTP server for PlanKit Web Dashboard.
+ */
+
+export function createWebServer({ cwd, config, io }) {
+  const server = http.createServer(async (req, res) => {
+    try {
+      const parsedUrl = new URL(req.url, `http://${req.headers.host || 'localhost'}`);
+      const pathname = parsedUrl.pathname;
+
+      // CORS headers for local development
+      res.setHeader('Access-Control-Allow-Origin', '*');
+      res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+      res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+
+      if (req.method === 'OPTIONS') {
+        res.writeHead(204);
+        res.end();
+        return;
+      }
+
+      // Root HTML page
+      if (pathname === '/' || pathname === '/index.html') {
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(getClientHtml());
+        return;
+      }
+
+      // API: Combined data (active features, archived count, and latest health scan)
+      if (pathname === '/api/data' && req.method === 'GET') {
+        const dashboardData = loadDashboardData(cwd, config);
+        
+        let healthReport = null;
+        const indexPath = path.join(cwd, config.artifactsDir || 'artifacts', '.plankit-index.json');
+        if (fs.existsSync(indexPath)) {
+          try {
+            healthReport = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
+          } catch {
+            healthReport = null;
+          }
+        }
+
+        // If no index exists yet, run a fast scan
+        if (!healthReport) {
+          healthReport = await runAnalysis(cwd, { artifactsDir: config.artifactsDir });
+        }
+
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+          activeFeatures: dashboardData.activeFeatures,
+          archivedCount: dashboardData.archivedCount,
+          healthReport
+        }));
+        return;
+      }
+
+      // API: Trigger live re-scan
+      if (pathname === '/api/scan' && req.method === 'POST') {
+        const report = await runAnalysis(cwd, { artifactsDir: config.artifactsDir });
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(report));
+        return;
+      }
+
+      // API: View Phase Spec Markdown
+      if (pathname === '/api/spec' && req.method === 'GET') {
+        const feature = parsedUrl.searchParams.get('feature');
+        const phase = parsedUrl.searchParams.get('phase');
+        if (!feature || !phase) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: 'Missing feature or phase parameter' }));
+          return;
+        }
+
+        const phasesDir = safeJoin(cwd, config.artifactsDir || 'artifacts', 'current', feature, 'phases');
+        const prefix = `phase-${phase}-`;
+        const file = fs.existsSync(phasesDir)
+          ? fs.readdirSync(phasesDir).find((n) => n.startsWith(prefix) && n.endsWith('.md'))
+          : null;
+
+        if (!file) {
+          res.writeHead(404, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: `Spec for Phase ${phase} not found` }));
+          return;
+        }
+
+        const content = fs.readFileSync(path.join(phasesDir, file), 'utf8');
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ file, content }));
+        return;
+      }
+
+      // API: View Phase Output Report Markdown
+      if (pathname === '/api/output' && req.method === 'GET') {
+        const feature = parsedUrl.searchParams.get('feature');
+        const phase = parsedUrl.searchParams.get('phase');
+        if (!feature || !phase) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: 'Missing feature or phase parameter' }));
+          return;
+        }
+
+        const outputPath = safeJoin(cwd, config.artifactsDir || 'artifacts', 'current', feature, 'outputs', `phase-${phase}-output.md`);
+        if (!fs.existsSync(outputPath)) {
+          res.writeHead(404, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: `Output report for Phase ${phase} not found` }));
+          return;
+        }
+
+        const content = fs.readFileSync(outputPath, 'utf8');
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ file: path.basename(outputPath), content }));
+        return;
+      }
+
+      // 404
+      res.writeHead(404, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: 'Not Found' }));
+    } catch (err) {
+      res.writeHead(500, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: err.message }));
+    }
+  });
+
+  return server;
+}
+
+export function startServer({ cwd, config, port = 4200, io }) {
+  return new Promise((resolve, reject) => {
+    const server = createWebServer({ cwd, config, io });
+
+    server.once('error', (err) => {
+      if (err.code === 'EADDRINUSE') {
+        reject(new Error(`Port ${port} is already in use. Try passing a different port with --port <number>.`));
+      } else {
+        reject(err);
+      }
+    });
+
+    server.listen(port, () => {
+      const address = server.address();
+      const actualPort = typeof address === 'object' ? address.port : port;
+      resolve({ server, port: actualPort });
+    });
+  });
+}