synapse-hub 0.0.0-stage → 2.0.0

package/tools/generate_tc_from_story.py

@@ -0,0 +1,182 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+tools/generate_tc_from_story.py — Large Action Model (LAM) Script Generator
+Inspired by LaVague: Converts natural language user stories into Clean POM test scripts.
+Supports configurable packages, dynamic Page Class discovery, and cross-platform execution.
+"""
+
+import sys
+import os
+import re
+import glob
+import argparse
+
+# Enforce UTF-8 stdout encoding for Windows console compatibility
+if hasattr(sys.stdout, 'reconfigure'):
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+        sys.stderr.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+DEFAULT_PAGE_MAP = {
+    "login": "LoginPage",
+    "auth": "LoginPage",
+    "user": "UserAdminPage",
+    "common": "CommonCategoryPage",
+    "category": "CategoryPage",
+    "planning": "PlanningPage",
+    "report": "ReportPage",
+    "search": "SearchPage",
+}
+
+
+def detect_project_package(repo_root="."):
+    """Detects the standard package prefix from existing project structure or guide."""
+    # 1. Check PROJECT_AI_GUIDE.md for explicit package hints
+    guide_path = os.path.join(repo_root, "PROJECT_AI_GUIDE.md")
+    if os.path.isfile(guide_path):
+        try:
+            with open(guide_path, "r", encoding="utf-8", errors="ignore") as f:
+                content = f.read()
+                m = re.search(r'import\s+([\w\.]+)\.pages\.', content)
+                if m:
+                    return f"{m.group(1)}.pages"
+        except Exception:
+            pass
+
+    # 2. Check existing Keywords/ directory
+    keywords_dir = os.path.join(repo_root, "Keywords")
+    if os.path.isdir(keywords_dir):
+        for root, _, files in os.walk(keywords_dir):
+            for file in files:
+                if file.endswith(".groovy"):
+                    rel = os.path.relpath(root, keywords_dir)
+                    parts = [p for p in rel.replace("\\", "/").split("/") if p and p != "."]
+                    if parts:
+                        return ".".join(parts)
+
+    return "pages"
+
+
+def discover_page_classes(repo_root="."):
+    """Discovers available Page classes dynamically from workspace files."""
+    pages = dict(DEFAULT_PAGE_MAP)
+    search_dirs = [
+        os.path.join(repo_root, "Keywords"),
+        os.path.join(repo_root, "pages"),
+        os.path.join(repo_root, "src", "pages"),
+        os.path.join(repo_root, "tests", "pages")
+    ]
+    for d in search_dirs:
+        if os.path.isdir(d):
+            for f in glob.glob(os.path.join(d, "**", "*Page*.*"), recursive=True):
+                base = os.path.basename(f)
+                name, _ = os.path.splitext(base)
+                clean_key = name.lower().replace("page", "").replace("_", "")
+                if clean_key:
+                    pages[clean_key] = name
+    return pages
+
+
+def generate_script(story, module_name="CategoryPage", tc_name="TC_AutoGenerated", package_name=None, repo_root="."):
+    detected_package = package_name or detect_project_package(repo_root)
+    discovered_pages = discover_page_classes(repo_root)
+
+    # Normalize module name
+    mod_clean = module_name.lower().replace("page", "").replace("_", "")
+    target_page = discovered_pages.get(mod_clean, f"{module_name[:1].upper()}{module_name[1:]}")
+    if not target_page.endswith("Page"):
+        target_page += "Page"
+
+    # Detect action intent from story keywords
+    story_lower = story.lower()
+    is_delete = any(k in story_lower for k in ["xóa", "xoa", "delete", "remove"])
+    is_edit = any(k in story_lower for k in ["sửa", "sua", "chỉnh sửa", "chinh sua", "edit", "update"])
+    is_search = any(k in story_lower for k in ["tìm", "tim", "tìm kiếm", "tim kiem", "search", "filter"])
+    is_add = not (is_delete or is_edit or is_search) or any(k in story_lower for k in ["thêm", "them", "tạo mới", "tao moi", "add", "create"])
+
+    lines = []
+    lines.append("// ===========================================================================")
+    lines.append(f"// Test Case: {tc_name}")
+    lines.append(f"// Requirement: {story}")
+    lines.append("// Architecture: Clean POM & Flat Architecture (Generated by LaVague LAM Engine)")
+    lines.append("// ===========================================================================")
+    lines.append("")
+    lines.append(f"import {detected_package}.LoginPage")
+    lines.append(f"import {detected_package}.{target_page}")
+    lines.append("")
+    lines.append("// 1. Ensure system authentication session")
+    lines.append("LoginPage.ensureLoggedIn()")
+    lines.append("")
+    lines.append("// 2. Initialize dynamic idempotent test data")
+    lines.append('String uniqueCode = "AUTO_" + System.currentTimeMillis()')
+    lines.append('String testName = "Test Entity " + uniqueCode')
+    lines.append("")
+
+    if is_add:
+        lines.append("// 3. Execute entity creation workflow")
+        lines.append(f"{target_page}.openCreateModal()")
+        lines.append(f"{target_page}.fillCreateForm(uniqueCode, testName)")
+        lines.append(f"{target_page}.confirmCreate()")
+        lines.append(f"{target_page}.verifyCreateSuccess(uniqueCode)")
+
+    elif is_edit:
+        lines.append("// 3. Execute entity update workflow")
+        lines.append('String updatedName = testName + " [Updated]"')
+        lines.append(f"{target_page}.searchKeyword(uniqueCode)")
+        lines.append(f"{target_page}.openEditFirstRow()")
+        lines.append(f"{target_page}.updateName(updatedName)")
+        lines.append(f"{target_page}.confirmEdit()")
+        lines.append(f"{target_page}.verifyEditSuccess(updatedName)")
+
+    elif is_delete:
+        lines.append("// 3. Execute entity deletion workflow")
+        lines.append(f"{target_page}.searchKeyword(uniqueCode)")
+        lines.append(f"{target_page}.clickDeleteFirstRow()")
+        lines.append(f"{target_page}.confirmDelete()")
+        lines.append(f"{target_page}.verifyDeleted(uniqueCode)")
+
+    elif is_search:
+        lines.append("// 3. Execute entity search/filter workflow")
+        lines.append(f"{target_page}.searchKeyword(uniqueCode)")
+        lines.append(f"{target_page}.verifySearchResults(uniqueCode)")
+
+    lines.append("")
+    lines.append("// 4. Automated idempotent teardown cleanup")
+    lines.append(f"// {target_page}.teardown(uniqueCode)")
+    lines.append("")
+
+    return "\n".join(lines)
+
+
+def main():
+    parser = argparse.ArgumentParser(description="LaVague-style LAM Script Generator for Clean POM Automation")
+    parser.add_argument("--story", "-s", required=True, help="User story or Acceptance Criteria (natural language)")
+    parser.add_argument("--module", "-m", default="CategoryPage", help="Target Page Class or Module name")
+    parser.add_argument("--name", "-n", default="TC_AutoGenerated", help="Test Case name")
+    parser.add_argument("--package", "-p", default=None, help="Base package name for imports (e.g. 'com.company.pages')")
+    parser.add_argument("--out", "-o", default=None, help="Output file path (optional)")
+    args = parser.parse_args()
+
+    script_content = generate_script(
+        story=args.story,
+        module_name=args.module,
+        tc_name=args.name,
+        package_name=args.package
+    )
+
+    if args.out:
+        out_dir = os.path.dirname(args.out)
+        if out_dir:
+            os.makedirs(out_dir, exist_ok=True)
+        with open(args.out, "w", encoding="utf-8") as f:
+            f.write(script_content)
+        print(f"Generated Clean POM script successfully saved to: {args.out}")
+    else:
+        print(script_content)
+
+
+if __name__ == "__main__":
+    main()

package/tools/generate_test_reports.ps1

@@ -0,0 +1,135 @@
+# PowerShell Script to ensure TestReports and summaryTemp.txt for CI/CD Dashboard
+param(
+    [string]$ProjectName = "Enterprise-Automation"
+)
+
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+Write-Host "=== [Centralize CI/CD] Generating TestReports & summaryTemp.txt for $ProjectName ===" -ForegroundColor Cyan
+
+$testReportsDir = Join-Path $PSScriptRoot "..\TestReports"
+$reportsDir = Join-Path $PSScriptRoot "..\Reports"
+
+if (-not (Test-Path $testReportsDir)) {
+    New-Item -ItemType Directory -Path $testReportsDir -Force | Out-Null
+}
+
+$passed = 0
+$failures = 0
+$errors = 0
+$incomplete = 0
+$skipped = 0
+$foundExistingSummary = $false
+
+# 0. Check if Cleanup_Browser already exported summaryTemp.txt with business test case counts
+$existingSummaryFile = Join-Path $reportsDir "summaryTemp.txt"
+if (-not (Test-Path $existingSummaryFile)) {
+    $existingSummaryFile = Join-Path $testReportsDir "summaryTemp.txt"
+}
+if (Test-Path $existingSummaryFile) {
+    try {
+        $rawSummary = [System.IO.File]::ReadAllText($existingSummaryFile, [System.Text.Encoding]::UTF8)
+        if ($rawSummary -match "(\d+)\s+Passed\s+-\s+.*?(\d+)\s+Failures\s+-\s+.*?(\d+)\s+Errors") {
+            $passed = [int]$matches[1]
+            $failures = [int]$matches[2]
+            $errors = [int]$matches[3]
+            if ($passed -gt 0) {
+                $foundExistingSummary = $true
+                Write-Host "[+] Found valid summaryTemp.txt from Cleanup_Browser: $rawSummary" -ForegroundColor Green
+            }
+        }
+    } catch {}
+}
+
+# 1. Find the latest report directory (check Reports, then TestReports)
+$latestReport = Get-ChildItem -Path @($reportsDir, $testReportsDir) -Recurse -Filter "*junit*.xml" -ErrorAction SilentlyContinue |
+    Sort-Object LastWriteTime -Descending | Select-Object -First 1
+
+if (-not $foundExistingSummary -and $latestReport) {
+    Write-Host "[+] Found latest JUnit report: $($latestReport.FullName)" -ForegroundColor Green
+    try {
+        [xml]$xml = Get-Content $latestReport.FullName
+        if ($xml.testsuites) {
+            $passed = [int]($xml.testsuites.passed)
+            $failures = [int]($xml.testsuites.failures)
+            $errors = [int]($xml.testsuites.errors)
+            $incomplete = [int]($xml.testsuites.incompleted)
+            $skipped = [int]($xml.testsuites.skipped)
+        } elseif ($xml.testsuite) {
+            $tests = [int]($xml.testsuite.tests)
+            $failures = [int]($xml.testsuite.failures)
+            $errors = [int]($xml.testsuite.errors)
+            $skipped = [int]($xml.testsuite.skipped)
+            $passed = [Math]::Max(0, $tests - $failures - $errors - $skipped)
+        }
+        $foundExistingSummary = $true
+    } catch {
+        Write-Warning "[!] Failed to parse XML: $_"
+    }
+}
+
+if (-not $foundExistingSummary) {
+    # Fallback to console0.log
+    $latestLog = Get-ChildItem -Path @($reportsDir, $testReportsDir) -Recurse -Filter "console0.log" -ErrorAction SilentlyContinue |
+        Sort-Object LastWriteTime -Descending | Select-Object -First 1
+
+    if ($latestLog) {
+        Write-Host "[+] Fallback: Parsing console log: $($latestLog.FullName)" -ForegroundColor Yellow
+        $logContent = Get-Content $latestLog.FullName -Raw
+        if ($logContent -match "Passed:\s*(\d+)\s*\|\s*Failed:\s*(\d+)\s*\|\s*Errors:\s*(\d+)") {
+            $passed = [int]$matches[1]
+            $failures = [int]$matches[2]
+            $errors = [int]$matches[3]
+        } elseif ($logContent -match "Tổng số:\s*(\d+)\s*\|\s*Đạt:\s*(\d+)\s*\|\s*Thất bại:\s*(\d+)\s*\|\s*Lỗi:\s*(\d+)") {
+            $passed = [int]$matches[2]
+            $failures = [int]$matches[3]
+            $errors = [int]$matches[4]
+        } else {
+            $passed = ([regex]::Matches($logContent, "\[TEST_CASE\]\[PASSED\]")).Count
+            $failures = ([regex]::Matches($logContent, "\[TEST_CASE\]\[FAILED\]")).Count
+            $errors = ([regex]::Matches($logContent, "\[TEST_CASE\]\[ERROR\]")).Count
+        }
+    }
+}
+
+Write-Host "[+] Metrics: Passed=$passed, Failures=$failures, Errors=$errors, Incomplete=$incomplete, Skipped=$skipped" -ForegroundColor Cyan
+
+# 2. Write summaryTemp.txt: \u2705 {P} Passed - \u274C {F} Failures - \u274C {E} Errors - \u2757 {I} Incomplete - \u26AA {S} Skipped
+$summaryContent = "\u2705 $passed Passed - \u274C $failures Failures - \u274C $errors Errors - \u2757 $incomplete Incomplete - \u26AA $skipped Skipped"
+
+$summaryFile = Join-Path $testReportsDir "summaryTemp.txt"
+[System.IO.File]::WriteAllText($summaryFile, $summaryContent, [System.Text.Encoding]::ASCII)
+Write-Host "[+] Created: $summaryFile" -ForegroundColor Green
+Write-Host "    $summaryContent"
+
+# Also write to Reports/summaryTemp.txt for fallback
+if (Test-Path $reportsDir) {
+    [System.IO.File]::WriteAllText((Join-Path $reportsDir "summaryTemp.txt"), $summaryContent, [System.Text.Encoding]::ASCII)
+}
+
+# 3. Synchronize report files into TestReports/<Project>_<timestamp>/ if Katalon saved to Reports/
+if ($latestReport) {
+    $reportParentDir = $latestReport.Directory.FullName
+    $nowStr = Get-Date -Format "yyyyMMddHHmmss"
+    if ($ProjectName -match "_\d{10,14}$") {
+        $targetProjDir = Join-Path $testReportsDir $ProjectName
+    } else {
+        $targetProjDir = Join-Path $testReportsDir "${ProjectName}_$nowStr"
+    }
+    $targetSubDir = Join-Path $targetProjDir (Split-Path $reportParentDir -Leaf)
+
+    if (-not (Test-Path $targetSubDir)) {
+        New-Item -ItemType Directory -Path $targetSubDir -Force | Out-Null
+    }
+
+    Copy-Item -Path "$reportParentDir\*" -Destination $targetSubDir -Recurse -Force
+    Write-Host "[+] Synced artifacts to: $targetSubDir" -ForegroundColor Green
+
+    # Ensure results.html exists in targetProjDir
+    $htmlFiles = Get-ChildItem -Path $targetSubDir -Filter "*.html"
+    if ($htmlFiles.Count -gt 0) {
+        Copy-Item -Path $htmlFiles[0].FullName -Destination (Join-Path $targetProjDir "results.html") -Force
+        Write-Host "[+] Created results.html in: $targetProjDir" -ForegroundColor Green
+    }
+}
+
+Write-Host "=== [Centralize CI/CD] Report Generation Complete ===" -ForegroundColor Cyan

package/tools/git_pre_commit_guard.py

@@ -0,0 +1,203 @@
+#!/usr/bin/env python3
+"""
+Enterprise Git Pre-Commit Architecture & Discipline Guard
+--------------------------------------------------
+Automated gatekeeper executed before every 'git commit'.
+Ensures:
+  1. 100% UTF-8 No BOM across repository files.
+  2. Flat Architecture & Clean POM: Zero raw XPaths or findTestObject in Scripts/TC-xxx.
+  3. Path Portability: Zero absolute machine paths (Users/, phungcao, /path/to/project).
+"""
+
+import sys
+import os
+import subprocess
+
+FORBIDDEN_PATHS = ["/Users/", "C:\\Workspace\\", "D:\\Workspace\\", "file:///c:", "file:///d:"]
+
+def run_cmd(cmd):
+    return subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, shell=True)
+
+def check_bom(files):
+    bom_files = []
+    for f in files:
+        if not os.path.exists(f):
+            continue
+        try:
+            with open(f, "rb") as fp:
+                if fp.read(3) == b"\xef\xbb\xbf":
+                    bom_files.append(f)
+        except Exception:
+            pass
+    return bom_files
+
+def check_forbidden_paths(files):
+    violations = []
+    for f in files:
+        if not os.path.exists(f) or os.path.isdir(f):
+            continue
+        # Skip this guard script itself and binary files
+        if f.endswith((".py", ".db", ".png", ".jpg", ".zip", ".tar", ".gz")):
+            continue
+        try:
+            with open(f, "r", encoding="utf-8", errors="ignore") as fp:
+                for line_no, line in enumerate(fp, 1):
+                    # Allow mention in historical report or gitignore
+                    if "FINAL_REPORT.md" in f or ".gitignore" in f:
+                        continue
+                    for forbidden in FORBIDDEN_PATHS:
+                        if forbidden in line:
+                            violations.append((f, line_no, forbidden))
+        except Exception:
+            pass
+    return violations
+
+def check_scripts_clean_pom(files):
+    violations = []
+    for f in files:
+        if not os.path.exists(f):
+            continue
+        # Only check test scripts in Scripts/
+        if "Scripts/" in f and f.endswith(".groovy"):
+            try:
+                with open(f, "r", encoding="utf-8", errors="ignore") as fp:
+                    for line_no, line in enumerate(fp, 1):
+                        stripped = line.strip()
+                        if stripped.startswith("//"):
+                            continue
+                        if "findTestObject" in line:
+                            violations.append((f, line_no, "Raw findTestObject is forbidden in Scripts/"))
+                        if "//" in line and ("//table" in line or "//input" in line or "//button" in line):
+                            violations.append((f, line_no, "Raw XPath is forbidden in Scripts/"))
+            except Exception:
+                pass
+    return violations
+
+def main():
+    # If called with --install
+    if len(sys.argv) > 1 and sys.argv[1] == "--install":
+        git_dir = run_cmd("git rev-parse --git-dir").stdout.strip()
+        if not git_dir or not os.path.isdir(git_dir):
+            print("❌ Error: Not a git repository.")
+            sys.exit(1)
+        
+        # 1. Pre-commit hook
+        pre_commit_path = os.path.join(git_dir, "hooks", "pre-commit")
+        pre_commit_content = (
+            "#!/bin/sh\n"
+            "# Enterprise Pre-Commit Guard\n"
+            "python3 \"$0/../tools/git_pre_commit_guard.py\" 2>/dev/null || python tools/git_pre_commit_guard.py \"$@\"\n"
+        )
+        with open(pre_commit_path, "w", encoding="utf-8") as fp:
+            fp.write(pre_commit_content)
+        os.chmod(pre_commit_path, 0o755)
+
+        # 2. Post-merge hook (Auto-sync memory cache on git pull)
+        post_merge_path = os.path.join(git_dir, "hooks", "post-merge")
+        post_merge_content = (
+            "#!/bin/sh\n"
+            "# Enterprise Post-Merge Hook: Automatically initialize & sync Central Agent Memory\n"
+            "if [ -f \"tools/cache_resolver.py\" ]; then\n"
+            "    echo \"🔄 [Git Post-Merge] Syncing Central Agent Memory...\"\n"
+            "    python3 \"$0/../tools/cache_resolver.py\" init 2>/dev/null || python tools/cache_resolver.py init 2>/dev/null || true\n"
+            "fi\n"
+        )
+        with open(post_merge_path, "w", encoding="utf-8") as fp:
+            fp.write(post_merge_content)
+        os.chmod(post_merge_path, 0o755)
+
+        # 3. Pre-push hook (Auto-sync memory cache on git push)
+        pre_push_path = os.path.join(git_dir, "hooks", "pre-push")
+        pre_push_content = (
+            "#!/bin/sh\n"
+            "# Enterprise Pre-Push Hook: Synchronize Central Agent Memory before pushing\n"
+            "if [ -f \"tools/cache_resolver.py\" ]; then\n"
+            "    echo \"🔄 [Git Pre-Push] Synchronizing Central Agent Memory to local cache...\"\n"
+            "    python3 \"$0/../tools/cache_resolver.py\" sync 2>/dev/null || python tools/cache_resolver.py sync 2>/dev/null || true\n"
+            "fi\n"
+        )
+        with open(pre_push_path, "w", encoding="utf-8") as fp:
+            fp.write(pre_push_content)
+        os.chmod(pre_push_path, 0o755)
+
+        print(f"✅ Git hooks installed successfully:")
+        print(f"   - Pre-commit: {pre_commit_path}")
+        print(f"   - Post-merge: {post_merge_path} (Auto-runs cache_resolver.py init on git pull)")
+        print(f"   - Pre-push:   {pre_push_path} (Auto-runs cache_resolver.py sync on git push)")
+        sys.exit(0)
+
+    # Get staged files
+    res = run_cmd("git diff --cached --name-only")
+    staged_files = [f.strip() for f in res.stdout.splitlines() if f.strip()]
+
+    if not staged_files:
+        sys.exit(0)
+
+    errors_found = False
+
+    # 1. BOM Check
+    target_exts = (".groovy", ".tc", ".ts", ".glbl", ".md", ".py", ".json", ".ps1")
+    check_files = [f for f in staged_files if f.endswith(target_exts)]
+    bom_files = check_bom(check_files)
+    if bom_files:
+        print("❌ [PRE-COMMIT BLOCKED] UTF-8 BOM detected in staged files:")
+        for bf in bom_files:
+            print(f"   - {bf}")
+        errors_found = True
+
+    # 2. Path Portability Check
+    path_violations = check_forbidden_paths(staged_files)
+    if path_violations:
+        print("❌ [PRE-COMMIT BLOCKED] Absolute machine path detected in staged files:")
+        for f, line_no, term in path_violations:
+            print(f"   - {f}:{line_no} (Forbidden: '{term}')")
+        errors_found = True
+
+    # 3. Clean POM Guard
+    pom_violations = check_scripts_clean_pom(staged_files)
+    if pom_violations:
+        print("❌ [PRE-COMMIT BLOCKED] Clean POM violation in Scripts/:")
+        for f, line_no, reason in pom_violations:
+            print(f"   - {f}:{line_no} ({reason})")
+        errors_found = True
+
+    # 4. AI Documentation & Anti-Drift Guard
+    doc_affected = any(f.endswith(".md") or ".agents" in f or "tools/" in f or "Keywords/" in f or "Test Suites/" in f for f in staged_files)
+    if doc_affected:
+        linter_script = os.path.join(os.path.dirname(__file__), "lint_ai_docs.py")
+        if os.path.exists(linter_script):
+            res = subprocess.run([sys.executable, linter_script], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
+            if res.returncode != 0:
+                print("❌ [PRE-COMMIT BLOCKED] AI Documentation Linter detected drift:")
+                print(res.stdout.strip())
+                errors_found = True
+
+    # 5. Keywords/ change -> Auto-regenerate Repo Map
+    keywords_affected = any(f.startswith("Keywords/") and f.endswith(".groovy") for f in staged_files)
+    if keywords_affected:
+        repo_map_script = os.path.join(os.path.dirname(__file__), "repo_map.py")
+        if os.path.exists(repo_map_script):
+            subprocess.run([sys.executable, repo_map_script], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+            # Stage updated repo_map files
+            subprocess.run(["git", "add", "tools/repo_map.txt", "tools/repo_map.json"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+
+    # 6. Scripts/ change -> Static Defect Linter (Meta Infer-Style)
+    scripts_affected = any(f.startswith("Scripts/") and f.endswith(".groovy") for f in staged_files)
+    if scripts_affected:
+        infer_script = os.path.join(os.path.dirname(__file__), "infer_linter.py")
+        if os.path.exists(infer_script):
+            res = subprocess.run([sys.executable, infer_script], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
+            if res.returncode != 0:
+                print("❌ [PRE-COMMIT BLOCKED] Static Defect Sentinel detected critical issues in staged scripts:")
+                print(res.stdout.strip())
+                errors_found = True
+
+    if errors_found:
+        print("\n🚫 Commit aborted. Please fix violations before committing.")
+        sys.exit(1)
+    else:
+        print("✅ [PRE-COMMIT GUARD] All quality gates passed (No BOM, Clean POM, Clean Paths, Docs Aligned, Static Lint Pass).")
+        sys.exit(0)
+
+if __name__ == "__main__":
+    main()