feat(cli): deployment history and version-scoped diff/review

[Ruari-Phipps]

Summary

Adds poly deployments, extends diff / review with hash and --before / --after / --files, updates.
Updates review to be review create to be similar with branch commands

Motivation

Improves visibility into deployed versions and makes comparing local vs remote or named versions consistent in the CLI.

Changes

• poly deployments with --env, pagination, --hash, --oneline, --json; Rich output with sandbox / pre-release / live badges.
• get_deployments (API + project): client_env, list return shape, tuple with active hashes on AgentStudioProject.
• poly diff / poly review: optional hash, --files, --before / --after; --delete on review; shared diff computation.
• poly review logic moved to poly review create
• poly revert / poly format: CLI shape updates to be consistent (--all removed; format uses --files).

Test strategy

• Added/updated unit tests
• Manual CLI testing (poly <command>)
• Tested against a live Agent Studio project
• N/A (docs, config, or trivial change)

Checklist

• ruff check . and ruff format --check . pass
• pytest passes
• No breaking changes to the poly CLI interface (or migration path documented)
• Commit messages follow conventional commits

Screenshots / Logs

--details

--env

[Copilot]

Pull request overview

Adds a new CLI surface for deployment history and extends existing diff/review workflows to support version-scoped comparisons.

Changes:

• Introduces poly deployments (env selection, pagination, hash anchor, rich/JSON output).
• Refactors poly diff / poly review to share diff computation and accept hash plus --before/--after/--files.
• Updates platform API + project layer deployment fetching to return deployment records (list) and active deployment hashes.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
src/poly/cli.py	Adds deployments command + new diff/review args and shared diff computation.
src/poly/project.py	Adds get_deployments() and extends named-version resolution (including deployment hash + local).
src/poly/output/console.py	Adds rich rendering helpers for deployment listings.
src/poly/handlers/platform_api.py	Changes get_deployments() to accept client_env and return a list of deployment records.
src/poly/handlers/interface.py	Updates interface signature/return type for get_deployments().
src/poly/tests/github_api_test.py	Updates review gist tests to patch _compute_diff and new arg names.

Comments suppressed due to low confidence (1)

src/poly/cli.py:1285

• AgentStudioCLI.revert() now rejects empty files and the error text still references --all, but the --all flag has been removed from the parser. This makes poly revert unusable despite the command description saying it should revert all changes by default. Consider treating files=None/[] as “revert all” and update the error/json output messages to remove --all references.

        if not files:
            if output_json:
                json_print(
                    {
                        "success": False,
                        "error": "No files specified to revert. Use --all or list files.",
                    }
                )
                sys.exit(1)
            error("No files specified to revert. Use [bold]--all[/bold] to revert all changes.")
            return

[Copilot]

_format_deployment_timestamp can raise ZoneInfoNotFoundError when ZoneInfo(tz_str) is constructed (e.g., if the timestamp ends with an unrecognized tz abbreviation). This exception is not currently caught, so poly deployments could crash on unexpected API data. Catch zoneinfo.ZoneInfoNotFoundError (or broader Exception) in this formatter.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 6 comments.

Comments suppressed due to low confidence (1)

src/poly/cli.py:1285

• The revert command currently errors when no files are provided and the error message still references --all, but --all has been removed from the parser and the help text says omitting files should revert all changes. The CLI should allow poly revert to revert everything (or reintroduce an explicit flag), and the error/help strings should be updated to match the actual arguments.

        if not files:
            if output_json:
                json_print(
                    {
                        "success": False,
                        "error": "No files specified to revert. Use --all or list files.",
                    }
                )
                sys.exit(1)
            error("No files specified to revert. Use [bold]--all[/bold] to revert all changes.")
            return

[github-actions]

Coverage Report

Base (main)	PR	Change
71.8%	72.3%	+0.5% ✅

Changed file coverage

File	Coverage	Change
poly/output/console.py	18.8%	-5.0% ⚠️
poly/handlers/platform_api.py	33.6%	+1.5% ✅
poly/cli.py	52.7%	+3.7% ✅
poly/project.py	69.3%	+2.4% ✅
poly/resources/pronunciation.py	78.8%	+0.7% ✅
poly/resources/resource.py	80.8%	+1.4% ✅