docs: compound streaming-event-contract-residuals learning #15

fischer · 2026-07-01T13:53:46+08:00

fischer commented

2026-07-01 13:53:46 +08:00

Summary

Knowledge sedimentation (ce-compound Full mode) for PR #14's 4 residual findings (1 P1 + 3 P2) from ce-code-review of feat/ui-ue-enhancement.

Created

docs/solutions/integration-issues/streaming-event-contract-residuals.md — bug-track doc covering the 4-fix cluster: expert_step payload alignment, execute_stream CancellationToken registration, team_synthesis orphan milestone cleanup, synthesis_id dedup. Includes code examples, root cause analysis, and prevention strategies.

Updated

AGENTS.md — WebSocket Chat 协议 section expanded with streaming event types, synthesis_id dedup contract, and execute_stream cancellation contract.
CONCEPTS.md — Added 'Streaming Milestone' entry to Expert Orchestration cluster.

Overlap

MODERATE overlap with docs/solutions/runtime-errors/streaming-event-whitelist-and-accumulation.md (same area, different specific bugs). Flagged for potential consolidation via ce-compound-refresh.

Verification

Frontmatter validator: OK
No code changes (docs-only)

## Summary Knowledge sedimentation (ce-compound Full mode) for PR #14's 4 residual findings (1 P1 + 3 P2) from ce-code-review of feat/ui-ue-enhancement. ### Created - `docs/solutions/integration-issues/streaming-event-contract-residuals.md` — bug-track doc covering the 4-fix cluster: expert_step payload alignment, execute_stream CancellationToken registration, team_synthesis orphan milestone cleanup, synthesis_id dedup. Includes code examples, root cause analysis, and prevention strategies. ### Updated - `AGENTS.md` — WebSocket Chat 协议 section expanded with streaming event types, synthesis_id dedup contract, and execute_stream cancellation contract. - `CONCEPTS.md` — Added 'Streaming Milestone' entry to Expert Orchestration cluster. ### Overlap MODERATE overlap with `docs/solutions/runtime-errors/streaming-event-whitelist-and-accumulation.md` (same area, different specific bugs). Flagged for potential consolidation via ce-compound-refresh. ### Verification - Frontmatter validator: OK - No code changes (docs-only)

fischer added 1 commit 2026-07-01 13:53:46 +08:00

Test / backend-test (pull_request) Has been cancelled Details

Test / frontend-unit (pull_request) Has been cancelled Details

Test / api-e2e (pull_request) Has been cancelled Details

Test / frontend-e2e (pull_request) Has been cancelled Details

fe93b0f2a4 docs: compound streaming-event-contract-residuals learning

Knowledge sedimentation for PR #14's 4 residual findings (1 P1 + 3 P2)
from ce-code-review of feat/ui-ue-enhancement. ce-compound Full mode run.

Created:
- docs/solutions/integration-issues/streaming-event-contract-residuals.md
  Bug-track doc covering the 4-fix cluster: expert_step payload alignment,
  execute_stream CancellationToken registration, team_synthesis orphan
  milestone cleanup, synthesis_id dedup. Includes code examples, root cause
  analysis, and prevention strategies (streaming contract testing,
  cancellation registration checklist, terminal event symmetry, milestone
  identifier pattern).

Updated:
- AGENTS.md: WebSocket Chat 协议 section expanded with streaming event
  types (expert_step/expert_result_chunk/team_synthesis_chunk), synthesis_id
  dedup contract, and execute_stream cancellation contract.
- CONCEPTS.md: Added "Streaming Milestone" entry to Expert Orchestration
  cluster — the UI pattern for streaming progress indicators that transition
  through streaming → completed|error states, including orphan failure mode
  and synthesis_id matching semantics.

Overlap with existing docs/solutions/runtime-errors/streaming-event-whitelist-and-accumulation.md
is MODERATE (same area, different specific bugs). Flagged for potential
consolidation via ce-compound-refresh.

fischer merged commit ba0baabfcd into main

2026-07-01 13:53:47 +08:00

fischer referenced this issue from a commit

2026-07-01 13:53:48 +08:00

Merge PR #15: docs: compound streaming-event-contract-residuals learning

Sign in to join this conversation.

No reviewers

No Label

No Milestone

No project

No Assignees

1 Participants

Notifications

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: fischer/fischer-agentkit#15