Skip to content

feat(tools/mail-source/mailman3): add Mailman 3 / Hyperkitty archive backend #306

Description

@potiuk

Add a new tools/mail-source/mailman3/ adapter implementing the mail-source contract against a public Mailman 3 archive (the Hyperkitty UI + the underlying Mailman REST API).

Operations to claim:

  • list_recent_threads(list, since) — Hyperkitty exposes /list/<list>@<domain>/latest and per-month archives in machine-readable form
  • read_thread(thread_id) — Hyperkitty thread page is keyed by thread root Message-ID
  • thread_url(thread_id) — Hyperkitty URL by Message-ID hash
  • thread_id_kind: rfc5322-message-id (matches IMAP + mbox)

Drafts / sent / write ops are unsupported — same shape as the PonyMail adapter (archive viewer only, no outbound).

Why: Hyperkitty is the standard archive UI for Mailman 3, which is what Python uses (mail.python.org), Fedora (lists.fedoraproject.org), Mailman itself, NumPy/SciPy mailing lists, the GNU project, Plone, and many smaller OSS projects. It's the non-ASF equivalent of PonyMail. Without it, every non-ASF adopter that lives on Mailman 3 is forced into Gmail-only territory.

Reference:

Activity

  1. added
    enhancementNew feature or request
    capability:platformFramework / agent substrate skills (install, verify, doctor, override, status, setup bootstrap)
    on May 26, 2026
  2. added a commit that references this issue on Oct 5, 2026
    6d388cf
  3. added 2 commits that reference this issue on Oct 5, 2026
    cad4dbb
    78032a9
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    capability:platformFramework / agent substrate skills (install, verify, doctor, override, status, setup bootstrap)contract:mail-sourceTool capability: inbound-mail ingestion (mbox / IMAP / ...)enhancementNew feature or requestfamily:docsDocs, MISSION.md, READMEsfamily:setupsetup-* skillsfamily:toolstools/*good first issueGood for newcomers

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions