From 2489e3215b8979b869b284aad6b537da07723886 Mon Sep 17 00:00:00 2001
From: Ed_ <edwardgz@gmail.com>
Date: Mon, 15 Jun 2026 11:21:58 -0400
Subject: [PATCH] docs(ai_client): add 2 follow-up notes for
 ai_loop_regressions_20260614

Adds 3 entries to the See Also section:
1. Gemini / Gemini CLI thinking-format compatibility (deferred from
   ai_loop_regressions_20260614) - investigate empirically
2. <think> (half-width) marker support in thinking_parser (deferred)
3. Public API Result Migration (planned, separate track public_api_migration_20260606)

Each entry links to the corresponding spec section for traceability.
---
 docs/guide_ai_client.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/guide_ai_client.md b/docs/guide_ai_client.md
index 6ba5fbde..6585e2a9 100644
--- a/docs/guide_ai_client.md
+++ b/docs/guide_ai_client.md
@@ -524,6 +524,9 @@ print(r.data)
 - **[guide_context_aggregation.md](guide_context_aggregation.md)** — The `aggregate.py` pipeline that produces the markdown the AI client sends
 - **[conductor/product.md](../conductor/product.md#multi-provider-integration)** — Product-level overview of providers
 - **[docs/reports/qwen_llama_grok_followup_audit_20260611.md](qwen_llama_grok_followup_audit_20260611.md)** — Audit of the parent track's gaps; follow-up track `qwen_llama_grok_followup_20260611` covers them
+- **Gemini / Gemini CLI thinking-format compatibility (deferred from `ai_loop_regressions_20260614`)** — the user's complaint included Gemini; the likely cause is a format mismatch between the Gemini SDK output and `parse_thinking_trace`. Empirically investigate by running a Gemini request that produces reasoning and inspecting the raw `resp.text`. See [spec §13.1](../conductor/tracks/ai_loop_regressions_20260614/spec.md#131-gemini--gemini-cli-thinking-format-compatibility-deferred).
+- **`<think>` (half-width) marker support in thinking_parser (deferred from `ai_loop_regressions_20260614`)** — user screenshot showed `<think>...</think>` format; current `parse_thinking_trace` requires `<thinking>`. The change is small (~3 lines in `src/thinking_parser.py:9`). See [spec §13.2](../conductor/tracks/ai_loop_regressions_20260614/spec.md#132-think-half-width-marker-support-deferred).
+- **Public API Result Migration (planned, separate track `public_api_migration_20260606`)** — the 5 production + 63 test call sites not migrated in this track; the follow-up removes the deprecated `ai_client.send()`. See [parent track spec](../conductor/tracks/data_oriented_error_handling_20260606/spec.md) §12.1.
 
 ---