Add configurable analyze output and git-skip options

[sonii-shivansh]

Motivation

• Provide users more control over analyze runs for large or non-git repositories and custom report locations.
• Allow temporarily overriding hotspot counts without changing config files.
• Ensure AI insights are colocated with the chosen report output for convenience.

Description

• Add new CLI flags to analyze: --skip-git to bypass git history analysis, --hotspots <n> to override hotspot count, and --output <path> to set the HTML report path, implemented in ImprovedAnalyzeCommand.
• Validate --hotspots to fail fast when non-positive values are provided and use the override when present via hotspotLimit.
• Compute reportFile from --output when provided and create parent directories as needed, and write ai-insights.md next to the chosen report file.
• Document the new flags and usage examples in README.md.

Testing

• Ran ./gradlew test in this environment and it failed due to the CI environment lacking a Java 21 toolchain (toolchain download not configured), so unit tests could not complete.

---

Codex Task

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 899080a948

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Return non-zero on invalid --hotspots value

When --hotspots is 0 or negative, this branch only prints an error and returns from run(), which still exits the CLI process successfully. In automation (scripts/CI), that makes an invalid invocation look like a successful analysis run, so downstream steps may proceed using stale or missing outputs. This validation should fail the command with a non-zero exit (for example via a Clikt usage error) instead of a normal return.

Useful? React with 👍 / 👎.