Prepare v1.0.0 release: Update documentation and add comprehensive badge tests

This commit prepares the project for the v1.0.0 release by fixing documentation
inaccuracies and adding comprehensive test coverage for previously untested badges.

Documentation Updates:
- Update README.md badge count from 75 to 101 across 16 categories (was 14)
- Fix individual category counts (Specialty: 2→10, Labs: 8→14, Medications: 3→6)
- Add missing categories: Visit Frequency Milestones (5), Seasonal (4)
- Update pkg/analysis/badges/doc.go badge count and category list
- Remove outdated BADGE_IDEAS.md (described implemented features as future work)

Test Coverage:
- Add distance_test.go: Tests for all 6 distance/travel badges
- Add milestones_test.go: Tests for all 5 visit frequency milestone badges
- Add seasonal_test.go: Tests for all 4 seasonal health pattern badges
- Add registry_test.go: Validates 101 badge count, no duplicates, complete metadata

Test Infrastructure:
- Enhance testutil builders with WithGeocodingEnabled(), WithDistanceFromHome(),
  WithVisitType(), and WithConfig() methods for comprehensive badge testing

Release Documentation:
- Add CHANGELOG.md documenting v1.0.0 release with complete feature list

All 450+ tests pass. The project is now ready for v1.0.0 release.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: jcrussell

BADGE_IDEAS.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2025-01-01
+
+### Added
+- Initial release of gamify-ccda
+- **101 Achievement Badges** across 16 categories:
+  - ⏰ Temporal (10): Time-based patterns (early morning, lunch hour, weekend, after hours, etc.)
+  - 📍 Location (7): Facility visit patterns (wanderer, loyalist, boomerang, yo-yo, etc.)
+  - 🎉 Holiday (7): Visits on special days (New Year's, Valentine's, Halloween, Christmas, etc.)
+  - 💻 Visit Modality (6): How you receive care (in-person, virtual, phone, hybrid)
+  - 👨‍⚕️ Provider Continuity (3): Provider relationships and loyalty
+  - 🏥 Specialty (10): Specialist care patterns
+  - 🔬 Lab & Testing (14): Lab work and preventive screening
+  - 📊 Vitals (4): Vital sign monitoring and tracking
+  - 💊 Medication (6): Medication management
+  - 💉 Immunization (3): Vaccination records
+  - 🩺 Diagnosis (4): Health condition tracking
+  - 🌟 Wellness (3): Overall healthcare engagement
+  - 🚗 Distance & Travel (6): Healthcare travel patterns and distances (requires geocoding)
+  - 🏆 Achievement & Milestone (9): Major milestones and meta-achievements
+  - 🎖️ Visit Frequency Milestones (5): Visit count milestones (Bronze, Silver, Gold, Platinum, Diamond)
+  - 🍂 Seasonal (4): Seasonal healthcare patterns (Spring, Summer, Fall, Winter)
+- **CCDA Parsing**: Comprehensive extraction of encounters, diagnoses, vitals, labs, medications, and immunizations
+- **Interactive Dashboard**: Activity heatmap, badge progress, quarterly timeline, and year-by-year comparison
+- **Location Map**: Interactive Leaflet map with geocoded facility locations and distance tracking (optional)
+- **Terminal Browser**: Browse encounters in a terminal UI with Bubble Tea
+- **Time Travel**: View data as of any historical date with `--when` flag
+- **Configuration System**: TOML-based config with geocoding preferences and home address support
+- **Privacy-Focused**: All processing happens locally, optional geocoding with OpenStreetMap
+- **Multi-Platform**: Cross-platform builds for Linux, macOS, and Windows (amd64, arm64)
+
+### Security
+- Password-protected ZIP file support for secure CCDA exports
+- Sensitive health data files excluded from git (.gitignore)
+- Generated HTML files created with restrictive permissions (0600)
+- Secure password input using golang.org/x/term
+- Geocoding disabled by default to protect privacy
+
+### Documentation
+- Comprehensive README with quick start guide
+- CLAUDE.md with architecture details and development guidelines
+- Example configuration file (config.example.toml)
+- BSD 3-Clause License
+
+### Infrastructure
+- GitHub Actions CI/CD (test, lint, build, release)
+- GoReleaser configuration for automated releases
+- Codecov integration for test coverage tracking
+- Comprehensive test suite with 450+ tests
+
+[Unreleased]: https://github.com/jcrussell/gamify-ccda/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/jcrussell/gamify-ccda/releases/tag/v1.0.0

CHANGELOG.md

@@ -16,7 +16,7 @@ This repository was created to explore the capabilities of Claude AI in software
 
 - 📊 **Interactive Dashboard**: View your health encounters over time with activity heatmap and insights
 - 🗺️ **Location Map**: Visualize all your healthcare facilities with distance tracking (requires geocoding)
-- 🏆 **75 Achievement Badges**: Earn badges across 14 categories (6 distance badges require geocoding)
+- 🏆 **101 Achievement Badges**: Earn badges across 16 categories (6 distance badges require geocoding)
 - 📅 **Yearly & Lifetime Stats**: Track your health journey with comprehensive analytics
 - ⏰ **Time Travel**: View your data as of any historical date with `--when` flag
 - 🔒 **Secure**: Processes password-protected ZIP files locally
@@ -56,29 +56,31 @@ Open `output/index.html` in your browser to view your health dashboard!
 
 ## Badge Categories
 
-Earn badges across 14 categories tracking different aspects of your healthcare journey:
+Earn badges across 16 categories tracking different aspects of your healthcare journey:
 
 - **⏰ Temporal (10)**: Time-based patterns (early morning, lunch hour, weekend, after hours, etc.)
 - **📍 Location (7)**: Facility visit patterns (wanderer, loyalist, boomerang, yo-yo, etc.)
 - **🎉 Holiday (7)**: Visits on special days (New Year's, Valentine's, Halloween, Christmas, etc.)
 - **💻 Visit Modality (6)**: How you receive care (in-person, virtual, phone, hybrid)
 - **👨‍⚕️ Provider Continuity (3)**: Provider relationships and loyalty
-- **🏥 Specialty (2)**: Specialist care patterns
-- **🔬 Lab & Testing (8)**: Lab work and preventive screening
+- **🏥 Specialty (10)**: Specialist care patterns
+- **🔬 Lab & Testing (14)**: Lab work and preventive screening
 - **📊 Vitals (4)**: Vital sign monitoring and tracking
-- **💊 Medication (3)**: Medication management
+- **💊 Medication (6)**: Medication management
 - **💉 Immunization (3)**: Vaccination records
-- **🏥 Diagnosis (4)**: Health condition tracking
+- **🩺 Diagnosis (4)**: Health condition tracking
 - **🌟 Wellness (3)**: Overall healthcare engagement
 - **🚗 Distance & Travel (6)**: Healthcare travel patterns and distances
 - **🏆 Achievement & Milestone (9)**: Major milestones and meta-achievements
+- **🎖️ Visit Frequency Milestones (5)**: Visit count milestones (Bronze, Silver, Gold, Platinum, Diamond)
+- **🍂 Seasonal (4)**: Seasonal healthcare patterns (Spring, Summer, Fall, Winter)
 
 ## How It Works
 
 1. **Export**: Download your health records as a CCDA/IHE_XDM ZIP file from your healthcare provider
 2. **Parse**: The tool extracts and parses comprehensive health data (encounters, diagnoses, vitals, labs, medications, immunizations)
 3. **Geocode** (optional): When enabled, geocodes facility addresses to calculate distances and generate map visualizations
-4. **Analyze**: Aggregates data into yearly buckets and evaluates 75 badge criteria across 14 categories
+4. **Analyze**: Aggregates data into yearly buckets and evaluates 101 badge criteria across 16 categories
 5. **Visualize**: Generates a beautiful HTML dashboard with interactive heatmaps, maps, and achievement tracking
 
 ## CCDA Compatibility

README.md

@@ -98,19 +98,47 @@ func (b *EncounterBuilder) WithStatus(status string) *EncounterBuilder {
 	return b
 }
 
+// WithDistanceFromHome sets the distance from home in km
+func (b *EncounterBuilder) WithDistanceFromHome(distance float64) *EncounterBuilder {
+	b.enc.DistanceFromHome = distance
+	return b
+}
+
+// WithVisitType sets the encounter code and location to match the specified visit type
+func (b *EncounterBuilder) WithVisitType(visitType ccda.VisitType) *EncounterBuilder {
+	switch visitType {
+	case ccda.VisitTypeInPerson:
+		b.enc.EncounterCode = "99213"
+		b.enc.EncounterCodeSystem = "2.16.840.1.113883.6.12" // CPT
+		b.enc.Location = "Medical Center"
+	case ccda.VisitTypeVirtual:
+		b.enc.EncounterOriginalText = "E-Visit"
+		b.enc.Location = "Virtual Clinic"
+	case ccda.VisitTypePhone:
+		b.enc.EncounterOriginalText = "Phone Consultation"
+		b.enc.Location = "Call Center"
+	case ccda.VisitTypeInHome:
+		b.enc.EncounterOriginalText = "Home Visit"
+		b.enc.Location = "Home Health"
+	}
+	return b
+}
+
 // Build returns the built encounter
 func (b *EncounterBuilder) Build() ccda.Encounter {
 	return b.enc
 }
 
 // HistoryBuilder provides a fluent interface for building health history
 type HistoryBuilder struct {
-	encounters    []ccda.Encounter
-	diagnoses     []ccda.Diagnosis
-	vitals        []ccda.Vital
-	labs          []ccda.Lab
-	medications   []ccda.Medication
-	immunizations []ccda.Immunization
+	encounters       []ccda.Encounter
+	diagnoses        []ccda.Diagnosis
+	vitals           []ccda.Vital
+	labs             []ccda.Lab
+	medications      []ccda.Medication
+	immunizations    []ccda.Immunization
+	geocodingEnabled bool
+	config           *config.Config
 }
 
 // NewHistory creates a new history builder
@@ -197,6 +225,38 @@ func (h *HistoryBuilder) WithImmunizations(imms ...ccda.Immunization) *HistoryBu
 	return h
 }
 
+// WithGeocodingEnabled sets whether geocoding is enabled
+func (h *HistoryBuilder) WithGeocodingEnabled(enabled bool) *HistoryBuilder {
+	h.geocodingEnabled = enabled
+	// If enabling geocoding, create a default config with a test home address if not already set
+	if enabled && h.config == nil {
+		h.config = &config.Config{
+			Preferences: config.Preferences{
+				DistanceUnit:    "km",
+				EnableGeocoding: true,
+			},
+			Addresses: []config.AddressEntry{
+				{
+					StartDate:  "2000-01-01",
+					EndDate:    "",
+					Street:     "123 Test Street",
+					City:       "Test City",
+					State:      "CA",
+					PostalCode: "90001",
+					Country:    "USA",
+				},
+			},
+		}
+	}
+	return h
+}
+
+// WithConfig sets a custom config
+func (h *HistoryBuilder) WithConfig(cfg *config.Config) *HistoryBuilder {
+	h.config = cfg
+	return h
+}
+
 // Build returns the built HealthHistory
 func (h *HistoryBuilder) Build() *analysis.HealthHistory {
 	data := &ccda.Data{
@@ -207,5 +267,11 @@ func (h *HistoryBuilder) Build() *analysis.HealthHistory {
 		Medications:   h.medications,
 		Immunizations: h.immunizations,
 	}
-	return analysis.NewHealthHistory(data, time.Now(), config.DefaultConfig(), false)
+
+	cfg := h.config
+	if cfg == nil {
+		cfg = config.DefaultConfig()
+	}
+
+	return analysis.NewHealthHistory(data, time.Now(), cfg, h.geocodingEnabled)
 }