docs: drop the preview designation from the trace surface

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [Unreleased]
+
+### Changed
+
+- Dropped the "preview" designation from `retrieveTrace` and `ScaniiTraceResult`.
+  The trace endpoint is no longer marked preview in the v2.2 contract; the method
+  itself is unchanged.
+
 ## [8.4.0] — 2026-08-29
 
 ### Added

README.md

@@ -46,7 +46,7 @@ System.out.printf("findings: %s%n", result.getFindings());
 | `retrieve(String id)` | Retrieve previous scan result |
 | `delete(String id)` | Delete a previous scan result |
 | `deleteTrace(String id)` | Delete the processing trace for a previous scan result |
-| `retrieveTrace(String id)` | Retrieve ordered processing events for a result (preview) |
+| `retrieveTrace(String id)` | Retrieve ordered processing events for a result |
 | `fetch(String location)` | Server-side async fetch-and-scan of a remote URL |
 | `ping()` | Health check |
 | `createAuthToken(int timeout, TimeUnit unit)` | Mint short-lived auth token |

src/main/java/com/scanii/ScaniiClient.java

@@ -154,9 +154,6 @@ public interface ScaniiClient {
    * Retrieves the processing trace for a previously processed file.
    * Returns an ordered list of events describing each stage of the processing pipeline.
    *
-   * <p><strong>Preview:</strong> the trace endpoint is marked preview in the v2.2 spec —
-   * the API surface may shift before it is marked stable.
-   *
    * @param id id of the previously processed content
    * @return optional {@link ScaniiTraceResult}, empty if the id is not found
    * @see <a href="https://scanii.github.io/openapi/v22/">spec</a>

src/main/java/com/scanii/models/ScaniiTraceResult.java

@@ -8,9 +8,6 @@
  * Result of a {@link com.scanii.ScaniiClient#retrieveTrace(String)} call,
  * containing an ordered list of processing events for a given processing id.
  *
- * <p><strong>Preview:</strong> the trace endpoint ({@code GET /v2.2/files/{id}/trace})
- * is marked preview in the v2.2 spec — the API surface may shift before it is marked stable.
- *
  * @see <a href="https://scanii.github.io/openapi/v22/">spec</a>
  */
 public class ScaniiTraceResult extends ScaniiResult {