Files
StarPunk/docs/projectplan/v1.3.0/RELEASE.md
T
PhilandClaude Opus 5.5 ceef048003 docs: documentation review for v2.14.0
Architecture, README, standards, CLAUDE.md, settings reference, indexes,
backlog, release plans and CHANGELOG checked against the code at v2.14.0:
backfeed, notifications, counts line and web actions documented; test
policy (changed area locally, full suite in CI); stale versions, statuses
and links fixed; legacy and superseded docs moved.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 14:51:57 -07:00

2.0 KiB

StarPunk v1.3.0 Release

Status: Released 2025-12-10 Codename: "Categories" Branch: feature/v1.3.0-tags-microformats Approved: 2025-12-10

Features

Tag/Category System (Complete)

  • Database schema for tags (migrations/008_add_tags.sql)
  • Tag management module (starpunk/tags.py)
  • Micropub category property support
  • Admin interface for tag editing
  • Tag archive pages (/tag/<tag>)
  • p-category microformats2 markup with rel="tag"

Strict Microformats2 Compliance (Complete)

  • h-feed required properties: p-name, p-author (h-card), u-url, u-photo
  • h-entry p-category for tags
  • u-photo placement outside e-content per draft spec
  • Author h-card with u-photo and p-note (graceful fallback)
  • mf2py validation test suite

Implementation Phases

  1. Phase 1: Database and Backend - Complete

    • Migration 008 for tags schema
    • Tags module with normalization
    • Notes CRUD updated for tags parameter
    • Micropub integration
  2. Phase 2: Templates - Complete

    • h-feed enhancements on index.html
    • p-category markup on note.html
    • Tag archive template (tag.html)
  3. Phase 3: Routes and Admin - Complete

    • Tag archive route
    • Admin form tag input
    • Tags pre-loaded in routes
  4. Phase 4: Validation - Complete

    • mf2py validation tests
    • Test fixtures for tags and media

Bugs Addressed

None

Known Limitations

  • No pagination on tag archive pages (future enhancement)
  • No tag autocomplete in admin (future enhancement)
  • No tag-filtered feeds (moved to backlog)

Test Results

  • 333 tests passed
  • 1 pre-existing flaky test (unrelated to v1.3.0)
  • All microformats validation tests pass

Documentation

  • Design: docs/design/v1.3.0/microformats-tags-design.md
  • Phase 1 Report: docs/design/v1.3.0/2025-12-10-phase1-implementation.md
  • Phase 2 Report: docs/design/v1.3.0/2025-12-10-phase2-implementation.md
  • Phase 3 Report: docs/design/v1.3.0/2025-12-10-phase3-implementation.md
  • Phase 4 Report: docs/design/v1.3.0/2025-12-10-phase4-implementation.md