@prowi/deskcheck 0.1.0 → 0.2.0

package/build/renderers/test/TerminalRenderer.js

@@ -0,0 +1,233 @@
+// =============================================================================
+// ANSI helpers
+// =============================================================================
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const RED = "\x1b[31m";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+// =============================================================================
+// Score color helpers
+// =============================================================================
+/** Color a percentage score: green >= 80%, yellow >= 50%, red < 50%. */
+function colorScore(value) {
+    const pct = Math.round(value * 100);
+    const str = `${pct}%`;
+    if (pct >= 80)
+        return `${GREEN}${str}${RESET}`;
+    if (pct >= 50)
+        return `${YELLOW}${str}${RESET}`;
+    return `${RED}${str}${RESET}`;
+}
+/** Pad a string to a fixed visible width (ignoring ANSI escape codes). */
+function padScore(colored, width) {
+    // Strip ANSI to measure visible length
+    const visible = colored.replace(/\x1b\[[0-9;]*m/g, "");
+    const padding = Math.max(0, width - visible.length);
+    return colored + " ".repeat(padding);
+}
+// =============================================================================
+// Status icon helpers
+// =============================================================================
+/** Get the status icon for a test case based on its status and scores. */
+function statusIcon(status, scores) {
+    if (status === "error")
+        return `${RED}\u2717${RESET}`;
+    if (status === "pending")
+        return `${DIM}\u25CB${RESET}`;
+    if (status === "executing" || status === "judging")
+        return `${DIM}\u27F3${RESET}`;
+    // status === "complete"
+    if (scores && scores.recall >= 0.8 && scores.precision >= 0.8 && scores.scope_compliance >= 0.8) {
+        return `${GREEN}\u2713${RESET}`;
+    }
+    return `${YELLOW}\u25B2${RESET}`;
+}
+/** Check if a completed test case passed (all scores >= 80%). */
+function isPassing(scores) {
+    if (!scores)
+        return false;
+    return scores.recall >= 0.8 && scores.precision >= 0.8 && scores.scope_compliance >= 0.8;
+}
+// =============================================================================
+// Progress renderer (live updates during execution)
+// =============================================================================
+/**
+ * Render the current state of a test run for live progress updates.
+ *
+ * Shows one line per test case with its current status and scores (if complete).
+ */
+export function renderTestProgress(run) {
+    const lines = [];
+    let totalTests = 0;
+    let completedTests = 0;
+    for (const [criterionId, suite] of Object.entries(run.suites)) {
+        lines.push("");
+        lines.push(`  ${BOLD}${criterionId}${RESET}`);
+        lines.push("");
+        for (const [testName, testCase] of Object.entries(suite.tests)) {
+            totalTests++;
+            const icon = statusIcon(testCase.status, testCase.scores);
+            if (testCase.status === "complete" && testCase.scores) {
+                completedTests++;
+                const recall = padScore(colorScore(testCase.scores.recall), 6);
+                const precision = padScore(colorScore(testCase.scores.precision), 6);
+                const scope = padScore(colorScore(testCase.scores.scope_compliance), 6);
+                lines.push(`    ${icon} ${testName}       recall: ${recall}precision: ${precision}scope: ${scope}`);
+                // Summary line
+                const parts = [];
+                if (testCase.scores.expectations_found > 0 || testCase.scores.total_expectations > 0) {
+                    parts.push(`${testCase.scores.expectations_found}/${testCase.scores.total_expectations} expected found`);
+                }
+                if (testCase.scores.out_of_scope > 0) {
+                    parts.push(`${testCase.scores.out_of_scope} out-of-scope finding${testCase.scores.out_of_scope !== 1 ? "s" : ""}`);
+                }
+                if (parts.length > 0) {
+                    lines.push(`      ${DIM}${parts.join(". ")}.${RESET}`);
+                }
+            }
+            else if (testCase.status === "error") {
+                completedTests++;
+                lines.push(`    ${icon} ${testName}       ${RED}error${RESET}`);
+                if (testCase.error) {
+                    lines.push(`      ${DIM}${testCase.error}${RESET}`);
+                }
+            }
+            else if (testCase.status === "executing") {
+                lines.push(`    ${icon} ${testName}       ${DIM}executing...${RESET}`);
+            }
+            else if (testCase.status === "judging") {
+                lines.push(`    ${icon} ${testName}       ${DIM}judging...${RESET}`);
+            }
+            else {
+                // pending
+                lines.push(`    ${icon} ${testName}       ${DIM}pending${RESET}`);
+            }
+        }
+    }
+    lines.push("");
+    lines.push(`  ${completedTests}/${totalTests} complete`);
+    return lines.join("\n");
+}
+// =============================================================================
+// Results renderer (final detailed output)
+// =============================================================================
+/**
+ * Render the final detailed results after all tests complete.
+ *
+ * For imperfect or failed tests, shows per-finding and per-expectation detail.
+ */
+export function renderTestResults(run) {
+    const lines = [];
+    let totalSuites = 0;
+    let passedSuites = 0;
+    let imperfectSuites = 0;
+    let totalCost = 0;
+    let totalDuration = 0;
+    for (const [criterionId, suite] of Object.entries(run.suites)) {
+        totalSuites++;
+        lines.push("");
+        lines.push(`  ${BOLD}${criterionId}${RESET}`);
+        lines.push("");
+        let suiteAllPassing = true;
+        for (const [testName, testCase] of Object.entries(suite.tests)) {
+            // Accumulate cost and duration
+            totalCost += accumulateCost(testCase);
+            totalDuration += accumulateDuration(testCase);
+            const icon = statusIcon(testCase.status, testCase.scores);
+            if (testCase.status === "complete" && testCase.scores) {
+                const passing = isPassing(testCase.scores);
+                if (!passing)
+                    suiteAllPassing = false;
+                const recall = padScore(colorScore(testCase.scores.recall), 6);
+                const precision = padScore(colorScore(testCase.scores.precision), 6);
+                const scope = padScore(colorScore(testCase.scores.scope_compliance), 6);
+                lines.push(`    ${icon} ${testName}       recall: ${recall}precision: ${precision}scope: ${scope}`);
+                // Show detail for imperfect tests
+                if (!passing && testCase.judge) {
+                    lines.push("");
+                    // Findings detail
+                    if (testCase.judge.findings_review.length > 0) {
+                        lines.push(`      ${BOLD}Findings:${RESET}`);
+                        for (const fr of testCase.judge.findings_review) {
+                            if (fr.verdict === "correct") {
+                                const check = fr.criterion_check ? ` ${DIM}(${fr.criterion_check})${RESET}` : "";
+                                lines.push(`        ${GREEN}\u2713${RESET} ${fr.finding}          ${DIM}correct${RESET}${check}`);
+                            }
+                            else if (fr.verdict === "out_of_scope") {
+                                lines.push(`        ${RED}\u2717${RESET} ${fr.finding}          ${YELLOW}out of scope${RESET}`);
+                            }
+                            else {
+                                lines.push(`        ${RED}\u2717${RESET} ${fr.finding}          ${RED}incorrect severity${RESET}`);
+                            }
+                        }
+                        lines.push("");
+                    }
+                    // Expectations detail
+                    if (testCase.judge.expectations_review.length > 0) {
+                        lines.push(`      ${BOLD}Expectations:${RESET}`);
+                        for (const er of testCase.judge.expectations_review) {
+                            if (er.verdict === "found") {
+                                lines.push(`        ${GREEN}\u2713${RESET} ${er.expectation}          ${DIM}found${RESET}`);
+                            }
+                            else {
+                                lines.push(`        ${RED}\u2717${RESET} ${er.expectation}          ${RED}missed${RESET}`);
+                            }
+                        }
+                    }
+                    lines.push("");
+                }
+            }
+            else if (testCase.status === "error") {
+                suiteAllPassing = false;
+                lines.push(`    ${icon} ${testName}       ${RED}error: ${testCase.error ?? "unknown"}${RESET}`);
+                lines.push("");
+            }
+            else {
+                suiteAllPassing = false;
+                lines.push(`    ${icon} ${testName}       ${DIM}${testCase.status}${RESET}`);
+            }
+        }
+        if (suiteAllPassing) {
+            passedSuites++;
+        }
+        else {
+            imperfectSuites++;
+        }
+    }
+    // Summary line
+    lines.push("");
+    const summaryParts = [];
+    if (passedSuites > 0)
+        summaryParts.push(`${GREEN}${passedSuites} passed${RESET}`);
+    if (imperfectSuites > 0)
+        summaryParts.push(`${YELLOW}${imperfectSuites} imperfect${RESET}`);
+    lines.push(`  Results: ${summaryParts.join(", ")} (${totalSuites} total)`);
+    // Cost and duration
+    const costStr = totalCost > 0 ? `$${totalCost.toFixed(2)}` : "$0.00";
+    const durationStr = `${Math.round(totalDuration / 1000)}s`;
+    lines.push(`  ${DIM}Cost: ${costStr} \u2502 Duration: ${durationStr}${RESET}`);
+    lines.push("");
+    return lines.join("\n");
+}
+// =============================================================================
+// Usage accumulation helpers
+// =============================================================================
+function accumulateCost(testCase) {
+    let cost = 0;
+    if (testCase.executor_usage)
+        cost += testCase.executor_usage.cost_usd;
+    if (testCase.judge_usage)
+        cost += testCase.judge_usage.cost_usd;
+    return cost;
+}
+function accumulateDuration(testCase) {
+    let duration = 0;
+    if (testCase.executor_usage)
+        duration += testCase.executor_usage.duration_ms;
+    if (testCase.judge_usage)
+        duration += testCase.judge_usage.duration_ms;
+    return duration;
+}
+//# sourceMappingURL=TerminalRenderer.js.map

package/build/renderers/test/TerminalRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerminalRenderer.js","sourceRoot":"","sources":["../../../src/renderers/test/TerminalRenderer.ts"],"names":[],"mappings":"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"}

package/build/server/controllers/ReviewController.d.ts

@@ -0,0 +1,23 @@
+import type http from "node:http";
+import type { ReviewStorageService } from "../../services/review/ReviewStorageService.js";
+import type { ReviewResults } from "../../types/review.js";
+/** A run summary returned by GET /api/runs. */
+export interface RunSummary {
+    planId: string;
+    name: string;
+    status: string;
+    createdAt: string;
+    sourceType: string | null;
+    sourceTarget: string | null;
+    taskCount: number;
+    moduleCount: number;
+    moduleNames: string[];
+    matchedFiles: number;
+    unmatchedFiles: number;
+    summary: ReviewResults["summary"] | null;
+    completion: ReviewResults["completion"] | null;
+}
+export declare function handleGetRuns(storage: ReviewStorageService, res: http.ServerResponse): void;
+export declare function handleGetPlan(storage: ReviewStorageService, res: http.ServerResponse, planId: string): void;
+export declare function handleGetResults(storage: ReviewStorageService, res: http.ServerResponse, planId: string): void;
+//# sourceMappingURL=ReviewController.d.ts.map

package/build/server/controllers/ReviewController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewController.d.ts","sourceRoot":"","sources":["../../../src/server/controllers/ReviewController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAM3D,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACzC,UAAU,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;CAChD;AAwBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAsD3F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO3G;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO9G"}

package/build/server/controllers/ReviewController.js

@@ -0,0 +1,90 @@
+// =============================================================================
+// Response helpers (used by controller handlers)
+// =============================================================================
+function sendJson(res, data, status = 200) {
+    const body = JSON.stringify(data);
+    res.writeHead(status, {
+        "Content-Type": "application/json",
+        "Access-Control-Allow-Origin": "*",
+        "Cache-Control": "no-cache",
+    });
+    res.end(body);
+}
+function sendError(res, status, message) {
+    sendJson(res, { error: message }, status);
+}
+// =============================================================================
+// Route handlers
+// =============================================================================
+export function handleGetRuns(storage, res) {
+    const plans = storage.listPlans();
+    const runs = plans.map((planSummary) => {
+        let summary = null;
+        let completion = null;
+        // Enrich with results data if available
+        try {
+            const results = storage.getResults(planSummary.planId);
+            summary = results.summary;
+            completion = results.completion;
+        }
+        catch {
+            // No results file yet
+        }
+        // Enrich with plan data (tasks, modules, coverage)
+        let taskCount = 0;
+        let moduleCount = 0;
+        let moduleNames = [];
+        let matchedFiles = 0;
+        let unmatchedFiles = 0;
+        let sourceType = null;
+        let sourceTarget = null;
+        try {
+            const plan = storage.getPlan(planSummary.planId);
+            taskCount = Object.keys(plan.tasks).length;
+            moduleCount = Object.keys(plan.modules).length;
+            moduleNames = Object.keys(plan.modules).map((id) => id.split("/").pop() ?? id);
+            matchedFiles = plan.matched_files?.length ?? 0;
+            unmatchedFiles = plan.unmatched_files?.length ?? 0;
+            sourceType = plan.source?.type ?? null;
+            sourceTarget = plan.source?.target ?? null;
+        }
+        catch {
+            // Plan read error
+        }
+        return {
+            planId: planSummary.planId,
+            name: planSummary.name,
+            status: planSummary.status,
+            createdAt: planSummary.createdAt,
+            sourceType,
+            sourceTarget,
+            taskCount,
+            moduleCount,
+            moduleNames,
+            matchedFiles,
+            unmatchedFiles,
+            summary,
+            completion,
+        };
+    });
+    sendJson(res, runs);
+}
+export function handleGetPlan(storage, res, planId) {
+    try {
+        const plan = storage.getPlan(planId);
+        sendJson(res, plan);
+    }
+    catch {
+        sendError(res, 404, `Plan not found: ${planId}`);
+    }
+}
+export function handleGetResults(storage, res, planId) {
+    try {
+        const results = storage.getResults(planId);
+        sendJson(res, results);
+    }
+    catch {
+        sendError(res, 404, `Results not found for plan: ${planId}`);
+    }
+}
+//# sourceMappingURL=ReviewController.js.map

package/build/server/controllers/ReviewController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewController.js","sourceRoot":"","sources":["../../../src/server/controllers/ReviewController.ts"],"names":[],"mappings":"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"}

package/build/server/controllers/TestController.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TestController.d.ts.map

package/build/server/controllers/TestController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestController.d.ts","sourceRoot":"","sources":["../../../src/server/controllers/TestController.ts"],"names":[],"mappings":""}

package/build/server/controllers/TestController.js

@@ -0,0 +1,3 @@
+export {};
+// Test run API endpoints — to be implemented
+//# sourceMappingURL=TestController.js.map

package/build/server/controllers/TestController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestController.js","sourceRoot":"","sources":["../../../src/server/controllers/TestController.ts"],"names":[],"mappings":";AAAA,6CAA6C"}

package/build/server/middleware/cors.d.ts

@@ -0,0 +1,9 @@
+import type http from "node:http";
+/**
+ * Handle CORS preflight (OPTIONS) requests.
+ *
+ * Returns `true` if the request was an OPTIONS preflight and has been
+ * fully handled (caller should stop processing). Returns `false` otherwise.
+ */
+export declare function handleCors(req: http.IncomingMessage, res: http.ServerResponse): boolean;
+//# sourceMappingURL=cors.d.ts.map

package/build/server/middleware/cors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.d.ts","sourceRoot":"","sources":["../../../src/server/middleware/cors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,GAAG,OAAO,CAUvF"}

package/build/server/middleware/cors.js

@@ -0,0 +1,18 @@
+/**
+ * Handle CORS preflight (OPTIONS) requests.
+ *
+ * Returns `true` if the request was an OPTIONS preflight and has been
+ * fully handled (caller should stop processing). Returns `false` otherwise.
+ */
+export function handleCors(req, res) {
+    if (req.method !== "OPTIONS")
+        return false;
+    res.writeHead(204, {
+        "Access-Control-Allow-Origin": "*",
+        "Access-Control-Allow-Methods": "GET, OPTIONS",
+        "Access-Control-Allow-Headers": "Content-Type",
+    });
+    res.end();
+    return true;
+}
+//# sourceMappingURL=cors.js.map

package/build/server/middleware/cors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.js","sourceRoot":"","sources":["../../../src/server/middleware/cors.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,GAAyB,EAAE,GAAwB;IAC5E,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAE3C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,6BAA6B,EAAE,GAAG;QAClC,8BAA8B,EAAE,cAAc;QAC9C,8BAA8B,EAAE,cAAc;KAC/C,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,EAAE,CAAC;IACV,OAAO,IAAI,CAAC;AACd,CAAC"}

package/build/{serve.d.ts → server/server.d.ts}

@@ -1,4 +1,4 @@
-import type { ReviewConfig } from "./core/types.js";
+import type { ReviewConfig } from "../config/types.js";
 /**
  * Start the deskcheck web UI server.
  *
@@ -6,4 +6,4 @@ import type { ReviewConfig } from "./core/types.js";
  * and SSE streams for live updates during execution.
  */
 export declare function startServer(config: ReviewConfig, projectRoot: string, port: number): void;
-//# sourceMappingURL=serve.d.ts.map
+//# sourceMappingURL=server.d.ts.map

package/build/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAyCvD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAkEzF"}

package/build/server/server.js

@@ -0,0 +1,102 @@
+import http from "node:http";
+import fs from "node:fs";
+import path from "node:path";
+import { URL } from "node:url";
+import { ReviewStorageService } from "../services/review/ReviewStorageService.js";
+import { handleCors } from "./middleware/cors.js";
+import { handleGetRuns, handleGetPlan, handleGetResults } from "./controllers/ReviewController.js";
+import { handleSSE } from "./sse/FileWatcherSSE.js";
+// =============================================================================
+// Response helpers
+// =============================================================================
+function sendJson(res, data, status = 200) {
+    const body = JSON.stringify(data);
+    res.writeHead(status, {
+        "Content-Type": "application/json",
+        "Access-Control-Allow-Origin": "*",
+        "Cache-Control": "no-cache",
+    });
+    res.end(body);
+}
+function sendHtml(res, html) {
+    res.writeHead(200, {
+        "Content-Type": "text/html; charset=utf-8",
+        "Access-Control-Allow-Origin": "*",
+    });
+    res.end(html);
+}
+function sendError(res, status, message) {
+    sendJson(res, { error: message }, status);
+}
+// =============================================================================
+// URL parsing
+// =============================================================================
+/** Parse a URL path into segments, e.g. "/api/runs/abc/plan" -> ["api", "runs", "abc", "plan"]. */
+function parseSegments(pathname) {
+    return pathname.split("/").filter((s) => s.length > 0);
+}
+// =============================================================================
+// Server
+// =============================================================================
+/**
+ * Start the deskcheck web UI server.
+ *
+ * Serves a self-contained HTML dashboard at the root, a JSON API for run data,
+ * and SSE streams for live updates during execution.
+ */
+export function startServer(config, projectRoot, port) {
+    const storageDir = path.join(projectRoot, config.storage_dir);
+    const storage = new ReviewStorageService(storageDir);
+    const uiHtmlPath = path.resolve(path.dirname(new URL(import.meta.url).pathname), "../../ui/dist/index.html");
+    const server = http.createServer((req, res) => {
+        // Handle CORS preflight
+        if (handleCors(req, res))
+            return;
+        if (req.method !== "GET") {
+            sendError(res, 405, "Method not allowed");
+            return;
+        }
+        const parsedUrl = new URL(req.url ?? "/", `http://localhost:${port}`);
+        const segments = parseSegments(parsedUrl.pathname);
+        // GET / -> dashboard HTML (re-read on each request so UI rebuilds are picked up without restart)
+        if (segments.length === 0) {
+            if (!fs.existsSync(uiHtmlPath)) {
+                sendHtml(res, "<html><body><p>UI not built yet. Run <code>cd ui &amp;&amp; npm run build</code>, or use the Vite dev server at <code>http://localhost:5173</code>.</p></body></html>");
+                return;
+            }
+            const dashboardHtml = fs.readFileSync(uiHtmlPath, "utf-8");
+            sendHtml(res, dashboardHtml);
+            return;
+        }
+        // API routes all start with "api"
+        if (segments[0] !== "api") {
+            sendError(res, 404, "Not found");
+            return;
+        }
+        // GET /api/runs
+        if (segments.length === 2 && segments[1] === "runs") {
+            handleGetRuns(storage, res);
+            return;
+        }
+        // GET /api/runs/:id/plan
+        if (segments.length === 4 && segments[1] === "runs" && segments[3] === "plan") {
+            handleGetPlan(storage, res, decodeURIComponent(segments[2]));
+            return;
+        }
+        // GET /api/runs/:id/results
+        if (segments.length === 4 && segments[1] === "runs" && segments[3] === "results") {
+            handleGetResults(storage, res, decodeURIComponent(segments[2]));
+            return;
+        }
+        // GET /api/events/:id -> SSE stream
+        if (segments.length === 3 && segments[1] === "events") {
+            handleSSE(res, storageDir, decodeURIComponent(segments[2]));
+            return;
+        }
+        sendError(res, 404, "Not found");
+    });
+    server.listen(port, () => {
+        console.log(`Deskcheck UI: http://localhost:${port}`);
+    });
+}
+//# sourceMappingURL=server.js.map

package/build/server/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"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"}

package/build/server/sse/FileWatcherSSE.d.ts

@@ -0,0 +1,10 @@
+import type http from "node:http";
+/**
+ * Stream SSE events when JSON files change in a watched directory.
+ *
+ * Watches the given directory for changes to `.json` files and emits
+ * `data: {"type":"update"}` events to the connected client. Falls back
+ * to polling if `fs.watch` is unavailable.
+ */
+export declare function handleSSE(res: http.ServerResponse, storageDir: string, planId: string): void;
+//# sourceMappingURL=FileWatcherSSE.d.ts.map

package/build/server/sse/FileWatcherSSE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileWatcherSSE.d.ts","sourceRoot":"","sources":["../../../src/server/sse/FileWatcherSSE.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,IAAI,CAiFN"}