[Desktop] Startup maintenance screen

[webfiltered]

Desktop startup validation

Detects problems with the installation when loading, allowing users to easily resolve several issues without needing to load a terminal and type out lengthy commands.

• Change application install path
• Install missing python packages
• Reset virtual environment (clear python packages)
• Reset uv cache
• Remove desktop config files and re-run the app installer (reinstall)
• Download git & Visual C++ Redistributable

Fix typo in base_path, and missing pyyaml

base-path-venv.mp4

Edit: Pending updates.

┆Issue is synchronized with this Notion page by Unito

[huchenlei]

Can you attach some example screenshots and the UX flow of this feature?

[webfiltered]

Can you attach some example screenshots and the UX flow of this feature?

100% - was the first thing I started doing after drafting. 😄

[huchenlei]

We can simplify states to following structure and make these boolean fields computed getter.

export enum TaskState {
  Idle = 'idle',
  Loading = 'loading',
  Executing = 'executing',
  Error = 'error',
  Warning = 'warning',
  OK = 'OK',
  Skipped = 'skipped',
  Resolved = 'resolved'
}

/** State of a maintenance task, managed by the maintenance task store. */
export interface MaintenanceTaskState {
  /** The current state of the task. */
  taskState: TaskState
  /** `true` if the task has been resolved (was `error`, now `OK`). */
  resolved: boolean
  /** Whether the task state is currently being refreshed. */
  loading: boolean
  /** Whether the task is currently running. */
  executing: boolean
  /** The error message that occurred when the task failed. */
  error?: string
}

export class MaintenanceTaskStateImpl implements MaintenanceTaskState {
  taskState: TaskState = TaskState.Idle
  error?: string

  constructor(public readonly task: MaintenanceTask) {}

  get resolved(): boolean {
    return this.taskState === TaskState.Resolved
  }

  get loading(): boolean {
    return this.taskState === TaskState.Loading
  }

  get executing(): boolean {
    return this.taskState === TaskState.Executing
  }

  get hasError(): boolean {
    return this.taskState === TaskState.Error
  }

  async execute() {
    try {
      this.taskState = TaskState.Executing
      const success = await this.task.execute()
      if (!success) return false

      this.error = undefined
      this.taskState = TaskState.OK
      return true
    } catch (error) {
      this.error = (error as Error)?.message
      this.taskState = TaskState.Error
      throw error
    }
  }
}

  /**
   * Updates the task list with the latest validation state.
   * @param update Update details passed in by electron
   */
  const processUpdate = (update: InstallValidation) => {
    // Update each task state
    for (const task of DESKTOP_MAINTENANCE_TASKS) {
      const state = getState(task)

      if (update[task.id] === undefined) {
        state.taskState = TaskState.Loading
        continue
      }

      if (state.taskState === TaskState.Error && update[task.id] === 'OK') {
        state.taskState = TaskState.Resolved
      } else {
        state.taskState = update[task.id] as TaskState
      }
    }

    // Final update
    if (!update.inProgress) {
      for (const task of DESKTOP_MAINTENANCE_TASKS) {
        const state = getState(task)
        state.taskState = update[task.id] as TaskState ?? TaskState.Skipped
      }
    }
  }