@nifrajs/cli 4.0.0 → 4.0.2

package/dist/sync-manifest.js

@@ -19,10 +19,19 @@ const GENERATED_MARKER = "GENERATED by @nifrajs/web generateServerManifest";
 // routes dir relative to the manifest and strips imports to route-relative keys.
 const ROUTES_PREFIX = /["'](\.{1,2}(?:\/[^"'/]+)*?\/routes\/)[^"']+["']/;
 const IGNORED = /(^|\/)(node_modules|dist(-[a-z0-9]+)?|build|\.nifra|\.git|\.wrangler|coverage)\//;
+// The fs codes that mean the routes dir is absent or unreadable. Every other throw is the route table
+// refusing to build, which must fail the command rather than read as "no manifest found".
+const ROUTES_DIR_UNAVAILABLE = new Set(["ENOENT", "ENOTDIR", "EACCES", "EPERM"]);
+function routesDirUnavailable(error) {
+    if (typeof error !== "object" || error === null || !("code" in error))
+        return false;
+    return typeof error.code === "string" && ROUTES_DIR_UNAVAILABLE.has(error.code);
+}
 /**
  * Discover every generated `server-manifest.ts` under `cwd` and re-sync its route table from the live
  * `routes/` tree, preserving baked client assets. Returns one result per generated manifest. Never throws
- * on a per-manifest miss (an unreadable/absent routes dir is skipped).
+ * on a per-manifest failure: an absent or unreadable routes dir is skipped, and a route table that fails
+ * to build is reported in that manifest's `error`.
  */
 export async function syncServerManifests(cwd) {
     const { discoverRoutes } = await import("@nifrajs/web/fs");
@@ -45,8 +54,12 @@ export async function syncServerManifests(cwd) {
         try {
             next = resyncServerManifestSource(source, discoverRoutes(routesDir), routesPrefix);
         }
-        catch {
-            continue; // routes dir gone/unreadable - not a manifest we can sync
+        catch (error) {
+            if (routesDirUnavailable(error))
+                continue; // not a manifest we can sync
+            const message = error instanceof Error ? error.message : String(error);
+            results.push({ file: rel, changed: false, added: [], removed: [], error: message });
+            continue;
         }
         const before = parseManifestRouteFiles(source, routesPrefix);
         const after = parseManifestRouteFiles(next, routesPrefix);
@@ -66,34 +79,45 @@ export async function syncServerManifests(cwd) {
     }
     return results.sort((a, b) => codeUnitOrder(a.file, b.file));
 }
-/** CLI entry: sync every generated manifest, print a per-file summary + the client-rebuild caveat. */
-export async function runSyncManifest(cwd) {
-    const results = await syncServerManifests(cwd);
-    if (results.length === 0) {
-        console.log("nifra sync-manifest: no generated server-manifest.ts found under this directory.");
-        return true;
-    }
+/** True when no manifest's route table failed to build. */
+export function syncManifestsOk(results) {
+    return results.every((r) => r.error === undefined);
+}
+/** Per-file summary lines + the client-rebuild caveat. */
+export function renderSyncManifestResults(results) {
+    if (results.length === 0)
+        return ["nifra sync-manifest: no generated server-manifest.ts found under this directory."];
+    const lines = [];
     let anyChanged = false;
     for (const r of results) {
-        if (r.refusedEmpty) {
-            console.log(`⚠ ${r.file}: refused - routes/ has zero routes but the manifest had some; left untouched (delete the manifest yourself if this is intentional).`);
+        if (r.error !== undefined) {
+            lines.push(`✖ ${r.file}: routes/ does not build a route table; left untouched.`, `    ${r.error}`);
+        }
+        else if (r.refusedEmpty) {
+            lines.push(`⚠ ${r.file}: refused - routes/ has zero routes but the manifest had some; left untouched (delete the manifest yourself if this is intentional).`);
         }
         else if (r.changed) {
             anyChanged = true;
-            console.log(`✓ synced ${r.file}`);
+            lines.push(`✓ synced ${r.file}`);
             if (r.added.length > 0)
-                console.log(`    added:   ${r.added.join(", ")}`);
+                lines.push(`    added:   ${r.added.join(", ")}`);
             if (r.removed.length > 0)
-                console.log(`    removed: ${r.removed.join(", ")}`);
+                lines.push(`    removed: ${r.removed.join(", ")}`);
         }
         else {
-            console.log(`• ${r.file} already in sync`);
+            lines.push(`• ${r.file} already in sync`);
         }
     }
     if (anyChanged) {
-        console.log("\nRe-synced the server manifest's route table. If you added or changed a HYDRATING route\n" +
+        lines.push("\nRe-synced the server manifest's route table. If you added or changed a HYDRATING route\n" +
             "component (not just a loader / SSR-only route), also run a full build so the client bundle matches.");
     }
-    return true;
+    return lines;
+}
+/** CLI entry: sync every generated manifest and print the summary. False when a route table failed to build. */
+export async function runSyncManifest(cwd) {
+    const results = await syncServerManifests(cwd);
+    console.log(renderSyncManifestResults(results).join("\n"));
+    return syncManifestsOk(results);
 }
 //# sourceMappingURL=sync-manifest.js.map

package/dist/sync-manifest.js.map

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

package/docs/types.json

@@ -15027,14 +15027,14 @@
     "name": "VERSION",
     "kind": "const",
     "package": "@nifrajs/core",
-    "signature": "export declare const VERSION: \"4.0.0\";",
+    "signature": "export declare const VERSION: \"4.0.2\";",
     "doc": "/**\n * Current package version. A hardcoded literal on purpose - core runs on the edge (no fs), so it can't\n * read its own package.json at runtime. `scripts/version.ts` rewrites it on every release bump and\n * `check:publish` asserts it equals `@nifrajs/core`'s package version.\n */"
   },
   {
     "name": "VERSION",
     "kind": "const",
     "package": "nifra",
-    "signature": "export declare const VERSION: \"4.0.0\";",
+    "signature": "export declare const VERSION: \"4.0.2\";",
     "doc": "/**\n * Current package version. A hardcoded literal on purpose - core runs on the edge (no fs), so it can't\n * read its own package.json at runtime. `scripts/version.ts` rewrites it on every release bump and\n * `check:publish` asserts it equals `@nifrajs/core`'s package version.\n */"
   },
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nifrajs/cli",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "description": "The nifra CLI - zero-config dev/build/start for a nifra app (`nifra dev`, `nifra build`, `nifra start`).",
   "keywords": [
     "bun",
@@ -69,17 +69,17 @@
     "access": "public"
   },
   "dependencies": {
-    "@nifrajs/client": "4.0.0",
-    "@nifrajs/core": "4.0.0",
-    "@nifrajs/agent-review": "4.0.0",
-    "@nifrajs/i18n": "4.0.0",
-    "@nifrajs/mcp": "4.0.0",
-    "@nifrajs/mcp-db": "4.0.0",
-    "@nifrajs/runner": "4.0.0",
-    "@nifrajs/schema": "4.0.0",
-    "@nifrajs/testing": "4.0.0",
-    "@nifrajs/web": "4.0.0",
-    "create-nifra": "4.0.0"
+    "@nifrajs/client": "4.0.2",
+    "@nifrajs/core": "4.0.2",
+    "@nifrajs/agent-review": "4.0.2",
+    "@nifrajs/i18n": "4.0.2",
+    "@nifrajs/mcp": "4.0.2",
+    "@nifrajs/mcp-db": "4.0.2",
+    "@nifrajs/runner": "4.0.2",
+    "@nifrajs/schema": "4.0.2",
+    "@nifrajs/testing": "4.0.2",
+    "@nifrajs/web": "4.0.2",
+    "create-nifra": "4.0.2"
   },
   "repository": {
     "type": "git",

package/src/cli.ts

@@ -304,7 +304,7 @@ set in the process environment is never overwritten by a file.
 ${renderCommandCatalogHelp()}`
 
 // Kept in lockstep with packages/cli/package.json by check:publish's version-consistency gate.
-const CLI_VERSION = "4.0.0"
+const CLI_VERSION = "4.0.2"
 
 // A render adapter + nifra server are opaque to the CLI (it just forwards them); cast at the seam.
 const asAdapter = (v: unknown): RenderAdapter => v as RenderAdapter

package/src/command-catalog.ts

@@ -31,6 +31,12 @@ import { reviewSpec } from "./review.ts"
 import type { RouteTypesReport } from "./route-types.ts"
 import type { SmokeReport } from "./smoke.ts"
 import type { StylexMigrationResult } from "./stylex-migrate.ts"
+import {
+  renderSyncManifestResults,
+  type SyncManifestResult,
+  syncManifestsOk,
+  syncServerManifests,
+} from "./sync-manifest.ts"
 import {
   collectProjectWorkGraph,
   type ProjectWorkGraphResult,
@@ -498,6 +504,10 @@ interface SyncCommandOutput {
   readonly ok: true
   readonly results: readonly unknown[]
 }
+interface SyncManifestCommandOutput {
+  readonly ok: boolean
+  readonly results: readonly SyncManifestResult[]
+}
 
 interface SmokeCommandOutput extends SmokeReport {}
 
@@ -1674,7 +1684,7 @@ const contractsSpec: CommandSpec<ContractsInput, ContractsCommandOutput> = {
   success: (out) => out.ok,
 }
 
-const syncManifestSpec: CommandSpec<SyncInput, SyncCommandOutput> = {
+const syncManifestSpec: CommandSpec<SyncInput, SyncManifestCommandOutput> = {
   name: "sync-manifest",
   summary: "Regenerate generated server-manifest route tables without a full build.",
   input: SYNC_SCHEMA,
@@ -1687,16 +1697,11 @@ const syncManifestSpec: CommandSpec<SyncInput, SyncCommandOutput> = {
   stability: "stable",
   argv: { flags: [{ name: "json", field: "json", type: "boolean" }] },
   async run(_value, ctx) {
-    return {
-      ok: true,
-      results: await (await import("./sync-manifest.ts")).syncServerManifests(ctx.cwd),
-    }
+    const results = await syncServerManifests(ctx.cwd)
+    return { ok: syncManifestsOk(results), results }
   },
-  render: (out) => [
-    out.results.length === 0
-      ? "nifra sync-manifest: no generated server-manifest.ts found under this directory."
-      : `✓ checked ${out.results.length} generated server manifest${out.results.length === 1 ? "" : "s"}`,
-  ],
+  render: (out) => renderSyncManifestResults(out.results),
+  success: (out) => out.ok,
 }
 
 const syncRoutesSpec: CommandSpec<SyncInput, SyncCommandOutput> = {

package/src/fix-recipes.ts

@@ -62,7 +62,15 @@ registerFixRecipe({
   async apply(root) {
     const { syncServerManifests } = await import("./sync-manifest.ts")
     const results = await syncServerManifests(root)
-    return results.filter((result) => result.changed).map((result) => result.file)
+    const changed = results.filter((result) => result.changed).map((result) => result.file)
+    const failed = results.filter((result) => result.error !== undefined)
+    if (failed.length > 0) {
+      const synced = changed.length === 0 ? "" : `synced ${changed.join(", ")}; `
+      throw new Error(
+        `[nifra] ${synced}cannot sync ${failed.map((result) => `${result.file}: ${result.error}`).join("; ")}`,
+      )
+    }
+    return changed
   },
 })
 

package/src/mcp-http.ts

@@ -29,7 +29,7 @@ export { docsTools } from "./mcp-docs-tools.ts"
 export type { TypeEntry } from "./types-search.ts"
 
 // Kept in lockstep with packages/cli/package.json by check:publish's version-consistency gate.
-const VERSION = "4.0.0"
+const VERSION = "4.0.2"
 const SERVER_INFO = { name: "nifra-docs", version: VERSION }
 // Derive the GET/health tool list from the tools actually served, so the line can never drift from them.
 const docsHealth = (tools: McpTool[]): string =>

package/src/migrate-layout.ts

@@ -24,6 +24,7 @@ import {
   readFileSync,
   renameSync,
   rmSync,
+  statSync,
   writeFileSync,
 } from "node:fs"
 import { dirname, extname, join, posix, relative, resolve } from "node:path"
@@ -55,6 +56,10 @@ const LEGACY_SERVER = /\.server(\.(?:[cm]?[jt]sx?|svelte|vue|mdx))$/
 const RETIRED_SPECIFIERS: Readonly<Record<string, string>> = {
   "@nifrajs/web/server-only": "@nifrajs/web/backend-only",
 }
+/** Scripts and config that name app files by path: scanned for paths that moved, never rewritten. */
+const TOOLING_FILE =
+  /(?:\.(?:json|jsonc|ya?ml|toml|sh|bash|zsh|ps1)|(?:^|\/)(?:Dockerfile|Makefile|Procfile))$/
+const SELF_LOCATION = /\bimport\.meta\.(?:dirname|dir|filename|url)\b|\b__(?:dirname|filename)\b/
 const SKIP_DIRS = new Set(["node_modules", "dist", "build", "coverage", ".git", ".vite", "public"])
 const ZONE_DIRS = new Set(["frontend", "backend", "shared", "routes", "public"])
 
@@ -666,6 +671,144 @@ function resolveIn(
   return candidates.find((candidate) => files.has(candidate))
 }
 
+/** Where `text` spells, inside quotes, an import specifier that resolves among `files`: [start, end). */
+function liveSpecifierSpans(
+  ts: typeof TS,
+  file: string,
+  text: string,
+  files: ReadonlySet<string>,
+): Array<readonly [number, number]> {
+  const spans: Array<readonly [number, number]> = []
+  for (const { specifier } of importsOf(ts, file, text)) {
+    if (resolveIn(files, file, specifier) === undefined) continue
+    for (const quote of ['"', "'", "`"]) {
+      const quoted = `${quote}${specifier}${quote}`
+      for (let at = text.indexOf(quoted); at !== -1; at = text.indexOf(quoted, at + 1))
+        spans.push([at + 1, at + 1 + specifier.length])
+    }
+  }
+  return spans
+}
+
+const OWN_DIR = new Set(["import.meta.dir", "import.meta.dirname", "__dirname"])
+
+/**
+ * Re-point the paths a module moving from `from` to `to` builds from its own location, so each still
+ * reaches what it did: `join(import.meta.dir, "..", "x")` (or `resolve`), `import.meta.dir + "/../x"`,
+ * `` `${__dirname}/../x` `` and `new URL("../x", import.meta.url)`, each with literal segments. `locate`
+ * maps an app-relative target to where it ends up. Returns the new text and the first use of the
+ * module's location it could not follow.
+ */
+function rebaseOwnPaths(
+  ts: typeof TS,
+  from: string,
+  to: string,
+  text: string,
+  locate: (target: string) => string,
+): { readonly text: string; readonly unfollowed: string | undefined } {
+  const sf = ts.createSourceFile(
+    to,
+    text,
+    ts.ScriptTarget.Latest,
+    true,
+    to.endsWith("x") ? ts.ScriptKind.TSX : ts.ScriptKind.TS,
+  )
+  const edits: Array<{ start: number; end: number; text: string }> = []
+  const followed: Array<readonly [number, number]> = []
+  const isOwnDir = (node: TS.Node | undefined): node is TS.Expression =>
+    node !== undefined && OWN_DIR.has(node.getText(sf))
+  const isLiteral = (
+    node: TS.Node | undefined,
+  ): node is TS.StringLiteral | TS.NoSubstitutionTemplateLiteral =>
+    node !== undefined && (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node))
+  const quoted = (node: TS.Node, value: string): string => {
+    const quote = node.getText(sf)[0] ?? '"'
+    return `${quote}${value}${quote}`
+  }
+  // The path `relative` names from the module's old folder, named from its new folder.
+  const rebased = (relative: string): string => {
+    const target = locate(posix.normalize(posix.join(posix.dirname(from), relative)))
+    const next = posix.relative(posix.dirname(to), target) || "."
+    return relative.endsWith("/") && next !== "." ? `${next}/` : next
+  }
+  const follow = (anchor: TS.Node, start: number, end: number, replacement: string): void => {
+    followed.push([anchor.getStart(sf), anchor.getEnd()])
+    if (text.slice(start, end) !== replacement) edits.push({ start, end, text: replacement })
+  }
+
+  const visit = (node: TS.Node): void => {
+    if (ts.isCallExpression(node)) {
+      const [dir, ...parts] = node.arguments
+      const callee = node.expression.getText(sf)
+      const first = parts[0]
+      const last = parts[parts.length - 1]
+      if (
+        isOwnDir(dir) &&
+        /(?:^|\.)(?:join|resolve)$/.test(callee) &&
+        first !== undefined &&
+        last !== undefined &&
+        parts.every(isLiteral) &&
+        !(callee.endsWith("resolve") && parts.some((part) => part.text.startsWith("/")))
+      ) {
+        const next = rebased(posix.join(...parts.map((part) => part.text)))
+        const segments = parts.length === 1 ? [next] : next.split("/").filter((s) => s !== "")
+        const replacement = segments.map((segment) => quoted(first, segment)).join(", ")
+        follow(dir, first.getStart(sf), last.getEnd(), replacement)
+        return
+      }
+    }
+    if (
+      ts.isBinaryExpression(node) &&
+      node.operatorToken.kind === ts.SyntaxKind.PlusToken &&
+      isOwnDir(node.left) &&
+      isLiteral(node.right) &&
+      node.right.text.startsWith("/")
+    ) {
+      const next = rebased(node.right.text.slice(1) || ".")
+      follow(
+        node.left,
+        node.right.getStart(sf),
+        node.right.getEnd(),
+        quoted(node.right, `/${next}`),
+      )
+      return
+    }
+    if (ts.isTemplateExpression(node) && node.head.text === "" && node.templateSpans.length === 1) {
+      const span = node.templateSpans[0]
+      if (span !== undefined && isOwnDir(span.expression) && span.literal.text.startsWith("/")) {
+        const next = rebased(span.literal.text.slice(1) || ".")
+        const replacement = `\`\${${span.expression.getText(sf)}}/${next}\``
+        follow(span.expression, node.getStart(sf), node.getEnd(), replacement)
+        return
+      }
+    }
+    if (
+      ts.isNewExpression(node) &&
+      node.expression.getText(sf) === "URL" &&
+      node.arguments?.length === 2 &&
+      node.arguments[1]?.getText(sf) === "import.meta.url"
+    ) {
+      const path = node.arguments[0]
+      if (isLiteral(path) && !/^(?:\/|[a-z][a-z\d+.-]*:)/i.test(path.text)) {
+        const next = rebased(path.text)
+        const replacement = quoted(path, next.startsWith("..") ? next : `./${next}`)
+        follow(node.arguments[1], path.getStart(sf), path.getEnd(), replacement)
+        return
+      }
+    }
+    ts.forEachChild(node, visit)
+  }
+  visit(sf)
+
+  const unfollowed = [...text.matchAll(new RegExp(SELF_LOCATION.source, "g"))].find(
+    (match) => !followed.some(([start, end]) => start <= match.index && match.index < end),
+  )?.[0]
+  let next = text
+  for (const edit of edits.sort((a, b) => b.start - a.start))
+    next = next.slice(0, edit.start) + edit.text + next.slice(edit.end)
+  return { text: next, unfollowed }
+}
+
 /** Rewrite one relative specifier from `from`'s new location to `target`'s new location, keeping the
  * author's style: extension kept when written, dropped when not, `/index` collapsed when it was. */
 function respecify(
@@ -947,21 +1090,25 @@ export async function migrateLayout(
     }
     edges.set(file, refs)
   }
-  const reach = (roots: readonly string[]): Set<string> => {
+  const files = [...new Set([...next.keys(), ...everyFile.filter((f) => !original.has(f))])]
+  const frontendRoots = files.filter(
+    (f) => f.startsWith("routes/") && ROUTE_FILE.test(f) && !f.includes(".backend."),
+  )
+  // A route page the server imports - a generated `server-manifest.ts` imports them all - is rendered
+  // there, not run as server code, so the server's walk stops at it: what only pages use stays frontend.
+  const pages = new Set(frontendRoots)
+  const reach = (roots: readonly string[], stopAt?: ReadonlySet<string>): Set<string> => {
     const seen = new Set<string>()
     const queue = [...roots]
     while (queue.length > 0) {
       const file = queue.pop() as string
       if (seen.has(file)) continue
       seen.add(file)
+      if (stopAt?.has(file)) continue
       for (const edge of edges.get(file) ?? []) if (!edge.typeOnly) queue.push(edge.target)
     }
     return seen
   }
-  const files = [...new Set([...next.keys(), ...everyFile.filter((f) => !original.has(f))])]
-  const frontendRoots = files.filter(
-    (f) => f.startsWith("routes/") && ROUTE_FILE.test(f) && !f.includes(".backend."),
-  )
   const backendRoots = files.filter(
     (f) =>
       (f.startsWith("routes/") && f.includes(".backend.")) ||
@@ -970,11 +1117,12 @@ export async function migrateLayout(
       (isRootScript(f) && f !== "nifra.config.ts" && !isTestFile(f)),
   )
   const browser = reach(frontendRoots)
-  const server = reach(backendRoots)
+  const server = reach(backendRoots, pages)
   // What the app's own server modules reach, without the root scripts: a root file in here is a module
   // the app imports, not an entry, so it moves into a zone.
   const appServer = reach(
     backendRoots.filter((f) => f.includes("/") || ROOT_MOVES[f] !== undefined),
+    pages,
   )
   // A `.server` module ran empty in the browser, so only server code used it: it moves under backend/.
   for (const file of files) {
@@ -1048,19 +1196,91 @@ export async function migrateLayout(
     if (updated !== text && !moveMap.has(file) && original.get(file) === text) rewritten.push(file)
   }
 
+  const moves = [...moveMap]
+    .map(([from, to]) => ({ from, to }))
+    .sort((a, b) => codeUnitOrder(a.from, b.from))
+
+  // A moved module's paths from its own location now start from its new folder: re-point the ones it
+  // spells out, and report the first one it cannot follow.
+  const unfollowed = new Map<string, string>()
+  for (const { from, to } of moves) {
+    const text = final.get(to)
+    if (text === undefined || !SELF_LOCATION.test(text)) continue
+    if (!/\.[cm]?[jt]sx?$/.test(to)) {
+      unfollowed.set(to, SELF_LOCATION.exec(text)?.[0] ?? "")
+      continue
+    }
+    const result = rebaseOwnPaths(ts, from, to, text, (target) =>
+      known.has(target) ? newPath(target) : target,
+    )
+    final.set(to, result.text)
+    if (result.unfollowed !== undefined) unfollowed.set(to, result.unfollowed)
+  }
+
   // A path in a string or comment is not an import, so nothing above rewrote it: a build script that
-  // writes `data/x.json` would keep writing to the old place.
-  for (const [file, text] of final) {
+  // writes `data/x.json` would keep writing to the old place, and so would a deploy script or
+  // `package.json` beside the code.
+  const settled = new Set([...known].map(newPath))
+  const scanned: Array<readonly [string, string]> = [...final]
+  for (const file of everyFile) {
+    if (
+      !original.has(file) &&
+      TOOLING_FILE.test(file) &&
+      statSync(join(root, file)).size <= 256_000
+    )
+      scanned.push([newPath(file), readFileSync(join(root, file), "utf8")])
+  }
+  for (const [file, text] of scanned) {
+    let live: ReadonlyArray<readonly [number, number]> | undefined
     for (const [from, to] of moveMap) {
       // `shared/lib/x.ts` contains `lib/x.ts`; that is the new path, not a stale one.
       const newPrefix = to.endsWith(from) ? to.slice(0, to.length - from.length) : undefined
       const stale = [
         ...text.matchAll(new RegExp(`(?<![\\w.-])${escapeRegExp(from)}(?![\\w])`, "g")),
-      ].some((match) => newPrefix === undefined || !text.slice(0, match.index).endsWith(newPrefix))
+      ].some((match) => {
+        if (newPrefix !== undefined && text.slice(0, match.index).endsWith(newPrefix)) return false
+        // An import that resolves after the moves is current, even when it still reads like the old
+        // path: `./x.json` from a module that moved together with `x.json`.
+        live ??= liveSpecifierSpans(ts, file, text, settled)
+        const end = match.index + from.length
+        return !live.some(([start, stop]) => start <= match.index && end <= stop)
+      })
       if (stale) issues.push({ file, reason: `mentions "${from}" by path; it moved to "${to}"` })
     }
   }
 
+  // Paths a module finds at run time are not imports either: one built from the module's own location
+  // now starts from its new folder, and a folder listed at run time loses whatever moved out of it.
+  const leaving = new Map<string, Array<{ from: string; to: string }>>()
+  for (const move of moves) {
+    const own = unfollowed.get(move.to)
+    if (own !== undefined) {
+      issues.push({
+        file: move.to,
+        reason: `builds a path from its own location (${own}) that the migration could not re-point, and it moved from "${move.from}"; check that path by hand`,
+      })
+    }
+    const dir = posix.dirname(move.from)
+    if (dir === "." || ZONE_DIRS.has(dir.split("/")[0] ?? "")) continue
+    leaving.set(dir, [...(leaving.get(dir) ?? []), move])
+  }
+  for (const [dir, group] of leaving) {
+    const staying = files.filter(
+      (f) => posix.dirname(f) === dir && !moveMap.has(f) && !isTestFile(f) && !f.endsWith(".d.ts"),
+    )
+    const first = group[0]
+    if (staying.length === 0 || first === undefined) continue
+    const others = group.length === 1 ? "" : ` with ${group.length - 1} other file(s)`
+    const left =
+      staying.length === 1
+        ? `"${staying[0]}" stays`
+        : `${staying.length} files such as "${staying[0]}" stay`
+    issues.push({
+      file: first.from,
+      reason: `moves to "${first.to}"${others} but ${left} in ${dir}/; code or tooling that lists ${dir}/ no longer finds what moved - move the folder together by hand`,
+    })
+  }
+
   // The server refuses data a loader or action returns without an output schema; only the author
   // knows which fields the browser may see.
   for (const [file, text] of final) {
@@ -1073,9 +1293,6 @@ export async function migrateLayout(
     }
   }
 
-  const moves = [...moveMap]
-    .map(([from, to]) => ({ from, to }))
-    .sort((a, b) => codeUnitOrder(a.from, b.from))
   if (options.write === true) {
     for (const [file, text] of final) {
       if (original.get(file) === text) continue

package/src/recipes/4.0.0.ts

@@ -22,6 +22,8 @@ export const recipe: UpgradeRecipe = {
     "The Cloudflare Pages target is `cloudflare` (`cf-pages` is refused), and `export const target` in `nifra.config.ts` sets what `nifra build` emits.",
     '`withISR` no longer caches a page per query string by default: a request with any query parameter renders fresh and is not stored. Pass `query: ["page", ...]` to cache those parameters, or `query: "all"` to both `withISR` and `revalidateEndpoint` to keep the old keys.',
     "A page file under the backend's API prefix or any other mount (`routes/api/*.tsx` with a backend) now fails at startup, at build and in `nifra check` (NF-C027), instead of answering 404. Move the page, change `apiPrefix` in `backend/framework.ts`, or serve that path from the backend.",
+    'Two page routes of one shape that share a path, such as `users/[id].tsx` beside `users/[slug].tsx`, fail dev, build and `nifra check` with "overlapping routes", because one could never be served. A static page beside a dynamic one (`users/me.tsx` beside `users/[id].tsx`) is fine: the more specific route serves the path they share. In a backend file, `nifra check` reports two same-method registrations that accept a shared path (NF-C024); make them disjoint (`/users/:id{[0-9]+}`) or mark the intended pair with a `// nifra-expect route-overlap` comment.',
+    "`nifra contracts check` (NF-K001) reports a changed contract for a route whose schema has a property named `description`, `title`, `default`, `example` or `examples`: earlier lock digests skipped such properties, so a change to one went unnoticed. Run `nifra contracts snapshot` once after upgrading and commit the lock.",
     "Request methods match exactly: a request sent as `post` or `Patch` answers 405 or 404 instead of reaching the `POST`/`PATCH` route.",
     "A request path's `.` and `..` segments (also `%2e` and backslashes) are resolved before routing on every runtime, so `/users/../posts` routes to `/posts` and `c.req.url` shows the resolved path.",
     "A JSON body is parsed only when its media type is `application/json` or `application/*+json`; `text/plain; x=application/json` no longer parses, and server functions answer it with 415.",