[Tracking] PRD 4: Nested Navigation and Command Palette

[Vonng]

Tracks PRD 4 delivery across the OINK theme and its consumer regression site.

Product constraints

• Hugo Menu remains the global-navigation authority.
• The Hugo content tree / existing docs nav remains the sidebar authority.
• The root switcher remains the product/domain switcher.
• The local search index becomes the shared discovery and command entry point.
• No second docs.json / navigation.yaml information architecture.
• Offline operation, language-separated indexes, CJK substring matching, and zero telemetry remain hard requirements.

Work breakdown

• [PRD4] Freeze navigation, palette, and runtime contracts #12 — contracts and characterization
• [PRD4] Isolate Palette runtime and coordinate transient surfaces #13 — runtime isolation and transient-surface coordination
• [PRD4] Add one-level nested navbar disclosure and mobile accordion #14 — one-level desktop/mobile nested navbar
• [PRD4] Add sidebar icon density policy #15 — sidebar icon density policy
• [PRD4] Extend local-search metadata and boosted ranking #16 — search metadata, boost, grouping, and CJK ranking
• [PRD4] Build shared action registry and command manifest #17 — shared action registry and safe command manifest
• [PRD4] Upgrade local search dialog into Command Palette #18 — Command Palette modes and interaction
• [PRD4] Integrate nested navigation and Command Palette regression site oink.pgsty.com#3 — multi-root bilingual consumer regression
• [PRD4] Document migration, compatibility, and release gates #19 — migration, compatibility, and release gates

Dependency graph

#12 Contract
 ├─> #13 Runtime ─┬─> #14 Navbar
 │                         ├─> #16 Search ─┐
 │                         └─> #17 Actions ├─> #18 Palette
 └─> #15 Sidebar                    ┘
          Navbar + Sidebar + Palette ─> consumer regression ─> #19 release gate

The runtime issue is intentionally two PRs (asset isolation, then surface coordination). The consumer issue is intentionally two PRs (navigation/sidebar, then search/Palette).

Epic exit criteria

• Flat menus remain compatible.
• Nested desktop and mobile navigation are keyboard and screen-reader operable.
• Search metadata, boosts, groups, and CJK paths are covered by deterministic tests.
• Page actions and Palette commands share one registry.
• Disabling local search emits no Palette runtime or local index.
• EN/ZH, subpath, home/docs/blog/project roots, shell, print, and external-link behavior pass consumer regression.
• No default telemetry request is introduced.

[Vonng]

Planning is now executable and the first foundation issue has started/landed locally.

• [PRD4] Freeze navigation, palette, and runtime contracts #12: local implementation complete at 314329a; contract and full characterization matrix are CI-wired.
• [PRD4] Isolate Palette runtime and coordinate transient surfaces #13 is the next critical-path issue because the harness proves plain and print outputs still load Lunr when local search is enabled.
• [PRD4] Add one-level nested navbar disclosure and mobile accordion #14 and [PRD4] Add sidebar icon density policy #15 can follow once [PRD4] Isolate Palette runtime and coordinate transient surfaces #13 establishes the shared transient-surface/runtime boundary.
• [PRD4] Extend local-search metadata and boosted ranking #16 and [PRD4] Build shared action registry and command manifest #17 can then proceed in parallel; [PRD4] Upgrade local search dialog into Command Palette #18 integrates both.
• Consumer regression remains tracked in [PRD4] Integrate nested navigation and Command Palette regression site oink.pgsty.com#3.

No feature behavior has been changed by #12; it establishes the regression and contract boundary for the implementation PRs.

[Vonng]

Epic completion (2026-08-23)

PRD 4 is complete and released.

• Theme issues [PRD4] Freeze navigation, palette, and runtime contracts #12 through [PRD4] Document migration, compatibility, and release gates #19 were closed by PR #20, merged as 9fc1d5e. The merge CI passed both supported Hugo versions.
• The bilingual multi-root consumer regression was delivered by pgsty/oink.pgsty.com PR #4, and the linked consumer issue is closed with deployment and production-verification evidence.
• The complete feature set shipped in OINK v0.3.0: nested Hugo Menu navigation, sidebar icon policy, language-separated search metadata/ranking, shared action registry, Command Palette, runtime isolation, migration documentation, and browser CI.
• On clean current origin/main (bdba85b, Hugo Extended 0.164.0), the navigation contract, runtime isolation, sidebar icon policy, search, actions, and Command Palette checkers all pass. The v0.6.0 CI run also passed Hugo 0.160.1, Hugo 0.164.0, and browser runtime tests.

Later shell and component releases have evolved the presentation, but the PRD 4 product constraints and capabilities remain in the current contract and regression suite. No epic exit criterion remains open. Closing as completed.