coulomb/mail-address-semantics
5
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Mail Address Semantics is a voluntary convention for naming people, actors and functions, and for addressing resources, facets, and optional interaction preferences through ordinary email addresses while keeping classification, authority, authentication, equivalence, and delivery implementation explicit and external to the address syntax.
43 commits 1 branch 0 tags 1.2 MiB
Find a file
tegwick 0a2d811444 MAS-WP-0005-T02: SCP-1 quoted local-parts equivalent on receipt 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 252470@bnt-lap001
Assistant-Session: ad628c8f-4be2-4979-94c9-76c7ed6f8241
2026-10-18 18:16:59 +02:00
deploy/railiance MAS-WP-0003-T06: lifetime cap on sent replies (300), discard Postfix bounces 2026-10-18 13:32:32 +02:00
docs MAS-WP-0005-T02: SCP-2 lower-case resource types (spec v0.1.1) 2026-10-18 18:08:36 +02:00
examples MAS-WP-0005-T03: match ticket ids case-insensitively (SCP-7) 2026-10-18 16:43:21 +02:00
experiments/postfix-probe Add railiance deploy manifests, mas.coulomb.social statute example, probe JSONL log + bind option 2026-10-11 20:22:37 +02:00
mas-v0.1-spec MAS-WP-0005-T02: SCP-1 quoted local-parts equivalent on receipt 2026-10-18 18:16:59 +02:00
mas_cli Implement MAS v0.1 reference experiment (MAS-WP-0002 M0-M8, M9 first pass) 2026-10-08 00:24:43 +02:00
mas_conformance MAS-WP-0005-T02: SCP-1 quoted local-parts equivalent on receipt 2026-10-18 18:16:59 +02:00
mas_core MAS-WP-0005-T02: SCP-1 quoted local-parts equivalent on receipt 2026-10-18 18:16:59 +02:00
mas_gateway MAS-WP-0005-T02: SCP-1 quoted local-parts equivalent on receipt 2026-10-18 18:16:59 +02:00
tests MAS-WP-0005-T02: SCP-1 quoted local-parts equivalent on receipt 2026-10-18 18:16:59 +02:00
workplans MAS-WP-0005-T02: SCP-1 quoted local-parts equivalent on receipt 2026-10-18 18:16:59 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-10-08 00:51:39 +02:00
.gitignore Register with State Hub; add MAS v0.1 spec bundle, intent and reference-experiment workplan 2026-10-08 00:14:14 +02:00
AGENTS.md Implement MAS v0.1 reference experiment (MAS-WP-0002 M0-M8, M9 first pass) 2026-10-08 00:24:43 +02:00
INTENT.md Register with State Hub; add MAS v0.1 spec bundle, intent and reference-experiment workplan 2026-10-08 00:14:14 +02:00
pyproject.toml Implement MAS v0.1 reference experiment (MAS-WP-0002 M0-M8, M9 first pass) 2026-10-08 00:24:43 +02:00
README.md Implement MAS v0.1 reference experiment (MAS-WP-0002 M0-M8, M9 first pass) 2026-10-08 00:24:43 +02:00
SCOPE.md Register with State Hub; add MAS v0.1 spec bundle, intent and reference-experiment workplan 2026-10-08 00:14:14 +02:00
WORK-RECORDS.md Refresh work records after sync 2026-10-08 01:08:20 +02:00

README.md

mail-address-semantics

Mail Address Semantics is a voluntary convention for naming people, actors and functions, and for addressing resources, facets, and optional interaction preferences through ordinary email addresses while keeping classification, authority, authentication, equivalence, and delivery implementation explicit and external to the address syntax.

This repo holds the normative MAS v0.1 bundle (mas-v0.1-spec/) and a Python reference experiment (see INTENT.md and workplans/MAS-WP-0002-*).

Parsing is local and deterministic. Discovery is networked. Policy is pure. Delivery remains external.

Layout

Path Role
mas_core/ parser, model, generator, statute (schema + semantic lint + inheritance), discovery, policy
mas_conformance/ Shared corpus: spec fixtures (vendored, drift-tested), property cases, statute cases
mas_cli/ mas parse / explain / discover / lint-statute / test
mas_gateway/ Generic inbound mail → MAS event → HTTP (pipe for MTAs, webhook for providers)
examples/statute/ Static /.well-known/mas for great-service.example + tiny server
examples/ticket_service/ Reference app proving create / correlate / closed / unknown
docs/experiment-review.md Milestone 9 findings

Quick start

uv venv && uv pip install -e '.[test]'
.venv/bin/pytest                       # full suite, offline
.venv/bin/mas test                     # conformance corpus
.venv/bin/mas explain 'ticket!callback@great-service.example' \
    --statute examples/statute/great-service.example/.well-known/mas
.venv/bin/mas lint-statute examples/statute/great-service.example/.well-known/mas

Local end-to-end run:

python examples/ticket_service/ticket_service.py --db /tmp/t.sqlite3 &        # :8025
mas-gateway --statute examples/statute/great-service.example/.well-known/mas \
    pipe --recipient 'ticket!callback@great-service.example' \
    --app-url http://127.0.0.1:8025/mas-events < message.eml
curl -s http://127.0.0.1:8025/outbox