From f901aa22429cc72a61429161ad0ad06b5cfb3732 Mon Sep 17 00:00:00 2001
From: Phil Skentelbery <phil@thesatelliteoflove.com>
Date: Wed, 10 Dec 2025 11:58:45 -0700
Subject: [PATCH] docs: Update project plan files

---
 docs/projectplan/BACKLOG.md        | 31 ++++++-------
 docs/projectplan/v1.3.0/RELEASE.md | 70 +++++++++++++++++++++++++-----
 2 files changed, 75 insertions(+), 26 deletions(-)

diff --git a/docs/projectplan/BACKLOG.md b/docs/projectplan/BACKLOG.md
index e6ff3e1..2d90b87 100644
--- a/docs/projectplan/BACKLOG.md
+++ b/docs/projectplan/BACKLOG.md
@@ -2,6 +2,16 @@
 
 **Last Updated**: 2025-12-10
 
+## Recently Completed
+
+### v1.3.0 - Microformats2 Compliance and Tags (Complete)
+- Tag/Category system with database schema
+- p-category microformats2 markup
+- h-feed required properties (name, author, url)
+- Author h-card with photo and bio
+- u-photo placement outside e-content
+- mf2py validation test suite
+
 ## Priority Levels
 
 - **Critical** - Items that break existing functionality
@@ -19,14 +29,6 @@
 
 ## High
 
-### Strict Microformats2 Compliance
-- Complete h-entry properties (p-name, p-summary, p-author)
-- Author h-card implementation
-- h-feed wrapper for index pages
-- Full IndieWeb parser compatibility
-- Microformats2 validation suite
-- See: ADR-040
-
 ### Enhanced Feed Media Support
 - Multiple image sizes/thumbnails (150px, 320px, 640px, 1280px)
 - Full Media RSS implementation (media:group, all attributes)
@@ -34,17 +36,16 @@
 - ATOM enclosure links for all media
 - See: ADR-059
 
-### Tag/Category System
-- Database schema for tags
-- Tag-based filtering
-- Tag clouds
-- Category RSS/ATOM/JSON feeds
-- p-category microformats2 support
-
 ---
 
 ## Medium
 
+### Tag Enhancements (v1.3.0 Follow-up)
+- Tag pagination on archive pages (when note count exceeds threshold)
+- Tag autocomplete in admin interface
+- Tag-filtered feeds (e.g., `/feed.rss?tag=python`, `/tags/python/feed.rss`)
+- Fix: Empty tag field in admin should remove all tags (currently may leave unchanged)
+
 ### Tag-Filtered Feeds
 - Filter feeds by tag (e.g., `/feed.rss?tag=python`)
 - Dedicated tag feed URLs (e.g., `/tags/python/feed.rss`)
diff --git a/docs/projectplan/v1.3.0/RELEASE.md b/docs/projectplan/v1.3.0/RELEASE.md
index f9df3df..4024a12 100644
--- a/docs/projectplan/v1.3.0/RELEASE.md
+++ b/docs/projectplan/v1.3.0/RELEASE.md
@@ -1,21 +1,69 @@
 # StarPunk v1.3.0 Release
 
-**Status**: Planning
+**Status**: Complete
+**Codename**: "Categories"
+**Branch**: `feature/v1.3.0-tags-microformats`
+**Approved**: 2025-12-10
 
 ## Features
 
-### Strict Microformats2 Compliance
-- Complete h-entry properties (p-name, p-summary, p-author)
-- Author h-card implementation
-- h-feed wrapper for index pages
-- Full IndieWeb parser compatibility
-- Microformats2 validation suite
-- See: ADR-040
+### 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 planned*
+*None*
 
-## Implementation
+## Known Limitations
 
-See `docs/design/v1.3.0/` for implementation details and reports.
+- 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`