fix(installer): back navigation from Pi-only install shows unrelated Gentle AI…
- User
fix(installer): back navigation from Pi-only install shows unrelated Gentle AI configuration
Pre-flight Checklist
- I have searched existing issues and this is not a duplicate
- I understand that PRs will be rejected if the linked issue does not have
status:approved
📝 Bug Description
When running the
gentle-piinstaller fromgentle-ai, if I select onlyPias the installation target and then useBackon the next step,
the installer returns to an unexpected configuration flow.Instead of going back to the previous installation target selection, it shows configuration options that do not correspond to the selected
Pi-only path, such as TDD configuration, multi-agent installation, communication style, and related Gentle AI setup options.🔄 Steps to Reproduce
- Start the
gentle-aiinstaller.
2. Select onlyPias the installation target.
3. Continue to the next step.
4. SelectBack.
5. Observe that the installer shows configuration screens for TDD, multi-agent setup, speaking style, etc.
✅ Expected Behavior
After selecting
Back, the installer should return to the previous relevant step in the Pi-only installation flow, likely the installation
target selection screen.❌ Actual Behavior
The installer jumps to unrelated Gentle AI configuration screens, including TDD setup, multi-agent installation, communication style, and other
options that were not expected after choosing a Pi-only installation.Gentle AI Version
v 1.30.5
Operating System
macOS
AI Agent / Client
Other
📋 Affected Area
CLI (commands, flags)
💡 Logs / Error Output
No logs available. This appears to be an installer navigation/state-flow issue.Additional Context
This happens specifically when selecting only
Piduring installation and then navigating back from the following step.Interface
No new interfaces are introduced.
- Assistant
Now the "Back" option handler in
confirmSelectionforScreenDependencyTree: - Assistant
Now the Esc handler in
goBack(): - Assistant
Now let me check how existing tests simulate Esc and the helper names:
- Assistant
Full test suite passes. The fix is complete.
Summary
Root cause: The Pi-only install flow skips the Persona and Preset screens on the way forward (
ScreenAgents→ScreenDependencyTreedirectly, model.go:1489), but back navigation fromScreenDependencyTreedidn't know about this shortcut. Both the Esc handler (goBack()) and the "Back" menu option fell through to the generic routeScreenDependencyTree → ScreenPreset, dropping the user into the preset/persona/TDD/multi-agent configuration flow that was never shown.Changes in
internal/tui/model.go:goBack()— added a Pi-only guard before the generic DependencyTree back logic: when the selection is Pi-only, Esc returns toScreenAgents(the actual previous screen).confirmSelection()/ScreenDependencyTree"Back" option — same guard, so Enter on "← Back" matches Esc behavior.confirmSelection()/ScreenAgentsPi-only branch — now also resetsSelection.PresettoPresetFullGentleman, so a stalePresetCustomfrom an earlier pass through the flow can't turn the Pi-only dependency tree into the custom component picker (which would have shown unrelated Gentle AI components and routed back navigation incorrectly).
Tests added in
internal/tui/model_test.go:TestPiOnlyDependencyTreeBackReturnsToAgents— verifies both Esc and the "Back" option return to agent selection instead of the preset screen.TestPiOnlyAgentContinueResetsStaleCustomPreset— verifies the stale-preset reset.
Verified with
go build ./...,go vet, and the fullgo test ./...suite — all green.
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.
Identical first prompt
- composer-2.5Compare side by side →
- composer-2.5Compare side by side →
- composer-2.5Compare side by side →
- composer-2.5Compare side by side →
- composer-2.5Compare side by side →
- gpt-5.6-solCompare side by side →
- gpt-5.6-solCompare side by side →
- gpt-5.6-solCompare side by side →
- gpt-5.6-solCompare side by side →
- gpt-5.6-solCompare side by side →
- fable-5Compare side by side →