Skip to content

docs: provider output lifecycle + slim design.md §5.2 - #93

Merged
qiankunli merged 1 commit into
mainfrom
docs/provider-output-lifecycle
Jul 13, 2026
Merged

docs: provider output lifecycle + slim design.md §5.2#93
qiankunli merged 1 commit into
mainfrom
docs/provider-output-lifecycle

Conversation

@qiankunli

Copy link
Copy Markdown
Collaborator

新增 docs/provider-output-lifecycle.md,作为 user-input-lifecycle.md 的对偶,承载 adapter 协议输出/感知侧的专项设计:事件归一、终态收口、丢事件/乱序自愈、静默悬挂对账(reconcile)。

改动

  • 新增 docs/provider-output-lifecycle.md:理念/主流程/能力表/重点场景(S1 静默悬挂盲区、S2 自愈、S3 observed turn 投影)/收敛方向(stall + 可选 reconcile)/代码锚点。
  • 精简 docs/design.md §5.2:把易随 provider schema 变化的三列原生映射大表收成「原则 + 统一词汇 + 指针」(净 −11 行),细节下沉到新文档,与 §3 用户输入节"不复制易变矩阵"的处理对称。
  • 索引 AGENTS.md(代码地图 + References)、docs/provider-interaction-design.md(输入/输出对偶说明)各加指针。

说明

  • 相交处(终态契约 §4.1 / 事件模型 §4.8 / error §4.9 / reduce 不变量 §4.10)一律引用 interaction-design 不复述,保持"结构契约在 interaction-design、感知行为在 output-lifecycle"的分工。
  • 纯文档,无代码依赖。§5 的 reconcile 落地代码在另一个 PR(stall observation + reconcile)。

🤖 Generated with Claude Code

New docs/provider-output-lifecycle.md tracks the provider output/perception
side of the adapter protocol: event normalization, terminal-state closure,
dropped-event self-heal, and the silent-hang reconcile design. It is the dual
of user-input-lifecycle.md.

Slim design.md §5.2's per-provider mapping table into principle + pointer
(the volatile native-mapping detail moves into the new doc's capability
table). Wire references in AGENTS.md and provider-interaction-design.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants