@bugmole/cli 0.4.0

package/src/runtime/explorer.test.ts

@@ -0,0 +1,101 @@
+import assert from "node:assert/strict";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+import { explore } from "./explorer.js";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(here, "..", "..");
+const qaAppRoot = path.resolve(repoRoot, "apps/qa");
+
+test("only real Next.js App Router pages/route handlers become discovered screens, not every component under app/", async () => {
+  const specDir = await fs.mkdtemp(path.join(os.tmpdir(), "bugmole-explorer-spec-"));
+  const artifactsDir = await fs.mkdtemp(path.join(os.tmpdir(), "bugmole-explorer-artifacts-"));
+
+  const result = await explore(
+    {
+      runtime: { spec_dir: specDir, artifacts_dir: artifactsDir },
+      cursor_driver: { project_directory: qaAppRoot },
+      project: { id: "explorer-route-inference-test" },
+    },
+    {
+      // An unreachable baseUrl is fine: route probes fail fast and don't
+      // affect which nodes get discovered — this test is only about
+      // source-tree route inference, not runtime reachability.
+      baseUrl: "http://127.0.0.1:1",
+      captureScreenshots: false,
+      maxDepth: 8,
+    },
+  );
+
+  assert.equal(result.status, "success");
+
+  const graph = JSON.parse(await fs.readFile(path.join(specDir, "journeys.graph.json"), "utf-8"));
+  const nodeIds: string[] = graph.nodes.map((node: { id: string }) => node.id);
+
+  // Real routes for apps/qa's App Router — must be discovered.
+  assert.ok(nodeIds.includes("screen:/devices"), "the real /devices page.tsx route should be discovered");
+  assert.ok(nodeIds.includes("screen:/"), "the root page.tsx route should be discovered");
+
+  // Plain components that merely live under app/ are not routes and must
+  // NOT be invented as fake screens — this is the exact regression
+  // reproduced during a real dogfooding exploration run.
+  const fakeComponentRoutes = [
+    "screen:/devices/devices-panel",
+    "screen:/device-live-view-overlay",
+    "screen:/dashboard-client",
+    "screen:/dashboard-route",
+    "screen:/dashboard-routes",
+    "screen:/dashboard-shell",
+  ];
+  for (const fakeId of fakeComponentRoutes) {
+    assert.ok(!nodeIds.includes(fakeId), `${fakeId} is a component file, not a route, and must not be discovered`);
+  }
+
+  // layout.tsx is a real Next.js App Router convention file, but it wraps
+  // routes rather than being independently navigable — it must not be
+  // discovered as its own screen either.
+  assert.ok(!nodeIds.includes("screen:/layout"), "layout.tsx must not be treated as its own route");
+});
+
+test("manage hub links resolve against optional catch-all resource routes", async () => {
+  const specDir = await fs.mkdtemp(path.join(os.tmpdir(), "bugmole-explorer-spec-"));
+  const artifactsDir = await fs.mkdtemp(path.join(os.tmpdir(), "bugmole-explorer-artifacts-"));
+
+  const result = await explore(
+    {
+      runtime: { spec_dir: specDir, artifacts_dir: artifactsDir },
+      cursor_driver: { project_directory: qaAppRoot },
+      project: { id: "explorer-manage-links-test" },
+    },
+    {
+      baseUrl: "http://localhost:3020",
+      captureScreenshots: false,
+      maxDepth: 8,
+    },
+  );
+
+  assert.equal(result.status, "success");
+
+  const graph = JSON.parse(await fs.readFile(path.join(specDir, "journeys.graph.json"), "utf-8"));
+  const unresolvedLinks: Array<{ source: string; target: string }> = graph.metadata?.analysis?.unresolvedLinks ?? [];
+  const manageLinks = unresolvedLinks.filter((link) => link.source === "/manage");
+
+  assert.deepEqual(
+    manageLinks,
+    [],
+    "resource-management hub cards should resolve to /manage/:resource/:[...action]",
+  );
+
+  const manageEdges = (graph.edges as Array<{ from: string; to: string; action?: string }>)
+    .filter((edge) => edge.from === "screen:/manage");
+  const targets = new Set(
+    manageEdges.map((edge) => edge.action?.replace(/^navigate:/, "") ?? ""),
+  );
+
+  for (const route of ["/manage/workspaces", "/manage/projects", "/manage/apps", "/manage/environments"]) {
+    assert.ok(targets.has(route), `expected /manage to link to ${route}`);
+  }
+});