@n-dx/web 0.1.0

package/dist/server/routes-static.js

@@ -0,0 +1,168 @@
+/**
+ * Static asset routes — serves the viewer HTML and image assets.
+ */
+import { readFileSync, existsSync, realpathSync } from "node:fs";
+import { resolve, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const LIVE_RELOAD_SNIPPET = `<script>
+(function(){
+  var proto = location.protocol === "https:" ? "wss:" : "ws:";
+  var url = proto + "//" + location.host;
+  var reconnectDelay = 1000;
+  function connect() {
+    var ws = new WebSocket(url);
+    ws.onmessage = function(e) {
+      try {
+        var msg = JSON.parse(e.data);
+        if (msg.type === "viewer:reload") location.reload();
+      } catch(err) {}
+    };
+    ws.onclose = function() {
+      setTimeout(connect, reconnectDelay);
+    };
+  }
+  connect();
+})();
+</script>`;
+function resolveDirRealpath(dir) {
+    try {
+        return realpathSync(dir);
+    }
+    catch {
+        return dir;
+    }
+}
+/** Locate and prepare static assets. Returns null if viewer HTML is not found. */
+export function resolveStaticAssets(dev) {
+    const thisDir = dirname(fileURLToPath(import.meta.url));
+    const viewerCandidates = [
+        resolve(thisDir, "../viewer/index.html"),
+        resolve(thisDir, "../../src/viewer/index.html"),
+    ];
+    let viewerPath = null;
+    for (const p of viewerCandidates) {
+        if (existsSync(p)) {
+            viewerPath = p;
+            break;
+        }
+    }
+    if (!viewerPath)
+        return null;
+    const viewerDir = dirname(viewerPath);
+    const packageRoot = resolve(thisDir, "../..");
+    const resolvedViewerDir = resolveDirRealpath(viewerDir);
+    const resolvedPackageRoot = resolveDirRealpath(packageRoot);
+    let cachedViewerHtml = dev ? null : readFileSync(viewerPath, "utf-8");
+    const vp = viewerPath;
+    function getViewerHtml() {
+        if (dev) {
+            let html = readFileSync(vp, "utf-8");
+            html = html.replace("</body>", `${LIVE_RELOAD_SNIPPET}</body>`);
+            return html;
+        }
+        return cachedViewerHtml;
+    }
+    // Resolve landing page HTML (parallel to viewer)
+    const landingCandidates = [
+        resolve(thisDir, "../landing/index.html"),
+        resolve(thisDir, "../../src/landing/index.html"),
+    ];
+    let landingPath = null;
+    for (const p of landingCandidates) {
+        if (existsSync(p)) {
+            landingPath = p;
+            break;
+        }
+    }
+    let cachedLandingHtml = landingPath && !dev ? readFileSync(landingPath, "utf-8") : null;
+    const lp = landingPath;
+    function getLandingHtml() {
+        if (!lp)
+            return null;
+        if (dev) {
+            let html = readFileSync(lp, "utf-8");
+            html = html.replace("</body>", `${LIVE_RELOAD_SNIPPET}</body>`);
+            return html;
+        }
+        return cachedLandingHtml;
+    }
+    function findAssetPath(filename) {
+        const inViewer = resolve(resolvedViewerDir, filename);
+        const inRoot = resolve(resolvedPackageRoot, filename);
+        return existsSync(inViewer) ? inViewer : existsSync(inRoot) ? inRoot : null;
+    }
+    return {
+        viewerPath,
+        viewerDir,
+        resolvedViewerDir,
+        resolvedPackageRoot,
+        getViewerHtml,
+        getLandingHtml,
+        findAssetPath,
+    };
+}
+// Known SPA view paths — keep in sync with ViewId in types.ts
+const SPA_VIEWS = new Set([
+    "overview", "graph", "zones", "files", "routes", "architecture",
+    "problems", "suggestions", "rex-dashboard", "prd",
+    "token-usage", "validation", "hench-runs", "hench-audit",
+    "hench-config", "hench-templates", "hench-optimization",
+]);
+/** Check if the project has been initialized (any tool directory exists). */
+export function isProjectInitialized(ctx) {
+    return existsSync(join(ctx.svDir, "manifest.json")) || existsSync(join(ctx.rexDir, "prd.json"));
+}
+/** Handle static asset requests. Returns true if the request was handled. */
+export function handleStaticRoute(req, res, ctx, assets) {
+    const url = req.url || "/";
+    // Root: dashboard if initialized, landing page otherwise
+    if (url === "/" || url === "/index.html") {
+        if (isProjectInitialized(ctx)) {
+            res.writeHead(200, { "Content-Type": "text/html", "Cache-Control": "no-cache" });
+            res.end(assets.getViewerHtml());
+            return true;
+        }
+        const landingHtml = assets.getLandingHtml();
+        if (landingHtml) {
+            res.writeHead(200, { "Content-Type": "text/html", "Cache-Control": "no-cache" });
+            res.end(landingHtml);
+            return true;
+        }
+        // No landing page available — serve viewer anyway
+        res.writeHead(200, { "Content-Type": "text/html", "Cache-Control": "no-cache" });
+        res.end(assets.getViewerHtml());
+        return true;
+    }
+    // Backward compat: /landing → redirect to /
+    if (url === "/landing" || url === "/landing/") {
+        res.writeHead(301, { Location: "/" });
+        res.end();
+        return true;
+    }
+    // PNG assets (must come before SPA catch-all)
+    if (url.endsWith(".png") && /^\/[\w-]+\.png$/.test(url)) {
+        const filename = url.slice(1);
+        const pngPath = assets.findAssetPath(filename);
+        if (pngPath) {
+            const content = readFileSync(pngPath);
+            res.writeHead(200, { "Content-Type": "image/png", "Cache-Control": "public, max-age=86400" });
+            res.end(content);
+        }
+        else {
+            res.writeHead(404);
+            res.end("Not found");
+        }
+        return true;
+    }
+    // SPA catch-all: known view paths serve the viewer HTML
+    // Also match deep-link paths like "hench-runs/RUNID"
+    const segment = url.slice(1).split("?")[0];
+    const baseSegment = segment.split("/")[0];
+    if (SPA_VIEWS.has(segment) || SPA_VIEWS.has(baseSegment)) {
+        res.writeHead(200, { "Content-Type": "text/html", "Cache-Control": "no-cache" });
+        res.end(assets.getViewerHtml());
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=routes-static.js.map

package/dist/server/routes-static.js.map

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

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

@@ -0,0 +1,58 @@
+/**
+ * Project status API route — lightweight health indicators for sidebar display.
+ *
+ * Combines SourceVision analysis freshness, PRD completion metrics, and
+ * pending task info into a single endpoint optimized for frequent polling.
+ *
+ * GET /api/status — project health indicators
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ServerContext } from "./types.js";
+import type { TreeStats } from "./rex-gateway.js";
+/** SourceVision analysis freshness status. */
+export type AnalysisFreshness = "fresh" | "stale" | "unavailable";
+export interface SourceVisionStatus {
+    /** Whether analysis data exists and how fresh it is. */
+    freshness: AnalysisFreshness;
+    /** ISO timestamp of last analysis, or null if unavailable. */
+    analyzedAt: string | null;
+    /** Minutes since last analysis, or null if unavailable. */
+    minutesAgo: number | null;
+    /** Number of completed analysis modules. */
+    modulesComplete: number;
+    /** Total number of analysis modules. */
+    modulesTotal: number;
+}
+export interface RexStatus {
+    /** Whether a PRD exists. */
+    exists: boolean;
+    /** PRD completion percentage (0-100). */
+    percentComplete: number;
+    /** Tree stats breakdown. */
+    stats: TreeStats | null;
+    /** Whether there are in-progress tasks. */
+    hasInProgress: boolean;
+    /** Whether there are pending (actionable) tasks. */
+    hasPending: boolean;
+    /** Title of the next actionable task, or null. */
+    nextTaskTitle: string | null;
+}
+export interface HenchStatus {
+    /** Whether hench is configured (config.json exists). */
+    configured: boolean;
+    /** Number of run files (JSON). */
+    totalRuns: number;
+    /** Number of currently running (active) runs. */
+    activeRuns: number;
+    /** Number of running runs that appear stale (no recent activity). */
+    staleRuns: number;
+}
+export interface ProjectStatus {
+    sv: SourceVisionStatus;
+    rex: RexStatus;
+    hench: HenchStatus;
+}
+/** Clear the status cache (exposed for testing). */
+export declare function clearStatusCache(): void;
+/** Handle project status API requests. Returns true if the request was handled. */
+export declare function handleStatusRoute(req: IncomingMessage, res: ServerResponse, ctx: ServerContext): boolean;

package/dist/server/routes-status.js

@@ -0,0 +1,191 @@
+/**
+ * Project status API route — lightweight health indicators for sidebar display.
+ *
+ * Combines SourceVision analysis freshness, PRD completion metrics, and
+ * pending task info into a single endpoint optimized for frequent polling.
+ *
+ * GET /api/status — project health indicators
+ */
+import { readFileSync, existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { jsonResponse } from "./types.js";
+import { DATA_FILES } from "../shared/index.js";
+import { computeStats, collectCompletedIds, findNextTask } from "./rex-gateway.js";
+import { loadPRDSync } from "./prd-io.js";
+// ---------------------------------------------------------------------------
+// Freshness threshold — analysis older than 24 hours is "stale"
+// ---------------------------------------------------------------------------
+const STALE_THRESHOLD_MINUTES = 24 * 60;
+/** Cache TTL — 5 seconds. Short enough for real-time feel, long enough to avoid thrashing. */
+const CACHE_TTL_MS = 5_000;
+let cache = null;
+/** Clear the status cache (exposed for testing). */
+export function clearStatusCache() {
+    cache = null;
+}
+// ---------------------------------------------------------------------------
+// Status extraction
+// ---------------------------------------------------------------------------
+const ANALYSIS_MODULES = ["inventory", "imports", "zones", "components", "callgraph"];
+function extractSvStatus(ctx) {
+    const manifestPath = join(ctx.svDir, DATA_FILES.manifest);
+    if (!existsSync(manifestPath)) {
+        return {
+            freshness: "unavailable",
+            analyzedAt: null,
+            minutesAgo: null,
+            modulesComplete: 0,
+            modulesTotal: ANALYSIS_MODULES.length,
+        };
+    }
+    try {
+        const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+        const analyzedAt = manifest.analyzedAt ?? manifest.timestamp ?? null;
+        let minutesAgo = null;
+        let freshness = "fresh";
+        if (analyzedAt) {
+            const elapsed = Date.now() - new Date(analyzedAt).getTime();
+            minutesAgo = Math.round(elapsed / 60_000);
+            freshness = minutesAgo > STALE_THRESHOLD_MINUTES ? "stale" : "fresh";
+        }
+        const modules = manifest.modules ?? {};
+        const modulesComplete = ANALYSIS_MODULES.filter((m) => modules[m]?.status === "complete").length;
+        return {
+            freshness,
+            analyzedAt,
+            minutesAgo,
+            modulesComplete,
+            modulesTotal: ANALYSIS_MODULES.length,
+        };
+    }
+    catch {
+        return {
+            freshness: "unavailable",
+            analyzedAt: null,
+            minutesAgo: null,
+            modulesComplete: 0,
+            modulesTotal: ANALYSIS_MODULES.length,
+        };
+    }
+}
+function extractRexStatus(ctx) {
+    const doc = loadPRDSync(ctx.rexDir);
+    if (!doc) {
+        return {
+            exists: false,
+            percentComplete: 0,
+            stats: null,
+            hasInProgress: false,
+            hasPending: false,
+            nextTaskTitle: null,
+        };
+    }
+    try {
+        const stats = computeStats(doc.items);
+        const completedIds = collectCompletedIds(doc.items);
+        const nextEntry = findNextTask(doc.items, completedIds);
+        return {
+            exists: true,
+            percentComplete: stats.total > 0
+                ? Math.round((stats.completed / stats.total) * 100)
+                : 0,
+            stats,
+            hasInProgress: stats.inProgress > 0,
+            hasPending: stats.pending > 0,
+            nextTaskTitle: nextEntry?.item.title ?? null,
+        };
+    }
+    catch {
+        return {
+            exists: false,
+            percentComplete: 0,
+            stats: null,
+            hasInProgress: false,
+            hasPending: false,
+            nextTaskTitle: null,
+        };
+    }
+}
+/** Staleness threshold for running runs: 5 minutes. */
+const HENCH_STALE_THRESHOLD_MS = 5 * 60 * 1000;
+function extractHenchStatus(ctx) {
+    const henchDir = join(ctx.projectDir, ".hench");
+    const configPath = join(henchDir, "config.json");
+    const runsDir = join(henchDir, "runs");
+    let totalRuns = 0;
+    let activeRuns = 0;
+    let staleRuns = 0;
+    if (existsSync(runsDir)) {
+        try {
+            const entries = readdirSync(runsDir);
+            const jsonFiles = entries.filter((f) => typeof f === "string" ? f.endsWith(".json") : false);
+            const now = Date.now();
+            for (const file of jsonFiles) {
+                try {
+                    const raw = readFileSync(join(runsDir, file), "utf-8");
+                    const run = JSON.parse(raw);
+                    // Only count valid runs (must have id and startedAt) — matches
+                    // the validation in GET /api/hench/runs to keep counts consistent.
+                    if (!run.id || !run.startedAt)
+                        continue;
+                    totalRuns++;
+                    if (run.status === "running") {
+                        activeRuns++;
+                        const lastActivity = run.lastActivityAt;
+                        if (lastActivity) {
+                            if (now - new Date(lastActivity).getTime() > HENCH_STALE_THRESHOLD_MS) {
+                                staleRuns++;
+                            }
+                        }
+                        else {
+                            // No lastActivityAt field (legacy run still marked running) = stale
+                            staleRuns++;
+                        }
+                    }
+                }
+                catch {
+                    // Skip unreadable/unparseable files — not counted toward totalRuns
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return {
+        configured: existsSync(configPath),
+        totalRuns,
+        activeRuns,
+        staleRuns,
+    };
+}
+function buildProjectStatus(ctx) {
+    return {
+        sv: extractSvStatus(ctx),
+        rex: extractRexStatus(ctx),
+        hench: extractHenchStatus(ctx),
+    };
+}
+// ---------------------------------------------------------------------------
+// Route handler
+// ---------------------------------------------------------------------------
+const STATUS_PREFIX = "/api/status";
+/** Handle project status API requests. Returns true if the request was handled. */
+export function handleStatusRoute(req, res, ctx) {
+    const url = req.url || "/";
+    const method = req.method || "GET";
+    if (method !== "GET" || url !== STATUS_PREFIX)
+        return false;
+    const now = Date.now();
+    if (cache &&
+        cache.projectDir === ctx.projectDir &&
+        now - cache.timestamp < CACHE_TTL_MS) {
+        jsonResponse(res, 200, cache.status);
+        return true;
+    }
+    const status = buildProjectStatus(ctx);
+    cache = { status, projectDir: ctx.projectDir, timestamp: now };
+    jsonResponse(res, 200, status);
+    return true;
+}
+//# sourceMappingURL=routes-status.js.map

package/dist/server/routes-status.js.map

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

package/dist/server/routes-token-usage.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Token usage analytics API routes.
+ *
+ * Aggregates token consumption data from all n-dx packages
+ * (rex, hench, sourcevision) and serves it for the dashboard.
+ *
+ * All endpoints are under /api/token/.
+ *
+ * GET /api/token/summary         — aggregate usage with per-package breakdown
+ * GET /api/token/events           — individual token events (with optional filters)
+ * GET /api/token/by-command       — usage grouped by command
+ * GET /api/token/by-period        — usage grouped by time period
+ * GET /api/token/budget           — budget status check
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ServerContext } from "./types.js";
+import { AggregationResultCache } from "./aggregation-cache.js";
+interface ConfiguredModel {
+    vendor: string;
+    model: string;
+}
+type WeeklyBudgetSource = "vendor_model" | "vendor_default" | "global_default" | "missing_budget";
+type WeeklyBudgetReasonCode = "fallback_model_budget_missing_or_invalid" | "fallback_vendor_budget_missing_or_invalid" | "missing_budget_config_not_set" | "missing_budget_no_valid_match" | "missing_budget_invalid_config";
+interface WeeklyBudgetValidationError {
+    code: "invalid_budget_value";
+    path: string;
+    message: string;
+    received: unknown;
+}
+interface WeeklyBudgetResolution {
+    /** Resolved weekly token budget; null means no configured budget applies. */
+    budget: number | null;
+    /** Which lookup tier produced the result. */
+    source: WeeklyBudgetSource;
+    /** Stable reason emitted when fallback/missing budget behavior is used. */
+    reasonCode?: WeeklyBudgetReasonCode;
+}
+interface VendorWeeklyBudgetScope {
+    default?: number;
+    models?: Record<string, number>;
+}
+interface WeeklyBudgetConfig {
+    globalDefault?: number;
+    vendors?: Record<string, VendorWeeklyBudgetScope>;
+}
+/**
+ * Resolve weekly budget using deterministic fallback order:
+ * 1) vendor + model
+ * 2) vendor default
+ * 3) global default
+ * 4) explicit missing budget sentinel
+ */
+export declare function resolveWeeklyBudget(configured: ConfiguredModel, budgetConfig?: WeeklyBudgetConfig, options?: {
+    hasConfiguredBudget?: boolean;
+    validationErrors?: WeeklyBudgetValidationError[];
+}): WeeklyBudgetResolution;
+/** Reset the module-level cache (for testing). */
+export declare function resetAggregationCache(): void;
+/** Get the current cache instance (for testing/monitoring). */
+export declare function getAggregationCacheInstance(): AggregationResultCache | null;
+/** Handle token usage API requests. Returns true if the request was handled. */
+export declare function handleTokenUsageRoute(req: IncomingMessage, res: ServerResponse, ctx: ServerContext): Promise<boolean>;
+export {};