Correct the stale and false comments and docs the comprehension seats flagged

src/plugin-host/router.ts

@@ -1,7 +1,8 @@
 // Router: pure core mapping method + pathname → a discovered plugin route. I/O-free;
 // app.ts is the shell (build context, gate, call handler, render RouteResult). A route mounts at
 // `/<id>` + its path (fullPath, shared with conflict detection); `:name` segments → path params.
-// Specificity: a literal segment beats a `:param` (/users/new wins /users/:id), order-independent.
+// Specificity: the route with fewer `:param` segments wins (/users/new beats /users/:id). A tie, such
+// as /a/:x/b against /a/b/:y, falls to discovery order.
 
 import { fullPath, type Plugin, type Route } from "./plugin.ts";