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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user