Private
Public Access
0
0

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.
This commit is contained in:
2026-06-15 18:58:16 -04:00
parent b37a095b14
commit 33fcedefc7
+6 -7
View File
@@ -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()`.
</new_content>
## Testing Requirements