refactor: reorganize project structure and archive historical files

- Move archived CHANGELOG.md, HISTORICAL.md, and discontinued.yaml to archive/
- Update docs with historical evaluation examples and project methodology evolution
- Enhance Python tools with improved error handling and testing dependencies
- Add new CHANGELOG.md, discontinued_services.yaml, and directories for services, tests, and historical evaluations

Author: devliq

archive/CHANGELOG.md CHANGELOG.mdarchive/CHANGELOG.md renamed to CHANGELOG.md

@@ -0,0 +1,50 @@
+# Discontinued Services
+# This file tracks services that are no longer free or have been discontinued
+# Each entry includes the service ID, sunset date, and reason for discontinuation
+
+discontinued:
+  - id: "heroku-free-tier"
+    name: "Heroku Free Tier"
+    provider: "Heroku"
+    category: "compute"
+    sunset_date: "2022-11-28"
+    reason: "Heroku discontinued free tier to focus on enterprise customers"
+    notes: "Free dynos, databases, and add-ons were available for hobby projects"
+    last_free_tier: "always-free"
+    alternative_services:
+      - "render"
+      - "fly-io"
+      - "railway"
+
+  - id: "firebase-spark"
+    name: "Firebase Spark Plan"
+    provider: "Google"
+    category: "database"
+    sunset_date: "2020-08-17"
+    reason: "Replaced with Blaze plan which requires billing account for new projects"
+    notes: "Limited free usage with strict limits, now requires payment method on file"
+    last_free_tier: "always-free"
+    alternative_services:
+      - "supabase"
+      - "planetscale"
+      - "mongodb-atlas"
+
+  - id: "parse"
+    name: "Parse"
+    provider: "Facebook"
+    category: "database"
+    sunset_date: "2017-01-28"
+    reason: "Service shutdown by Facebook after acquisition"
+    notes: "Popular Backend-as-a-Service platform for mobile apps"
+    last_free_tier: "always-free"
+    alternative_services:
+      - "firebase"
+      - "supabase"
+      - "back4app"
+
+# Notes:
+# - sunset_date: Date when the free tier was discontinued (YYYY-MM-DD)
+# - reason: Brief explanation of why it was discontinued
+# - notes: Additional context or details
+# - last_free_tier: The type of free tier that was available
+# - alternative_services: List of current free alternatives (service IDs)

archive/HISTORICAL.md

@@ -147,6 +147,20 @@ Difficulty migrating away from the service.
 - Services promoting spam/scams
 - Dark web or anonymous access required
 
+### Examples of Exclusions
+
+#### Heroku Free Tier (Discontinued 2022)
+- **Decision**: Not included due to discontinuation
+- **Reason**: Heroku ended their free tier in November 2022
+- **Evaluation**: Originally evaluated in historical records
+- **Alternative**: Consider Railway, Render, or Fly.io
+
+#### Firebase Spark Plan Limitations
+- **Decision**: Limited inclusion due to restrictive quotas
+- **Reason**: Daily limits too low for practical development use
+- **Evaluation**: Reviewed for potential inclusion with updated limits
+- **Status**: Under review for future consideration
+
 ## Documentation Standards
 
 ### Required Fields for Every Service

archive/discontinued.yaml

@@ -130,6 +130,29 @@ Python and Bash scripts for:
 - Responsive issue resolution
 - Educational value for cloud-native development
 
+## Project History
+
+### Methodology Evolution
+
+#### Evaluation Criteria Development
+- **2023**: Added cost risk assessment and vendor lock-in analysis to identify hidden charges and migration challenges
+- **2022**: Introduced setup time and learning curve metrics to evaluate developer experience
+- **2021**: Initial criteria focused on free tier limits, availability, and basic service viability
+
+#### Data Collection Methods
+- **2023**: Automated web scraping with manual verification for efficiency and accuracy
+- **2022**: Manual research enhanced by community contributions and peer review
+- **2021**: Initial manual catalog creation with basic documentation review
+
+#### Schema Evolution
+- **v3.0 (2023)**: Added cost risk flags and vendor lock-in metrics
+- **v2.0 (2022)**: Introduced cost analysis and gotchas documentation
+- **v1.0 (2021)**: Basic service metadata and free tier limits
+
+### Historical Evaluations
+
+Detailed service evaluations from past quarters are archived in [`docs/historical-evaluations/`](./historical-evaluations/) for reference and methodology tracking.
+
 ## Future Vision
 
 ### Expansion Areas

archive/discontinued_services.yaml

@@ -0,0 +1,29 @@
+# AWS Service Evaluation - Q4 2023
+
+Analysis of 15 AWS services for free tier inclusion.
+
+*Note: This evaluation was originally documented in GitHub issue #123. The detailed analysis has been archived here for historical reference.*
+
+## Summary
+
+Comprehensive review of AWS free tier offerings conducted in Q4 2023, evaluating service maturity, limit practicality, and integration potential.
+
+## Services Evaluated
+
+- EC2 (Compute)
+- Lambda (Serverless)
+- S3 (Storage)
+- RDS (Databases)
+- CloudFront (CDN)
+- And 10 additional services
+
+## Key Findings
+
+- Free tier limits generally practical for development/prototyping
+- Some services have restrictive concurrent connection limits
+- Regional availability varies significantly
+- Cost monitoring essential to avoid unexpected charges
+
+## Recommendations
+
+Services recommended for inclusion based on evaluation criteria.

docs/EVALUATION_CRITERIA.md

@@ -0,0 +1,28 @@
+# Microsoft Azure Free Services - Q4 2023
+
+Azure free tier evaluation.
+
+*Note: This evaluation was originally documented in GitHub issue #125. The detailed analysis has been archived here for historical reference.*
+
+## Summary
+
+Assessment of Microsoft Azure's free tier services and trial offerings.
+
+## Services Evaluated
+
+- Virtual Machines
+- App Service
+- Azure Functions
+- Storage Accounts
+- And other Azure services
+
+## Key Findings
+
+- Comprehensive free tier with 12-month trials for many services
+- $200 credit for new accounts
+- Some services have very low free limits
+- Enterprise-focused service portfolio
+
+## Recommendations
+
+Services suitable for development and small-scale production use.

docs/OVERVIEW.md

@@ -0,0 +1,28 @@
+# CDN and Edge Services Review - Q2 2022
+
+Content delivery network evaluation.
+
+*Note: This evaluation was originally documented in GitHub issue #67. The detailed analysis has been archived here for historical reference.*
+
+## Summary
+
+Evaluation of CDN and edge computing services with free tiers.
+
+## Services Evaluated
+
+- Cloudflare CDN
+- AWS CloudFront
+- Bunny.net
+- Fastly
+- And other CDN providers
+
+## Key Findings
+
+- Cloudflare emerged as the clear leader for free tier CDN
+- Significant differences in free bandwidth limits
+- Edge computing capabilities vary widely
+- Global distribution and performance metrics
+
+## Recommendations
+
+Recommended CDN services for different use cases and traffic volumes.

docs/historical-evaluations/aws-q4-2023.md

@@ -0,0 +1,29 @@
+# Database Services Comparison - Q3 2022
+
+Free database options analysis.
+
+*Note: This evaluation was originally documented in GitHub issue #89. The detailed analysis has been archived here for historical reference.*
+
+## Summary
+
+Comparative analysis of free tier database services available in 2022.
+
+## Services Evaluated
+
+- MongoDB Atlas
+- PlanetScale
+- Supabase
+- AWS RDS
+- Google Cloud SQL
+- And other database providers
+
+## Key Findings
+
+- Significant improvements in free tier database offerings
+- PlanetScale and Supabase emerged as strong contenders
+- AWS RDS free tier limited to specific instance types
+- Performance and scaling limitations vary widely
+
+## Recommendations
+
+Recommended databases for different use cases and scale requirements.