Priivacy-ai/spec-kitty v0.5.1

v0.5.1 - Task Metadata Validation & Dynamic Version Fix

on GitHub

🔧 Patch Release: Task Metadata Validation & Critical Fixes

This patch release adds task metadata validation and fixes critical UX bugs.

🛡️ Task Metadata Validation Guardrail (NEW!)

Problem: Review workflow fails when file location doesn't match frontmatter
Solution: Auto-detects and repairs lane mismatches

Usage:

spec-kitty validate-tasks --fix
spec-kitty validate-tasks --all --fix

🐛 Critical Bug Fixes

1. Dashboard False Error (FIXED!)

Problem: CLI shows "❌ Unable to start dashboard" even when dashboard successfully starts
Root Cause: Health check timeout but server actually running
Impact: Confusing UX - users think dashboard failed when it's functional

Solution:

• Added fallback verification before reporting error
• Scans ports to confirm dashboard isn't running
• Shows warning if health check slow but dashboard accessible
• Only reports error if truly inaccessible

Before:

❌ Unable to start or locate the dashboard
   Dashboard failed to start on port 9280...
(but dashboard is actually running at http://localhost:9280)

After:

⚠️ Dashboard health check timed out but server is running

Spec Kitty Dashboard
============================================================
URL: http://127.0.0.1:9280
✅ Status: Started new dashboard instance

2. Hardcoded Version (FIXED!)

Problem: spec-kitty --version showed 0.4.13 even after upgrading
Solution: Now reads dynamically from package metadata

Verification:

pip install --upgrade spec-kitty-cli
spec-kitty --version
# spec-kitty-cli version 0.5.1 ✅

📚 New Features

1. spec-kitty validate-tasks - Auto-fix lane mismatches
2. Review workflow auto-validation - Runs before every review
3. Dashboard recovery logic - Verifies accessibility before error

🔧 Files Changed

• src/specify_cli/task_metadata_validation.py (290 lines, NEW)
• src/specify_cli/cli/commands/validate_tasks.py (200 lines, NEW)
• src/specify_cli/cli/commands/dashboard.py (+35 lines) - Fallback verification
• src/specify_cli/__init__.py - Dynamic version reading
• .claude/commands/spec-kitty.review.md - Auto-validation step
• docs/task-metadata-validation.md (350 lines, NEW)

✅ Testing

• Dashboard false error fix tested on priivacy_rust project
• Verified fallback detection works when health check times out
• Task metadata validation tested with real mismatches
• Version reading tests added
• All tests passing

🔄 Migration from 0.5.0

pip install --upgrade spec-kitty-cli

# Verify fixes
spec-kitty --version  # Should show 0.5.1
spec-kitty dashboard  # Should not show false errors
spec-kitty validate-tasks --all --fix  # Fix any metadata issues

💔 Breaking Changes

None - fully backwards compatible

Full changelog: https://github.com/Priivacy-ai/spec-kitty/blob/main/CHANGELOG.md#051---2025-11-14