StarPunk/docs/projectplan/v1.3.0/RELEASE.md

StarPunk v1.3.0 Release

Status: Complete 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