INTENT/SCOPE: mode reference implementation (handoff semantics for P2, email master/slave roles, callback stub, reuse surface)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 5787@bnt-lap001
Assistant-Session: 5db26b82-138b-40cc-9856-4d5eb0f752fd
This commit is contained in:
tegwick 2026-10-19 10:35:56 +02:00
parent 0c7ed5f46f
commit 55ea04f65d
2 changed files with 146 additions and 14 deletions

View file

@ -41,12 +41,22 @@ delivery stays external.
tested against a real Postfix by `experiments/postfix-probe/` and
`tests/test_postfix_profile.py` (needs Docker). Exim: notes only
(`integrations/exim/NOTES.md`).
- **Mode reference implementation** (new; INTENT.md, *Mode reference
implementation*). A language-neutral mode contract (handoffs, statuses,
timeouts, master/slave roles, outside-master commands) with JSON schemas
and fixtures. The email side implements both roles: master per resource
type, or slave to an outside master that issues case ids. Test stubs: a
scripted callback mode and a fake outside master. Email is the only real
channel.
- **Live test environment.** `deploy/railiance/`: the MX for
`mas.coulomb.social`, with replies through Scaleway TEM capped at 300.
It is temporary; MAS-WP-0007 retires it.
## Out of Scope
- Real non-email modes (telephony, chat, SMS, video), connectors to real
CMS or ticketing products, and the multimodal framework itself. Other
modes exist here only as contract-speaking test stubs.
- Implementations in other languages (TypeScript, Go), until a second
consumer exists. That is also the gate for declaring v0.2 final
(MAS-WP-0009).
@ -72,6 +82,9 @@ delivery stays external.
MAS-WP-0009 (declare v0.2 final; waits for a second implementation or
deployment).
- v0.2 stays a draft (founder, 2026-10-19).
- P2 is decided: `!MODE` requests a handoff, defined by the mode contract
(founder, 2026-10-19). The mode contract and stubs are not started yet;
they need a workplan.
- The live `mas-mx` pod runs an image built before the profile refactor.
- Tests: `.venv/bin/pytest` runs 199 tests, offline apart from loopback
fixtures and the Docker probe.