npm - dev-booster - Versions diffs - 1.0.0 - Mend

dev-booster 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (294) hide show

package/template/.devbooster/hub/scripts/accessibility_checker.py ADDED Viewed

@@ -0,0 +1,183 @@
+#!/usr/bin/env python3
+"""
+Accessibility Checker - WCAG compliance audit
+Checks HTML files for accessibility issues.
+Usage:
+    python accessibility_checker.py <project_path>
+Checks:
+    - Form labels
+    - ARIA attributes
+    - Color contrast hints
+    - Keyboard navigation
+    - Semantic HTML
+"""
+import sys
+import json
+import re
+from pathlib import Path
+from datetime import datetime
+# Fix Windows console encoding
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+except:
+    pass
+def find_html_files(project_path: Path) -> list:
+    """Find all HTML/JSX/TSX files."""
+    patterns = ['**/*.html', '**/*.jsx', '**/*.tsx']
+    skip_dirs = {'node_modules', '.next', 'dist', 'build', '.git'}
+    files = []
+    for pattern in patterns:
+        for f in project_path.glob(pattern):
+            if not any(skip in f.parts for skip in skip_dirs):
+                files.append(f)
+    return files[:50]
+def check_accessibility(file_path: Path) -> list:
+    """Check a single file for accessibility issues."""
+    issues = []
+    try:
+        content = file_path.read_text(encoding='utf-8', errors='ignore')
+        # Check for form inputs without labels
+        inputs = re.findall(r'<input[^>]*>', content, re.IGNORECASE)
+        for inp in inputs:
+            if 'type="hidden"' not in inp.lower():
+                if 'aria-label' not in inp.lower() and 'id=' not in inp.lower():
+                    issues.append("Input without label or aria-label")
+                    break
+        # Check for buttons without accessible text
+        buttons = re.findall(r'<button[^>]*>[^<]*</button>', content, re.IGNORECASE)
+        for btn in buttons:
+            # Check if button has text content or aria-label
+            if 'aria-label' not in btn.lower():
+                text = re.sub(r'<[^>]+>', '', btn)
+                if not text.strip():
+                    issues.append("Button without accessible text")
+                    break
+        # Check for missing lang attribute
+        if '<html' in content.lower() and 'lang=' not in content.lower():
+            issues.append("Missing lang attribute on <html>")
+        # Check for missing skip link
+        if '<main' in content.lower() or '<body' in content.lower():
+            if 'skip' not in content.lower() and '#main' not in content.lower():
+                issues.append("Consider adding skip-to-main-content link")
+        # Check for click handlers without keyboard support
+        onclick_count = content.lower().count('onclick=')
+        onkeydown_count = content.lower().count('onkeydown=') + content.lower().count('onkeyup=')
+        if onclick_count > 0 and onkeydown_count == 0:
+            issues.append("onClick without keyboard handler (onKeyDown)")
+        # Check for tabIndex misuse
+        if 'tabindex=' in content.lower():
+            if 'tabindex="-1"' not in content.lower() and 'tabindex="0"' not in content.lower():
+                positive_tabindex = re.findall(r'tabindex="([1-9]\d*)"', content, re.IGNORECASE)
+                if positive_tabindex:
+                    issues.append("Avoid positive tabIndex values")
+        # Check for autoplay media
+        if 'autoplay' in content.lower():
+            if 'muted' not in content.lower():
+                issues.append("Autoplay media should be muted")
+        # Check for role usage
+        if 'role="button"' in content.lower():
+            # Divs with role button should have tabindex
+            div_buttons = re.findall(r'<div[^>]*role="button"[^>]*>', content, re.IGNORECASE)
+            for div in div_buttons:
+                if 'tabindex' not in div.lower():
+                    issues.append("role='button' without tabindex")
+                    break
+    except Exception as e:
+        issues.append(f"Error reading file: {str(e)[:50]}")
+    return issues
+def main():
+    project_path = Path(sys.argv[1] if len(sys.argv) > 1 else ".").resolve()
+    print(f"\n{'='*60}")
+    print(f"[ACCESSIBILITY CHECKER] WCAG Compliance Audit")
+    print(f"{'='*60}")
+    print(f"Project: {project_path}")
+    print(f"Time: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+    print("-"*60)
+    # Find HTML files
+    files = find_html_files(project_path)
+    print(f"Found {len(files)} HTML/JSX/TSX files")
+    if not files:
+        output = {
+            "script": "accessibility_checker",
+            "project": str(project_path),
+            "files_checked": 0,
+            "issues_found": 0,
+            "passed": True,
+            "message": "No HTML files found"
+        }
+        print(json.dumps(output, indent=2))
+        sys.exit(0)
+    # Check each file
+    all_issues = []
+    for f in files:
+        issues = check_accessibility(f)
+        if issues:
+            all_issues.append({
+                "file": str(f.name),
+                "issues": issues
+            })
+    # Summary
+    print("\n" + "="*60)
+    print("ACCESSIBILITY ISSUES")
+    print("="*60)
+    if all_issues:
+        for item in all_issues[:10]:
+            print(f"\n{item['file']}:")
+            for issue in item["issues"]:
+                print(f"  - {issue}")
+        if len(all_issues) > 10:
+            print(f"\n... and {len(all_issues) - 10} more files with issues")
+    else:
+        print("No accessibility issues found!")
+    total_issues = sum(len(item["issues"]) for item in all_issues)
+    # Accessibility issues are important but not blocking
+    passed = total_issues < 5  # Allow minor issues
+    output = {
+        "script": "accessibility_checker",
+        "project": str(project_path),
+        "files_checked": len(files),
+        "files_with_issues": len(all_issues),
+        "issues_found": total_issues,
+        "passed": passed
+    }
+    print("\n" + json.dumps(output, indent=2))
+    sys.exit(0 if passed else 1)
+if __name__ == "__main__":
+    main()

package/template/.devbooster/hub/scripts/api_validator.py ADDED Viewed

@@ -0,0 +1,211 @@
+#!/usr/bin/env python3
+"""
+API Validator - Checks API endpoints for best practices.
+Validates OpenAPI specs, response formats, and common issues.
+"""
+import sys
+import json
+import re
+from pathlib import Path
+# Fix Windows console encoding for Unicode output
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except AttributeError:
+    pass  # Python < 3.7
+def find_api_files(project_path: Path) -> list:
+    """Find API-related files."""
+    patterns = [
+        "**/*api*.ts", "**/*api*.js", "**/*api*.py",
+        "**/routes/*.ts", "**/routes/*.js", "**/routes/*.py",
+        "**/controllers/*.ts", "**/controllers/*.js",
+        "**/endpoints/*.ts", "**/endpoints/*.py",
+        "**/*.openapi.json", "**/*.openapi.yaml",
+        "**/swagger.json", "**/swagger.yaml",
+        "**/openapi.json", "**/openapi.yaml"
+    ]
+    files = []
+    for pattern in patterns:
+        files.extend(project_path.glob(pattern))
+    # Exclude node_modules, etc.
+    return [f for f in files if not any(x in str(f) for x in ['node_modules', '.git', 'dist', 'build', '__pycache__'])]
+def check_openapi_spec(file_path: Path) -> dict:
+    """Check OpenAPI/Swagger specification."""
+    issues = []
+    passed = []
+    try:
+        content = file_path.read_text(encoding='utf-8')
+        if file_path.suffix == '.json':
+            spec = json.loads(content)
+        else:
+            # Basic YAML check
+            if 'openapi:' in content or 'swagger:' in content:
+                passed.append("[OK] OpenAPI/Swagger version defined")
+            else:
+                issues.append("[X] No OpenAPI version found")
+            if 'paths:' in content:
+                passed.append("[OK] Paths section exists")
+            else:
+                issues.append("[X] No paths defined")
+            if 'components:' in content or 'definitions:' in content:
+                passed.append("[OK] Schema components defined")
+            return {'file': str(file_path), 'passed': passed, 'issues': issues, 'type': 'openapi'}
+        # JSON OpenAPI checks
+        if 'openapi' in spec or 'swagger' in spec:
+            passed.append("[OK] OpenAPI version defined")
+        if 'info' in spec:
+            if 'title' in spec['info']:
+                passed.append("[OK] API title defined")
+            if 'version' in spec['info']:
+                passed.append("[OK] API version defined")
+            if 'description' not in spec['info']:
+                issues.append("[!] API description missing")
+        if 'paths' in spec:
+            path_count = len(spec['paths'])
+            passed.append(f"[OK] {path_count} endpoints defined")
+            # Check each path
+            for path, methods in spec['paths'].items():
+                for method, details in methods.items():
+                    if method in ['get', 'post', 'put', 'patch', 'delete']:
+                        if 'responses' not in details:
+                            issues.append(f"[X] {method.upper()} {path}: No responses defined")
+                        if 'summary' not in details and 'description' not in details:
+                            issues.append(f"[!] {method.upper()} {path}: No description")
+    except Exception as e:
+        issues.append(f"[X] Parse error: {e}")
+    return {'file': str(file_path), 'passed': passed, 'issues': issues, 'type': 'openapi'}
+def check_api_code(file_path: Path) -> dict:
+    """Check API code for common issues."""
+    issues = []
+    passed = []
+    try:
+        content = file_path.read_text(encoding='utf-8')
+        # Check for error handling
+        error_patterns = [
+            r'try\s*{', r'try:', r'\.catch\(',
+            r'except\s+', r'catch\s*\('
+        ]
+        has_error_handling = any(re.search(p, content) for p in error_patterns)
+        if has_error_handling:
+            passed.append("[OK] Error handling present")
+        else:
+            issues.append("[X] No error handling found")
+        # Check for status codes
+        status_patterns = [
+            r'status\s*\(\s*\d{3}\s*\)', r'statusCode\s*[=:]\s*\d{3}',
+            r'HttpStatus\.', r'status_code\s*=\s*\d{3}',
+            r'\.status\(\d{3}\)', r'res\.status\('
+        ]
+        has_status = any(re.search(p, content) for p in status_patterns)
+        if has_status:
+            passed.append("[OK] HTTP status codes used")
+        else:
+            issues.append("[!] No explicit HTTP status codes")
+        # Check for validation
+        validation_patterns = [
+            r'validate', r'schema', r'zod', r'joi', r'yup',
+            r'pydantic', r'@Body\(', r'@Query\('
+        ]
+        has_validation = any(re.search(p, content, re.I) for p in validation_patterns)
+        if has_validation:
+            passed.append("[OK] Input validation present")
+        else:
+            issues.append("[!] No input validation detected")
+        # Check for auth middleware
+        auth_patterns = [
+            r'auth', r'jwt', r'bearer', r'token',
+            r'middleware', r'guard', r'@Authenticated'
+        ]
+        has_auth = any(re.search(p, content, re.I) for p in auth_patterns)
+        if has_auth:
+            passed.append("[OK] Authentication/authorization detected")
+        # Check for rate limiting
+        rate_patterns = [r'rateLimit', r'throttle', r'rate.?limit']
+        has_rate = any(re.search(p, content, re.I) for p in rate_patterns)
+        if has_rate:
+            passed.append("[OK] Rate limiting present")
+        # Check for logging
+        log_patterns = [r'console\.log', r'logger\.', r'logging\.', r'log\.']
+        has_logging = any(re.search(p, content) for p in log_patterns)
+        if has_logging:
+            passed.append("[OK] Logging present")
+    except Exception as e:
+        issues.append(f"[X] Read error: {e}")
+    return {'file': str(file_path), 'passed': passed, 'issues': issues, 'type': 'code'}
+def main():
+    target = sys.argv[1] if len(sys.argv) > 1 else "."
+    project_path = Path(target)
+    print("\n" + "=" * 60)
+    print("  API VALIDATOR - Endpoint Best Practices Check")
+    print("=" * 60 + "\n")
+    api_files = find_api_files(project_path)
+    if not api_files:
+        print("[!] No API files found.")
+        print("   Looking for: routes/, controllers/, api/, openapi.json/yaml")
+        sys.exit(0)
+    results = []
+    for file_path in api_files[:15]:  # Limit
+        if 'openapi' in file_path.name.lower() or 'swagger' in file_path.name.lower():
+            result = check_openapi_spec(file_path)
+        else:
+            result = check_api_code(file_path)
+        results.append(result)
+    # Print results
+    total_issues = 0
+    total_passed = 0
+    for result in results:
+        print(f"\n[FILE] {result['file']} [{result['type']}]")
+        for item in result['passed']:
+            print(f"   {item}")
+            total_passed += 1
+        for item in result['issues']:
+            print(f"   {item}")
+            if item.startswith("[X]"):
+                total_issues += 1
+    print("\n" + "=" * 60)
+    print(f"[RESULTS] {total_passed} passed, {total_issues} critical issues")
+    print("=" * 60)
+    if total_issues == 0:
+        print("[OK] API validation passed")
+        sys.exit(0)
+    else:
+        print("[X] Fix critical issues before deployment")
+        sys.exit(1)
+if __name__ == "__main__":
+    main()

package/template/.devbooster/hub/scripts/auto_preview.py ADDED Viewed

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+"""
+Auto Preview - Kit 2.0
+==============================
+Manages (start/stop/status) the local development server for previewing the application.
+Usage:
+    python .devbooster/hub/scripts/auto_preview.py start [port]
+    python .devbooster/hub/scripts/auto_preview.py stop
+    python .devbooster/hub/scripts/auto_preview.py status
+"""
+import os
+import sys
+import time
+import json
+import signal
+import argparse
+import subprocess
+from pathlib import Path
+AGENT_DIR = Path(".devbooster")
+PID_FILE = AGENT_DIR / "preview.pid"
+LOG_FILE = AGENT_DIR / "preview.log"
+def get_project_root():
+    return Path(".").resolve()
+def is_running(pid):
+    try:
+        os.kill(pid, 0)
+        return True
+    except OSError:
+        return False
+def get_start_command(root):
+    pkg_file = root / "package.json"
+    if not pkg_file.exists():
+        return None
+    with open(pkg_file, 'r') as f:
+        data = json.load(f)
+    scripts = data.get("scripts", {})
+    if "dev" in scripts:
+        return ["npm", "run", "dev"]
+    elif "start" in scripts:
+        return ["npm", "start"]
+    return None
+def start_server(port=3000):
+    if PID_FILE.exists():
+        try:
+            pid = int(PID_FILE.read_text().strip())
+            if is_running(pid):
+                print(f"⚠️  Preview already running (PID: {pid})")
+                return
+        except:
+            pass # Invalid PID file
+    root = get_project_root()
+    cmd = get_start_command(root)
+    if not cmd:
+        print("❌ No 'dev' or 'start' script found in package.json")
+        sys.exit(1)
+    # Add port env var if needed (simple heuristic)
+    env = os.environ.copy()
+    env["PORT"] = str(port)
+    print(f"🚀 Starting preview on port {port}...")
+    with open(LOG_FILE, "w") as log:
+        process = subprocess.Popen(
+            cmd,
+            cwd=str(root),
+            stdout=log,
+            stderr=log,
+            env=env,
+            shell=True # Required for npm on windows often, or consistent path handling
+        )
+    PID_FILE.write_text(str(process.pid))
+    print(f"✅ Preview started! (PID: {process.pid})")
+    print(f"   Logs: {LOG_FILE}")
+    print(f"   URL: http://localhost:{port}")
+def stop_server():
+    if not PID_FILE.exists():
+        print("ℹ️  No preview server found.")
+        return
+    try:
+        pid = int(PID_FILE.read_text().strip())
+        if is_running(pid):
+            # Try gentle kill first
+            os.kill(pid, signal.SIGTERM) if sys.platform != 'win32' else subprocess.call(['taskkill', '/F', '/T', '/PID', str(pid)])
+            print(f"🛑 Preview stopped (PID: {pid})")
+        else:
+            print("ℹ️  Process was not running.")
+    except Exception as e:
+        print(f"❌ Error stopping server: {e}")
+    finally:
+        if PID_FILE.exists():
+            PID_FILE.unlink()
+def status_server():
+    running = False
+    pid = None
+    url = "Unknown"
+    if PID_FILE.exists():
+        try:
+            pid = int(PID_FILE.read_text().strip())
+            if is_running(pid):
+                running = True
+                # Heuristic for URL, strictly we should save it
+                url = "http://localhost:3000"
+        except:
+            pass
+    print("\n=== Preview Status ===")
+    if running:
+        print(f"✅ Status: Running")
+        print(f"🔢 PID: {pid}")
+        print(f"🌐 URL: {url} (Likely)")
+        print(f"📝 Logs: {LOG_FILE}")
+    else:
+        print("⚪ Status: Stopped")
+    print("===================\n")
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("action", choices=["start", "stop", "status"])
+    parser.add_argument("port", nargs="?", default="3000")
+    args = parser.parse_args()
+    if args.action == "start":
+        start_server(int(args.port))
+    elif args.action == "stop":
+        stop_server()
+    elif args.action == "status":
+        status_server()
+if __name__ == "__main__":
+    main()