feat(walkthrough): a first-visit tour built from this app's own menu

[rubenvdlinde]

ADR-043. This app had no walkthrough, so a new user arrived on a shell with no orientation at all.

Every target is read from this manifest, never invented

CnWalkthrough resolves target: {kind: "nav-item", ref} by querying [data-cn-route="<ref>"],
which CnAppNav emits from the route. A tour pointing at a menu id that differs from its route
still renders — as a centred, anchorless coachmark that points at nothing. That failure is invisible
in every way that matters: the step appears, advances correctly, and reads fine; it just stops doing
the one thing it exists for.

So every ref here is taken from the manifest's own route, and I verified that each one resolves
to a page this manifest declares.

Translation keys are not sentences

Where a menu label is a key rather than prose, the copy uses the key's last segment as a word.
Printing launchpad.menu.dashboards at a user is worse than useless — and the obvious fallback, the
route, gives "Click dashboard-detail in the menu": an internal identifier read aloud.

Verified

• manifest validates against schema 2.26.0
• 0 target refs that do not resolve to a declared page
• 0 raw translation keys reaching user-visible copy
• manifest-only change

Scope note

thematiq and planninq are deliberately excluded: both declare zero pages and zero menu
entries, so a tour would have nothing to point at. A walkthrough there would be the same anchorless
coachmark this PR exists to avoid.

[github-actions]

Quality Report — ConductionNL/keepiq @ 78eda1d

Check	PHP	Vue	Security	License	Tests
lint	✅
phpcs	✅
phpmd	✅
psalm	✅
phpstan	✅
phpmetrics	✅
eslint		✅
stylelint		✅
build		✅
check-manifest		✅
test-l10n		✅
format		✅
check-l10n-js		✅
check-schema-l10n		✅
composer			✅	✅ 111/111
npm			✅	✅ 550/550
app:check-code	⏭️
info.xml	✅
REUSE	❌
PHPUnit					✅
Newman					✅
Playwright					🚨 NO VERDICT — enabled but never ran
Hydra gates					❌

---

Quality workflow — 2026-08-28 20:12 UTC

Download the full PDF report from the workflow artifacts.

[github-actions]

Quality Report — ConductionNL/keepiq @ 022d78a

Check	PHP	Vue	Security	License	Tests
lint	✅
phpcs	✅
phpmd	✅
psalm	✅
phpstan	✅
phpmetrics	✅
eslint		✅
stylelint		✅
build		✅
check-manifest		✅
test-l10n		✅
format		✅
check-l10n-js		✅
check-schema-l10n		✅
composer			✅	✅ 111/111
npm			✅	✅ 550/550
app:check-code	⏭️
info.xml	✅
REUSE	❌
PHPUnit					✅
Newman					✅
Playwright					🚨 NO VERDICT — enabled but never ran
Hydra gates					❌

---

Quality workflow — 2026-08-28 20:24 UTC

Download the full PDF report from the workflow artifacts.

[github-actions]

Quality Report — ConductionNL/keepiq @ f62cf5e

Check	PHP	Vue	Security	License	Tests
lint	✅
phpcs	✅
phpmd	✅
psalm	✅
phpstan	✅
phpmetrics	✅
eslint		✅
stylelint		✅
build		✅
check-manifest		✅
test-l10n		✅
format		✅
check-l10n-js		❌
check-schema-l10n		✅
composer			✅	✅ 111/111
npm			✅	✅ 550/550
app:check-code	⏭️
info.xml	✅
REUSE	❌
PHPUnit					✅
Newman					✅
Playwright					🚨 NO VERDICT — enabled but never ran
Hydra gates					✅

---

Quality workflow — 2026-08-29 02:00 UTC

Download the full PDF report from the workflow artifacts.

[github-actions]

Quality Report — ConductionNL/keepiq @ 736f9ca

Check	PHP	Vue	Security	License	Tests
lint	✅
phpcs	✅
phpmd	✅
psalm	✅
phpstan	✅
phpmetrics	✅
eslint		✅
stylelint		✅
build		✅
check-manifest		✅
test-l10n		✅
format		✅
check-l10n-js		✅
check-schema-l10n		✅
composer			✅	✅ 111/111
npm			✅	✅ 550/550
app:check-code	⏭️
info.xml	✅
REUSE	❌
PHPUnit					✅
Newman					✅
Playwright					🚨 NO VERDICT — enabled but never ran
Hydra gates					✅

---

Quality workflow — 2026-08-29 02:44 UTC

Download the full PDF report from the workflow artifacts.