docs: code review (#411)

PACT-4401

Author: mefellows

website/docs/docs/ai/index.md

@@ -12,7 +12,7 @@ PactFlow AI includes a suite of features to improve the efficiency and quality o
 * Generating Pact tests using various combinations of OpenAPI descriptions, code, or request-response pairs
 * Customizable prompts and test templates to tailor output to your specific needs
 * Seamless integration with PactFlow's Role-based Access Controls feature, enabling you to enforce and manage organizational policies
-* Code review (upcoming), enabling you to evaluate the quality of existing Pact tests and suggest best-practice improvements
+* Code review (beta), enabling you to evaluate the quality of existing Pact tests and suggest best-practice improvements
 
 PactFlow AI is available as a CLI and supports the following programming languages:
 

website/docs/docs/ai/using.md

@@ -353,6 +353,46 @@ This would instruct the test generation process to read the file content and use
 * Use the PactV4 interface
 ```
 
+### Reviewing Pact Tests
+
+Use the `pactflow-ai review` command to check an existing Pact test against best practices.
+
+:::note
+This feature is currently in beta. Supported languages include JavaScript and Java.
+:::
+
+```sh
+pactflow-ai review \
+  --test ./src/api.pact.spec.ts \
+  --code ./src/api.js \
+  --code ./src/product.js
+```
+
+#### Applying Changes
+
+By default, the review command provides feedback and suggested changes without modifying files.
+
+To apply the suggestions automatically, use the `--apply` flag:
+
+```sh
+pactflow-ai review \
+  --test ./test.js \
+  --code ./src.js \
+  --apply
+```
+
+The command requires a clean Git state to avoid introducing irreversible changes. If the file is not part of a Git repository, or if it has uncommitted or staged changes, the command will fail.
+
+To override this behavior, use one or more of the following flags:
+
+- `--allow-no-vcs` – Allow editing files not tracked in a Git repository.
+- `--allow-dirty` – Allow changes to files with uncommitted modifications.
+- `--allow-staged` – Allow changes to files with staged but uncommitted changes.
+
+:::tip
+Run `pactflow-ai review --help` to see all available options and usage examples.
+:::
+
 ## Best Practices
 
 ### 1. Check PactFlow's work