v2026.5.10 — Beginner Onboarding Wizard + Docs

Guided onboarding wizard, deterministic workspace engagement status, and beginner docs for first-run success.

v2026.5.10 — Beginner Onboarding Wizard + Docs

Tag: `v2026.5.10` · Released: 2026-05-19 · npm: `npm install -g [email protected]`

This patch release makes the first-run path easier to understand and safer to execute. It adds a real guided onboarding flow, tightens status reporting around local project engagement, and refreshes beginner-facing docs so new users can move from install to a verified workspace without reading internal implementation history.

It also restores the literal meaning of `aiwg use all`: the command now deploys every framework, addon, and deployable extension by default. Workspace-aware filtering remains available through explicit profile-driven deployment and preview commands, but it no longer shadows the full install path.

What's new

`aiwg wizard` now walks users through provider choice, profile selection, execution mode, and verification. JSON output stays plan-only for automation, while unattended execution requires `--non-interactive` so scripts do not accidentally mutate a workspace.

`aiwg status --probe --json` now reports a deterministic engagement status for the current workspace. When local AIWG config is malformed, the status path keeps returning actionable repair guidance instead of leaving users with a raw parse failure.

`aiwg use all` now stays on the full deployment path. Use `aiwg use --workspace-signals` to preview a workspace-aware plan or `aiwg use --profile <name>` to deploy a filtered profile.

The full deployment summary now distinguishes platform-native skills from the larger `aiwg discover` corpus by printing a separate discoverable-skill count after the capability index build.

The shared context finalization path now includes engagement verification guidance without adding generated attribution footers to project docs.

Documentation updates

  • Added beginner docs for provider handoff, scope and recovery, onboarding validation, share/demo workflows, and current onboarding research.
  • Updated the skills/commands unification guide to describe provider-specific command mirroring without exposing internal tracker references.
  • Updated release navigation so the current and immediately previous patch releases appear in the docs manifest.

User impact

  • New users have a guided path from `aiwg wizard` to a verified provider workspace.
  • Automation can inspect wizard plans without side effects and must opt in explicitly before executing deployment.
  • `aiwg use all` installs the complete AIWG surface again instead of only the workspace-aware subset.
  • Status output is more useful for support and onboarding because it distinguishes configured, partially configured, and repair-needed project states.

Verification

Release-readiness checks for this line:

node tools/cli/validate-writing.mjs docs/beginner-provider-handoff.md docs/beginner-scope-and-recovery.md docs/beginner-onboarding-validation.md docs/beginner-share-demo-assets.md docs/beginner-research-refresh-2026.md docs/beginner-first-success.md
npx vitest run --config config/vitest.config.js test/unit/cli/wizard.test.ts
npx vitest run --config config/vitest.config.js test/unit/cli/handlers/use-workspace-filter.test.ts
npm run typecheck
npm run build:cli
npm test