@n-dx/core 0.1.0

package/packages/web/dist/server/routes-rex/requirements.js

@@ -0,0 +1,408 @@
+/**
+ * Requirements routes: CRUD on item requirements, coverage stats, traceability matrix.
+ */
+import { randomUUID } from "node:crypto";
+import { jsonResponse, errorResponse, readBody } from "../types.js";
+import { findItemById, loadPRD, savePRD, appendLog } from "./shared.js";
+import { isPriority, isRequirementCategory, isValidationType, VALID_REQUIREMENT_CATEGORIES, VALID_VALIDATION_TYPES, } from "../rex-gateway.js";
+// ---------------------------------------------------------------------------
+// Route dispatchers
+// ---------------------------------------------------------------------------
+/** Item requirements sub-routes: CRUD on /api/rex/items/:id/requirements. */
+export function routeItemRequirements(path, method, req, res, ctx, itemId, broadcast) {
+    const reqSubMatch = path.match(/^items\/[^/?]+\/requirements(?:\/([^/?]+))?$/);
+    if (!reqSubMatch)
+        return false;
+    const reqId = reqSubMatch[1]; // undefined for collection routes
+    // GET /api/rex/items/:id/requirements — list requirements (own + inherited)
+    if (method === "GET" && !reqId) {
+        return handleGetRequirements(res, ctx, itemId);
+    }
+    // POST /api/rex/items/:id/requirements — add a requirement
+    if (method === "POST" && !reqId) {
+        return handleAddRequirement(req, res, ctx, itemId, broadcast);
+    }
+    // PATCH /api/rex/items/:id/requirements/:reqId — update a requirement
+    if (method === "PATCH" && reqId) {
+        return handleUpdateRequirement(req, res, ctx, itemId, reqId, broadcast);
+    }
+    // DELETE /api/rex/items/:id/requirements/:reqId — delete a requirement
+    if (method === "DELETE" && reqId) {
+        return handleDeleteRequirement(res, ctx, itemId, reqId, broadcast);
+    }
+    return false;
+}
+/** Requirements coverage & traceability top-level routes. */
+export function routeRequirementsAnalytics(path, method, res, ctx) {
+    if (path === "requirements/coverage" && method === "GET") {
+        return handleRequirementsCoverage(res, ctx);
+    }
+    if (path === "requirements/traceability" && method === "GET") {
+        return handleRequirementsTraceability(res, ctx);
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Walk the item tree collecting requirements with inheritance. */
+function collectInheritedRequirements(items, targetId) {
+    const result = [];
+    // Find the item and its parent chain
+    function findWithParents(list, id, parents) {
+        for (const item of list) {
+            if (item.id === id)
+                return { item, parents };
+            if (Array.isArray(item.children)) {
+                const found = findWithParents(item.children, id, [...parents, item]);
+                if (found)
+                    return found;
+            }
+        }
+        return null;
+    }
+    const found = findWithParents(items, targetId, []);
+    if (!found)
+        return result;
+    // Own requirements first
+    const reqs = (found.item.requirements ?? []);
+    for (const req of reqs) {
+        result.push({
+            ...req,
+            sourceItemId: found.item.id,
+            sourceItemTitle: found.item.title,
+            sourceItemLevel: found.item.level,
+        });
+    }
+    // Then parent chain (immediate parent → root)
+    for (const parent of [...found.parents].reverse()) {
+        const parentReqs = (parent.requirements ?? []);
+        for (const req of parentReqs) {
+            result.push({
+                ...req,
+                sourceItemId: parent.id,
+                sourceItemTitle: parent.title,
+                sourceItemLevel: parent.level,
+            });
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Route handlers
+// ---------------------------------------------------------------------------
+/** GET /api/rex/items/:id/requirements */
+function handleGetRequirements(res, ctx, itemId) {
+    const doc = loadPRD(ctx);
+    if (!doc) {
+        errorResponse(res, 404, "No PRD data found");
+        return true;
+    }
+    const item = findItemById(doc.items, itemId);
+    if (!item) {
+        errorResponse(res, 404, `Item "${itemId}" not found`);
+        return true;
+    }
+    const inherited = collectInheritedRequirements(doc.items, itemId);
+    const own = (item.requirements ?? []);
+    jsonResponse(res, 200, {
+        own,
+        inherited,
+        totalCount: inherited.length,
+        ownCount: own.length,
+        inheritedCount: inherited.length - own.length,
+    });
+    return true;
+}
+/** POST /api/rex/items/:id/requirements */
+async function handleAddRequirement(req, res, ctx, itemId, broadcast) {
+    const doc = loadPRD(ctx);
+    if (!doc) {
+        errorResponse(res, 404, "No PRD data found");
+        return true;
+    }
+    const item = findItemById(doc.items, itemId);
+    if (!item) {
+        errorResponse(res, 404, `Item "${itemId}" not found`);
+        return true;
+    }
+    try {
+        const body = await readBody(req);
+        const input = JSON.parse(body);
+        if (!input.title?.trim()) {
+            errorResponse(res, 400, "Missing required field: title");
+            return true;
+        }
+        if (!input.category || !isRequirementCategory(input.category)) {
+            errorResponse(res, 400, `Invalid category: ${input.category}. Valid: ${[...VALID_REQUIREMENT_CATEGORIES].join(", ")}`);
+            return true;
+        }
+        if (!input.validationType || !isValidationType(input.validationType)) {
+            errorResponse(res, 400, `Invalid validationType: ${input.validationType}. Valid: ${[...VALID_VALIDATION_TYPES].join(", ")}`);
+            return true;
+        }
+        const id = randomUUID();
+        const requirement = {
+            id,
+            title: input.title.trim(),
+            category: input.category,
+            validationType: input.validationType,
+            acceptanceCriteria: input.acceptanceCriteria ?? [],
+        };
+        if (input.description)
+            requirement.description = input.description;
+        if (input.validationCommand)
+            requirement.validationCommand = input.validationCommand;
+        if (input.threshold !== undefined)
+            requirement.threshold = input.threshold;
+        if (input.priority && isPriority(input.priority))
+            requirement.priority = input.priority;
+        if (!Array.isArray(item.requirements)) {
+            item.requirements = [];
+        }
+        item.requirements.push(requirement);
+        savePRD(ctx, doc);
+        appendLog(ctx, {
+            timestamp: new Date().toISOString(),
+            event: "requirement_added",
+            itemId,
+            detail: `Added ${input.category} requirement "${input.title}" to item "${item.title}" (via web)`,
+        });
+        if (broadcast) {
+            broadcast({
+                type: "rex:prd-changed",
+                timestamp: new Date().toISOString(),
+            });
+        }
+        jsonResponse(res, 201, { ok: true, id, requirement });
+    }
+    catch (err) {
+        errorResponse(res, 400, String(err));
+    }
+    return true;
+}
+/** PATCH /api/rex/items/:id/requirements/:reqId */
+async function handleUpdateRequirement(req, res, ctx, itemId, reqId, broadcast) {
+    const doc = loadPRD(ctx);
+    if (!doc) {
+        errorResponse(res, 404, "No PRD data found");
+        return true;
+    }
+    const item = findItemById(doc.items, itemId);
+    if (!item) {
+        errorResponse(res, 404, `Item "${itemId}" not found`);
+        return true;
+    }
+    const reqs = (item.requirements ?? []);
+    const reqIdx = reqs.findIndex((r) => r.id === reqId);
+    if (reqIdx === -1) {
+        errorResponse(res, 404, `Requirement "${reqId}" not found on item "${itemId}"`);
+        return true;
+    }
+    try {
+        const body = await readBody(req);
+        const updates = JSON.parse(body);
+        // Validate category/validationType if being changed
+        if (updates.category !== undefined && !isRequirementCategory(updates.category)) {
+            errorResponse(res, 400, `Invalid category: ${updates.category}`);
+            return true;
+        }
+        if (updates.validationType !== undefined && !isValidationType(updates.validationType)) {
+            errorResponse(res, 400, `Invalid validationType: ${updates.validationType}`);
+            return true;
+        }
+        if (updates.priority !== undefined && updates.priority !== null && !isPriority(updates.priority)) {
+            errorResponse(res, 400, `Invalid priority: ${updates.priority}`);
+            return true;
+        }
+        // Apply updates (preserve id)
+        const existing = reqs[reqIdx];
+        Object.assign(existing, updates, { id: reqId });
+        savePRD(ctx, doc);
+        appendLog(ctx, {
+            timestamp: new Date().toISOString(),
+            event: "requirement_updated",
+            itemId,
+            detail: `Updated requirement "${existing.title}" on item "${item.title}" (via web)`,
+        });
+        if (broadcast) {
+            broadcast({
+                type: "rex:prd-changed",
+                timestamp: new Date().toISOString(),
+            });
+        }
+        jsonResponse(res, 200, { ok: true, requirement: existing });
+    }
+    catch (err) {
+        errorResponse(res, 400, String(err));
+    }
+    return true;
+}
+/** DELETE /api/rex/items/:id/requirements/:reqId */
+function handleDeleteRequirement(res, ctx, itemId, reqId, broadcast) {
+    const doc = loadPRD(ctx);
+    if (!doc) {
+        errorResponse(res, 404, "No PRD data found");
+        return true;
+    }
+    const item = findItemById(doc.items, itemId);
+    if (!item) {
+        errorResponse(res, 404, `Item "${itemId}" not found`);
+        return true;
+    }
+    const reqs = (item.requirements ?? []);
+    const reqIdx = reqs.findIndex((r) => r.id === reqId);
+    if (reqIdx === -1) {
+        errorResponse(res, 404, `Requirement "${reqId}" not found on item "${itemId}"`);
+        return true;
+    }
+    const removed = reqs.splice(reqIdx, 1)[0];
+    if (reqs.length === 0) {
+        delete item.requirements;
+    }
+    savePRD(ctx, doc);
+    appendLog(ctx, {
+        timestamp: new Date().toISOString(),
+        event: "requirement_deleted",
+        itemId,
+        detail: `Deleted requirement "${removed.title}" from item "${item.title}" (via web)`,
+    });
+    if (broadcast) {
+        broadcast({
+            type: "rex:prd-changed",
+            timestamp: new Date().toISOString(),
+        });
+    }
+    jsonResponse(res, 200, { ok: true });
+    return true;
+}
+/** GET /api/rex/requirements/coverage */
+function handleRequirementsCoverage(res, ctx) {
+    const doc = loadPRD(ctx);
+    if (!doc) {
+        errorResponse(res, 404, "No PRD data found");
+        return true;
+    }
+    const stats = {
+        totalItems: 0,
+        itemsWithRequirements: 0,
+        itemsWithInheritedRequirements: 0,
+        itemsWithNoRequirements: 0,
+        totalRequirements: 0,
+        byCategory: {},
+        byValidationType: {},
+        byPriority: {},
+        coveragePercent: 0,
+    };
+    const seenReqIds = new Set();
+    // Walk tree counting requirements
+    function walkForCoverage(list, parentHasReqs) {
+        for (const item of list) {
+            if (item.status === "deleted")
+                continue;
+            stats.totalItems++;
+            const ownReqs = (item.requirements ?? []);
+            const hasOwn = ownReqs.length > 0;
+            if (hasOwn) {
+                stats.itemsWithRequirements++;
+                for (const req of ownReqs) {
+                    if (!seenReqIds.has(req.id)) {
+                        seenReqIds.add(req.id);
+                        stats.totalRequirements++;
+                        stats.byCategory[req.category] = (stats.byCategory[req.category] ?? 0) + 1;
+                        stats.byValidationType[req.validationType] = (stats.byValidationType[req.validationType] ?? 0) + 1;
+                        const p = req.priority ?? "unset";
+                        stats.byPriority[p] = (stats.byPriority[p] ?? 0) + 1;
+                    }
+                }
+            }
+            const inherits = parentHasReqs && !hasOwn;
+            if (inherits) {
+                stats.itemsWithInheritedRequirements++;
+            }
+            if (!hasOwn && !parentHasReqs) {
+                stats.itemsWithNoRequirements++;
+            }
+            if (Array.isArray(item.children)) {
+                walkForCoverage(item.children, hasOwn || parentHasReqs);
+            }
+        }
+    }
+    walkForCoverage(doc.items, false);
+    stats.coveragePercent = stats.totalItems > 0
+        ? Math.round(((stats.totalItems - stats.itemsWithNoRequirements) / stats.totalItems) * 100)
+        : 0;
+    jsonResponse(res, 200, stats);
+    return true;
+}
+/** GET /api/rex/requirements/traceability */
+function handleRequirementsTraceability(res, ctx) {
+    const doc = loadPRD(ctx);
+    if (!doc) {
+        errorResponse(res, 404, "No PRD data found");
+        return true;
+    }
+    // Build traceability: each requirement → which items it applies to
+    const matrix = [];
+    // Collect all unique requirements and find what items they are defined on
+    const reqMap = new Map();
+    function walkForReqs(list) {
+        for (const item of list) {
+            const reqs = (item.requirements ?? []);
+            for (const req of reqs) {
+                if (!reqMap.has(req.id)) {
+                    reqMap.set(req.id, {
+                        requirement: req,
+                        definedOnItemId: item.id,
+                        definedOnItemTitle: item.title,
+                        definedOnItemLevel: item.level,
+                        childIds: [],
+                    });
+                }
+            }
+            if (Array.isArray(item.children)) {
+                walkForReqs(item.children);
+            }
+        }
+    }
+    // Collect descendant items for each requirement-bearing item
+    function collectDescendants(items) {
+        const result = [];
+        for (const item of items) {
+            if (item.status !== "deleted") {
+                result.push({ id: item.id, title: item.title, level: item.level, status: item.status });
+            }
+            if (Array.isArray(item.children)) {
+                result.push(...collectDescendants(item.children));
+            }
+        }
+        return result;
+    }
+    walkForReqs(doc.items);
+    // For each requirement, find all items it applies to (the defining item + descendants)
+    for (const [, entry] of reqMap) {
+        const defItem = findItemById(doc.items, entry.definedOnItemId);
+        const appliesTo = [];
+        if (defItem) {
+            appliesTo.push({
+                id: defItem.id,
+                title: defItem.title,
+                level: defItem.level,
+                status: defItem.status,
+            });
+            if (Array.isArray(defItem.children)) {
+                appliesTo.push(...collectDescendants(defItem.children));
+            }
+        }
+        matrix.push({
+            requirement: entry.requirement,
+            definedOnItemId: entry.definedOnItemId,
+            definedOnItemTitle: entry.definedOnItemTitle,
+            definedOnItemLevel: entry.definedOnItemLevel,
+            appliesTo,
+        });
+    }
+    jsonResponse(res, 200, { matrix, totalRequirements: matrix.length });
+    return true;
+}
+//# sourceMappingURL=requirements.js.map

package/packages/web/dist/server/routes-rex/requirements.js.map

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

package/packages/web/dist/server/routes-rex/shared.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared helpers for Rex route handlers.
+ *
+ * Thin wrappers over canonical rex functions that adapt the rex API
+ * to the patterns used throughout the route modules.
+ */
+import type { ServerContext } from "../types.js";
+import { type PRDItem, type PRDDocument, type TreeEntry, collectCompletedIds } from "../rex-gateway.js";
+/**
+ * API-settable statuses — excludes "deleted" from the canonical set.
+ * Deleted items shouldn't be settable via the API.
+ */
+export declare const API_SETTABLE_STATUSES: Set<string>;
+/** Find an item by ID, returning just the item (or null). */
+export declare function findItemById(items: PRDItem[], id: string): PRDItem | null;
+/**
+ * Insert a child under a parent. Skips rex's hierarchy validation since the
+ * web API validates level separately and some batch-import paths construct
+ * items with the correct level pre-set.
+ */
+export declare function insertChild(items: PRDItem[], parentId: string, child: PRDItem): boolean;
+/**
+ * Update an item in the tree, automatically applying timestamp transitions
+ * (startedAt / completedAt) via the canonical `computeTimestampUpdates`.
+ */
+export declare function updateInTree(items: PRDItem[], id: string, updates: Partial<PRDItem>): boolean;
+/** Find the next actionable task, returning just the item (or null). */
+export declare function findNextTask(items: PRDItem[], completedIds: Set<string>): PRDItem | null;
+/** Load and parse prd.json. Returns null if not found. */
+export declare function loadPRD(ctx: ServerContext): PRDDocument | null;
+/** Save prd.json. */
+export declare function savePRD(ctx: ServerContext, doc: PRDDocument): void;
+/** Extract the parent ID from a TreeEntry's parent chain. */
+export declare function parentIdOf(entry: TreeEntry): string | null;
+/** Append to execution log (sync, best-effort). */
+export declare function appendLog(ctx: ServerContext, entry: Record<string, unknown>): void;
+export { collectCompletedIds };

package/packages/web/dist/server/routes-rex/shared.js

@@ -0,0 +1,73 @@
+/**
+ * Shared helpers for Rex route handlers.
+ *
+ * Thin wrappers over canonical rex functions that adapt the rex API
+ * to the patterns used throughout the route modules.
+ */
+import { appendFileSync } from "node:fs";
+import { join } from "node:path";
+import { loadPRDSync, savePRDSync } from "../prd-io.js";
+import { VALID_STATUSES, findItem, insertChild as rexInsertChild, updateInTree as rexUpdateInTree, findNextTask as rexFindNextTask, collectCompletedIds, computeTimestampUpdates, } from "../rex-gateway.js";
+/**
+ * API-settable statuses — excludes "deleted" from the canonical set.
+ * Deleted items shouldn't be settable via the API.
+ */
+export const API_SETTABLE_STATUSES = new Set([...VALID_STATUSES].filter((s) => s !== "deleted"));
+/** Find an item by ID, returning just the item (or null). */
+export function findItemById(items, id) {
+    const entry = findItem(items, id);
+    return entry ? entry.item : null;
+}
+/**
+ * Insert a child under a parent. Skips rex's hierarchy validation since the
+ * web API validates level separately and some batch-import paths construct
+ * items with the correct level pre-set.
+ */
+export function insertChild(items, parentId, child) {
+    return rexInsertChild(items, parentId, child);
+}
+/**
+ * Update an item in the tree, automatically applying timestamp transitions
+ * (startedAt / completedAt) via the canonical `computeTimestampUpdates`.
+ */
+export function updateInTree(items, id, updates) {
+    // Auto-apply timestamps when status changes
+    if (updates.status) {
+        const existing = findItemById(items, id);
+        if (existing && existing.status !== updates.status) {
+            const tsUpdates = computeTimestampUpdates(existing.status, updates.status, existing);
+            Object.assign(updates, tsUpdates);
+        }
+    }
+    return rexUpdateInTree(items, id, updates);
+}
+/** Find the next actionable task, returning just the item (or null). */
+export function findNextTask(items, completedIds) {
+    const entry = rexFindNextTask(items, completedIds);
+    return entry ? entry.item : null;
+}
+/** Load and parse prd.json. Returns null if not found. */
+export function loadPRD(ctx) {
+    return loadPRDSync(ctx.rexDir);
+}
+/** Save prd.json. */
+export function savePRD(ctx, doc) {
+    savePRDSync(ctx.rexDir, doc);
+}
+/** Extract the parent ID from a TreeEntry's parent chain. */
+export function parentIdOf(entry) {
+    return entry.parents.length > 0 ? entry.parents[entry.parents.length - 1].id : null;
+}
+/** Append to execution log (sync, best-effort). */
+export function appendLog(ctx, entry) {
+    try {
+        const logPath = join(ctx.rexDir, "execution-log.jsonl");
+        appendFileSync(logPath, JSON.stringify(entry) + "\n");
+    }
+    catch {
+        // Best-effort logging
+    }
+}
+// Re-export collectCompletedIds for use in reads.ts
+export { collectCompletedIds };
+//# sourceMappingURL=shared.js.map

package/packages/web/dist/server/routes-rex/shared.js.map

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

package/packages/web/dist/server/routes-rex.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Rex API routes — CRUD for PRD items, tree stats, next task, and log entries.
+ *
+ * All endpoints are under /api/rex/.
+ *
+ * GET   /api/rex/prd              — full PRD document
+ * GET   /api/rex/stats            — tree stats (total, completed, etc.)
+ * GET   /api/rex/dashboard        — dashboard data (stats + per-epic + next task + priority dist)
+ * GET   /api/rex/next             — next actionable task
+ * GET   /api/rex/items/:id        — single item by ID
+ * POST  /api/rex/items            — add a new item
+ * PATCH /api/rex/items/:id        — update item fields
+ * DELETE /api/rex/items/:id       — remove item and all descendants
+ * PATCH /api/rex/items/bulk       — bulk update multiple items
+ * POST  /api/rex/items/merge     — consolidate/merge sibling items
+ * GET   /api/rex/prune/preview    — preview items that would be pruned
+ * POST  /api/rex/prune            — execute prune (removes completed subtrees)
+ * POST  /api/rex/analyze          — trigger analysis (scan project)
+ * GET   /api/rex/proposals        — get pending proposals
+ * POST  /api/rex/proposals/accept — accept pending proposals
+ * POST  /api/rex/proposals/accept-edited — accept edited proposals (inline-edited data)
+ * POST  /api/rex/smart-add-preview — generate proposals from natural language (real-time preview)
+ * POST  /api/rex/batch-import     — process multiple ideas from various sources with consolidated review
+ * GET   /api/rex/log              — execution log (?limit=N)
+ * GET   /api/rex/items/:id/requirements       — get requirements for item (own + inherited)
+ * POST  /api/rex/items/:id/requirements       — add a requirement to item
+ * PATCH /api/rex/items/:id/requirements/:rid  — update a requirement
+ * DELETE /api/rex/items/:id/requirements/:rid — delete a requirement
+ * GET   /api/rex/requirements/coverage        — requirements coverage stats
+ * GET   /api/rex/requirements/traceability    — traceability matrix
+ * POST  /api/rex/execute/epic-by-epic — start epic-by-epic execution
+ * GET   /api/rex/execute/status       — current execution state
+ * POST  /api/rex/execute/pause        — pause execution
+ * POST  /api/rex/execute/resume       — resume execution
+ */
+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>;
+/**
+ * Result returned by {@link shutdownRexExecution}.
+ *
+ * Callers (e.g. `gracefulShutdown` in start.ts) use this to build a final
+ * verification summary for the rex epic-by-epic execution component.
+ */
+export interface ShutdownRexResult {
+    /** Whether a rex epic-by-epic hench process was running at shutdown time. */
+    hadActiveProcess: boolean;
+    /** Whether the process was successfully terminated (false if it errored or was not present). */
+    terminated: boolean;
+}
+/**
+ * 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 declare function shutdownRexExecution(gracePeriodMs?: number): Promise<ShutdownRexResult>;