fix(cli): correct misleading docs and remove nonexistent --version hint

[alfredo-petri]

Problem

Two pieces of documentation describe behavior that doesn't match the code:

1. cli/README.md — wrong install mechanism

"By default, uipro init tries to download the latest release from GitHub..."

The current default path (init.ts:179-183) uses generatePlatformFiles() — template generation from bundled assets. GitHub download only happens in the legacy ZIP mode (init.ts:160), which is not exposed as a CLI option. So --offline is currently a no-op relative to the default.

2. cli/src/commands/versions.ts:34 — advertises a nonexistent flag

Use: uipro init --version <tag> to install a specific version

--version is not a registered option in index.ts for the init command. Running this would either use Commander's built-in --version (prints CLI version) or fail silently.

Fix

• Rewrite "How It Works" in README to accurately describe template-based generation
• Replace the nonexistent --version hint in versions.ts with an accurate tip

🤖 Generated with Claude Code

[mrgoonie]

Summary: This PR correctly removes the nonexistent uipro init --version <tag> hint, but the README rewrite goes too far and now makes --offline look like a no-op even though it still changes behavior in the legacy ZIP install path.

Risk level: Medium

Mandatory gates:

• Duplicate/prior implementation: no merged duplicate found; search found this PR plus broader CLI/release PRs, but no prior fix for the exact --version hint + README wording.
• Project standards: issue found — CLI docs should describe both default template mode and the remaining legacy/offline behavior accurately.
• Strategic necessity: clear value — avoiding nonexistent CLI flags and stale install docs reduces support churn.
• CI/checks: missing/not reported for this PR.

Findings:

• Important: cli/src/commands/init.ts still has a legacy ZIP-based install branch where options.offline skips the GitHub release download and falls back to bundled assets (if (options.legacy) { ... if (!options.offline) tryGitHubInstall(...) ... copyFolders(...) }). The PR README says --offline is a no-op with the current default, but the public CLI no longer exposes --legacy in cli/src/index.ts, so this wording is confusing from both directions: it documents internal behavior without explaining that the GitHub-download path is legacy-only/inaccessible from current public options. Please adjust the README/help text so it is precise, e.g. default init uses bundled template generation; --offline is retained for compatibility and only affects legacy/package paths if those are exposed, or remove/clarify the flag separately.

Verdict: REQUEST_CHANGES