qualia-framework 2.6.0 → 3.2.0

package/framework/qualia-framework/bin/generate-report-docx.py

@@ -1,429 +0,0 @@
-#!/usr/bin/env python3
-"""
-Qualia Report — DOCX Generator
-
-Reads JSON report data from stdin, produces a branded DOCX file.
-
-Usage:
-    echo '{"project": "...", ...}' | python3 generate-report-docx.py /path/to/output.docx
-
-Input JSON schema:
-{
-    "project": "project-name",
-    "user": "Fawzi Goussous",
-    "date": "2026-04-06",
-    "time": "14:30",
-    "branch": "main",
-    "duration": "~3 hours",
-    "phase": "Phase 3 of 6 — Auth Integration",
-    "done": [...],
-    "deviations": [...],
-    "blockers": [...],
-    "next": [...],
-    "commits": [...]
-}
-"""
-
-import json
-import sys
-import os
-from datetime import datetime
-
-from docx import Document
-from docx.shared import Inches, Pt, Cm, RGBColor, Emu
-from docx.enum.text import WD_ALIGN_PARAGRAPH
-from docx.enum.table import WD_TABLE_ALIGNMENT
-from docx.oxml.ns import qn, nsdecls
-from docx.oxml import parse_xml
-
-# ─── Brand constants ─────────────────────────────────────────────────────────
-
-TEAL        = RGBColor(0x2A, 0xBF, 0xBF)
-TEAL_DARK   = RGBColor(0x1E, 0x96, 0x96)
-DARK        = RGBColor(0x1A, 0x1A, 0x2E)
-CHARCOAL    = RGBColor(0x2D, 0x2D, 0x3F)
-GRAY        = RGBColor(0x6B, 0x7B, 0x8D)
-LIGHT_GRAY  = RGBColor(0x9A, 0xA5, 0xB0)
-WHITE       = RGBColor(0xFF, 0xFF, 0xFF)
-
-TEAL_HEX       = "2ABFBF"
-TEAL_DARK_HEX  = "1E9696"
-DARK_HEX       = "1A1A2E"
-INFO_BG        = "F0FAFA"
-COMMIT_BG      = "F5F7F9"
-
-LOGO_PATH = os.path.join(os.path.dirname(__file__), "..", "assets", "qualia-logo.png")
-
-FONT_BODY    = "Segoe UI"
-FONT_HEADING = "Segoe UI Semibold"
-FONT_MONO    = "Cascadia Code"
-
-
-# ─── Helpers ──────────────────────────────────────────────────────────────────
-
-def remove_table_borders(table):
-    """Remove all borders from a table."""
-    tbl = table._tbl
-    tblPr = tbl.tblPr if tbl.tblPr is not None else parse_xml(f'<w:tblPr {nsdecls("w")}/>')
-    borders = parse_xml(
-        f'<w:tblBorders {nsdecls("w")}>'
-        f'  <w:top w:val="none" w:sz="0" w:space="0" w:color="auto"/>'
-        f'  <w:left w:val="none" w:sz="0" w:space="0" w:color="auto"/>'
-        f'  <w:bottom w:val="none" w:sz="0" w:space="0" w:color="auto"/>'
-        f'  <w:right w:val="none" w:sz="0" w:space="0" w:color="auto"/>'
-        f'  <w:insideH w:val="none" w:sz="0" w:space="0" w:color="auto"/>'
-        f'  <w:insideV w:val="none" w:sz="0" w:space="0" w:color="auto"/>'
-        f'</w:tblBorders>'
-    )
-    tblPr.append(borders)
-
-
-def set_cell_shading(cell, color_hex):
-    """Set background color on a table cell."""
-    shading = parse_xml(f'<w:shd {nsdecls("w")} w:fill="{color_hex}"/>')
-    cell._tc.get_or_add_tcPr().append(shading)
-
-
-def set_cell_margins(cell, top=0, bottom=0, left=100, right=100):
-    """Set cell margins in twips."""
-    tc = cell._tc
-    tcPr = tc.get_or_add_tcPr()
-    tcMar = parse_xml(
-        f'<w:tcMar {nsdecls("w")}>'
-        f'  <w:top w:w="{top}" w:type="dxa"/>'
-        f'  <w:bottom w:w="{bottom}" w:type="dxa"/>'
-        f'  <w:start w:w="{left}" w:type="dxa"/>'
-        f'  <w:end w:w="{right}" w:type="dxa"/>'
-        f'</w:tcMar>'
-    )
-    tcMar_old = tcPr.find(qn('w:tcMar'))
-    if tcMar_old is not None:
-        tcPr.remove(tcMar_old)
-    tcPr.append(tcMar)
-
-
-def add_teal_rule(doc, weight=6):
-    """Add a teal horizontal line."""
-    p = doc.add_paragraph()
-    p.paragraph_format.space_before = Pt(2)
-    p.paragraph_format.space_after = Pt(8)
-    pPr = p._p.get_or_add_pPr()
-    pBdr = parse_xml(
-        f'<w:pBdr {nsdecls("w")}>'
-        f'  <w:bottom w:val="single" w:sz="{weight}" w:space="1" w:color="{TEAL_HEX}"/>'
-        f'</w:pBdr>'
-    )
-    pPr.append(pBdr)
-
-
-def add_section_heading(doc, text):
-    """Add a premium section heading with teal left accent."""
-    p = doc.add_paragraph()
-    p.paragraph_format.space_before = Pt(20)
-    p.paragraph_format.space_after = Pt(10)
-    # Left border accent
-    pPr = p._p.get_or_add_pPr()
-    pBdr = parse_xml(
-        f'<w:pBdr {nsdecls("w")}>'
-        f'  <w:left w:val="single" w:sz="18" w:space="8" w:color="{TEAL_HEX}"/>'
-        f'  <w:bottom w:val="single" w:sz="2" w:space="4" w:color="E0E0E0"/>'
-        f'</w:pBdr>'
-    )
-    pPr.append(pBdr)
-    run = p.add_run(text)
-    run.font.name = FONT_HEADING
-    run.font.size = Pt(13)
-    run.font.color.rgb = CHARCOAL
-    run.font.bold = True
-    return p
-
-
-def add_bullet(doc, text):
-    """Add a styled bullet point with teal bullet."""
-    p = doc.add_paragraph()
-    p.paragraph_format.space_after = Pt(5)
-    p.paragraph_format.left_indent = Cm(0.8)
-    # Teal bullet
-    bullet_run = p.add_run("  \u25B8  ")
-    bullet_run.font.name = FONT_BODY
-    bullet_run.font.size = Pt(10)
-    bullet_run.font.color.rgb = TEAL
-    # Text
-    text_run = p.add_run(text)
-    text_run.font.name = FONT_BODY
-    text_run.font.size = Pt(10.5)
-    text_run.font.color.rgb = DARK
-    return p
-
-
-def add_spacer(doc, pts=6):
-    """Add vertical spacing."""
-    p = doc.add_paragraph()
-    p.paragraph_format.space_before = Pt(0)
-    p.paragraph_format.space_after = Pt(pts)
-    run = p.add_run("")
-    run.font.size = Pt(2)
-
-
-# ─── Document builder ────────────────────────────────────────────────────────
-
-def build_report(data, output_path):
-    doc = Document()
-
-    # ── Page setup ──
-    for section in doc.sections:
-        section.top_margin = Cm(1.8)
-        section.bottom_margin = Cm(1.5)
-        section.left_margin = Cm(2.5)
-        section.right_margin = Cm(2.5)
-
-    # ── Page border ──
-    for section in doc.sections:
-        sectPr = section._sectPr
-        pgBorders = parse_xml(
-            f'<w:pgBorders {nsdecls("w")} w:offsetFrom="page">'
-            f'  <w:top w:val="single" w:sz="4" w:space="24" w:color="{TEAL_HEX}"/>'
-            f'  <w:left w:val="single" w:sz="4" w:space="24" w:color="{TEAL_HEX}"/>'
-            f'  <w:bottom w:val="single" w:sz="4" w:space="24" w:color="{TEAL_HEX}"/>'
-            f'  <w:right w:val="single" w:sz="4" w:space="24" w:color="{TEAL_HEX}"/>'
-            f'</w:pgBorders>'
-        )
-        sectPr.append(pgBorders)
-
-    # ══════════════════════════════════════════════════════════════════════════
-    # HEADER — Logo left, Title + subtitle right
-    # ══════════════════════════════════════════════════════════════════════════
-
-    header_table = doc.add_table(rows=1, cols=2)
-    header_table.alignment = WD_TABLE_ALIGNMENT.CENTER
-    header_table.autofit = True
-    remove_table_borders(header_table)
-
-    # Set column widths
-    header_table.columns[0].width = Cm(4)
-    header_table.columns[1].width = Cm(12)
-
-    # Logo
-    logo_cell = header_table.cell(0, 0)
-    logo_p = logo_cell.paragraphs[0]
-    logo_p.alignment = WD_ALIGN_PARAGRAPH.LEFT
-    if os.path.exists(LOGO_PATH):
-        logo_p.add_run().add_picture(LOGO_PATH, width=Cm(2.5))
-
-    # Title block
-    title_cell = header_table.cell(0, 1)
-    # "Session Report" — large teal
-    title_p = title_cell.paragraphs[0]
-    title_p.alignment = WD_ALIGN_PARAGRAPH.RIGHT
-    run = title_p.add_run("Session Report")
-    run.font.name = FONT_HEADING
-    run.font.size = Pt(26)
-    run.font.color.rgb = TEAL
-    run.font.bold = True
-    title_p.paragraph_format.space_after = Pt(2)
-
-    # "QUALIA SOLUTIONS" — subtle uppercase
-    sub_p = title_cell.add_paragraph()
-    sub_p.alignment = WD_ALIGN_PARAGRAPH.RIGHT
-    sub_p.paragraph_format.space_after = Pt(0)
-    run = sub_p.add_run("QUALIA SOLUTIONS")
-    run.font.name = FONT_BODY
-    run.font.size = Pt(9)
-    run.font.color.rgb = LIGHT_GRAY
-    run.font.bold = True
-    # Letter spacing
-    rPr = run._r.get_or_add_rPr()
-    spacing = parse_xml(f'<w:spacing {nsdecls("w")} w:val="60"/>')
-    rPr.append(spacing)
-
-    add_teal_rule(doc, weight=12)
-
-    # ══════════════════════════════════════════════════════════════════════════
-    # INFO CARD — teal-tinted background, 2-column layout
-    # ══════════════════════════════════════════════════════════════════════════
-
-    report_date = data.get("date", datetime.now().strftime("%Y-%m-%d"))
-    report_time = data.get("time", datetime.now().strftime("%H:%M"))
-    user_name = data.get("user", "—")
-
-    info_left = [
-        ("Project",  data.get("project", "—")),
-        ("Prepared by", user_name),
-    ]
-    if data.get("phase"):
-        info_left.append(("Phase", data["phase"]))
-
-    info_right = [
-        ("Date",     report_date),
-        ("Time",     report_time),
-        ("Branch",   data.get("branch", "—")),
-        ("Duration", data.get("duration", "—")),
-    ]
-
-    max_rows = max(len(info_left), len(info_right))
-    info_table = doc.add_table(rows=max_rows, cols=4)
-    info_table.alignment = WD_TABLE_ALIGNMENT.CENTER
-    remove_table_borders(info_table)
-
-    # Shade entire info card
-    for row in info_table.rows:
-        for cell in row.cells:
-            set_cell_shading(cell, INFO_BG)
-            set_cell_margins(cell, top=40, bottom=40, left=120, right=60)
-
-    # Fill left columns
-    for i, (label, value) in enumerate(info_left):
-        # Label
-        cell_l = info_table.cell(i, 0)
-        cell_l.width = Cm(2.8)
-        p = cell_l.paragraphs[0]
-        p.paragraph_format.space_after = Pt(1)
-        run = p.add_run(label)
-        run.font.name = FONT_BODY
-        run.font.size = Pt(9)
-        run.font.color.rgb = GRAY
-        run.font.bold = True
-        # Value
-        cell_v = info_table.cell(i, 1)
-        cell_v.width = Cm(5)
-        p = cell_v.paragraphs[0]
-        p.paragraph_format.space_after = Pt(1)
-        run = p.add_run(value)
-        run.font.name = FONT_BODY
-        run.font.size = Pt(10)
-        run.font.color.rgb = DARK
-        run.font.bold = True if label == "Project" else False
-
-    # Fill right columns
-    for i, (label, value) in enumerate(info_right):
-        cell_l = info_table.cell(i, 2)
-        cell_l.width = Cm(2.2)
-        p = cell_l.paragraphs[0]
-        p.paragraph_format.space_after = Pt(1)
-        run = p.add_run(label)
-        run.font.name = FONT_BODY
-        run.font.size = Pt(9)
-        run.font.color.rgb = GRAY
-        run.font.bold = True
-        cell_v = info_table.cell(i, 3)
-        cell_v.width = Cm(4)
-        p = cell_v.paragraphs[0]
-        p.paragraph_format.space_after = Pt(1)
-        run = p.add_run(value)
-        run.font.name = FONT_BODY
-        run.font.size = Pt(10)
-        run.font.color.rgb = DARK
-
-    add_spacer(doc, 4)
-
-    # ══════════════════════════════════════════════════════════════════════════
-    # BODY SECTIONS
-    # ══════════════════════════════════════════════════════════════════════════
-
-    # ── What Was Done ──
-    done_items = data.get("done", [])
-    if done_items:
-        add_section_heading(doc, "What Was Done")
-        for item in done_items:
-            add_bullet(doc, item)
-
-    # ── Deviations (only if any) ──
-    deviations = data.get("deviations", [])
-    if deviations:
-        add_section_heading(doc, "Deviations")
-        for item in deviations:
-            add_bullet(doc, item)
-
-    # ── Blockers (only if any) ──
-    blockers = data.get("blockers", [])
-    if blockers:
-        add_section_heading(doc, "Blockers")
-        for item in blockers:
-            add_bullet(doc, item)
-
-    # ── Commits (compact card) ──
-    commits = data.get("commits", [])
-    if commits:
-        add_section_heading(doc, "Commits")
-        # Render in a shaded card
-        commit_table = doc.add_table(rows=1, cols=1)
-        commit_table.alignment = WD_TABLE_ALIGNMENT.LEFT
-        remove_table_borders(commit_table)
-        commit_cell = commit_table.cell(0, 0)
-        set_cell_shading(commit_cell, COMMIT_BG)
-        set_cell_margins(commit_cell, top=80, bottom=80, left=160, right=160)
-        # First commit in existing paragraph
-        p = commit_cell.paragraphs[0]
-        p.paragraph_format.space_after = Pt(2)
-        run = p.add_run(commits[0])
-        run.font.name = FONT_MONO
-        run.font.size = Pt(8.5)
-        run.font.color.rgb = GRAY
-        # Remaining commits
-        for c in commits[1:10]:
-            p = commit_cell.add_paragraph()
-            p.paragraph_format.space_after = Pt(2)
-            run = p.add_run(c)
-            run.font.name = FONT_MONO
-            run.font.size = Pt(8.5)
-            run.font.color.rgb = GRAY
-        if len(commits) > 10:
-            p = commit_cell.add_paragraph()
-            run = p.add_run(f"  ... and {len(commits) - 10} more")
-            run.font.name = FONT_BODY
-            run.font.size = Pt(8)
-            run.font.color.rgb = LIGHT_GRAY
-            run.font.italic = True
-
-    # ── Next Steps ──
-    next_items = data.get("next", [])
-    if next_items:
-        add_section_heading(doc, "Next Steps")
-        for item in next_items:
-            add_bullet(doc, item)
-
-    # ══════════════════════════════════════════════════════════════════════════
-    # FOOTER
-    # ══════════════════════════════════════════════════════════════════════════
-
-    add_spacer(doc, 16)
-    add_teal_rule(doc, weight=4)
-
-    footer_p = doc.add_paragraph()
-    footer_p.alignment = WD_ALIGN_PARAGRAPH.CENTER
-    footer_p.paragraph_format.space_after = Pt(0)
-
-    run = footer_p.add_run("Qualia Solutions")
-    run.font.name = FONT_HEADING
-    run.font.size = Pt(8)
-    run.font.color.rgb = TEAL
-    run.font.bold = True
-
-    run = footer_p.add_run(f"   \u00B7   {report_date}  {report_time}")
-    run.font.name = FONT_BODY
-    run.font.size = Pt(8)
-    run.font.color.rgb = LIGHT_GRAY
-
-    tagline_p = doc.add_paragraph()
-    tagline_p.alignment = WD_ALIGN_PARAGRAPH.CENTER
-    run = tagline_p.add_run("qualia.solutions")
-    run.font.name = FONT_BODY
-    run.font.size = Pt(7)
-    run.font.color.rgb = LIGHT_GRAY
-
-    # ── Save ──
-    doc.save(output_path)
-    return output_path
-
-
-# ─── Main ─────────────────────────────────────────────────────────────────────
-
-if __name__ == "__main__":
-    if len(sys.argv) < 2:
-        print("Usage: echo '{...}' | python3 generate-report-docx.py /path/to/output.docx", file=sys.stderr)
-        sys.exit(1)
-
-    output_path = sys.argv[1]
-    data = json.load(sys.stdin)
-    result = build_report(data, output_path)
-    print(f"Report saved: {result}")