CodeNomad/dev-docs
Pascal André 339ecf945c
feat(help): open localized guide sections from contextual info icons (#1404)
## Summary

- Extend the existing `SettingsInfoTip` with `help?: { page: string;
anchor?: string }`; retain short hover/focus explanations and open
matching localized help externally on click, Enter or touch.
- Reuse `helpUrl` and `openExternalUrl`, guard page/anchor syntax,
preserve containing controls and disclosures, and show the existing
localized help error without replaying failed actions.
- Carry destinations through existing choice rows, behavior settings and
core Status metadata; document the reusable pattern and update the
settings guide in all ten languages.

## Linked inventory

- General: automatic subsession expansion, keep-awake, Memory, Tidy up
and memory-review warning.
- Advanced: whitespace-only changes and session environment variables.
- OpenCode: startup launch.
- Providers: image generation and image storage.
- Notifications: On screen, History and System column tips.
- Speech: provider, separate providers, shared/input/output base URLs,
playback mode, output format, playback test and prompt voice input.
- Status: Tokens, Yolo mode, Usage, Background Shells, MCP and Plugins.

Mission creation/scheduling/depth/preferences belong to the separate
form change, which can use the shared prop directly. Dynamic mission
budget, attention and diagnostics tips retain their information-only
purpose. Existing `SettingsInfoLink` and integration `InfoPopoverButton`
explanations retain their actionable/runtime-specific popovers; sidebar
Info navigation and Info-card heading icons keep their distinct purpose.

## Validation

- `npm ci` in the isolated checkout.
- UI typecheck.
- URL/section checks: every literal contextual destination resolves in
all ten locales, including `zh-Hans`.
- Behavior and right-panel registry tests: 14 passed.
- Full help suite: 31 passed, validating 28 pages × 10 locales.
- Real Solid browser gesture and relevant settings regressions: 56
passed (new shared-tip cases, startup launch, General/appearance,
Memory, notifications and help-command routes). All eight new
gesture/native-route cases pass.
- The fixture-wiring audit reports two existing WebKit fixtures without
the required exemption/navigation-budget wiring; those files and the
audit inputs are unchanged from `origin/dev`.

## Scope

No Mission form/tree edits, new dependencies, URL registry, plugin
extension point or duplicated info component. Visible explanations and
opener errors reuse existing translations.

## Independent review and CI

Round 1 found a translation-readiness race in the browser test. The test
now waits for the real localized info-link label before activating it.
Round 2: **No findings**.

Current `origin/dev` is merged. CI has baseline failures in the
unchanged binary-build ordering expectation and Cargo lockfile; the unit
failure reproduces locally and the affected inputs match `origin/dev`.
The existing fixture-wiring audit likewise reports only unchanged WebKit
files. These are tracked in the PR discussion separately from
contextual-help validation. Additional platform jobs remain
queued/running; admin merge is explicitly authorized for this change.

## Real component capture

![Startup and keep-awake settings with the shared contextual info
tooltip](https://raw.githubusercontent.com/NeuralNomadsAI/CodeNomad/95c2ada0f/pr-assets/contextual-help.png)
2026-11-09 00:22:03 +01:00
..
AGENT_MEMORY.md feat(memory): add opt-in persistent agent memory (#1313) 2026-11-06 15:29:24 +01:00
architecture.md feat(tauri): embed native WebKit previews on macOS and Linux (#1301) 2026-11-08 23:46:06 +01:00
BROWSER_AUTOMATION.md feat(tauri): embed native WebKit previews on macOS and Linux (#1301) 2026-11-08 23:46:06 +01:00
BROWSER_DEVICE_EMULATION.md feat(tauri): embed native WebKit previews on macOS and Linux (#1301) 2026-11-08 23:46:06 +01:00
BROWSER_TESTING.md feat(usage): read OpenCode Console usage and mark free quota exhaustion (#1317) 2026-11-06 23:17:25 +01:00
CACHE_REFRESH_CONVENTIONS.md perf(transcript): coalesce streaming projections to one pass per frame (#1289) 2026-11-05 10:20:20 +01:00
COMPOSER.md fix(tauri): attach pasted images and files on Linux (#1383) 2026-11-08 01:53:27 +01:00
DESKTOP_DATA_PROFILES.md feat(tauri): embed native WebKit previews on macOS and Linux (#1301) 2026-11-08 23:46:06 +01:00
FILES_PANEL.md fix(files): keep the central file reader open when the right panel hides (#1267) 2026-11-03 15:07:31 +01:00
HOTKEYS.md fix(tauri): stop F11 from freezing the Linux app (#1143) 2026-10-25 21:25:16 +01:00
INDEX.md ci: serve release downloads from verified dev-seeded caches (#1390) 2026-11-08 18:03:18 +01:00
MISSIONS.md fix(missions): make the subagent depth one menu row and Save as brief an icon (#1391) 2026-11-08 17:31:31 +01:00
MISSIONS_AUTONOMY.md fix(missions): disconnect Missions from service supervision so Play and Resume always run (#1285) 2026-11-04 00:12:04 +01:00
MISSIONS_NATIVE_CONTRACTS.md fix(missions): resolve scheduled wakes from native message records (OpenCode 2.2.6) (#1350) 2026-11-07 22:01:03 +01:00
MISSIONS_NATIVE_SCHEDULE_TRANSPORT.md fix(missions): resolve scheduled wakes from native message records (OpenCode 2.2.6) (#1350) 2026-11-07 22:01:03 +01:00
MISSIONS_RECURRING.md fix(missions): resolve scheduled wakes from native message records (OpenCode 2.2.6) (#1350) 2026-11-07 22:01:03 +01:00
MISSIONS_RECURRING_QUALIFICATION.md fix(missions): disconnect Missions from service supervision so Play and Resume always run (#1285) 2026-11-04 00:12:04 +01:00
NATIVE_INTERRUPTION_UX.md fix(worktrees): keep checkouts lacking the opened nested folder out of recovery (#1299) 2026-11-06 01:35:49 +01:00
OPENCODE_COMPATIBILITY.md chore(opencode): recommend qualified runtime 2.2.6 (#1379) 2026-11-07 22:06:31 +01:00
OPENCODE_INTEGRATIONS.md feat(integrations): ship native Status sections and catalogue installation (#1283) 2026-11-04 01:36:40 +01:00
OPENCODE_RUNTIME_SETUP.md fix(runtime): run bundled npm and npx commands with a scoped, general-purpose environment (#1377) 2026-11-07 23:53:44 +01:00
PALETTE_SOURCES.md docs(agents): keep AGENTS.md to universal rules and agent docs to the current state (#1082) 2026-10-21 16:59:43 +02:00
PANEL_EXTENSIONS.md build(electron): update to Electron 45 and keep the desktop toolchains current (#1315) 2026-11-07 01:23:02 +01:00
PLUGIN_CONTROLS.md chore(pruning): remove the unused TUI companion plugin (#1316) 2026-11-06 16:21:00 +01:00
PROJECTS.md feat(memory): add opt-in persistent agent memory (#1313) 2026-11-06 15:29:24 +01:00
PROVIDER_ACCOUNTS.md feat(usage): read OpenCode Console usage and mark free quota exhaustion (#1317) 2026-11-06 23:17:25 +01:00
REMOTE_CONTROL.md perf(electron): run the backend with Electron's Node (#1304) 2026-11-06 06:35:53 +01:00
RUNTIME_MAINTENANCE.md ci: serve release downloads from verified dev-seeded caches (#1390) 2026-11-08 18:03:18 +01:00
SESSION_ENVIRONMENT.md feat(missions): resume recurring Missions after OpenCode restarts with native schedules (#1259) 2026-11-01 14:40:24 +01:00
SESSION_HISTORY_NAVIGATION.md fix(transcript): hold the top after an immediate jump to the first message (#1302) 2026-11-05 21:14:21 +01:00
SESSION_HISTORY_QUERIES.md fix(missions): resolve scheduled wakes from native message records (OpenCode 2.2.6) (#1350) 2026-11-07 22:01:03 +01:00
SESSION_PRUNING_RPC.md fix(storage): support native split assistant parts across history and pruning (#1359) 2026-11-07 15:34:22 +01:00
SESSION_PRUNING_SAFETY.md fix(storage): support native split assistant parts across history and pruning (#1359) 2026-11-07 15:34:22 +01:00
SESSION_RECOVERY.md fix(sessions): restore the collapsed parent chevron (#1292) 2026-11-04 19:01:41 +01:00
SETTINGS.md feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
solidjs-llms.txt update blank session cleanup code for now session store logic 2025-11-27 20:18:22 -05:00
TAURI_UPDATER.md build(tauri): update to Tauri 2.12 and keep its crates current (#1320) 2026-11-06 23:05:59 +01:00
TEXT_DISPLAY_BOUNDS.md fix(transcript): keep streaming reasoning rendering past the display bound (#1106) 2026-10-23 11:48:13 +02:00
TRANSCRIPT.md fix(transcript): preserve message order when HTTP is ahead of live events (#1294) 2026-11-05 10:27:41 +01:00
UI_CONVENTIONS.md chore(missions): bordered panel commands and remove dead tree leftovers (#1388) 2026-11-08 10:36:11 +01:00
UI_SHELL.md fix(missions): keep the panel inside the window and move Save as brief to its menu (#1389) 2026-11-08 14:54:28 +01:00
USER_HELP.md feat(help): open localized guide sections from contextual info icons (#1404) 2026-11-09 00:22:03 +01:00
WORKTREE_SESSION_PLACEMENT.md fix(worktrees): keep checkouts lacking the opened nested folder out of recovery (#1299) 2026-11-06 01:35:49 +01:00