@n-dx/web 0.1.0

package/LICENSE

@@ -0,0 +1,96 @@
+Elastic License 2.0
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set
+of the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key
+functionality in the software, and you may not remove or obscure any
+functionality in the software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other
+notices of the licensor in the software. Any use of the licensor's trademarks
+is subject to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If your company
+makes such a claim, your patent license ends immediately for work on behalf
+of your company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not
+licensed, and your licenses will automatically terminate. If the licensor
+provides you with a notice of your violation, and you cease all violation of
+this license no later than 30 days after you receive that notice, your
+licenses will be reinstated retroactively. However, if you violate these
+terms after such reinstatement, any additional violation of these terms will
+cause your licenses to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is
+the software the licensor makes available under these terms, including any
+portion of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control
+over, are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of
+an entity, or the power to direct its management and policies by vote,
+contract, or otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your
+licenses.
+
+**trademark** means trademarks, service marks, and similar rights.
+
+---
+
+Copyright 2025-2026 En Dash Consulting

package/README.md

@@ -0,0 +1,5 @@
+# @n-dx/web
+
+> **This is an internal package of [`@n-dx/core`](https://www.npmjs.com/package/@n-dx/core).** Install `@n-dx/core` instead — it includes this package and registers all CLI commands.
+
+Web dashboard and unified MCP HTTP server for n-dx. Serves the browser-based project dashboard with zone maps, PRD status, and MCP endpoints for Claude Code integration.

package/build.js

@@ -0,0 +1,243 @@
+import * as esbuild from "esbuild";
+import { readFileSync, writeFileSync, mkdirSync, copyFileSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const watchMode = process.argv.includes("--watch");
+const viewerOnly = process.argv.includes("--viewer-only");
+const landingOnly = process.argv.includes("--landing-only");
+
+const jsEntryPoint = resolve(__dirname, "src/viewer/main.ts");
+const cssEntryPoint = resolve(__dirname, "src/viewer/styles/index.css");
+const htmlTemplatePath = resolve(__dirname, "src/viewer/index.html");
+const outDir = resolve(__dirname, "dist/viewer");
+
+// ── Landing page entry points ─────────────────────────────────────────────────
+// The landing page is a self-contained vanilla-JS feature with no Preact
+// dependency.  All source files (landing.ts, landing.css, index.html) are
+// co-located in src/landing/ so a single zone owns the full feature boundary.
+// Build-time coupling is limited to this build script — there are no runtime
+// imports between the landing page and the dashboard viewer.
+const landingJsEntryPoint = resolve(__dirname, "src/landing/landing.ts");
+const landingCssEntryPoint = resolve(__dirname, "src/landing/landing.css");
+const landingHtmlTemplatePath = resolve(__dirname, "src/landing/index.html");
+const landingOutDir = resolve(__dirname, "dist/landing");
+
+const commonJsOptions = {
+  entryPoints: [jsEntryPoint],
+  bundle: true,
+  format: "esm",
+  target: "es2022",
+  jsx: "automatic",
+  jsxImportSource: "preact",
+  define: {
+    "process.env.NODE_ENV": watchMode ? '"development"' : '"production"',
+  },
+};
+
+function buildHtml(jsCode, cssCode) {
+  const htmlTemplate = readFileSync(htmlTemplatePath, "utf-8");
+
+  let inlinedHtml = htmlTemplate.replace(
+    '<link rel="stylesheet" href="./styles.css">',
+    () => `<style>${cssCode}</style>`
+  );
+
+  inlinedHtml = inlinedHtml.replace(
+    '<script type="module" src="./main.ts"></script>',
+    () => `<script type="module">${jsCode}</script>`
+  );
+
+  mkdirSync(outDir, { recursive: true });
+  writeFileSync(resolve(outDir, "index.html"), inlinedHtml);
+  copyFileSync(resolve(__dirname, "SourceVision.png"), resolve(outDir, "SourceVision.png"));
+  if (existsSync(resolve(__dirname, "SourceVision-F.png"))) {
+    copyFileSync(resolve(__dirname, "SourceVision-F.png"), resolve(outDir, "SourceVision-F.png"));
+  }
+  // Copy logos from sibling packages and project root
+  const monorepoRoot = resolve(__dirname, "../..");
+  const logoPaths = [
+    [resolve(__dirname, "../rex/Rex-F.png"), "Rex-F.png"],
+    [resolve(__dirname, "../hench/Hench-F.png"), "Hench-F.png"],
+    [resolve(monorepoRoot, "n-dx.png"), "n-dx.png"],
+  ];
+  for (const [src, dest] of logoPaths) {
+    if (existsSync(src)) {
+      copyFileSync(src, resolve(outDir, dest));
+    }
+  }
+}
+
+async function bundleCss() {
+  const result = await esbuild.build({
+    entryPoints: [cssEntryPoint],
+    bundle: true,
+    write: false,
+    minify: !watchMode,
+  });
+  return result.outputFiles[0].text;
+}
+
+// ── Landing page build helpers ──
+
+function buildLandingHtml(jsCode, cssCode) {
+  const htmlTemplate = readFileSync(landingHtmlTemplatePath, "utf-8");
+
+  let inlinedHtml = htmlTemplate.replace(
+    '<link rel="stylesheet" href="./landing.css">',
+    () => `<style>${cssCode}</style>`
+  );
+
+  inlinedHtml = inlinedHtml.replace(
+    '<script type="module" src="./landing.ts"></script>',
+    () => `<script type="module">${jsCode}</script>`
+  );
+
+  mkdirSync(landingOutDir, { recursive: true });
+  writeFileSync(resolve(landingOutDir, "index.html"), inlinedHtml);
+}
+
+async function bundleLandingCss() {
+  const result = await esbuild.build({
+    entryPoints: [landingCssEntryPoint],
+    bundle: true,
+    write: false,
+    minify: !watchMode,
+  });
+  return result.outputFiles[0].text;
+}
+
+const landingJsOptions = {
+  entryPoints: [landingJsEntryPoint],
+  bundle: true,
+  format: "esm",
+  target: "es2022",
+};
+
+async function buildViewer() {
+  const jsResult = await esbuild.build({
+    ...commonJsOptions,
+    write: false,
+    minify: true,
+  });
+
+  const jsCode = jsResult.outputFiles[0].text;
+  const cssCode = await bundleCss();
+
+  buildHtml(jsCode, cssCode);
+  console.log("Built viewer: dist/viewer/index.html");
+}
+
+async function buildLanding() {
+  const landingJsResult = await esbuild.build({
+    ...landingJsOptions,
+    write: false,
+    minify: true,
+  });
+
+  const landingJsCode = landingJsResult.outputFiles[0].text;
+  const landingCssCode = await bundleLandingCss();
+
+  buildLandingHtml(landingJsCode, landingCssCode);
+  console.log("Built landing: dist/landing/index.html");
+}
+
+async function buildProduction() {
+  if (landingOnly) {
+    await buildLanding();
+  } else if (viewerOnly) {
+    await buildViewer();
+  } else {
+    await buildViewer();
+    await buildLanding();
+  }
+}
+
+async function buildWatch() {
+  // CSS context for watching
+  const cssCtx = await esbuild.context({
+    entryPoints: [cssEntryPoint],
+    bundle: true,
+    outfile: resolve(outDir, "styles.css"),
+    logLevel: "info",
+  });
+
+  // JS context for watching
+  const jsCtx = await esbuild.context({
+    ...commonJsOptions,
+    write: false,
+    plugins: [{
+      name: "rebuild-html",
+      setup(build) {
+        build.onEnd(async (result) => {
+          if (result.errors.length > 0) return;
+
+          try {
+            const jsCode = result.outputFiles?.[0]?.text ?? "";
+            const cssCode = await bundleCss();
+            buildHtml(jsCode, cssCode);
+            console.log(`[esbuild] Rebuilt viewer: dist/viewer/index.html`);
+          } catch (err) {
+            console.error("[esbuild] HTML rebuild failed:", err.message);
+          }
+        });
+      },
+    }],
+  });
+
+  // Landing page JS context for watching
+  const landingJsCtx = await esbuild.context({
+    ...landingJsOptions,
+    write: false,
+    plugins: [{
+      name: "rebuild-landing-html",
+      setup(build) {
+        build.onEnd(async (result) => {
+          if (result.errors.length > 0) return;
+
+          try {
+            const jsCode = result.outputFiles?.[0]?.text ?? "";
+            const cssCode = await bundleLandingCss();
+            buildLandingHtml(jsCode, cssCode);
+            console.log(`[esbuild] Rebuilt landing: dist/landing/index.html`);
+          } catch (err) {
+            console.error("[esbuild] Landing rebuild failed:", err.message);
+          }
+        });
+      },
+    }],
+  });
+
+  // Initial build — viewer
+  const jsResult = await jsCtx.rebuild();
+  const jsCode = jsResult.outputFiles?.[0]?.text ?? "";
+  const cssCode = await bundleCss();
+  buildHtml(jsCode, cssCode);
+  console.log("[esbuild] Initial build complete: dist/viewer/index.html");
+
+  // Initial build — landing
+  const landingJsResult = await landingJsCtx.rebuild();
+  const landingJsCode = landingJsResult.outputFiles?.[0]?.text ?? "";
+  const landingCssCode = await bundleLandingCss();
+  buildLandingHtml(landingJsCode, landingCssCode);
+  console.log("[esbuild] Initial build complete: dist/landing/index.html");
+
+  // Start watching all
+  await cssCtx.watch();
+  await jsCtx.watch();
+  await landingJsCtx.watch();
+  console.log("[esbuild] Watching for changes...");
+}
+
+if (watchMode) {
+  buildWatch().catch((err) => {
+    console.error("Watch failed:", err);
+    process.exit(1);
+  });
+} else {
+  buildProduction().catch((err) => {
+    console.error("Build failed:", err);
+    process.exit(1);
+  });
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * n-dx web dashboard CLI
+ *
+ * Commands:
+ *   serve [dir]   - Start the web dashboard server
+ */
+export {};

package/dist/cli/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * n-dx web dashboard CLI
+ *
+ * Commands:
+ *   serve [dir]   - Start the web dashboard server
+ */
+import { resolve } from "node:path";
+import { startServer } from "../server/start.js";
+const VALID_SCOPES = new Set(["sourcevision", "rex", "hench"]);
+const args = process.argv.slice(2);
+const command = args[0];
+let port = 3117;
+let scope;
+for (const a of args.slice(1)) {
+    if (a.startsWith("--port=")) {
+        port = parseInt(a.split("=")[1], 10);
+    }
+    else if (a.startsWith("--scope=")) {
+        const val = a.split("=")[1];
+        if (!VALID_SCOPES.has(val)) {
+            console.error(`Invalid scope: ${val} (valid: ${[...VALID_SCOPES].join(", ")})`);
+            process.exit(1);
+        }
+        scope = val;
+    }
+}
+const targetArg = args.slice(1).find((a) => !a.startsWith("-"));
+if (command === "serve") {
+    const dir = resolve(targetArg || ".");
+    const dev = args.includes("--dev");
+    await startServer(dir, port, { dev, scope });
+}
+else {
+    console.log(`n-dx web dashboard
+
+Commands:
+  serve [dir]   Start the web dashboard server
+
+Options:
+  --port=N                  Port to listen on (default: 3117)
+  --scope=<package>         Restrict to a single package (sourcevision, rex, hench)
+  --dev                     Enable dev mode (live reload)
+`);
+    if (command) {
+        console.error(`Unknown command: ${command}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAc,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAE5E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAExB,IAAI,IAAI,GAAG,IAAI,CAAC;AAChB,IAAI,KAA8B,CAAC;AAEnC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;SAAM,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAgB,CAAC;QAC3C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,kBAAkB,GAAG,YAAY,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,KAAK,GAAG,GAAG,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/C,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC;;;;;;;;;CASb,CAAC,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}