fix: comprehensive QA content fixes and governance implementations

Author: TechStack Global

.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# CODEOWNERS
+
+# Require owner review and approval for any changes to product review posts.
+posts/*.html @TechStackGlobalOwner
+posts/template.html @TechStackGlobalOwner

.github/CONTRIBUTING.md

@@ -0,0 +1,14 @@
+# Contributing Guidelines
+
+## Foundation Files & Structural Changes
+
+**Critical Safety Directive:** No automated bulk edits on product review files. 
+Changes to individual posts (`posts/*.html`) and the review template (`posts/template.html`) must be performed cautiously and manually, or via carefully scoped scripts restricted to a feature branch.
+
+### Change Process
+1. Do not deploy structural UI changes directly to `main`.
+2. Create a feature branch named `fix/<short-description>-<date>` or `feat/<short-description>-<date>`.
+3. Changes to `posts/*` must be submitted via a Pull Request (PR) with preview links.
+4. The PR must receive owner sign-off before merging into `main`.
+
+Please refer to the emergency standardization pipeline for compliance requirements.

check_links.py

@@ -0,0 +1,52 @@
+import os
+import re
+
+def check_internal_links():
+    base_dir = 'c:/Users/PMLS/Desktop/Youtube Shorts/b2b_blog'
+    html_files = []
+    
+    for root, dirs, files in os.walk(base_dir):
+        # Exclude node_modules, .git, etc if present
+        if '.git' in root or '.venv' in root:
+            continue
+        for f in files:
+            if f.endswith('.html'):
+                html_files.append(os.path.join(root, f))
+                
+    broken_links = []
+    
+    for filepath in html_files:
+        with open(filepath, 'r', encoding='utf-8') as f:
+            content = f.read()
+            
+            # Find all href=
+            hrefs = re.findall(r'href=["\'](.*?)["\']', content)
+            
+            for href in hrefs:
+                if href.startswith('http') or href.startswith('mailto:') or href.startswith('#') or href == '':
+                    continue
+                
+                # Resolve relative path
+                # Strip query params or hash
+                href_clean = href.split('?')[0].split('#')[0]
+                if not href_clean:
+                    continue
+                    
+                target_path = os.path.normpath(os.path.join(os.path.dirname(filepath), href_clean))
+                
+                if not os.path.exists(target_path):
+                    broken_links.append((filepath, href))
+                    
+    report_path = 'c:/Users/PMLS/.gemini/antigravity/brain/8acb5e45-297b-4c05-ae50-1d7cdeac50b0/broken_links_report.txt'
+    with open(report_path, 'w', encoding='utf-8') as f:
+        if broken_links:
+            f.write("Broken Links Found:\n")
+            for source, link in broken_links:
+                f.write(f"In {os.path.basename(source)}: {link}\n")
+            print(f"Found {len(broken_links)} broken links. Check report.")
+        else:
+            f.write("No broken internal links found.\n")
+            print("No broken internal links found.")
+
+if __name__ == '__main__':
+    check_internal_links()

posts/apple-macbook-pro-m4-pro-review.html

@@ -5,6 +5,9 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Apple MacBook Pro M4 Pro Review (2026) | TechStack Global</title>
+    <meta name="description"
+        content="Technical review of the Apple MacBook Pro M4 Pro (2026). In-depth analysis on performance, battery life, and ROI for modern professionals.">
+    <!-- OpenGraph / Social Media -->
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&display=swap"
         rel="stylesheet">
     <link rel="stylesheet" href="../style.css">

qa_content.py

@@ -0,0 +1,44 @@
+import os
+import csv
+import re
+
+def check_content():
+    posts_dir = 'c:/Users/PMLS/Desktop/Youtube Shorts/b2b_blog/posts'
+    output_file = 'c:/Users/PMLS/.gemini/antigravity/brain/8acb5e45-297b-4c05-ae50-1d7cdeac50b0/product_checks.csv'
+    
+    files = [f for f in os.listdir(posts_dir) if f.endswith('.html') and f != 'template.html']
+    
+    results = []
+    
+    for filename in files:
+        path = os.path.join(posts_dir, filename)
+        with open(path, 'r', encoding='utf-8') as f:
+            content = f.read()
+            
+            has_tldr = bool(re.search(r'TL;DR', content, re.IGNORECASE))
+            has_specs = bool(re.search(r'Spec|Technical', content, re.IGNORECASE) or '<table' in content.lower())
+            has_proscons = bool(re.search(r'Pros|Cons', content, re.IGNORECASE))
+            has_whofor = bool(re.search(r'Who is this for|Who Should Buy|Who is', content, re.IGNORECASE))
+            has_faqs = bool(re.search(r'FAQ', content, re.IGNORECASE))
+            has_cta = bool(re.search(r'amazon\.com', content, re.IGNORECASE))
+            
+            results.append([
+                filename,
+                'Yes',
+                'Y' if has_tldr else 'N',
+                'Y' if has_specs else 'N',
+                'Y' if has_proscons else 'N',
+                'Y' if has_whofor else 'N',
+                'Y' if has_faqs else 'N',
+                'Y' if has_cta else 'N'
+            ])
+            
+    with open(output_file, 'w', newline='', encoding='utf-8') as csvfile:
+        writer = csv.writer(csvfile)
+        writer.writerow(['Filename', 'Exists', 'TLDR', 'Specs', 'ProsCons', 'WhoFor', 'FAQs', 'CTA (Y/N)'])
+        writer.writerows(results)
+        
+    print(f"Content audit complete. Results saved to {output_file}")
+
+if __name__ == '__main__':
+    check_content()

qa_seo.py

@@ -0,0 +1,70 @@
+import os
+import re
+
+def verify_seo():
+    base_dir = 'c:/Users/PMLS/Desktop/Youtube Shorts/b2b_blog'
+    report_path = 'c:/Users/PMLS/.gemini/antigravity/brain/8acb5e45-297b-4c05-ae50-1d7cdeac50b0/seo_affiliate_report.txt'
+    
+    with open(report_path, 'w', encoding='utf-8') as report:
+        # Check robots.txt
+        robots_path = os.path.join(base_dir, 'robots.txt')
+        if os.path.exists(robots_path):
+            with open(robots_path, 'r', encoding='utf-8') as f:
+                report.write("--- robots.txt ---\n")
+                report.write(f.read().strip() + "\n\n")
+        else:
+            report.write("--- robots.txt NOT FOUND ---\n\n")
+
+        # Check sitemap.xml
+        sitemap_path = os.path.join(base_dir, 'sitemap.xml')
+        if os.path.exists(sitemap_path):
+            with open(sitemap_path, 'r', encoding='utf-8') as f:
+                lines = f.readlines()
+                report.write("--- sitemap.xml (First 20 Lines) ---\n")
+                report.write("".join(lines[:20]).strip() + "\n\n")
+        else:
+            report.write("--- sitemap.xml NOT FOUND ---\n\n")
+
+        # Check meta tags and JSON-LD
+        samples = [
+            'index.html',
+            'posts/apple-macbook-pro-m4-pro-review.html',
+            'posts/lg-27us500-w-ultrafine-monitor-review.html',
+            'posts/surface-laptop-studio-2-review.html'
+        ]
+        
+        report.write("--- Meta Title & Description Samples ---\n")
+        for sample in samples:
+            filepath = os.path.join(base_dir, sample)
+            try:
+                with open(filepath, 'r', encoding='utf-8') as f:
+                    content = f.read()
+                    
+                    title = re.search(r'<title>(.*?)</title>', content, re.IGNORECASE | re.DOTALL)
+                    title_text = title.group(1).strip() if title else "NO TITLE"
+                    
+                    desc = re.search(r'<meta\s+name=["\']description["\']\s+content=["\'](.*?)["\']', content, re.IGNORECASE | re.DOTALL)
+                    desc_text = desc.group(1).strip() if desc else "NO DESCRIPTION"
+                    
+                    report.write(f"\n{sample}:\nTitle: {title_text}\nDesc: {desc_text}\n")
+                    
+                    if sample.startswith('posts/'):
+                        schema = "YES" if '<script type="application/ld+json">' in content else "NO"
+                        report.write(f"Has JSON-LD Schema: {schema}\n")
+                        
+                        # Check affiliate links
+                        amazon_links = re.findall(r'<a[^>]+href=["\'][^"\']*amazon\.com[^"\']*["\'][^>]*>', content, re.IGNORECASE)
+                        has_sponsored = all('rel="sponsored"' in link or "rel='sponsored'" in link for link in amazon_links) if amazon_links else False
+                        sample_link = amazon_links[0] if amazon_links else "No Amazon links found"
+                        
+                        clean_sample = re.sub(r'\s+', ' ', sample_link).strip()
+                        
+                        report.write(f"Has Amazon Links: {'YES' if amazon_links else 'NO'}\n")
+                        report.write(f"All Amazon links use rel='sponsored': {'YES' if has_sponsored else 'NO'}\n")
+                        report.write(f"Sample Affiliate Link Tag: {clean_sample[:100]}...\n")
+
+            except FileNotFoundError:
+                report.write(f"\n{sample}: FILE NOT FOUND\n")
+
+if __name__ == '__main__':
+    verify_seo()

take_screenshots.py

@@ -0,0 +1,36 @@
+import os
+from playwright.sync_api import sync_playwright
+
+def capture_screenshots():
+    with sync_playwright() as p:
+        browser = p.chromium.launch(headless=True)
+        # Desktop
+        context_desktop = browser.new_context(viewport={'width': 1280, 'height': 800})
+        page_desktop = context_desktop.new_page()
+        
+        # Mobile
+        iphone_13 = p.devices['iPhone 13']
+        context_mobile = browser.new_context(**iphone_13)
+        page_mobile = context_mobile.new_page()
+
+        urls = {
+            'homepage': 'https://techstackglobal.github.io/',
+            'macbook': 'https://techstackglobal.github.io/posts/apple-macbook-pro-m4-pro-review.html'
+        }
+
+        output_dir = 'c:/Users/PMLS/.gemini/antigravity/brain/8acb5e45-297b-4c05-ae50-1d7cdeac50b0/'
+
+        for name, url in urls.items():
+            print(f"Navigating to {url} (Desktop)...")
+            page_desktop.goto(url)
+            page_desktop.screenshot(path=os.path.join(output_dir, f"{name}_desktop.png"), full_page=True)
+
+            print(f"Navigating to {url} (Mobile)...")
+            page_mobile.goto(url)
+            page_mobile.screenshot(path=os.path.join(output_dir, f"{name}_mobile.png"), full_page=True)
+            
+        print("Screenshots captured successfully.")
+        browser.close()
+
+if __name__ == '__main__':
+    capture_screenshots()