dslinter 0.1.13 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,77 @@
 # Changelog
 
+## v0.2.2
+
+[compare changes](https://github.com/jrmybtlr/DSLinter/compare/v0.2.1...v0.2.2)
+
+### ✅ Tests
+
+- **collectScanModules:** Enhance case sensitivity tests for include_dirs ([32c2065](https://github.com/jrmybtlr/DSLinter/commit/32c2065))
+
+### ❤️ Contributors
+
+- Jeremy Butler <jeremy.butler@laravel.com>
+
+## v0.2.1
+
+[compare changes](https://github.com/jrmybtlr/DSLinter/compare/v0.2.0...v0.2.1)
+
+### 🩹 Fixes
+
+- **ci:** Build NAPI and demo report before publish tests ([fdf497d](https://github.com/jrmybtlr/DSLinter/commit/fdf497d))
+- **report-cache:** Improve report path validation by ensuring report root matches project root ([7510dde](https://github.com/jrmybtlr/DSLinter/commit/7510dde))
+
+### 💅 Refactors
+
+- Enhance path resolution for include directories and improve case sensitivity handling ([22c96fb](https://github.com/jrmybtlr/DSLinter/commit/22c96fb))
+
+### ❤️ Contributors
+
+- Jeremy Butler <jeremy.butler@laravel.com>
+
+## v0.2.0
+
+[compare changes](https://github.com/jrmybtlr/DSLinter/compare/v0.1.13...v0.2.0)
+
+### 🚀 Enhancements
+
+- **website:** Switch deploy config from pages to workers ([22d7e35](https://github.com/jrmybtlr/DSLinter/commit/22d7e35))
+- **playground:** Add user info playground component and enhance controls handling ([625f7c2](https://github.com/jrmybtlr/DSLinter/commit/625f7c2))
+
+### 🔥 Performance
+
+- Precompute newline_offsets once in analyze_vue_file, pass to merge_template_usages ([a2839b3](https://github.com/jrmybtlr/DSLinter/commit/a2839b3))
+
+### 🩹 Fixes
+
+- **dashboard:** Address PR review feedback on publish files and API export ([d3a1f1b](https://github.com/jrmybtlr/DSLinter/commit/d3a1f1b))
+- Import website main stylesheet in entrypoint ([79fa1ec](https://github.com/jrmybtlr/DSLinter/commit/79fa1ec))
+- Remove duplicate typescript devDependency in dashboard package ([03e3dc1](https://github.com/jrmybtlr/DSLinter/commit/03e3dc1))
+- Address review comments - remove duplicate typescript dep, add .d.mts declaration, remove dead code ([cbfd7ab](https://github.com/jrmybtlr/DSLinter/commit/cbfd7ab))
+
+### 💅 Refactors
+
+- **rust:** Consolidate usage maps, DRY FileScan ctors, remove scan_and_evaluate, fix scoring bugs, use lazy_regex! ([5033b13](https://github.com/jrmybtlr/DSLinter/commit/5033b13))
+- **ts:** Split playground module, useRef cancellation, Set dedup, useMemo fixes, DashboardLayout, Sidebar, barrel index ([d57a673](https://github.com/jrmybtlr/DSLinter/commit/d57a673))
+
+### 📖 Documentation
+
+- Update README config options ([5f2be14](https://github.com/jrmybtlr/DSLinter/commit/5f2be14))
+- Remove trailing spaces in README ([1fc4c1d](https://github.com/jrmybtlr/DSLinter/commit/1fc4c1d))
+
+### 🏡 Chore
+
+- **release:** V0.1.13 ([3cd1a20](https://github.com/jrmybtlr/DSLinter/commit/3cd1a20))
+- **dashboard:** Remove dead code and dedupe helpers ([cb41bcd](https://github.com/jrmybtlr/DSLinter/commit/cb41bcd))
+- Begin optimisation pass over src/ and packages/dashboard ([8ec1a34](https://github.com/jrmybtlr/DSLinter/commit/8ec1a34))
+- Plan cloudflare workers website deploy ([affabf5](https://github.com/jrmybtlr/DSLinter/commit/affabf5))
+- Add semver as a dev dependency and update pnpm lockfile ([18afb12](https://github.com/jrmybtlr/DSLinter/commit/18afb12))
+
+### ❤️ Contributors
+
+- Jeremy Butler <jeremy.butler@laravel.com>
+- Cursor Agent ([@cursoragent](https://github.com/cursoragent))
+
 ## v0.1.13
 
 [compare changes](https://github.com/jrmybtlr/DSLinter/compare/v0.1.12...v0.1.13)

package/README.md

@@ -1,6 +1,6 @@
 # dslinter
 
-React UI for the **DSLinter dashboard**: component playground shell, token wall, and governance panels. It expects a **`dslint-report.json`** file produced by the **`dslinter`** CLI (Rust scanner powered by [Oxc](https://oxc.rs) in this repo).
+React UI for the **DSLinter dashboard**: component playground shell, token wall, and governance panels. It expects a **`dslinter-report.json`** file produced by the **`dslinter`** CLI (Rust scanner powered by [Oxc](https://oxc.rs) in this repo).
 
 **Previously published as `@dslinter/dashboard`.** Migrate with `npm install dslinter` and replace imports `@dslinter/dashboard` → `dslinter`, and `@dslinter/dashboard/theme.css` → `dslinter/theme.css`.
 
@@ -24,9 +24,10 @@ The **`dslinter`** command orchestrates the Rust scanner (via **napi-rs**, same
 | Mode | Flag | Behavior |
 |------|------|----------|
 | Dev (default locally) | _(none)_ | `--serve`, watch, write `--output`, start Vite `--mode serve` |
-| Report | `--report` | One-shot scan; human stdout or `--json`; `--output` writes JSON |
-| Watch | `--watch` | Watch + write JSON only |
-| Build | `--build` | One-shot report to `--output`, then `vite build` |
+| Report | `--report` | One-shot scan; human stdout or `--json`; `--output` writes JSON; enriches playground prop kinds/options from TypeScript when `tsconfig.json` is present |
+| Watch | `--watch` | Watch + write JSON only; re-enriches playgrounds after each scan |
+| Build | `--build` | One-shot report to `--output` (with TS enrichment), then `vite build` |
+| MCP | `mcp` | Stdio MCP server for AI agents (catalog, findings, agent context) |
 | CI default | `CI=true` | Same as `--report` |
 
 Scanner flags: `--json`, `-p` / `--parallel`, `--fail-on-warnings`, `--max-warnings`, `--output`, `[PATH]`. Low-level: `--serve <port>` (watch + HTTP, no Vite).
@@ -37,43 +38,48 @@ On **`npm install dslinter`**, npm installs the platform **`@dslinter/binding-*`
 
 | Variable | Purpose |
 |----------|---------|
-| `DSLINT_BIN` | Use a cargo-built `dslinter` binary instead of the NAPI binding. |
-| `DSLINT_ALLOW_PATH=1` | Allow `dslinter` on `PATH` when the binding is missing. |
+| `DSLINTER_BIN` | Use a cargo-built `dslinter` binary instead of the NAPI binding. |
+| `DSLINTER_ALLOW_PATH=1` | Allow `dslinter` on `PATH` when the binding is missing. |
 | `NAPI_RS_NATIVE_LIBRARY_PATH` | Point at a specific `.node` file (napi-rs escape hatch). |
 
 ### Do not `cargo install dslint`
 
-The crates.io crate **`dslint`** is a **different project**. Use **`cargo install --git https://github.com/jrmybtlr/DSLinter dslinter --locked`** or **`DSLINT_BIN`** for local Rust builds.
+The crates.io crate **`dslint`** is a **different project**. Use **`cargo install --git https://github.com/jrmybtlr/DSLinter dslinter --locked`** or **`DSLINTER_BIN`** for local Rust builds.
 
 Typical usage:
 
 ```bash
-npx dslinter init                         # scaffold .dslint.json + src/playground/buildRegistry.ts
-npx dslinter                              # dev (watch + dashboard)
-npx dslinter --report /path/to/repo --json
-npx dslinter --report --output public/dslint-report.json
-npx dslinter --watch --output public/dslint-report.json
+npx dslinter                              # dev (watch + dashboard) — run from any project subdirectory
+npx dslinter --yes                        # dev + auto-create .dslinter.json and public/ without prompting
+npx dslinter init                         # optional: scaffold buildRegistry.ts for custom controls
+npx dslinter --report demo --json
+npx dslinter --report --output public/dslinter-report.json
+npx dslinter --watch --output public/dslinter-report.json
 ```
 
-Set `DSLINT_SERVE_PORT` to override the default scanner port (`7878`).
-On first local run, `npx dslinter` scaffolds `.dslint.json` automatically if missing.
+Set `DSLINTER_SERVE_PORT` to override the default scanner port (`7878`).
+When dev mode prints both a **Dashboard** URL and a **Scanner API** URL, open the **Dashboard** URL for the UI (port 7878 is the scanner API only).
+
+On first local run in an interactive terminal, `npx dslinter` asks whether to create minimal setup files (`.dslinter.json` and `public/`). In CI or with `--yes`, those files are created automatically. Set `DSLINTER_NO_SCAFFOLD=1` to skip all writes.
+
+| Flag / variable | Purpose |
+|-----------------|--------|
+| `--yes` / `-y` | Create minimal scaffold without prompting |
+| `DSLINTER_NO_SCAFFOLD=1` | Never write scaffold files |
+| `DSLINTER_USE_CONSUMER_VITE=1` | Use your app's Vite dev server as the dashboard UI (embedded `<DashboardLayout />`) |
+| `DSLINTER_NO_EMBED_VITE=1` | Disable standalone embed dashboard dev server |
 
 ### Zero-config live previews (recommended)
 
-**`npx dslinter .`** from your project root auto-merges the dslinter Vite plugin (playground module glob, scanner proxy, react dedupe). In your app:
+Run **`npx dslinter`** from your repo (including `resources/js/Components` or other subdirectories — the CLI resolves the project root automatically). For **Laravel / Inertia** apps, dev mode starts a **standalone DSLinter dashboard** with live previews; you do **not** need to add `<DashboardLayout />` to your Inertia app.
 
-```tsx
-import { DashboardLayout, useWorkspaceReport } from "dslinter";
+Previews load your components with your Vite `@/` aliases and Inertia stubs (`usePage`, `<Link>`, etc.) so isolated components render without a full page visit.
 
-const dslinterReport = useWorkspaceReport({
-  reportUrl: "/dslint-report.json",
-  watchUrl: "/events",
-});
+The embed dev server registers Tailwind `@source` paths for your `.dslinter.json` **`include_dirs`** (for example `resources/js/components`), so component utility classes like `px-3.5` are generated in preview CSS. For 100% parity with your app's full CSS pipeline (theme entry, `@custom-variant`, etc.), use `DSLINTER_USE_CONSUMER_VITE=1` instead.
 
-<DashboardLayout autoPlayground dslinterReport={dslinterReport} tokenCatalog={...} />;
-```
+The prebuilt **`dashboard-dist`** bundle shipped on npm does not run this Vite transform; use embed dev mode (monorepo / git checkout) or consumer Vite for accurate preview styling.
 
-No `buildRegistry.ts` scaffold required. Works with Laravel/Inertia (`resources/js/Components/...`) and existing `@/*` → `resources/js/*` aliases.
+For apps that already embed the dashboard (like this repo's `demo/`), dev mode uses your app's Vite server when `src/App.tsx` imports `DashboardLayout` from `dslinter`.
 
 **Direct `vite --mode serve`:** add one line to `vite.config.ts`:
 
@@ -85,12 +91,27 @@ export default defineConfig({
 });
 ```
 
-The plugin sets `DSLINT_SCAN_ROOT` from the environment (set by `npx dslinter`) or defaults to `process.cwd()`.
+The plugin sets `DSLINTER_SCAN_ROOT` from the environment (set by `npx dslinter`) or defaults to `process.cwd()`.
 
 ### Consumer Vite (Laravel, Inertia, existing `@/*` aliases)
 
 Published `dslinter` source uses **relative imports only** — your app's `@/*` alias does not hijack dslinter internal UI. You do **not** need `@/components` → `node_modules/dslinter` alias overrides.
 
+### Laravel / Inertia (zero app code)
+
+```bash
+cd my-laravel-app
+npx dslinter
+```
+
+Open the **Dashboard** URL from the terminal banner (default port `5175`). The scanner writes `public/dslinter-report.json` at the project root.
+
+No Inertia route, no `buildRegistry.ts`, and no `vite.config` edits are required for dev previews.
+
+**Optional — embed dashboard in your app:** set `DSLINTER_USE_CONSUMER_VITE=1`, add `plugins: [dslinter()]` from `dslinter/vite`, and render `<DashboardLayout autoPlayground dslinterReport={...} />`.
+
+**Optional — custom playground controls:** `npx dslinter init --laravel` scaffolds `resources/js/playground/buildRegistry.ts`.
+
 ## Styles (Tailwind v4)
 
 1. In your app CSS, load Tailwind, then point Tailwind at this package so utility scanning picks up dashboard classes:
@@ -113,7 +134,7 @@ Use **`autoPlayground`** (above) for zero-config previews. Optionally scaffold a
 - `npx dslinter init` → `src/playground/buildRegistry.ts`
 - `npx dslinter init --laravel` → `resources/js/playground/buildRegistry.ts`
 
-`npx dslinter init` now also scaffolds a starter `.dslint.json` (unless one already exists), including:
+`npx dslinter init` now also scaffolds a starter `.dslinter.json` (unless one already exists), including:
 - `include_dirs` (directory scope for discovery)
 - `ignore_globs` (file/directory ignores)
 - `css_entrypoints` (main CSS entry files for token analysis)
@@ -123,7 +144,7 @@ import { useMemo } from "react";
 import { DashboardLayout, useWorkspaceReport } from "dslinter";
 import { buildPlaygroundEntries } from "./playground/buildRegistry";
 
-const dslinterReport = useWorkspaceReport({ reportUrl: "/dslint-report.json", watchUrl: "/events" });
+const dslinterReport = useWorkspaceReport({ reportUrl: "/dslinter-report.json", watchUrl: "/events" });
 const playgroundEntries = useMemo(
   () => buildPlaygroundEntries(dslinterReport.report),
   [dslinterReport.report],
@@ -143,7 +164,7 @@ Run the scanner from the **project root** (`npx dslinter .`) so `playgrounds[].r
 - **`autoPlayground`** (recommended) — or **`playgroundEntries`** from a custom registry / `usePlaygroundFromReport`.
 - **`playgroundJoinSkips`** (optional) — auto-filled when using `autoPlayground`.
 - **`tokenCatalog`** — token wall data (see `demo/src/tokenCatalog.ts`).
-- **`dslinterReport`** — from `useWorkspaceReport({ reportUrl: "/dslint-report.json", ... })`.
+- **`dslinterReport`** — from `useWorkspaceReport({ reportUrl: "/dslinter-report.json", ... })`.
 
 ```tsx
 import { useMemo } from "react";
@@ -156,7 +177,7 @@ import { tokenCatalog } from "./tokenCatalog";
 
 export default function App() {
   const dslinterReport = useWorkspaceReport({
-    reportUrl: "/dslint-report.json",
+    reportUrl: "/dslinter-report.json",
     refreshIntervalMs: 5000,
   });
 

package/bin/dslinter.mjs

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
 /**
- * DSLinter CLI: mode routing (dev / report / watch / build) + scanner (NAPI or DSLINT_BIN).
+ * DSLinter CLI: mode routing (dev / report / watch / build) + scanner (NAPI or DSLINTER_BIN).
  */
 import { parseDslinterArgs } from "./lib/parse-args.mjs";
+import { withScannerScanPath } from "./lib/resolve-project.mjs";
+import { logScanScopeHint } from "./lib/project-root.mjs";
 import { runScannerInternal } from "./lib/run-scanner.mjs";
 import { runBuildMode } from "./modes/build.mjs";
 import { runDevMode } from "./modes/dev.mjs";
 import { runInitMode } from "./modes/init.mjs";
+import { runMcpMode } from "./modes/mcp.mjs";
 import { runReportMode } from "./modes/report.mjs";
 
 const rawArgs = process.argv.slice(2);
@@ -16,6 +19,10 @@ if (rawArgs[0] === "init") {
   process.exit(0);
 }
 
+if (rawArgs[0] === "mcp") {
+  await runMcpMode({ argv: rawArgs.slice(1) });
+}
+
 if (process.env.DSLINTER_INTERNAL === "1") {
   runScannerInternal(rawArgs);
 }
@@ -36,23 +43,37 @@ try {
   process.exit(1);
 }
 
-const { mode, scannerArgs } = parsed;
+const { mode } = parsed;
+logScanScopeHint({
+  scanPath: parsed.scanPath,
+  projectRoot: parsed.projectRoot,
+  explicitScanPath: parsed.explicitScanPath,
+});
+const scannerArgs = withScannerScanPath(parsed.scannerArgs, parsed.scanPath);
+const runParsed = { ...parsed, scannerArgs };
 
 switch (mode) {
   case "dev":
-    await runDevMode(parsed);
+    await runDevMode(runParsed);
     break;
   case "report":
-    runReportMode(["--report", ...scannerArgs]);
+    await runReportMode({
+      scanPath: runParsed.scanPath,
+      projectRoot: runParsed.projectRoot,
+      outputPath: runParsed.outputPath,
+      scannerArgs: runParsed.scannerArgs,
+    });
     break;
   case "watch":
+    process.env.DSLINTER_PROJECT_ROOT = runParsed.projectRoot;
     runScannerInternal(["--watch", ...scannerArgs]);
     break;
   case "scanner":
+    process.env.DSLINTER_PROJECT_ROOT = runParsed.projectRoot;
     runScannerInternal(scannerArgs);
     break;
   case "build":
-    runBuildMode(parsed);
+    await runBuildMode(runParsed);
     break;
   default:
     process.stderr.write(`dslinter: unknown mode ${mode}\n`);

package/bin/lib/config-hide-component.mjs

@@ -0,0 +1,44 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const CONFIG_FILE_NAMES = [".dslinter.json", "dslinter.json"];
+const DEFAULT_CONFIG_FILE_NAME = ".dslinter.json";
+
+/**
+ * @param {string} projectRoot
+ * @returns {string}
+ */
+export function findDslintConfigPath(projectRoot) {
+  for (const name of CONFIG_FILE_NAMES) {
+    const candidate = join(projectRoot, name);
+    if (existsSync(candidate)) return candidate;
+  }
+  return join(projectRoot, DEFAULT_CONFIG_FILE_NAME);
+}
+
+/**
+ * @param {string} projectRoot
+ * @param {string} componentName
+ * @returns {{ hidden_components: string[] }}
+ */
+export function hideComponentInDslintConfig(projectRoot, componentName) {
+  const name = String(componentName ?? "").trim();
+  if (!name) {
+    throw new Error("component name is required");
+  }
+  const configPath = findDslintConfigPath(projectRoot);
+  let config = {};
+  if (existsSync(configPath)) {
+    try {
+      config = JSON.parse(readFileSync(configPath, "utf8"));
+    } catch (e) {
+      throw new Error(`Invalid JSON in ${configPath}: ${e.message}`);
+    }
+  }
+  const hidden = Array.isArray(config.hidden_components)
+    ? [...config.hidden_components]
+    : [];
+  if (!hidden.includes(name)) hidden.push(name);
+  config.hidden_components = hidden;
+  writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`);
+  return { hidden_components: hidden };
+}

package/bin/lib/config-hide-component.test.mjs

@@ -0,0 +1,33 @@
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { hideComponentInDslintConfig } from "./config-hide-component.mjs";
+
+describe("hideComponentInDslintConfig", () => {
+  const dirs = [];
+
+  afterEach(() => {
+    for (const dir of dirs) rmSync(dir, { recursive: true, force: true });
+    dirs.length = 0;
+  });
+
+  it("appends hidden_components to a new config file", () => {
+    const root = mkdtempSync(join(tmpdir(), "dslint-hide-"));
+    dirs.push(root);
+    const result = hideComponentInDslintConfig(root, "Foo");
+    expect(result.hidden_components).toEqual(["Foo"]);
+    const written = JSON.parse(
+      readFileSync(join(root, ".dslinter.json"), "utf8"),
+    );
+    expect(written.hidden_components).toEqual(["Foo"]);
+  });
+
+  it("does not duplicate names", () => {
+    const root = mkdtempSync(join(tmpdir(), "dslint-hide-"));
+    dirs.push(root);
+    hideComponentInDslintConfig(root, "Foo");
+    const result = hideComponentInDslintConfig(root, "Foo");
+    expect(result.hidden_components).toEqual(["Foo"]);
+  });
+});

package/bin/lib/constants.mjs

@@ -0,0 +1,20 @@
+import { readEnv } from "./env.mjs";
+
+/** @typedef {import("node:process").ProcessEnv} ProcessEnv */
+
+/** Default scanner HTTP port when `DSLINTER_SERVE_PORT` is unset. */
+export const DEFAULT_SERVE_PORT = 7878;
+
+/**
+ * Resolve scanner HTTP port from `DSLINTER_SERVE_PORT` or {@link DEFAULT_SERVE_PORT}.
+ * @param {ProcessEnv} [env]
+ * @returns {number}
+ */
+export function resolveServePort(env = process.env) {
+  const fromEnv = readEnv("SERVE_PORT", env);
+  if (fromEnv) {
+    const n = Number.parseInt(fromEnv, 10);
+    if (Number.isFinite(n) && n > 0 && n <= 65535) return n;
+  }
+  return DEFAULT_SERVE_PORT;
+}

package/bin/lib/dev-banner.mjs

@@ -172,33 +172,23 @@ export function formatDevBanner(opts) {
   const maxBox = Math.min(Math.max(terminalCols, 64), 96);
 
   const scanAbs = resolve(opts.scanPath);
-  const reportAbs = resolve(opts.reportPath);
-  const apiBase = `http://127.0.0.1:${opts.apiPort}`;
-
-  const apiStatusPlain = opts.apiAvailable ? "listening" : "unavailable — port in use";
-  const bundledStatusPlain = opts.apiAvailable ? "ready" : "port busy";
+  const dashboardUrl = opts.dashboardUrl ?? opts.bundledUrl ?? null;
   const scanPlain = shortenPath(scanAbs, 80);
-  const reportPlain = shortenPath(reportAbs, 80);
+  const scannerWarnPlain = opts.apiAvailable
+    ? null
+    : `unavailable — port ${opts.apiPort} in use`;
 
   /** @type {number[]} */
   const plainWidths = [
     ...LOGO.map((l) => visibleLength(l)),
     14 + 2 + scanPlain.length,
-    14 + 2 + reportPlain.length,
   ];
-  if (opts.dashboardUrl) plainWidths.push(14 + 2 + opts.dashboardUrl.length);
-  if (opts.bundledUrl) {
-    plainWidths.push(14 + 2 + `${opts.bundledUrl}  (${bundledStatusPlain})`.length);
-  }
-  plainWidths.push(14 + 2 + `${apiBase}  (${apiStatusPlain})`.length);
-  if (opts.apiAvailable) {
-    plainWidths.push(14 + 2 + `${apiBase}/dslint-report.json`.length);
-    plainWidths.push(14 + 2 + `${apiBase}/events`.length);
-  }
+  if (dashboardUrl) plainWidths.push(14 + 2 + dashboardUrl.length);
+  if (scannerWarnPlain) plainWidths.push(14 + 2 + scannerWarnPlain.length);
   if (opts.pollMs) plainWidths.push(14 + 2 + `polling every ${opts.pollMs} ms`.length);
-  const footerPlain = opts.bundledUrl
-    ? "  Open the Bundled UI URL in your browser. Ctrl+C to stop."
-    : "  Open the Dashboard URL in your browser. Ctrl+C to stop.";
+  const footerPlain = dashboardUrl
+    ? "  Open the Dashboard in your browser. Ctrl+C to stop."
+    : "  Ctrl+C to stop.";
   plainWidths.push(visibleLength(footerPlain));
 
   const contentWidth = Math.min(maxBox - 4, Math.max(...plainWidths, 40));
@@ -212,45 +202,20 @@ export function formatDevBanner(opts) {
   styledRows.push(
     ...row(color.label("Scan path"), scanPlain, contentWidth, color.value),
   );
-  styledRows.push(
-    ...row(color.label("Report file"), reportPlain, contentWidth, color.value),
-  );
-  styledRows.push("");
-  if (opts.dashboardUrl && !opts.bundledUrl) {
-    styledRows.push(
-      ...row(color.label("Dashboard"), opts.dashboardUrl, contentWidth, color.url),
-    );
-  }
-  if (opts.bundledUrl) {
-    const status = opts.apiAvailable ? color.ok(bundledStatusPlain) : color.warn(bundledStatusPlain);
+  if (opts.pollMs) {
     styledRows.push(
-      ...row(
-        color.label("Bundled UI"),
-        `${opts.bundledUrl}  (${bundledStatusPlain})`,
-        contentWidth,
-        () => `${color.url(opts.bundledUrl)}  ${color.dim("(")}${status}${color.dim(")")}`,
-      ),
+      ...row(color.label("Watch"), `polling every ${opts.pollMs} ms`, contentWidth, color.dim),
     );
   }
-  const apiStatus = opts.apiAvailable ? color.ok(apiStatusPlain) : color.err(apiStatusPlain);
-  styledRows.push(
-    ...row(
-      color.label("Scanner API"),
-      `${apiBase}  (${apiStatusPlain})`,
-      contentWidth,
-      () => `${color.url(apiBase)}  ${color.dim("(")}${apiStatus}${color.dim(")")}`,
-    ),
-  );
-  if (opts.apiAvailable) {
+  styledRows.push("");
+  if (dashboardUrl) {
     styledRows.push(
-      ...row("", `${apiBase}/dslint-report.json`, contentWidth, color.dim),
+      ...row(color.label("Dashboard"), dashboardUrl, contentWidth, color.url),
     );
-    styledRows.push(...row("", `${apiBase}/events`, contentWidth, color.dim));
   }
-  if (opts.pollMs) {
-    styledRows.push("");
+  if (scannerWarnPlain) {
     styledRows.push(
-      ...row(color.label("Watch"), `polling every ${opts.pollMs} ms`, contentWidth, color.dim),
+      ...row(color.label("Scanner"), scannerWarnPlain, contentWidth, color.err),
     );
   }
   styledRows.push("");

package/bin/lib/dev-banner.test.mjs

@@ -22,59 +22,61 @@ describe("shortenPath", () => {
 });
 
 describe("formatDevBanner", () => {
-  it("includes logo, scan path, report, bundled UI, and API URLs", () => {
+  it("includes logo, scan path, dashboard URL, and watch info", () => {
     const text = formatDevBanner({
       scanPath: "/tmp/components",
-      reportPath: "/tmp/components/public/dslint-report.json",
+      reportPath: "/tmp/components/public/dslinter-report.json",
       apiPort: 7878,
       apiAvailable: true,
       dashboardUrl: "http://localhost:5173/",
-      bundledUrl: "http://127.0.0.1:7878/",
       pollMs: 150,
     });
     expect(text).toContain(LOGO[0]);
     expect(text).toContain(LOGO[1]);
     expect(text).toContain("Scan path");
-    expect(text).toContain("Report file");
-    expect(text).toContain("Bundled UI");
-    expect(text).not.toContain("http://localhost:5173/");
-    expect(text).not.toMatch(/\bDashboard\b/);
-    expect(text).toContain("7878");
-    expect(text).toContain("dslint-report.json");
+    expect(text).not.toContain("Report file");
+    expect(text).toContain("Dashboard");
+    expect(text).toContain("http://localhost:5173/");
+    expect(text).not.toContain("Scanner API");
+    expect(text).not.toContain("dslinter-report.json");
+    expect(text).not.toContain("/events");
     expect(text).toContain("polling every 150 ms");
-    expect(text).toContain("Open the Bundled UI URL");
+    expect(text).toContain("Open the Dashboard in your browser");
   });
 
-  it("shows dashboard URL when bundled UI is not served", () => {
+  it("shows bundled URL as the dashboard when no separate dev server", () => {
     const text = formatDevBanner({
       scanPath: "/tmp/components",
-      reportPath: "/tmp/components/public/dslint-report.json",
+      reportPath: "/tmp/components/public/dslinter-report.json",
       apiPort: 7878,
       apiAvailable: true,
-      dashboardUrl: "http://localhost:5173/",
+      bundledUrl: "http://127.0.0.1:7878/",
       pollMs: 150,
     });
     expect(text).toContain("Dashboard");
-    expect(text).toContain("http://localhost:5173/");
-    expect(text).toContain("Open the Dashboard URL");
+    expect(text).toContain("http://127.0.0.1:7878/");
+    expect(text).not.toContain("Bundled UI");
+    expect(text).not.toContain("Scanner API");
   });
 
-  it("marks API unavailable when port is busy", () => {
+  it("marks scanner unavailable when port is busy", () => {
     const text = formatDevBanner({
       scanPath: ".",
-      reportPath: "./public/dslint-report.json",
+      reportPath: "./public/dslinter-report.json",
       apiPort: 7878,
       apiAvailable: false,
       dashboardUrl: "http://localhost:5174/",
     });
+    expect(text).toContain("Scanner");
     expect(text).toContain("unavailable");
+    expect(text).not.toContain("7878/");
     expect(text).not.toContain("/events");
   });
 
   it("keeps right border aligned on every row", () => {
     const text = formatDevBanner({
       scanPath: "/very/long/path/that/could/push/the/box/wider/than/usual/Components",
-      reportPath: "/very/long/path/public/dslint-report.json",
+      reportPath: "/very/long/path/public/dslinter-report.json",
       apiPort: 7878,
       apiAvailable: false,
       dashboardUrl: "http://localhost:5175/",