Organize document URLs by category and collection with compact navigation

apps/docs/scripts/auth-cli.ts

@@ -182,15 +182,32 @@ async function main() {
   const searchResponse = await request("/api/search", { headers });
   assert.equal(searchResponse.status, 200);
   const searchIndex = await searchResponse.json();
-  assert.ok(searchIndex.some((doc: { slug: string; searchText: string }) => doc.slug === "pretext/04-chapter" && doc.searchText.includes("getSegmentMetrics")));
+  assert.ok(searchIndex.some((doc: { slug: string; searchText: string }) => doc.slug === "source-studies/pretext/measurement-cache" && doc.searchText.includes("getSegmentMetrics")));
+  for (const doc of searchIndex as { slug: string; sourceSlug: string }[]) {
+    assert.ok(!doc.slug.split("/").some((part) => /^\d+-/.test(part)), doc.slug);
+    const legacy = await request(`/docs/${doc.sourceSlug}`, { headers });
+    assert.equal(legacy.status, 308, doc.sourceSlug);
+    assert.equal(new URL(legacy.headers.get("location")!, base).pathname, `/docs/${doc.slug}`);
+  }
   let home = "";
   for (const route of routes) {
     const response = await request(route, { headers });
-    assert.equal(response.status, 200, route);
-    if (route === "/") home = await response.text();
+    const alias = (searchIndex as { sourceSlug: string }[]).some((doc) => route === `/docs/${doc.sourceSlug}`);
+    assert.equal(response.status, alias ? 308 : 200, route);
+    if (alias) continue;
+    const html = await response.text();
+    if (route === "/") home = html;
+    if (route.startsWith("/docs/")) {
+      assert.ok(html.includes('aria-label="文档选择"'), route);
+      assert.ok(html.includes('<optgroup label="语言与运行时">'), route);
+      assert.ok(!html.includes('class="nav-back"'), route);
+      const ids = [...html.matchAll(/<h[23] id="([^"]+)"/g)].map((match) => match[1]);
+      assert.equal(new Set(ids).size, ids.length, `Unique heading anchors: ${route}`);
+      for (const id of ids) assert.ok(html.includes(`href="#${id}"`), `TOC anchor: ${route}#${id}`);
+    }
   }
   assert.ok(home.includes("资料库"));
-  assert.ok(home.includes("/docs/pretext/00-overview"));
+  assert.ok(home.includes("/docs/source-studies/pretext/overview"));
   const assets = new Set(
     [...home.matchAll(/(?:src|href)="(\/_next\/static\/[^" ]+)"/g)].map((m) =>
       m[1].replaceAll("&amp;", "&"),