PadIO: context_modes resolution (context token to mode)

[vgreg]

Implements #9. Builds on #8.

Maps the context token published by ContextObserver to a mode, per profile. All policy lives in PadIO so the bridge (#12) stays dumb and just reports a raw process name.

Config format

New optional key on ProfileConfig:

"ghostty": {
  "apps": ["com.mitchellh.ghostty"],
  "default_mode": "herdr-nav",
  "context_modes": { "claude": "agent", "nvim": "vim", "zsh": "shell" },
  "modes": { "herdr-nav": {}, "agent": {}, "vim": {}, "shell": {} }
}

context_modes is [String: String] (token → mode), decoded with decodeIfPresent(...) ?? [:], so every existing config keeps parsing unchanged. Matching is exact on the token.

Resolution rules (applyContext)

1. Fires only on token change — ContextObserver publishes only when the token actually changes, so an unchanged token never re-applies a mode.
2. No match leaves the mode alone — a token with no context_modes entry (or a nil token) keeps the active mode; it does not fall back to default_mode. This is what makes many app-specific modes safe.
3. Manual override sticks — because we only act on token changes, a hand-picked mode survives until the token changes.
4. Unknown mode name is logged and ignored, mirroring the existing .setMode handling.
5. Only the active profile is affected.

Profile-switch interaction

refreshActiveProfile now restores the context-implied mode when a profile becomes active again (alt-tab away from Ghostty and back), instead of snapping to default_mode. When it applies a context mode it sets both activeModeName and profileModes[name], so it no longer widens the pre-existing gap where only activeModeName was set.

Verified

• Builds clean via BuildProject.
• Behaviour with no context_modes anywhere is unchanged (empty dict default).

Runtime check (writing claude / nvim / an unmapped token to the context file and watching the mode HUD) is easiest to do end-to-end once the bridge in #12 exists, or by hand with printf ... > tmp && mv tmp ~/.config/padio/context.

🤖 Generated with Claude Code