@n-dx/web 0.1.0

package/dist/server/process-memory-tracker.js

@@ -0,0 +1,194 @@
+/**
+ * Per-process memory tracking with history and high-RSS warnings.
+ *
+ * Collects time-series RSS samples for individual hench task processes
+ * and stores them in bounded ring buffers. Flags processes whose RSS
+ * exceeds a configurable threshold.
+ *
+ * This is the web-server counterpart to hench's own ProcessMemoryTracker.
+ * Implemented separately to avoid adding a runtime dependency from
+ * @n-dx/web to hench (web reads hench data from disk, never imports it).
+ *
+ * @module @n-dx/web/server/process-memory-tracker
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum samples retained per process (ring buffer size). */
+const DEFAULT_MAX_SAMPLES = 360;
+/** Maximum number of completed process histories to retain. */
+const DEFAULT_MAX_COMPLETED_HISTORIES = 20;
+/** Default RSS warning threshold: 512 MB. */
+const DEFAULT_RSS_WARNING_BYTES = 512 * 1024 * 1024;
+export const DEFAULT_PROCESS_MEMORY_TRACKER_CONFIG = {
+    maxSamples: DEFAULT_MAX_SAMPLES,
+    maxCompletedHistories: DEFAULT_MAX_COMPLETED_HISTORIES,
+    rssWarningBytes: DEFAULT_RSS_WARNING_BYTES,
+};
+// ---------------------------------------------------------------------------
+// ProcessMemoryTracker
+// ---------------------------------------------------------------------------
+export class ProcessMemoryTracker {
+    _config;
+    _active = new Map();
+    _completed = [];
+    _now;
+    constructor(config, overrides) {
+        this._config = { ...DEFAULT_PROCESS_MEMORY_TRACKER_CONFIG, ...config };
+        this._now = overrides?.now ?? Date.now;
+    }
+    get config() {
+        return { ...this._config };
+    }
+    get activeCount() {
+        return this._active.size;
+    }
+    get completedCount() {
+        return this._completed.length;
+    }
+    recordSample(taskId, taskTitle, pid, rssBytes) {
+        const now = this._now();
+        const sample = {
+            rssBytes,
+            timestamp: new Date(now).toISOString(),
+            epochMs: now,
+        };
+        let tracked = this._active.get(taskId);
+        if (!tracked) {
+            tracked = {
+                taskId,
+                taskTitle,
+                pid,
+                samples: [],
+                startedAt: sample.timestamp,
+                peakRssBytes: rssBytes,
+                active: true,
+            };
+            this._active.set(taskId, tracked);
+        }
+        tracked.pid = pid;
+        if (tracked.samples.length >= this._config.maxSamples) {
+            tracked.samples.shift();
+        }
+        tracked.samples.push(sample);
+        if (rssBytes > tracked.peakRssBytes) {
+            tracked.peakRssBytes = rssBytes;
+        }
+    }
+    markCompleted(taskId) {
+        const tracked = this._active.get(taskId);
+        if (!tracked)
+            return;
+        tracked.active = false;
+        tracked.endedAt = new Date(this._now()).toISOString();
+        this._active.delete(taskId);
+        this._completed.push(tracked);
+        while (this._completed.length > this._config.maxCompletedHistories) {
+            this._completed.shift();
+        }
+    }
+    remove(taskId) {
+        this._active.delete(taskId);
+    }
+    getHistory(taskId) {
+        const tracked = this._active.get(taskId) ??
+            this._completed.find((p) => p.taskId === taskId);
+        if (!tracked)
+            return undefined;
+        return this._buildHistory(tracked);
+    }
+    getAllHistories() {
+        const all = [];
+        for (const tracked of this._active.values()) {
+            all.push(this._buildHistory(tracked));
+        }
+        for (const tracked of this._completed) {
+            all.push(this._buildHistory(tracked));
+        }
+        return all;
+    }
+    getActiveHistories() {
+        const result = [];
+        for (const tracked of this._active.values()) {
+            result.push(this._buildHistory(tracked));
+        }
+        return result;
+    }
+    detectLeaks() {
+        const leaks = [];
+        for (const tracked of this._active.values()) {
+            const samples = tracked.samples;
+            const currentRss = samples[samples.length - 1]?.rssBytes ?? 0;
+            if (currentRss < this._config.rssWarningBytes)
+                continue;
+            const firstSample = samples[0];
+            const lastSample = samples[samples.length - 1];
+            const durationSec = firstSample && lastSample
+                ? (lastSample.epochMs - firstSample.epochMs) / 1000
+                : 0;
+            const currentMB = Math.round(currentRss / 1024 / 1024);
+            const thresholdMB = Math.round(this._config.rssWarningBytes / 1024 / 1024);
+            leaks.push({
+                taskId: tracked.taskId,
+                taskTitle: tracked.taskTitle,
+                pid: tracked.pid,
+                trend: {
+                    isLeaking: true,
+                    description: `RSS ${currentMB}MB exceeds ${thresholdMB}MB threshold`,
+                },
+                currentRssBytes: currentRss,
+                peakRssBytes: tracked.peakRssBytes,
+                trackingDurationSec: Math.round(durationSec),
+                timestamp: new Date().toISOString(),
+            });
+        }
+        return {
+            activeProcesses: this._active.size,
+            completedProcesses: this._completed.length,
+            leaks,
+            health: leaks.length > 0 ? "warning" : "healthy",
+            timestamp: new Date().toISOString(),
+        };
+    }
+    getLeakAlerts() {
+        return this.detectLeaks().leaks;
+    }
+    reset() {
+        this._active.clear();
+        this._completed.length = 0;
+    }
+    _computeTrend(tracked) {
+        const samples = tracked.samples;
+        if (samples.length === 0)
+            return undefined;
+        const currentRss = samples[samples.length - 1].rssBytes;
+        const currentMB = Math.round(currentRss / 1024 / 1024);
+        if (currentRss >= this._config.rssWarningBytes) {
+            const thresholdMB = Math.round(this._config.rssWarningBytes / 1024 / 1024);
+            return {
+                isLeaking: true,
+                description: `RSS ${currentMB}MB exceeds ${thresholdMB}MB threshold`,
+            };
+        }
+        return {
+            isLeaking: false,
+            description: `RSS ${currentMB}MB — within normal range`,
+        };
+    }
+    _buildHistory(tracked) {
+        const samples = tracked.samples;
+        const lastSample = samples[samples.length - 1];
+        return {
+            taskId: tracked.taskId,
+            taskTitle: tracked.taskTitle,
+            pid: tracked.pid,
+            samples: [...samples],
+            startedAt: tracked.startedAt,
+            endedAt: tracked.endedAt,
+            trend: this._computeTrend(tracked),
+            peakRssBytes: tracked.peakRssBytes,
+            currentRssBytes: lastSample?.rssBytes ?? 0,
+        };
+    }
+}
+//# sourceMappingURL=process-memory-tracker.js.map

package/dist/server/process-memory-tracker.js.map

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

package/dist/server/register-scheduler.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Scheduler registration for the usage-cleanup zone.
+ *
+ * Exports a single `registerUsageScheduler()` function that encapsulates
+ * all wiring needed to start the periodic cleanup scheduler. This makes
+ * the scheduler's lifecycle dependency on web-dashboard explicit and
+ * self-contained — the dashboard calls one function at startup rather
+ * than knowing internal scheduler details (aggregator factories, PRD
+ * ID collection callbacks, broadcast functions, etc.).
+ *
+ * @module web/server/register-scheduler
+ */
+import type { IncrementalTaskUsageAggregator } from "./incremental-task-usage.js";
+import type { LoadPRDFn } from "./usage-cleanup-scheduler.js";
+import type { CollectAllIdsFn } from "./shared-types.js";
+/** Options for registering the usage cleanup scheduler. */
+export interface RegisterSchedulerOptions {
+    /** Server context with project paths. */
+    ctx: {
+        rexDir: string;
+        projectDir: string;
+    };
+    /** Factory to get the aggregator singleton for the runs directory. */
+    getAggregator: () => IncrementalTaskUsageAggregator;
+    /** WebSocket broadcast function for notifying connected clients. */
+    broadcast?: (data: unknown) => void;
+    /** Function to extract valid task IDs from PRD items. */
+    collectAllIds?: CollectAllIdsFn;
+    /** Override interval in ms (for testing; takes precedence over config). */
+    overrideIntervalMs?: number;
+    /** PRD loader function (injected to avoid cross-zone coupling). */
+    loadPRD?: LoadPRDFn;
+}
+/**
+ * Register the periodic usage cleanup scheduler.
+ *
+ * Wraps `startUsageCleanupScheduler` with a clean interface so the
+ * server startup code (web-dashboard zone) can wire the scheduler with
+ * a single function call. Returns the interval handle for shutdown
+ * cleanup.
+ *
+ * Usage in start.ts:
+ * ```ts
+ * const handle = registerUsageScheduler({
+ *   ctx,
+ *   getAggregator: () => getAggregator(runsDir),
+ *   broadcast: ws.broadcast,
+ *   collectAllIds,
+ * });
+ * watcherHandles.monitorIntervals.push(handle);
+ * ```
+ */
+export declare function registerUsageScheduler(options: RegisterSchedulerOptions): ReturnType<typeof setInterval>;

package/dist/server/register-scheduler.js

@@ -0,0 +1,36 @@
+/**
+ * Scheduler registration for the usage-cleanup zone.
+ *
+ * Exports a single `registerUsageScheduler()` function that encapsulates
+ * all wiring needed to start the periodic cleanup scheduler. This makes
+ * the scheduler's lifecycle dependency on web-dashboard explicit and
+ * self-contained — the dashboard calls one function at startup rather
+ * than knowing internal scheduler details (aggregator factories, PRD
+ * ID collection callbacks, broadcast functions, etc.).
+ *
+ * @module web/server/register-scheduler
+ */
+import { startUsageCleanupScheduler } from "./usage-cleanup-scheduler.js";
+/**
+ * Register the periodic usage cleanup scheduler.
+ *
+ * Wraps `startUsageCleanupScheduler` with a clean interface so the
+ * server startup code (web-dashboard zone) can wire the scheduler with
+ * a single function call. Returns the interval handle for shutdown
+ * cleanup.
+ *
+ * Usage in start.ts:
+ * ```ts
+ * const handle = registerUsageScheduler({
+ *   ctx,
+ *   getAggregator: () => getAggregator(runsDir),
+ *   broadcast: ws.broadcast,
+ *   collectAllIds,
+ * });
+ * watcherHandles.monitorIntervals.push(handle);
+ * ```
+ */
+export function registerUsageScheduler(options) {
+    return startUsageCleanupScheduler(options.ctx, options.getAggregator, options.broadcast, options.overrideIntervalMs, options.collectAllIds, options.loadPRD);
+}
+//# sourceMappingURL=register-scheduler.js.map

package/dist/server/register-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-scheduler.js","sourceRoot":"","sources":["../../src/server/register-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAyB1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAiC;IAEjC,OAAO,0BAA0B,CAC/B,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,kBAAkB,EAC1B,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,OAAO,CAChB,CAAC;AACJ,CAAC"}

package/dist/server/rex-gateway.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Centralized gateway for rex runtime imports.
+ *
+ * Web route handlers and the rex MCP server need access to rex domain types,
+ * constants, tree utilities, and the MCP server factory. Rather than scattering
+ * `import … from "@n-dx/rex"` across route files, all web→rex runtime imports pass
+ * through this single module.
+ *
+ * **Minimal surface:** This gateway re-exports only the symbols actually
+ * consumed by web package source files. If a new route needs a rex symbol,
+ * add the re-export here — don't import rex directly in the route file.
+ *
+ * By concentrating all web→rex runtime imports here, we ensure:
+ * - The cross-package surface is **explicit** (re-exports in one file, not scattered).
+ * - The DAG stays **acyclic** — rex never imports from web.
+ * - Future changes to rex's public API need only be updated in this single file.
+ *
+ * @module web/server/rex-gateway
+ * @see packages/web/src/server/domain-gateway.ts — web's gateway for sourcevision imports
+ * @see packages/hench/src/prd/rex-gateway.ts — hench's equivalent gateway for rex
+ */
+export { createRexMcpServer } from "@n-dx/rex";
+export { SCHEMA_VERSION, isCompatibleSchema } from "@n-dx/rex";
+export type { ItemLevel, ItemStatus } from "@n-dx/rex";
+export type { PRDItem, PRDDocument, Requirement } from "@n-dx/rex";
+export { LEVEL_HIERARCHY, VALID_STATUSES, VALID_REQUIREMENT_CATEGORIES, VALID_VALIDATION_TYPES, CHILD_LEVEL, isPriority, isItemLevel, isRequirementCategory, isValidationType, isRootLevel, isWorkItem, } from "@n-dx/rex";
+export { findItem, walkTree, insertChild, updateInTree, removeFromTree, computeStats, collectAllIds, } from "@n-dx/rex";
+export type { TreeEntry, TreeStats } from "@n-dx/rex";
+export { findNextTask, collectCompletedIds } from "@n-dx/rex";
+export { computeTimestampUpdates } from "@n-dx/rex";
+export { validateMerge, previewMerge, mergeItems } from "@n-dx/rex";
+export { countSubtree } from "@n-dx/rex";
+export { computeEpicStats, computePriorityDistribution, computeRequirementsSummary, } from "@n-dx/rex";
+export { computeHealthScore } from "@n-dx/rex";
+export { detectReorganizations, applyProposals } from "@n-dx/rex";
+export { applyReshape, reasonForReshape } from "@n-dx/rex";
+export type { ReshapeProposal } from "@n-dx/rex";
+export { handleEditItem } from "@n-dx/rex";
+export type { Proposal, ProposalFeature, ProposalTask } from "@n-dx/rex";

package/dist/server/rex-gateway.js

@@ -0,0 +1,47 @@
+/**
+ * Centralized gateway for rex runtime imports.
+ *
+ * Web route handlers and the rex MCP server need access to rex domain types,
+ * constants, tree utilities, and the MCP server factory. Rather than scattering
+ * `import … from "@n-dx/rex"` across route files, all web→rex runtime imports pass
+ * through this single module.
+ *
+ * **Minimal surface:** This gateway re-exports only the symbols actually
+ * consumed by web package source files. If a new route needs a rex symbol,
+ * add the re-export here — don't import rex directly in the route file.
+ *
+ * By concentrating all web→rex runtime imports here, we ensure:
+ * - The cross-package surface is **explicit** (re-exports in one file, not scattered).
+ * - The DAG stays **acyclic** — rex never imports from web.
+ * - Future changes to rex's public API need only be updated in this single file.
+ *
+ * @module web/server/rex-gateway
+ * @see packages/web/src/server/domain-gateway.ts — web's gateway for sourcevision imports
+ * @see packages/hench/src/prd/rex-gateway.ts — hench's equivalent gateway for rex
+ */
+// ---- Rex MCP server factory -------------------------------------------------
+export { createRexMcpServer } from "@n-dx/rex";
+// ---- Rex schema version contract --------------------------------------------
+export { SCHEMA_VERSION, isCompatibleSchema } from "@n-dx/rex";
+export { LEVEL_HIERARCHY, VALID_STATUSES, VALID_REQUIREMENT_CATEGORIES, VALID_VALIDATION_TYPES, CHILD_LEVEL, isPriority, isItemLevel, isRequirementCategory, isValidationType, isRootLevel, isWorkItem, } from "@n-dx/rex";
+// ---- Rex tree utilities -----------------------------------------------------
+export { findItem, walkTree, insertChild, updateInTree, removeFromTree, computeStats, collectAllIds, } from "@n-dx/rex";
+// ---- Rex task selection -----------------------------------------------------
+export { findNextTask, collectCompletedIds } from "@n-dx/rex";
+// ---- Rex timestamps ---------------------------------------------------------
+export { computeTimestampUpdates } from "@n-dx/rex";
+// ---- Rex merge/consolidation ------------------------------------------------
+export { validateMerge, previewMerge, mergeItems } from "@n-dx/rex";
+// ---- Rex prune --------------------------------------------------------------
+export { countSubtree } from "@n-dx/rex";
+// ---- Rex analytics ----------------------------------------------------------
+export { computeEpicStats, computePriorityDistribution, computeRequirementsSummary, } from "@n-dx/rex";
+// ---- Rex health -------------------------------------------------------------
+export { computeHealthScore } from "@n-dx/rex";
+// ---- Rex reorganize ---------------------------------------------------------
+export { detectReorganizations, applyProposals } from "@n-dx/rex";
+// ---- Rex reshape (LLM-powered restructuring) --------------------------------
+export { applyReshape, reasonForReshape } from "@n-dx/rex";
+// ---- Rex MCP tool handlers (direct invocation) -----------------------------
+export { handleEditItem } from "@n-dx/rex";
+//# sourceMappingURL=rex-gateway.js.map

package/dist/server/rex-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rex-gateway.js","sourceRoot":"","sources":["../../src/server/rex-gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,gFAAgF;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAK/D,OAAO,EACL,eAAe,EACf,cAAc,EACd,4BAA4B,EAC5B,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,gFAAgF;AAChF,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,WAAW,CAAC;AAGnB,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAE9D,gFAAgF;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD,gFAAgF;AAChF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEpE,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,gFAAgF;AAChF,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AAEnB,gFAAgF;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,gFAAgF;AAChF,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAElE,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG3D,+EAA+E;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/server/routes-adaptive.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Adaptive workflow adjustment API routes — monitor project evolution
+ * and automatically adjust workflow parameters.
+ *
+ * All endpoints are under /api/hench/adaptive/.
+ *
+ * GET    /api/hench/adaptive/analysis       — full adaptive analysis with metrics and adjustments
+ * GET    /api/hench/adaptive/settings       — current adaptive settings
+ * POST   /api/hench/adaptive/settings       — update adaptive settings (enable/disable, window, locks)
+ * POST   /api/hench/adaptive/apply          — apply an adjustment (auto or manual)
+ * POST   /api/hench/adaptive/dismiss/:id    — dismiss a recommended adjustment
+ * POST   /api/hench/adaptive/lock/:key      — lock a config key from auto-adjustment
+ * POST   /api/hench/adaptive/unlock/:key    — unlock a config key for auto-adjustment
+ * POST   /api/hench/adaptive/override       — set a manual override for a config key
+ * DELETE /api/hench/adaptive/override/:key   — remove a manual override
+ * GET    /api/hench/adaptive/history        — adjustment history + stats
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ServerContext } from "./types.js";
+/** Handle adaptive workflow adjustment API requests. Returns true if handled. */
+export declare function handleAdaptiveRoute(req: IncomingMessage, res: ServerResponse, ctx: ServerContext): boolean | Promise<boolean>;