micropub: Micropub extensions roadmap (maturity-grouped)

[davidwkeith]

Tracking issue for adopting the IndieWeb Micropub extensions in @dwk/micropub.

The wiki organizes extensions into three maturity groups — official (adopted into the spec), stable (widely implemented and settled), and proposed (experimental). @dwk/micropub mirrors that model: each extension is tagged with its group and only advertised/honoured when that group is enabled, via the extensions config ({ official?, stable?, proposed? }; defaults official+stable on, proposed off).

Stable — implemented ✅ (this increment)

• Post Status (post-status: published/draft) — validated on create/update
• Visibility (visibility: public/unlisted/private) — validated; stored & advertised only, read-time enforcement is the serving layer's job
• Supported Vocabulary (post-types in q=config via postTypes config)
• Category/Tag List (q=category) with Limit (limit) and Filter (filter)
• Slug (mp-slug) — pre-existing, always on
• Destination (mp-destination) — declined: our model is one Worker = one site with a single-user me binding, so multi-destination has no meaning unless that changes

Stable — tracked separately

• Query for Post List (q=source with no url) + offset pagination — micropub: q=source list query (no url param) for client post browsing #351 / feat(micropub): add q=source list query (offset pagination) #353 (implemented)

Proposed — off by default, roadmap

• Location/Venue (q=geo) — implemented in feat(micropub): implement q=geo Location/Venue extension #372 (contract designed in micropub: design proposed location/venue (q=geo) extension #359, spec in docs(micropub): define location venue query #366): D1 venue store, live routing, proximity search
• Contacts (q=contact) — implemented in feat(micropub): add proposed contacts extension #368 (design in micropub: design proposed contacts (q=contact) extension #360)
• Audience (audience) / Location Visibility (location-visibility) — implemented in feat(micropub): add audience and location visibility #365 (design in micropub: design proposed audience and location-visibility extensions #361)
• Richer query filters — Offset, After/Before, Order, Post-Type, Post-Status/Visibility filters, Property Exists/Value — implemented in feat(micropub): add richer source list filters #367 (design in micropub: design proposed richer q=source list filters #362)
• Media-endpoint extensions — Delete from Media Endpoint (action=delete, + package-defined undelete), q=source for media (listing + by-URL), and the upload response body ({ "url": ... }) — implemented in feat(micropub): implement proposed media-endpoint extensions #375 (design in micropub: design proposed media-endpoint extensions #363 / docs(micropub): design proposed media-endpoint extensions #374)

Notes

• Serving-layer boundary: @dwk/micropub stores and advertises post-status/visibility; it does not itself gate reads. Hiding drafts and access-controlling private posts belong to the consuming site (or WAC in @dwk/solid-pod).
• DPoP posture is unchanged by any of this: the default bearer-only micropub.rocks flow still can't authenticate; extensions improve real-client capability, they don't move the conformance bar.

See spec/packages/micropub.md § "Micropub extensions" for the authoritative requirements.

[davidwkeith]

Reviewed the roadmap against main (through #370) and the design/implementation sub-issues (#351, #359–#363). Refreshed the checklist above to match reality:

Done since this issue was opened:

• Query for Post List (micropub: q=source list query (no url param) for client post browsing #351/feat(micropub): add q=source list query (offset pagination) #353) ✅
• Contacts (q=contact, micropub: design proposed contacts (q=contact) extension #360 design → feat(micropub): add proposed contacts extension #368 implementation) ✅
• Audience / Location Visibility (micropub: design proposed audience and location-visibility extensions #361 design → feat(micropub): add audience and location visibility #365 implementation) ✅
• Richer q=source list filters (micropub: design proposed richer q=source list filters #362 design → feat(micropub): add richer source list filters #367 implementation) ✅

Not ready to close — two items still outstanding:

1. Location/Venue (q=geo) — design closed in micropub: design proposed location/venue (q=geo) extension #359 and documented in docs(micropub): define location venue query #366, but there's no venue store or live routing yet; spec/packages/micropub.md explicitly flags q=geo as unimplemented and points back to this issue.
2. Media-endpoint extensions (action=delete, media q=source, response-format) — the design sub-issue micropub: design proposed media-endpoint extensions #363 is still open, no implementation has started.

Recommend keeping this issue open as the roadmap tracker until #363 closes and a q=geo implementation PR lands (a follow-up "implement q=geo" issue may be worth opening alongside #363, since #359 only covered the design). No code changes were needed for this review — it was a status audit only.

---

Generated by Claude Code

[davidwkeith]

Roadmap complete 🎉 — every extension in the tracking list is now implemented (or explicitly declined, for mp-destination):

• Stable group: post-status, visibility, supported vocabulary, category/tag list (+limit/filter), slug, and the post list with offset pagination (micropub: q=source list query (no url param) for client post browsing #351/feat(micropub): add q=source list query (offset pagination) #353).
• Proposed group (off by default behind extensions.proposed): Contacts (feat(micropub): add proposed contacts extension #368), Audience / Location Visibility (feat(micropub): add audience and location visibility #365), richer source-list filters (feat(micropub): add richer source list filters #367), Location/Venue q=geo (feat(micropub): implement q=geo Location/Venue extension #372), and the media-endpoint extensions — media q=source, upload response body, and recoverable action=delete/undelete (feat(micropub): implement proposed media-endpoint extensions #375, design micropub: design proposed media-endpoint extensions #363/docs(micropub): design proposed media-endpoint extensions #374).

spec/packages/micropub.md § "Micropub extensions" documents everything as implemented; checkboxes above updated to match.

🤖 Generated with Claude Code