Skip to content

Extract onboarding gateway lifecycle application #9171

Closed

Description

@cv

Important

Reserved for @cv. Do not self-assign this issue. Do not open an implementation PR unless @cv requests help.

Parent: #7695

Problem

src/lib/onboard.ts owns OpenShell gateway create, start, stop, and recovery decisions.

Scope

  • Move gateway lifecycle behavior into src/lib/onboard/gateway/.
  • Keep the onboarding entry module responsible for phase sequencing and dependency wiring.
  • Reduce the onboarding fan-out and root-file budgets.

Acceptance criteria

  • The gateway phase has a named input and result contract.
  • The onboarding entry module contains no gateway lifecycle decision.
  • Resume and failure behavior remain unchanged.
  • Gateway and onboarding tests pass.
  • Architecture checks prevent new gateway lifecycle decisions in the entry module.

Activity

  1. added
    refactorPR restructures code without intended behavior change
    area: onboardingOnboarding FSM, provider setup, sandbox launch, or first-run flow
    area: sandboxOpenShell sandbox lifecycle, runtime, config, or recovery
    on Aug 14, 2026
  2. self-assigned this
    on Aug 14, 2026
  3. added
    area: architectureArchitecture, design debt, major refactors, or maintainability
    on Aug 14, 2026
  4. added a commit that references this issue on Aug 14, 2026
    f369791
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

area: architectureArchitecture, design debt, major refactors, or maintainabilityarea: onboardingOnboarding FSM, provider setup, sandbox launch, or first-run flowarea: sandboxOpenShell sandbox lifecycle, runtime, config, or recoveryrefactorPR restructures code without intended behavior change

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions