Skip to content

Spec v0.3: document the ISO ts requirement on escalation_to_human - #2

Merged
ciopulse merged 1 commit into
mainfrom
docs/spec-v03-escalation-ts
Sep 23, 2026
Merged

ciopulse merged 1 commit into
mainfrom
docs/spec-v03-escalation-ts

Conversation

@ciopulse

Copy link
Copy Markdown
Owner

Handover v4 made the mock reject an escalation_to_human event without a valid ISO ts, but the spec only showed the field in an example. That left the reference implementation stricter than the published contract — the same defect v4 fixed, pointing the other way. Spec and CHANGELOG only; the mock, the forwarder and the contract version are unchanged.

Spec (docs/send-a-copy-spec-v0.3.md)

  • The events[] row now states the requirement: an escalation_to_human event requires a valid ISO 8601 ts with timezone; other event types need only type, and any ts present must be ISO 8601.
  • The actor-fallback sentence (in the turns[].actor row, where it lives) gains one sentence explaining that the fallback has no other anchor, so such an event without a valid ts is rejected with a field-level 400.
  • A separate, dated correction note, kept apart from the 21 Sep documentation-only one and labelled as a tightening.

CHANGELOG

  • New ### Changed subsection between ### Documentation and ### Fixed, carrying the new spec bullet and the existing mock ts bullet moved out of ### Fixed. The four genuine documentation corrections stay under ### Fixed.

54 tests pass locally.

🤖 Generated with Claude Code

The mock receiver has rejected an escalation_to_human event without a valid
ISO ts since 22 Sep, but the spec only showed the field in an example, leaving
the reference implementation stricter than the published contract. The payload
table now states the requirement, the actor-fallback wording says why it is
enforced, and a dated note records it as a tightening rather than a
documentation-only correction. The mock, the forwarder and the contract
version are unchanged.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@ciopulse
ciopulse merged commit 1663063 into main Sep 23, 2026
2 checks passed
@ciopulse
ciopulse deleted the docs/spec-v03-escalation-ts branch September 23, 2026 07:03
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.

1 participant