A Four-Tiered Cognitive Architecture for Advanced AI Reasoning

#!/usr/bin/env python3 """ Final solution: Create HTML with inline Mermaid.js that renders properly in browsers, then use browser print-to-PDF functionality for best results. """ import markdown import re import sys from pathlib import Path def process_manual_breaks(html_content): """Convert manual page break markers to proper CSS page breaks.""" # Pattern to match our manual page break markers page_break_pattern = r'[\s\n]*

PAGE BREAK

[\s\n]*' # Replace with proper CSS page break page_break_replacement = '

' processed_html = re.sub(page_break_pattern, page_break_replacement, html_content, flags=re.IGNORECASE | re.MULTILINE) return processed_html def extract_mermaid_diagrams(html_content): """Extract and replace Mermaid code blocks with proper Mermaid.js divs.""" # Pattern to match Mermaid code blocks in HTML (both formats) mermaid_pattern1 = r'

(.*?)

' mermaid_pattern2 = r'

flowchart(.*?)

' def replace_mermaid1(match): diagram_content = match.group(1).strip() # Create proper Mermaid.js div mermaid_div = f'''

{diagram_content}

''' return mermaid_div def replace_mermaid2(match): # Extract the flowchart content and clean it up diagram_content = "flowchart" + match.group(1) # Remove HTML span tags and decode entities diagram_content = re.sub(r']*>', '', diagram_content) diagram_content = re.sub(r'', '', diagram_content) diagram_content = diagram_content.replace('"', '"') diagram_content = diagram_content.replace('>', '>') diagram_content = diagram_content.replace('<', '<') diagram_content = diagram_content.replace('&', '&') # Create proper Mermaid.js div mermaid_div = f'''

{diagram_content}

''' return mermaid_div # Apply both patterns processed_html = re.sub(mermaid_pattern1, replace_mermaid1, html_content, flags=re.DOTALL) processed_html = re.sub(mermaid_pattern2, replace_mermaid2, processed_html, flags=re.DOTALL) return processed_html def create_html_with_mermaid(content): """Create a complete HTML document with Mermaid.js integration.""" html_template = f""" A Four-Tiered Cognitive Architecture for Advanced AI Reasoning

📄 Print Instructions

To convert this document to PDF:

Press Ctrl+P (or Cmd+P on Mac)
Select "Save as PDF" as the destination
Set paper size to A4
Set margins to 0.75 inches (or 19mm)
Ensure "Background graphics" is enabled
Click "Save" or "Print"

This instruction box will not appear in the printed PDF.

{content} """ return html_template def convert_md_to_printable_html(input_file, output_file=None): """Convert markdown to HTML with working Mermaid diagrams for browser printing.""" input_path = Path(input_file) if not input_path.exists(): print(f"Error: Input file {input_file} not found") return False if output_file is None: output_file = input_path.stem + '_printable.html' output_path = Path(output_file) print(f"Converting {input_file} to {output_file}") try: # Read markdown content with open(input_path, 'r', encoding='utf-8') as f: md_content = f.read() # Convert markdown to HTML md = markdown.Markdown(extensions=['codehilite', 'fenced_code', 'tables']) html_content = md.convert(md_content) # Process manual page breaks html_content = process_manual_breaks(html_content) # Process Mermaid diagrams html_content = extract_mermaid_diagrams(html_content) # Create complete HTML document with Mermaid.js full_html = create_html_with_mermaid(html_content) # Save HTML file with open(output_path, 'w', encoding='utf-8') as f: f.write(full_html) print(f"✅ HTML file created: {output_path}") print("\n📄 NEXT STEPS:") print(f"1. Open {output_path} in your browser") print("2. Wait for diagrams to load (should see flowcharts)") print("3. Press Ctrl+P (or Cmd+P on Mac)") print("4. Select 'Save as PDF'") print("5. Set paper size to A4, margins to 0.75 inches") print("6. Enable 'Background graphics'") print("7. Save as PDF") print("\n🎯 This will give you a PDF with properly rendered Mermaid diagrams!") return True except Exception as e: print(f"Error during conversion: {e}") return False def main(): if len(sys.argv) < 2: print("Usage: python final_mermaid_pdf_solution.py [output.html]") print("\nThis creates an HTML file with working Mermaid diagrams.") print("Use your browser's print-to-PDF feature for best results.") sys.exit(1) input_file = sys.argv[1] output_file = sys.argv[2] if len(sys.argv) > 2 else None success = convert_md_to_printable_html(input_file, output_file) sys.exit(0 if success else 1) if __name__ == "__main__": main()