@jonit-dev/night-watch-cli 1.7.17 → 1.7.19

package/dist/server/index.js

@@ -1,1074 +0,0 @@
-/**
- * HTTP API Server for Night Watch CLI
- * Provides REST API endpoints for the Web UI
- * Supports both single-project and global (multi-project) modes
- */
-import express, { Router } from "express";
-import cors from "cors";
-import { execSync, spawn } from "child_process";
-import * as fs from "fs";
-import * as path from "path";
-import { dirname } from "path";
-import { fileURLToPath } from "url";
-import { CLAIM_FILE_EXTENSION, CONFIG_FILE_NAME, LOG_DIR, LOG_FILE_NAMES } from "../constants.js";
-import { loadConfig } from "../config.js";
-import { createBoardProvider } from "../board/factory.js";
-import { BOARD_COLUMNS } from "../board/types.js";
-import { validateWebhook } from "../commands/doctor.js";
-import { checkLockFile, collectPrInfo, collectPrdInfo, executorLockPath, fetchStatusSnapshot, getLastLogLines, reviewerLockPath } from "../utils/status-data.js";
-import { performCancel } from "../commands/cancel.js";
-import { saveConfig } from "../utils/config-writer.js";
-import { loadRegistry, validateRegistry } from "../utils/registry.js";
-import { generateMarker, getEntries, getProjectEntries } from "../utils/crontab.js";
-import { CronExpressionParser } from "cron-parser";
-import { sendNotifications } from "../utils/notify.js";
-import { getRoadmapStatus, scanRoadmap } from "../utils/roadmap-scanner.js";
-import { loadRoadmapState } from "../utils/roadmap-state.js";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-// Track spawned processes
-const spawnedProcesses = new Map();
-/**
- * Broadcast an SSE event to all connected clients
- */
-function broadcastSSE(clients, event, data) {
-    const msg = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
-    for (const client of clients) {
-        try {
-            client.write(msg);
-        }
-        catch {
-            clients.delete(client);
-        }
-    }
-}
-/**
- * Start the SSE status change watcher that broadcasts when snapshot changes
- */
-function startSseStatusWatcher(clients, projectDir, getConfig) {
-    let lastSnapshotHash = "";
-    return setInterval(() => {
-        if (clients.size === 0)
-            return;
-        try {
-            const snapshot = fetchStatusSnapshot(projectDir, getConfig());
-            const hash = JSON.stringify({
-                processes: snapshot.processes,
-                prds: snapshot.prds.map((p) => ({ n: p.name, s: p.status })),
-            });
-            if (hash !== lastSnapshotHash) {
-                lastSnapshotHash = hash;
-                broadcastSSE(clients, "status_changed", snapshot);
-            }
-        }
-        catch {
-            // Silently ignore errors during status polling
-        }
-    }, 2000);
-}
-/**
- * Error handler middleware
- */
-function errorHandler(err, _req, res, _next) {
-    console.error("API Error:", err);
-    res.status(500).json({ error: err.message });
-}
-/**
- * Validate PRD name to prevent path traversal
- */
-function validatePrdName(name) {
-    return /^[a-zA-Z0-9_-]+(\.md)?$/.test(name) && !name.includes("..");
-}
-// ==================== Extracted Route Handlers ====================
-function handleGetStatus(projectDir, config, _req, res) {
-    try {
-        const snapshot = fetchStatusSnapshot(projectDir, config);
-        res.json(snapshot);
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handleGetPrds(projectDir, config, _req, res) {
-    try {
-        const prds = collectPrdInfo(projectDir, config.prdDir, config.maxRuntime);
-        const prdsWithContent = prds.map((prd) => {
-            const prdPath = path.join(projectDir, config.prdDir, `${prd.name}.md`);
-            let content = "";
-            if (fs.existsSync(prdPath)) {
-                try {
-                    content = fs.readFileSync(prdPath, "utf-8");
-                }
-                catch {
-                    content = "";
-                }
-            }
-            return { ...prd, content };
-        });
-        res.json(prdsWithContent);
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handleGetPrdByName(projectDir, config, req, res) {
-    try {
-        const { name } = req.params;
-        if (!validatePrdName(name)) {
-            res.status(400).json({ error: "Invalid PRD name" });
-            return;
-        }
-        const nameStr = name;
-        const filename = nameStr.endsWith(".md") ? nameStr : `${nameStr}.md`;
-        const prdPath = path.join(projectDir, config.prdDir, filename);
-        if (!fs.existsSync(prdPath)) {
-            res.status(404).json({ error: "PRD not found" });
-            return;
-        }
-        const content = fs.readFileSync(prdPath, "utf-8");
-        res.json({ name: filename.replace(/\.md$/, ""), content });
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handleGetPrs(projectDir, config, _req, res) {
-    try {
-        const prs = collectPrInfo(projectDir, config.branchPatterns);
-        res.json(prs);
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handleGetLogs(projectDir, _config, req, res) {
-    try {
-        const { name } = req.params;
-        const validNames = ["executor", "reviewer", "qa"];
-        if (!validNames.includes(name)) {
-            res.status(400).json({ error: `Invalid log name. Must be one of: ${validNames.join(", ")}` });
-            return;
-        }
-        const linesParam = req.query.lines;
-        const lines = typeof linesParam === "string" ? parseInt(linesParam, 10) : 200;
-        const linesToRead = isNaN(lines) || lines < 1 ? 200 : Math.min(lines, 10000);
-        // Map logical name (executor/reviewer) to actual file name (night-watch/night-watch-pr-reviewer)
-        const fileName = LOG_FILE_NAMES[name] || name;
-        const logPath = path.join(projectDir, LOG_DIR, `${fileName}.log`);
-        const logLines = getLastLogLines(logPath, linesToRead);
-        res.json({ name, lines: logLines });
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handleGetConfig(config, _req, res) {
-    try {
-        res.json(config);
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handlePutConfig(projectDir, getConfig, reloadConfig, req, res) {
-    try {
-        const changes = req.body;
-        if (typeof changes !== "object" || changes === null) {
-            res.status(400).json({ error: "Invalid request body" });
-            return;
-        }
-        if (changes.provider !== undefined) {
-            const validProviders = ["claude", "codex"];
-            if (!validProviders.includes(changes.provider)) {
-                res.status(400).json({ error: `Invalid provider. Must be one of: ${validProviders.join(", ")}` });
-                return;
-            }
-        }
-        if (changes.reviewerEnabled !== undefined) {
-            if (typeof changes.reviewerEnabled !== "boolean") {
-                res.status(400).json({ error: "reviewerEnabled must be a boolean" });
-                return;
-            }
-        }
-        if (changes.maxRuntime !== undefined) {
-            if (typeof changes.maxRuntime !== "number" || changes.maxRuntime < 60) {
-                res.status(400).json({ error: "maxRuntime must be a number >= 60" });
-                return;
-            }
-        }
-        if (changes.reviewerMaxRuntime !== undefined) {
-            if (typeof changes.reviewerMaxRuntime !== "number" || changes.reviewerMaxRuntime < 60) {
-                res.status(400).json({ error: "reviewerMaxRuntime must be a number >= 60" });
-                return;
-            }
-        }
-        if (changes.minReviewScore !== undefined) {
-            if (typeof changes.minReviewScore !== "number" || changes.minReviewScore < 0 || changes.minReviewScore > 100) {
-                res.status(400).json({ error: "minReviewScore must be a number between 0 and 100" });
-                return;
-            }
-        }
-        if (changes.maxLogSize !== undefined) {
-            if (typeof changes.maxLogSize !== "number" || changes.maxLogSize < 0) {
-                res.status(400).json({ error: "maxLogSize must be a positive number" });
-                return;
-            }
-        }
-        if (changes.branchPatterns !== undefined) {
-            if (!Array.isArray(changes.branchPatterns) || !changes.branchPatterns.every((p) => typeof p === "string")) {
-                res.status(400).json({ error: "branchPatterns must be an array of strings" });
-                return;
-            }
-        }
-        if (changes.prdPriority !== undefined) {
-            if (!Array.isArray(changes.prdPriority) || !changes.prdPriority.every((p) => typeof p === "string")) {
-                res.status(400).json({ error: "prdPriority must be an array of strings" });
-                return;
-            }
-        }
-        if (changes.cronSchedule !== undefined) {
-            if (typeof changes.cronSchedule !== "string" || changes.cronSchedule.trim().length === 0) {
-                res.status(400).json({ error: "cronSchedule must be a non-empty string" });
-                return;
-            }
-        }
-        if (changes.reviewerSchedule !== undefined) {
-            if (typeof changes.reviewerSchedule !== "string" || changes.reviewerSchedule.trim().length === 0) {
-                res.status(400).json({ error: "reviewerSchedule must be a non-empty string" });
-                return;
-            }
-        }
-        if (changes.notifications?.webhooks !== undefined) {
-            if (!Array.isArray(changes.notifications.webhooks)) {
-                res.status(400).json({ error: "notifications.webhooks must be an array" });
-                return;
-            }
-            for (const webhook of changes.notifications.webhooks) {
-                const issues = validateWebhook(webhook);
-                if (issues.length > 0) {
-                    res.status(400).json({ error: `Invalid webhook: ${issues.join(", ")}` });
-                    return;
-                }
-            }
-        }
-        if (changes.roadmapScanner !== undefined) {
-            const rs = changes.roadmapScanner;
-            if (typeof rs !== "object" || rs === null) {
-                res.status(400).json({ error: "roadmapScanner must be an object" });
-                return;
-            }
-            if (rs.enabled !== undefined && typeof rs.enabled !== "boolean") {
-                res.status(400).json({ error: "roadmapScanner.enabled must be a boolean" });
-                return;
-            }
-            if (rs.roadmapPath !== undefined) {
-                if (typeof rs.roadmapPath !== "string" || rs.roadmapPath.trim().length === 0) {
-                    res.status(400).json({ error: "roadmapScanner.roadmapPath must be a non-empty string" });
-                    return;
-                }
-            }
-            if (rs.autoScanInterval !== undefined) {
-                if (typeof rs.autoScanInterval !== "number" || rs.autoScanInterval < 30) {
-                    res.status(400).json({ error: "roadmapScanner.autoScanInterval must be a number >= 30" });
-                    return;
-                }
-            }
-        }
-        const result = saveConfig(projectDir, changes);
-        if (!result.success) {
-            res.status(500).json({ error: result.error });
-            return;
-        }
-        reloadConfig();
-        res.json(getConfig());
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handleGetDoctor(projectDir, config, _req, res) {
-    try {
-        const checks = [];
-        try {
-            execSync("git rev-parse --is-inside-work-tree", { cwd: projectDir, stdio: "pipe" });
-            checks.push({ name: "git", status: "pass", detail: "Git repository detected" });
-        }
-        catch {
-            checks.push({ name: "git", status: "fail", detail: "Not a git repository" });
-        }
-        try {
-            execSync(`which ${config.provider}`, { stdio: "pipe" });
-            checks.push({ name: "provider", status: "pass", detail: `Provider CLI found: ${config.provider}` });
-        }
-        catch {
-            checks.push({ name: "provider", status: "fail", detail: `Provider CLI not found: ${config.provider}` });
-        }
-        try {
-            const projectName = path.basename(projectDir);
-            const marker = generateMarker(projectName);
-            const crontabEntries = [...getEntries(marker), ...getProjectEntries(projectDir)];
-            if (crontabEntries.length > 0) {
-                checks.push({
-                    name: "crontab",
-                    status: "pass",
-                    detail: `${crontabEntries.length} crontab entr(y/ies) installed`,
-                });
-            }
-            else {
-                checks.push({ name: "crontab", status: "warn", detail: "No crontab entries installed" });
-            }
-        }
-        catch (_error) {
-            checks.push({ name: "crontab", status: "fail", detail: "Failed to check crontab" });
-        }
-        const configPath = path.join(projectDir, CONFIG_FILE_NAME);
-        if (fs.existsSync(configPath)) {
-            checks.push({ name: "config", status: "pass", detail: "Config file exists" });
-        }
-        else {
-            checks.push({ name: "config", status: "warn", detail: "Config file not found (using defaults)" });
-        }
-        const prdDir = path.join(projectDir, config.prdDir);
-        if (fs.existsSync(prdDir)) {
-            const prds = fs.readdirSync(prdDir).filter((f) => f.endsWith(".md") && f !== "NIGHT-WATCH-SUMMARY.md");
-            checks.push({ name: "prdDir", status: "pass", detail: `PRD directory exists (${prds.length} PRDs)` });
-        }
-        else {
-            checks.push({ name: "prdDir", status: "warn", detail: `PRD directory not found: ${config.prdDir}` });
-        }
-        res.json(checks);
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handleSpawnAction(projectDir, command, req, res, onSpawned) {
-    try {
-        // Prevent duplicate execution: check the lock file before spawning
-        const lockPath = command[0] === "run"
-            ? executorLockPath(projectDir)
-            : command[0] === "review"
-                ? reviewerLockPath(projectDir)
-                : null;
-        if (lockPath) {
-            const lock = checkLockFile(lockPath);
-            if (lock.running) {
-                const processType = command[0] === "run" ? "Executor" : "Reviewer";
-                res.status(409).json({
-                    error: `${processType} is already running (PID ${lock.pid})`,
-                    pid: lock.pid,
-                });
-                return;
-            }
-        }
-        // Extract optional prdName for priority execution (only for "run" command)
-        const prdName = command[0] === "run" ? req.body?.prdName : undefined;
-        // Build extra env vars for priority hint
-        const extraEnv = {};
-        if (prdName) {
-            extraEnv.NW_PRD_PRIORITY = prdName; // bash script respects NW_PRD_PRIORITY
-        }
-        const child = spawn("night-watch", command, {
-            detached: true,
-            stdio: "ignore",
-            cwd: projectDir,
-            env: { ...process.env, ...extraEnv },
-        });
-        child.unref();
-        if (child.pid !== undefined) {
-            spawnedProcesses.set(child.pid, child);
-            // Fire notification for executor start (non-blocking)
-            if (command[0] === "run") {
-                const config = loadConfig(projectDir);
-                sendNotifications(config, {
-                    event: "run_started",
-                    projectName: path.basename(projectDir),
-                    exitCode: 0,
-                    provider: config.provider,
-                }).catch(() => { });
-            }
-            // Notify SSE clients about executor start
-            if (onSpawned) {
-                onSpawned(child.pid);
-            }
-            res.json({ started: true, pid: child.pid });
-        }
-        else {
-            res.status(500).json({ error: "Failed to spawn process: no PID assigned" });
-        }
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handleGetScheduleInfo(projectDir, config, _req, res) {
-    try {
-        const snapshot = fetchStatusSnapshot(projectDir, config);
-        const installed = snapshot.crontab.installed;
-        const entries = snapshot.crontab.entries;
-        const computeNextRun = (cronExpr) => {
-            try {
-                const interval = CronExpressionParser.parse(cronExpr);
-                return interval.next().toISOString();
-            }
-            catch {
-                return null;
-            }
-        };
-        res.json({
-            executor: {
-                schedule: config.cronSchedule,
-                installed,
-                nextRun: installed ? computeNextRun(config.cronSchedule) : null,
-            },
-            reviewer: {
-                schedule: config.reviewerSchedule,
-                installed: installed && config.reviewerEnabled,
-                nextRun: installed && config.reviewerEnabled ? computeNextRun(config.reviewerSchedule) : null,
-            },
-            qa: {
-                schedule: config.qa.schedule,
-                installed: installed && config.qa.enabled,
-                nextRun: installed && config.qa.enabled ? computeNextRun(config.qa.schedule) : null,
-            },
-            paused: !installed,
-            entries,
-        });
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handleGetRoadmap(projectDir, config, _req, res) {
-    try {
-        const status = getRoadmapStatus(projectDir, config);
-        const prdDir = path.join(projectDir, config.prdDir);
-        const state = loadRoadmapState(prdDir);
-        res.json({
-            ...status,
-            lastScan: state.lastScan || null,
-            autoScanInterval: config.roadmapScanner.autoScanInterval,
-        });
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-async function handlePostRoadmapScan(projectDir, config, _req, res) {
-    try {
-        if (!config.roadmapScanner.enabled) {
-            res.status(409).json({ error: "Roadmap scanner is disabled" });
-            return;
-        }
-        const result = await scanRoadmap(projectDir, config);
-        res.json(result);
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handlePutRoadmapToggle(projectDir, getConfig, reloadConfig, req, res) {
-    try {
-        const { enabled } = req.body;
-        if (typeof enabled !== "boolean") {
-            res.status(400).json({ error: "enabled must be a boolean" });
-            return;
-        }
-        const currentConfig = getConfig();
-        const result = saveConfig(projectDir, {
-            roadmapScanner: {
-                ...currentConfig.roadmapScanner,
-                enabled,
-            },
-        });
-        if (!result.success) {
-            res.status(500).json({ error: result.error });
-            return;
-        }
-        reloadConfig();
-        res.json(getConfig());
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-const BOARD_CACHE_TTL_MS = 60_000; // 60 seconds
-const boardCacheMap = new Map();
-function getCachedBoardData(projectDir) {
-    const entry = boardCacheMap.get(projectDir);
-    if (!entry)
-        return null;
-    if (Date.now() - entry.timestamp > BOARD_CACHE_TTL_MS) {
-        boardCacheMap.delete(projectDir);
-        return null;
-    }
-    return entry.data;
-}
-function setCachedBoardData(projectDir, data) {
-    boardCacheMap.set(projectDir, { data, timestamp: Date.now() });
-}
-function invalidateBoardCache(projectDir) {
-    boardCacheMap.delete(projectDir);
-}
-// ==================== Board Handlers ====================
-function getBoardProvider(config, projectDir) {
-    if (!config.boardProvider?.enabled || !config.boardProvider?.projectNumber) {
-        return null;
-    }
-    return createBoardProvider(config.boardProvider, projectDir);
-}
-async function handleGetBoardStatus(projectDir, config, _req, res) {
-    try {
-        const provider = getBoardProvider(config, projectDir);
-        if (!provider) {
-            res.status(404).json({ error: "Board not configured" });
-            return;
-        }
-        const cached = getCachedBoardData(projectDir);
-        if (cached) {
-            res.json(cached);
-            return;
-        }
-        const issues = await provider.getAllIssues();
-        const columns = {
-            Draft: [], Ready: [], "In Progress": [], Review: [], Done: [],
-        };
-        for (const issue of issues) {
-            const col = issue.column ?? "Draft";
-            columns[col].push(issue);
-        }
-        const result = { enabled: true, columns };
-        setCachedBoardData(projectDir, result);
-        res.json(result);
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-async function handleGetBoardIssues(projectDir, config, _req, res) {
-    try {
-        const provider = getBoardProvider(config, projectDir);
-        if (!provider) {
-            res.status(404).json({ error: "Board not configured" });
-            return;
-        }
-        const issues = await provider.getAllIssues();
-        res.json(issues);
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-async function handlePostBoardIssue(projectDir, config, req, res) {
-    try {
-        const provider = getBoardProvider(config, projectDir);
-        if (!provider) {
-            res.status(404).json({ error: "Board not configured" });
-            return;
-        }
-        const { title, body, column } = req.body;
-        if (!title || typeof title !== "string" || title.trim().length === 0) {
-            res.status(400).json({ error: "title is required" });
-            return;
-        }
-        if (column && !BOARD_COLUMNS.includes(column)) {
-            res.status(400).json({ error: `Invalid column. Must be one of: ${BOARD_COLUMNS.join(", ")}` });
-            return;
-        }
-        const issue = await provider.createIssue({ title: title.trim(), body: body ?? "", column });
-        invalidateBoardCache(projectDir);
-        res.status(201).json(issue);
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-async function handlePatchBoardIssueMove(projectDir, config, req, res) {
-    try {
-        const provider = getBoardProvider(config, projectDir);
-        if (!provider) {
-            res.status(404).json({ error: "Board not configured" });
-            return;
-        }
-        const issueNumber = parseInt(req.params.number, 10);
-        if (isNaN(issueNumber)) {
-            res.status(400).json({ error: "Invalid issue number" });
-            return;
-        }
-        const { column } = req.body;
-        if (!column || !BOARD_COLUMNS.includes(column)) {
-            res.status(400).json({ error: `Invalid column. Must be one of: ${BOARD_COLUMNS.join(", ")}` });
-            return;
-        }
-        await provider.moveIssue(issueNumber, column);
-        invalidateBoardCache(projectDir);
-        res.json({ moved: true });
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-async function handlePostBoardIssueComment(projectDir, config, req, res) {
-    try {
-        const provider = getBoardProvider(config, projectDir);
-        if (!provider) {
-            res.status(404).json({ error: "Board not configured" });
-            return;
-        }
-        const issueNumber = parseInt(req.params.number, 10);
-        if (isNaN(issueNumber)) {
-            res.status(400).json({ error: "Invalid issue number" });
-            return;
-        }
-        const { body } = req.body;
-        if (!body || typeof body !== "string" || body.trim().length === 0) {
-            res.status(400).json({ error: "body is required" });
-            return;
-        }
-        await provider.commentOnIssue(issueNumber, body);
-        invalidateBoardCache(projectDir);
-        res.json({ commented: true });
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-async function handleDeleteBoardIssue(projectDir, config, req, res) {
-    try {
-        const provider = getBoardProvider(config, projectDir);
-        if (!provider) {
-            res.status(404).json({ error: "Board not configured" });
-            return;
-        }
-        const issueNumber = parseInt(req.params.number, 10);
-        if (isNaN(issueNumber)) {
-            res.status(400).json({ error: "Invalid issue number" });
-            return;
-        }
-        await provider.closeIssue(issueNumber);
-        invalidateBoardCache(projectDir);
-        res.json({ closed: true });
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-async function handleCancelAction(projectDir, req, res) {
-    try {
-        const { type = "all" } = req.body;
-        const validTypes = ["run", "review", "all"];
-        if (!validTypes.includes(type)) {
-            res.status(400).json({ error: `Invalid type. Must be one of: ${validTypes.join(", ")}` });
-            return;
-        }
-        const results = await performCancel(projectDir, { type: type, force: true });
-        const hasFailure = results.some((r) => !r.success);
-        res.status(hasFailure ? 500 : 200).json({ results });
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-function handleRetryAction(projectDir, config, req, res) {
-    try {
-        const { prdName } = req.body;
-        if (!prdName || typeof prdName !== "string") {
-            res.status(400).json({ error: "prdName is required" });
-            return;
-        }
-        if (!validatePrdName(prdName)) {
-            res.status(400).json({ error: "Invalid PRD name" });
-            return;
-        }
-        const prdDir = path.join(projectDir, config.prdDir);
-        const normalized = prdName.endsWith(".md") ? prdName : `${prdName}.md`;
-        const pendingPath = path.join(prdDir, normalized);
-        const donePath = path.join(prdDir, "done", normalized);
-        if (fs.existsSync(pendingPath)) {
-            res.json({ message: `"${normalized}" is already pending` });
-            return;
-        }
-        if (!fs.existsSync(donePath)) {
-            res.status(404).json({ error: `PRD "${normalized}" not found in done/` });
-            return;
-        }
-        fs.renameSync(donePath, pendingPath);
-        res.json({ message: `Moved "${normalized}" back to pending` });
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-/**
- * Handle clearing stale executor lock and orphaned claim files.
- * Returns 409 if executor is actively running (should use Stop instead).
- */
-function handleClearLockAction(projectDir, config, sseClients, _req, res) {
-    try {
-        const lockPath = executorLockPath(projectDir);
-        const lock = checkLockFile(lockPath);
-        if (lock.running) {
-            res.status(409).json({ error: "Executor is actively running — use Stop instead" });
-            return;
-        }
-        // Remove the stale lock file if it exists
-        if (fs.existsSync(lockPath)) {
-            fs.unlinkSync(lockPath);
-        }
-        // Clean up any orphaned claim files
-        const prdDir = path.join(projectDir, config.prdDir);
-        if (fs.existsSync(prdDir)) {
-            cleanOrphanedClaims(prdDir);
-        }
-        // Broadcast updated status via SSE
-        broadcastSSE(sseClients, "status_changed", fetchStatusSnapshot(projectDir, config));
-        res.json({ cleared: true });
-    }
-    catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-    }
-}
-/**
- * Recursively clean up orphaned claim files in the PRD directory.
- * A claim is orphaned if the executor is not running.
- */
-function cleanOrphanedClaims(dir) {
-    let entries;
-    try {
-        entries = fs.readdirSync(dir, { withFileTypes: true });
-    }
-    catch {
-        return;
-    }
-    for (const entry of entries) {
-        const fullPath = path.join(dir, entry.name);
-        if (entry.isDirectory() && entry.name !== "done") {
-            cleanOrphanedClaims(fullPath);
-        }
-        else if (entry.name.endsWith(CLAIM_FILE_EXTENSION)) {
-            // This is a claim file - remove it since executor is not running
-            try {
-                fs.unlinkSync(fullPath);
-            }
-            catch {
-                // Ignore errors during cleanup
-            }
-        }
-    }
-}
-// ==================== Static Files + SPA Fallback ====================
-function setupStaticFiles(app) {
-    const webDistPath = path.resolve(__dirname, "../../web/dist");
-    if (fs.existsSync(webDistPath)) {
-        app.use(express.static(webDistPath));
-    }
-    app.use((req, res, next) => {
-        if (req.path.startsWith("/api/")) {
-            next();
-            return;
-        }
-        const indexPath = path.resolve(webDistPath, "index.html");
-        if (fs.existsSync(indexPath)) {
-            res.sendFile(indexPath, (err) => {
-                if (err)
-                    next();
-            });
-        }
-        else {
-            next();
-        }
-    });
-}
-// ==================== Single-Project Mode ====================
-/**
- * Create and configure the Express application (single-project mode)
- */
-export function createApp(projectDir) {
-    const app = express();
-    app.use(cors());
-    app.use(express.json());
-    let config = loadConfig(projectDir);
-    const reloadConfig = () => {
-        config = loadConfig(projectDir);
-    };
-    // SSE client registry for real-time push
-    const sseClients = new Set();
-    // SSE endpoint for real-time status updates
-    app.get("/api/status/events", (req, res) => {
-        res.setHeader("Content-Type", "text/event-stream");
-        res.setHeader("Cache-Control", "no-cache");
-        res.setHeader("Connection", "keep-alive");
-        res.flushHeaders();
-        sseClients.add(res);
-        // Send current snapshot immediately on connect
-        try {
-            const snapshot = fetchStatusSnapshot(projectDir, config);
-            res.write(`event: status_changed\ndata: ${JSON.stringify(snapshot)}\n\n`);
-        }
-        catch {
-            // Ignore errors during initial snapshot
-        }
-        req.on("close", () => {
-            sseClients.delete(res);
-        });
-    });
-    // Start the SSE status watcher (runs until process exits)
-    startSseStatusWatcher(sseClients, projectDir, () => config);
-    // API Routes
-    app.get("/api/status", (req, res) => handleGetStatus(projectDir, config, req, res));
-    app.get("/api/schedule-info", (req, res) => handleGetScheduleInfo(projectDir, config, req, res));
-    app.get("/api/prds", (req, res) => handleGetPrds(projectDir, config, req, res));
-    app.get("/api/prds/:name", (req, res) => handleGetPrdByName(projectDir, config, req, res));
-    app.get("/api/prs", (req, res) => handleGetPrs(projectDir, config, req, res));
-    app.get("/api/logs/:name", (req, res) => handleGetLogs(projectDir, config, req, res));
-    app.get("/api/config", (req, res) => handleGetConfig(config, req, res));
-    app.put("/api/config", (req, res) => handlePutConfig(projectDir, () => config, reloadConfig, req, res));
-    app.get("/api/doctor", (req, res) => handleGetDoctor(projectDir, config, req, res));
-    app.post("/api/actions/run", (req, res) => handleSpawnAction(projectDir, ["run"], req, res, (pid) => {
-        broadcastSSE(sseClients, "executor_started", { pid });
-    }));
-    app.post("/api/actions/review", (req, res) => handleSpawnAction(projectDir, ["review"], req, res));
-    app.post("/api/actions/install-cron", (req, res) => handleSpawnAction(projectDir, ["install"], req, res));
-    app.post("/api/actions/uninstall-cron", (req, res) => handleSpawnAction(projectDir, ["uninstall"], req, res));
-    app.post("/api/actions/cancel", (req, res) => handleCancelAction(projectDir, req, res));
-    app.post("/api/actions/retry", (req, res) => handleRetryAction(projectDir, config, req, res));
-    app.post("/api/actions/clear-lock", (req, res) => handleClearLockAction(projectDir, config, sseClients, req, res));
-    app.get("/api/roadmap", (req, res) => handleGetRoadmap(projectDir, config, req, res));
-    app.post("/api/roadmap/scan", (req, res) => handlePostRoadmapScan(projectDir, config, req, res));
-    app.put("/api/roadmap/toggle", (req, res) => handlePutRoadmapToggle(projectDir, () => config, reloadConfig, req, res));
-    // Board routes
-    app.get("/api/board/status", (req, res) => handleGetBoardStatus(projectDir, config, req, res));
-    app.get("/api/board/issues", (req, res) => handleGetBoardIssues(projectDir, config, req, res));
-    app.post("/api/board/issues", (req, res) => handlePostBoardIssue(projectDir, config, req, res));
-    app.patch("/api/board/issues/:number/move", (req, res) => handlePatchBoardIssueMove(projectDir, config, req, res));
-    app.post("/api/board/issues/:number/comment", (req, res) => handlePostBoardIssueComment(projectDir, config, req, res));
-    app.delete("/api/board/issues/:number", (req, res) => handleDeleteBoardIssue(projectDir, config, req, res));
-    // Auto-scan timer
-    let autoScanTimer = null;
-    function startAutoScan() {
-        stopAutoScan();
-        const currentConfig = loadConfig(projectDir);
-        if (!currentConfig.roadmapScanner.enabled)
-            return;
-        const intervalMs = currentConfig.roadmapScanner.autoScanInterval * 1000;
-        autoScanTimer = setInterval(() => {
-            const cfg = loadConfig(projectDir);
-            if (!cfg.roadmapScanner.enabled)
-                return;
-            const status = getRoadmapStatus(projectDir, cfg);
-            if (status.status === "complete" || status.status === "no-roadmap")
-                return;
-            // Fire and forget - async scan
-            scanRoadmap(projectDir, cfg).catch(() => {
-                // Silently ignore auto-scan errors
-            });
-        }, intervalMs);
-    }
-    function stopAutoScan() {
-        if (autoScanTimer) {
-            clearInterval(autoScanTimer);
-            autoScanTimer = null;
-        }
-    }
-    if (config.roadmapScanner.enabled) {
-        startAutoScan();
-    }
-    setupStaticFiles(app);
-    app.use(errorHandler);
-    return app;
-}
-// ==================== Global (Multi-Project) Mode ====================
-/**
- * Middleware that resolves a project from the registry by :projectId param
- */
-function resolveProject(req, res, next) {
-    const projectId = req.params.projectId;
-    // Decode ~ back to / (frontend encodes / as ~ to avoid Express 5 %2F routing issues)
-    const decodedId = decodeURIComponent(projectId).replace(/~/g, "/");
-    const entries = loadRegistry();
-    const entry = entries.find((e) => e.name === decodedId);
-    if (!entry) {
-        res.status(404).json({ error: `Project not found: ${decodedId}` });
-        return;
-    }
-    if (!fs.existsSync(entry.path) || !fs.existsSync(path.join(entry.path, CONFIG_FILE_NAME))) {
-        res.status(404).json({ error: `Project path invalid or missing config: ${entry.path}` });
-        return;
-    }
-    req.projectDir = entry.path;
-    req.projectConfig = loadConfig(entry.path);
-    next();
-}
-/**
- * Create a router with all project-scoped endpoints
- */
-function createProjectRouter() {
-    const router = Router({ mergeParams: true });
-    // Per-project SSE client registry and watchers
-    const projectSseClients = new Map();
-    const projectSseWatchers = new Map();
-    const dir = (req) => req.projectDir;
-    const cfg = (req) => req.projectConfig;
-    // SSE endpoint for project-scoped status updates
-    router.get("/status/events", (req, res) => {
-        const projectDir = dir(req);
-        const config = cfg(req);
-        // Initialize client set for this project if not exists
-        if (!projectSseClients.has(projectDir)) {
-            projectSseClients.set(projectDir, new Set());
-        }
-        const clients = projectSseClients.get(projectDir);
-        // Start watcher for this project if not already running
-        if (!projectSseWatchers.has(projectDir)) {
-            const watcher = startSseStatusWatcher(clients, projectDir, () => loadConfig(projectDir));
-            projectSseWatchers.set(projectDir, watcher);
-        }
-        res.setHeader("Content-Type", "text/event-stream");
-        res.setHeader("Cache-Control", "no-cache");
-        res.setHeader("Connection", "keep-alive");
-        res.flushHeaders();
-        clients.add(res);
-        // Send current snapshot immediately on connect
-        try {
-            const snapshot = fetchStatusSnapshot(projectDir, config);
-            res.write(`event: status_changed\ndata: ${JSON.stringify(snapshot)}\n\n`);
-        }
-        catch {
-            // Ignore errors during initial snapshot
-        }
-        req.on("close", () => {
-            clients.delete(res);
-        });
-    });
-    router.get("/status", (req, res) => handleGetStatus(dir(req), cfg(req), req, res));
-    router.get("/schedule-info", (req, res) => handleGetScheduleInfo(dir(req), cfg(req), req, res));
-    router.get("/prds", (req, res) => handleGetPrds(dir(req), cfg(req), req, res));
-    router.get("/prds/:name", (req, res) => handleGetPrdByName(dir(req), cfg(req), req, res));
-    router.get("/prs", (req, res) => handleGetPrs(dir(req), cfg(req), req, res));
-    router.get("/logs/:name", (req, res) => handleGetLogs(dir(req), cfg(req), req, res));
-    router.get("/config", (req, res) => handleGetConfig(cfg(req), req, res));
-    router.put("/config", (req, res) => {
-        const projectDir = dir(req);
-        let config = cfg(req);
-        handlePutConfig(projectDir, () => config, () => { config = loadConfig(projectDir); }, req, res);
-    });
-    router.get("/doctor", (req, res) => handleGetDoctor(dir(req), cfg(req), req, res));
-    router.post("/actions/run", (req, res) => {
-        const projectDir = dir(req);
-        handleSpawnAction(projectDir, ["run"], req, res, (pid) => {
-            const clients = projectSseClients.get(projectDir);
-            if (clients) {
-                broadcastSSE(clients, "executor_started", { pid });
-            }
-        });
-    });
-    router.post("/actions/review", (req, res) => handleSpawnAction(dir(req), ["review"], req, res));
-    router.post("/actions/install-cron", (req, res) => handleSpawnAction(dir(req), ["install"], req, res));
-    router.post("/actions/uninstall-cron", (req, res) => handleSpawnAction(dir(req), ["uninstall"], req, res));
-    router.post("/actions/cancel", (req, res) => handleCancelAction(dir(req), req, res));
-    router.post("/actions/retry", (req, res) => handleRetryAction(dir(req), cfg(req), req, res));
-    router.post("/actions/clear-lock", (req, res) => {
-        const projectDir = dir(req);
-        const config = cfg(req);
-        const clients = projectSseClients.get(projectDir);
-        handleClearLockAction(projectDir, config, clients ?? new Set(), req, res);
-    });
-    router.get("/roadmap", (req, res) => handleGetRoadmap(dir(req), cfg(req), req, res));
-    router.post("/roadmap/scan", (req, res) => handlePostRoadmapScan(dir(req), cfg(req), req, res));
-    router.put("/roadmap/toggle", (req, res) => {
-        const projectDir = dir(req);
-        let config = cfg(req);
-        handlePutRoadmapToggle(projectDir, () => config, () => {
-            config = loadConfig(projectDir);
-        }, req, res);
-    });
-    // Board routes
-    router.get("/board/status", (req, res) => handleGetBoardStatus(dir(req), cfg(req), req, res));
-    router.get("/board/issues", (req, res) => handleGetBoardIssues(dir(req), cfg(req), req, res));
-    router.post("/board/issues", (req, res) => handlePostBoardIssue(dir(req), cfg(req), req, res));
-    router.patch("/board/issues/:number/move", (req, res) => handlePatchBoardIssueMove(dir(req), cfg(req), req, res));
-    router.post("/board/issues/:number/comment", (req, res) => handlePostBoardIssueComment(dir(req), cfg(req), req, res));
-    router.delete("/board/issues/:number", (req, res) => handleDeleteBoardIssue(dir(req), cfg(req), req, res));
-    return router;
-}
-/**
- * Create the Express application for global (multi-project) mode
- */
-export function createGlobalApp() {
-    const app = express();
-    app.use(cors());
-    app.use(express.json());
-    // List all registered projects
-    app.get("/api/projects", (_req, res) => {
-        try {
-            const entries = loadRegistry();
-            const { invalid } = validateRegistry();
-            const invalidPaths = new Set(invalid.map((e) => e.path));
-            res.json(entries.map((e) => ({
-                name: e.name,
-                path: e.path,
-                valid: !invalidPaths.has(e.path),
-            })));
-        }
-        catch (error) {
-            res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
-        }
-    });
-    // Project-scoped routes
-    app.use("/api/projects/:projectId", resolveProject, createProjectRouter());
-    setupStaticFiles(app);
-    app.use(errorHandler);
-    return app;
-}
-// ==================== Server Startup ====================
-/**
- * Graceful shutdown handler
- */
-function setupGracefulShutdown(server) {
-    process.on("SIGTERM", () => {
-        console.log("SIGTERM received, shutting down server...");
-        server.close(() => {
-            console.log("Server closed");
-            process.exit(0);
-        });
-    });
-    process.on("SIGINT", () => {
-        console.log("\nSIGINT received, shutting down server...");
-        server.close(() => {
-            console.log("Server closed");
-            process.exit(0);
-        });
-    });
-}
-/**
- * Start the HTTP server (single-project mode)
- */
-export function startServer(projectDir, port) {
-    const app = createApp(projectDir);
-    const server = app.listen(port, () => {
-        console.log(`Night Watch UI running at http://localhost:${port}`);
-    });
-    setupGracefulShutdown(server);
-}
-/**
- * Start the HTTP server (global multi-project mode)
- */
-export function startGlobalServer(port) {
-    const entries = loadRegistry();
-    if (entries.length === 0) {
-        console.error("No projects registered. Run 'night-watch init' in a project first.");
-        process.exit(1);
-    }
-    const { valid, invalid } = validateRegistry();
-    if (invalid.length > 0) {
-        console.warn(`Warning: ${invalid.length} registered project(s) have invalid paths and will be skipped.`);
-    }
-    console.log(`Managing ${valid.length} project(s):`);
-    valid.forEach((p) => console.log(`  - ${p.name} (${p.path})`));
-    const app = createGlobalApp();
-    const server = app.listen(port, () => {
-        console.log(`Night Watch Global UI running at http://localhost:${port}`);
-    });
-    setupGracefulShutdown(server);
-}
-//# sourceMappingURL=index.js.map