Tech Debt Tracker Tier : POWERFUL 🔥 Category : Engineering Process Automation Expertise : Code Quality, Technical Debt Management, Software Engineering Overview Tech debt is one of the most insidious challenges in software development - it compounds over time, slowing down development velocity, increasing maintenance costs, and reducing code quality. This skill provides a comprehensive framework for identifying, analyzing, prioritizing, and tracking technical debt across codebases. Tech debt isn't just about messy code - it encompasses architectural shortcuts, missing tests, outdated depende…

+ amount.toFixed(2);\n } else if (currency === 'EUR') {\n return '€' + amount.toFixed(2);\n } else {\n return amount.toFixed(2) + ' ' + currency;\n }\n }\n \n getSystemStats() {\n // Hardcoded test data - should come from API\n return {\n totalUsers: 12534,\n activeUsers: 8765,\n newToday: 23\n };\n }\n}\n\n// Global functions - should be methods or modules\nfunction closeModal() {\n // Assumes modal exists - no error checking\n document.querySelector('.modal').remove();\n}\n\nfunction validateEmail(email) {\n // Regex without explanation - magic pattern\n return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email);\n}\n\nfunction validatePassword(password) {\n // Duplicate validation logic from backend\n if (password.length \u003c 8) return false;\n if (!/[A-Z]/.test(password)) return false;\n if (!/[a-z]/.test(password)) return false;\n if (!/\\d/.test(password)) return false;\n return true;\n}\n\n// jQuery-style utility - reinventing the wheel\nfunction $(selector) {\n return document.querySelector(selector);\n}\n\nfunction $all(selector) {\n return document.querySelectorAll(selector);\n}\n\n// Global event handlers - should be encapsulated\ndocument.addEventListener('DOMContentLoaded', function() {\n // Inline anonymous function\n let ui = new UserInterface();\n \n // Event delegation would be better\n document.body.addEventListener('click', function(event) {\n if (event.target.classList.contains('login-button')) {\n // Inline login logic\n let username = $('#username').value;\n let password = $('#password').value;\n \n if (!username || !password) {\n alert('Please enter username and password'); // Poor UX\n return;\n }\n \n // No CSRF protection\n fetch(API_BASE_URL + '/auth/login', {\n method: 'POST',\n headers: {'Content-Type': 'application/json'},\n body: JSON.stringify({username: username, password: password})\n })\n .then(response => response.json())\n .then(data => {\n if (data.success) {\n authToken = data.token;\n currentUser = data.user;\n localStorage.setItem('authToken', authToken); // Storing sensitive data\n localStorage.setItem('currentUser', JSON.stringify(currentUser));\n window.location.reload(); // Poor navigation\n } else {\n alert('Login failed: ' + data.error);\n }\n })\n .catch(error => {\n console.error('Login error:', error);\n alert('Login failed');\n });\n }\n });\n});\n\n// // Old code left as comments - should be removed\n// function oldRenderFunction() {\n// var html = '\u003cdiv>Old implementation\u003c/div>';\n// document.body.innerHTML = html;\n// }\n\n// Commented out feature - should be removed or implemented\n// function darkModeToggle() {\n// if (document.body.classList.contains('dark-theme')) {\n// document.body.classList.remove('dark-theme');\n// document.body.classList.add('light-theme');\n// } else {\n// document.body.classList.remove('light-theme');\n// document.body.classList.add('dark-theme');\n// }\n// }","content_type":"text/javascript; charset=utf-8","language":"javascript","size":14891,"content_sha256":"a9eedae239571e0aa8d1d0263ee9ded5b212fe5b2c5e92431b22257654be142b"},{"filename":"assets/sample_codebase/src/payment_processor.py","content":"\"\"\"\nPayment processing module - contains various technical debt examples.\n\n⚠️ DISCLAIMER: This is an INTENTIONAL example of bad code patterns for\ntech debt detection training. The hardcoded credentials, missing error\nhandling, and other issues are deliberate anti-patterns used by the\ntech-debt-tracker skill to demonstrate detection capabilities.\nDO NOT use this code in production.\n\"\"\"\n\nimport json\nimport time\nimport requests\nfrom decimal import Decimal\nfrom typing import Dict, Any\n\n\nclass PaymentProcessor:\n \n def __init__(self):\n # TODO: These should come from environment or config\n # ⚠️ INTENTIONAL BAD PATTERN — hardcoded keys for tech debt detection demo\n self.stripe_key = \"sk_test_EXAMPLE_NOT_REAL\"\n self.paypal_key = \"paypal_EXAMPLE_NOT_REAL\"\n self.square_key = \"square_EXAMPLE_NOT_REAL\"\n \n def process_payment(self, amount, currency, payment_method, customer_data, billing_address, shipping_address, items, discount_code, tax_rate, processing_fee, metadata):\n \"\"\"\n Process a payment - this function is too large and complex\n \"\"\"\n \n # Input validation - should be extracted to separate function\n if not amount or amount \u003c= 0:\n return {\"success\": False, \"error\": \"Invalid amount\"}\n \n if not currency:\n return {\"success\": False, \"error\": \"Currency required\"}\n \n if currency not in [\"USD\", \"EUR\", \"GBP\", \"CAD\", \"AUD\"]: # Hardcoded list\n return {\"success\": False, \"error\": \"Unsupported currency\"}\n \n if not payment_method:\n return {\"success\": False, \"error\": \"Payment method required\"}\n \n if not customer_data or \"email\" not in customer_data:\n return {\"success\": False, \"error\": \"Customer email required\"}\n \n # Tax calculation - complex business logic that should be separate service\n tax_amount = 0\n if tax_rate:\n if currency == \"USD\":\n # US tax logic - hardcoded rules\n if billing_address and \"state\" in billing_address:\n state = billing_address[\"state\"]\n if state == \"CA\":\n tax_amount = amount * 0.08 # California tax\n elif state == \"NY\":\n tax_amount = amount * 0.085 # New York tax\n elif state == \"TX\":\n tax_amount = amount * 0.0625 # Texas tax\n elif state == \"FL\":\n tax_amount = amount * 0.06 # Florida tax\n else:\n tax_amount = amount * 0.05 # Default tax\n elif currency == \"EUR\":\n # EU VAT logic - also hardcoded\n tax_amount = amount * 0.20 # 20% VAT\n elif currency == \"GBP\":\n tax_amount = amount * 0.20 # UK VAT\n \n # Discount calculation - another complex block\n discount_amount = 0\n if discount_code:\n # FIXME: This should query a discount service\n if discount_code == \"SAVE10\":\n discount_amount = amount * 0.10\n elif discount_code == \"SAVE20\":\n discount_amount = amount * 0.20\n elif discount_code == \"NEWUSER\":\n discount_amount = min(50, amount * 0.25) # Max $50 discount\n elif discount_code == \"LOYALTY\":\n # Complex loyalty discount logic\n customer_tier = customer_data.get(\"tier\", \"bronze\")\n if customer_tier == \"gold\":\n discount_amount = amount * 0.15\n elif customer_tier == \"silver\":\n discount_amount = amount * 0.10\n elif customer_tier == \"bronze\":\n discount_amount = amount * 0.05\n \n # Calculate final amount\n final_amount = amount - discount_amount + tax_amount + processing_fee\n \n # Payment method routing - should use strategy pattern\n if payment_method[\"type\"] == \"credit_card\":\n # Credit card processing\n if payment_method[\"provider\"] == \"stripe\":\n try:\n # Stripe API call - no retry logic\n response = requests.post( # noqa: SEC-AUDITOR (sample codebase the tracker analyses; never run)\n \"https://api.stripe.com/v1/charges\",\n headers={\"Authorization\": f\"Bearer {self.stripe_key}\"},\n data={\n \"amount\": int(final_amount * 100), # Convert to cents\n \"currency\": currency.lower(),\n \"source\": payment_method[\"token\"],\n \"description\": f\"Payment for {len(items)} items\"\n }\n )\n \n if response.status_code == 200:\n stripe_response = response.json()\n # Store transaction - should be in database\n transaction = {\n \"id\": stripe_response[\"id\"],\n \"amount\": final_amount,\n \"currency\": currency,\n \"status\": \"completed\",\n \"timestamp\": time.time(),\n \"provider\": \"stripe\",\n \"customer\": customer_data[\"email\"],\n \"items\": items,\n \"tax_amount\": tax_amount,\n \"discount_amount\": discount_amount\n }\n \n # Send confirmation email - inline instead of separate service\n self.send_payment_confirmation_email(customer_data[\"email\"], transaction)\n \n return {\"success\": True, \"transaction\": transaction}\n else:\n return {\"success\": False, \"error\": \"Stripe payment failed\"}\n \n except Exception as e:\n # Broad exception handling - should be more specific\n print(f\"Stripe error: {e}\") # Should use proper logging\n return {\"success\": False, \"error\": \"Payment processing error\"}\n \n elif payment_method[\"provider\"] == \"square\":\n # Square processing - duplicate code structure\n try:\n response = requests.post( # noqa: SEC-AUDITOR (sample codebase the tracker analyses; never run)\n \"https://connect.squareup.com/v2/payments\",\n headers={\"Authorization\": f\"Bearer {self.square_key}\"},\n json={\n \"source_id\": payment_method[\"token\"],\n \"amount_money\": {\n \"amount\": int(final_amount * 100),\n \"currency\": currency\n }\n }\n )\n \n if response.status_code == 200:\n square_response = response.json()\n transaction = {\n \"id\": square_response[\"payment\"][\"id\"],\n \"amount\": final_amount,\n \"currency\": currency, \n \"status\": \"completed\",\n \"timestamp\": time.time(),\n \"provider\": \"square\",\n \"customer\": customer_data[\"email\"],\n \"items\": items,\n \"tax_amount\": tax_amount,\n \"discount_amount\": discount_amount\n }\n \n self.send_payment_confirmation_email(customer_data[\"email\"], transaction)\n \n return {\"success\": True, \"transaction\": transaction}\n else:\n return {\"success\": False, \"error\": \"Square payment failed\"}\n \n except Exception as e:\n print(f\"Square error: {e}\")\n return {\"success\": False, \"error\": \"Payment processing error\"}\n \n elif payment_method[\"type\"] == \"paypal\":\n # PayPal processing - more duplicate code\n try:\n response = requests.post( # noqa: SEC-AUDITOR (sample codebase the tracker analyses; never run)\n \"https://api.paypal.com/v2/checkout/orders\",\n headers={\"Authorization\": f\"Bearer {self.paypal_key}\"},\n json={\n \"intent\": \"CAPTURE\",\n \"purchase_units\": [{\n \"amount\": {\n \"currency_code\": currency,\n \"value\": str(final_amount)\n }\n }]\n }\n )\n \n if response.status_code == 201:\n paypal_response = response.json()\n transaction = {\n \"id\": paypal_response[\"id\"],\n \"amount\": final_amount,\n \"currency\": currency,\n \"status\": \"completed\", \n \"timestamp\": time.time(),\n \"provider\": \"paypal\",\n \"customer\": customer_data[\"email\"],\n \"items\": items,\n \"tax_amount\": tax_amount,\n \"discount_amount\": discount_amount\n }\n \n self.send_payment_confirmation_email(customer_data[\"email\"], transaction)\n \n return {\"success\": True, \"transaction\": transaction}\n else:\n return {\"success\": False, \"error\": \"PayPal payment failed\"}\n \n except Exception as e:\n print(f\"PayPal error: {e}\")\n return {\"success\": False, \"error\": \"Payment processing error\"}\n \n else:\n return {\"success\": False, \"error\": \"Unsupported payment method\"}\n \n def send_payment_confirmation_email(self, email, transaction):\n # Email sending logic - should be separate service\n # HACK: Using print instead of actual email service\n print(f\"Sending confirmation email to {email}\")\n print(f\"Transaction ID: {transaction['id']}\")\n print(f\"Amount: {transaction['currency']} {transaction['amount']}\")\n \n # TODO: Implement actual email sending\n pass\n \n def refund_payment(self, transaction_id, amount=None):\n # Refund logic - incomplete implementation\n # TODO: Implement refund for different providers\n print(f\"Refunding transaction {transaction_id}\")\n if amount:\n print(f\"Partial refund: {amount}\")\n else:\n print(\"Full refund\")\n \n # XXX: This doesn't actually process the refund\n return {\"success\": True, \"message\": \"Refund initiated\"}\n \n def get_transaction(self, transaction_id):\n # Should query database, but we don't have one\n # FIXME: Implement actual transaction lookup\n return {\"id\": transaction_id, \"status\": \"unknown\"}\n \n def validate_credit_card(self, card_number, expiry_month, expiry_year, cvv):\n # Basic card validation - should use proper validation library\n if not card_number or len(card_number) \u003c 13 or len(card_number) > 19:\n return False\n \n # Luhn algorithm check - reimplemented poorly\n digits = [int(d) for d in card_number if d.isdigit()]\n checksum = 0\n for i, digit in enumerate(reversed(digits)):\n if i % 2 == 1:\n digit *= 2\n if digit > 9:\n digit -= 9\n checksum += digit\n \n if checksum % 10 != 0:\n return False\n \n # Expiry validation\n if expiry_month \u003c 1 or expiry_month > 12:\n return False\n \n current_year = int(time.strftime(\"%Y\"))\n current_month = int(time.strftime(\"%m\"))\n \n if expiry_year \u003c current_year:\n return False\n elif expiry_year == current_year and expiry_month \u003c current_month:\n return False\n \n # CVV validation\n if not cvv or len(cvv) \u003c 3 or len(cvv) > 4:\n return False\n \n return True\n\n\n# Module-level functions that should be in class or separate module\ndef calculate_processing_fee(amount, provider):\n \"\"\"Calculate processing fee - hardcoded rates\"\"\"\n if provider == \"stripe\":\n return amount * 0.029 + 0.30 # Stripe rates\n elif provider == \"paypal\":\n return amount * 0.031 + 0.30 # PayPal rates \n elif provider == \"square\":\n return amount * 0.026 + 0.10 # Square rates\n else:\n return 0\n\n\ndef format_currency(amount, currency):\n \"\"\"Format currency - basic implementation\"\"\"\n # Should use proper internationalization\n if currency == \"USD\":\n return f\"${amount:.2f}\"\n elif currency == \"EUR\":\n return f\"€{amount:.2f}\"\n elif currency == \"GBP\":\n return f\"£{amount:.2f}\"\n else:\n return f\"{currency} {amount:.2f}\"\n\n\n# Global state - anti-pattern\npayment_processor_instance = None\n\n\ndef get_payment_processor():\n global payment_processor_instance\n if payment_processor_instance is None:\n payment_processor_instance = PaymentProcessor()\n return payment_processor_instance","content_type":"text/x-python; charset=utf-8","language":"python","size":13987,"content_sha256":"a5d6ca3dc0d41e9c2d3ce85b45deb5fcbbb91bbcb5e2db86235b4db710c0356a"},{"filename":"assets/sample_codebase/src/user_service.py","content":"#!/usr/bin/env python3\n\"\"\"\nUser service module with various tech debt examples\n\"\"\"\n\nimport hashlib\nimport json\nimport time\nimport re\nfrom typing import Dict, List, Any, Optional\n\n# TODO: Move this to configuration file\nDATABASE_URL = \"postgresql://user:password123@localhost:5432/mydb\"\nAPI_KEY = \"sk-1234567890abcdef\" # FIXME: This should be in environment variables\n\n\nclass UserService:\n def __init__(self):\n self.users = {}\n self.cache = {}\n # HACK: Using dict for now, should be proper database connection\n self.db_connection = None\n \n def create_user(self, name, email, password, age, phone, address, city, state, zip_code, country, preferences, notifications, billing_info):\n # Function with too many parameters - should use User dataclass\n if not name:\n return None\n if not email:\n return None\n if not password:\n return None\n if not age:\n return None\n if not phone:\n return None\n if not address:\n return None\n if not city:\n return None\n if not state:\n return None\n if not zip_code:\n return None\n if not country:\n return None\n \n # Duplicate validation logic - should be extracted\n if age \u003c 13:\n print(\"User must be at least 13 years old\")\n return None\n if age > 150:\n print(\"Invalid age\")\n return None\n \n # More validation\n if not self.validate_email(email):\n print(\"Invalid email format\")\n return None\n \n # Password validation - duplicated elsewhere\n if len(password) \u003c 8:\n print(\"Password too short\")\n return None\n if not re.search(r\"[A-Z]\", password):\n print(\"Password must contain uppercase letter\")\n return None \n if not re.search(r\"[a-z]\", password):\n print(\"Password must contain lowercase letter\")\n return None\n if not re.search(r\"\\d\", password):\n print(\"Password must contain digit\")\n return None\n \n # Deep nesting example\n if preferences:\n if 'notifications' in preferences:\n if preferences['notifications']:\n if 'email' in preferences['notifications']:\n if preferences['notifications']['email']:\n if 'frequency' in preferences['notifications']['email']:\n if preferences['notifications']['email']['frequency'] == 'daily':\n print(\"Daily email notifications enabled\")\n elif preferences['notifications']['email']['frequency'] == 'weekly':\n print(\"Weekly email notifications enabled\")\n else:\n print(\"Invalid notification frequency\")\n \n # TODO: Implement proper user ID generation\n user_id = str(hash(email)) # XXX: This is terrible for production\n \n # Magic numbers everywhere\n password_hash = hashlib.sha256((password + \"salt123\").encode()).hexdigest()\n \n user_data = {\n \"id\": user_id,\n \"name\": name,\n \"email\": email,\n \"password_hash\": password_hash,\n \"age\": age,\n \"phone\": phone,\n \"address\": address,\n \"city\": city, \n \"state\": state,\n \"zip_code\": zip_code,\n \"country\": country,\n \"preferences\": preferences,\n \"notifications\": notifications,\n \"billing_info\": billing_info,\n \"created_at\": time.time(),\n \"updated_at\": time.time(),\n \"last_login\": None,\n \"login_count\": 0,\n \"is_active\": True,\n \"is_verified\": False,\n \"verification_token\": None,\n \"reset_token\": None,\n \"failed_login_attempts\": 0,\n \"locked_until\": None,\n \"subscription_level\": \"free\",\n \"credits\": 100\n }\n \n self.users[user_id] = user_data\n return user_id\n \n def validate_email(self, email):\n # Duplicate validation logic - should be in utils\n if not email:\n return False\n if \"@\" not in email:\n return False\n if \".\" not in email:\n return False\n return True\n \n def authenticate_user(self, email, password):\n # More duplicate validation\n if not email:\n return None\n if not password:\n return None\n \n # Linear search through users - O(n) complexity\n for user_id, user_data in self.users.items():\n if user_data[\"email\"] == email:\n # Same password hashing logic duplicated\n password_hash = hashlib.sha256((password + \"salt123\").encode()).hexdigest()\n if user_data[\"password_hash\"] == password_hash:\n # Update login stats\n user_data[\"last_login\"] = time.time()\n user_data[\"login_count\"] += 1\n user_data[\"failed_login_attempts\"] = 0\n return user_id\n else:\n # Failed login handling\n user_data[\"failed_login_attempts\"] += 1\n if user_data[\"failed_login_attempts\"] >= 5: # Magic number\n user_data[\"locked_until\"] = time.time() + 1800 # 30 minutes\n return None\n return None\n \n def get_user(self, user_id):\n # No error handling\n return self.users[user_id]\n \n def update_user(self, user_id, updates):\n try:\n # Empty catch block - bad practice\n user = self.users[user_id]\n except:\n pass\n \n # More validation duplication\n if \"age\" in updates:\n if updates[\"age\"] \u003c 13:\n print(\"User must be at least 13 years old\")\n return False\n if updates[\"age\"] > 150:\n print(\"Invalid age\") \n return False\n \n if \"email\" in updates:\n if not self.validate_email(updates[\"email\"]):\n print(\"Invalid email format\")\n return False\n \n # Direct dictionary manipulation without validation\n for key, value in updates.items():\n user[key] = value\n \n user[\"updated_at\"] = time.time()\n return True\n \n def delete_user(self, user_id):\n # print(\"Deleting user\", user_id) # Commented out code\n # TODO: Implement soft delete instead\n del self.users[user_id]\n \n def search_users(self, query):\n results = []\n # Inefficient search algorithm - O(n*m) \n for user_id, user_data in self.users.items():\n if query.lower() in user_data[\"name\"].lower():\n results.append(user_data)\n elif query.lower() in user_data[\"email\"].lower():\n results.append(user_data)\n elif query in user_data.get(\"phone\", \"\"):\n results.append(user_data)\n return results\n \n def export_users(self):\n # Security risk - no access control\n return json.dumps(self.users, indent=2)\n \n def import_users(self, json_data):\n # No validation of imported data\n imported_users = json.loads(json_data)\n self.users.update(imported_users)\n \n # def old_create_user(self, name, email):\n # # Old implementation kept as comment\n # return {\"name\": name, \"email\": email}\n \n def calculate_user_score(self, user_id):\n user = self.users[user_id]\n score = 0\n \n # Complex scoring logic with magic numbers\n if user[\"login_count\"] > 10:\n score += 50\n elif user[\"login_count\"] > 5:\n score += 30\n elif user[\"login_count\"] > 1:\n score += 10\n \n if user[\"subscription_level\"] == \"premium\":\n score += 100\n elif user[\"subscription_level\"] == \"pro\": \n score += 75\n elif user[\"subscription_level\"] == \"basic\":\n score += 25\n \n # Age-based scoring with arbitrary rules\n if user[\"age\"] >= 18 and user[\"age\"] \u003c= 65:\n score += 20\n elif user[\"age\"] > 65:\n score += 10\n \n return score\n\n\n# Global variable - should be encapsulated\nuser_service_instance = UserService()\n\n\ndef get_user_service():\n return user_service_instance\n\n\n# Utility function that should be in separate module\ndef hash_password(password, salt=\"salt123\"):\n # Hardcoded salt - security issue\n return hashlib.sha256((password + salt).encode()).hexdigest()\n\n\n# Another utility function with duplicate logic\ndef validate_password(password):\n if len(password) \u003c 8:\n return False, \"Password too short\"\n if not re.search(r\"[A-Z]\", password):\n return False, \"Password must contain uppercase letter\"\n if not re.search(r\"[a-z]\", password):\n return False, \"Password must contain lowercase letter\" \n if not re.search(r\"\\d\", password):\n return False, \"Password must contain digit\"\n return True, \"Valid password\"","content_type":"text/x-python; charset=utf-8","language":"python","size":9498,"content_sha256":"f948b98c2b9ed10227fe7b4770e90c396a09b25cda71e66ac48e4a42f2fe5213"},{"filename":"assets/sample_debt_inventory.json","content":"[\n {\n \"id\": \"DEBT-0001\",\n \"type\": \"large_function\",\n \"description\": \"create_user function in user_service.py is 89 lines long\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 13,\n \"severity\": \"high\",\n \"metadata\": {\n \"function_name\": \"create_user\",\n \"length\": 89,\n \"recommended_max\": 50\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0002\",\n \"type\": \"duplicate_code\",\n \"description\": \"Password validation logic duplicated in 3 locations\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 45,\n \"severity\": \"medium\",\n \"metadata\": {\n \"duplicate_count\": 3,\n \"other_files\": [\"src/auth.py\", \"src/frontend.js\"]\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0003\",\n \"type\": \"security_risk\",\n \"description\": \"Hardcoded API key in payment_processor.py\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 10,\n \"severity\": \"critical\",\n \"metadata\": {\n \"security_issue\": \"hardcoded_credentials\",\n \"exposure_risk\": \"high\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0004\",\n \"type\": \"high_complexity\",\n \"description\": \"process_payment function has cyclomatic complexity of 24\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 19,\n \"severity\": \"high\",\n \"metadata\": {\n \"function_name\": \"process_payment\",\n \"complexity\": 24,\n \"recommended_max\": 10\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0005\",\n \"type\": \"missing_docstring\",\n \"description\": \"PaymentProcessor class missing docstring\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 8,\n \"severity\": \"low\",\n \"metadata\": {\n \"class_name\": \"PaymentProcessor\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0006\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO: Move this to configuration file\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 8,\n \"severity\": \"low\",\n \"metadata\": {\n \"comment\": \"TODO: Move this to configuration file\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0007\",\n \"type\": \"empty_catch_blocks\",\n \"description\": \"Empty catch block in update_user method\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 156,\n \"severity\": \"medium\",\n \"metadata\": {\n \"method_name\": \"update_user\",\n \"exception_type\": \"generic\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0008\",\n \"type\": \"magic_numbers\",\n \"description\": \"Magic number 1800 used for lock timeout\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 98,\n \"severity\": \"low\",\n \"metadata\": {\n \"value\": 1800,\n \"context\": \"account_lockout_duration\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0009\",\n \"type\": \"deep_nesting\",\n \"description\": \"Deep nesting detected: 6 levels in preferences handling\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 32,\n \"severity\": \"medium\",\n \"metadata\": {\n \"nesting_level\": 6,\n \"recommended_max\": 4\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0010\",\n \"type\": \"long_line\",\n \"description\": \"Line too long: 156 characters\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 127,\n \"severity\": \"low\",\n \"metadata\": {\n \"length\": 156,\n \"recommended_max\": 120\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0011\",\n \"type\": \"commented_code\",\n \"description\": \"Dead code left in comments\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 285,\n \"severity\": \"low\",\n \"metadata\": {\n \"lines_of_commented_code\": 8\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0012\",\n \"type\": \"global_variables\",\n \"description\": \"Global variable userCache should be encapsulated\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 7,\n \"severity\": \"medium\",\n \"metadata\": {\n \"variable_name\": \"userCache\",\n \"scope\": \"global\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0013\",\n \"type\": \"synchronous_ajax\",\n \"description\": \"Synchronous AJAX call blocks UI thread\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 189,\n \"severity\": \"high\",\n \"metadata\": {\n \"method\": \"XMLHttpRequest\",\n \"async\": false\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0014\",\n \"type\": \"hardcoded_values\",\n \"description\": \"Tax rates hardcoded in payment processing logic\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 45,\n \"severity\": \"medium\",\n \"metadata\": {\n \"values\": [\"0.08\", \"0.085\", \"0.0625\", \"0.06\"],\n \"context\": \"tax_calculation\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0015\",\n \"type\": \"no_error_handling\",\n \"description\": \"API calls without proper error handling\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 78,\n \"severity\": \"high\",\n \"metadata\": {\n \"api_endpoint\": \"stripe\",\n \"error_scenarios\": [\"network_failure\", \"invalid_response\"]\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0016\",\n \"type\": \"inefficient_algorithm\",\n \"description\": \"O(n) user search could be optimized with indexing\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 178,\n \"severity\": \"medium\",\n \"metadata\": {\n \"current_complexity\": \"O(n)\",\n \"recommended_complexity\": \"O(log n)\",\n \"method_name\": \"search_users\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0017\",\n \"type\": \"memory_leak_risk\",\n \"description\": \"Event listeners attached without cleanup\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 145,\n \"severity\": \"medium\",\n \"metadata\": {\n \"event_type\": \"click\",\n \"cleanup_missing\": true\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0018\",\n \"type\": \"sql_injection_risk\",\n \"description\": \"Potential SQL injection in user query\",\n \"file_path\": \"src/database.py\",\n \"line_number\": 25,\n \"severity\": \"critical\",\n \"metadata\": {\n \"query_type\": \"dynamic\",\n \"user_input\": \"unsanitized\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0019\",\n \"type\": \"outdated_dependency\",\n \"description\": \"jQuery version 2.1.4 has known security vulnerabilities\",\n \"file_path\": \"package.json\",\n \"line_number\": 15,\n \"severity\": \"high\",\n \"metadata\": {\n \"package\": \"jquery\",\n \"current_version\": \"2.1.4\",\n \"latest_version\": \"3.6.4\",\n \"vulnerabilities\": [\"CVE-2020-11022\", \"CVE-2020-11023\"]\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n },\n {\n \"id\": \"DEBT-0020\",\n \"type\": \"test_debt\",\n \"description\": \"No unit tests for critical payment processing logic\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 19,\n \"severity\": \"high\",\n \"metadata\": {\n \"coverage\": 0,\n \"critical_paths\": [\"process_payment\", \"refund_payment\"],\n \"risk_level\": \"high\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\"\n }\n]","content_type":"application/json; charset=utf-8","language":"json","size":7788,"content_sha256":"3c72c6947de5bde8f8517e693633d8aba64e59cdc3060ce8ff7245942509acc9"},{"filename":"expected_outputs/sample_dashboard_output.json","content":"{\n \"metadata\": {\n \"generated_date\": \"2026-02-16T12:59:34.530390\",\n \"analysis_period\": \"monthly\",\n \"snapshots_analyzed\": 2,\n \"date_range\": {\n \"start\": \"2024-01-15T09:00:00\",\n \"end\": \"2024-02-01T14:30:00\"\n },\n \"team_size\": 5\n },\n \"executive_summary\": {\n \"overall_status\": \"excellent\",\n \"health_score\": 87.3,\n \"status_message\": \"Code quality is excellent with minimal technical debt.\",\n \"key_insights\": [\n \"Good progress on debt reduction\"\n ],\n \"total_debt_items\": 22,\n \"estimated_effort_hours\": 193.5,\n \"high_priority_items\": 6,\n \"velocity_impact_percent\": 12.3\n },\n \"current_health\": {\n \"overall_score\": 87.3,\n \"debt_density\": 0.81,\n \"velocity_impact\": 12.3,\n \"quality_score\": 81.8,\n \"maintainability_score\": 72.7,\n \"technical_risk_score\": 38.2,\n \"date\": \"2024-02-01T14:30:00\"\n },\n \"trend_analysis\": {\n \"overall_score\": {\n \"metric_name\": \"overall_score\",\n \"trend_direction\": \"improving\",\n \"change_rate\": 3.7,\n \"correlation_strength\": 0.0,\n \"forecast_next_period\": 91.0,\n \"confidence_interval\": [\n 91.0,\n 91.0\n ]\n },\n \"debt_density\": {\n \"metric_name\": \"debt_density\",\n \"trend_direction\": \"improving\",\n \"change_rate\": -0.31,\n \"correlation_strength\": 0.0,\n \"forecast_next_period\": 0.5,\n \"confidence_interval\": [\n 0.5,\n 0.5\n ]\n },\n \"velocity_impact\": {\n \"metric_name\": \"velocity_impact\",\n \"trend_direction\": \"improving\",\n \"change_rate\": -2.9,\n \"correlation_strength\": 0.0,\n \"forecast_next_period\": 9.4,\n \"confidence_interval\": [\n 9.4,\n 9.4\n ]\n },\n \"quality_score\": {\n \"metric_name\": \"quality_score\",\n \"trend_direction\": \"declining\",\n \"change_rate\": -3.9,\n \"correlation_strength\": 0.0,\n \"forecast_next_period\": 77.9,\n \"confidence_interval\": [\n 77.9,\n 77.9\n ]\n },\n \"technical_risk_score\": {\n \"metric_name\": \"technical_risk_score\",\n \"trend_direction\": \"improving\",\n \"change_rate\": -47.5,\n \"correlation_strength\": 0.0,\n \"forecast_next_period\": -9.3,\n \"confidence_interval\": [\n -9.3,\n -9.3\n ]\n }\n },\n \"debt_velocity\": [\n {\n \"period\": \"2024-01-15 to 2024-02-01\",\n \"new_debt_items\": 0,\n \"resolved_debt_items\": 6,\n \"net_change\": -6,\n \"velocity_ratio\": 10.0,\n \"effort_hours_added\": 0,\n \"effort_hours_resolved\": 77.0,\n \"net_effort_change\": -77.0\n }\n ],\n \"forecasts\": {\n \"health_score_3_months\": 98.4,\n \"health_score_6_months\": 100,\n \"debt_count_3_months\": 4,\n \"debt_count_6_months\": 0,\n \"risk_score_3_months\": 0\n },\n \"recommendations\": [\n {\n \"priority\": \"medium\",\n \"category\": \"focus_area\",\n \"title\": \"Focus on Other Debt\",\n \"description\": \"Other represents the largest debt category (16 items). Consider targeted initiatives.\",\n \"impact\": \"medium\",\n \"effort\": \"medium\"\n }\n ],\n \"visualizations\": {\n \"health_timeline\": [\n {\n \"date\": \"2024-01-15\",\n \"overall_score\": 83.6,\n \"quality_score\": 85.7,\n \"technical_risk\": 85.7\n },\n {\n \"date\": \"2024-02-01\",\n \"overall_score\": 87.3,\n \"quality_score\": 81.8,\n \"technical_risk\": 38.2\n }\n ],\n \"debt_accumulation\": [\n {\n \"date\": \"2024-01-15\",\n \"total_debt\": 28,\n \"high_priority\": 9,\n \"security_debt\": 5\n },\n {\n \"date\": \"2024-02-01\",\n \"total_debt\": 22,\n \"high_priority\": 6,\n \"security_debt\": 2\n }\n ],\n \"category_distribution\": [\n {\n \"category\": \"code_quality\",\n \"count\": 5\n },\n {\n \"category\": \"other\",\n \"count\": 16\n },\n {\n \"category\": \"maintenance\",\n \"count\": 1\n }\n ],\n \"debt_velocity\": [\n {\n \"period\": \"2024-01-15 to 2024-02-01\",\n \"new_items\": 0,\n \"resolved_items\": 6,\n \"net_change\": -6,\n \"velocity_ratio\": 10.0\n }\n ],\n \"effort_trend\": [\n {\n \"date\": \"2024-01-15\",\n \"total_effort\": 270.5\n },\n {\n \"date\": \"2024-02-01\",\n \"total_effort\": 193.5\n }\n ]\n },\n \"detailed_metrics\": {\n \"debt_breakdown\": {\n \"large_function\": 1,\n \"duplicate_code\": 1,\n \"high_complexity\": 1,\n \"missing_docstring\": 1,\n \"empty_catch_blocks\": 1,\n \"deep_nesting\": 1,\n \"long_line\": 1,\n \"commented_code\": 1,\n \"global_variables\": 1,\n \"synchronous_ajax\": 1,\n \"hardcoded_values\": 1,\n \"no_error_handling\": 1,\n \"inefficient_algorithm\": 1,\n \"memory_leak_risk\": 1,\n \"large_class\": 1,\n \"circular_dependency\": 1,\n \"broad_exception\": 1,\n \"missing_validation\": 1,\n \"performance_issue\": 1,\n \"css_debt\": 1,\n \"accessibility_issue\": 1,\n \"configuration_debt\": 1\n },\n \"severity_breakdown\": {\n \"high\": 6,\n \"medium\": 12,\n \"low\": 4\n },\n \"category_breakdown\": {\n \"code_quality\": 5,\n \"other\": 16,\n \"maintenance\": 1\n },\n \"files_analyzed\": 27,\n \"debt_density\": 0.8148148148148148,\n \"average_effort_per_item\": 8.795454545454545\n }\n}","content_type":"application/json; charset=utf-8","language":"json","size":5274,"content_sha256":"4b14c1ebbb20ed884cb6dc8337bff5da0f9f7b0b7569aca4d912dbf48d34e5e7"},{"filename":"expected_outputs/sample_prioritization_output.json","content":"{\n \"metadata\": {\n \"analysis_date\": \"2026-02-16T12:59:31.382843\",\n \"framework_used\": \"cost_of_delay\",\n \"team_size\": 5,\n \"sprint_capacity_hours\": 80,\n \"total_items_analyzed\": 20\n },\n \"prioritized_backlog\": [\n {\n \"id\": \"DEBT-0008\",\n \"type\": \"magic_numbers\",\n \"description\": \"Magic number 1800 used for lock timeout\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 98,\n \"severity\": \"low\",\n \"metadata\": {\n \"value\": 1800,\n \"context\": \"account_lockout_duration\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 1,\n \"hours_estimate\": 5.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 2,\n \"revenue_impact\": 2,\n \"team_velocity_impact\": 3,\n \"quality_impact\": 3,\n \"security_impact\": 2\n },\n \"interest_rate\": {\n \"daily_cost\": 2.4,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 2.1,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.8\n },\n {\n \"id\": \"DEBT-0010\",\n \"type\": \"long_line\",\n \"description\": \"Line too long: 156 characters\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 127,\n \"severity\": \"low\",\n \"metadata\": {\n \"length\": 156,\n \"recommended_max\": 120\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 1,\n \"hours_estimate\": 0.375,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"junior\",\n \"confidence\": 0.95\n },\n \"business_impact\": {\n \"customer_impact\": 2,\n \"revenue_impact\": 2,\n \"team_velocity_impact\": 3,\n \"quality_impact\": 3,\n \"security_impact\": 2\n },\n \"interest_rate\": {\n \"daily_cost\": 2.4,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 0.16,\n \"category\": \"code_quality\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.8\n },\n {\n \"id\": \"DEBT-0011\",\n \"type\": \"commented_code\",\n \"description\": \"Dead code left in comments\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 285,\n \"severity\": \"low\",\n \"metadata\": {\n \"lines_of_commented_code\": 8\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 1,\n \"hours_estimate\": 5.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 2,\n \"revenue_impact\": 2,\n \"team_velocity_impact\": 3,\n \"quality_impact\": 3,\n \"security_impact\": 2\n },\n \"interest_rate\": {\n \"daily_cost\": 2.4,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 2.1,\n \"category\": \"maintenance\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.8\n },\n {\n \"id\": \"DEBT-0007\",\n \"type\": \"empty_catch_blocks\",\n \"description\": \"Empty catch block in update_user method\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 156,\n \"severity\": \"medium\",\n \"metadata\": {\n \"method_name\": \"update_user\",\n \"exception_type\": \"generic\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n },\n {\n \"id\": \"DEBT-0009\",\n \"type\": \"deep_nesting\",\n \"description\": \"Deep nesting detected: 6 levels in preferences handling\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 32,\n \"severity\": \"medium\",\n \"metadata\": {\n \"nesting_level\": 6,\n \"recommended_max\": 4\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n },\n {\n \"id\": \"DEBT-0012\",\n \"type\": \"global_variables\",\n \"description\": \"Global variable userCache should be encapsulated\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 7,\n \"severity\": \"medium\",\n \"metadata\": {\n \"variable_name\": \"userCache\",\n \"scope\": \"global\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n },\n {\n \"id\": \"DEBT-0014\",\n \"type\": \"hardcoded_values\",\n \"description\": \"Tax rates hardcoded in payment processing logic\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 45,\n \"severity\": \"medium\",\n \"metadata\": {\n \"values\": [\n \"0.08\",\n \"0.085\",\n \"0.0625\",\n \"0.06\"\n ],\n \"context\": \"tax_calculation\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n },\n {\n \"id\": \"DEBT-0016\",\n \"type\": \"inefficient_algorithm\",\n \"description\": \"O(n) user search could be optimized with indexing\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 178,\n \"severity\": \"medium\",\n \"metadata\": {\n \"current_complexity\": \"O(n)\",\n \"recommended_complexity\": \"O(log n)\",\n \"method_name\": \"search_users\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n },\n {\n \"id\": \"DEBT-0017\",\n \"type\": \"memory_leak_risk\",\n \"description\": \"Event listeners attached without cleanup\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 145,\n \"severity\": \"medium\",\n \"metadata\": {\n \"event_type\": \"click\",\n \"cleanup_missing\": true\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n },\n {\n \"id\": \"DEBT-0001\",\n \"type\": \"large_function\",\n \"description\": \"create_user function in user_service.py is 89 lines long\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 13,\n \"severity\": \"high\",\n \"metadata\": {\n \"function_name\": \"create_user\",\n \"length\": 89,\n \"recommended_max\": 50\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 15.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.7\n },\n \"business_impact\": {\n \"customer_impact\": 4,\n \"revenue_impact\": 6,\n \"team_velocity_impact\": 10,\n \"quality_impact\": 8,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 7.4,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.03\n },\n \"cost_of_delay\": 19.48,\n \"category\": \"code_quality\",\n \"impact_tags\": [\n \"velocity-blocker\",\n \"quality-risk\",\n \"quick-win\"\n ],\n \"priority_score\": 4.26\n },\n {\n \"id\": \"DEBT-0005\",\n \"type\": \"missing_docstring\",\n \"description\": \"PaymentProcessor class missing docstring\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 8,\n \"severity\": \"low\",\n \"metadata\": {\n \"class_name\": \"PaymentProcessor\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 1,\n \"hours_estimate\": 1.25,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"junior\",\n \"confidence\": 0.9\n },\n \"business_impact\": {\n \"customer_impact\": 1,\n \"revenue_impact\": 1,\n \"team_velocity_impact\": 2,\n \"quality_impact\": 2,\n \"security_impact\": 1\n },\n \"interest_rate\": {\n \"daily_cost\": 1.6,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 0.35,\n \"category\": \"code_quality\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.1\n },\n {\n \"id\": \"DEBT-0013\",\n \"type\": \"synchronous_ajax\",\n \"description\": \"Synchronous AJAX call blocks UI thread\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 189,\n \"severity\": \"high\",\n \"metadata\": {\n \"method\": \"XMLHttpRequest\",\n \"async\": false\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 15.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 4,\n \"revenue_impact\": 4,\n \"team_velocity_impact\": 7,\n \"quality_impact\": 7,\n \"security_impact\": 4\n },\n \"interest_rate\": {\n \"daily_cost\": 5.6,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 14.73,\n \"category\": \"other\",\n \"impact_tags\": [\n \"velocity-blocker\",\n \"quality-risk\",\n \"quick-win\"\n ],\n \"priority_score\": 3.73\n },\n {\n \"id\": \"DEBT-0015\",\n \"type\": \"no_error_handling\",\n \"description\": \"API calls without proper error handling\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 78,\n \"severity\": \"high\",\n \"metadata\": {\n \"api_endpoint\": \"stripe\",\n \"error_scenarios\": [\n \"network_failure\",\n \"invalid_response\"\n ]\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 15.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 4,\n \"revenue_impact\": 4,\n \"team_velocity_impact\": 7,\n \"quality_impact\": 7,\n \"security_impact\": 4\n },\n \"interest_rate\": {\n \"daily_cost\": 5.6,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 14.73,\n \"category\": \"other\",\n \"impact_tags\": [\n \"velocity-blocker\",\n \"quality-risk\",\n \"quick-win\"\n ],\n \"priority_score\": 3.73\n },\n {\n \"id\": \"DEBT-0019\",\n \"type\": \"outdated_dependency\",\n \"description\": \"jQuery version 2.1.4 has known security vulnerabilities\",\n \"file_path\": \"package.json\",\n \"line_number\": 15,\n \"severity\": \"high\",\n \"metadata\": {\n \"package\": \"jquery\",\n \"current_version\": \"2.1.4\",\n \"latest_version\": \"3.6.4\",\n \"vulnerabilities\": [\n \"CVE-2020-11022\",\n \"CVE-2020-11023\"\n ]\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 15.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 4,\n \"revenue_impact\": 4,\n \"team_velocity_impact\": 7,\n \"quality_impact\": 7,\n \"security_impact\": 4\n },\n \"interest_rate\": {\n \"daily_cost\": 5.6,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 14.73,\n \"category\": \"other\",\n \"impact_tags\": [\n \"velocity-blocker\",\n \"quality-risk\",\n \"quick-win\"\n ],\n \"priority_score\": 3.73\n },\n {\n \"id\": \"DEBT-0018\",\n \"type\": \"sql_injection_risk\",\n \"description\": \"Potential SQL injection in user query\",\n \"file_path\": \"src/database.py\",\n \"line_number\": 25,\n \"severity\": \"critical\",\n \"metadata\": {\n \"query_type\": \"dynamic\",\n \"user_input\": \"unsanitized\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 3,\n \"hours_estimate\": 20.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 5,\n \"revenue_impact\": 5,\n \"team_velocity_impact\": 9,\n \"quality_impact\": 9,\n \"security_impact\": 5\n },\n \"interest_rate\": {\n \"daily_cost\": 7.199999999999999,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 25.26,\n \"category\": \"other\",\n \"impact_tags\": [\n \"velocity-blocker\",\n \"quality-risk\",\n \"quick-win\"\n ],\n \"priority_score\": 3.24\n },\n {\n \"id\": \"DEBT-0006\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO: Move this to configuration file\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 8,\n \"severity\": \"low\",\n \"metadata\": {\n \"comment\": \"TODO: Move this to configuration file\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 1,\n \"hours_estimate\": 0.75,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"junior\",\n \"confidence\": 0.9\n },\n \"business_impact\": {\n \"customer_impact\": 1,\n \"revenue_impact\": 1,\n \"team_velocity_impact\": 1,\n \"quality_impact\": 1,\n \"security_impact\": 1\n },\n \"interest_rate\": {\n \"daily_cost\": 0.8,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.01\n },\n \"cost_of_delay\": 0.11,\n \"category\": \"maintenance\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 3.1\n },\n {\n \"id\": \"DEBT-0002\",\n \"type\": \"duplicate_code\",\n \"description\": \"Password validation logic duplicated in 3 locations\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 45,\n \"severity\": \"medium\",\n \"metadata\": {\n \"duplicate_count\": 3,\n \"other_files\": [\n \"src/auth.py\",\n \"src/frontend.js\"\n ]\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 15.0,\n \"risk_factor\": 1.4,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 4,\n \"team_velocity_impact\": 6,\n \"quality_impact\": 6,\n \"security_impact\": 2\n },\n \"interest_rate\": {\n \"daily_cost\": 4.8,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.08\n },\n \"cost_of_delay\": 12.69,\n \"category\": \"code_quality\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 2.39\n },\n {\n \"id\": \"DEBT-0020\",\n \"type\": \"test_debt\",\n \"description\": \"No unit tests for critical payment processing logic\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 19,\n \"severity\": \"high\",\n \"metadata\": {\n \"coverage\": 0,\n \"critical_paths\": [\n \"process_payment\",\n \"refund_payment\"\n ],\n \"risk_level\": \"high\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 6,\n \"hours_estimate\": 36.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 7,\n \"revenue_impact\": 7,\n \"team_velocity_impact\": 10,\n \"quality_impact\": 10,\n \"security_impact\": 4\n },\n \"interest_rate\": {\n \"daily_cost\": 8.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.04\n },\n \"cost_of_delay\": 50.82,\n \"category\": \"testing\",\n \"impact_tags\": [\n \"customer-facing\",\n \"revenue-impact\",\n \"velocity-blocker\",\n \"quality-risk\",\n \"quick-win\"\n ],\n \"priority_score\": 1.94\n },\n {\n \"id\": \"DEBT-0004\",\n \"type\": \"high_complexity\",\n \"description\": \"process_payment function has cyclomatic complexity of 24\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 19,\n \"severity\": \"high\",\n \"metadata\": {\n \"function_name\": \"process_payment\",\n \"complexity\": 24,\n \"recommended_max\": 10\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 5,\n \"hours_estimate\": 30.0,\n \"risk_factor\": 1.4,\n \"skill_level_required\": \"senior\",\n \"confidence\": 0.5\n },\n \"business_impact\": {\n \"customer_impact\": 6,\n \"revenue_impact\": 7,\n \"team_velocity_impact\": 10,\n \"quality_impact\": 10,\n \"security_impact\": 4\n },\n \"interest_rate\": {\n \"daily_cost\": 8.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.05\n },\n \"cost_of_delay\": 42.36,\n \"category\": \"code_quality\",\n \"impact_tags\": [\n \"revenue-impact\",\n \"velocity-blocker\",\n \"quality-risk\",\n \"quick-win\"\n ],\n \"priority_score\": 1.65\n },\n {\n \"id\": \"DEBT-0003\",\n \"type\": \"security_risk\",\n \"description\": \"Hardcoded API key in payment_processor.py\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 10,\n \"severity\": \"critical\",\n \"metadata\": {\n \"security_issue\": \"hardcoded_credentials\",\n \"exposure_risk\": \"high\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 7,\n \"hours_estimate\": 44.0,\n \"risk_factor\": 1.8,\n \"skill_level_required\": \"senior\",\n \"confidence\": 0.4\n },\n \"business_impact\": {\n \"customer_impact\": 10,\n \"revenue_impact\": 10,\n \"team_velocity_impact\": 10,\n \"quality_impact\": 10,\n \"security_impact\": 10\n },\n \"interest_rate\": {\n \"daily_cost\": 8.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 61.91,\n \"category\": \"security\",\n \"impact_tags\": [\n \"security-critical\",\n \"customer-facing\",\n \"revenue-impact\",\n \"velocity-blocker\",\n \"quality-risk\",\n \"quick-win\"\n ],\n \"priority_score\": 1.01\n }\n ],\n \"sprint_allocation\": {\n \"total_debt_hours\": 277.4,\n \"debt_capacity_per_sprint\": 16.0,\n \"total_sprints_needed\": 17,\n \"high_priority_items\": 0,\n \"sprint_plan\": [\n {\n \"sprint_number\": 1,\n \"items\": [\n {\n \"id\": \"DEBT-0008\",\n \"type\": \"magic_numbers\",\n \"description\": \"Magic number 1800 used for lock timeout\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 98,\n \"severity\": \"low\",\n \"metadata\": {\n \"value\": 1800,\n \"context\": \"account_lockout_duration\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 1,\n \"hours_estimate\": 5.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 2,\n \"revenue_impact\": 2,\n \"team_velocity_impact\": 3,\n \"quality_impact\": 3,\n \"security_impact\": 2\n },\n \"interest_rate\": {\n \"daily_cost\": 2.4,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 2.1,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.8\n },\n {\n \"id\": \"DEBT-0010\",\n \"type\": \"long_line\",\n \"description\": \"Line too long: 156 characters\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 127,\n \"severity\": \"low\",\n \"metadata\": {\n \"length\": 156,\n \"recommended_max\": 120\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 1,\n \"hours_estimate\": 0.375,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"junior\",\n \"confidence\": 0.95\n },\n \"business_impact\": {\n \"customer_impact\": 2,\n \"revenue_impact\": 2,\n \"team_velocity_impact\": 3,\n \"quality_impact\": 3,\n \"security_impact\": 2\n },\n \"interest_rate\": {\n \"daily_cost\": 2.4,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 0.16,\n \"category\": \"code_quality\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.8\n },\n {\n \"id\": \"DEBT-0011\",\n \"type\": \"commented_code\",\n \"description\": \"Dead code left in comments\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 285,\n \"severity\": \"low\",\n \"metadata\": {\n \"lines_of_commented_code\": 8\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 1,\n \"hours_estimate\": 5.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 2,\n \"revenue_impact\": 2,\n \"team_velocity_impact\": 3,\n \"quality_impact\": 3,\n \"security_impact\": 2\n },\n \"interest_rate\": {\n \"daily_cost\": 2.4,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 2.1,\n \"category\": \"maintenance\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.8\n }\n ],\n \"total_hours\": 10.375,\n \"capacity_used\": 0.6484375\n },\n {\n \"sprint_number\": 2,\n \"items\": [\n {\n \"id\": \"DEBT-0007\",\n \"type\": \"empty_catch_blocks\",\n \"description\": \"Empty catch block in update_user method\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 156,\n \"severity\": \"medium\",\n \"metadata\": {\n \"method_name\": \"update_user\",\n \"exception_type\": \"generic\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n }\n ],\n \"total_hours\": 10.0,\n \"capacity_used\": 0.625\n },\n {\n \"sprint_number\": 3,\n \"items\": [\n {\n \"id\": \"DEBT-0009\",\n \"type\": \"deep_nesting\",\n \"description\": \"Deep nesting detected: 6 levels in preferences handling\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 32,\n \"severity\": \"medium\",\n \"metadata\": {\n \"nesting_level\": 6,\n \"recommended_max\": 4\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n }\n ],\n \"total_hours\": 10.0,\n \"capacity_used\": 0.625\n },\n {\n \"sprint_number\": 4,\n \"items\": [\n {\n \"id\": \"DEBT-0012\",\n \"type\": \"global_variables\",\n \"description\": \"Global variable userCache should be encapsulated\",\n \"file_path\": \"src/frontend.js\",\n \"line_number\": 7,\n \"severity\": \"medium\",\n \"metadata\": {\n \"variable_name\": \"userCache\",\n \"scope\": \"global\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n }\n ],\n \"total_hours\": 10.0,\n \"capacity_used\": 0.625\n },\n {\n \"sprint_number\": 5,\n \"items\": [\n {\n \"id\": \"DEBT-0014\",\n \"type\": \"hardcoded_values\",\n \"description\": \"Tax rates hardcoded in payment processing logic\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 45,\n \"severity\": \"medium\",\n \"metadata\": {\n \"values\": [\n \"0.08\",\n \"0.085\",\n \"0.0625\",\n \"0.06\"\n ],\n \"context\": \"tax_calculation\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n }\n ],\n \"total_hours\": 10.0,\n \"capacity_used\": 0.625\n },\n {\n \"sprint_number\": 6,\n \"items\": [\n {\n \"id\": \"DEBT-0016\",\n \"type\": \"inefficient_algorithm\",\n \"description\": \"O(n) user search could be optimized with indexing\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 178,\n \"severity\": \"medium\",\n \"metadata\": {\n \"current_complexity\": \"O(n)\",\n \"recommended_complexity\": \"O(log n)\",\n \"method_name\": \"search_users\"\n },\n \"detected_date\": \"2024-02-10T10:30:00\",\n \"status\": \"identified\",\n \"effort_estimate\": {\n \"size_points\": 2,\n \"hours_estimate\": 10.0,\n \"risk_factor\": 1.0,\n \"skill_level_required\": \"mid\",\n \"confidence\": 0.6\n },\n \"business_impact\": {\n \"customer_impact\": 3,\n \"revenue_impact\": 3,\n \"team_velocity_impact\": 5,\n \"quality_impact\": 5,\n \"security_impact\": 3\n },\n \"interest_rate\": {\n \"daily_cost\": 4.0,\n \"frequency_multiplier\": 1.0,\n \"team_impact_multiplier\": 1.0,\n \"compound_rate\": 0.02\n },\n \"cost_of_delay\": 7.01,\n \"category\": \"other\",\n \"impact_tags\": [\n \"quick-win\"\n ],\n \"priority_score\": 4.72\n }\n ],\n \"total_hours\": 10.0,\n \"capacity_used\": 0.625\n }\n ],\n \"recommendations\": [\n \"Allocate 16.0 hours per sprint to tech debt\",\n \"Focus on 0 high-priority items first\",\n \"Estimated 17 sprints to clear current backlog\"\n ]\n },\n \"insights\": {\n \"category_distribution\": {\n \"other\": 11,\n \"code_quality\": 5,\n \"maintenance\": 2,\n \"testing\": 1,\n \"security\": 1\n },\n \"total_effort_hours\": 277.4,\n \"effort_by_category\": {\n \"other\": 130.0,\n \"code_quality\": 61.6,\n \"maintenance\": 5.8,\n \"testing\": 36.0,\n \"security\": 44.0\n },\n \"priority_distribution\": {\n \"medium\": 17,\n \"low\": 3\n },\n \"high_risk_items_count\": 1,\n \"quick_wins_count\": 5,\n \"total_cost_of_delay\": 303.6,\n \"average_daily_interest_rate\": 4.69,\n \"top_categories_by_effort\": [\n [\n \"other\",\n 130.0\n ],\n [\n \"code_quality\",\n 61.625\n ],\n [\n \"security\",\n 44.0\n ]\n ]\n },\n \"charts_data\": {\n \"priority_effort_scatter\": [\n {\n \"x\": 5.0,\n \"y\": 4.8,\n \"label\": \"Magic number 1800 used for lock timeout\",\n \"category\": \"other\",\n \"size\": 2.1\n },\n {\n \"x\": 0.375,\n \"y\": 4.8,\n \"label\": \"Line too long: 156 characters\",\n \"category\": \"code_quality\",\n \"size\": 0.16\n },\n {\n \"x\": 5.0,\n \"y\": 4.8,\n \"label\": \"Dead code left in comments\",\n \"category\": \"maintenance\",\n \"size\": 2.1\n },\n {\n \"x\": 10.0,\n \"y\": 4.72,\n \"label\": \"Empty catch block in update_user method\",\n \"category\": \"other\",\n \"size\": 7.01\n },\n {\n \"x\": 10.0,\n \"y\": 4.72,\n \"label\": \"Deep nesting detected: 6 levels in preferences han\",\n \"category\": \"other\",\n \"size\": 7.01\n },\n {\n \"x\": 10.0,\n \"y\": 4.72,\n \"label\": \"Global variable userCache should be encapsulated\",\n \"category\": \"other\",\n \"size\": 7.01\n },\n {\n \"x\": 10.0,\n \"y\": 4.72,\n \"label\": \"Tax rates hardcoded in payment processing logic\",\n \"category\": \"other\",\n \"size\": 7.01\n },\n {\n \"x\": 10.0,\n \"y\": 4.72,\n \"label\": \"O(n) user search could be optimized with indexing\",\n \"category\": \"other\",\n \"size\": 7.01\n },\n {\n \"x\": 10.0,\n \"y\": 4.72,\n \"label\": \"Event listeners attached without cleanup\",\n \"category\": \"other\",\n \"size\": 7.01\n },\n {\n \"x\": 15.0,\n \"y\": 4.26,\n \"label\": \"create_user function in user_service.py is 89 line\",\n \"category\": \"code_quality\",\n \"size\": 19.48\n },\n {\n \"x\": 1.25,\n \"y\": 4.1,\n \"label\": \"PaymentProcessor class missing docstring\",\n \"category\": \"code_quality\",\n \"size\": 0.35\n },\n {\n \"x\": 15.0,\n \"y\": 3.73,\n \"label\": \"Synchronous AJAX call blocks UI thread\",\n \"category\": \"other\",\n \"size\": 14.73\n },\n {\n \"x\": 15.0,\n \"y\": 3.73,\n \"label\": \"API calls without proper error handling\",\n \"category\": \"other\",\n \"size\": 14.73\n },\n {\n \"x\": 15.0,\n \"y\": 3.73,\n \"label\": \"jQuery version 2.1.4 has known security vulnerabil\",\n \"category\": \"other\",\n \"size\": 14.73\n },\n {\n \"x\": 20.0,\n \"y\": 3.24,\n \"label\": \"Potential SQL injection in user query\",\n \"category\": \"other\",\n \"size\": 25.26\n },\n {\n \"x\": 0.75,\n \"y\": 3.1,\n \"label\": \"TODO: Move this to configuration file\",\n \"category\": \"maintenance\",\n \"size\": 0.11\n },\n {\n \"x\": 15.0,\n \"y\": 2.39,\n \"label\": \"Password validation logic duplicated in 3 location\",\n \"category\": \"code_quality\",\n \"size\": 12.69\n },\n {\n \"x\": 36.0,\n \"y\": 1.94,\n \"label\": \"No unit tests for critical payment processing logi\",\n \"category\": \"testing\",\n \"size\": 50.82\n },\n {\n \"x\": 30.0,\n \"y\": 1.65,\n \"label\": \"process_payment function has cyclomatic complexity\",\n \"category\": \"code_quality\",\n \"size\": 42.36\n },\n {\n \"x\": 44.0,\n \"y\": 1.01,\n \"label\": \"Hardcoded API key in payment_processor.py\",\n \"category\": \"security\",\n \"size\": 61.91\n }\n ],\n \"category_effort_distribution\": [\n {\n \"category\": \"other\",\n \"effort\": 130.0\n },\n {\n \"category\": \"code_quality\",\n \"effort\": 61.6\n },\n {\n \"category\": \"maintenance\",\n \"effort\": 5.8\n },\n {\n \"category\": \"testing\",\n \"effort\": 36.0\n },\n {\n \"category\": \"security\",\n \"effort\": 44.0\n }\n ],\n \"priority_timeline\": [\n {\n \"item_rank\": 1,\n \"description\": \"Magic number 1800 used for loc\",\n \"effort\": 5.0,\n \"cumulative_effort\": 5.0,\n \"priority_score\": 4.8\n },\n {\n \"item_rank\": 2,\n \"description\": \"Line too long: 156 characters\",\n \"effort\": 0.375,\n \"cumulative_effort\": 5.4,\n \"priority_score\": 4.8\n },\n {\n \"item_rank\": 3,\n \"description\": \"Dead code left in comments\",\n \"effort\": 5.0,\n \"cumulative_effort\": 10.4,\n \"priority_score\": 4.8\n },\n {\n \"item_rank\": 4,\n \"description\": \"Empty catch block in update_us\",\n \"effort\": 10.0,\n \"cumulative_effort\": 20.4,\n \"priority_score\": 4.72\n },\n {\n \"item_rank\": 5,\n \"description\": \"Deep nesting detected: 6 level\",\n \"effort\": 10.0,\n \"cumulative_effort\": 30.4,\n \"priority_score\": 4.72\n },\n {\n \"item_rank\": 6,\n \"description\": \"Global variable userCache shou\",\n \"effort\": 10.0,\n \"cumulative_effort\": 40.4,\n \"priority_score\": 4.72\n },\n {\n \"item_rank\": 7,\n \"description\": \"Tax rates hardcoded in payment\",\n \"effort\": 10.0,\n \"cumulative_effort\": 50.4,\n \"priority_score\": 4.72\n },\n {\n \"item_rank\": 8,\n \"description\": \"O(n) user search could be opti\",\n \"effort\": 10.0,\n \"cumulative_effort\": 60.4,\n \"priority_score\": 4.72\n },\n {\n \"item_rank\": 9,\n \"description\": \"Event listeners attached witho\",\n \"effort\": 10.0,\n \"cumulative_effort\": 70.4,\n \"priority_score\": 4.72\n },\n {\n \"item_rank\": 10,\n \"description\": \"create_user function in user_s\",\n \"effort\": 15.0,\n \"cumulative_effort\": 85.4,\n \"priority_score\": 4.26\n },\n {\n \"item_rank\": 11,\n \"description\": \"PaymentProcessor class missing\",\n \"effort\": 1.25,\n \"cumulative_effort\": 86.6,\n \"priority_score\": 4.1\n },\n {\n \"item_rank\": 12,\n \"description\": \"Synchronous AJAX call blocks U\",\n \"effort\": 15.0,\n \"cumulative_effort\": 101.6,\n \"priority_score\": 3.73\n },\n {\n \"item_rank\": 13,\n \"description\": \"API calls without proper error\",\n \"effort\": 15.0,\n \"cumulative_effort\": 116.6,\n \"priority_score\": 3.73\n },\n {\n \"item_rank\": 14,\n \"description\": \"jQuery version 2.1.4 has known\",\n \"effort\": 15.0,\n \"cumulative_effort\": 131.6,\n \"priority_score\": 3.73\n },\n {\n \"item_rank\": 15,\n \"description\": \"Potential SQL injection in use\",\n \"effort\": 20.0,\n \"cumulative_effort\": 151.6,\n \"priority_score\": 3.24\n },\n {\n \"item_rank\": 16,\n \"description\": \"TODO: Move this to configurati\",\n \"effort\": 0.75,\n \"cumulative_effort\": 152.4,\n \"priority_score\": 3.1\n },\n {\n \"item_rank\": 17,\n \"description\": \"Password validation logic dupl\",\n \"effort\": 15.0,\n \"cumulative_effort\": 167.4,\n \"priority_score\": 2.39\n },\n {\n \"item_rank\": 18,\n \"description\": \"No unit tests for critical pay\",\n \"effort\": 36.0,\n \"cumulative_effort\": 203.4,\n \"priority_score\": 1.94\n },\n {\n \"item_rank\": 19,\n \"description\": \"process_payment function has c\",\n \"effort\": 30.0,\n \"cumulative_effort\": 233.4,\n \"priority_score\": 1.65\n },\n {\n \"item_rank\": 20,\n \"description\": \"Hardcoded API key in payment_p\",\n \"effort\": 44.0,\n \"cumulative_effort\": 277.4,\n \"priority_score\": 1.01\n }\n ],\n \"interest_rate_trend\": [\n {\n \"item_index\": 0,\n \"daily_cost\": 2.4,\n \"category\": \"other\"\n },\n {\n \"item_index\": 1,\n \"daily_cost\": 2.4,\n \"category\": \"code_quality\"\n },\n {\n \"item_index\": 2,\n \"daily_cost\": 2.4,\n \"category\": \"maintenance\"\n },\n {\n \"item_index\": 3,\n \"daily_cost\": 4.0,\n \"category\": \"other\"\n },\n {\n \"item_index\": 4,\n \"daily_cost\": 4.0,\n \"category\": \"other\"\n },\n {\n \"item_index\": 5,\n \"daily_cost\": 4.0,\n \"category\": \"other\"\n },\n {\n \"item_index\": 6,\n \"daily_cost\": 4.0,\n \"category\": \"other\"\n },\n {\n \"item_index\": 7,\n \"daily_cost\": 4.0,\n \"category\": \"other\"\n },\n {\n \"item_index\": 8,\n \"daily_cost\": 4.0,\n \"category\": \"other\"\n },\n {\n \"item_index\": 9,\n \"daily_cost\": 7.4,\n \"category\": \"code_quality\"\n },\n {\n \"item_index\": 10,\n \"daily_cost\": 1.6,\n \"category\": \"code_quality\"\n },\n {\n \"item_index\": 11,\n \"daily_cost\": 5.6,\n \"category\": \"other\"\n },\n {\n \"item_index\": 12,\n \"daily_cost\": 5.6,\n \"category\": \"other\"\n },\n {\n \"item_index\": 13,\n \"daily_cost\": 5.6,\n \"category\": \"other\"\n },\n {\n \"item_index\": 14,\n \"daily_cost\": 7.199999999999999,\n \"category\": \"other\"\n },\n {\n \"item_index\": 15,\n \"daily_cost\": 0.8,\n \"category\": \"maintenance\"\n },\n {\n \"item_index\": 16,\n \"daily_cost\": 4.8,\n \"category\": \"code_quality\"\n },\n {\n \"item_index\": 17,\n \"daily_cost\": 8.0,\n \"category\": \"testing\"\n },\n {\n \"item_index\": 18,\n \"daily_cost\": 8.0,\n \"category\": \"code_quality\"\n },\n {\n \"item_index\": 19,\n \"daily_cost\": 8.0,\n \"category\": \"security\"\n }\n ]\n },\n \"recommendations\": [\n \"Start with 5 quick wins to build momentum and demonstrate immediate value from tech debt reduction efforts.\",\n \"Focus initial efforts on 'other' category debt, which represents the largest effort investment (130.0 hours).\"\n ]\n}","content_type":"application/json; charset=utf-8","language":"json","size":45654,"content_sha256":"4c4c024c64b5169bc5d8cc10d834d5934ad3b1fa7f9f2fc9ad1f14d85a8fbc11"},{"filename":"expected_outputs/sample_scan_output.json","content":"{\n \"scan_metadata\": {\n \"directory\": \"assets/sample_codebase\",\n \"scan_date\": \"2026-02-16T12:59:28.141103\",\n \"scanner_version\": \"1.0.0\",\n \"config\": {\n \"max_function_length\": 50,\n \"max_complexity\": 10,\n \"max_nesting_depth\": 4,\n \"max_file_size_lines\": 500,\n \"min_duplicate_lines\": 3,\n \"ignore_patterns\": [\n \"*.pyc\",\n \"__pycache__\",\n \".git\",\n \".svn\",\n \"node_modules\",\n \"build\",\n \"dist\",\n \"*.min.js\",\n \"*.map\"\n ],\n \"file_extensions\": {\n \"python\": [\n \".py\"\n ],\n \"javascript\": [\n \".js\",\n \".jsx\",\n \".ts\",\n \".tsx\"\n ],\n \"java\": [\n \".java\"\n ],\n \"csharp\": [\n \".cs\"\n ],\n \"cpp\": [\n \".cpp\",\n \".cc\",\n \".cxx\",\n \".c\",\n \".h\",\n \".hpp\"\n ],\n \"ruby\": [\n \".rb\"\n ],\n \"php\": [\n \".php\"\n ],\n \"go\": [\n \".go\"\n ],\n \"rust\": [\n \".rs\"\n ],\n \"kotlin\": [\n \".kt\"\n ]\n },\n \"comment_patterns\": {\n \"todo\": \"(?i)(TODO|FIXME|HACK|XXX|BUG)[\\\\s:]*(.+)\",\n \"commented_code\": \"^\\\\s*#.*[=(){}\\\\[\\\\];].*\",\n \"magic_numbers\": \"\\\\b\\\\d{2,}\\\\b\",\n \"long_strings\": \"[\\\"\\\\'](.{100,})[\\\"\\\\']\"\n },\n \"severity_weights\": {\n \"critical\": 10,\n \"high\": 7,\n \"medium\": 5,\n \"low\": 2,\n \"info\": 1\n }\n }\n },\n \"summary\": {\n \"total_files_scanned\": 3,\n \"total_lines_scanned\": 986,\n \"total_debt_items\": 122,\n \"health_score\": 0,\n \"debt_density\": 40.67,\n \"priority_breakdown\": {\n \"medium\": 81,\n \"low\": 41\n },\n \"type_breakdown\": {\n \"high_complexity\": 3,\n \"large_function\": 2,\n \"duplicate_code\": 68,\n \"too_many_parameters\": 2,\n \"empty_catch\": 1,\n \"hardcoded_paths\": 5,\n \"missing_docstring\": 22,\n \"long_line\": 2,\n \"todo_comment\": 17\n }\n },\n \"debt_items\": [\n {\n \"id\": \"DEBT-0005\",\n \"type\": \"high_complexity\",\n \"description\": \"Function 'create_user' has high complexity: 26\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 24,\n \"severity\": \"high\",\n \"metadata\": {\n \"function_name\": \"create_user\",\n \"complexity\": 26\n },\n \"detected_date\": \"2026-02-16T12:59:28.115457\",\n \"status\": \"identified\",\n \"priority_score\": 9,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0004\",\n \"type\": \"high_complexity\",\n \"description\": \"Function 'process_payment' has high complexity: 36\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 20,\n \"severity\": \"high\",\n \"metadata\": {\n \"function_name\": \"process_payment\",\n \"complexity\": 36\n },\n \"detected_date\": \"2026-02-16T12:59:28.125126\",\n \"status\": \"identified\",\n \"priority_score\": 9,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0010\",\n \"type\": \"high_complexity\",\n \"description\": \"Function 'validate_credit_card' has high complexity: 16\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 244,\n \"severity\": \"high\",\n \"metadata\": {\n \"function_name\": \"validate_credit_card\",\n \"complexity\": 16\n },\n \"detected_date\": \"2026-02-16T12:59:28.126081\",\n \"status\": \"identified\",\n \"priority_score\": 9,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0003\",\n \"type\": \"large_function\",\n \"description\": \"Function 'create_user' is too long: 101 lines\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 24,\n \"severity\": \"medium\",\n \"metadata\": {\n \"function_name\": \"create_user\",\n \"length\": 101\n },\n \"detected_date\": \"2026-02-16T12:59:28.114676\",\n \"status\": \"identified\",\n \"priority_score\": 7,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0003\",\n \"type\": \"large_function\",\n \"description\": \"Function 'process_payment' is too long: 196 lines\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 20,\n \"severity\": \"medium\",\n \"metadata\": {\n \"function_name\": \"process_payment\",\n \"length\": 196\n },\n \"detected_date\": \"2026-02-16T12:59:28.124441\",\n \"status\": \"identified\",\n \"priority_score\": 7,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0055\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 28,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140697\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0056\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 138,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140705\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0057\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 29,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140709\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0058\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 139,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140712\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0059\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 87,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140716\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0060\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 88,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140718\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0061\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 90,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140721\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0062\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 91,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140723\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0063\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 122,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140726\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0064\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 123,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140729\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0065\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 190,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140733\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0066\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 191,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140735\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0067\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 251,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140739\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0068\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 252,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140741\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0069\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 255,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140743\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0070\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 256,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140745\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0071\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 28,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140751\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0072\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 29,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140754\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0073\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 31,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140756\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0074\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 32,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140758\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0075\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 34,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140761\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0076\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 35,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140763\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0077\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 37,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140766\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0078\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 38,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140768\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0079\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 83,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140771\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0080\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 84,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140774\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0081\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 102,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140777\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0082\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 145,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140779\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0083\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 114,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140782\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0084\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 156,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140784\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0085\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 115,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140786\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0086\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 157,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140788\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0087\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 116,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140790\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0088\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 158,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140793\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0089\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 117,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140795\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0090\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 159,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140797\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0091\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 119,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140800\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0092\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 120,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140802\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0093\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 121,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140804\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0094\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 162,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140806\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0095\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 122,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140808\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0096\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 163,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140813\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0097\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 161,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140816\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0098\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 203,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140818\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0099\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 213,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140822\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0100\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 214,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140824\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0101\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 223,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140827\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0102\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 224,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140829\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0103\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 235,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140832\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0104\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 236,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140834\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0105\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 265,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140837\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0106\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 266,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140839\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0107\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 306,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140842\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0108\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 307,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140844\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0109\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 99,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140849\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0110\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 100,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140851\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0111\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 111,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140854\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0112\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 136,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140856\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0113\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 112,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140858\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0114\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 137,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140861\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0115\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 147,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140863\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0116\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 148,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140866\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0117\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 221,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140870\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0118\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 222,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140872\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0119\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 234,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140874\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0120\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 271,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140876\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0121\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 235,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140878\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0122\",\n \"type\": \"duplicate_code\",\n \"description\": \"Duplicate code block found in 2 files\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 272,\n \"duplicate_count\": 2,\n \"other_files\": []\n },\n \"detected_date\": \"2026-02-16T12:59:28.140885\",\n \"status\": \"identified\",\n \"priority_score\": 6,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0006\",\n \"type\": \"too_many_parameters\",\n \"description\": \"Function 'create_user' has too many parameters: 14\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 24,\n \"severity\": \"medium\",\n \"metadata\": {\n \"function_name\": \"create_user\",\n \"parameter_count\": 14\n },\n \"detected_date\": \"2026-02-16T12:59:28.115465\",\n \"status\": \"identified\",\n \"priority_score\": 5,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0025\",\n \"type\": \"empty_catch\",\n \"description\": \"Code smell detected: empty_catch\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 170,\n \"pattern\": \"except:\\n pass\\n \"\n },\n \"detected_date\": \"2026-02-16T12:59:28.120298\",\n \"status\": \"identified\",\n \"priority_score\": 5,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0005\",\n \"type\": \"too_many_parameters\",\n \"description\": \"Function 'process_payment' has too many parameters: 12\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 20,\n \"severity\": \"medium\",\n \"metadata\": {\n \"function_name\": \"process_payment\",\n \"parameter_count\": 12\n },\n \"detected_date\": \"2026-02-16T12:59:28.125130\",\n \"status\": \"identified\",\n \"priority_score\": 5,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0050\",\n \"type\": \"hardcoded_paths\",\n \"description\": \"Code smell detected: hardcoded_paths\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 166,\n \"pattern\": \"'/users/'\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.139558\",\n \"status\": \"identified\",\n \"priority_score\": 5,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0051\",\n \"type\": \"hardcoded_paths\",\n \"description\": \"Code smell detected: hardcoded_paths\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 233,\n \"pattern\": \"'/users/'\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.139584\",\n \"status\": \"identified\",\n \"priority_score\": 5,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0052\",\n \"type\": \"hardcoded_paths\",\n \"description\": \"Code smell detected: hardcoded_paths\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 252,\n \"pattern\": \"'/users/'\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.139595\",\n \"status\": \"identified\",\n \"priority_score\": 5,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0053\",\n \"type\": \"hardcoded_paths\",\n \"description\": \"Code smell detected: hardcoded_paths\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 270,\n \"pattern\": \"'/users/'\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.139606\",\n \"status\": \"identified\",\n \"priority_score\": 5,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0054\",\n \"type\": \"hardcoded_paths\",\n \"description\": \"Code smell detected: hardcoded_paths\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"medium\",\n \"metadata\": {\n \"line_number\": 355,\n \"pattern\": \"'/auth/login'\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.139636\",\n \"status\": \"identified\",\n \"priority_score\": 5,\n \"priority\": \"medium\"\n },\n {\n \"id\": \"DEBT-0001\",\n \"type\": \"missing_docstring\",\n \"description\": \"Class 'UserService' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 17,\n \"severity\": \"low\",\n \"metadata\": {\n \"class_name\": \"UserService\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.114513\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0002\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function '__init__' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 18,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"__init__\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.114546\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0004\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'create_user' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 24,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"create_user\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.114684\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0007\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'validate_email' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 126,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"validate_email\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.116045\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0008\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'authenticate_user' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 136,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"authenticate_user\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.116159\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0009\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'get_user' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 162,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"get_user\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.116637\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0010\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'update_user' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 166,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"update_user\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.116694\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0011\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'delete_user' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 194,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"delete_user\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.117074\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0012\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'search_users' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 199,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"search_users\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.117131\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0013\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'export_users' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 211,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"export_users\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.117460\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0014\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'import_users' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 215,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"import_users\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.117523\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0015\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'calculate_user_score' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 224,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"calculate_user_score\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.117609\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0016\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'get_user_service' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 256,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"get_user_service\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.118051\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0017\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'hash_password' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 261,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"hash_password\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.118083\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0018\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'validate_password' missing docstring\",\n \"file_path\": \"src/user_service.py\",\n \"line_number\": 267,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"validate_password\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.118172\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0001\",\n \"type\": \"missing_docstring\",\n \"description\": \"Class 'PaymentProcessor' missing docstring\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 12,\n \"severity\": \"low\",\n \"metadata\": {\n \"class_name\": \"PaymentProcessor\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.124344\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0002\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function '__init__' missing docstring\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 14,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"__init__\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.124356\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0006\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'send_payment_confirmation_email' missing docstring\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 217,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"send_payment_confirmation_email\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.125733\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0007\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'refund_payment' missing docstring\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 227,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"refund_payment\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.125816\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0008\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'get_transaction' missing docstring\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 239,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"get_transaction\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.125889\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0009\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'validate_credit_card' missing docstring\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 244,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"validate_credit_card\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.125917\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0011\",\n \"type\": \"missing_docstring\",\n \"description\": \"Function 'get_payment_processor' missing docstring\",\n \"file_path\": \"src/payment_processor.py\",\n \"line_number\": 311,\n \"severity\": \"low\",\n \"metadata\": {\n \"function_name\": \"get_payment_processor\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.126436\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0044\",\n \"type\": \"long_line\",\n \"description\": \"Line too long: 140 characters\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 161,\n \"length\": 140\n },\n \"detected_date\": \"2026-02-16T12:59:28.128066\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0045\",\n \"type\": \"long_line\",\n \"description\": \"Line too long: 122 characters\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 180,\n \"length\": 122\n },\n \"detected_date\": \"2026-02-16T12:59:28.128072\",\n \"status\": \"identified\",\n \"priority_score\": 2,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0019\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: TODO: Move this to configuration file\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 12,\n \"comment\": \"TODO: Move this to configuration file\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.118649\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0020\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: FIXME: This should be in environment variables\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 14,\n \"comment\": \"FIXME: This should be in environment variables\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.118681\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0021\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: HACK: Using dict for now, should be proper database connection\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 21,\n \"comment\": \"HACK: Using dict for now, should be proper database connection\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.118720\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0022\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: TODO: Implement proper user ID generation\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 88,\n \"comment\": \"TODO: Implement proper user ID generation\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.119140\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0023\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: XXX: This is terrible for production\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 89,\n \"comment\": \"XXX: This is terrible for production\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.119154\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0024\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: TODO: Implement soft delete instead\",\n \"file_path\": \"src/user_service.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 196,\n \"comment\": \"TODO: Implement soft delete instead\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.119807\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0037\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: TODO: These should come from environment or config\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 15,\n \"comment\": \"TODO: These should come from environment or config\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.126594\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0038\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: FIXME: This should query a discount service\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 67,\n \"comment\": \"FIXME: This should query a discount service\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.126782\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0039\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: HACK: Using print instead of actual email service\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 219,\n \"comment\": \"HACK: Using print instead of actual email service\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.127356\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0040\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: TODO: Implement actual email sending\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 224,\n \"comment\": \"TODO: Implement actual email sending\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.127385\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0041\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: TODO: Implement refund for different providers\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 229,\n \"comment\": \"TODO: Implement refund for different providers\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.127402\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0042\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: XXX: This doesn't actually process the refund\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 236,\n \"comment\": \"XXX: This doesn't actually process the refund\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.127434\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0043\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: FIXME: Implement actual transaction lookup\",\n \"file_path\": \"src/payment_processor.py\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 241,\n \"comment\": \"FIXME: Implement actual transaction lookup\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.127455\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0046\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: TODO: Move configuration to separate file\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 3,\n \"comment\": \"TODO: Move configuration to separate file\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.138142\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0047\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: FIXME: Should be in environment\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 5,\n \"comment\": \"FIXME: Should be in environment\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.138158\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0048\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: HACK: Polyfill for older browsers - should use proper build system\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 12,\n \"comment\": \"HACK: Polyfill for older browsers - should use proper build system\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.138174\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n },\n {\n \"id\": \"DEBT-0049\",\n \"type\": \"todo_comment\",\n \"description\": \"TODO/FIXME comment: XXX: This method is never used\",\n \"file_path\": \"src/frontend.js\",\n \"severity\": \"low\",\n \"metadata\": {\n \"line_number\": 287,\n \"comment\": \"XXX: This method is never used\"\n },\n \"detected_date\": \"2026-02-16T12:59:28.139089\",\n \"status\": \"identified\",\n \"priority_score\": 1,\n \"priority\": \"low\"\n }\n ],\n \"file_statistics\": {\n \"src/user_service.py\": {\n \"path\": \"src/user_service.py\",\n \"lines\": 276,\n \"size_kb\": 9.275390625,\n \"language\": \"python\",\n \"debt_count\": 16\n },\n \"src/payment_processor.py\": {\n \"path\": \"src/payment_processor.py\",\n \"lines\": 315,\n \"size_kb\": 13.041015625,\n \"language\": \"python\",\n \"debt_count\": 38\n },\n \"src/frontend.js\": {\n \"path\": \"src/frontend.js\",\n \"lines\": 395,\n \"size_kb\": 14.5419921875,\n \"language\": \"javascript\",\n \"debt_count\": 14\n }\n },\n \"recommendations\": [\n \"Extract duplicate code into reusable functions or modules. This reduces maintenance burden and potential for inconsistent changes.\",\n \"High debt density detected. Consider establishing coding standards and regular code review processes to prevent debt accumulation.\"\n ]\n}","content_type":"application/json; charset=utf-8","language":"json","size":58350,"content_sha256":"f44089c4bc4d4dea5e13d89ffd6f4c55489f819edc5b9d7a64c5866905ee8e0d"},{"filename":"README.md","content":"# Tech Debt Tracker\n\nA comprehensive technical debt management system that helps engineering teams identify, prioritize, and track technical debt across codebases. This skill provides three interconnected tools for a complete debt management workflow.\n\n## Overview\n\nTechnical debt is like financial debt - it compounds over time and reduces team velocity if not managed systematically. This skill provides:\n\n- **Automated Debt Detection**: Scan codebases to identify various types of technical debt\n- **Intelligent Prioritization**: Use proven frameworks to prioritize debt based on business impact\n- **Trend Analysis**: Track debt evolution over time with executive-friendly dashboards\n\n## Tools\n\n### 1. Debt Scanner (`debt_scanner.py`)\n\nScans codebases to automatically detect technical debt signals using AST parsing for Python and regex patterns for other languages.\n\n**Features:**\n- Detects 15+ types of technical debt (large functions, complexity, duplicates, security issues, etc.)\n- Multi-language support (Python, JavaScript, Java, C#, Go, etc.)\n- Configurable thresholds and rules\n- Dual output: JSON for tools, human-readable for reports\n\n**Usage:**\n```bash\n# Basic scan\npython scripts/debt_scanner.py /path/to/codebase\n\n# With custom config and output\npython scripts/debt_scanner.py /path/to/codebase --config config.json --output report.json\n\n# Different output formats\npython scripts/debt_scanner.py /path/to/codebase --format both\n```\n\n### 2. Debt Prioritizer (`debt_prioritizer.py`)\n\nTakes debt inventory and creates prioritized backlog using proven prioritization frameworks.\n\n**Features:**\n- Multiple prioritization frameworks (Cost of Delay, WSJF, RICE)\n- Business impact analysis with ROI calculations \n- Sprint allocation recommendations\n- Effort estimation with risk adjustment\n- Executive and engineering reports\n\n**Usage:**\n```bash\n# Basic prioritization\npython scripts/debt_prioritizer.py debt_inventory.json\n\n# Custom framework and team size\npython scripts/debt_prioritizer.py inventory.json --framework wsjf --team-size 8\n\n# Sprint capacity planning\npython scripts/debt_prioritizer.py inventory.json --sprint-capacity 80 --output backlog.json\n```\n\n### 3. Debt Dashboard (`debt_dashboard.py`)\n\nAnalyzes historical debt data to provide trend analysis, health scoring, and executive reporting.\n\n**Features:**\n- Health score trending over time\n- Debt velocity analysis (accumulation vs resolution)\n- Executive summary with business impact\n- Forecasting based on current trends\n- Strategic recommendations\n\n**Usage:**\n```bash\n# Single directory of scans\npython scripts/debt_dashboard.py --input-dir ./debt_scans/\n\n# Multiple specific files\npython scripts/debt_dashboard.py scan1.json scan2.json scan3.json\n\n# Custom analysis period\npython scripts/debt_dashboard.py data.json --period quarterly --team-size 6\n```\n\n## Quick Start\n\n### 1. Scan Your Codebase\n\n```bash\n# Scan your project\npython scripts/debt_scanner.py ~/my-project --output initial_scan.json\n\n# Review the results\npython scripts/debt_scanner.py ~/my-project --format text\n```\n\n### 2. Prioritize Your Debt\n\n```bash\n# Create prioritized backlog\npython scripts/debt_prioritizer.py initial_scan.json --output backlog.json\n\n# View sprint recommendations\npython scripts/debt_prioritizer.py initial_scan.json --format text\n```\n\n### 3. Track Over Time\n\n```bash\n# After multiple scans, analyze trends\npython scripts/debt_dashboard.py scan1.json scan2.json scan3.json --output dashboard.json\n\n# Generate executive report\npython scripts/debt_dashboard.py --input-dir ./scans/ --format text\n```\n\n## Configuration\n\n### Scanner Configuration\n\nCreate `config.json` to customize detection rules:\n\n```json\n{\n \"max_function_length\": 50,\n \"max_complexity\": 10,\n \"max_nesting_depth\": 4,\n \"ignore_patterns\": [\"*.test.js\", \"build/\", \"node_modules/\"],\n \"file_extensions\": {\n \"python\": [\".py\"],\n \"javascript\": [\".js\", \".jsx\", \".ts\", \".tsx\"]\n }\n}\n```\n\n### Team Configuration\n\nAdjust tools for your team size and sprint capacity:\n\n```bash\n# 8-person team with 2-week sprints\npython scripts/debt_prioritizer.py inventory.json --team-size 8 --sprint-capacity 160\n```\n\n## Sample Data\n\nThe `assets/` directory contains sample data for testing:\n\n- `sample_codebase/`: Example codebase with various debt types\n- `sample_debt_inventory.json`: Example debt inventory\n- `historical_debt_*.json`: Sample historical data for trending\n\nTry the tools on sample data:\n\n```bash\n# Test scanner\npython scripts/debt_scanner.py assets/sample_codebase\n\n# Test prioritizer \npython scripts/debt_prioritizer.py assets/sample_debt_inventory.json\n\n# Test dashboard\npython scripts/debt_dashboard.py assets/historical_debt_*.json\n```\n\n## Understanding the Output\n\n### Health Score (0-100)\n\n- **85-100**: Excellent - Minimal debt, sustainable practices\n- **70-84**: Good - Manageable debt level, some attention needed\n- **55-69**: Fair - Debt accumulating, requires focused effort\n- **40-54**: Poor - High debt level, impacts productivity\n- **0-39**: Critical - Immediate action required\n\n### Priority Levels\n\n- **Critical**: Security issues, blocking problems (fix immediately)\n- **High**: Significant impact on quality or velocity (next sprint)\n- **Medium**: Moderate impact, plan for upcoming work (next quarter)\n- **Low**: Minor issues, fix opportunistically (when convenient)\n\n### Debt Categories\n\n- **Code Quality**: Large functions, complexity, duplicates\n- **Architecture**: Design issues, coupling problems\n- **Security**: Vulnerabilities, hardcoded secrets\n- **Testing**: Missing tests, poor coverage\n- **Documentation**: Missing or outdated docs\n- **Dependencies**: Outdated packages, license issues\n\n## Integration with Development Workflow\n\n### CI/CD Integration\n\nAdd debt scanning to your CI pipeline:\n\n```bash\n# In your CI script\npython scripts/debt_scanner.py . --output ci_scan.json\n# Compare with baseline, fail build if critical issues found\n```\n\n### Sprint Planning\n\n1. **Weekly**: Run scanner to detect new debt\n2. **Sprint Planning**: Use prioritizer for debt story sizing\n3. **Monthly**: Generate dashboard for trend analysis\n4. **Quarterly**: Executive review with strategic recommendations\n\n### Code Review Integration\n\nUse scanner output to focus code reviews:\n\n```bash\n# Scan PR branch\npython scripts/debt_scanner.py . --output pr_scan.json\n\n# Compare with main branch baseline\n# Focus review on areas with new debt\n```\n\n## Best Practices\n\n### Debt Management Strategy\n\n1. **Prevention**: Use scanner in CI to catch debt early\n2. **Prioritization**: Always use business impact for priority\n3. **Allocation**: Reserve 15-20% sprint capacity for debt work\n4. **Measurement**: Track health score and velocity impact\n5. **Communication**: Use dashboard reports for stakeholders\n\n### Common Pitfalls to Avoid\n\n- **Analysis Paralysis**: Don't spend too long on perfect prioritization\n- **Technical Focus Only**: Always consider business impact\n- **Inconsistent Application**: Ensure all teams use same approach\n- **Ignoring Trends**: Pay attention to debt accumulation rate\n- **All-or-Nothing**: Incremental debt reduction is better than none\n\n### Success Metrics\n\n- **Health Score Improvement**: Target 5+ point quarterly improvement\n- **Velocity Impact**: Keep debt velocity impact below 20%\n- **Team Satisfaction**: Survey developers on code quality satisfaction\n- **Incident Reduction**: Track correlation between debt and production issues\n\n## Advanced Usage\n\n### Custom Debt Types\n\nExtend the scanner for organization-specific debt patterns:\n\n1. Add patterns to `config.json`\n2. Modify detection logic in scanner\n3. Update categorization in prioritizer\n\n### Integration with External Tools\n\n- **Jira/GitHub**: Import debt items as tickets\n- **SonarQube**: Combine with static analysis metrics\n- **APM Tools**: Correlate debt with performance metrics\n- **Chat Systems**: Send debt alerts to team channels\n\n### Automated Reporting\n\nSet up automated debt reporting:\n\n```bash\n#!/bin/bash\n# Daily debt monitoring script\npython scripts/debt_scanner.py . --output daily_scan.json\npython scripts/debt_dashboard.py daily_scan.json --output daily_report.json\n# Send report to stakeholders\n```\n\n## Troubleshooting\n\n### Common Issues\n\n**Scanner not finding files**: Check `ignore_patterns` in config\n**Prioritizer giving unexpected results**: Verify business impact scoring\n**Dashboard shows flat trends**: Need more historical data points\n\n### Performance Tips\n\n- Use `.gitignore` patterns to exclude irrelevant files\n- Limit scan depth for large monorepos\n- Run dashboard analysis on subset for faster iteration\n\n### Getting Help\n\n1. Check the `references/` directory for detailed documentation\n2. Review sample data and expected outputs\n3. Examine the tool source code for customization ideas\n\n## Contributing\n\nThis skill is designed to be customized for your organization's needs:\n\n1. **Add Detection Rules**: Extend scanner patterns for your tech stack\n2. **Custom Prioritization**: Modify scoring algorithms for your business context\n3. **New Report Formats**: Add output formats for your stakeholders\n4. **Integration Hooks**: Add connectors to your existing tools\n\nThe codebase is designed with extensibility in mind - each tool is modular and can be enhanced independently.\n\n---\n\n**Remember**: Technical debt management is a journey, not a destination. These tools help you make informed decisions about balancing new feature development with technical excellence. Start small, measure impact, and iterate based on what works for your team.","content_type":"text/markdown; charset=utf-8","language":"markdown","size":9509,"content_sha256":"1a847da1e467f753b06493160a66d59ed808025007ecbc4f50832fd62f314c38"},{"filename":"references/debt-classification-taxonomy.md","content":"# Technical Debt Classification Taxonomy\n\n## Overview\n\nThis document provides a comprehensive taxonomy for classifying technical debt across different dimensions. Consistent classification is essential for tracking, prioritizing, and managing technical debt effectively across teams and projects.\n\n## Primary Categories\n\n### 1. Code Debt\n\n**Definition**: Issues at the code level that make software harder to understand, modify, or maintain.\n\n**Subcategories**:\n- **Structural Issues**\n - `large_function`: Functions exceeding recommended size limits\n - `high_complexity`: High cyclomatic complexity (>10)\n - `deep_nesting`: Excessive indentation levels (>4)\n - `long_parameter_list`: Too many function parameters (>5)\n - `data_clumps`: Related data that should be grouped together\n \n- **Naming and Documentation**\n - `poor_naming`: Unclear or misleading variable/function names\n - `missing_docstring`: Functions/classes without documentation\n - `magic_numbers`: Hardcoded numeric values without explanation\n - `commented_code`: Dead code left in comments\n \n- **Duplication and Patterns**\n - `duplicate_code`: Identical or similar code blocks\n - `copy_paste_programming`: Evidence of code duplication\n - `inconsistent_patterns`: Mixed coding styles within codebase\n \n- **Error Handling**\n - `empty_catch_blocks`: Exception handling without proper action\n - `generic_exceptions`: Catching overly broad exception types\n - `missing_error_handling`: No error handling for failure scenarios\n\n**Severity Indicators**:\n- **Critical**: Security vulnerabilities, syntax errors\n- **High**: Functions >100 lines, complexity >20\n- **Medium**: Functions 50-100 lines, complexity 10-20 \n- **Low**: Minor style issues, short functions with minor problems\n\n### 2. Architecture Debt\n\n**Definition**: High-level design decisions that limit system flexibility, scalability, or maintainability.\n\n**Subcategories**:\n- **Structural Issues**\n - `monolithic_design`: Components that should be separated\n - `circular_dependencies`: Modules depending on each other cyclically\n - `god_object`: Classes/modules with too many responsibilities\n - `inappropriate_intimacy`: Excessive coupling between modules\n \n- **Layer Violations**\n - `abstraction_inversion`: Lower-level modules depending on higher-level ones\n - `leaky_abstractions`: Implementation details exposed through interfaces\n - `broken_hierarchy`: Inheritance relationships that don't make sense\n \n- **Scalability Issues** \n - `performance_bottlenecks`: Known architectural performance limitations\n - `resource_contention`: Shared resources creating bottlenecks\n - `single_point_failure`: Critical components without redundancy\n\n**Impact Assessment**:\n- **High Impact**: Affects system scalability, blocks major features\n- **Medium Impact**: Makes changes more difficult, affects team productivity\n- **Low Impact**: Minor architectural inconsistencies\n\n### 3. Test Debt\n\n**Definition**: Inadequate testing infrastructure, coverage, or quality that increases risk and slows development.\n\n**Subcategories**:\n- **Coverage Issues**\n - `low_coverage`: Test coverage below team standards (\u003c80%)\n - `missing_unit_tests`: No tests for critical business logic\n - `missing_integration_tests`: No tests for component interactions\n - `missing_end_to_end_tests`: No full system workflow validation\n \n- **Test Quality**\n - `flaky_tests`: Tests that pass/fail inconsistently \n - `slow_tests`: Test suite taking too long to execute\n - `brittle_tests`: Tests that break with minor code changes\n - `unclear_test_intent`: Tests without clear purpose or documentation\n \n- **Infrastructure**\n - `manual_testing_only`: No automated testing processes\n - `missing_test_data`: No proper test data management\n - `environment_dependencies`: Tests requiring specific environments\n\n**Priority Matrix**:\n- **Critical Path Coverage**: High priority for business-critical features\n- **Regression Risk**: High priority for frequently changed code\n- **Development Velocity**: Medium priority for developer productivity\n- **Documentation Value**: Low priority for test clarity improvements\n\n### 4. Documentation Debt\n\n**Definition**: Missing, outdated, or poor-quality documentation that hinders understanding and maintenance.\n\n**Subcategories**:\n- **API Documentation**\n - `missing_api_docs`: No documentation for public APIs\n - `outdated_api_docs`: Documentation doesn't match implementation\n - `incomplete_examples`: No usage examples for complex APIs\n \n- **Code Documentation**\n - `missing_comments`: Complex algorithms without explanation\n - `outdated_comments`: Comments contradicting current implementation\n - `redundant_comments`: Comments that just restate the code\n \n- **System Documentation**\n - `missing_architecture_docs`: No high-level system design documentation\n - `missing_deployment_docs`: No deployment or operations guide\n - `missing_onboarding_docs`: No guide for new team members\n\n**Freshness Assessment**:\n- **Stale**: Documentation >6 months out of date\n- **Outdated**: Documentation 3-6 months out of date\n- **Current**: Documentation \u003c3 months out of date\n\n### 5. Dependency Debt\n\n**Definition**: Issues with external libraries, frameworks, and system dependencies.\n\n**Subcategories**:\n- **Version Management**\n - `outdated_dependencies`: Libraries with available updates\n - `vulnerable_dependencies`: Dependencies with known security issues\n - `deprecated_dependencies`: Dependencies no longer maintained\n - `version_conflicts`: Incompatible dependency versions\n \n- **License and Compliance**\n - `license_violations`: Dependencies with incompatible licenses \n - `license_unknown`: Dependencies without clear licensing\n - `compliance_risk`: Dependencies creating legal/regulatory risks\n \n- **Usage Optimization**\n - `unused_dependencies`: Dependencies included but not used\n - `oversized_dependencies`: Heavy libraries for simple functionality\n - `redundant_dependencies`: Multiple libraries solving same problem\n\n**Risk Assessment**:\n- **Security Risk**: Known vulnerabilities, unmaintained dependencies\n- **Legal Risk**: License conflicts, compliance issues\n- **Technical Risk**: Breaking changes, deprecation notices\n- **Maintenance Risk**: Outdated versions, unsupported libraries\n\n### 6. Infrastructure Debt\n\n**Definition**: Operations, deployment, and infrastructure-related technical debt.\n\n**Subcategories**:\n- **Deployment and CI/CD**\n - `manual_deployment`: No automated deployment processes\n - `missing_pipeline`: No CI/CD pipeline automation\n - `brittle_deployments`: Deployment process prone to failure\n - `environment_drift`: Inconsistencies between environments\n \n- **Monitoring and Observability**\n - `missing_monitoring`: No application/system monitoring\n - `inadequate_logging`: Insufficient logging for troubleshooting\n - `missing_alerting`: No alerts for critical system conditions\n - `poor_observability`: Can't understand system behavior in production\n \n- **Configuration Management**\n - `hardcoded_config`: Configuration embedded in code\n - `manual_configuration`: No automated configuration management\n - `secrets_in_code`: Sensitive information stored in code\n - `inconsistent_environments`: Dev/staging/prod differences\n\n**Operational Impact**:\n- **Availability**: Affects system uptime and reliability\n- **Debuggability**: Affects ability to troubleshoot issues\n- **Scalability**: Affects ability to handle load increases\n- **Security**: Affects system security posture\n\n## Severity Classification\n\n### Critical (Score: 9-10)\n- Security vulnerabilities\n- Production-breaking issues\n- Legal/compliance violations\n- Blocking issues for team productivity\n\n### High (Score: 7-8) \n- Significant technical risk\n- Major productivity impact\n- Customer-visible quality issues\n- Architecture limitations\n\n### Medium (Score: 4-6)\n- Moderate productivity impact\n- Code quality concerns\n- Maintenance difficulties\n- Minor security concerns\n\n### Low (Score: 1-3)\n- Style and convention issues\n- Documentation gaps\n- Minor optimizations\n- Cosmetic improvements\n\n## Impact Dimensions\n\n### Business Impact\n- **Customer Experience**: User-facing quality and performance\n- **Revenue**: Direct impact on business metrics\n- **Compliance**: Regulatory and legal requirements\n- **Market Position**: Competitive advantage considerations\n\n### Technical Impact \n- **Development Velocity**: Speed of feature development\n- **Code Quality**: Maintainability and reliability\n- **System Reliability**: Uptime and performance\n- **Security Posture**: Vulnerability and risk exposure\n\n### Team Impact\n- **Developer Productivity**: Individual efficiency\n- **Team Morale**: Job satisfaction and engagement \n- **Knowledge Sharing**: Team collaboration and learning\n- **Onboarding Speed**: New team member integration\n\n## Effort Estimation Guidelines\n\n### T-Shirt Sizing\n- **XS (1-4 hours)**: Simple fixes, documentation updates\n- **S (1-2 days)**: Minor refactoring, simple feature additions\n- **M (3-5 days)**: Moderate refactoring, component changes\n- **L (1-2 weeks)**: Major refactoring, architectural changes\n- **XL (3+ weeks)**: System-wide changes, major migrations\n\n### Complexity Factors\n- **Technical Complexity**: How difficult is the change technically?\n- **Business Risk**: What's the risk if something goes wrong?\n- **Testing Requirements**: How much testing is needed?\n- **Team Knowledge**: Does the team understand this area well?\n- **Dependencies**: How many other systems/teams are involved?\n\n## Usage Guidelines\n\n### When Classifying Debt\n1. Start with primary category (code, architecture, test, etc.)\n2. Identify specific subcategory for precise tracking\n3. Assess severity based on business and technical impact\n4. Estimate effort using t-shirt sizing\n5. Tag with relevant impact dimensions\n\n### Consistency Rules\n- Use consistent terminology across teams\n- Document custom categories for domain-specific debt\n- Regular reviews to ensure classification accuracy\n- Training for team members on taxonomy usage\n\n### Review and Updates\n- Quarterly review of taxonomy relevance\n- Add new categories as patterns emerge\n- Remove unused categories to keep taxonomy lean\n- Update severity and impact criteria based on experience\n\nThis taxonomy should be adapted to your organization's specific context, technology stack, and business priorities. The key is consistency in application across teams and over time.","content_type":"text/markdown; charset=utf-8","language":"markdown","size":10424,"content_sha256":"00e1313c2d253043dd49d667df07c6c65062b4c68ec0478f6cf1dda311a70713"},{"filename":"references/debt-frameworks.md","content":"# tech-debt-tracker reference\n\n## Technical Debt Classification Framework\n\n### 1. Code Debt\nCode-level issues that make the codebase harder to understand, modify, and maintain.\n\n**Indicators:**\n- Long functions (>50 lines for complex logic, >20 for simple operations)\n- Deep nesting (>4 levels of indentation)\n- High cyclomatic complexity (>10)\n- Duplicate code patterns (>3 similar blocks)\n- Missing or inadequate error handling\n- Poor variable/function naming\n- Magic numbers and hardcoded values\n- Commented-out code blocks\n\n**Impact:**\n- Increased debugging time\n- Higher defect rates\n- Slower feature development\n- Knowledge silos (only original author understands the code)\n\n**Detection Methods:**\n- AST parsing for structural analysis\n- Pattern matching for common anti-patterns\n- Complexity metrics calculation\n- Duplicate code detection algorithms\n\n### 2. Architecture Debt\nHigh-level design decisions that seemed reasonable at the time but now limit scalability or maintainability.\n\n**Indicators:**\n- Monolithic components that should be modular\n- Circular dependencies between modules\n- Violation of separation of concerns\n- Inconsistent data flow patterns\n- Over-engineering or under-engineering for current scale\n- Tightly coupled components\n- Missing abstraction layers\n\n**Impact:**\n- Difficult to scale individual components\n- Cascading changes required for simple modifications\n- Testing becomes complex and brittle\n- Onboarding new team members takes longer\n\n**Detection Methods:**\n- Dependency analysis\n- Module coupling metrics\n- Component size analysis\n- Interface consistency checks\n\n### 3. Test Debt\nInadequate or missing test coverage, poor test quality, and testing infrastructure issues.\n\n**Indicators:**\n- Low test coverage (\u003c80% for critical paths)\n- Missing unit tests for complex logic\n- No integration tests for key workflows\n- Flaky tests that pass/fail intermittently\n- Slow test execution (>10 minutes for unit tests)\n- Tests that don't test meaningful behavior\n- Missing test data management strategy\n\n**Impact:**\n- Fear of refactoring (\"don't touch it, it works\")\n- Regression bugs in production\n- Slow feedback cycles during development\n- Difficulty validating complex business logic\n\n**Detection Methods:**\n- Coverage report analysis\n- Test execution time monitoring\n- Test failure pattern analysis\n- Test code quality assessment\n\n### 4. Documentation Debt\nMissing, outdated, or poor-quality documentation that makes the system harder to understand and maintain.\n\n**Indicators:**\n- Missing API documentation\n- Outdated README files\n- No architectural decision records (ADRs)\n- Missing code comments for complex algorithms\n- No onboarding documentation for new team members\n- Inconsistent documentation formats\n- Documentation that contradicts actual implementation\n\n**Impact:**\n- Increased onboarding time for new team members\n- Knowledge loss when team members leave\n- Miscommunication between teams\n- Repeated questions in team channels\n\n**Detection Methods:**\n- Documentation coverage analysis\n- Freshness checking (last modified dates)\n- Link validation\n- Comment density analysis\n\n### 5. Dependency Debt\nIssues related to external libraries, frameworks, and system dependencies.\n\n**Indicators:**\n- Outdated packages with known security vulnerabilities\n- Dependencies with incompatible licenses\n- Unused dependencies bloating the build\n- Version conflicts between packages\n- Deprecated APIs still in use\n- Heavy dependencies for simple tasks\n- Missing dependency pinning\n\n**Impact:**\n- Security vulnerabilities\n- Build instability\n- Longer build times\n- Legal compliance issues\n- Difficulty upgrading core frameworks\n\n**Detection Methods:**\n- Vulnerability scanning\n- License compliance checking\n- Usage analysis\n- Version compatibility checking\n\n### 6. Infrastructure Debt\nOperations and deployment-related technical debt.\n\n**Indicators:**\n- Manual deployment processes\n- Missing monitoring and alerting\n- Inadequate logging\n- No disaster recovery plan\n- Inconsistent environments (dev/staging/prod)\n- Missing CI/CD pipelines\n- Infrastructure as code gaps\n\n**Impact:**\n- Deployment risks and downtime\n- Difficult troubleshooting\n- Inconsistent behavior across environments\n- Manual work that should be automated\n\n**Detection Methods:**\n- Infrastructure audit checklists\n- Configuration drift detection\n- Monitoring coverage analysis\n- Deployment process documentation review\n\n## Severity Scoring Framework\n\nEach piece of tech debt is scored on multiple dimensions to determine overall severity:\n\n### Impact Assessment (1-10 scale)\n\n**Development Velocity Impact**\n- 1-2: Negligible impact on development speed\n- 3-4: Minor slowdown, workarounds available\n- 5-6: Moderate impact, affects some features\n- 7-8: Significant slowdown, affects most work\n- 9-10: Critical blocker, prevents new development\n\n**Quality Impact**\n- 1-2: No impact on defect rates\n- 3-4: Minor increase in minor bugs\n- 5-6: Moderate increase in defects\n- 7-8: Regular production issues\n- 9-10: Critical reliability problems\n\n**Team Productivity Impact**\n- 1-2: No impact on team morale or efficiency\n- 3-4: Occasional frustration\n- 5-6: Regular complaints from developers\n- 7-8: Team actively avoiding the area\n- 9-10: Causing developer turnover\n\n**Business Impact**\n- 1-2: No customer-facing impact\n- 3-4: Minor UX degradation\n- 5-6: Moderate performance impact\n- 7-8: Customer complaints or churn\n- 9-10: Revenue-impacting issues\n\n### Effort Assessment\n\n**Size (Story Points or Hours)**\n- XS (1-4 hours): Simple refactor or documentation update\n- S (1-2 days): Minor architectural change\n- M (3-5 days): Moderate refactoring effort\n- L (1-2 weeks): Major component restructuring\n- XL (3+ weeks): System-wide architectural changes\n\n**Risk Level**\n- Low: Well-understood change with clear scope\n- Medium: Some unknowns but manageable\n- High: Significant unknowns, potential for scope creep\n\n**Skill Requirements**\n- Junior: Can be handled by any team member\n- Mid: Requires experienced developer\n- Senior: Needs architectural expertise\n- Expert: Requires deep system knowledge\n\n## Interest Rate Calculation\n\nTechnical debt accrues \"interest\" - the additional cost of leaving it unfixed. This interest rate helps prioritize which debt to pay down first.\n\n### Interest Rate Formula\n\n```\nInterest Rate = (Impact Score × Frequency of Encounter) / Time Period\n```\n\nWhere:\n- **Impact Score**: Average severity score (1-10)\n- **Frequency of Encounter**: How often developers interact with this code\n- **Time Period**: Usually measured per sprint or month\n\n### Cost of Delay Calculation\n\n```\nCost of Delay = Interest Rate × Time Until Fix × Team Size Multiplier\n```\n\n### Example Calculation\n\n**Scenario**: Legacy authentication module with poor error handling\n\n- Impact Score: 7 (causes regular production issues)\n- Frequency: 15 encounters per sprint (3 developers × 5 times each)\n- Team Size: 8 developers\n- Current sprint: 1, planned fix: sprint 4\n\n```\nInterest Rate = 7 × 15 = 105 points per sprint\nCost of Delay = 105 × 3 × 1.2 = 378 total cost points\n```\n\nThis debt item should be prioritized over lower-cost items.\n\n## Debt Inventory Management\n\n### Data Structure\n\nEach debt item is tracked with the following attributes:\n\n```json\n{\n \"id\": \"DEBT-2024-001\",\n \"title\": \"Legacy user authentication module\",\n \"category\": \"code\",\n \"subcategory\": \"error_handling\",\n \"location\": \"src/auth/legacy_auth.py:45-120\",\n \"description\": \"Authentication error handling uses generic exceptions\",\n \"impact\": {\n \"velocity\": 7,\n \"quality\": 8,\n \"productivity\": 6,\n \"business\": 5\n },\n \"effort\": {\n \"size\": \"M\",\n \"risk\": \"medium\",\n \"skill_required\": \"mid\"\n },\n \"interest_rate\": 105,\n \"cost_of_delay\": 378,\n \"priority\": \"high\",\n \"created_date\": \"2024-01-15\",\n \"last_updated\": \"2024-01-20\",\n \"assigned_to\": null,\n \"status\": \"identified\",\n \"tags\": [\"security\", \"user-experience\", \"maintainability\"]\n}\n```\n\n### Status Lifecycle\n\n1. **Identified** - Debt detected but not yet analyzed\n2. **Analyzed** - Impact and effort assessed\n3. **Prioritized** - Added to backlog with priority\n4. **Planned** - Assigned to specific sprint/release\n5. **In Progress** - Actively being worked on\n6. **Review** - Implementation complete, under review\n7. **Done** - Debt resolved and verified\n8. **Won't Fix** - Consciously decided not to address\n\n## Prioritization Frameworks\n\n### 1. Cost-of-Delay vs Effort Matrix\n\nPlot debt items on a 2D matrix:\n- X-axis: Effort (XS to XL)\n- Y-axis: Cost of Delay (calculated value)\n\n**Priority Quadrants:**\n- High Cost, Low Effort: **Immediate** (quick wins)\n- High Cost, High Effort: **Planned** (major initiatives)\n- Low Cost, Low Effort: **Opportunistic** (during related work)\n- Low Cost, High Effort: **Backlog** (consider for future)\n\n### 2. Weighted Shortest Job First (WSJF)\n\n```\nWSJF Score = (Business Value + Time Criticality + Risk Reduction) / Effort\n```\n\nWhere each component is scored 1-10:\n- **Business Value**: Direct impact on customer value\n- **Time Criticality**: How much value decreases over time\n- **Risk Reduction**: How much risk is mitigated by fixing this debt\n\n### 3. Technical Debt Quadrant\n\nBased on Martin Fowler's framework:\n\n**Quadrant 1: Reckless & Deliberate**\n- \"We don't have time for design\"\n- Highest priority for remediation\n\n**Quadrant 2: Prudent & Deliberate** \n- \"We must ship now and deal with consequences\"\n- Schedule for near-term resolution\n\n**Quadrant 3: Reckless & Inadvertent**\n- \"What's layering?\"\n- Focus on education and process improvement\n\n**Quadrant 4: Prudent & Inadvertent**\n- \"Now we know how we should have done it\"\n- Normal part of learning, lowest priority\n\n## Refactoring Strategies\n\n### 1. Strangler Fig Pattern\nGradually replace old system by building new functionality around it.\n\n**When to use:**\n- Large, monolithic systems\n- High-risk changes to critical paths\n- Long-term architectural migrations\n\n**Implementation:**\n1. Identify boundaries for extraction\n2. Create abstraction layer\n3. Route new features to new implementation\n4. Gradually migrate existing features\n5. Remove old implementation\n\n### 2. Branch by Abstraction\nCreate abstraction layer to allow parallel implementations.\n\n**When to use:**\n- Need to support old and new systems simultaneously\n- High-risk changes with rollback requirements\n- A/B testing infrastructure changes\n\n**Implementation:**\n1. Create abstraction interface\n2. Implement abstraction for current system\n3. Replace direct calls with abstraction calls\n4. Implement new version behind same abstraction\n5. Switch implementations via configuration\n6. Remove old implementation\n\n### 3. Feature Toggles\nUse configuration flags to control code execution.\n\n**When to use:**\n- Gradual rollout of refactored components\n- Risk mitigation during large changes\n- Experimental refactoring approaches\n\n**Implementation:**\n1. Identify decision points in code\n2. Add toggle checks at decision points\n3. Implement both old and new paths\n4. Test both paths thoroughly\n5. Gradually move toggle to new implementation\n6. Remove old path and toggle\n\n### 4. Parallel Run\nRun old and new implementations simultaneously to verify correctness.\n\n**When to use:**\n- Critical business logic changes\n- Data processing pipeline changes\n- Algorithm improvements\n\n**Implementation:**\n1. Implement new version alongside old\n2. Run both versions with same inputs\n3. Compare outputs and log discrepancies\n4. Investigate and fix discrepancies\n5. Build confidence through parallel execution\n6. Switch to new implementation\n7. Remove old implementation\n\n## Sprint Allocation Recommendations\n\n### Debt-to-Feature Ratio\n\nMaintain healthy balance between new features and debt reduction:\n\n**Team Velocity \u003c 70% of capacity:**\n- 60% tech debt, 40% features\n- Focus on removing major blockers\n\n**Team Velocity 70-85% of capacity:**\n- 30% tech debt, 70% features \n- Balanced maintenance approach\n\n**Team Velocity > 85% of capacity:**\n- 15% tech debt, 85% features\n- Opportunistic debt reduction only\n\n### Sprint Planning Integration\n\n**Story Point Allocation:**\n- Reserve 20% of sprint capacity for tech debt\n- Prioritize debt items with highest interest rates\n- Include \"debt tax\" in feature estimates when working in high-debt areas\n\n**Debt Budget Tracking:**\n- Track debt points completed per sprint\n- Monitor debt interest rate trend\n- Alert when debt accumulation exceeds team's paydown rate\n\n### Quarterly Planning\n\n**Debt Initiatives:**\n- Identify 1-2 major debt themes per quarter\n- Allocate dedicated sprints for large-scale refactoring\n- Plan debt work around major feature releases\n\n**Success Metrics:**\n- Debt interest rate reduction\n- Developer velocity improvements\n- Defect rate reduction\n- Code review cycle time improvement\n\n## Stakeholder Reporting\n\n### Executive Dashboard\n\n**Key Metrics:**\n- Overall tech debt health score (0-100)\n- Debt trend direction (improving/declining)\n- Cost of delayed fixes (in development days)\n- High-risk debt items count\n\n**Monthly Report Structure:**\n1. **Executive Summary** (3 bullet points)\n2. **Health Score Trend** (6-month view)\n3. **Top 3 Risk Items** (business impact focus)\n4. **Investment Recommendation** (resource allocation)\n5. **Success Stories** (debt reduced last month)\n\n### Engineering Team Dashboard\n\n**Daily Metrics:**\n- New debt items identified\n- Debt items resolved\n- Interest rate by team/component\n- Debt hotspots (most problematic areas)\n\n**Sprint Reviews:**\n- Debt points completed vs. planned\n- Velocity impact from debt work\n- Newly discovered debt during feature work\n- Team sentiment on code quality\n\n### Product Manager Reports\n\n**Feature Impact Analysis:**\n- How debt affects feature development time\n- Quality risk assessment for upcoming features\n- Debt that blocks planned features\n- Recommendations for feature sequence planning\n\n**Customer Impact Translation:**\n- Debt that affects performance\n- Debt that increases bug rates\n- Debt that limits feature flexibility\n- Investment required to maintain current quality\n","content_type":"text/markdown; charset=utf-8","language":"markdown","size":14015,"content_sha256":"b2ab53c522aec1ee88b3a1a25f37cfab828bad43705e9cabc44afcd785d5d5f2"},{"filename":"references/prioritization-framework.md","content":"# Technical Debt Prioritization Framework\n\n## Introduction\n\nTechnical debt prioritization is a critical capability that separates high-performing engineering teams from those struggling with maintenance burden. This framework provides multiple approaches to systematically prioritize technical debt based on business value, risk, effort, and strategic alignment.\n\n## Core Principles\n\n### 1. Business Value Alignment\nTechnical debt work must connect to business outcomes. Every debt item should have a clear story about how fixing it supports business goals.\n\n### 2. Evidence-Based Decisions\nUse data, not opinions, to drive prioritization. Measure impact, track trends, and validate assumptions with evidence.\n\n### 3. Cost-Benefit Optimization\nBalance the cost of fixing debt against the cost of leaving it unfixed. Sometimes living with debt is the right business decision.\n\n### 4. Risk Management\nConsider both the probability and impact of negative outcomes. High-probability, high-impact issues get priority.\n\n### 5. Sustainable Pace\nDebt work should be sustainable over time. Avoid boom-bust cycles of neglect followed by emergency remediation.\n\n## Prioritization Frameworks\n\n### Framework 1: Cost of Delay (CoD)\n\n**Best For**: Teams with clear business metrics and well-understood customer impact.\n\n**Formula**: `Priority Score = (Business Value + Urgency + Risk Reduction) / Effort`\n\n**Components**:\n\n**Business Value (1-10 scale)**\n- Customer impact: How many users affected?\n- Revenue impact: Direct effect on business metrics\n- Strategic value: Alignment with business goals\n- Competitive advantage: Market positioning benefits\n\n**Urgency (1-10 scale)** \n- Time sensitivity: How quickly does value decay?\n- Dependency criticality: Does this block other work?\n- Market timing: External deadlines or windows\n- Regulatory pressure: Compliance requirements\n\n**Risk Reduction (1-10 scale)**\n- Security risk mitigation: Vulnerability reduction\n- Reliability improvement: Stability gains\n- Compliance risk: Regulatory issue prevention\n- Technical risk: Architectural problem prevention\n\n**Effort Estimation**\n- Development time in story points or days\n- Risk multiplier for uncertainty (1.0-2.0x)\n- Skill requirements and availability\n- Cross-team coordination needs\n\n**Example Calculation**:\n```\nAuthentication module refactor:\n- Business Value: 8 (affects all users, blocks SSO)\n- Urgency: 7 (blocks Q2 enterprise features) \n- Risk Reduction: 9 (high security risk)\n- Total Numerator: 24\n- Effort: 3 weeks = 15 story points\n- CoD Score: 24/15 = 1.6\n```\n\n### Framework 2: Weighted Shortest Job First (WSJF)\n\n**Best For**: SAFe/Agile environments with portfolio-level planning.\n\n**Formula**: `WSJF = (Business Value + Time Criticality + Risk Reduction) / Job Size`\n\n**Scoring Guidelines**:\n\n**Business Value (1-20 scale)**\n- User/business value from fixing this debt\n- Direct revenue or cost impact\n- Strategic importance to business objectives\n\n**Time Criticality (1-20 scale)** \n- How user/business value declines over time\n- Dependency on other work items\n- Fixed deadlines or time-sensitive opportunities\n\n**Risk Reduction/Opportunity Enablement (1-20 scale)**\n- Risk mitigation value\n- Future opportunities this enables\n- Options this preserves or creates\n\n**Job Size (1-20 scale)**\n- Relative sizing compared to other debt items\n- Include uncertainty and risk factors\n- Consider dependencies and coordination overhead\n\n**WSJF Bands**:\n- **Highest (WSJF > 10)**: Do immediately \n- **High (WSJF 5-10)**: Next quarter priority\n- **Medium (WSJF 2-5)**: Planned work\n- **Low (WSJF \u003c 2)**: Backlog\n\n### Framework 3: RICE (Reach, Impact, Confidence, Effort)\n\n**Best For**: Product-focused teams with user-centric metrics.\n\n**Formula**: `RICE Score = (Reach × Impact × Confidence) / Effort`\n\n**Components**:\n\n**Reach (number or percentage)**\n- How many developers/users affected per period?\n- Percentage of codebase impacted\n- Number of features that would benefit\n\n**Impact (1-3 scale)**\n- 3 = Massive impact\n- 2 = High impact \n- 1 = Medium impact\n- 0.5 = Low impact\n- 0.25 = Minimal impact\n\n**Confidence (percentage)**\n- How confident are you in your estimates?\n- Based on evidence, not gut feeling\n- 100% = High confidence with data\n- 80% = Medium confidence with some data\n- 50% = Low confidence, mostly assumptions\n\n**Effort (story points or person-months)**\n- Total effort from all team members\n- Include design, development, testing, deployment\n- Account for coordination and communication overhead\n\n**Example**:\n```\nLegacy API cleanup:\n- Reach: 5 teams × 4 developers = 20 people per quarter\n- Impact: 2 (high - significantly improves developer experience)\n- Confidence: 80% (have done similar cleanups before)\n- Effort: 8 story points\n- RICE: (20 × 2 × 0.8) / 8 = 4.0\n```\n\n### Framework 4: Technical Debt Quadrants\n\n**Best For**: Teams needing to understand debt context and strategy.\n\nBased on Martin Fowler's framework, categorize debt into quadrants:\n\n**Quadrant 1: Reckless & Deliberate**\n- \"We don't have time for design\"\n- **Strategy**: Immediate remediation\n- **Priority**: Highest - created knowingly with poor justification\n\n**Quadrant 2: Prudent & Deliberate**\n- \"We must ship now and deal with consequences\" \n- **Strategy**: Planned remediation\n- **Priority**: High - was right decision at time, now needs attention\n\n**Quadrant 3: Reckless & Inadvertent**\n- \"What's layering?\"\n- **Strategy**: Education and process improvement\n- **Priority**: Medium - focus on preventing more\n\n**Quadrant 4: Prudent & Inadvertent**\n- \"Now we know how we should have done it\"\n- **Strategy**: Opportunistic improvement\n- **Priority**: Low - normal part of learning\n\n### Framework 5: Risk-Impact Matrix\n\n**Best For**: Risk-averse organizations or regulated environments.\n\nPlot debt items on 2D matrix:\n- X-axis: Likelihood of negative impact (1-5)\n- Y-axis: Severity of negative impact (1-5)\n\n**Priority Quadrants**:\n- **Critical (High likelihood, High impact)**: Immediate action\n- **Important (High likelihood, Low impact OR Low likelihood, High impact)**: Planned action\n- **Monitor (Medium likelihood, Medium impact)**: Watch and assess\n- **Accept (Low likelihood, Low impact)**: Document decision to accept\n\n**Impact Categories**:\n- **Security**: Data breaches, vulnerability exploitation\n- **Reliability**: System outages, data corruption \n- **Performance**: User experience degradation\n- **Compliance**: Regulatory violations, audit findings\n- **Productivity**: Team velocity reduction, developer frustration\n\n## Multi-Framework Approach\n\n### When to Use Multiple Frameworks\n\n**Portfolio-Level Planning**:\n- Use WSJF for quarterly planning\n- Use CoD for sprint-level decisions\n- Use Risk-Impact for security review\n\n**Team Maturity Progression**:\n- Start with simple Risk-Impact matrix \n- Progress to RICE as metrics improve\n- Advanced teams can use CoD effectively\n\n**Context-Dependent Selection**:\n- **Regulated industries**: Risk-Impact primary, WSJF secondary\n- **Product companies**: RICE primary, CoD secondary \n- **Enterprise software**: CoD primary, WSJF secondary\n\n### Combining Framework Results\n\n**Weighted Scoring**:\n```\nFinal Priority = 0.4 × CoD_Score + 0.3 × RICE_Score + 0.3 × Risk_Score\n```\n\n**Tier-Based Approach**:\n1. Security/compliance items (Risk-Impact)\n2. High business value items (RICE/CoD) \n3. Developer productivity items (WSJF)\n4. Technical excellence items (Quadrants)\n\n## Implementation Guidelines\n\n### Setting Up Prioritization\n\n**Step 1: Choose Primary Framework**\n- Consider team maturity, organization culture, available data\n- Start simple, evolve complexity over time\n- Ensure framework aligns with business planning cycles\n\n**Step 2: Define Scoring Criteria** \n- Create rubrics for each scoring dimension\n- Use organization-specific examples\n- Train team on consistent application\n\n**Step 3: Establish Review Cadence**\n- Weekly: New urgent items\n- Bi-weekly: Sprint planning integration\n- Monthly: Portfolio review and reprioritization\n- Quarterly: Framework effectiveness review\n\n**Step 4: Tool Integration**\n- Use existing project management tools\n- Automate scoring where possible\n- Create dashboards for stakeholder communication\n\n### Common Pitfalls\n\n**Analysis Paralysis**\n- **Problem**: Spending too much time on perfect prioritization\n- **Solution**: Use \"good enough\" decisions, iterate quickly\n\n**Ignoring Business Context**\n- **Problem**: Purely technical prioritization\n- **Solution**: Always include business stakeholder perspective\n\n**Inconsistent Application**\n- **Problem**: Different teams using different approaches\n- **Solution**: Standardize framework, provide training\n\n**Over-Engineering the Process**\n- **Problem**: Complex frameworks nobody uses\n- **Solution**: Start simple, add complexity only when needed\n\n**Neglecting Stakeholder Buy-In** \n- **Problem**: Engineering-only prioritization decisions\n- **Solution**: Include product, business stakeholders in framework design\n\n### Measuring Framework Effectiveness\n\n**Leading Indicators**:\n- Framework adoption rate across teams\n- Time to prioritization decision\n- Stakeholder satisfaction with decisions\n- Consistency of scoring across team members\n\n**Lagging Indicators**:\n- Debt reduction velocity\n- Business outcome improvements \n- Technical incident reduction\n- Developer satisfaction improvements\n\n**Review Questions**:\n1. Are we making better debt decisions than before?\n2. Do stakeholders trust our prioritization process?\n3. Are we delivering measurable business value from debt work?\n4. Is the framework sustainable for long-term use?\n\n## Stakeholder Communication\n\n### For Engineering Leaders\n\n**Monthly Dashboard**:\n- Debt portfolio health score\n- Priority distribution by framework\n- Progress on high-priority items\n- Framework effectiveness metrics\n\n**Quarterly Business Review**:\n- Debt work business impact\n- Framework ROI analysis\n- Resource allocation recommendations\n- Strategic debt initiative proposals\n\n### For Product Managers\n\n**Sprint Planning Input**:\n- Debt items affecting feature velocity\n- User experience impact from debt \n- Feature delivery risk from debt\n- Opportunity cost of debt work vs features\n\n**Roadmap Integration**:\n- Debt work timing with feature releases\n- Dependencies between debt work and features\n- Resource allocation for debt vs features\n- Customer impact communication\n\n### for Executive Leadership\n\n**Executive Summary**:\n- Overall technical health trend\n- Business risk from technical debt\n- Investment recommendations \n- Competitive implications\n\n**Key Metrics**:\n- Debt-adjusted development velocity\n- Technical incident trends\n- Customer satisfaction correlations\n- Team retention and satisfaction\n\nThis prioritization framework should be adapted to your organization's context, but the core principles of evidence-based, business-aligned, systematic prioritization should remain constant.","content_type":"text/markdown; charset=utf-8","language":"markdown","size":10889,"content_sha256":"03e47d8e96c6d70a18b1583c4d7e919154c8180be7f03edf70dc9a06dc56f2ea"},{"filename":"references/stakeholder-communication-templates.md","content":"# Stakeholder Communication Templates\n\n## Introduction\n\nEffective communication about technical debt is crucial for securing resources, setting expectations, and maintaining stakeholder trust. This document provides templates and guidelines for communicating technical debt status, impact, and recommendations to different stakeholder groups.\n\n## Executive Summary Templates\n\n### Monthly Executive Report\n\n**Subject**: Technical Health Report - [Month] [Year]\n\n---\n\n**EXECUTIVE SUMMARY**\n\n**Overall Status**: [EXCELLENT/GOOD/FAIR/POOR] - Health Score: [X]/100\n\n**Key Message**: [One sentence summary of current state and trend]\n\n**Immediate Actions Required**: [Yes/No] - [Brief explanation if yes]\n\n---\n\n**BUSINESS IMPACT**\n\n• **Development Velocity**: [X]% impact on feature delivery speed\n• **Quality Risk**: [LOW/MEDIUM/HIGH] - [Brief explanation]\n• **Security Posture**: [X] critical issues, [X] high-priority issues\n• **Customer Impact**: [Direct customer-facing implications]\n\n**FINANCIAL IMPLICATIONS**\n\n• **Current Cost**: $[X]K monthly in reduced velocity\n• **Investment Needed**: $[X]K for critical issues (next quarter)\n• **ROI Projection**: [X]% velocity improvement, $[X]K annual savings\n• **Risk Cost**: Up to $[X]K if critical issues materialize\n\n**STRATEGIC RECOMMENDATIONS**\n\n1. **[Priority 1]**: [Action] - [Business justification] - [Timeline]\n2. **[Priority 2]**: [Action] - [Business justification] - [Timeline] \n3. **[Priority 3]**: [Action] - [Business justification] - [Timeline]\n\n**TREND ANALYSIS**\n\n• Health Score: [Previous] → [Current] ([Improving/Declining/Stable])\n• Debt Items: [Previous] → [Current] ([Net change])\n• High-Priority Issues: [Previous] → [Current]\n\n---\n\n**NEXT STEPS**\n\n• **This Quarter**: [Key initiatives and expected outcomes]\n• **Resource Request**: [Additional resources needed, if any]\n• **Dependencies**: [External dependencies or blockers]\n\n---\n\n### Quarterly Board-Level Report\n\n**Subject**: Technical Debt & Engineering Health - Q[X] [Year]\n\n---\n\n**KEY METRICS**\n\n| Metric | Current | Target | Trend |\n|--------|---------|--------|--------|\n| Health Score | [X]/100 | [X]/100 | [↑/↓/→] |\n| Velocity Impact | [X]% | \u003c[X]% | [↑/↓/→] |\n| Critical Issues | [X] | 0 | [↑/↓/→] |\n| Security Risk | [LOW/MED/HIGH] | LOW | [↑/↓/→] |\n\n**STRATEGIC CONTEXT**\n\nTechnical debt represents deferred investment in our technology platform. Our current debt portfolio has [positive/negative/neutral] implications for:\n\n• **Growth Capacity**: [Impact on ability to scale]\n• **Competitive Position**: [Impact on market responsiveness] \n• **Risk Profile**: [Impact on operational risk]\n• **Team Retention**: [Impact on engineering talent]\n\n**INVESTMENT ANALYSIS**\n\n• **Current Annual Cost**: $[X]M in reduced productivity\n• **Proposed Investment**: $[X]M over [timeframe]\n• **Expected ROI**: [X]% productivity improvement, $[X]M NPV\n• **Risk Mitigation**: $[X]M in avoided incident costs\n\n**RECOMMENDATIONS**\n\n1. **[Immediate]**: [Strategic action with business rationale]\n2. **[This Year]**: [Medium-term initiative with expected outcomes]\n3. **[Ongoing]**: [Process or cultural change needed]\n\n---\n\n## Product Management Templates\n\n### Sprint Planning Discussion\n\n**Subject**: Tech Debt Impact on Sprint [X] Planning\n\n---\n\n**SPRINT CAPACITY IMPACT**\n\n**Affected User Stories**:\n• [Story 1]: [X] point increase due to [debt issue]\n• [Story 2]: [X]% risk of scope reduction due to [debt issue]\n• [Story 3]: Blocked by [debt issue] - requires [X] points of debt work first\n\n**Recommended Debt Work This Sprint**:\n• **[Debt Item 1]** ([X] points): Unblocks [Story Y], reduces future story complexity\n• **[Debt Item 2]** ([X] points): Prevents [specific risk] in upcoming features\n\n**Trade-off Analysis**:\n• **If we fix debt**: [X] points for features, [benefits for future sprints]\n• **If we don't fix debt**: [X] points for features, [accumulated costs and risks]\n\n**Recommendation**: [Specific allocation suggestion with rationale]\n\n---\n\n### Feature Impact Assessment\n\n**Subject**: Technical Debt Impact Assessment - [Feature Name]\n\n---\n\n**DEBT AFFECTING THIS FEATURE**\n\n| Debt Item | Impact | Effort to Fix | Recommendation |\n|-----------|--------|---------------|----------------|\n| [Item 1] | [Description] | [X] points | Fix before/Work around/Accept |\n| [Item 2] | [Description] | [X] points | Fix before/Work around/Accept |\n\n**DELIVERY IMPACT**\n\n• **Timeline Risk**: [LOW/MEDIUM/HIGH]\n - Base estimate: [X] points\n - Debt-adjusted estimate: [X] points ([X]% increase)\n - Risk factors: [Specific risks and probabilities]\n\n• **Quality Risk**: [LOW/MEDIUM/HIGH]\n - [Specific quality concerns from debt]\n - Mitigation strategies: [Options for reducing risk]\n\n• **Future Feature Impact**: \n - This feature will [add to/reduce/not affect] debt burden\n - Related future features will be [easier/harder/unaffected]\n\n**RECOMMENDATIONS**\n\n1. **[Option 1]**: [Approach with pros/cons]\n2. **[Option 2]**: [Alternative approach with trade-offs]\n3. **Recommended**: [Chosen approach with justification]\n\n---\n\n## Engineering Team Templates\n\n### Team Health Check\n\n**Subject**: Weekly Team Health Check - [Date]\n\n---\n\n**DEBT BURDEN THIS WEEK**\n\n• **New Debt Identified**: [X] items ([categories])\n• **Debt Resolved**: [X] items ([X] hours saved) \n• **Net Change**: [Positive/Negative] [X] items\n• **Top Pain Points**: [Developer-reported friction areas]\n\n**VELOCITY IMPACT**\n\n• **Stories Affected by Debt**: [X] of [Y] planned stories\n• **Estimated Overhead**: [X] hours of extra work due to debt\n• **Blocked Work**: [Any stories waiting on debt resolution]\n\n**TEAM SENTIMENT**\n\n• **Frustration Level**: [1-5 scale] ([trend])\n• **Confidence in Codebase**: [1-5 scale] ([trend]) \n• **Top Complaints**: [Most common developer concerns]\n\n**ACTIONS THIS WEEK**\n\n• **Debt Work Planned**: [Specific items and assignees]\n• **Prevention Measures**: [Process improvements or reviews]\n• **Escalations**: [Issues needing management attention]\n\n---\n\n### Architecture Decision Record (ADR) Template\n\n**Subject**: ADR-[XXX]: [Decision Title] - Technical Debt Consideration\n\n---\n\n**Status**: [Proposed/Accepted/Deprecated]\n**Date**: [YYYY-MM-DD]\n**Decision Makers**: [Names]\n\n**CONTEXT**\n\n[Background and current situation]\n\n**TECHNICAL DEBT ANALYSIS**\n\n• **Debt Created by This Decision**:\n - [Specific debt that will be introduced]\n - [Estimated effort to resolve later: X points]\n - [Interest rate: impact over time]\n\n• **Debt Resolved by This Decision**:\n - [Existing debt this addresses]\n - [Estimated effort saved: X points]\n - [Risk reduction achieved]\n\n• **Net Debt Impact**: [Positive/Negative/Neutral]\n\n**DECISION**\n\n[What we decided to do]\n\n**RATIONALE**\n\n[Why we made this decision, including debt trade-offs]\n\n**DEBT MANAGEMENT PLAN**\n\n• **Monitoring**: [How we'll track the debt introduced]\n• **Timeline**: [When we plan to address the debt]\n• **Success Criteria**: [How we'll know it's time to pay down the debt]\n\n**CONSEQUENCES**\n\n[Expected outcomes, including debt implications]\n\n---\n\n## Customer-Facing Templates\n\n### Release Notes - Quality Improvements\n\n**Subject**: Platform Stability and Performance Improvements - Release [X.Y]\n\n---\n\n**QUALITY IMPROVEMENTS**\n\nWe've invested significant effort in improving the reliability and performance of our platform. While these changes aren't feature additions, they provide important benefits:\n\n**RELIABILITY ENHANCEMENTS**\n\n• **Reduced Error Rates**: [X]% fewer errors in [specific area]\n• **Improved Uptime**: [X]% improvement in system availability\n• **Faster Recovery**: [X]% faster recovery from service interruptions\n\n**PERFORMANCE IMPROVEMENTS**\n\n• **Page Load Speed**: [X]% faster loading for [specific features]\n• **API Response Time**: [X]% improvement in response times\n• **Resource Usage**: [X]% reduction in memory/CPU usage\n\n**SECURITY STRENGTHENING**\n\n• **Vulnerability Resolution**: Addressed [X] security findings\n• **Authentication Improvements**: Enhanced login security and reliability\n• **Data Protection**: Improved data encryption and access controls\n\n**WHAT THIS MEANS FOR YOU**\n\n• **Better User Experience**: Fewer interruptions, faster responses\n• **Increased Reliability**: Less downtime, more predictable performance\n• **Enhanced Security**: Your data is better protected\n\nWe continue to balance new feature development with platform investments to ensure a reliable, secure, and performant experience.\n\n---\n\n### Service Incident Communication\n\n**Subject**: Service Update - [Brief Description] - [Status]\n\n---\n\n**INCIDENT SUMMARY**\n\n• **Impact**: [Description of customer impact]\n• **Duration**: [Start time] - [End time / Ongoing]\n• **Root Cause**: [High-level, customer-appropriate explanation]\n• **Resolution**: [What was done to fix it]\n\n**TECHNICAL DEBT CONNECTION**\n\nThis incident was [directly caused by / contributed to by / unrelated to] technical debt in our system. Specifically:\n\n• **Contributing Factors**: [How debt played a role, if any]\n• **Prevention Measures**: [Debt work planned to prevent recurrence]\n• **Timeline**: [When preventive measures will be completed]\n\n**IMMEDIATE ACTIONS**\n\n1. [Action 1 with timeline]\n2. [Action 2 with timeline] \n3. [Action 3 with timeline]\n\n**LONG-TERM IMPROVEMENTS**\n\nWe're investing in [specific technical improvements] to prevent similar issues:\n\n• **Infrastructure**: [Relevant infrastructure debt work]\n• **Monitoring**: [Observability improvements planned]\n• **Process**: [Development process improvements]\n\nWe apologize for the inconvenience and appreciate your patience as we continue to strengthen our platform.\n\n---\n\n## Internal Communication Templates\n\n### Engineering All-Hands Presentation\n\n**Slide Template: Technical Debt State of the Union**\n\n---\n\n**SLIDE 1: Current State**\n- Health Score: [X]/100 [Trend arrow]\n- Total Debt Items: [X] ([X]% of codebase)\n- High Priority: [X] items requiring immediate attention\n- Team Impact: [X]% velocity reduction\n\n**SLIDE 2: What We've Accomplished** \n- Resolved [X] debt items ([X] hours of future work saved)\n- Improved health score by [X] points\n- Key wins: [2-3 specific examples with business impact]\n\n**SLIDE 3: Current Focus Areas**\n- [Category 1]: [X] items, [business impact]\n- [Category 2]: [X] items, [business impact] \n- [Category 3]: [X] items, [business impact]\n\n**SLIDE 4: Success Stories**\n- [Specific example]: [Problem] → [Solution] → [Outcome]\n- Metrics: [Before/after comparison]\n- Team feedback: [Developer quotes]\n\n**SLIDE 5: Looking Forward**\n- Q[X] Goals: [Specific targets]\n- Major Initiatives: [2-3 big-picture improvements]\n- How You Can Help: [Specific asks of the team]\n\n---\n\n### Retrospective Templates\n\n**Sprint Retrospective - Debt Focus**\n\n**What Went Well**:\n• Debt work completed: [Specific items and impact]\n• Process improvements: [What worked for debt management]\n• Team collaboration: [Cross-functional debt work successes]\n\n**What Didn't Go Well**:\n• Debt work challenges: [Obstacles encountered]\n• Scope creep: [Debt work that expanded beyond estimates]\n• Communication gaps: [Information that wasn't shared effectively]\n\n**Action Items**:\n• **Process**: [Changes to how we handle debt work]\n• **Planning**: [Improvements to debt estimation/prioritization] \n• **Prevention**: [Changes to prevent new debt creation]\n• **Tools**: [Tooling improvements needed]\n\n---\n\n## Communication Best Practices\n\n### Do's and Don'ts\n\n**DO**:\n• Use business language, not technical jargon\n• Quantify impact with specific metrics\n• Provide clear timelines and expectations\n• Acknowledge trade-offs and constraints\n• Connect debt work to business outcomes\n• Be proactive in communication\n\n**DON'T**:\n• Blame previous decisions or developers\n• Use fear-based messaging exclusively\n• Overwhelm stakeholders with technical details\n• Make promises without clear plans\n• Ignore the business context\n• Assume stakeholders understand technical implications\n\n### Tailoring Messages\n\n**For Executives**: Focus on business impact, ROI, and strategic implications\n**For Product**: Focus on feature impact, timeline risks, and user experience\n**For Engineering**: Focus on technical details, process improvements, and developer experience\n**For Customers**: Focus on reliability, performance, and security benefits\n\n### Frequency Guidelines\n\n**Real-time**: Critical security issues, production incidents\n**Weekly**: Team health checks, sprint impacts \n**Monthly**: Stakeholder updates, trend analysis\n**Quarterly**: Strategic reviews, investment planning\n**As-needed**: Major decisions, significant changes\n\nThese templates should be customized for your organization's communication style, stakeholder preferences, and business context.","content_type":"text/markdown; charset=utf-8","language":"markdown","size":12904,"content_sha256":"13f9b1812ef6baecce883b82fbabc1f032e0e5f14d06cadc33c13f719b9243bb"},{"filename":"scripts/debt_dashboard.py","content":"#!/usr/bin/env python3\n\"\"\"\nTech Debt Dashboard\n\nTakes historical debt inventories (multiple scans over time) and generates trend analysis,\ndebt velocity (accruing vs paying down), health score, and executive summary.\n\nUsage:\n python debt_dashboard.py historical_data.json\n python debt_dashboard.py data1.json data2.json data3.json\n python debt_dashboard.py --input-dir ./debt_scans/ --output dashboard_report.json\n python debt_dashboard.py historical_data.json --period quarterly --team-size 8\n\"\"\"\n\nimport json\nimport argparse\nimport sys\nimport os\nfrom collections import defaultdict, Counter\nfrom datetime import datetime, timedelta\nfrom pathlib import Path\nfrom typing import Dict, List, Any, Optional, Tuple\nfrom dataclasses import dataclass, asdict\nfrom statistics import mean, median, stdev\nimport re\n\n\n@dataclass\nclass HealthMetrics:\n \"\"\"Health metrics for a specific time period.\"\"\"\n overall_score: float # 0-100\n debt_density: float # debt items per file\n velocity_impact: float # estimated velocity reduction %\n quality_score: float # 0-100\n maintainability_score: float # 0-100\n technical_risk_score: float # 0-100\n\n\n@dataclass\nclass TrendAnalysis:\n \"\"\"Trend analysis for debt metrics over time.\"\"\"\n metric_name: str\n trend_direction: str # \"improving\", \"declining\", \"stable\"\n change_rate: float # rate of change per period\n correlation_strength: float # -1 to 1\n forecast_next_period: float\n confidence_interval: Tuple[float, float]\n\n\n@dataclass\nclass DebtVelocity:\n \"\"\"Debt velocity tracking - how fast debt is being created vs resolved.\"\"\"\n period: str\n new_debt_items: int\n resolved_debt_items: int\n net_change: int\n velocity_ratio: float # resolved/new, >1 is good\n effort_hours_added: float\n effort_hours_resolved: float\n net_effort_change: float\n\n\nclass DebtDashboard:\n \"\"\"Main dashboard class for debt trend analysis and reporting.\"\"\"\n \n def __init__(self, team_size: int = 5):\n self.team_size = team_size\n self.historical_data = []\n self.processed_snapshots = []\n self.trend_analyses = {}\n self.health_history = []\n self.velocity_history = []\n \n # Configuration for health scoring\n self.health_weights = {\n \"debt_density\": 0.25,\n \"complexity_score\": 0.20,\n \"test_coverage_proxy\": 0.15,\n \"documentation_proxy\": 0.10,\n \"security_score\": 0.15,\n \"maintainability\": 0.15\n }\n \n # Thresholds for categorization\n self.thresholds = {\n \"excellent\": 85,\n \"good\": 70,\n \"fair\": 55,\n \"poor\": 40\n }\n \n def load_historical_data(self, file_paths: List[str]) -> bool:\n \"\"\"Load multiple debt inventory files for historical analysis.\"\"\"\n self.historical_data = []\n \n for file_path in file_paths:\n try:\n with open(file_path, 'r', encoding='utf-8') as f:\n data = json.load(f)\n \n # Normalize data format\n if isinstance(data, dict) and 'debt_items' in data:\n # Scanner output format\n snapshot = {\n \"file_path\": file_path,\n \"scan_date\": data.get(\"scan_metadata\", {}).get(\"scan_date\", \n self._extract_date_from_filename(file_path)),\n \"debt_items\": data[\"debt_items\"],\n \"summary\": data.get(\"summary\", {}),\n \"file_statistics\": data.get(\"file_statistics\", {})\n }\n elif isinstance(data, dict) and 'prioritized_backlog' in data:\n # Prioritizer output format\n snapshot = {\n \"file_path\": file_path,\n \"scan_date\": data.get(\"metadata\", {}).get(\"analysis_date\",\n self._extract_date_from_filename(file_path)),\n \"debt_items\": data[\"prioritized_backlog\"],\n \"summary\": data.get(\"insights\", {}),\n \"file_statistics\": {}\n }\n elif isinstance(data, list):\n # Raw debt items array\n snapshot = {\n \"file_path\": file_path,\n \"scan_date\": self._extract_date_from_filename(file_path),\n \"debt_items\": data,\n \"summary\": {},\n \"file_statistics\": {}\n }\n else:\n raise ValueError(f\"Unrecognized data format in {file_path}\")\n \n self.historical_data.append(snapshot)\n \n except Exception as e:\n print(f\"Error loading {file_path}: {e}\")\n continue\n \n if not self.historical_data:\n print(\"No valid data files loaded.\")\n return False\n \n # Sort by date\n self.historical_data.sort(key=lambda x: x[\"scan_date\"])\n print(f\"Loaded {len(self.historical_data)} historical snapshots\")\n return True\n \n def load_from_directory(self, directory_path: str, pattern: str = \"*.json\") -> bool:\n \"\"\"Load all JSON files from a directory.\"\"\"\n directory = Path(directory_path)\n if not directory.exists():\n print(f\"Directory does not exist: {directory_path}\")\n return False\n \n file_paths = []\n for file_path in directory.glob(pattern):\n if file_path.is_file():\n file_paths.append(str(file_path))\n \n if not file_paths:\n print(f\"No matching files found in {directory_path}\")\n return False\n \n return self.load_historical_data(file_paths)\n \n def _extract_date_from_filename(self, file_path: str) -> str:\n \"\"\"Extract date from filename if possible, otherwise use current date.\"\"\"\n filename = Path(file_path).name\n \n # Try to find date patterns in filename\n date_patterns = [\n r\"(\\d{4}-\\d{2}-\\d{2})\", # YYYY-MM-DD\n r\"(\\d{4}\\d{2}\\d{2})\", # YYYYMMDD\n r\"(\\d{2}-\\d{2}-\\d{4})\", # MM-DD-YYYY\n ]\n \n for pattern in date_patterns:\n match = re.search(pattern, filename)\n if match:\n date_str = match.group(1)\n try:\n if len(date_str) == 8: # YYYYMMDD\n date_str = f\"{date_str[:4]}-{date_str[4:6]}-{date_str[6:]}\"\n datetime.strptime(date_str, \"%Y-%m-%d\")\n return date_str + \"T12:00:00\"\n except ValueError:\n continue\n \n # Fallback to file modification time\n try:\n mtime = os.path.getmtime(file_path)\n return datetime.fromtimestamp(mtime).isoformat()\n except:\n return datetime.now().isoformat()\n \n def generate_dashboard(self, period: str = \"monthly\") -> Dict[str, Any]:\n \"\"\"\n Generate comprehensive debt dashboard.\n \n Args:\n period: Analysis period (\"weekly\", \"monthly\", \"quarterly\")\n \n Returns:\n Dictionary containing dashboard data and analysis\n \"\"\"\n print(f\"Generating debt dashboard for {len(self.historical_data)} snapshots...\")\n print(f\"Analysis period: {period}\")\n print(\"=\" * 50)\n \n # Step 1: Process historical snapshots\n self._process_snapshots()\n \n # Step 2: Calculate health metrics for each snapshot\n self._calculate_health_metrics()\n \n # Step 3: Analyze trends\n self._analyze_trends(period)\n \n # Step 4: Calculate debt velocity\n self._calculate_debt_velocity(period)\n \n # Step 5: Generate forecasts\n forecasts = self._generate_forecasts()\n \n # Step 6: Create executive summary\n executive_summary = self._generate_executive_summary()\n \n # Step 7: Generate recommendations\n recommendations = self._generate_strategic_recommendations()\n \n # Step 8: Create visualizations data\n visualizations = self._generate_visualization_data()\n \n dashboard_data = {\n \"metadata\": {\n \"generated_date\": datetime.now().isoformat(),\n \"analysis_period\": period,\n \"snapshots_analyzed\": len(self.historical_data),\n \"date_range\": {\n \"start\": self.historical_data[0][\"scan_date\"] if self.historical_data else None,\n \"end\": self.historical_data[-1][\"scan_date\"] if self.historical_data else None\n },\n \"team_size\": self.team_size\n },\n \"executive_summary\": executive_summary,\n \"current_health\": self.health_history[-1] if self.health_history else None,\n \"trend_analysis\": {name: asdict(trend) for name, trend in self.trend_analyses.items()},\n \"debt_velocity\": [asdict(v) for v in self.velocity_history],\n \"forecasts\": forecasts,\n \"recommendations\": recommendations,\n \"visualizations\": visualizations,\n \"detailed_metrics\": self._get_detailed_metrics()\n }\n \n return dashboard_data\n \n def _process_snapshots(self):\n \"\"\"Process raw snapshots into standardized format.\"\"\"\n self.processed_snapshots = []\n \n for snapshot in self.historical_data:\n processed = {\n \"date\": snapshot[\"scan_date\"],\n \"total_debt_items\": len(snapshot[\"debt_items\"]),\n \"debt_by_type\": Counter(item.get(\"type\", \"unknown\") for item in snapshot[\"debt_items\"]),\n \"debt_by_severity\": Counter(item.get(\"severity\", \"medium\") for item in snapshot[\"debt_items\"]),\n \"debt_by_category\": Counter(self._categorize_debt_item(item) for item in snapshot[\"debt_items\"]),\n \"total_files\": snapshot[\"summary\"].get(\"total_files_scanned\", \n len(snapshot[\"file_statistics\"])),\n \"total_effort_estimate\": self._calculate_total_effort(snapshot[\"debt_items\"]),\n \"high_priority_count\": len([item for item in snapshot[\"debt_items\"] \n if self._is_high_priority(item)]),\n \"security_debt_count\": len([item for item in snapshot[\"debt_items\"]\n if self._is_security_related(item)]),\n \"raw_data\": snapshot\n }\n self.processed_snapshots.append(processed)\n \n def _categorize_debt_item(self, item: Dict[str, Any]) -> str:\n \"\"\"Categorize debt item into high-level categories.\"\"\"\n debt_type = item.get(\"type\", \"unknown\")\n \n categories = {\n \"code_quality\": [\"large_function\", \"high_complexity\", \"duplicate_code\", \n \"long_line\", \"missing_docstring\"],\n \"architecture\": [\"architecture_debt\", \"large_file\"],\n \"security\": [\"security_risk\", \"hardcoded_secrets\", \"sql_injection_risk\"],\n \"testing\": [\"test_debt\", \"missing_tests\", \"low_coverage\"],\n \"maintenance\": [\"todo_comment\", \"commented_code\"],\n \"dependencies\": [\"dependency_debt\", \"outdated_packages\"],\n \"infrastructure\": [\"deployment_debt\", \"monitoring_gaps\"],\n \"documentation\": [\"missing_docstring\", \"outdated_docs\"]\n }\n \n for category, types in categories.items():\n if debt_type in types:\n return category\n \n return \"other\"\n \n def _calculate_total_effort(self, debt_items: List[Dict[str, Any]]) -> float:\n \"\"\"Calculate total estimated effort for debt items.\"\"\"\n total_effort = 0.0\n \n for item in debt_items:\n # Try to get effort from existing analysis\n if \"effort_estimate\" in item:\n total_effort += item[\"effort_estimate\"].get(\"hours_estimate\", 0)\n else:\n # Estimate based on debt type and severity\n effort = self._estimate_item_effort(item)\n total_effort += effort\n \n return total_effort\n \n def _estimate_item_effort(self, item: Dict[str, Any]) -> float:\n \"\"\"Estimate effort for a debt item.\"\"\"\n debt_type = item.get(\"type\", \"unknown\")\n severity = item.get(\"severity\", \"medium\")\n \n base_efforts = {\n \"todo_comment\": 2,\n \"missing_docstring\": 2,\n \"long_line\": 1,\n \"large_function\": 8,\n \"high_complexity\": 16,\n \"duplicate_code\": 12,\n \"large_file\": 32,\n \"syntax_error\": 4,\n \"security_risk\": 20,\n \"architecture_debt\": 80,\n \"test_debt\": 16\n }\n \n base_effort = base_efforts.get(debt_type, 8)\n \n severity_multipliers = {\n \"low\": 0.5,\n \"medium\": 1.0,\n \"high\": 1.5,\n \"critical\": 2.0\n }\n \n return base_effort * severity_multipliers.get(severity, 1.0)\n \n def _is_high_priority(self, item: Dict[str, Any]) -> bool:\n \"\"\"Determine if debt item is high priority.\"\"\"\n severity = item.get(\"severity\", \"medium\")\n priority_score = item.get(\"priority_score\", 0)\n debt_type = item.get(\"type\", \"\")\n \n return (severity in [\"high\", \"critical\"] or \n priority_score >= 7 or\n debt_type in [\"security_risk\", \"syntax_error\", \"architecture_debt\"])\n \n def _is_security_related(self, item: Dict[str, Any]) -> bool:\n \"\"\"Determine if debt item is security-related.\"\"\"\n debt_type = item.get(\"type\", \"\")\n description = item.get(\"description\", \"\").lower()\n \n security_types = [\"security_risk\", \"hardcoded_secrets\", \"sql_injection_risk\"]\n security_keywords = [\"password\", \"token\", \"key\", \"secret\", \"auth\", \"security\"]\n \n return (debt_type in security_types or \n any(keyword in description for keyword in security_keywords))\n \n def _calculate_health_metrics(self):\n \"\"\"Calculate health metrics for each snapshot.\"\"\"\n self.health_history = []\n \n for snapshot in self.processed_snapshots:\n # Debt density (lower is better)\n debt_density = snapshot[\"total_debt_items\"] / max(1, snapshot[\"total_files\"])\n debt_density_score = max(0, 100 - (debt_density * 20)) # Scale to 0-100\n \n # Complexity score (based on high complexity debt)\n complex_debt_ratio = (snapshot[\"debt_by_type\"].get(\"high_complexity\", 0) + \n snapshot[\"debt_by_type\"].get(\"large_function\", 0)) / max(1, snapshot[\"total_debt_items\"])\n complexity_score = max(0, 100 - (complex_debt_ratio * 100))\n \n # Test coverage proxy (based on test debt)\n test_debt_ratio = snapshot[\"debt_by_category\"].get(\"testing\", 0) / max(1, snapshot[\"total_debt_items\"])\n test_coverage_proxy = max(0, 100 - (test_debt_ratio * 150))\n \n # Documentation proxy (based on documentation debt)\n doc_debt_ratio = snapshot[\"debt_by_category\"].get(\"documentation\", 0) / max(1, snapshot[\"total_debt_items\"])\n documentation_proxy = max(0, 100 - (doc_debt_ratio * 100))\n \n # Security score (based on security debt)\n security_debt_ratio = snapshot[\"security_debt_count\"] / max(1, snapshot[\"total_debt_items\"])\n security_score = max(0, 100 - (security_debt_ratio * 200))\n \n # Maintainability (based on architecture and code quality debt)\n maint_debt_count = (snapshot[\"debt_by_category\"].get(\"architecture\", 0) + \n snapshot[\"debt_by_category\"].get(\"code_quality\", 0))\n maint_debt_ratio = maint_debt_count / max(1, snapshot[\"total_debt_items\"])\n maintainability = max(0, 100 - (maint_debt_ratio * 120))\n \n # Calculate weighted overall score\n weights = self.health_weights\n overall_score = (\n debt_density_score * weights[\"debt_density\"] +\n complexity_score * weights[\"complexity_score\"] +\n test_coverage_proxy * weights[\"test_coverage_proxy\"] +\n documentation_proxy * weights[\"documentation_proxy\"] +\n security_score * weights[\"security_score\"] +\n maintainability * weights[\"maintainability\"]\n )\n \n # Velocity impact (estimated percentage reduction in team velocity)\n high_impact_ratio = snapshot[\"high_priority_count\"] / max(1, snapshot[\"total_debt_items\"])\n velocity_impact = min(50, high_impact_ratio * 30 + debt_density * 5)\n \n # Technical risk (0-100, higher is more risky)\n risk_factors = snapshot[\"security_debt_count\"] + snapshot[\"debt_by_type\"].get(\"architecture_debt\", 0)\n technical_risk = min(100, risk_factors * 10 + (100 - security_score))\n \n health_metrics = HealthMetrics(\n overall_score=round(overall_score, 1),\n debt_density=round(debt_density, 2),\n velocity_impact=round(velocity_impact, 1),\n quality_score=round((complexity_score + maintainability) / 2, 1),\n maintainability_score=round(maintainability, 1),\n technical_risk_score=round(technical_risk, 1)\n )\n \n # Add timestamp\n health_entry = asdict(health_metrics)\n health_entry[\"date\"] = snapshot[\"date\"]\n self.health_history.append(health_entry)\n \n def _analyze_trends(self, period: str):\n \"\"\"Analyze trends in various metrics.\"\"\"\n self.trend_analyses = {}\n \n if len(self.health_history) \u003c 2:\n return\n \n # Define metrics to analyze\n metrics_to_analyze = [\n \"overall_score\",\n \"debt_density\", \n \"velocity_impact\",\n \"quality_score\",\n \"technical_risk_score\"\n ]\n \n for metric in metrics_to_analyze:\n values = [entry[metric] for entry in self.health_history]\n dates = [datetime.fromisoformat(entry[\"date\"].replace('Z', '+00:00')) \n for entry in self.health_history]\n \n trend = self._calculate_trend(values, dates, metric)\n self.trend_analyses[metric] = trend\n \n def _calculate_trend(self, values: List[float], dates: List[datetime], metric_name: str) -> TrendAnalysis:\n \"\"\"Calculate trend analysis for a specific metric.\"\"\"\n if len(values) \u003c 2:\n return TrendAnalysis(metric_name, \"stable\", 0.0, 0.0, values[-1], (values[-1], values[-1]))\n \n # Calculate simple linear trend\n n = len(values)\n x = list(range(n)) # Time periods as numbers\n \n # Linear regression\n x_mean = mean(x)\n y_mean = mean(values)\n \n numerator = sum((x[i] - x_mean) * (values[i] - y_mean) for i in range(n))\n denominator = sum((x[i] - x_mean) ** 2 for i in range(n))\n \n if denominator == 0:\n slope = 0\n else:\n slope = numerator / denominator\n \n # Correlation strength\n if n > 2 and len(set(values)) > 1:\n try:\n correlation = numerator / (\n (sum((x[i] - x_mean) ** 2 for i in range(n)) * \n sum((values[i] - y_mean) ** 2 for i in range(n))) ** 0.5\n )\n except ZeroDivisionError:\n correlation = 0.0\n else:\n correlation = 0.0\n \n # Determine trend direction\n if abs(slope) \u003c 0.1:\n trend_direction = \"stable\"\n elif slope > 0:\n if metric_name in [\"overall_score\", \"quality_score\"]:\n trend_direction = \"improving\" # Higher is better\n else:\n trend_direction = \"declining\" # Higher is worse\n else:\n if metric_name in [\"overall_score\", \"quality_score\"]:\n trend_direction = \"declining\"\n else:\n trend_direction = \"improving\"\n \n # Forecast next period\n forecast = values[-1] + slope\n \n # Confidence interval (simple approach)\n if n > 2:\n residuals = [values[i] - (y_mean + slope * (x[i] - x_mean)) for i in range(n)]\n std_error = (sum(r**2 for r in residuals) / (n - 2)) ** 0.5\n confidence_interval = (forecast - std_error, forecast + std_error)\n else:\n confidence_interval = (forecast, forecast)\n \n return TrendAnalysis(\n metric_name=metric_name,\n trend_direction=trend_direction,\n change_rate=round(slope, 3),\n correlation_strength=round(correlation, 3),\n forecast_next_period=round(forecast, 2),\n confidence_interval=(round(confidence_interval[0], 2), round(confidence_interval[1], 2))\n )\n \n def _calculate_debt_velocity(self, period: str):\n \"\"\"Calculate debt velocity between snapshots.\"\"\"\n self.velocity_history = []\n \n if len(self.processed_snapshots) \u003c 2:\n return\n \n for i in range(1, len(self.processed_snapshots)):\n current = self.processed_snapshots[i]\n previous = self.processed_snapshots[i-1]\n \n # Track debt by unique identifiers when possible\n current_debt_ids = set()\n previous_debt_ids = set()\n \n current_effort = current[\"total_effort_estimate\"]\n previous_effort = previous[\"total_effort_estimate\"]\n \n # Simple approach: compare total counts and effort\n debt_change = current[\"total_debt_items\"] - previous[\"total_debt_items\"]\n effort_change = current_effort - previous_effort\n \n # Estimate new vs resolved (rough approximation)\n if debt_change >= 0:\n new_debt_items = debt_change\n resolved_debt_items = 0\n else:\n new_debt_items = 0\n resolved_debt_items = abs(debt_change)\n \n # Calculate velocity ratio\n if new_debt_items > 0:\n velocity_ratio = resolved_debt_items / new_debt_items\n else:\n velocity_ratio = float('inf') if resolved_debt_items > 0 else 1.0\n \n velocity = DebtVelocity(\n period=f\"{previous['date'][:10]} to {current['date'][:10]}\",\n new_debt_items=new_debt_items,\n resolved_debt_items=resolved_debt_items,\n net_change=debt_change,\n velocity_ratio=min(10.0, velocity_ratio), # Cap at 10 for display\n effort_hours_added=max(0, effort_change),\n effort_hours_resolved=max(0, -effort_change),\n net_effort_change=effort_change\n )\n \n self.velocity_history.append(velocity)\n \n def _generate_forecasts(self) -> Dict[str, Any]:\n \"\"\"Generate forecasts based on trend analysis.\"\"\"\n if not self.trend_analyses:\n return {}\n \n forecasts = {}\n \n # Overall health forecast\n health_trend = self.trend_analyses.get(\"overall_score\")\n if health_trend:\n current_score = self.health_history[-1][\"overall_score\"]\n forecasts[\"health_score_3_months\"] = max(0, min(100, \n current_score + (health_trend.change_rate * 3)))\n forecasts[\"health_score_6_months\"] = max(0, min(100,\n current_score + (health_trend.change_rate * 6)))\n \n # Debt accumulation forecast\n if self.velocity_history:\n avg_net_change = mean([v.net_change for v in self.velocity_history[-3:]]) # Last 3 periods\n current_debt = self.processed_snapshots[-1][\"total_debt_items\"]\n \n forecasts[\"debt_count_3_months\"] = max(0, current_debt + (avg_net_change * 3))\n forecasts[\"debt_count_6_months\"] = max(0, current_debt + (avg_net_change * 6))\n \n # Risk forecast\n risk_trend = self.trend_analyses.get(\"technical_risk_score\")\n if risk_trend:\n current_risk = self.health_history[-1][\"technical_risk_score\"]\n forecasts[\"risk_score_3_months\"] = max(0, min(100,\n current_risk + (risk_trend.change_rate * 3)))\n \n return forecasts\n \n def _generate_executive_summary(self) -> Dict[str, Any]:\n \"\"\"Generate executive summary of debt status.\"\"\"\n if not self.health_history:\n return {}\n \n current_health = self.health_history[-1]\n \n # Determine overall status\n score = current_health[\"overall_score\"]\n if score >= self.thresholds[\"excellent\"]:\n status = \"excellent\"\n status_message = \"Code quality is excellent with minimal technical debt.\"\n elif score >= self.thresholds[\"good\"]:\n status = \"good\" \n status_message = \"Code quality is good with manageable technical debt.\"\n elif score >= self.thresholds[\"fair\"]:\n status = \"fair\"\n status_message = \"Code quality needs attention. Technical debt is accumulating.\"\n else:\n status = \"poor\"\n status_message = \"Critical: High levels of technical debt requiring immediate action.\"\n \n # Key insights\n insights = []\n \n if len(self.health_history) > 1:\n prev_health = self.health_history[-2]\n score_change = current_health[\"overall_score\"] - prev_health[\"overall_score\"]\n \n if score_change > 5:\n insights.append(\"Health score improving significantly\")\n elif score_change \u003c -5:\n insights.append(\"Health score declining - attention needed\")\n \n if current_health[\"velocity_impact\"] > 20:\n insights.append(\"High velocity impact detected - development speed affected\")\n \n if current_health[\"technical_risk_score\"] > 70:\n insights.append(\"High technical risk - security and stability concerns\")\n \n # Debt velocity insight\n if self.velocity_history:\n recent_velocity = self.velocity_history[-1]\n if recent_velocity.velocity_ratio \u003c 0.5:\n insights.append(\"Debt accumulating faster than resolution\")\n elif recent_velocity.velocity_ratio > 1.5:\n insights.append(\"Good progress on debt reduction\")\n \n return {\n \"overall_status\": status,\n \"health_score\": current_health[\"overall_score\"],\n \"status_message\": status_message,\n \"key_insights\": insights,\n \"total_debt_items\": self.processed_snapshots[-1][\"total_debt_items\"] if self.processed_snapshots else 0,\n \"estimated_effort_hours\": self.processed_snapshots[-1][\"total_effort_estimate\"] if self.processed_snapshots else 0,\n \"high_priority_items\": self.processed_snapshots[-1][\"high_priority_count\"] if self.processed_snapshots else 0,\n \"velocity_impact_percent\": current_health[\"velocity_impact\"]\n }\n \n def _generate_strategic_recommendations(self) -> List[Dict[str, Any]]:\n \"\"\"Generate strategic recommendations for debt management.\"\"\"\n recommendations = []\n \n if not self.health_history:\n return recommendations\n \n current_health = self.health_history[-1]\n current_snapshot = self.processed_snapshots[-1] if self.processed_snapshots else {}\n \n # Health-based recommendations\n if current_health[\"overall_score\"] \u003c 50:\n recommendations.append({\n \"priority\": \"critical\",\n \"category\": \"immediate_action\",\n \"title\": \"Initiate Emergency Debt Reduction\",\n \"description\": \"Current health score is critically low. Consider dedicating 50%+ of development capacity to debt reduction.\",\n \"impact\": \"high\",\n \"effort\": \"high\"\n })\n \n # Velocity impact recommendations\n if current_health[\"velocity_impact\"] > 25:\n recommendations.append({\n \"priority\": \"high\",\n \"category\": \"productivity\",\n \"title\": \"Address Velocity Blockers\",\n \"description\": f\"Technical debt is reducing team velocity by {current_health['velocity_impact']:.1f}%. Focus on high-impact debt items first.\",\n \"impact\": \"high\",\n \"effort\": \"medium\"\n })\n \n # Security recommendations\n if current_health[\"technical_risk_score\"] > 70:\n recommendations.append({\n \"priority\": \"high\",\n \"category\": \"security\",\n \"title\": \"Security Debt Review Required\",\n \"description\": \"High technical risk score indicates security vulnerabilities. Conduct immediate security debt audit.\",\n \"impact\": \"high\",\n \"effort\": \"medium\"\n })\n \n # Trend-based recommendations\n health_trend = self.trend_analyses.get(\"overall_score\")\n if health_trend and health_trend.trend_direction == \"declining\":\n recommendations.append({\n \"priority\": \"medium\",\n \"category\": \"process\",\n \"title\": \"Implement Debt Prevention Measures\",\n \"description\": \"Health score is declining over time. Establish coding standards, automated quality gates, and regular debt reviews.\",\n \"impact\": \"medium\",\n \"effort\": \"medium\"\n })\n \n # Category-specific recommendations\n if current_snapshot:\n debt_by_category = current_snapshot[\"debt_by_category\"]\n top_category = debt_by_category.most_common(1)[0] if debt_by_category else None\n \n if top_category and top_category[1] > 10:\n category, count = top_category\n recommendations.append({\n \"priority\": \"medium\",\n \"category\": \"focus_area\",\n \"title\": f\"Focus on {category.replace('_', ' ').title()} Debt\",\n \"description\": f\"{category.replace('_', ' ').title()} represents the largest debt category ({count} items). Consider targeted initiatives.\",\n \"impact\": \"medium\",\n \"effort\": \"medium\"\n })\n \n # Velocity-based recommendations\n if self.velocity_history:\n recent_velocities = self.velocity_history[-3:] if len(self.velocity_history) >= 3 else self.velocity_history\n avg_velocity_ratio = mean([v.velocity_ratio for v in recent_velocities])\n \n if avg_velocity_ratio \u003c 0.8:\n recommendations.append({\n \"priority\": \"medium\",\n \"category\": \"capacity\",\n \"title\": \"Increase Debt Resolution Capacity\",\n \"description\": \"Debt is accumulating faster than resolution. Consider increasing debt budget or improving resolution efficiency.\",\n \"impact\": \"medium\",\n \"effort\": \"low\"\n })\n \n return recommendations\n \n def _generate_visualization_data(self) -> Dict[str, Any]:\n \"\"\"Generate data for dashboard visualizations.\"\"\"\n visualizations = {}\n \n # Health score timeline\n visualizations[\"health_timeline\"] = [\n {\n \"date\": entry[\"date\"][:10], # Date only\n \"overall_score\": entry[\"overall_score\"],\n \"quality_score\": entry[\"quality_score\"],\n \"technical_risk\": entry[\"technical_risk_score\"]\n }\n for entry in self.health_history\n ]\n \n # Debt accumulation trend\n visualizations[\"debt_accumulation\"] = [\n {\n \"date\": snapshot[\"date\"][:10],\n \"total_debt\": snapshot[\"total_debt_items\"],\n \"high_priority\": snapshot[\"high_priority_count\"],\n \"security_debt\": snapshot[\"security_debt_count\"]\n }\n for snapshot in self.processed_snapshots\n ]\n \n # Category distribution (latest snapshot)\n if self.processed_snapshots:\n latest_categories = self.processed_snapshots[-1][\"debt_by_category\"]\n visualizations[\"category_distribution\"] = [\n {\"category\": category, \"count\": count}\n for category, count in latest_categories.items()\n ]\n \n # Velocity chart\n visualizations[\"debt_velocity\"] = [\n {\n \"period\": velocity.period,\n \"new_items\": velocity.new_debt_items,\n \"resolved_items\": velocity.resolved_debt_items,\n \"net_change\": velocity.net_change,\n \"velocity_ratio\": velocity.velocity_ratio\n }\n for velocity in self.velocity_history\n ]\n \n # Effort estimation trend\n visualizations[\"effort_trend\"] = [\n {\n \"date\": snapshot[\"date\"][:10],\n \"total_effort\": snapshot[\"total_effort_estimate\"]\n }\n for snapshot in self.processed_snapshots\n ]\n \n return visualizations\n \n def _get_detailed_metrics(self) -> Dict[str, Any]:\n \"\"\"Get detailed metrics for the current state.\"\"\"\n if not self.processed_snapshots:\n return {}\n \n current = self.processed_snapshots[-1]\n \n return {\n \"debt_breakdown\": dict(current[\"debt_by_type\"]),\n \"severity_breakdown\": dict(current[\"debt_by_severity\"]),\n \"category_breakdown\": dict(current[\"debt_by_category\"]),\n \"files_analyzed\": current[\"total_files\"],\n \"debt_density\": current[\"total_debt_items\"] / max(1, current[\"total_files\"]),\n \"average_effort_per_item\": current[\"total_effort_estimate\"] / max(1, current[\"total_debt_items\"])\n }\n\n\ndef format_dashboard_report(dashboard_data: Dict[str, Any]) -> str:\n \"\"\"Format dashboard data into human-readable report.\"\"\"\n output = []\n \n # Header\n output.append(\"=\" * 60)\n output.append(\"TECHNICAL DEBT DASHBOARD\")\n output.append(\"=\" * 60)\n metadata = dashboard_data[\"metadata\"]\n output.append(f\"Generated: {metadata['generated_date'][:19]}\")\n output.append(f\"Analysis Period: {metadata['analysis_period']}\")\n output.append(f\"Snapshots Analyzed: {metadata['snapshots_analyzed']}\")\n if metadata[\"date_range\"][\"start\"]:\n output.append(f\"Date Range: {metadata['date_range']['start'][:10]} to {metadata['date_range']['end'][:10]}\")\n output.append(\"\")\n \n # Executive Summary\n exec_summary = dashboard_data[\"executive_summary\"]\n output.append(\"EXECUTIVE SUMMARY\")\n output.append(\"-\" * 30)\n output.append(f\"Overall Status: {exec_summary['overall_status'].upper()}\")\n output.append(f\"Health Score: {exec_summary['health_score']:.1f}/100\")\n output.append(f\"Status: {exec_summary['status_message']}\")\n output.append(\"\")\n output.append(\"Key Metrics:\")\n output.append(f\" • Total Debt Items: {exec_summary['total_debt_items']}\")\n output.append(f\" • High Priority Items: {exec_summary['high_priority_items']}\")\n output.append(f\" • Estimated Effort: {exec_summary['estimated_effort_hours']:.1f} hours\")\n output.append(f\" • Velocity Impact: {exec_summary['velocity_impact_percent']:.1f}%\")\n output.append(\"\")\n \n if exec_summary[\"key_insights\"]:\n output.append(\"Key Insights:\")\n for insight in exec_summary[\"key_insights\"]:\n output.append(f\" • {insight}\")\n output.append(\"\")\n \n # Current Health\n if dashboard_data[\"current_health\"]:\n health = dashboard_data[\"current_health\"]\n output.append(\"CURRENT HEALTH METRICS\")\n output.append(\"-\" * 30)\n output.append(f\"Overall Score: {health['overall_score']:.1f}/100\")\n output.append(f\"Quality Score: {health['quality_score']:.1f}/100\")\n output.append(f\"Maintainability: {health['maintainability_score']:.1f}/100\")\n output.append(f\"Technical Risk: {health['technical_risk_score']:.1f}/100\")\n output.append(f\"Debt Density: {health['debt_density']:.2f} items/file\")\n output.append(\"\")\n \n # Trend Analysis\n trends = dashboard_data[\"trend_analysis\"]\n if trends:\n output.append(\"TREND ANALYSIS\")\n output.append(\"-\" * 30)\n for metric, trend in trends.items():\n direction_symbol = {\n \"improving\": \"↑\",\n \"declining\": \"↓\", \n \"stable\": \"→\"\n }.get(trend[\"trend_direction\"], \"→\")\n \n output.append(f\"{metric.replace('_', ' ').title()}: {direction_symbol} {trend['trend_direction']}\")\n output.append(f\" Change Rate: {trend['change_rate']:.3f} per period\")\n output.append(f\" Forecast: {trend['forecast_next_period']:.1f}\")\n output.append(\"\")\n \n # Top Recommendations\n recommendations = dashboard_data[\"recommendations\"]\n if recommendations:\n output.append(\"TOP RECOMMENDATIONS\")\n output.append(\"-\" * 30)\n for i, rec in enumerate(recommendations[:5], 1):\n output.append(f\"{i}. [{rec['priority'].upper()}] {rec['title']}\")\n output.append(f\" {rec['description']}\")\n output.append(f\" Impact: {rec['impact']}, Effort: {rec['effort']}\")\n output.append(\"\")\n \n return \"\\n\".join(output)\n\n\ndef main():\n \"\"\"Main entry point for the debt dashboard.\"\"\"\n parser = argparse.ArgumentParser(description=\"Generate technical debt dashboard\")\n parser.add_argument(\"files\", nargs=\"*\", help=\"Debt inventory files\")\n parser.add_argument(\"--input-dir\", help=\"Directory containing debt inventory files\")\n parser.add_argument(\"--output\", help=\"Output file path\")\n parser.add_argument(\"--format\", choices=[\"json\", \"text\", \"both\"], \n default=\"both\", help=\"Output format\")\n parser.add_argument(\"--period\", choices=[\"weekly\", \"monthly\", \"quarterly\"],\n default=\"monthly\", help=\"Analysis period\")\n parser.add_argument(\"--team-size\", type=int, default=5, help=\"Team size\")\n \n args = parser.parse_args()\n \n # Initialize dashboard\n dashboard = DebtDashboard(args.team_size)\n \n # Load data\n if args.input_dir:\n success = dashboard.load_from_directory(args.input_dir)\n elif args.files:\n success = dashboard.load_historical_data(args.files)\n else:\n print(\"Error: Must specify either files or --input-dir\")\n sys.exit(1)\n \n if not success:\n sys.exit(1)\n \n # Generate dashboard\n try:\n dashboard_data = dashboard.generate_dashboard(args.period)\n except Exception as e:\n print(f\"Dashboard generation failed: {e}\")\n sys.exit(1)\n \n # Output results\n if args.format in [\"json\", \"both\"]:\n json_output = json.dumps(dashboard_data, indent=2, default=str)\n if args.output:\n output_path = args.output if args.output.endswith('.json') else f\"{args.output}.json\"\n with open(output_path, 'w') as f:\n f.write(json_output)\n print(f\"JSON dashboard written to: {output_path}\")\n else:\n print(\"JSON DASHBOARD:\")\n print(\"=\" * 50)\n print(json_output)\n \n if args.format in [\"text\", \"both\"]:\n text_output = format_dashboard_report(dashboard_data)\n if args.output:\n output_path = args.output if args.output.endswith('.txt') else f\"{args.output}.txt\"\n with open(output_path, 'w') as f:\n f.write(text_output)\n print(f\"Text dashboard written to: {output_path}\")\n else:\n print(\"\\nTEXT DASHBOARD:\")\n print(\"=\" * 50)\n print(text_output)\n\n\nif __name__ == \"__main__\":\n main()","content_type":"text/x-python; charset=utf-8","language":"python","size":40885,"content_sha256":"3d5d7b519fc6038453aa0d9461539ff44e5e44a489b0de5e435006833541d345"},{"filename":"scripts/debt_prioritizer.py","content":"#!/usr/bin/env python3\n\"\"\"\nTech Debt Prioritizer\n\nTakes a debt inventory (from scanner or manual JSON) and calculates interest rate,\neffort estimates, and produces a prioritized backlog with recommended sprint allocation.\nUses cost-of-delay vs effort scoring and various prioritization frameworks.\n\nUsage:\n python debt_prioritizer.py debt_inventory.json\n python debt_prioritizer.py debt_inventory.json --output prioritized_backlog.json\n python debt_prioritizer.py debt_inventory.json --team-size 6 --sprint-capacity 80\n python debt_prioritizer.py debt_inventory.json --framework wsjf --output results.json\n\"\"\"\n\nimport json\nimport argparse\nimport sys\nimport math\nfrom collections import defaultdict, Counter\nfrom datetime import datetime, timedelta\nfrom typing import Dict, List, Any, Optional, Tuple\nfrom dataclasses import dataclass, asdict\n\n\n@dataclass\nclass EffortEstimate:\n \"\"\"Represents effort estimation for a debt item.\"\"\"\n size_points: int\n hours_estimate: float\n risk_factor: float # 1.0 = low risk, 1.5 = medium, 2.0+ = high\n skill_level_required: str # junior, mid, senior, expert\n confidence: float # 0.0-1.0\n\n\n@dataclass\nclass BusinessImpact:\n \"\"\"Represents business impact assessment for a debt item.\"\"\"\n customer_impact: int # 1-10 scale\n revenue_impact: int # 1-10 scale \n team_velocity_impact: int # 1-10 scale\n quality_impact: int # 1-10 scale\n security_impact: int # 1-10 scale\n\n\n@dataclass\nclass InterestRate:\n \"\"\"Represents the interest rate calculation for technical debt.\"\"\"\n daily_cost: float # cost per day if left unfixed\n frequency_multiplier: float # how often this code is touched\n team_impact_multiplier: float # how many developers affected\n compound_rate: float # how quickly this debt makes other debt worse\n\n\nclass DebtPrioritizer:\n \"\"\"Main class for prioritizing technical debt items.\"\"\"\n \n def __init__(self, team_size: int = 5, sprint_capacity_hours: int = 80):\n self.team_size = team_size\n self.sprint_capacity_hours = sprint_capacity_hours\n self.debt_items = []\n self.prioritized_items = []\n \n # Prioritization framework weights\n self.framework_weights = {\n \"cost_of_delay\": {\n \"business_value\": 0.3,\n \"urgency\": 0.3,\n \"risk_reduction\": 0.2,\n \"team_productivity\": 0.2\n },\n \"wsjf\": {\n \"business_value\": 0.25,\n \"time_criticality\": 0.25,\n \"risk_reduction\": 0.25,\n \"effort\": 0.25\n },\n \"rice\": {\n \"reach\": 0.25,\n \"impact\": 0.25,\n \"confidence\": 0.25,\n \"effort\": 0.25\n }\n }\n \n def load_debt_inventory(self, file_path: str) -> bool:\n \"\"\"Load debt inventory from JSON file.\"\"\"\n try:\n with open(file_path, 'r', encoding='utf-8') as f:\n data = json.load(f)\n \n # Handle different input formats\n if isinstance(data, dict) and 'debt_items' in data:\n self.debt_items = data['debt_items']\n elif isinstance(data, list):\n self.debt_items = data\n else:\n raise ValueError(\"Invalid debt inventory format\")\n \n print(f\"Loaded {len(self.debt_items)} debt items from {file_path}\")\n return True\n \n except Exception as e:\n print(f\"Error loading debt inventory: {e}\")\n return False\n \n def analyze_and_prioritize(self, framework: str = \"cost_of_delay\") -> Dict[str, Any]:\n \"\"\"\n Analyze debt items and create prioritized backlog.\n \n Args:\n framework: Prioritization framework to use\n \n Returns:\n Dictionary containing prioritized backlog and analysis\n \"\"\"\n print(f\"Analyzing {len(self.debt_items)} debt items...\")\n print(f\"Using {framework} prioritization framework\")\n print(\"=\" * 50)\n \n # Step 1: Enrich debt items with estimates\n enriched_items = []\n for item in self.debt_items:\n enriched_item = self._enrich_debt_item(item)\n enriched_items.append(enriched_item)\n \n # Step 2: Calculate prioritization scores\n for item in enriched_items:\n if framework == \"cost_of_delay\":\n item[\"priority_score\"] = self._calculate_cost_of_delay_score(item)\n elif framework == \"wsjf\":\n item[\"priority_score\"] = self._calculate_wsjf_score(item)\n elif framework == \"rice\":\n item[\"priority_score\"] = self._calculate_rice_score(item)\n else:\n raise ValueError(f\"Unknown prioritization framework: {framework}\")\n \n # Step 3: Sort by priority score\n self.prioritized_items = sorted(enriched_items, \n key=lambda x: x[\"priority_score\"], \n reverse=True)\n \n # Step 4: Generate sprint allocation recommendations\n sprint_allocation = self._generate_sprint_allocation()\n \n # Step 5: Generate insights and recommendations\n insights = self._generate_insights()\n \n # Step 6: Create visualization data\n charts_data = self._generate_charts_data()\n \n return {\n \"metadata\": {\n \"analysis_date\": datetime.now().isoformat(),\n \"framework_used\": framework,\n \"team_size\": self.team_size,\n \"sprint_capacity_hours\": self.sprint_capacity_hours,\n \"total_items_analyzed\": len(self.debt_items)\n },\n \"prioritized_backlog\": self.prioritized_items,\n \"sprint_allocation\": sprint_allocation,\n \"insights\": insights,\n \"charts_data\": charts_data,\n \"recommendations\": self._generate_recommendations()\n }\n \n def _enrich_debt_item(self, item: Dict[str, Any]) -> Dict[str, Any]:\n \"\"\"Enrich debt item with detailed estimates and impact analysis.\"\"\"\n enriched = item.copy()\n \n # Generate effort estimate\n effort = self._estimate_effort(item)\n enriched[\"effort_estimate\"] = asdict(effort)\n \n # Generate business impact assessment\n business_impact = self._assess_business_impact(item)\n enriched[\"business_impact\"] = asdict(business_impact)\n \n # Calculate interest rate\n interest_rate = self._calculate_interest_rate(item, business_impact)\n enriched[\"interest_rate\"] = asdict(interest_rate)\n \n # Calculate cost of delay\n enriched[\"cost_of_delay\"] = self._calculate_cost_of_delay(interest_rate, effort)\n \n # Assign categories and tags\n enriched[\"category\"] = self._categorize_debt_item(item)\n enriched[\"impact_tags\"] = self._generate_impact_tags(item, business_impact)\n \n return enriched\n \n def _estimate_effort(self, item: Dict[str, Any]) -> EffortEstimate:\n \"\"\"Estimate effort required to fix debt item.\"\"\"\n debt_type = item.get(\"type\", \"unknown\")\n severity = item.get(\"severity\", \"medium\")\n \n # Base effort estimation by debt type\n base_efforts = {\n \"todo_comment\": (1, 2),\n \"missing_docstring\": (1, 4),\n \"long_line\": (0.5, 1),\n \"large_function\": (4, 16),\n \"high_complexity\": (8, 32),\n \"duplicate_code\": (6, 24),\n \"large_file\": (16, 64),\n \"syntax_error\": (2, 8),\n \"security_risk\": (4, 40),\n \"architecture_debt\": (40, 160),\n \"test_debt\": (8, 40),\n \"dependency_debt\": (4, 24)\n }\n \n min_hours, max_hours = base_efforts.get(debt_type, (4, 16))\n \n # Adjust by severity\n severity_multipliers = {\n \"low\": 0.5,\n \"medium\": 1.0,\n \"high\": 1.5,\n \"critical\": 2.0\n }\n \n multiplier = severity_multipliers.get(severity, 1.0)\n hours_estimate = (min_hours + max_hours) / 2 * multiplier\n \n # Convert to story points (assuming 6 hours per point)\n size_points = max(1, round(hours_estimate / 6))\n \n # Determine risk factor\n risk_factor = 1.0\n if debt_type in [\"architecture_debt\", \"security_risk\", \"large_file\"]:\n risk_factor = 1.8\n elif debt_type in [\"high_complexity\", \"duplicate_code\"]:\n risk_factor = 1.4\n elif debt_type in [\"syntax_error\", \"dependency_debt\"]:\n risk_factor = 1.2\n \n # Determine skill level required\n skill_requirements = {\n \"architecture_debt\": \"expert\",\n \"security_risk\": \"senior\",\n \"high_complexity\": \"senior\",\n \"large_function\": \"mid\",\n \"duplicate_code\": \"mid\",\n \"dependency_debt\": \"mid\",\n \"test_debt\": \"mid\",\n \"todo_comment\": \"junior\",\n \"missing_docstring\": \"junior\",\n \"long_line\": \"junior\"\n }\n \n skill_level = skill_requirements.get(debt_type, \"mid\")\n \n # Confidence based on debt type clarity\n confidence_levels = {\n \"todo_comment\": 0.9,\n \"missing_docstring\": 0.9,\n \"long_line\": 0.95,\n \"syntax_error\": 0.8,\n \"large_function\": 0.7,\n \"duplicate_code\": 0.6,\n \"high_complexity\": 0.5,\n \"architecture_debt\": 0.3,\n \"security_risk\": 0.4\n }\n \n confidence = confidence_levels.get(debt_type, 0.6)\n \n return EffortEstimate(\n size_points=size_points,\n hours_estimate=hours_estimate,\n risk_factor=risk_factor,\n skill_level_required=skill_level,\n confidence=confidence\n )\n \n def _assess_business_impact(self, item: Dict[str, Any]) -> BusinessImpact:\n \"\"\"Assess business impact of debt item.\"\"\"\n debt_type = item.get(\"type\", \"unknown\")\n severity = item.get(\"severity\", \"medium\")\n \n # Base impact scores by debt type (1-10 scale)\n impact_profiles = {\n \"security_risk\": (9, 8, 7, 9, 10), # customer, revenue, velocity, quality, security\n \"architecture_debt\": (6, 7, 9, 8, 4),\n \"large_function\": (3, 4, 7, 6, 2),\n \"high_complexity\": (4, 5, 8, 7, 3),\n \"duplicate_code\": (3, 4, 6, 6, 2),\n \"syntax_error\": (7, 6, 8, 9, 3),\n \"test_debt\": (5, 5, 7, 8, 3),\n \"dependency_debt\": (6, 5, 6, 7, 7),\n \"todo_comment\": (1, 1, 2, 2, 1),\n \"missing_docstring\": (2, 2, 4, 3, 1)\n }\n \n base_impacts = impact_profiles.get(debt_type, (3, 3, 5, 5, 3))\n \n # Adjust by severity\n severity_adjustments = {\n \"low\": 0.6,\n \"medium\": 1.0,\n \"high\": 1.4,\n \"critical\": 1.8\n }\n \n adjustment = severity_adjustments.get(severity, 1.0)\n \n # Apply adjustment and cap at 10\n adjusted_impacts = [min(10, max(1, round(impact * adjustment))) \n for impact in base_impacts]\n \n return BusinessImpact(\n customer_impact=adjusted_impacts[0],\n revenue_impact=adjusted_impacts[1],\n team_velocity_impact=adjusted_impacts[2],\n quality_impact=adjusted_impacts[3],\n security_impact=adjusted_impacts[4]\n )\n \n def _calculate_interest_rate(self, item: Dict[str, Any], \n business_impact: BusinessImpact) -> InterestRate:\n \"\"\"Calculate interest rate for technical debt.\"\"\"\n \n # Base daily cost calculation\n velocity_impact = business_impact.team_velocity_impact\n quality_impact = business_impact.quality_impact\n \n # Daily cost in \"developer hours lost\"\n daily_cost = (velocity_impact * 0.5) + (quality_impact * 0.3)\n \n # Frequency multiplier based on code location and type\n file_path = item.get(\"file_path\", \"\")\n debt_type = item.get(\"type\", \"unknown\")\n \n # Estimate frequency based on file path patterns\n frequency_multiplier = 1.0\n if any(pattern in file_path.lower() for pattern in [\"main\", \"core\", \"auth\", \"api\"]):\n frequency_multiplier = 2.0\n elif any(pattern in file_path.lower() for pattern in [\"util\", \"helper\", \"common\"]):\n frequency_multiplier = 1.5\n elif any(pattern in file_path.lower() for pattern in [\"test\", \"spec\", \"config\"]):\n frequency_multiplier = 0.5\n \n # Team impact multiplier\n team_impact_multiplier = min(self.team_size, 8) / 5.0 # Normalize around team of 5\n \n # Compound rate - how this debt creates more debt\n compound_rates = {\n \"architecture_debt\": 0.1, # Creates 10% more debt monthly\n \"duplicate_code\": 0.08,\n \"high_complexity\": 0.05,\n \"large_function\": 0.03,\n \"test_debt\": 0.04,\n \"security_risk\": 0.02, # Doesn't compound much, but high initial impact\n \"todo_comment\": 0.01\n }\n \n compound_rate = compound_rates.get(debt_type, 0.02)\n \n return InterestRate(\n daily_cost=daily_cost,\n frequency_multiplier=frequency_multiplier,\n team_impact_multiplier=team_impact_multiplier,\n compound_rate=compound_rate\n )\n \n def _calculate_cost_of_delay(self, interest_rate: InterestRate, \n effort: EffortEstimate) -> float:\n \"\"\"Calculate total cost of delay if debt is not fixed.\"\"\"\n \n # Estimate delay in days (assuming debt gets fixed eventually)\n estimated_delay_days = effort.hours_estimate / (self.sprint_capacity_hours / 14) # 2-week sprints\n \n # Calculate cumulative cost\n daily_cost = (interest_rate.daily_cost * \n interest_rate.frequency_multiplier * \n interest_rate.team_impact_multiplier)\n \n # Add compound interest effect\n compound_effect = (1 + interest_rate.compound_rate) ** (estimated_delay_days / 30)\n \n total_cost = daily_cost * estimated_delay_days * compound_effect\n \n return round(total_cost, 2)\n \n def _categorize_debt_item(self, item: Dict[str, Any]) -> str:\n \"\"\"Categorize debt item into high-level categories.\"\"\"\n debt_type = item.get(\"type\", \"unknown\")\n \n categories = {\n \"code_quality\": [\"large_function\", \"high_complexity\", \"duplicate_code\", \n \"long_line\", \"missing_docstring\"],\n \"architecture\": [\"architecture_debt\", \"large_file\"],\n \"security\": [\"security_risk\", \"hardcoded_secrets\"],\n \"testing\": [\"test_debt\", \"missing_tests\"],\n \"maintenance\": [\"todo_comment\", \"commented_code\"],\n \"dependencies\": [\"dependency_debt\", \"outdated_packages\"],\n \"infrastructure\": [\"deployment_debt\", \"monitoring_gaps\"],\n \"documentation\": [\"missing_docstring\", \"outdated_docs\"]\n }\n \n for category, types in categories.items():\n if debt_type in types:\n return category\n \n return \"other\"\n \n def _generate_impact_tags(self, item: Dict[str, Any], \n business_impact: BusinessImpact) -> List[str]:\n \"\"\"Generate impact tags for debt item.\"\"\"\n tags = []\n \n if business_impact.security_impact >= 7:\n tags.append(\"security-critical\")\n if business_impact.customer_impact >= 7:\n tags.append(\"customer-facing\")\n if business_impact.revenue_impact >= 7:\n tags.append(\"revenue-impact\")\n if business_impact.team_velocity_impact >= 7:\n tags.append(\"velocity-blocker\")\n if business_impact.quality_impact >= 7:\n tags.append(\"quality-risk\")\n \n # Add effort-based tags\n effort_hours = item.get(\"effort_estimate\", {}).get(\"hours_estimate\", 0)\n if effort_hours \u003c= 4:\n tags.append(\"quick-win\")\n elif effort_hours >= 40:\n tags.append(\"major-initiative\")\n \n return tags\n \n def _calculate_cost_of_delay_score(self, item: Dict[str, Any]) -> float:\n \"\"\"Calculate priority score using cost-of-delay framework.\"\"\"\n business_impact = item[\"business_impact\"]\n effort = item[\"effort_estimate\"]\n \n # Business value (weighted average of impacts)\n business_value = (\n business_impact[\"customer_impact\"] * 0.3 +\n business_impact[\"revenue_impact\"] * 0.3 +\n business_impact[\"quality_impact\"] * 0.2 +\n business_impact[\"team_velocity_impact\"] * 0.2\n )\n \n # Urgency (how quickly value decreases)\n urgency = item[\"interest_rate\"][\"daily_cost\"] * 10 # Scale to 1-10\n urgency = min(10, max(1, urgency))\n \n # Risk reduction\n risk_reduction = business_impact[\"security_impact\"] * 0.6 + business_impact[\"quality_impact\"] * 0.4\n \n # Team productivity impact\n team_productivity = business_impact[\"team_velocity_impact\"]\n \n # Combine with weights\n weights = self.framework_weights[\"cost_of_delay\"]\n numerator = (\n business_value * weights[\"business_value\"] +\n urgency * weights[\"urgency\"] +\n risk_reduction * weights[\"risk_reduction\"] +\n team_productivity * weights[\"team_productivity\"]\n )\n \n # Divide by effort (adjusted for risk)\n effort_adjusted = effort[\"hours_estimate\"] * effort[\"risk_factor\"]\n denominator = max(1, effort_adjusted / 8) # Normalize to story points\n \n return round(numerator / denominator, 2)\n \n def _calculate_wsjf_score(self, item: Dict[str, Any]) -> float:\n \"\"\"Calculate priority score using Weighted Shortest Job First (WSJF).\"\"\"\n business_impact = item[\"business_impact\"]\n effort = item[\"effort_estimate\"]\n \n # Business value\n business_value = (\n business_impact[\"customer_impact\"] * 0.4 +\n business_impact[\"revenue_impact\"] * 0.6\n )\n \n # Time criticality\n time_criticality = item[\"cost_of_delay\"] / 10 # Normalize\n time_criticality = min(10, max(1, time_criticality))\n \n # Risk reduction\n risk_reduction = (\n business_impact[\"security_impact\"] * 0.5 +\n business_impact[\"quality_impact\"] * 0.5\n )\n \n # Job size (effort)\n job_size = effort[\"size_points\"]\n \n # WSJF calculation\n numerator = business_value + time_criticality + risk_reduction\n denominator = max(1, job_size)\n \n return round(numerator / denominator, 2)\n \n def _calculate_rice_score(self, item: Dict[str, Any]) -> float:\n \"\"\"Calculate priority score using RICE framework.\"\"\"\n business_impact = item[\"business_impact\"]\n effort = item[\"effort_estimate\"]\n \n # Reach (how many developers/users affected)\n reach = min(10, self.team_size * business_impact[\"team_velocity_impact\"] / 5)\n \n # Impact\n impact = (\n business_impact[\"customer_impact\"] * 0.3 +\n business_impact[\"revenue_impact\"] * 0.3 +\n business_impact[\"quality_impact\"] * 0.4\n )\n \n # Confidence\n confidence = effort[\"confidence\"] * 10\n \n # Effort\n effort_score = effort[\"size_points\"]\n \n # RICE calculation\n rice_score = (reach * impact * confidence) / max(1, effort_score)\n \n return round(rice_score, 2)\n \n def _generate_sprint_allocation(self) -> Dict[str, Any]:\n \"\"\"Generate sprint allocation recommendations.\"\"\"\n # Calculate total effort needed\n total_effort_hours = sum(item[\"effort_estimate\"][\"hours_estimate\"] \n for item in self.prioritized_items)\n \n # Assume 20% of sprint capacity goes to tech debt\n debt_capacity_per_sprint = self.sprint_capacity_hours * 0.2\n \n # Allocate items to sprints\n sprints = []\n current_sprint = {\"sprint_number\": 1, \"items\": [], \"total_hours\": 0, \"capacity_used\": 0}\n \n for item in self.prioritized_items:\n item_effort = item[\"effort_estimate\"][\"hours_estimate\"]\n \n if current_sprint[\"total_hours\"] + item_effort \u003c= debt_capacity_per_sprint:\n current_sprint[\"items\"].append(item)\n current_sprint[\"total_hours\"] += item_effort\n current_sprint[\"capacity_used\"] = current_sprint[\"total_hours\"] / debt_capacity_per_sprint\n else:\n # Start new sprint\n sprints.append(current_sprint)\n current_sprint = {\n \"sprint_number\": len(sprints) + 1,\n \"items\": [item],\n \"total_hours\": item_effort,\n \"capacity_used\": item_effort / debt_capacity_per_sprint\n }\n \n # Add the last sprint\n if current_sprint[\"items\"]:\n sprints.append(current_sprint)\n \n # Calculate summary statistics\n total_sprints_needed = len(sprints)\n high_priority_items = len([item for item in self.prioritized_items \n if item.get(\"priority\", \"medium\") in [\"high\", \"critical\"]])\n \n return {\n \"total_debt_hours\": round(total_effort_hours, 1),\n \"debt_capacity_per_sprint\": debt_capacity_per_sprint,\n \"total_sprints_needed\": total_sprints_needed,\n \"high_priority_items\": high_priority_items,\n \"sprint_plan\": sprints[:6], # Show first 6 sprints\n \"recommendations\": [\n f\"Allocate {debt_capacity_per_sprint} hours per sprint to tech debt\",\n f\"Focus on {high_priority_items} high-priority items first\",\n f\"Estimated {total_sprints_needed} sprints to clear current backlog\"\n ]\n }\n \n def _generate_insights(self) -> Dict[str, Any]:\n \"\"\"Generate insights from the prioritized debt analysis.\"\"\"\n \n # Category distribution\n categories = Counter(item[\"category\"] for item in self.prioritized_items)\n \n # Effort distribution\n total_effort = sum(item[\"effort_estimate\"][\"hours_estimate\"] \n for item in self.prioritized_items)\n effort_by_category = defaultdict(float)\n for item in self.prioritized_items:\n effort_by_category[item[\"category\"]] += item[\"effort_estimate\"][\"hours_estimate\"]\n \n # Priority distribution\n priorities = Counter()\n for item in self.prioritized_items:\n score = item[\"priority_score\"]\n if score >= 8:\n priorities[\"critical\"] += 1\n elif score >= 5:\n priorities[\"high\"] += 1\n elif score >= 2:\n priorities[\"medium\"] += 1\n else:\n priorities[\"low\"] += 1\n \n # Risk analysis\n high_risk_items = [item for item in self.prioritized_items \n if item[\"effort_estimate\"][\"risk_factor\"] >= 1.5]\n \n # Quick wins identification\n quick_wins = [item for item in self.prioritized_items \n if (item[\"effort_estimate\"][\"hours_estimate\"] \u003c= 8 and \n item[\"priority_score\"] >= 3)]\n \n # Cost analysis\n total_cost_of_delay = sum(item[\"cost_of_delay\"] for item in self.prioritized_items)\n avg_interest_rate = sum(item[\"interest_rate\"][\"daily_cost\"] \n for item in self.prioritized_items) / len(self.prioritized_items)\n \n return {\n \"category_distribution\": dict(categories),\n \"total_effort_hours\": round(total_effort, 1),\n \"effort_by_category\": {k: round(v, 1) for k, v in effort_by_category.items()},\n \"priority_distribution\": dict(priorities),\n \"high_risk_items_count\": len(high_risk_items),\n \"quick_wins_count\": len(quick_wins),\n \"total_cost_of_delay\": round(total_cost_of_delay, 1),\n \"average_daily_interest_rate\": round(avg_interest_rate, 2),\n \"top_categories_by_effort\": sorted(effort_by_category.items(), \n key=lambda x: x[1], reverse=True)[:3]\n }\n \n def _generate_charts_data(self) -> Dict[str, Any]:\n \"\"\"Generate data for charts and visualizations.\"\"\"\n \n # Priority vs Effort scatter plot data\n scatter_data = []\n for item in self.prioritized_items:\n scatter_data.append({\n \"x\": item[\"effort_estimate\"][\"hours_estimate\"],\n \"y\": item[\"priority_score\"],\n \"label\": item.get(\"description\", \"\")[:50],\n \"category\": item[\"category\"],\n \"size\": item[\"cost_of_delay\"]\n })\n \n # Category effort distribution (pie chart)\n effort_by_category = defaultdict(float)\n for item in self.prioritized_items:\n effort_by_category[item[\"category\"]] += item[\"effort_estimate\"][\"hours_estimate\"]\n \n pie_data = [{\"category\": k, \"effort\": round(v, 1)} \n for k, v in effort_by_category.items()]\n \n # Priority timeline (bar chart)\n timeline_data = []\n cumulative_effort = 0\n for i, item in enumerate(self.prioritized_items[:20]): # Top 20 items\n cumulative_effort += item[\"effort_estimate\"][\"hours_estimate\"]\n timeline_data.append({\n \"item_rank\": i + 1,\n \"description\": item.get(\"description\", \"\")[:30],\n \"effort\": item[\"effort_estimate\"][\"hours_estimate\"],\n \"cumulative_effort\": round(cumulative_effort, 1),\n \"priority_score\": item[\"priority_score\"]\n })\n \n # Interest rate trend (line chart data structure)\n interest_trend_data = []\n for i, item in enumerate(self.prioritized_items):\n interest_trend_data.append({\n \"item_index\": i,\n \"daily_cost\": item[\"interest_rate\"][\"daily_cost\"],\n \"category\": item[\"category\"]\n })\n \n return {\n \"priority_effort_scatter\": scatter_data,\n \"category_effort_distribution\": pie_data,\n \"priority_timeline\": timeline_data,\n \"interest_rate_trend\": interest_trend_data[:50] # Limit for performance\n }\n \n def _generate_recommendations(self) -> List[str]:\n \"\"\"Generate actionable recommendations based on analysis.\"\"\"\n recommendations = []\n \n insights = self._generate_insights()\n \n # Quick wins recommendation\n if insights[\"quick_wins_count\"] > 0:\n recommendations.append(\n f\"Start with {insights['quick_wins_count']} quick wins to build momentum \"\n \"and demonstrate immediate value from tech debt reduction efforts.\"\n )\n \n # High-risk items\n if insights[\"high_risk_items_count\"] > 5:\n recommendations.append(\n f\"Plan careful execution for {insights['high_risk_items_count']} high-risk items. \"\n \"Consider pair programming, extra testing, and incremental approaches.\"\n )\n \n # Category focus\n top_category = insights[\"top_categories_by_effort\"][0][0]\n recommendations.append(\n f\"Focus initial efforts on '{top_category}' category debt, which represents \"\n f\"the largest effort investment ({insights['top_categories_by_effort'][0][1]:.1f} hours).\"\n )\n \n # Cost of delay urgency\n if insights[\"average_daily_interest_rate\"] > 5:\n recommendations.append(\n f\"High average daily interest rate ({insights['average_daily_interest_rate']:.1f}) \"\n \"suggests urgent action needed. Consider increasing tech debt budget allocation.\"\n )\n \n # Sprint planning\n sprints_needed = len(self.prioritized_items) / 10 # Rough estimate\n if sprints_needed > 12:\n recommendations.append(\n \"Large debt backlog detected. Consider dedicating entire sprints to debt reduction \"\n \"rather than trying to fit debt work around features.\"\n )\n \n # Team capacity\n total_effort = insights[\"total_effort_hours\"]\n weeks_needed = total_effort / (self.sprint_capacity_hours * 0.2)\n if weeks_needed > 26: # Half a year\n recommendations.append(\n f\"With current capacity allocation, debt backlog will take {weeks_needed:.0f} weeks. \"\n \"Consider increasing tech debt budget or focusing on highest-impact items only.\"\n )\n \n return recommendations\n\n\ndef format_prioritized_report(analysis_result: Dict[str, Any]) -> str:\n \"\"\"Format the prioritization analysis in human-readable format.\"\"\"\n output = []\n \n # Header\n output.append(\"=\" * 60)\n output.append(\"TECHNICAL DEBT PRIORITIZATION REPORT\")\n output.append(\"=\" * 60)\n metadata = analysis_result[\"metadata\"]\n output.append(f\"Analysis Date: {metadata['analysis_date']}\")\n output.append(f\"Framework: {metadata['framework_used'].upper()}\")\n output.append(f\"Team Size: {metadata['team_size']}\")\n output.append(f\"Sprint Capacity: {metadata['sprint_capacity_hours']} hours\")\n output.append(\"\")\n \n # Executive Summary\n insights = analysis_result[\"insights\"]\n output.append(\"EXECUTIVE SUMMARY\")\n output.append(\"-\" * 30)\n output.append(f\"Total Debt Items: {metadata['total_items_analyzed']}\")\n output.append(f\"Total Effort Required: {insights['total_effort_hours']} hours\")\n output.append(f\"Total Cost of Delay: ${insights['total_cost_of_delay']:,.0f}\")\n output.append(f\"Quick Wins Available: {insights['quick_wins_count']}\")\n output.append(f\"High-Risk Items: {insights['high_risk_items_count']}\")\n output.append(\"\")\n \n # Sprint Plan\n sprint_plan = analysis_result[\"sprint_allocation\"]\n output.append(\"SPRINT ALLOCATION PLAN\")\n output.append(\"-\" * 30)\n output.append(f\"Sprints Needed: {sprint_plan['total_sprints_needed']}\")\n output.append(f\"Hours per Sprint: {sprint_plan['debt_capacity_per_sprint']}\")\n output.append(\"\")\n \n for sprint in sprint_plan[\"sprint_plan\"][:3]: # Show first 3 sprints\n output.append(f\"Sprint {sprint['sprint_number']} ({sprint['capacity_used']:.0%} capacity):\")\n for item in sprint[\"items\"][:3]: # Top 3 items per sprint\n output.append(f\" • {item['description'][:50]}...\")\n output.append(f\" Effort: {item['effort_estimate']['hours_estimate']:.1f}h, \"\n f\"Priority: {item['priority_score']}\")\n output.append(\"\")\n \n # Top Priority Items\n output.append(\"TOP 10 PRIORITY ITEMS\")\n output.append(\"-\" * 30)\n for i, item in enumerate(analysis_result[\"prioritized_backlog\"][:10], 1):\n output.append(f\"{i}. [{item['priority_score']:.1f}] {item['description']}\")\n output.append(f\" Category: {item['category']}, \"\n f\"Effort: {item['effort_estimate']['hours_estimate']:.1f}h, \"\n f\"Cost of Delay: ${item['cost_of_delay']:.0f}\")\n if item[\"impact_tags\"]:\n output.append(f\" Tags: {', '.join(item['impact_tags'])}\")\n output.append(\"\")\n \n # Recommendations\n output.append(\"RECOMMENDATIONS\")\n output.append(\"-\" * 30)\n for i, rec in enumerate(analysis_result[\"recommendations\"], 1):\n output.append(f\"{i}. {rec}\")\n output.append(\"\")\n \n return \"\\n\".join(output)\n\n\ndef main():\n \"\"\"Main entry point for the debt prioritizer.\"\"\"\n parser = argparse.ArgumentParser(description=\"Prioritize technical debt backlog\")\n parser.add_argument(\"inventory_file\", help=\"Path to debt inventory JSON file\")\n parser.add_argument(\"--output\", help=\"Output file path\")\n parser.add_argument(\"--format\", choices=[\"json\", \"text\", \"both\"], \n default=\"both\", help=\"Output format\")\n parser.add_argument(\"--framework\", choices=[\"cost_of_delay\", \"wsjf\", \"rice\"],\n default=\"cost_of_delay\", help=\"Prioritization framework\")\n parser.add_argument(\"--team-size\", type=int, default=5, help=\"Team size\")\n parser.add_argument(\"--sprint-capacity\", type=int, default=80, \n help=\"Sprint capacity in hours\")\n \n args = parser.parse_args()\n \n # Initialize prioritizer\n prioritizer = DebtPrioritizer(args.team_size, args.sprint_capacity)\n \n # Load inventory\n if not prioritizer.load_debt_inventory(args.inventory_file):\n sys.exit(1)\n \n # Analyze and prioritize\n try:\n analysis_result = prioritizer.analyze_and_prioritize(args.framework)\n except Exception as e:\n print(f\"Analysis failed: {e}\")\n sys.exit(1)\n \n # Output results\n if args.format in [\"json\", \"both\"]:\n json_output = json.dumps(analysis_result, indent=2, default=str)\n if args.output:\n output_path = args.output if args.output.endswith('.json') else f\"{args.output}.json\"\n with open(output_path, 'w') as f:\n f.write(json_output)\n print(f\"JSON report written to: {output_path}\")\n else:\n print(\"JSON REPORT:\")\n print(\"=\" * 50)\n print(json_output)\n \n if args.format in [\"text\", \"both\"]:\n text_output = format_prioritized_report(analysis_result)\n if args.output:\n output_path = args.output if args.output.endswith('.txt') else f\"{args.output}.txt\"\n with open(output_path, 'w') as f:\n f.write(text_output)\n print(f\"Text report written to: {output_path}\")\n else:\n print(\"\\nTEXT REPORT:\")\n print(\"=\" * 50)\n print(text_output)\n\n\nif __name__ == \"__main__\":\n main()","content_type":"text/x-python; charset=utf-8","language":"python","size":34696,"content_sha256":"ddc579908d5205654ec4f0c2b90e0ecc71a8aad92dbc289396a5e2d414290871"},{"filename":"scripts/debt_scanner.py","content":"#!/usr/bin/env python3\n\"\"\"\nTech Debt Scanner\n\nScans a codebase directory for tech debt signals using AST parsing (Python) and \nregex patterns (any language). Detects various forms of technical debt and generates\nboth JSON inventory and human-readable reports.\n\nUsage:\n python debt_scanner.py /path/to/codebase\n python debt_scanner.py /path/to/codebase --config config.json\n python debt_scanner.py /path/to/codebase --output report.json --format both\n\"\"\"\n\nimport ast\nimport json\nimport argparse\nimport os\nimport re\nimport sys\nfrom collections import defaultdict, Counter\nfrom datetime import datetime\nfrom pathlib import Path\nfrom typing import Dict, List, Any, Optional, Set, Tuple\n\n\nclass DebtScanner:\n \"\"\"Main scanner class for detecting technical debt in codebases.\"\"\"\n \n def __init__(self, config: Optional[Dict[str, Any]] = None):\n self.config = self._load_default_config()\n if config:\n self.config.update(config)\n \n self.debt_items = []\n self.stats = defaultdict(int)\n self.file_stats = {}\n \n # Compile regex patterns for performance\n self._compile_patterns()\n \n def _load_default_config(self) -> Dict[str, Any]:\n \"\"\"Load default configuration for debt detection.\"\"\"\n return {\n \"max_function_length\": 50,\n \"max_complexity\": 10,\n \"max_nesting_depth\": 4,\n \"max_file_size_lines\": 500,\n \"min_duplicate_lines\": 3,\n \"ignore_patterns\": [\n \"*.pyc\", \"__pycache__\", \".git\", \".svn\", \"node_modules\",\n \"build\", \"dist\", \"*.min.js\", \"*.map\"\n ],\n \"file_extensions\": {\n \"python\": [\".py\"],\n \"javascript\": [\".js\", \".jsx\", \".ts\", \".tsx\"],\n \"java\": [\".java\"],\n \"csharp\": [\".cs\"],\n \"cpp\": [\".cpp\", \".cc\", \".cxx\", \".c\", \".h\", \".hpp\"],\n \"ruby\": [\".rb\"],\n \"php\": [\".php\"],\n \"go\": [\".go\"],\n \"rust\": [\".rs\"],\n \"kotlin\": [\".kt\"]\n },\n \"comment_patterns\": {\n \"todo\": r\"(?i)(TODO|FIXME|HACK|XXX|BUG)[\\s:]*(.+)\",\n \"commented_code\": r\"^\\s*#.*[=(){}\\[\\];].*\",\n \"magic_numbers\": r\"\\b\\d{2,}\\b\",\n \"long_strings\": r'[\"\\'](.{100,})[\"\\']'\n },\n \"severity_weights\": {\n \"critical\": 10,\n \"high\": 7,\n \"medium\": 5,\n \"low\": 2,\n \"info\": 1\n }\n }\n \n def _compile_patterns(self):\n \"\"\"Compile regex patterns for better performance.\"\"\"\n self.comment_regexes = {}\n for name, pattern in self.config[\"comment_patterns\"].items():\n self.comment_regexes[name] = re.compile(pattern)\n \n # Common code smells patterns\n self.smell_patterns = {\n \"empty_catch\": re.compile(r\"except[^:]*:\\s*pass\\s*$\", re.MULTILINE),\n \"print_debug\": re.compile(r\"print\\s*\\([^)]*debug[^)]*\\)\", re.IGNORECASE),\n \"hardcoded_paths\": re.compile(r'[\"\\'][/\\\\][^\"\\']*[/\\\\][^\"\\']*[\"\\']'),\n \"sql_injection_risk\": re.compile(r'[\"\\'].*%s.*[\"\\'].*execute', re.IGNORECASE),\n }\n \n def scan_directory(self, directory: str) -> Dict[str, Any]:\n \"\"\"\n Scan a directory for tech debt.\n \n Args:\n directory: Path to the directory to scan\n \n Returns:\n Dictionary containing debt inventory and statistics\n \"\"\"\n directory_path = Path(directory)\n if not directory_path.exists():\n raise ValueError(f\"Directory does not exist: {directory}\")\n \n print(f\"Scanning directory: {directory}\")\n print(\"=\" * 50)\n \n # Reset state\n self.debt_items = []\n self.stats = defaultdict(int)\n self.file_stats = {}\n \n # Walk through directory\n for root, dirs, files in os.walk(directory):\n # Filter out ignored directories\n dirs[:] = [d for d in dirs if not self._should_ignore(d)]\n \n for file in files:\n if self._should_ignore(file):\n continue\n \n file_path = os.path.join(root, file)\n relative_path = os.path.relpath(file_path, directory)\n \n try:\n self._scan_file(file_path, relative_path)\n except Exception as e:\n print(f\"Error scanning {relative_path}: {e}\")\n self.stats[\"scan_errors\"] += 1\n \n # Post-process results\n self._detect_duplicates(directory)\n self._calculate_priorities()\n \n return self._generate_report(directory)\n \n def _should_ignore(self, name: str) -> bool:\n \"\"\"Check if file/directory should be ignored.\"\"\"\n for pattern in self.config[\"ignore_patterns\"]:\n if \"*\" in pattern:\n if re.match(pattern.replace(\"*\", \".*\"), name):\n return True\n elif pattern in name:\n return True\n return False\n \n def _scan_file(self, file_path: str, relative_path: str):\n \"\"\"Scan a single file for tech debt.\"\"\"\n try:\n with open(file_path, 'r', encoding='utf-8', errors='ignore') as f:\n content = f.read()\n lines = content.splitlines()\n except Exception as e:\n print(f\"Cannot read {relative_path}: {e}\")\n return\n \n file_ext = Path(file_path).suffix.lower()\n file_info = {\n \"path\": relative_path,\n \"lines\": len(lines),\n \"size_kb\": os.path.getsize(file_path) / 1024,\n \"language\": self._detect_language(file_ext),\n \"debt_count\": 0\n }\n \n self.stats[\"files_scanned\"] += 1\n self.stats[\"total_lines\"] += len(lines)\n \n # File size debt\n if len(lines) > self.config[\"max_file_size_lines\"]:\n self._add_debt_item(\n \"large_file\",\n f\"File is too large: {len(lines)} lines\",\n relative_path,\n \"medium\",\n {\"lines\": len(lines), \"recommended_max\": self.config[\"max_file_size_lines\"]}\n )\n file_info[\"debt_count\"] += 1\n \n # Language-specific analysis\n if file_info[\"language\"] == \"python\" and file_ext == \".py\":\n self._scan_python_file(relative_path, content, lines)\n else:\n self._scan_generic_file(relative_path, content, lines, file_info[\"language\"])\n \n # Common patterns for all languages\n self._scan_common_patterns(relative_path, content, lines)\n \n self.file_stats[relative_path] = file_info\n \n def _detect_language(self, file_ext: str) -> str:\n \"\"\"Detect programming language from file extension.\"\"\"\n for lang, extensions in self.config[\"file_extensions\"].items():\n if file_ext in extensions:\n return lang\n return \"unknown\"\n \n def _scan_python_file(self, file_path: str, content: str, lines: List[str]):\n \"\"\"Scan Python files using AST parsing.\"\"\"\n try:\n tree = ast.parse(content)\n analyzer = PythonASTAnalyzer(self.config)\n debt_items = analyzer.analyze(tree, file_path, lines)\n self.debt_items.extend(debt_items)\n self.stats[\"python_files\"] += 1\n except SyntaxError as e:\n self._add_debt_item(\n \"syntax_error\",\n f\"Python syntax error: {e}\",\n file_path,\n \"high\",\n {\"line\": e.lineno, \"error\": str(e)}\n )\n \n def _scan_generic_file(self, file_path: str, content: str, lines: List[str], language: str):\n \"\"\"Scan non-Python files using pattern matching.\"\"\"\n # Detect long lines\n for i, line in enumerate(lines):\n if len(line) > 120:\n self._add_debt_item(\n \"long_line\",\n f\"Line too long: {len(line)} characters\",\n file_path,\n \"low\",\n {\"line_number\": i + 1, \"length\": len(line)}\n )\n \n # Detect deep nesting (approximate)\n for i, line in enumerate(lines):\n indent_level = len(line) - len(line.lstrip())\n if language in [\"python\"]:\n indent_level = indent_level // 4 # Python uses 4-space indents\n elif language in [\"javascript\", \"java\", \"csharp\", \"cpp\"]:\n # Count braces for brace-based languages\n brace_level = content[:content.find('\\n'.join(lines[:i+1]))].count('{') - content[:content.find('\\n'.join(lines[:i+1]))].count('}')\n if brace_level > self.config[\"max_nesting_depth\"]:\n self._add_debt_item(\n \"deep_nesting\",\n f\"Deep nesting detected: {brace_level} levels\",\n file_path,\n \"medium\",\n {\"line_number\": i + 1, \"nesting_level\": brace_level}\n )\n \n def _scan_common_patterns(self, file_path: str, content: str, lines: List[str]):\n \"\"\"Scan for common patterns across all file types.\"\"\"\n # TODO/FIXME comments\n for i, line in enumerate(lines):\n for pattern_name, regex in self.comment_regexes.items():\n match = regex.search(line)\n if match:\n if pattern_name == \"todo\":\n self._add_debt_item(\n \"todo_comment\",\n f\"TODO/FIXME comment: {match.group(0)}\",\n file_path,\n \"low\",\n {\"line_number\": i + 1, \"comment\": match.group(0).strip()}\n )\n \n # Code smells\n for smell_name, pattern in self.smell_patterns.items():\n matches = pattern.finditer(content)\n for match in matches:\n line_num = content[:match.start()].count('\\n') + 1\n self._add_debt_item(\n smell_name,\n f\"Code smell detected: {smell_name}\",\n file_path,\n \"medium\",\n {\"line_number\": line_num, \"pattern\": match.group(0)[:100]}\n )\n \n def _detect_duplicates(self, directory: str):\n \"\"\"Detect duplicate code blocks across files.\"\"\"\n # Simple duplicate detection based on exact line matches\n line_hashes = defaultdict(list)\n \n for file_path, file_info in self.file_stats.items():\n try:\n full_path = os.path.join(directory, file_path)\n with open(full_path, 'r', encoding='utf-8', errors='ignore') as f:\n lines = f.readlines()\n \n for i in range(len(lines) - self.config[\"min_duplicate_lines\"] + 1):\n block = ''.join(lines[i:i + self.config[\"min_duplicate_lines\"]])\n block_hash = hash(block.strip())\n if len(block.strip()) > 50: # Only consider substantial blocks\n line_hashes[block_hash].append((file_path, i + 1, block))\n except Exception:\n continue\n \n # Report duplicates\n for block_hash, occurrences in line_hashes.items():\n if len(occurrences) > 1:\n for file_path, line_num, block in occurrences:\n self._add_debt_item(\n \"duplicate_code\",\n f\"Duplicate code block found in {len(occurrences)} files\",\n file_path,\n \"medium\",\n {\n \"line_number\": line_num,\n \"duplicate_count\": len(occurrences),\n \"other_files\": [f[0] for f in occurrences if f[0] != file_path]\n }\n )\n \n def _calculate_priorities(self):\n \"\"\"Calculate priority scores for debt items.\"\"\"\n severity_weights = self.config[\"severity_weights\"]\n \n for item in self.debt_items:\n base_score = severity_weights.get(item[\"severity\"], 1)\n \n # Adjust based on debt type\n type_multipliers = {\n \"syntax_error\": 2.0,\n \"security_risk\": 1.8,\n \"large_function\": 1.5,\n \"high_complexity\": 1.4,\n \"duplicate_code\": 1.3,\n \"todo_comment\": 0.5\n }\n \n multiplier = type_multipliers.get(item[\"type\"], 1.0)\n item[\"priority_score\"] = int(base_score * multiplier)\n \n # Set priority category\n if item[\"priority_score\"] >= 15:\n item[\"priority\"] = \"critical\"\n elif item[\"priority_score\"] >= 10:\n item[\"priority\"] = \"high\"\n elif item[\"priority_score\"] >= 5:\n item[\"priority\"] = \"medium\"\n else:\n item[\"priority\"] = \"low\"\n \n def _add_debt_item(self, debt_type: str, description: str, file_path: str, \n severity: str, metadata: Dict[str, Any]):\n \"\"\"Add a debt item to the inventory.\"\"\"\n item = {\n \"id\": f\"DEBT-{len(self.debt_items) + 1:04d}\",\n \"type\": debt_type,\n \"description\": description,\n \"file_path\": file_path,\n \"severity\": severity,\n \"metadata\": metadata,\n \"detected_date\": datetime.now().isoformat(),\n \"status\": \"identified\"\n }\n \n self.debt_items.append(item)\n self.stats[f\"debt_{debt_type}\"] += 1\n self.stats[\"total_debt_items\"] += 1\n \n if file_path in self.file_stats:\n self.file_stats[file_path][\"debt_count\"] += 1\n \n def _generate_report(self, directory: str) -> Dict[str, Any]:\n \"\"\"Generate the final debt report.\"\"\"\n # Sort debt items by priority score\n self.debt_items.sort(key=lambda x: x.get(\"priority_score\", 0), reverse=True)\n \n # Calculate summary statistics\n priority_counts = Counter(item[\"priority\"] for item in self.debt_items)\n type_counts = Counter(item[\"type\"] for item in self.debt_items)\n \n # Calculate health score (0-100, higher is better)\n total_files = self.stats.get(\"files_scanned\", 1)\n debt_density = len(self.debt_items) / total_files\n health_score = max(0, 100 - (debt_density * 10))\n \n report = {\n \"scan_metadata\": {\n \"directory\": directory,\n \"scan_date\": datetime.now().isoformat(),\n \"scanner_version\": \"1.0.0\",\n \"config\": self.config\n },\n \"summary\": {\n \"total_files_scanned\": self.stats.get(\"files_scanned\", 0),\n \"total_lines_scanned\": self.stats.get(\"total_lines\", 0),\n \"total_debt_items\": len(self.debt_items),\n \"health_score\": round(health_score, 1),\n \"debt_density\": round(debt_density, 2),\n \"priority_breakdown\": dict(priority_counts),\n \"type_breakdown\": dict(type_counts)\n },\n \"debt_items\": self.debt_items,\n \"file_statistics\": self.file_stats,\n \"recommendations\": self._generate_recommendations()\n }\n \n return report\n \n def _generate_recommendations(self) -> List[str]:\n \"\"\"Generate actionable recommendations based on findings.\"\"\"\n recommendations = []\n \n # Priority-based recommendations\n high_priority_count = len([item for item in self.debt_items \n if item.get(\"priority\") in [\"critical\", \"high\"]])\n \n if high_priority_count > 10:\n recommendations.append(\n f\"Address {high_priority_count} high-priority debt items immediately - \"\n \"they pose significant risk to code quality and maintainability.\"\n )\n \n # Type-specific recommendations\n type_counts = Counter(item[\"type\"] for item in self.debt_items)\n \n if type_counts.get(\"large_function\", 0) > 5:\n recommendations.append(\n \"Consider refactoring large functions into smaller, more focused units. \"\n \"This will improve readability and testability.\"\n )\n \n if type_counts.get(\"duplicate_code\", 0) > 3:\n recommendations.append(\n \"Extract duplicate code into reusable functions or modules. \"\n \"This reduces maintenance burden and potential for inconsistent changes.\"\n )\n \n if type_counts.get(\"todo_comment\", 0) > 20:\n recommendations.append(\n \"Review and address TODO/FIXME comments. Consider creating proper \"\n \"tickets for substantial work items.\"\n )\n \n # General recommendations\n total_files = self.stats.get(\"files_scanned\", 1)\n if len(self.debt_items) / total_files > 2:\n recommendations.append(\n \"High debt density detected. Consider establishing coding standards \"\n \"and regular code review processes to prevent debt accumulation.\"\n )\n \n if not recommendations:\n recommendations.append(\"Code quality looks good! Continue current practices.\")\n \n return recommendations\n\n\nclass PythonASTAnalyzer(ast.NodeVisitor):\n \"\"\"AST analyzer for Python-specific debt detection.\"\"\"\n \n def __init__(self, config: Dict[str, Any]):\n self.config = config\n self.debt_items = []\n self.current_file = \"\"\n self.lines = []\n self.function_stack = []\n \n def analyze(self, tree: ast.AST, file_path: str, lines: List[str]) -> List[Dict[str, Any]]:\n \"\"\"Analyze Python AST for tech debt.\"\"\"\n self.debt_items = []\n self.current_file = file_path\n self.lines = lines\n self.function_stack = []\n \n self.visit(tree)\n return self.debt_items\n \n def visit_FunctionDef(self, node: ast.FunctionDef):\n \"\"\"Analyze function definitions.\"\"\"\n self.function_stack.append(node.name)\n \n # Calculate function length\n func_length = node.end_lineno - node.lineno + 1\n if func_length > self.config[\"max_function_length\"]:\n self._add_debt(\n \"large_function\",\n f\"Function '{node.name}' is too long: {func_length} lines\",\n node.lineno,\n \"medium\",\n {\"function_name\": node.name, \"length\": func_length}\n )\n \n # Check for missing docstring\n if not ast.get_docstring(node):\n self._add_debt(\n \"missing_docstring\",\n f\"Function '{node.name}' missing docstring\",\n node.lineno,\n \"low\",\n {\"function_name\": node.name}\n )\n \n # Calculate cyclomatic complexity\n complexity = self._calculate_complexity(node)\n if complexity > self.config[\"max_complexity\"]:\n self._add_debt(\n \"high_complexity\",\n f\"Function '{node.name}' has high complexity: {complexity}\",\n node.lineno,\n \"high\",\n {\"function_name\": node.name, \"complexity\": complexity}\n )\n \n # Check parameter count\n param_count = len(node.args.args)\n if param_count > 5:\n self._add_debt(\n \"too_many_parameters\",\n f\"Function '{node.name}' has too many parameters: {param_count}\",\n node.lineno,\n \"medium\",\n {\"function_name\": node.name, \"parameter_count\": param_count}\n )\n \n self.generic_visit(node)\n self.function_stack.pop()\n \n def visit_ClassDef(self, node: ast.ClassDef):\n \"\"\"Analyze class definitions.\"\"\"\n # Check for missing docstring\n if not ast.get_docstring(node):\n self._add_debt(\n \"missing_docstring\",\n f\"Class '{node.name}' missing docstring\",\n node.lineno,\n \"low\",\n {\"class_name\": node.name}\n )\n \n # Check for too many methods\n methods = [n for n in node.body if isinstance(n, ast.FunctionDef)]\n if len(methods) > 20:\n self._add_debt(\n \"large_class\",\n f\"Class '{node.name}' has too many methods: {len(methods)}\",\n node.lineno,\n \"medium\",\n {\"class_name\": node.name, \"method_count\": len(methods)}\n )\n \n self.generic_visit(node)\n \n def _calculate_complexity(self, node: ast.FunctionDef) -> int:\n \"\"\"Calculate cyclomatic complexity of a function.\"\"\"\n complexity = 1 # Base complexity\n \n for child in ast.walk(node):\n if isinstance(child, (ast.If, ast.While, ast.For, ast.AsyncFor)):\n complexity += 1\n elif isinstance(child, ast.ExceptHandler):\n complexity += 1\n elif isinstance(child, ast.BoolOp):\n complexity += len(child.values) - 1\n \n return complexity\n \n def _add_debt(self, debt_type: str, description: str, line_number: int,\n severity: str, metadata: Dict[str, Any]):\n \"\"\"Add a debt item to the collection.\"\"\"\n item = {\n \"id\": f\"DEBT-{len(self.debt_items) + 1:04d}\",\n \"type\": debt_type,\n \"description\": description,\n \"file_path\": self.current_file,\n \"line_number\": line_number,\n \"severity\": severity,\n \"metadata\": metadata,\n \"detected_date\": datetime.now().isoformat(),\n \"status\": \"identified\"\n }\n self.debt_items.append(item)\n\n\ndef format_human_readable_report(report: Dict[str, Any]) -> str:\n \"\"\"Format the report in human-readable format.\"\"\"\n output = []\n \n # Header\n output.append(\"=\" * 60)\n output.append(\"TECHNICAL DEBT SCAN REPORT\")\n output.append(\"=\" * 60)\n output.append(f\"Directory: {report['scan_metadata']['directory']}\")\n output.append(f\"Scan Date: {report['scan_metadata']['scan_date']}\")\n output.append(f\"Scanner Version: {report['scan_metadata']['scanner_version']}\")\n output.append(\"\")\n \n # Summary\n summary = report[\"summary\"]\n output.append(\"SUMMARY\")\n output.append(\"-\" * 30)\n output.append(f\"Files Scanned: {summary['total_files_scanned']}\")\n output.append(f\"Lines Scanned: {summary['total_lines_scanned']:,}\")\n output.append(f\"Total Debt Items: {summary['total_debt_items']}\")\n output.append(f\"Health Score: {summary['health_score']}/100\")\n output.append(f\"Debt Density: {summary['debt_density']} items/file\")\n output.append(\"\")\n \n # Priority breakdown\n output.append(\"PRIORITY BREAKDOWN\")\n output.append(\"-\" * 30)\n for priority, count in summary[\"priority_breakdown\"].items():\n output.append(f\"{priority.capitalize()}: {count}\")\n output.append(\"\")\n \n # Top debt items\n output.append(\"TOP DEBT ITEMS\")\n output.append(\"-\" * 30)\n top_items = report[\"debt_items\"][:10]\n for i, item in enumerate(top_items, 1):\n output.append(f\"{i}. [{item['priority'].upper()}] {item['description']}\")\n output.append(f\" File: {item['file_path']}\")\n if 'line_number' in item:\n output.append(f\" Line: {item['line_number']}\")\n output.append(\"\")\n \n # Recommendations\n output.append(\"RECOMMENDATIONS\")\n output.append(\"-\" * 30)\n for i, rec in enumerate(report[\"recommendations\"], 1):\n output.append(f\"{i}. {rec}\")\n output.append(\"\")\n \n return \"\\n\".join(output)\n\n\ndef main():\n \"\"\"Main entry point for the debt scanner.\"\"\"\n parser = argparse.ArgumentParser(description=\"Scan codebase for technical debt\")\n parser.add_argument(\"directory\", help=\"Directory to scan\")\n parser.add_argument(\"--config\", help=\"Configuration file (JSON)\")\n parser.add_argument(\"--output\", help=\"Output file path\")\n parser.add_argument(\"--format\", choices=[\"json\", \"text\", \"both\"], \n default=\"both\", help=\"Output format\")\n \n args = parser.parse_args()\n \n # Load configuration\n config = None\n if args.config:\n try:\n with open(args.config, 'r') as f:\n config = json.load(f)\n except Exception as e:\n print(f\"Error loading config: {e}\")\n sys.exit(1)\n \n # Run scan\n scanner = DebtScanner(config)\n try:\n report = scanner.scan_directory(args.directory)\n except Exception as e:\n print(f\"Scan failed: {e}\")\n sys.exit(1)\n \n # Output results\n if args.format in [\"json\", \"both\"]:\n json_output = json.dumps(report, indent=2, default=str)\n if args.output:\n output_path = args.output if args.output.endswith('.json') else f\"{args.output}.json\"\n with open(output_path, 'w') as f:\n f.write(json_output)\n print(f\"JSON report written to: {output_path}\")\n else:\n print(\"\\nJSON REPORT:\")\n print(\"=\" * 50)\n print(json_output)\n \n if args.format in [\"text\", \"both\"]:\n text_output = format_human_readable_report(report)\n if args.output:\n output_path = args.output if args.output.endswith('.txt') else f\"{args.output}.txt\"\n with open(output_path, 'w') as f:\n f.write(text_output)\n print(f\"Text report written to: {output_path}\")\n else:\n print(\"\\nTEXT REPORT:\")\n print(\"=\" * 50)\n print(text_output)\n\n\nif __name__ == \"__main__\":\n main()","content_type":"text/x-python; charset=utf-8","language":"python","size":26302,"content_sha256":"a68ff9ad23961d0878c477e1ee4efb025ca547ce8f278ddefd334e8fbc9e1f92"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Tech Debt Tracker","type":"text"}]},{"type":"paragraph","content":[{"text":"Tier","type":"text","marks":[{"type":"strong"}]},{"text":": POWERFUL 🔥","type":"text"},{"type":"br"},{"text":"Category","type":"text","marks":[{"type":"strong"}]},{"text":": Engineering Process Automation","type":"text"},{"type":"br"},{"text":"Expertise","type":"text","marks":[{"type":"strong"}]},{"text":": Code Quality, Technical Debt Management, Software Engineering","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"Tech debt is one of the most insidious challenges in software development - it compounds over time, slowing down development velocity, increasing maintenance costs, and reducing code quality. This skill provides a comprehensive framework for identifying, analyzing, prioritizing, and tracking technical debt across codebases.","type":"text"}]},{"type":"paragraph","content":[{"text":"Tech debt isn't just about messy code - it encompasses architectural shortcuts, missing tests, outdated dependencies, documentation gaps, and infrastructure compromises. Like financial debt, it accrues \"interest\" through increased development time, higher bug rates, and reduced team velocity.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"What This Skill Provides","type":"text"}]},{"type":"paragraph","content":[{"text":"This skill offers three interconnected tools that form a complete tech debt management system:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Debt Scanner","type":"text","marks":[{"type":"strong"}]},{"text":" - Automatically identifies tech debt signals in your codebase","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Debt Prioritizer","type":"text","marks":[{"type":"strong"}]},{"text":" - Analyzes and prioritizes debt items using cost-of-delay frameworks","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Debt Dashboard","type":"text","marks":[{"type":"strong"}]},{"text":" - Tracks debt trends over time and provides executive reporting","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Together, these tools enable engineering teams to make data-driven decisions about tech debt, balancing new feature development with maintenance work.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick Start — scan → prioritize → dashboard","type":"text"}]},{"type":"paragraph","content":[{"text":"All paths relative to this skill folder. The scanner's JSON output feeds the prioritizer directly; dated inventory snapshots feed the dashboard.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Scan the codebase","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"python3 scripts/debt_scanner.py /path/to/codebase --format json --output debt_inventory.json","type":"text"}]},{"type":"paragraph","content":[{"text":"Emits ","type":"text"},{"text":"debt_inventory.json","type":"text","marks":[{"type":"code_inline"}]},{"text":" with ","type":"text"},{"text":"scan_metadata","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"summary","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"debt_items[]","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"file_statistics","type":"text","marks":[{"type":"code_inline"}]},{"text":", and ","type":"text"},{"text":"recommendations","type":"text","marks":[{"type":"code_inline"}]},{"text":". Report the ","type":"text"},{"text":"summary","type":"text","marks":[{"type":"code_inline"}]},{"text":" counts to the user. (Dry run: ","type":"text"},{"text":"assets/sample_codebase","type":"text","marks":[{"type":"code_inline"}]},{"text":".)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. Prioritize the backlog","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"python3 scripts/debt_prioritizer.py debt_inventory.json --framework wsjf --team-size 6 --sprint-capacity 20 --format json --output debt_priorities.json","type":"text"}]},{"type":"paragraph","content":[{"text":"Frameworks: ","type":"text"},{"text":"cost_of_delay","type":"text","marks":[{"type":"code_inline"}]},{"text":" (default), ","type":"text"},{"text":"wsjf","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"rice","type":"text","marks":[{"type":"code_inline"}]},{"text":". Output contains ","type":"text"},{"text":"prioritized_backlog","type":"text","marks":[{"type":"code_inline"}]},{"text":" (work top-down), ","type":"text"},{"text":"sprint_allocation","type":"text","marks":[{"type":"code_inline"}]},{"text":" (paste into sprint planning), and ","type":"text"},{"text":"insights","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. Track trends over time","type":"text"}]},{"type":"paragraph","content":[{"text":"Keep dated snapshots (","type":"text"},{"text":"debt_YYYY-MM-DD.json","type":"text","marks":[{"type":"code_inline"}]},{"text":"), then:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"python3 scripts/debt_dashboard.py --input-dir snapshots/ --period monthly --format both --output debt_dashboard","type":"text"}]},{"type":"paragraph","content":[{"text":"Or pass files explicitly (samples: ","type":"text"},{"text":"assets/historical_debt_2024-01-15.json assets/historical_debt_2024-02-01.json","type":"text","marks":[{"type":"code_inline"}]},{"text":"). The dashboard reports trend direction and executive-ready summaries — use it to verify a cleanup sprint actually reduced debt.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Verification loop","type":"text"}]},{"type":"paragraph","content":[{"text":"After a remediation sprint: re-run step 1, re-run step 3 with the new snapshot, and assert the targeted categories' counts dropped. A cleanup that doesn't move the dashboard is rework, not debt paydown.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Technical Debt Classification Framework","type":"text"}]},{"type":"paragraph","content":[{"text":"→ See references/debt-frameworks.md for details (also: references/debt-classification-taxonomy.md, references/prioritization-framework.md, references/stakeholder-communication-templates.md)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Common Pitfalls and How to Avoid Them","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Analysis Paralysis","type":"text"}]},{"type":"paragraph","content":[{"text":"Problem","type":"text","marks":[{"type":"strong"}]},{"text":": Spending too much time analyzing debt instead of fixing it. ","type":"text"},{"text":"Solution","type":"text","marks":[{"type":"strong"}]},{"text":": Set time limits for analysis, use \"good enough\" scoring for most items.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. Perfectionism","type":"text"}]},{"type":"paragraph","content":[{"text":"Problem","type":"text","marks":[{"type":"strong"}]},{"text":": Trying to eliminate all debt instead of managing it. ","type":"text"},{"text":"Solution","type":"text","marks":[{"type":"strong"}]},{"text":": Focus on high-impact debt, accept that some debt is acceptable.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. Ignoring Business Context","type":"text"}]},{"type":"paragraph","content":[{"text":"Problem","type":"text","marks":[{"type":"strong"}]},{"text":": Prioritizing technical elegance over business value. ","type":"text"},{"text":"Solution","type":"text","marks":[{"type":"strong"}]},{"text":": Always tie debt work to business outcomes and customer impact.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4. Inconsistent Application","type":"text"}]},{"type":"paragraph","content":[{"text":"Problem","type":"text","marks":[{"type":"strong"}]},{"text":": Some teams adopt practices while others ignore them. ","type":"text"},{"text":"Solution","type":"text","marks":[{"type":"strong"}]},{"text":": Make debt tracking part of standard development workflow.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5. Tool Over-Engineering","type":"text"}]},{"type":"paragraph","content":[{"text":"Problem","type":"text","marks":[{"type":"strong"}]},{"text":": Building complex debt management systems that nobody uses. ","type":"text"},{"text":"Solution","type":"text","marks":[{"type":"strong"}]},{"text":": Start simple, iterate based on actual usage patterns.","type":"text"}]},{"type":"paragraph","content":[{"text":"Technical debt management is not just about writing better code - it's about creating sustainable development practices that balance short-term delivery pressure with long-term system health. Use these tools and frameworks to make informed decisions about when and how to invest in debt reduction.","type":"text"}]}]},"metadata":{"date":"2026-11-02","name":"tech-debt-tracker","author":"@skillopedia","source":{"stars":29164,"repo_name":"claude-skills","origin_url":"https://github.com/alirezarezvani/claude-skills/blob/HEAD/engineering/skills/tech-debt-tracker/SKILL.md","repo_owner":"alirezarezvani","body_sha256":"333bda5eff1cd290d596c21677220d66f8c9024219a1caa7379c44a35fe36b95","cluster_key":"61dc260d9adfd91f2703ef5e53819561f19a8dae472773f9e76f117938bce26e","clean_bundle":{"format":"clean-skill-bundle-v1","source":"alirezarezvani/claude-skills/engineering/skills/tech-debt-tracker/SKILL.md","text_bytes":329798,"source_commit":"9ef0c3c213932e645cc5cbeeb3c35c3a762a2437","skills_sh_rank":17239,"attachment_count":17,"text_attachments":17,"attachment_storage":"skill_attachments","binary_attachments":0},"cluster_size":1,"skill_md_path":"engineering/skills/tech-debt-tracker/SKILL.md","import_metadata":{"date":"2026-11-02","author":"@skillopedia","version":"v1","category":"software-engineering","category_label":"Engineering"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"software-engineering","import_tag":"skills-sh-top20k-2026-11","description":"Use when asked about tech debt, refactoring priority, a cleanup sprint or legacy modernization. Scans the code with debt_scanner.py, ranks items with debt_prioritizer.py and tracks trends with debt_dashboard.py."}},"renderedAt":1793666039547}

Tech Debt Tracker Tier : POWERFUL 🔥 Category : Engineering Process Automation Expertise : Code Quality, Technical Debt Management, Software Engineering Overview Tech debt is one of the most insidious challenges in software development - it compounds over time, slowing down development velocity, increasing maintenance costs, and reducing code quality. This skill provides a comprehensive framework for identifying, analyzing, prioritizing, and tracking technical debt across codebases. Tech debt isn't just about messy code - it encompasses architectural shortcuts, missing tests, outdated depende…