[PRD4] Integrate nested navigation and Command Palette regression site

[Vonng]

Consumer integration for theme epic pgsty/oink#11.

Outcome

Adopt and exercise PRD 4 in a real multi-root, bilingual consumer site without coupling content rollout to incomplete theme internals.

Phase A — after navbar/sidebar support

• Configure Docs, Blog, and Project roots using native Hugo menus.
• Add one-level nested top navigation with descriptions/icons and at least one external link.
• Set params.ui.sidebar_icon_policy: groups explicitly.
• Add one deliberate deep-menu fixture in a non-production test config to verify warning/degradation.

Phase B — after search/actions/Palette support

• Add representative search_keywords, inherited search_boost, and exclusion aliases.
• Add localized custom URL commands and built-in action references.
• Exercise Copy/View Markdown, edit/issue URLs, theme/language/version switches, and print.

Acceptance criteria

• EN/ZH home, Docs, Blog, and Project routes build and navigate under root and subpath deployment.
• Search indexes remain language-separated and meet the agreed size budget.
• Desktop, mobile, keyboard, and screen-reader regression matrix passes.
• Flat-menu compatibility is retained in a legacy fixture.
• Search-disabled and print builds contain no Palette runtime.
• No default telemetry request is observed.
• Work is delivered in two phases aligned with the theme dependency graph.

[Vonng]

PRD 4 consumer integration is implemented on local branch codex/prd4-regression-site and remains unreleased.

Phase A (07a5044): bilingual Docs/Blog nested navbar, Project third root, root switcher regression, sidebar_icon_policy: groups, root/subpath fixtures, desktop/mobile keyboard tests, and opened-state axe coverage.

Phase B (6480e0f): localized URL/built-in commands merged by ID, representative keywords/boost/cascade/exclusion metadata, EN/ZH language-separated index checks, runtime-gating checks, and Command Palette browser coverage for empty/text/>/choice/copy/print/URL/mobile-focus behavior. Follow-up compatibility commits: 091caf3 in the theme fixes same-type product-root identity; b644ff9 updates the legacy result-cap assertion so the configured cap applies to page hits while Actions remain independently available.

Current Hugo 0.164.0 evidence:

• npm test: PASS (build/format/Markdown/86-of-86 translation coverage/rendered links; 9 Hugo/alt-site, 18 Markdown-golden, and 15 favicon tests)
• full sitemap axe plus viewport/open-state checks: 29/29 PASS
• responsive shell, blog, Palette, content-component, and code-block browser suite: 52/52 PASS
• local search budgets: EN 63,523 B raw / 14,549 B gzip; ZH 66,620 B / 17,484 B at root, with subpath equivalents also below budget

This comment is implementation/test evidence only. Merge CI, the tagged theme release, consumer version update, and hosted root/subpath smoke tests remain separate release gates; the site should not advertise PRD 4 as released before those complete.

[Vonng]

Final local cross-version regression evidence:

• npm test: PASS with Hugo 0.160.1+extended and Hugo 0.164.0+extended against the local PRD 4 theme branch.
• npm run test:browser: PASS with both versions: 81 Playwright checks per version (29 accessibility/axe + 52 functional).
• The matrix covers EN/ZH, root and /preview/ deployment, Docs/Blog/Project roots, nested desktop disclosure and mobile accordion, Command Palette empty/text/>/choice modes, shared actions, language-separated local indexes, search-off and print runtime omission, no-JS behavior, and no default Palette telemetry.
• Static integration checks also pass: 9 Hugo build tests, 9 alternative-site tests, 18 Markdown output goldens, 15 favicon tests, translation/rendered-link validation, and formatting.
• The consumer worktree is clean at b644ff9; the theme worktree is clean at 19b2fc6.

This is local integration evidence only. Neither branch has been pushed or merged and no hosted deployment has been verified, so the Issue remains open for PR/CI/release validation.

[Vonng]

Merged, deployed, and production-verified.

• Consumer PR: feat: integrate PRD 4 navigation and Command Palette #4
• Merge commit: 7ace8b63952c20c3d8fca88614c67483080bed6b
• Theme dependency is pinned to the merged theme commit 9fc1d5ea50c843698cd08d31940c72bcfec45395 via public pseudo-version v0.2.2-0.20260812083702-9fc1d5ea50c8.
• PR checks passed: Cloudflare Pages preview, responsive/mobile, and Axe WCAG AA.
• Post-merge checks passed: GitHub Pages deploy https://github.com/pgsty/oink.pgsty.com/actions/runs/31580572388 and browser quality https://github.com/pgsty/oink.pgsty.com/actions/runs/31580572361.
• Production verification at https://oink.pgsty.com confirmed 200 responses for EN/ZH home, Docs, and Project routes; nested navigation, Command Palette/action manifest, group sidebar policy, and both fingerprinted language indexes are live. EN/ZH indexes contain 95 entries each with root, keywords, boost, and breadcrumb metadata.

Issue #3 was closed by the merge.