@n-dx/web 0.1.0

package/dist/server/routes-rex/execution.js

@@ -0,0 +1,355 @@
+/**
+ * Execution routes: epic-by-epic orchestration, status, pause, resume.
+ *
+ * Manages the in-memory execution state machine that runs hench
+ * sequentially across epics, with pause/resume support.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { spawnManaged, killWithFallback } from "@n-dx/llm-client";
+import { jsonResponse, errorResponse, readBody } from "../types.js";
+import { findItemById, loadPRD, appendLog } from "./shared.js";
+import { computeStats, isRootLevel, } from "../rex-gateway.js";
+// ---------------------------------------------------------------------------
+// Singleton state
+// ---------------------------------------------------------------------------
+/** Singleton execution state. Reset on server restart. */
+let executionState = {
+    status: "idle",
+    currentEpicIndex: -1,
+    epics: [],
+};
+/** Reference to the current hench child process (if any). */
+let henchProcess = null;
+/** Context and broadcast saved during execution for resume. */
+let savedCtx = null;
+let savedBroadcast;
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Broadcast the current execution state over WebSocket. */
+function broadcastExecutionState(broadcast) {
+    if (!broadcast)
+        return;
+    broadcast({
+        type: "rex:execution-progress",
+        state: getExecutionStatusPayload(),
+        timestamp: new Date().toISOString(),
+    });
+}
+/** Build the status payload returned by the status endpoint and broadcasts. */
+function getExecutionStatusPayload() {
+    const { status, startedAt, finishedAt, currentEpicId, currentEpicIndex, epics, error } = executionState;
+    const totalEpics = epics.length;
+    const completedEpics = epics.filter((e) => e.status === "completed").length;
+    const totalTasks = epics.reduce((s, e) => s + e.tasksTotal, 0);
+    const completedTasks = epics.reduce((s, e) => s + e.tasksCompleted, 0);
+    return {
+        status,
+        startedAt,
+        finishedAt,
+        currentEpicId,
+        currentEpicIndex,
+        totalEpics,
+        completedEpics,
+        totalTasks,
+        completedTasks,
+        percentComplete: totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0,
+        epics: epics.map((e) => ({ ...e })),
+        error,
+    };
+}
+/** Refresh epic task counts from the PRD on disk. */
+function refreshEpicProgress(ctx) {
+    const doc = loadPRD(ctx);
+    if (!doc)
+        return;
+    for (const ep of executionState.epics) {
+        const epicItem = findItemById(doc.items, ep.id);
+        if (!epicItem)
+            continue;
+        const stats = computeStats(epicItem.children ?? []);
+        ep.tasksTotal = stats.total;
+        ep.tasksCompleted = stats.completed;
+    }
+}
+/**
+ * Run the hench CLI for one epic.
+ * Returns a promise that resolves when hench exits.
+ */
+async function runHenchForEpic(ctx, epicId) {
+    const henchBin = join(ctx.projectDir, "node_modules", ".bin", "hench");
+    const henchFallback = join(ctx.projectDir, "packages", "hench", "dist", "cli", "index.js");
+    const args = ["run", "--epic=" + epicId, "--loop", "--auto", ctx.projectDir];
+    const binPath = existsSync(henchBin) ? henchBin : "node";
+    const binArgs = existsSync(henchBin) ? args : [henchFallback, ...args];
+    const handle = spawnManaged(binPath, binArgs, {
+        cwd: ctx.projectDir,
+        stdio: "inherit",
+        env: { ...process.env },
+    });
+    henchProcess = handle;
+    const result = await handle.done;
+    if (henchProcess === handle)
+        henchProcess = null;
+    return { code: result.exitCode, signal: null };
+}
+/**
+ * Execute epics sequentially, starting from the current index.
+ * Respects pause state and broadcasts progress.
+ */
+async function executeEpicSequence(ctx, broadcast) {
+    while (executionState.currentEpicIndex < executionState.epics.length) {
+        // Check for pause
+        if (executionState.status === "paused")
+            return;
+        if (executionState.status !== "running")
+            return;
+        const epicIdx = executionState.currentEpicIndex;
+        const epic = executionState.epics[epicIdx];
+        // Refresh task counts before starting
+        refreshEpicProgress(ctx);
+        broadcastExecutionState(broadcast);
+        // Skip epics with no actionable tasks
+        if (epic.tasksTotal === 0 || epic.tasksCompleted >= epic.tasksTotal) {
+            epic.status = epic.tasksTotal === 0 ? "skipped" : "completed";
+            epic.finishedAt = new Date().toISOString();
+            executionState.currentEpicIndex++;
+            broadcastExecutionState(broadcast);
+            continue;
+        }
+        // Start this epic
+        epic.status = "running";
+        epic.startedAt = new Date().toISOString();
+        executionState.currentEpicId = epic.id;
+        broadcastExecutionState(broadcast);
+        // Run hench for this epic
+        const result = await runHenchForEpic(ctx, epic.id);
+        // Refresh task counts after hench finishes
+        refreshEpicProgress(ctx);
+        // Check if we were paused/stopped while hench was running
+        // (status can change via pause endpoint during the await above)
+        const currentStatus = executionState.status;
+        if (currentStatus === "paused") {
+            epic.status = "pending"; // Revert to pending — will resume later
+            epic.startedAt = undefined;
+            broadcastExecutionState(broadcast);
+            return;
+        }
+        if (currentStatus !== "running")
+            return;
+        // Mark epic as completed or failed
+        if (result.code === 0 || epic.tasksCompleted >= epic.tasksTotal) {
+            epic.status = "completed";
+        }
+        else {
+            // Non-zero exit but some tasks may have completed
+            // Mark completed if all tasks done, otherwise move on
+            epic.status = epic.tasksCompleted >= epic.tasksTotal ? "completed" : "completed";
+        }
+        epic.finishedAt = new Date().toISOString();
+        executionState.currentEpicIndex++;
+        broadcastExecutionState(broadcast);
+    }
+    // All epics processed
+    if (executionState.status === "running") {
+        executionState.status = "completed";
+        executionState.finishedAt = new Date().toISOString();
+        executionState.currentEpicId = undefined;
+        appendLog(ctx, {
+            timestamp: new Date().toISOString(),
+            event: "epic_by_epic_completed",
+            detail: `Epic-by-epic execution completed. ${executionState.epics.filter((e) => e.status === "completed").length}/${executionState.epics.length} epics processed.`,
+        });
+        broadcastExecutionState(broadcast);
+    }
+}
+// ---------------------------------------------------------------------------
+// Route dispatcher
+// ---------------------------------------------------------------------------
+/** Execution routes: epic-by-epic, status, pause, resume. */
+export function routeExecution(path, method, req, res, ctx, broadcast) {
+    // POST /api/rex/execute/epic-by-epic — start epic-by-epic execution
+    if (path === "execute/epic-by-epic" && method === "POST") {
+        return handleStartEpicByEpic(req, res, ctx, broadcast);
+    }
+    // GET /api/rex/execute/status — current execution state
+    if (path === "execute/status" && method === "GET") {
+        return handleExecutionStatus(res);
+    }
+    // POST /api/rex/execute/pause — pause execution
+    if (path === "execute/pause" && method === "POST") {
+        return handleExecutionPause(res, broadcast);
+    }
+    // POST /api/rex/execute/resume — resume execution
+    if (path === "execute/resume" && method === "POST") {
+        return handleExecutionResume(res, ctx, broadcast);
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Route handlers
+// ---------------------------------------------------------------------------
+/** Handle POST /api/rex/execute/epic-by-epic — start sequential epic execution. */
+async function handleStartEpicByEpic(req, res, ctx, broadcast) {
+    // Don't allow starting if already running
+    if (executionState.status === "running" || executionState.status === "paused") {
+        errorResponse(res, 409, `Execution already ${executionState.status}. Use pause/resume or wait for completion.`);
+        return true;
+    }
+    const doc = loadPRD(ctx);
+    if (!doc) {
+        errorResponse(res, 404, "No PRD data found");
+        return true;
+    }
+    try {
+        const body = await readBody(req);
+        const input = JSON.parse(body);
+        // Build the list of epics to execute
+        const allEpics = doc.items.filter((item) => isRootLevel(item.level));
+        let epicsToRun;
+        if (input.epicIds && input.epicIds.length > 0) {
+            epicsToRun = input.epicIds
+                .map((id) => allEpics.find((e) => e.id === id))
+                .filter((e) => e != null);
+        }
+        else {
+            // All epics that aren't fully completed
+            epicsToRun = allEpics.filter((epic) => {
+                const stats = computeStats(epic.children ?? []);
+                return stats.total === 0 || stats.completed < stats.total;
+            });
+        }
+        if (epicsToRun.length === 0) {
+            jsonResponse(res, 200, { ok: true, message: "No actionable epics to execute" });
+            return true;
+        }
+        // Initialize execution state
+        executionState = {
+            status: "running",
+            startedAt: new Date().toISOString(),
+            currentEpicIndex: 0,
+            epics: epicsToRun.map((epic) => {
+                const stats = computeStats(epic.children ?? []);
+                return {
+                    id: epic.id,
+                    title: epic.title,
+                    status: "pending",
+                    tasksTotal: stats.total,
+                    tasksCompleted: stats.completed,
+                };
+            }),
+        };
+        savedCtx = ctx;
+        savedBroadcast = broadcast;
+        appendLog(ctx, {
+            timestamp: new Date().toISOString(),
+            event: "epic_by_epic_started",
+            detail: `Started epic-by-epic execution with ${epicsToRun.length} epics: ${epicsToRun.map((e) => e.title).join(", ")}`,
+        });
+        broadcastExecutionState(broadcast);
+        // Respond immediately — execution runs in the background
+        jsonResponse(res, 200, {
+            ok: true,
+            epicCount: epicsToRun.length,
+            epics: executionState.epics.map((e) => ({ id: e.id, title: e.title })),
+        });
+        // Start execution asynchronously (don't await)
+        executeEpicSequence(ctx, broadcast).catch((err) => {
+            executionState.status = "failed";
+            executionState.error = String(err);
+            executionState.finishedAt = new Date().toISOString();
+            broadcastExecutionState(broadcast);
+        });
+    }
+    catch (err) {
+        errorResponse(res, 400, String(err));
+    }
+    return true;
+}
+/** Handle GET /api/rex/execute/status — return current execution state. */
+function handleExecutionStatus(res) {
+    // Refresh epic progress if running
+    if (savedCtx && (executionState.status === "running" || executionState.status === "paused")) {
+        refreshEpicProgress(savedCtx);
+    }
+    jsonResponse(res, 200, getExecutionStatusPayload());
+    return true;
+}
+/** Handle POST /api/rex/execute/pause — pause the current execution. */
+function handleExecutionPause(res, broadcast) {
+    if (executionState.status !== "running") {
+        errorResponse(res, 409, `Cannot pause: execution is ${executionState.status}`);
+        return true;
+    }
+    executionState.status = "paused";
+    // Kill the current hench process if running
+    if (henchProcess) {
+        henchProcess.kill("SIGINT");
+        henchProcess = null;
+    }
+    broadcastExecutionState(broadcast);
+    jsonResponse(res, 200, { ok: true, status: "paused" });
+    return true;
+}
+/** Handle POST /api/rex/execute/resume — resume a paused execution. */
+function handleExecutionResume(res, ctx, broadcast) {
+    if (executionState.status !== "paused") {
+        errorResponse(res, 409, `Cannot resume: execution is ${executionState.status}`);
+        return true;
+    }
+    executionState.status = "running";
+    savedCtx = ctx;
+    savedBroadcast = broadcast;
+    broadcastExecutionState(broadcast);
+    jsonResponse(res, 200, { ok: true, status: "running" });
+    // Continue execution asynchronously
+    executeEpicSequence(ctx, broadcast).catch((err) => {
+        executionState.status = "failed";
+        executionState.error = String(err);
+        executionState.finishedAt = new Date().toISOString();
+        broadcastExecutionState(broadcast);
+    });
+    return true;
+}
+/**
+ * Terminate any active rex epic-by-epic hench process.
+ *
+ * Called during server graceful shutdown to ensure the hench child spawned
+ * by the rex execution engine is cleaned up alongside the hench-route
+ * executions. Mirrors the pattern used by `shutdownActiveExecutions` in
+ * routes-hench.ts.
+ *
+ * @param gracePeriodMs  How long to wait for graceful SIGTERM before
+ *                       sending SIGKILL (default: HENCH_SHUTDOWN_TIMEOUT_MS
+ *                       env var, or 5 000 ms).
+ * @returns Result indicating whether the process was present and terminated.
+ */
+export async function shutdownRexExecution(gracePeriodMs = Number(process.env["HENCH_SHUTDOWN_TIMEOUT_MS"] ?? 5_000)) {
+    if (!henchProcess)
+        return { hadActiveProcess: false, terminated: false };
+    const handle = henchProcess;
+    const pid = handle.pid;
+    const pidInfo = pid != null ? ` (pid ${pid})` : "";
+    henchProcess = null;
+    console.log(`[shutdown] terminating rex epic-by-epic execution${pidInfo}`);
+    let terminated = false;
+    try {
+        await killWithFallback(handle, gracePeriodMs);
+        console.log(`[shutdown] rex epic-by-epic execution${pidInfo} terminated`);
+        terminated = true;
+    }
+    catch (err) {
+        const error = err;
+        console.error(`[shutdown] rex epic-by-epic execution${pidInfo} failed to terminate: ${error.message}`);
+    }
+    // Mark execution as failed so callers (status endpoint, WebSocket) see a
+    // clean terminal state rather than a stale "running" after restart.
+    if (executionState.status === "running" || executionState.status === "paused") {
+        executionState.status = "failed";
+        executionState.error = "Server shutting down";
+        executionState.finishedAt = new Date().toISOString();
+    }
+    return { hadActiveProcess: true, terminated };
+}
+//# sourceMappingURL=execution.js.map

package/dist/server/routes-rex/execution.js.map

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

package/dist/server/routes-rex/health.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Health and reorganize routes: structure health score, reorganization proposals.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ServerContext } from "../types.js";
+import type { WebSocketBroadcaster } from "../websocket.js";
+/** Health and reorganize routes. */
+export declare function routeHealthReorganize(path: string, method: string, req: IncomingMessage, res: ServerResponse, ctx: ServerContext, broadcast?: WebSocketBroadcaster): boolean | Promise<boolean>;

package/dist/server/routes-rex/health.js

@@ -0,0 +1,136 @@
+/**
+ * Health and reorganize routes: structure health score, reorganization proposals.
+ */
+import { jsonResponse, errorResponse, readBody } from "../types.js";
+import { loadPRD, savePRD } from "./shared.js";
+import { computeHealthScore, detectReorganizations, applyProposals, applyReshape, } from "../rex-gateway.js";
+/** Health and reorganize routes. */
+export function routeHealthReorganize(path, method, req, res, ctx, broadcast) {
+    // GET /api/rex/health — structure health score
+    if (path === "health" && method === "GET") {
+        const doc = loadPRD(ctx);
+        if (!doc) {
+            errorResponse(res, 404, "No PRD data found");
+            return true;
+        }
+        const health = computeHealthScore(doc.items);
+        jsonResponse(res, 200, health);
+        return true;
+    }
+    // GET /api/rex/reorganize — detect reorganization proposals
+    // Query params: mode=fast|full (default: full)
+    if (path === "reorganize" && method === "GET") {
+        return (async () => {
+            const doc = loadPRD(ctx);
+            if (!doc) {
+                errorResponse(res, 404, "No PRD data found");
+                return true;
+            }
+            if (doc.items.length === 0) {
+                jsonResponse(res, 200, { structural: { proposals: [], stats: {} }, llm: [] });
+                return true;
+            }
+            const urlObj = new URL(req.url || "/", `http://${req.headers.host || "localhost"}`);
+            const mode = urlObj.searchParams.get("mode") ?? "full";
+            const plan = detectReorganizations(doc.items);
+            const structural = {
+                proposals: plan.proposals.map((p) => ({
+                    id: p.id,
+                    type: p.type,
+                    description: p.description,
+                    risk: p.risk,
+                    confidence: p.confidence,
+                    items: p.items,
+                })),
+                stats: plan.stats,
+            };
+            let llm = [];
+            if (mode !== "fast") {
+                try {
+                    const { reasonForReshape } = await import("../rex-gateway.js");
+                    const { proposals } = await reasonForReshape(doc.items, { dir: ctx.projectDir });
+                    llm = proposals.map((p) => ({
+                        id: p.id,
+                        action: p.action.action,
+                        reason: p.action.reason,
+                    }));
+                }
+                catch {
+                    // LLM unavailable — return structural only
+                }
+            }
+            jsonResponse(res, 200, { structural, llm });
+            return true;
+        })();
+    }
+    // POST /api/rex/reorganize/apply — apply selected proposals
+    // Body: { proposalIds?: number[], llmProposalIds?: string[] }
+    if (path === "reorganize/apply" && method === "POST") {
+        return (async () => {
+            const doc = loadPRD(ctx);
+            if (!doc) {
+                errorResponse(res, 404, "No PRD data found");
+                return true;
+            }
+            const body = await readBody(req);
+            let proposalIds;
+            let llmProposalIds;
+            try {
+                const parsed = JSON.parse(body);
+                proposalIds = parsed.proposalIds ?? [];
+                llmProposalIds = parsed.llmProposalIds ?? [];
+            }
+            catch {
+                errorResponse(res, 400, "Invalid JSON body");
+                return true;
+            }
+            let structuralApplied = 0;
+            let structuralFailed = 0;
+            // Apply structural proposals
+            if (proposalIds.length > 0 || (llmProposalIds.length === 0 && proposalIds.length === 0)) {
+                const plan = detectReorganizations(doc.items);
+                const toApply = proposalIds.length > 0
+                    ? plan.proposals.filter((p) => proposalIds.includes(p.id))
+                    : plan.proposals.filter((p) => p.risk === "low");
+                if (toApply.length > 0) {
+                    const result = applyProposals(doc.items, toApply);
+                    structuralApplied = result.applied;
+                    structuralFailed = result.failed;
+                }
+            }
+            // Apply LLM proposals
+            let llmApplied = 0;
+            let llmFailed = 0;
+            if (llmProposalIds.length > 0) {
+                try {
+                    const { reasonForReshape } = await import("../rex-gateway.js");
+                    const { proposals } = await reasonForReshape(doc.items, { dir: ctx.projectDir });
+                    const toApply = proposals.filter((p) => llmProposalIds.includes(p.id));
+                    if (toApply.length > 0) {
+                        const reshapeResult = applyReshape(doc.items, toApply);
+                        llmApplied = reshapeResult.applied.length;
+                        llmFailed = reshapeResult.errors.length;
+                    }
+                }
+                catch {
+                    // LLM unavailable
+                }
+            }
+            const totalApplied = structuralApplied + llmApplied;
+            if (totalApplied > 0) {
+                savePRD(ctx, doc);
+                if (broadcast)
+                    broadcast({ type: "rex:prd-changed", source: "reorganize" });
+            }
+            jsonResponse(res, 200, {
+                applied: totalApplied,
+                failed: structuralFailed + llmFailed,
+                structuralApplied,
+                llmApplied,
+            });
+            return true;
+        })();
+    }
+    return false;
+}
+//# sourceMappingURL=health.js.map

package/dist/server/routes-rex/health.js.map

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

package/dist/server/routes-rex/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Rex API routes — CRUD for PRD items, tree stats, next task, and log entries.
+ *
+ * All endpoints are under /api/rex/.
+ *
+ * This module is the entry point for rex routing. It delegates to focused
+ * sub-modules for each domain area:
+ *
+ *   reads.ts        — PRD read routes (prd, stats, dashboard, next, log)
+ *   items.ts        — Item CRUD (add, get, patch, bulk, merge, delete)
+ *   requirements.ts — Requirements CRUD, coverage, traceability
+ *   prune.ts        — Prune preview and execution
+ *   analysis.ts     — Analysis, proposals, smart-add, batch-import
+ *   execution.ts    — Epic-by-epic execution, pause/resume, shutdown
+ *   health.ts       — Health score and reorganization proposals
+ *   shared.ts       — Shared helpers (load/save PRD, appendLog, etc.)
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ServerContext } from "../types.js";
+import type { WebSocketBroadcaster } from "../websocket.js";
+/**
+ * Handle Rex API requests. Returns true if the request was handled.
+ *
+ * Delegates to focused sub-routers for each domain area:
+ * - PRD reads (prd, stats, dashboard, next, log)
+ * - Item CRUD (add, get, patch, bulk, merge)
+ * - Requirements (item requirements CRUD, coverage, traceability)
+ * - Prune (preview, execute)
+ * - Proposals (analyze, proposals, smart-add, batch-import)
+ * - Execution (epic-by-epic, status, pause, resume)
+ * - Health & reorganize (health score, proposals, apply)
+ */
+export declare function handleRexRoute(req: IncomingMessage, res: ServerResponse, ctx: ServerContext, broadcast?: WebSocketBroadcaster): boolean | Promise<boolean>;
+export { shutdownRexExecution } from "./execution.js";
+export type { ShutdownRexResult } from "./execution.js";

package/dist/server/routes-rex/index.js

@@ -0,0 +1,72 @@
+/**
+ * Rex API routes — CRUD for PRD items, tree stats, next task, and log entries.
+ *
+ * All endpoints are under /api/rex/.
+ *
+ * This module is the entry point for rex routing. It delegates to focused
+ * sub-modules for each domain area:
+ *
+ *   reads.ts        — PRD read routes (prd, stats, dashboard, next, log)
+ *   items.ts        — Item CRUD (add, get, patch, bulk, merge, delete)
+ *   requirements.ts — Requirements CRUD, coverage, traceability
+ *   prune.ts        — Prune preview and execution
+ *   analysis.ts     — Analysis, proposals, smart-add, batch-import
+ *   execution.ts    — Epic-by-epic execution, pause/resume, shutdown
+ *   health.ts       — Health score and reorganization proposals
+ *   shared.ts       — Shared helpers (load/save PRD, appendLog, etc.)
+ */
+import { routePrdReads } from "./reads.js";
+import { routeItems } from "./items.js";
+import { routeItemRequirements, routeRequirementsAnalytics } from "./requirements.js";
+import { routePrune } from "./prune.js";
+import { routeProposals } from "./analysis.js";
+import { routeExecution } from "./execution.js";
+import { routeHealthReorganize } from "./health.js";
+const REX_PREFIX = "/api/rex/";
+/**
+ * Handle Rex API requests. Returns true if the request was handled.
+ *
+ * Delegates to focused sub-routers for each domain area:
+ * - PRD reads (prd, stats, dashboard, next, log)
+ * - Item CRUD (add, get, patch, bulk, merge)
+ * - Requirements (item requirements CRUD, coverage, traceability)
+ * - Prune (preview, execute)
+ * - Proposals (analyze, proposals, smart-add, batch-import)
+ * - Execution (epic-by-epic, status, pause, resume)
+ * - Health & reorganize (health score, proposals, apply)
+ */
+export function handleRexRoute(req, res, ctx, broadcast) {
+    const url = req.url || "/";
+    const method = req.method || "GET";
+    if (!url.startsWith(REX_PREFIX))
+        return false;
+    const fullPath = url.slice(REX_PREFIX.length);
+    const qIdx = fullPath.indexOf("?");
+    const path = qIdx === -1 ? fullPath : fullPath.slice(0, qIdx);
+    // Try each sub-router in turn. The first to return non-false wins.
+    const prdResult = routePrdReads(url, path, method, res, ctx);
+    if (prdResult !== false)
+        return prdResult;
+    const itemsResult = routeItems(path, method, req, res, ctx, broadcast, routeItemRequirements);
+    if (itemsResult !== false)
+        return itemsResult;
+    const reqAnalyticsResult = routeRequirementsAnalytics(path, method, res, ctx);
+    if (reqAnalyticsResult !== false)
+        return reqAnalyticsResult;
+    const pruneResult = routePrune(path, method, req, res, ctx, broadcast);
+    if (pruneResult !== false)
+        return pruneResult;
+    const proposalResult = routeProposals(path, method, req, res, ctx, broadcast);
+    if (proposalResult !== false)
+        return proposalResult;
+    const execResult = routeExecution(path, method, req, res, ctx, broadcast);
+    if (execResult !== false)
+        return execResult;
+    const healthResult = routeHealthReorganize(path, method, req, res, ctx, broadcast);
+    if (healthResult !== false)
+        return healthResult;
+    return false;
+}
+// Re-export shutdown for use by start.ts
+export { shutdownRexExecution } from "./execution.js";
+//# sourceMappingURL=index.js.map

package/dist/server/routes-rex/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/routes-rex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,UAAU,GAAG,WAAW,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAoB,EACpB,GAAmB,EACnB,GAAkB,EAClB,SAAgC;IAEhC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;IAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;IAEnC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9C,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAE9D,mEAAmE;IACnE,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7D,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IAE1C,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;IAC9F,IAAI,WAAW,KAAK,KAAK;QAAE,OAAO,WAAW,CAAC;IAE9C,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9E,IAAI,kBAAkB,KAAK,KAAK;QAAE,OAAO,kBAAkB,CAAC;IAE5D,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACvE,IAAI,WAAW,KAAK,KAAK;QAAE,OAAO,WAAW,CAAC;IAE9C,MAAM,cAAc,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAC9E,IAAI,cAAc,KAAK,KAAK;QAAE,OAAO,cAAc,CAAC;IAEpD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAC1E,IAAI,UAAU,KAAK,KAAK;QAAE,OAAO,UAAU,CAAC;IAE5C,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACnF,IAAI,YAAY,KAAK,KAAK;QAAE,OAAO,YAAY,CAAC;IAEhD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yCAAyC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/server/routes-rex/items.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Item CRUD routes: add, get, patch, delete, bulk update, merge.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ServerContext } from "../types.js";
+import type { WebSocketBroadcaster } from "../websocket.js";
+/** Item CRUD routes: add, get, patch, bulk update, merge. */
+export declare function routeItems(path: string, method: string, req: IncomingMessage, res: ServerResponse, ctx: ServerContext, broadcast?: WebSocketBroadcaster, routeItemRequirements?: (path: string, method: string, req: IncomingMessage, res: ServerResponse, ctx: ServerContext, itemId: string, broadcast?: WebSocketBroadcaster) => boolean | Promise<boolean>): boolean | Promise<boolean>;