thothctl 0.14.2__tar.gz → 0.14.3__tar.gz

{thothctl-0.14.2 → thothctl-0.14.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thothctl
-Version: 0.14.2
+Version: 0.14.3
 Summary: A CLI for Developer Control Plane. Accelerate your cloud IaC deployments.
 Project-URL: Homepage, https://github.com/thothforge/thothctl
 Author-email: Alejandro Velez <velez94@pm.me>

{thothctl-0.14.2 → thothctl-0.14.3}/docs/framework/commands/inventory/CHANGELOG.md

@@ -1,5 +1,14 @@
 # ThothCTL Inventory Command Changelog
 
+## Version 0.14.3 - May 2026
+
+### 🔧 Fix: Weighted Technical Debt Scoring
+
+- **Weighted formula**: Modules now carry 70% weight and providers 30% in debt score calculation
+- **Fairer scoring**: A single outdated provider no longer inflates the score disproportionately
+- **Consistent thresholds**: CDK risk levels aligned with the main formula (70/50/30)
+- **Rationale**: Providers may be intentionally pinned (e.g., a module tested against a specific provider version), so they should not dominate the debt score
+
 ## Version 0.4.0 - July 2025
 
 ### 🎯 Major Improvements

{thothctl-0.14.2 → thothctl-0.14.3}/docs/framework/commands/inventory/inventory_iac.md

@@ -197,6 +197,52 @@ The reports now include comprehensive provider data:
 - **Module Context**: Which module uses the provider
 - **Status**: Current, Outdated, or Unknown
 
+## Technical Debt Scoring 📊
+
+When `--check-versions` is enabled, ThothCTL calculates a **technical debt score** that reflects how outdated your infrastructure is.
+
+### Weighted Formula
+
+The debt score uses a weighted approach that separates module health from provider health:
+
+```
+module_debt   = outdated_modules / total_modules       (weight: 70%)
+provider_debt = outdated_providers / total_providers   (weight: 30%)
+
+debt_score = (module_debt × 0.7 + provider_debt × 0.3) × 100 + breaking_changes_penalty
+```
+
+**Why weighted?** Modules define your architecture and are the primary source of risk. Providers are dependencies that may be intentionally pinned (e.g., a latest module tested against a specific provider version). A single outdated provider should not inflate the score disproportionately.
+
+### Breaking Changes Penalty
+
+Each module or provider with detected breaking changes adds **+5 points** to the debt score (capped at 100%).
+
+### Risk Levels
+
+| Debt Score | Risk Level | Meaning |
+|-----------|------------|---------|
+| ≥ 70%    | **Critical** | Immediate action required |
+| ≥ 50%    | **High** | Plan upgrades soon |
+| ≥ 30%    | **Medium** | Schedule maintenance |
+| < 30%    | **Low** | Infrastructure is well-maintained |
+
+### Examples
+
+| Scenario | Score | Risk |
+|----------|-------|------|
+| 2 modules current, 1/2 providers outdated | 15% | Low |
+| 2/4 modules outdated, providers current | 35% | Medium |
+| All modules and providers outdated | 100% | Critical |
+| Everything current | 0% | Low |
+
+### Recommendations
+
+The system auto-generates actionable recommendations based on the metrics:
+- Update outdated modules/providers
+- Review components with breaking changes before upgrading
+- Confirmation when infrastructure is well-maintained (score < 20%)
+
 ## Framework Type Options
 
 ### Auto-detect Framework (Default)

{thothctl-0.14.2 → thothctl-0.14.3}/src/thothctl/services/inventory/inventory_service.py

@@ -1011,7 +1011,7 @@ class InventoryService:
                             outdated += 1
             if total > 0:
                 debt_score = (outdated / total) * 100
-                risk = "critical" if debt_score > 75 else "high" if debt_score > 50 else "medium" if debt_score > 25 else "low"
+                risk = "critical" if debt_score >= 70 else "high" if debt_score >= 50 else "medium" if debt_score >= 30 else "low"
                 inventory_dict["technical_debt"] = {
                     "debt_score": debt_score,
                     "risk_level": risk,
@@ -1455,12 +1455,21 @@ class InventoryService:
         metrics["providers_with_breaking_changes"] = schema_compat.get("providers_with_breaking_changes", 0)
         
         # Calculate debt score (0-100, higher is worse)
-        total_items = metrics["total_components"] + metrics["outdated_providers"]
-        if total_items > 0:
-            outdated_items = metrics["outdated_modules"] + metrics["outdated_providers"]
-            metrics["debt_score"] = (outdated_items / total_items) * 100
+        # Weighted approach: modules carry 70% weight, providers 30%
+        # This prevents a single outdated provider from inflating the score
+        total_modules = metrics["total_components"]
+        total_providers = metrics["current_providers"] + metrics["outdated_providers"]
+        
+        module_debt = (metrics["outdated_modules"] / total_modules) if total_modules > 0 else 0
+        provider_debt = (metrics["outdated_providers"] / total_providers) if total_providers > 0 else 0
+        
+        MODULE_WEIGHT = 0.7
+        PROVIDER_WEIGHT = 0.3
+        
+        if total_modules > 0 or total_providers > 0:
+            metrics["debt_score"] = (module_debt * MODULE_WEIGHT + provider_debt * PROVIDER_WEIGHT) * 100
             
-            # Add weight for breaking changes
+            # Add penalty for breaking changes (+5 points each)
             breaking_weight = (metrics["modules_with_breaking_changes"] + 
                              metrics["providers_with_breaking_changes"]) * 5
             metrics["debt_score"] = min(100, metrics["debt_score"] + breaking_weight)

thothctl-0.14.3/src/thothctl/version.py

@@ -0,0 +1,2 @@
+"""Version module."""
+__version__ = "0.14.3"

thothctl-0.14.2/src/thothctl/version.py

@@ -1,2 +0,0 @@
-"""Version module."""
-__version__ = "0.14.2"