@n-dx/core 0.1.0

package/packages/sourcevision/dist/cli/output.js

@@ -0,0 +1,48 @@
+/**
+ * CLI output control — supports --quiet mode for scripting.
+ *
+ * Re-exports the shared foundation primitives from @n-dx/llm-client.
+ * All existing consumers import from this file — the re-export preserves
+ * their import paths while consolidating the implementation.
+ */
+export { setQuiet, isQuiet, info, result } from "@n-dx/llm-client";
+import { isQuiet, info } from "@n-dx/llm-client";
+import ora from "ora";
+/**
+ * Start an animated progress spinner in the terminal.
+ * Suppressed in quiet mode or non-TTY environments (falls back to a single info line).
+ */
+export function startSpinner(message) {
+    if (isQuiet() || !process.stderr.isTTY) {
+        info(message);
+        let stopped = false;
+        return {
+            update(_msg) { },
+            stop(final) {
+                if (stopped)
+                    return;
+                stopped = true;
+                if (final)
+                    info(final);
+            },
+        };
+    }
+    const spinner = ora({ text: message, stream: process.stderr }).start();
+    let stopped = false;
+    return {
+        update(msg) {
+            if (stopped)
+                return;
+            spinner.text = msg;
+        },
+        stop(finalMessage) {
+            if (stopped)
+                return;
+            stopped = true;
+            spinner.stop();
+            if (finalMessage)
+                info(finalMessage);
+        },
+    };
+}
+//# sourceMappingURL=output.js.map

package/packages/sourcevision/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,GAAG,MAAM,KAAK,CAAC;AAStB;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,CAAC;QACd,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,OAAO;YACL,MAAM,CAAC,IAAY,IAAe,CAAC;YACnC,IAAI,CAAC,KAAc;gBACjB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,KAAK;oBAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IACvE,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO;QACL,MAAM,CAAC,GAAW;YAChB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,YAAqB;YACxB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,YAAY;gBAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/packages/sourcevision/dist/cli/serve.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Delegate `sourcevision serve` to the @n-dx/web package.
+ *
+ * The web server code now lives in packages/web. This stub provides
+ * backward compatibility for `sourcevision serve [dir]`.
+ *
+ * Resolution uses the pnpm workspace root to locate the sibling package,
+ * avoiding a hardcoded relative path that would create a tier-inversion
+ * edge in the import graph (Domain → Web).
+ */
+export declare function startServe(dir: string, port?: number): Promise<void>;

package/packages/sourcevision/dist/cli/serve.js

@@ -0,0 +1,41 @@
+/**
+ * Delegate `sourcevision serve` to the @n-dx/web package.
+ *
+ * The web server code now lives in packages/web. This stub provides
+ * backward compatibility for `sourcevision serve [dir]`.
+ *
+ * Resolution uses the pnpm workspace root to locate the sibling package,
+ * avoiding a hardcoded relative path that would create a tier-inversion
+ * edge in the import graph (Domain → Web).
+ */
+import { resolve, dirname } from "node:path";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { spawnTool } from "@n-dx/llm-client";
+const __filename = fileURLToPath(import.meta.url);
+/**
+ * Walk up from the current file to find the monorepo root
+ * (identified by pnpm-workspace.yaml), then resolve the web CLI.
+ */
+function resolveWebCli() {
+    let dir = dirname(__filename);
+    for (let i = 0; i < 10; i++) {
+        if (existsSync(resolve(dir, "pnpm-workspace.yaml"))) {
+            const webCli = resolve(dir, "packages/web/dist/cli/index.js");
+            if (existsSync(webCli))
+                return webCli;
+            break;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error("Could not locate @n-dx/web CLI. Ensure you are running inside the n-dx workspace.");
+}
+export async function startServe(dir, port = 3117) {
+    const webCli = resolveWebCli();
+    const result = await spawnTool(process.execPath, [webCli, "serve", "--scope=sourcevision", `--port=${port}`, dir]);
+    process.exit(result.exitCode ?? 1);
+}
+//# sourceMappingURL=serve.js.map

package/packages/sourcevision/dist/cli/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/cli/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAElD;;;GAGG;AACH,SAAS,aAAa;IACpB,IAAI,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,gCAAgC,CAAC,CAAC;YAC9D,IAAI,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;YACtC,MAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,OAAe,IAAI;IAC/D,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,SAAS,CAC5B,OAAO,CAAC,QAAQ,EAChB,CAAC,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,UAAU,IAAI,EAAE,EAAE,GAAG,CAAC,CACjE,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC"}

package/packages/sourcevision/dist/cli/server/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Web server for the n-dx dashboard.
+ *
+ * Serves the sourcevision viewer, provides REST API endpoints for
+ * Rex (PRD data), sourcevision (analysis data), and Hench (agent runs),
+ * and supports WebSocket connections for real-time updates.
+ *
+ * Architecture:
+ *   Static assets   → routes-static.ts
+ *   /data/*          → routes-data.ts    (sourcevision data files, live-reload)
+ *   /api/rex/*       → routes-rex.ts     (PRD CRUD, stats, next task, log)
+ *   /api/sv/*        → routes-sourcevision.ts (analysis data endpoints)
+ *   /api/hench/*     → routes-hench.ts   (agent run history, run detail)
+ *   WebSocket        → websocket.ts      (upgrade handler, broadcast)
+ */
+export { startServer } from "./start.js";
+export type { ServerOptions } from "./start.js";
+export type { ServerContext, RouteHandler } from "./types.js";
+export type { WebSocketBroadcaster } from "./websocket.js";

package/packages/sourcevision/dist/cli/server/index.js

@@ -0,0 +1,17 @@
+/**
+ * Web server for the n-dx dashboard.
+ *
+ * Serves the sourcevision viewer, provides REST API endpoints for
+ * Rex (PRD data), sourcevision (analysis data), and Hench (agent runs),
+ * and supports WebSocket connections for real-time updates.
+ *
+ * Architecture:
+ *   Static assets   → routes-static.ts
+ *   /data/*          → routes-data.ts    (sourcevision data files, live-reload)
+ *   /api/rex/*       → routes-rex.ts     (PRD CRUD, stats, next task, log)
+ *   /api/sv/*        → routes-sourcevision.ts (analysis data endpoints)
+ *   /api/hench/*     → routes-hench.ts   (agent run history, run detail)
+ *   WebSocket        → websocket.ts      (upgrade handler, broadcast)
+ */
+export { startServer } from "./start.js";
+//# sourceMappingURL=index.js.map

package/packages/sourcevision/dist/cli/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/packages/sourcevision/dist/cli/server/routes-data.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Data routes — serves .sourcevision/ data files and live-reload status.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ServerContext } from "./types.js";
+export interface DataWatcher {
+    fileMtimes: Record<string, number>;
+    viewerMtime: number;
+    refresh: () => void;
+}
+/** Create a mtime tracker for live-reload support. */
+export declare function createDataWatcher(ctx: ServerContext, viewerPath?: string): DataWatcher;
+/** Handle data file requests. Returns true if the request was handled. */
+export declare function handleDataRoute(req: IncomingMessage, res: ServerResponse, ctx: ServerContext, watcher: DataWatcher): boolean;

package/packages/sourcevision/dist/cli/server/routes-data.js

@@ -0,0 +1,122 @@
+/**
+ * Data routes — serves .sourcevision/ data files and live-reload status.
+ */
+import { readFileSync, existsSync, statSync } from "node:fs";
+import { join, extname } from "node:path";
+import { jsonResponse } from "./types.js";
+import { ALL_DATA_FILES, SUPPLEMENTARY_FILES } from "../../schema/data-files.js";
+const MIME_TYPES = {
+    ".html": "text/html",
+    ".js": "application/javascript",
+    ".css": "text/css",
+    ".json": "application/json",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".md": "text/markdown",
+    ".txt": "text/plain",
+};
+/** Create a mtime tracker for live-reload support. */
+export function createDataWatcher(ctx, viewerPath) {
+    const watcher = {
+        fileMtimes: {},
+        viewerMtime: 0,
+        refresh() {
+            for (const file of ALL_DATA_FILES) {
+                const filePath = join(ctx.svDir, file);
+                try {
+                    if (existsSync(filePath)) {
+                        watcher.fileMtimes[file] = statSync(filePath).mtimeMs;
+                    }
+                }
+                catch {
+                    // File may be mid-write
+                }
+            }
+            // Track prd.json mtime
+            const prdPath = join(ctx.rexDir, "prd.json");
+            try {
+                if (existsSync(prdPath)) {
+                    watcher.fileMtimes["prd.json"] = statSync(prdPath).mtimeMs;
+                }
+            }
+            catch {
+                // ignore
+            }
+            // Track viewer HTML mtime in dev mode
+            if (ctx.dev && viewerPath) {
+                try {
+                    watcher.viewerMtime = statSync(viewerPath).mtimeMs;
+                }
+                catch {
+                    // ignore
+                }
+            }
+        },
+    };
+    watcher.refresh();
+    return watcher;
+}
+/** Handle data file requests. Returns true if the request was handled. */
+export function handleDataRoute(req, res, ctx, watcher) {
+    const url = req.url || "/";
+    const method = req.method || "GET";
+    if (method !== "GET")
+        return false;
+    // Status endpoint for live reload polling
+    if (url === "/data/status") {
+        const status = { mtimes: watcher.fileMtimes };
+        if (ctx.dev)
+            status.viewerMtime = watcher.viewerMtime;
+        jsonResponse(res, 200, status);
+        return true;
+    }
+    // List available data files
+    if (url === "/data") {
+        const files = [...ALL_DATA_FILES, ...SUPPLEMENTARY_FILES];
+        const available = files.filter((f) => existsSync(join(ctx.svDir, f)));
+        if (existsSync(join(ctx.rexDir, "prd.json"))) {
+            available.push("prd.json");
+        }
+        jsonResponse(res, 200, { files: available });
+        return true;
+    }
+    // Serve individual data files
+    if (url.startsWith("/data/")) {
+        const dataFile = url.replace("/data/", "");
+        // Serve prd.json from .rex/ directory
+        if (dataFile === "prd.json") {
+            const prdPath = join(ctx.rexDir, "prd.json");
+            if (existsSync(prdPath)) {
+                const content = readFileSync(prdPath, "utf-8");
+                res.writeHead(200, { "Content-Type": "application/json", "Cache-Control": "no-cache" });
+                res.end(content);
+            }
+            else {
+                res.writeHead(404);
+                res.end("Not found");
+            }
+            return true;
+        }
+        const filePath = join(ctx.svDir, dataFile);
+        // Prevent directory traversal
+        if (!filePath.startsWith(ctx.svDir)) {
+            res.writeHead(403);
+            res.end("Forbidden");
+            return true;
+        }
+        if (existsSync(filePath)) {
+            const ext = extname(filePath);
+            const mime = MIME_TYPES[ext] || "application/octet-stream";
+            const content = readFileSync(filePath, "utf-8");
+            res.writeHead(200, { "Content-Type": mime });
+            res.end(content);
+        }
+        else {
+            res.writeHead(404);
+            res.end("Not found");
+        }
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=routes-data.js.map

package/packages/sourcevision/dist/cli/server/routes-data.js.map

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

package/packages/sourcevision/dist/cli/server/routes-hench.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hench API routes — read-only access to agent run history.
+ *
+ * All endpoints are under /api/hench/.
+ *
+ * GET  /api/hench/runs        — list runs with summary (newest first, ?limit=N)
+ * GET  /api/hench/runs/:id    — full run detail with transcript
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ServerContext } from "./types.js";
+/** Handle Hench API requests. Returns true if the request was handled. */
+export declare function handleHenchRoute(req: IncomingMessage, res: ServerResponse, ctx: ServerContext): boolean;

package/packages/sourcevision/dist/cli/server/routes-hench.js

@@ -0,0 +1,100 @@
+/**
+ * Hench API routes — read-only access to agent run history.
+ *
+ * All endpoints are under /api/hench/.
+ *
+ * GET  /api/hench/runs        — list runs with summary (newest first, ?limit=N)
+ * GET  /api/hench/runs/:id    — full run detail with transcript
+ */
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { jsonResponse, errorResponse } from "./types.js";
+const HENCH_PREFIX = "/api/hench/";
+/** Read a single run file, returning the full parsed JSON or null on error. */
+function loadRunFile(runsDir, id) {
+    try {
+        const raw = readFileSync(join(runsDir, `${id}.json`), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Strip heavy fields to produce a lightweight summary for list views. */
+function toRunSummary(run) {
+    const structured = run.structuredSummary;
+    return {
+        id: run.id,
+        taskId: run.taskId,
+        taskTitle: run.taskTitle,
+        startedAt: run.startedAt,
+        finishedAt: run.finishedAt,
+        status: run.status,
+        turns: run.turns,
+        summary: run.summary,
+        error: run.error,
+        model: run.model,
+        tokenUsage: (run.tokenUsage ?? { input: 0, output: 0 }),
+        structuredSummary: structured
+            ? { counts: structured.counts }
+            : undefined,
+    };
+}
+/** Handle Hench API requests. Returns true if the request was handled. */
+export function handleHenchRoute(req, res, ctx) {
+    const url = req.url || "/";
+    const method = req.method || "GET";
+    if (!url.startsWith(HENCH_PREFIX))
+        return false;
+    const fullPath = url.slice(HENCH_PREFIX.length);
+    const qIdx = fullPath.indexOf("?");
+    const path = qIdx === -1 ? fullPath : fullPath.slice(0, qIdx);
+    const runsDir = join(ctx.projectDir, ".hench", "runs");
+    // GET /api/hench/runs — list runs with summary
+    if (path === "runs" && method === "GET") {
+        let files;
+        try {
+            files = readdirSync(runsDir);
+        }
+        catch {
+            jsonResponse(res, 200, { runs: [] });
+            return true;
+        }
+        const jsonFiles = files.filter((f) => f.endsWith(".json"));
+        // Parse limit from query string
+        let limit = 0;
+        if (qIdx !== -1) {
+            const params = new URLSearchParams(fullPath.slice(qIdx));
+            const limitStr = params.get("limit");
+            if (limitStr)
+                limit = parseInt(limitStr, 10);
+        }
+        // Load all runs, extract summaries, sort by startedAt descending
+        const summaries = [];
+        for (const file of jsonFiles) {
+            const id = file.replace(/\.json$/, "");
+            const run = loadRunFile(runsDir, id);
+            if (run && run.id && run.startedAt) {
+                summaries.push(toRunSummary(run));
+            }
+        }
+        summaries.sort((a, b) => b.startedAt.localeCompare(a.startedAt));
+        const result = limit > 0 ? summaries.slice(0, limit) : summaries;
+        jsonResponse(res, 200, { runs: result });
+        return true;
+    }
+    // GET /api/hench/runs/:id — full run detail
+    const runsMatch = path.match(/^runs\/([^/?]+)$/);
+    if (runsMatch && method === "GET") {
+        const runId = runsMatch[1];
+        const run = loadRunFile(runsDir, runId);
+        if (!run) {
+            errorResponse(res, 404, `Run "${runId}" not found`);
+            return true;
+        }
+        jsonResponse(res, 200, run);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=routes-hench.js.map

package/packages/sourcevision/dist/cli/server/routes-hench.js.map

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

package/packages/sourcevision/dist/cli/server/routes-rex.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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
+ * PATCH /api/rex/items/bulk       — bulk update multiple items
+ * POST  /api/rex/analyze          — trigger analysis (scan project)
+ * GET   /api/rex/proposals        — get pending proposals
+ * POST  /api/rex/proposals/accept — accept pending proposals
+ * GET   /api/rex/log              — execution log (?limit=N)
+ */
+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. */
+export declare function handleRexRoute(req: IncomingMessage, res: ServerResponse, ctx: ServerContext, broadcast?: WebSocketBroadcaster): boolean | Promise<boolean>;