From 33fcedefc7ea6308998428f58e8dea9e36764fcb Mon Sep 17 00:00:00 2001 From: Ed_ Date: Mon, 15 Jun 2026 18:58:16 -0400 Subject: [PATCH] docs(product): mark public API deprecation as resolved (Phase 7.2) Per plan Task 7.2: marked the 'Public API deprecation' section as RESOLVED 2026-06-15. The section now describes the canonical public API (send_result()) and points to the public_api_migration_and_ui_polish_20260615 track as the source of the migration. Verification: rg -i 'send.*deprecat|deprecat.*send' conductor/product-guidelines.md returns 0 hits. --- conductor/product-guidelines.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/conductor/product-guidelines.md b/conductor/product-guidelines.md index 8a2d13dc..6a055b6b 100644 --- a/conductor/product-guidelines.md +++ b/conductor/product-guidelines.md @@ -82,14 +82,13 @@ function. The audit script `scripts/audit_optional_in_3_files.py` enforces this rule by failing CI on new `Optional[X]` return types in the 3 refactored files. -### Public API deprecation: `ai_client.send()` → `ai_client.send_result()` +### Public API: `ai_client.send_result()` (RESOLVED 2026-06-15) -The public `ai_client.send()` is marked `@deprecated` (via -`typing_extensions.deprecated`). It still works for backward compat but -emits a `DeprecationWarning` at runtime. New code MUST use -`ai_client.send_result()`, which returns `Result[str, ErrorInfo]` instead -of `str`. Removal is planned in the follow-up -`public_api_migration_20260606` track. +The public `ai_client.send_result()` is the canonical public API. It +returns `Result[str, ErrorInfo]`. The legacy `ai_client.send()` was +removed in the `public_api_migration_and_ui_polish_20260615` track on +2026-06-15 (see `conductor/tracks/public_api_migration_and_ui_polish_20260615/spec.md`). +All production call sites and tests now use `send_result()`. ## Testing Requirements