MIT suits software better than CC BY (Creative Commons advises against its licenses for code). Copyright Phil Skentelbery 2025-2026. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
11 KiB
StarPunk Backlog
Last Updated: 2026-11-03 (current release: v2.11.0)
These are the open features and bugs, sorted by priority. Each item was checked against the code
at v2.11.0. Work that has shipped is listed per release in vX.Y.Z/RELEASE.md and in
CHANGELOG.md.
Priority Levels
- Critical - Items that break existing functionality
- High - Security, data-integrity or correctness bugs; important features
- Medium - Planned features and spec gaps with visible effect
- Low - Nice-to-have, minor spec deviations, deferred ideas
Critical
No critical items
High
None open.
Medium
Admin editor cannot clear all tags
- Description: When a note is saved with an empty tag field, the route passes
tags=None.update_notetreats that as "unchanged", so the last tags can't be removed from the editor. - Where:
starpunk/routes/admin.py(edit POST:tags=tags if tags else None),starpunk/notes.py(update_note) - Source: Old backlog (v1.3.0 follow-up); still present
Media captions not escaped in RSS HTML
- Description: The RSS description embeds
<img alt="{caption}">without escaping the caption. A caption containing"or<breaks the item's HTML. - Where:
starpunk/feeds/rss.py(two places, ~lines 136 and 277) - Source: Old backlog (Architect Review 2.2.10); still present
No rate limiting on upload endpoints
- Description: Media uploads (
/admin/newand the Micropub media endpoint) have no rate limit. Both require authentication, so the risk comes from a leaked token or session. - Where:
starpunk/routes/admin.py,starpunk/routes/micropub.py - Source: Old backlog (Architect Review security assessment); still present
Micropub: more updatable properties
- Description:
addworks only forcategoryandphoto.published,syndicationandlocationcan't be updated. - Where:
starpunk/micropub.py - Source:
docs/design/v2.9.0/2026-11-03-micropub-review.md(Kept as is)
Micropub: insufficient_scope returns 403
- Description: StarPunk follows RFC 6750 and returns 403, but the Micropub spec's error table says 401. Choose one: keep 403 and document why, or switch to 401.
- Where:
starpunk/micropub.py,starpunk/routes/micropub.py - Source:
docs/design/v2.9.0/2026-11-03-micropub-review.md(Kept as is)
Webmentions with status error are never retried
- Description: When a received webmention fails unexpectedly or temporarily, it is stored as
error. It is never processed again unless the sender sends it again. Add a limited number of retries with backoff. - Where:
starpunk/webmention_worker.py - Source:
docs/design/v2.7.0/2026-11-03-webmention-spec-compliance.md(Known limits)
IndieAuth scope handling
- Description: The metadata's
scopes_supportedomitsdraft, though Micropub honours it and the consent screen grants it. Requested scopes aren't filtered, so unknown scopes are granted (and have no effect). - Where:
starpunk/indieauth.py,starpunk/routes/indieauth.py - Source: Documentation refresh 2026-11-03
Webmention source DNS failures are permanent
- Description: A DNS failure while fetching a webmention source becomes
ValueErrorand marks the mention invalid/error without retry; the WebSub worker now retriesResolutionError. Treat it as transient here too. - Where:
starpunk/webmention_processor.py,starpunk/webmention_worker.py - Source: v1.6.0 design reconstruction (docs/design/v1.6.0/background-worker.md)
Atom and JSON Feed not linked from pages
- Description:
base.htmladvertises only/feed(as RSS) and OPML withrel=alternate; add<link rel="alternate">for/feed.atomand/feed.jsonso readers can pick a format. - Where:
templates/base.html - Source: Documentation refresh 2026-11-03
Backfeed responses to crossposts
- Description: Idea: bring likes, boosts and replies to StarPunk's own crossposts back to the note as responses. Two options: poll GoToSocial (the token would need a
readscope), or rely on Bridgy, which sends webmentions. Since v2.8.0, StarPunk ignores webmentions from a note's own crossposts, so that rule would need to change to work with Bridgy. - Where:
starpunk/syndication.py,starpunk/webmention_worker.py - Source: v2.8.0 microformats2 review discussion
Tag-filtered feeds
- Description: Tag pages are h-feeds and WebSub topics, but there are no RSS, Atom or JSON feeds per tag (for example
/tag/python/feed.atom). Tag pages also have no pagination, and the editor has no tag autocomplete. - Where:
starpunk/routes/public.py,starpunk/feeds/,templates/admin/ - Source: Old backlog (Tag enhancements)
Low
Micropub: location / checkin ignored
- Description: These properties are accepted but dropped, which spec 3.3.5 allows.
- Where:
starpunk/micropub.py - Source:
docs/design/v2.9.0/2026-11-03-micropub-review.md
Micropub: video and audio unsupported
- Description:
videoandaudioare refused with 400 (UNSUPPORTED_MEDIA). Supporting them would need upload handling, HTML5 embedding, Media RSS and possibly podcast feeds (see ADR-059). - Where:
starpunk/micropub.py,starpunk/media.py - Source:
docs/design/v2.9.0/2026-11-03-micropub-review.md; old backlog (Audio/Podcast, Video)
Micropub: GET access_token query parameter accepted
- Description: Tokens sent in the URL end up in logs and proxies. Consider refusing them.
- Where:
starpunk/micropub.py(extract_bearer_token) - Source:
docs/design/v2.9.0/2026-11-03-micropub-review.md
Person tags (p-category h-card) unsupported
- Description: h-card objects in
categoryare silently ignored. - Where:
starpunk/micropub.py, templates - Source:
docs/design/v2.8.0/2026-11-03-microformats2-review.md(Not done)
Reply-context h-cite lacks author h-card, name and published
- Description: The
u-in-reply-to h-citeshows the cached author name as plain text. It has nop-author h-card,p-nameordt-published. - Where:
templates/note.html,starpunk/reply_context.py - Source:
docs/design/v2.8.0/2026-11-03-microformats2-review.md(Not done)
Photo alt falls back to "Image"
- Description: A photo-only post with no caption still gets
alt="Image". - Where:
templates/partials/media.html - Source:
docs/design/v2.8.0/2026-11-03-microformats2-review.md(Not done)
Old webmentions lack source details
- Description: Webmentions received before migration 014 keep NULL source details (the original post's URL and published time) until they are re-validated. A one-off re-validation would fill them in.
- Where:
starpunk/webmention_worker.py, migration 014 - Source:
docs/design/v2.8.0/2026-11-03-microformats2-review.md(Not done)
Homepage webmentions refused
- Description: Mentions of the home page are refused with 400. They are not stored or shown anywhere.
- Where:
starpunk/routes/webmention.py - Source:
docs/design/v2.7.0/2026-11-03-webmention-spec-compliance.md(Known limits)
Webmention discovery ignores HTTP cache headers
- Description: Endpoint discovery doesn't apply HTTP caching (spec 5.3). Targets are only fetched when a note is created, edited or deleted, so the extra cost is small.
- Where:
starpunk/webmention_sender.py - Source:
docs/design/v2.7.0/2026-11-03-webmention-spec-compliance.md(Known limits)
410 tombstone page has no microformats
- Description: The "This post has been deleted" page is a generic error page. It could include an
h-entrywith the post's URL and deletion state. - Where:
templates/410.html - Source:
docs/design/v2.7.0/2026-11-03-webmention-spec-compliance.md(Known limits)
Slow and previously flaky tests
- Description:
tests/test_migration_race_condition.pytakes about 5 minutes. 8 tests were flaky or failing until v2.7.1. Speed them up (mock the waits) or mark them slow so the default test run stays fast. - Where:
tests/test_migration_race_condition.py - Source: v2.7.1 release; ADR-012
Animated WebP not detected
- Description: Animated GIFs are detected and handled; animated WebP is not.
- Where:
starpunk/media.py - Source: Old backlog (Architect Review 2.2.2); still present
MAX_DIMENSION not configurable
- Description:
MAX_DIMENSION = 12000is a constant. - Where:
starpunk/media.py - Source: Old backlog (Developer Review M4)
N+1 queries on secondary pages
- Description: Tag pages and a few single-note views load media one note at a time. Load it in batches if this becomes a problem.
- Where:
starpunk/routes/public.py(tag page),starpunk/routes/admin.py,starpunk/models.py,starpunk/tags.py - Source: Old backlog (v1.5.0 scoping)
Unused settings and legacy tables
- Description:
NOTES_PATHis read and its folder created, but notes are always written underDATA_PATH/notes.SITE_AUTHORis required but shown nowhere.INITIAL_SCHEMA_SQLrecreates the unusedtokensandauthorization_codestables (dropped by migration 004) on every start, andauth_stateis unused. Version fallbacks are stale (author_discovery.py"1.2.0",base.html"0.5.0"). - Where:
starpunk/config.py,starpunk/utils.py,starpunk/database/schema.py,starpunk/author_discovery.py,templates/base.html - Source: Documentation refresh 2026-11-03 (docs/architecture/database.md, deployment.md)
Media library and crosspost settings UI
- Description: There is no admin page to browse or delete media, and crosspost targets can only be configured through environment variables.
- Where:
starpunk/routes/admin.py - Source: Old backlog (Media enhancements, POSSE configuration UI)
Deferred indefinitely
- Static site generation (conflicts with Micropub)
- Multi-language UI, advanced analytics, WYSIWYG editor, mobile app
- Comments system (webmentions cover it)
- CDN integration, gallery views
Done since the last update (2025-12-17)
These items were removed from the backlog because they have shipped:
-
LICENSE: MIT, copyright Phil Skentelbery 2025-2026 (2026-11-03)
-
v2.11.0: SQLite foreign keys enforced (orphans cleaned up by migration 018); CSRF tokens on admin, logout and consent forms; IndieAuth client and crosspost link-card fetches moved onto the SSRF-safe fetcher;
FLASK_DEBUG/FLASK_ENVdefault to off/production; rate limits shared by all processes (and old windows pruned, so the webmention limiter no longer grows); dependencies upgraded (Python 3.14, no known vulnerabilities); stalecompose.yaml, duplicatedev_auth.pyandtest.iniremoved or fixed;lxml/python-dateutilpinned,pytestout of the runtime requirements -
POSSE: GoToSocial (v2.1.0), Bluesky (v2.2.0), Threads (v2.6.0)
-
Webmentions: receive, send, display and moderation (v1.6.0); fixed and made spec-compliant in v2.6.8–v2.7.2
-
Reply contexts, replies, likes, reposts and bookmarks (v2.4.0, v2.5.0, v2.9.0)
-
Photo posts without text (v2.6.5); thumbnails and image variants (v1.4.0)
-
PKCE for IndieAuth login: replaced by OIDC admin login with PKCE (v2.0.0, ADR-064)
-
HEIC conversion quality: no longer hardcoded; HEIC images now go through the normal optimisation tiers
-
media.pymodule docstring now says 12000px -
Fresh feeds and push updates: WebSub (v2.10.0, v2.10.1)