Skip to content

feat: improve onboarding, desktop reliability, and project manager workflows - #2805

Merged
numnx merged 1 commit into
devfrom
fix/onboarding-electron-agent-navigation
Jul 10, 2026
Merged

feat: improve onboarding, desktop reliability, and project manager workflows#2805
numnx merged 1 commit into
devfrom
fix/onboarding-electron-agent-navigation

Conversation

@numnx

@numnx numnx commented Jul 10, 2026

Copy link
Copy Markdown
Collaborator

What changed

  • Restored the Easy onboarding introduction, removed Gemini from Easy mode, preselected Dashboard Login for every Easy provider, and preserved an explicit Local Copy choice.
  • Allowed only the required Claude Code and OpenCode postinstall scripts during managed global installation so npm 11 no longer leaves those CLIs half-prepared.
  • Rebuilt the interactive CLI login modal around a bounded terminal screen parser, reliable right-click paste/focus behavior, high-contrast trusted styling, and a safe temporary CLI working directory.
  • Packaged the automatic model-price catalog into Electron so desktop token costs match the npm runtime, including GPT-5.5 pricing.
  • Made Project Manager the default dashboard reply agent for new and imported projects, expanded its base instruction, and added a dedicated add_long_term_memory MCP lane with canonical/searchable storage and a rich confirmation widget.
  • Repaired Sprint Tasks/Live links and made project+sprint selection update route scope atomically on both pages.
  • Repaired compiled Electron documentation routes and added one focused five-page docs smoke job covering the index, overview, and three representative pages.
  • Updated canonical and public documentation for every changed behavior.

Why

Several desktop and Easy-mode paths had drifted from the npm runtime: onboarding skipped a required step and selected the wrong auth behavior, npm's newer install-script policy blocked two managed CLIs, Electron omitted the pricing catalog, and route state was updated outside the router. Project initialization also retained a worker-oriented dashboard reply override, while the Project Manager lacked a direct durable-memory write lane despite being the primary user entry point.

User and developer impact

Easy onboarding now leads users through the complete flow with predictable dashboard auth. Desktop provider setup, pricing, docs, and terminal login are reliable and visually coherent. New/imported projects consistently converse through Project Manager, which can store important durable knowledge directly and visibly. Sprint navigation no longer strands the UI on stale project or sprint query parameters.

Validation

  • pnpm run ci
    • dependency audit: no known vulnerabilities
    • backend coverage: 4,966 passed, 7 skipped; all coverage gates passed
    • dashboard: 1,969 passed, 2 skipped
    • typecheck and production build passed
  • pnpm run check:docs-web
  • git diff --check
  • pnpm run test:e2e -- --project=navigation tests/e2e/navigation/docs-page.spec.ts tests/e2e/navigation/sprint-navigation.spec.ts
    • five compiled docs routes loaded without page or console errors
    • Tasks/Live project and sprint switching regression passed
  • Fresh compiled runtime smoke at http://127.0.0.1:4444: /health, /docs, and /docs/docs-overview returned HTTP 200.

Risk and rollback

The highest-risk areas are project default routing, terminal stream normalization, and the new memory write path. Each is guarded by focused unit/integration tests plus browser coverage for navigation and docs. Rollback is a single revert of this commit; existing stored project overrides and memory claims remain backward-compatible.

@numnx
numnx marked this pull request as ready for review July 10, 2026 04:55
@numnx
numnx merged commit c99cb09 into dev Jul 10, 2026
13 checks passed
@numnx
numnx deleted the fix/onboarding-electron-agent-navigation branch July 10, 2026 04:55
@numnx numnx mentioned this pull request Jul 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant