docs: ai updates (#377)

1. Add additional languages
2. Add test templates killercoda tutorial

PACT-4122

Author: mefellows

website/docs/docs/ai/index.md

@@ -16,8 +16,10 @@ PactFlow AI includes a suite of features to improve the efficiency and quality o
 
 PactFlow AI is available as a CLI and supports the following programming languages:
 
-* Java
-* JavaScript / TypeScript
-* Golang (coming soon)
-* .NET (coming soon)
+* Java and Kotlin
+* TypeScript / JavaScript
+* .NET
+* Golang
+* PHP
+* Swift
 * Python (coming soon)

website/docs/docs/ai/using.md

@@ -335,21 +335,22 @@ To provide specific updates or constraints for the test generation, use a concis
 
 `--instructions "Include the 'X-HMAC-SIGNATURE' header in all GET requests (format: 'SHA256-HMAC-SIGNATURE: {sig}')"`
 
-Alternatively, you can load instructions from a file `--instructions /path/to/instructions.txt`
+Alternatively, you can load instructions from a file `--instructions @/path/to/instructions.txt`
 
 This would instruct the test generation process to read the file content and use it as the instruction.
 
 **Example:**
 
 `prompts.txt`:
 ```
+* Make sure to cover happy and non-happy paths
+  * Specifically, ensure to include test cases for the positive (HTTP 200) scenario and negative scenarios, specifically the case of 400, 401 and 404
+* Only include endpoints/properties used by the API client - do not include additional fields in the OAS that are not in the client code
+  * You can check the properties used in the Product class to help make this determination
 * Use the Jest testing framework
 * Use the native Jest expect (https://jestjs.io/docs/expect) matchers such as `toEqual` and `toBeTruthy`
 * Prefer the use of the async/await pattern when using Promises
-* Use a 3 level hierarchy for tests
-  1. Level 1 should be the API under test as a `describe` block e.g. "Product API"
-  2. Level 2 should be the endpoint as a `describe` block e.g. "GET /products/:id", "POST /products"
-  3. Level 3 should be the scenario as a `test` block e.g. "Given a valid user, returns a 200", "Given an invalid user, returns a 400"
+* Use the PactV4 interface
 ```
 
 ## Best Practices

website/docs/docs/tutorials.md

@@ -44,15 +44,15 @@ You will:
 | Node JS  | <https://killercoda.com/pactflow/scenario/pactflow-getting-started-js>   |
 | Java     | <https://killercoda.com/pactflow/scenario/pactflow-getting-started-java> |
 
-## Generating Tests with PactFlow's AI-Augmented Contract Testing Capabilities
+## Generate Tests with AI-Augmented Contract Testing in PactFlow
 
 _Level: Beginner_
 
 In this tutorial, we guide you through creating a consumer Pact test with the help of PactFlow's Test Generation capability, featuring HaloAI.
 
 You will download and setup the CLI tool, and generate consumer Pact tests for a JavaScript codebase.
 
-Read more about our [test generation feature](https://pactflow.io/ai/), or check out our documentation [here](https://docs.pactflow.io/docs/ai).
+[Learn more about Test Generation](https://docs.pactflow.io/docs/ai).
 
 ### Goals
 
@@ -74,6 +74,26 @@ You will:
 | -------- | ---------------------------------------------------------------------- |
 | Node JS  | <https://killercoda.com/pactflow/scenario/pactflow-ai>   |
 
+## Use Test Templates with AI-Augmented Contract Testing in PactFlow
+
+_Level: Beginner_
+
+This tutorial introduces the **Test Templates** feature and shows you how to use it with PactFlow’s AI-powered **Test Generation** capability, powered by **HaloAI**.
+
+[Learn more about Test Templates](https://docs.pactflow.io/docs/ai).
+
+### What You'll Learn
+
+1. How to create and apply a template file to generate Pact tests
+2. How templates help align generated tests with your existing test suite
+3. How to improve test output—such as adding edge case coverage—by refining your prompts
+
+### Tutorial
+
+| Language | Link                                                                   |
+| -------- | ---------------------------------------------------------------------- |
+| Node JS  | <https://killercoda.com/pactflow/scenario/pactflow-ai-test-templates>  |
+
 ## Gating deployments with PactFlow
 
 _Level: Intermediate_