feat(setup): ask which example data to load, as cards, instead of a bare Run button

[rubenvdlinde]

The problem, and it is not only cosmetic

The demo-data step was a Run button under a paragraph. The paragraph said the data is safe to load and safe to delete. Neither said what was about to land in the operator's register.

And there was no way to say no. This app implements a skip-demo-data action that no manifest step could reach — the only step was the run-action that installs. So an operator who did not want example data could not record that, demo-data stayed done: false, and CnAppRoot reopens the wizard while any optional step is outstanding: over every page, on every fresh browser profile, until they imported data they did not want.

Measured across the fleet on 2026-09-05: fifteen apps implement that action and not one declares a step that can post it.

What the step asks now

Two cards, read from the server:

None, I will set this up myself	Nothing is imported. You start with an empty app.
Example data	Sample values for every schema this app supplies, with the object count the descriptor actually carries.

Picking one is an answer. none closes both steps without importing anything.

The list comes from GET /api/setup/status as datasets: the step declares optionsSource and carries no options of its own, so nothing in the manifest can disagree with what will be imported. The count is read from the descriptor file, so the card promises the number that lands.

The card's description carries no number, deliberately. The wizard translates a description by literal lookup, so an interpolated count would leave a Dutch operator reading English. The count travels as objectCount and renders as a stat with a label the library translates.

Compatibility

install-demo-data still works and still means "the dataset this app ships", so a runbook or script that posts it keeps working. skip-demo-data now writes both keys instead of only the decision flag.

Verification

• 21 PHPUnit tests pass, 9 of them new: the offered list, declining, an unknown dataset refused, loading without a choice refused, the legacy action, and a failure leaving the step undecided.
• PHPCS, ESLint and prettier clean.
• All 75 applicable hydra gates green.

Depends on

• @conduction/nextcloud-vue 2.37.0 — CnChoiceCards and the display / optionsSource manifest keys (feat(setup): let a choice step explain itself, as cards over a server-owned list nextcloud-vue#996, published from main).
• hydra-gates v1.15.0 — manifest schema 2.33.0, or gate 22 rejects this manifest. Already in composer.lock here.

Follows ConductionNL/decidiq#1152 and ConductionNL/filinq#1010.

🤖 Generated with Claude Code

[github-actions]

Quality Report — ConductionNL/integriq @ eb3151b

Check	PHP	Vue	Security	License	Tests
lint	✅
phpcs	✅
phpmd	✅
psalm	✅
phpstan	✅
phpmetrics	✅
eslint		✅
stylelint		✅
build		✅
build		✅
check-specs		✅
test-l10n		✅
format		✅
check-schema-l10n		✅
check-l10n-js		✅
composer			✅	✅ 141/141
npm			✅	✅ 537/537
app:check-code	⏭️
info.xml	✅
REUSE	❌
PHPUnit					✅
Newman					✅
Playwright					⏭️ deferred — runs on the promotion into beta/main, not on a pull request into development
Hydra gates					✅

---

Quality workflow — 2026-09-05 09:42 UTC

Download the full PDF report from the workflow artifacts.