Migrate setup_wizard to the new resource layer

[rtibblesbot]

Summary

• TaskResource.{cancel,restart,clearAll} call sites now use the _v2 methods.
• SetupWizardResource and FacilityImportResource are plugin-local, so their four custom methods are rewritten in place onto request rather than paired with a _v2.
• Three of them now resolve with the response body rather than the response, so LodJoinFacility.vue destructures one level up; facilityadmins already did.
• Deleted FacilityImportResource.listfacilitylearners — uncalled, and a duplicate of FacilityUserResource.listRemoteFacilityLearners.

References

Closes #15063. Recipe: #15057. _v2 methods: #15162.

Reviewer guidance

Code review

For a developer reading the diff.

• The rewritten methods route failures through Resource.logError, which accessListEndpoint never called. A wrong password on SelectSuperAdminAccountForm.vue:175 now emits a Request error: group — confirm that is acceptable.
• No useList conversion: the three TaskResource.list sites are setTimeout polling loops, and useList wraps a single list() with no polling.

QA steps

For a tester installing the build artifacts in a VM. No UI change — every screen below should behave as on develop. The wizard runs once per device, so each row needs a freshly installed VM; rows 2-6 need a second VM on the network running any released Kolibri with a facility on it.

Where	What to check
Setting up Kolibri — "Group learning" with a new facility, and separately "On my own"	both run through to the end and leave you signed in
Group learning → import a facility from the other VM	Cancel mid-import stops it and a restart finishes; after a failed import, Retry and Start over both work
Select super admin, after that import	the account dropdown lists the imported facility's admins; a wrong password shows the error and does not advance, the right one continues; finish and sign in as that admin
Select super admin → Create new super admin account	the form finishes the wizard, and the account you just made signs in
Learn-only device → Import one or more existing user accounts	one user imports, then Import another user account imports two more from the list; each imported user signs in
Learn-only device → Create a new user account for an existing facility (that facility must allow learners to sign up)	a username already used there shows the "username already exists" error on the form; a free one creates the account and imports it
Reload the browser midway through a facility import	the wizard carries on, with no task from the previous attempt on screen

AI usage

Used Claude Code to apply the shared migration recipe across the plugin and to write the resource spec covering the four rewritten methods. Verified with the setup_wizard Jest suite and prek.

---

@rtibblesbot's comments are generated by an LLM, and should be evaluated accordingly

How was this generated?

• Ran pre-flight CI checks (lint, format, tests) and verified all pass
• Rebased onto the target branch and resolved any conflicts
• Reorganized commit history into clean, logical commits
• Audited the diff to ensure only issue-relevant files are changed
• Built PR body from the repository's PR template with evidence blocks

🟡 Waiting for feedback Last updated: 2026-08-20 15:08 UTC

[github-actions]

Build Artifacts

Asset type	Download link
PEX file	kolibri-0.20.0a2.dev114_g581c02beb.pex
Windows Installer (EXE)	kolibri-setup-0.20.0a2.dev114+g581c02beb-unsigned.exe
Debian Package	kolibri_0.20.0a2.dev114+g581c02beb-0ubuntu1_all.deb
Debian Package	kolibri-server_0.20.0~a2.dev114+g581c02beb-0ubuntu1_all.deb
Mac Installer (DMG)	kolibri-0.20.0a2.dev114+g581c02beb.dmg
Android Package (APK)	kolibri-0.20.0a2.dev114+g581c02beb-debug.apk
Raspberry Pi Image	kolibri-pi-image-0.20.0a2.dev114+g581c02beb.zip
TAR file	kolibri-0.20.0a2.dev114+g581c02beb.tar.gz
WHL file	kolibri-0.20.0a2.dev114+g581c02beb-py3-none-any.whl

Smoke test screenshot

Download screenshot

[rtibblesbot]

The red Android smoke test (API 24) leg is a runner-local flake, not a diff issue: make maestro-install died with curl: (56) fetching the pinned maestro.zip from GitHub releases, before the emulator booted. API 30 and API 35 installed and passed on the same commit in the same run.

[AlexVelezLl]

Code changes look good, and smoke tests check out. It's ready for QA review, @rtibblesbot please add a QA steps section similar to the other migration PRs, thanks!

[rtibblesbot]

Added a QA steps section: seven flows covering the six renamed TaskResource call sites and the four rewritten custom methods — new facility, facility import (cancel/retry/start over), both super-admin branches, both learn-only branches, and a mid-import reload.

Class sweep: checked every open PR in the #15057 migration family for a missing QA-steps section. Three are open — #15163 already had one; #15183 (user_profile) did not, so it now has one too. #15144, #15155, #15162 and #15184 are merged and untouched.

[radinamatic]

Removed the Needs QA label so the PR can be rebased to include changes from #15217 that will unblock the pending QA workflows.

[rtibblesbot]

Rebased onto develop eca38c5, which carries #15217. All three commits replayed without conflict — #15217 is backend-only and this branch is frontend-only, so the diff is unchanged (8 files, all under kolibri/plugins/setup_wizard/frontend/).

Re-verified after the rebase: pnpm test-jest --testPathPatterns setup_wizard 6 suites / 16 tests pass, prek run --from-ref upstream/develop --to-ref HEAD passes, and both acceptance greps (legacy base methods; TaskResource.{cancel,clear,restart,clearAll} without _v2) are still empty — develop landed no new legacy call sites in this plugin.

Class sweep: checked all five open PRs in the #15057 migration family for the same staleness. #15163 and #15183 got the same request and are already on eca38c5. #15206 and #15207 are 48 commits behind but are not in QA and carry no such request, so I left them alone — say the word if you want them rebased too.

QA steps unchanged: none of the seven flows pins a peer Kolibri version, so nothing there was blocked on #15217.

[rtibblesbot]

Restructured the body: Reviewer guidance now splits into ### Code review and ### QA steps, after @radinamatic asked for that separation on #15183. The seven wizard flows are unchanged in substance, now a Where | What to check table, and the rig is a freshly installed VM rather than a reset KOLIBRI_HOME.

---

@rtibblesbot's comments are generated by an LLM, and should be evaluated accordingly

[pcenov]

Thanks @AlexVelezLl @radinamatic and @rtibblesbot - no regressions observed while manually testing - good to go!

[AlexVelezLl]

LGTM! Thank you all!