feat: first-run onboarding experience and user engagement nudges#101

Merged

kumaakh merged 41 commits into

mainfrom

feat/onboarding-ux

Apr 18, 2026

Commits on Apr 15, 2026

plan: onboarding & user engagement implementation plan

mraduldubey
authored and
kumaakh
committed
review: onboarding plan — CHANGES NEEDED (6 must-fix, 4 recommended)

mraduldubey
authored and
kumaakh
committed
chore: add reviewer feedback

mraduldubey
authored and
kumaakh
committed
review: onboarding plan re-review — APPROVED (all findings resolved)

mraduldubey
authored and
kumaakh
committed
feat(onboarding): Phase 1 — state service and text constants [tasks 1.1, 1.2]

mraduldubey
authored and
kumaakh
committed
review: Phase 1 code review — APPROVED (all criteria pass, 3 minor recommendations)

mraduldubey
authored and
kumaakh
committed
feat(onboarding): Phase 2 — wrapTool() integration + first-run banner [tasks 2.1, 2.2]

mraduldubey
authored and
kumaakh
committed
chore: update progress.json — Phase 2 completed (tasks 2.1, 2.2, VERIFY 2)

mraduldubey
authored and
kumaakh
committed
review: Phase 2 code review — APPROVED (all 8 criteria pass, 2 minor recommendations)

mraduldubey
authored and
kumaakh
committed
feat(onboarding): Phase 3 task 3.1 — getOnboardingNudge() [task 3.1]

mraduldubey
authored and
kumaakh
committed
feat(onboarding): Phase 3 task 3.2 — getWelcomeBackPreamble() + Phase 3 tests [task 3.2]

mraduldubey
authored and
kumaakh
committed
chore: update progress.json — Phase 3 completed (tasks 3.1, 3.2, VERIFY 3)

mraduldubey
authored and
kumaakh
committed
review: Phase 3 code review (cumulative) — APPROVED (all 9 criteria pass, 1 minor observation)

mraduldubey
authored and
kumaakh
committed
feat(onboarding): Phase 4 task 4.1 — hardening & polish [task 4.1]

mraduldubey
authored and
kumaakh
committed
feat(onboarding): Phase 4 task 4.2 — integration tests + full coverage [task 4.2]

mraduldubey
authored and
kumaakh
committed
chore: update progress.json — Phase 4 completed (tasks 4.1, 4.2, VERIFY 4)

mraduldubey
authored and
kumaakh
committed
chore: add CLAUDE.md to .gitignore (agent-role file, not for repo)

mraduldubey
authored and
kumaakh
committed
review: Final cumulative review (Phases 1-4) — APPROVED (all 8 criteria pass, all 5 RECs resolved)

mraduldubey
authored and
kumaakh
committed
cleanup: remove fleet control files

mraduldubey
authored and
kumaakh
committed
fix(tests): skip file-permission assertion on Windows

mraduldubey
authored and
kumaakh
committed
cleanup: remove sprint control files, PM artifacts, and FUSE hidden files from PR

mraduldubey
authored and
kumaakh
committed
chore: restore AGENTS.md and CLAUDE.md from main

mraduldubey
authored and
kumaakh
committed
feat(onboarding): rewrite guide to use natural language instead of tool names

mraduldubey
authored and
kumaakh
committed
review(onboarding): UX feedback on user-facing onboarding text

mraduldubey
authored and
kumaakh
committed
fix(onboarding): apply 5 UX review fixes from feedback.md

mraduldubey
authored and
kumaakh
committed
review(onboarding): round 2 — all 5 UX fixes verified, APPROVED

mraduldubey
authored and
kumaakh
committed
chore: sync final UX review feedback

mraduldubey
authored and
kumaakh
committed
docs(onboarding): update token cost comment with accurate character counts

mraduldubey
authored and
kumaakh
committed
fix(onboarding): add passive tool guard, session flag reset, and MCP content annotations

mraduldubey
authored and
kumaakh
committed
fix(onboarding): banner bypasses JSON check — passive guard is sufficient

mraduldubey
authored and
kumaakh
committed
review(onboarding): banner visibility fix — code review APPROVED

mraduldubey
authored and
kumaakh
committed
feat(onboarding): emit banner/nudges via MCP logging notifications with verbatim markers

mraduldubey
authored and
kumaakh
committed
test(onboarding): verify notification emission and verbatim markers

mraduldubey
authored and
kumaakh
committed
test(onboarding): close coverage gaps for notification approach

mraduldubey
authored and
kumaakh
committed
docs(onboarding): update token cost analysis for notification-hybrid delivery

mraduldubey
authored and
kumaakh
committed
fix(security): sanitize <apra-fleet-display> markers in tool results; validate host/work_folder inputs

mraduldubey
authored and
kumaakh
committed
test(security): verify marker sanitization and input validation

mraduldubey
authored and
kumaakh
committed
docs(adr): verbatim onboarding UX delivery through an LLM client

mraduldubey
authored and
kumaakh
committed

Commits on Apr 16, 2026

Commits on Apr 18, 2026

review(#101): APPROVED — first-run onboarding experience and user engagement nudges

Akhil Kumar
authored and
Akhil Kumar
committed