AGENTS.md: align purpose and spec-bundle notes with INTENT/SCOPE phase 2

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:12:16 +02:00
parent 1ba7379590
commit 0c7ed5f46f

View file

@ -2,7 +2,7 @@
## Repo Identity
**Purpose:** Mail Address Semantics (MAS) v0.1 reference implementation: parser, statute discovery, pure policy, CLI, mail gateway and reference ticket service.
**Purpose:** Mail Address Semantics (MAS) reference implementation and spec workbench (v0.1.1, v0.2 draft): parser, statute discovery, pure policy, generator, CLI, mail gateway, reference ticket service and Postfix integration profile. See INTENT.md (phase 2) and SCOPE.md.
**Domain:** communication
**Repo slug:** mail-address-semantics
@ -97,13 +97,15 @@ curl -s -X PATCH "http://127.0.0.1:8000/tasks/<task_id>" \
```bash
uv venv && uv pip install -e '.[test]' # install (only runtime dep: jsonschema)
.venv/bin/pytest # full suite; offline apart from loopback fixture servers
.venv/bin/pytest # full suite; offline apart from loopback fixtures; Postfix probe needs Docker
.venv/bin/mas test # shared conformance corpus only
```
`mas-v0.1-spec/` is the normative bundle. `mas_conformance/addresses.json` and
`mas_core/schema/` are vendored copies, and tests fail if they drift from the
bundle. Keep the boundaries: the parser does no I/O, policy is pure, and only
`mas-v0.1-spec/` (v0.1.1) and `mas-v0.2-spec/` (draft) are the normative
bundles. `mas_conformance/addresses.json`, `mas_conformance/statute_aware.json`
and `mas_core/schema/` are vendored copies, and tests fail if they drift from
the bundles. Spec changes need evidence, bundle fixtures and a `mas_core`
implementation; record them in `docs/spec-change-proposals.md`. Keep the boundaries: the parser does no I/O, policy is pure, and only
`mas_core/discovery.py` touches the network.
## Session Protocol