#!/usr/bin/env python3
"""The single definition of this site's nav and footer, and the tool that applies it.

Run from anywhere: python3 admin/build/chrome.py

Every page is hand-written static HTML — that stays true, because a human should
be able to open any file and edit it. What is NOT hand-maintained is the chrome:
the nav row (including the version badge that validate.js requires to agree
everywhere) and the footer columns. Those are defined once here and rewritten in
place across the tree, which is what stops a many-page site from drifting.

Adding a page: add it to NAV or FOOTER if it belongs there, write the file with
any nav/footer block at all, then run this. The block contents are replaced; the
`here` state is set from the page's own path.
"""
import re
import sys
from pathlib import Path

ROOT = Path(__file__).resolve().parents[2]
VERSION = (ROOT / "admin/build/version.txt").read_text().strip()
GH = "https://github.com/SGit-AI/SGit-AI__Website__Subscriptions"
PARENT = "https://sgit.ai"
PARENT_TITLE = ("sgit.ai — the parent project: the vault layer and CLI this site's "
                "workflows run on, and the network this site is a member of")

# The nav, two levels. Each entry is (label, own page, [(sub-label, href), ...], prefixes).
#
# Two rules the structure has to keep:
#   · A group label is always a link to a real page, never a menu-only stub. Nothing on
#     this site should be reachable only by opening a dropdown.
#   · `prefixes` decides the "here" state, so a page that is not itself in the nav still
#     lights up the group it belongs to.
NAV = [
    ("The standard", "standard/index.html", [
        ("● The five clauses", "standard/index.html"),
        ("The proposal (draft law)", "standard/proposal/index.html"),
    ], ("standard/",)),
    ("The register", "register/index.html", [
        ("● Do you hold it?", "register/index.html"),
        ("Governance & schema", "register/index.html#governance"),
    ], ("register/",)),
    ("Evidence", "exit/index.html", [
        ("● Exit-path method", "exit/index.html"),
        ("The law", "law/index.html"),
    ], ("exit/", "law/")),
    ("How it works", "workflows/index.html", [
        ("Workflows & vaults", "workflows/index.html"),
        ("The service (later)", "service/index.html"),
    ], ("workflows/", "service/")),
    ("Site", "documents/index.html", [
        ("The documents", "documents/index.html"),
        ("The network", "network/index.html"),
        ("What this site ships", "shipped/index.html"),
        ("Comms: tasks & requests", "admin/comms.html"),
        ("Release history", "admin/versions.html"),
        ("Admin & engineering", "admin/index.html"),
    ], ("documents/", "network/", "shipped/", "admin/")),
]

FOOTER = [
    ("The standard", [
        ("● The five clauses", "standard/index.html"),
        ("The proposal (draft law)", "standard/proposal/index.html"),
        ("The register", "register/index.html"),
    ]),
    ("Evidence", [
        ("Exit-path method", "exit/index.html"),
        ("The law", "law/index.html"),
        ("What this site ships", "shipped/index.html"),
    ]),
    ("How it works", [
        ("Workflows & vaults", "workflows/index.html"),
        ("The service (later)", "service/index.html"),
        ("The network", "network/index.html"),
    ]),
    ("Site", [
        ("The documents", "documents/index.html"),
        ("Comms: tasks & requests", "admin/comms.html"),
        ("Release history", "admin/versions.html"),
        ("llms.txt", "llms.txt"),
        ("llms-full.txt", "llms-full.txt"),
    ]),
]

BLURB = ("A subscription is a discount for committing to regular use, not rent on "
         "something you have the right to ignore. Five checkable clauses, a public "
         "register that publishes the record and never the verdict, and the exit-path "
         "measurements behind it — CC BY 4.0, part of the "
         "<a href=\"https://sgit.ai\" style=\"display:inline;padding:0\"><b>sgit.ai</b></a> "
         "network.")
PARTNOTE = ('⚠ Record, never verdict — no adjectives, no scores, anywhere on this site. '
            'The register launches empty: governance and the publishing rule ship before '
            'entry one. <a href="{up}shipped/index.html" style="display:inline;padding:0">'
            'What this site ships, and what is still pending</a>.')
PARTNOTE_SELF = ('⚠ Record, never verdict — no adjectives, no scores, anywhere on this '
                 'site. You are on the page that states what is built versus proposed.')
NETLINE = ('<a href="https://sgit.ai"><b>↗ sgit.ai</b></a> — the parent project · '
           '<a href="https://risks.sgit.ai">↗ risks.sgit.ai</a> — registers, scoring, '
           'evidence · <a href="https://standards.sgit.ai">↗ standards.sgit.ai</a> — '
           'instruments as graphs · <a href="https://nfrs.sgit.ai">↗ nfrs.sgit.ai</a> — '
           'the dated-page discipline · <a href="https://sgit.ai/network/index.html">↗ the '
           'network</a>')


def nav_html(rel, up):
    groups = []
    for label, own, subs, prefixes in NAV:
        active = rel == own or any(rel.startswith(pre) for pre in prefixes)
        links = "\n".join(
            f'      <a class="sl{" here" if href.split("#")[0] == rel else ""}" href="{up}{href}">{text}</a>'
            for text, href in subs)
        groups.append(
            f'    <div class="ni ni-has">\n'
            f'      <a class="nl{" here" if active else ""}" href="{up}{own}">{label}'
            f'<span class="caret">&#9662;</span></a>\n'
            f'      <div class="sub">\n{links}\n      </div>\n'
            f'    </div>')
    rows = "\n".join(groups)
    return (f'<nav class="site"><div class="row">\n'
            f'  <a class="brand" href="{up}index.html">subscriptions<span>.sgit.ai</span></a>\n'
            f'  <a class="parent" href="{PARENT}" title="{PARENT_TITLE}">↗ part of <b>sgit.ai</b></a>\n'
            f'  <span class="stage-pill">record, never verdict</span>\n'
            f'  <a class="ver" href="{up}admin/versions.html" title="Site release history">{VERSION}</a>\n'
            f'  <button class="nav-toggle" type="button" aria-expanded="false" aria-label="Menu">Menu</button>\n'
            f'  <div class="nav-items">\n{rows}\n  </div>\n'
            f'  <a class="gh" href="{GH}">★ GitHub</a>\n'
            f'  <script src="{up}assets/nav.js" defer></script>\n'
            f'</div></nav>')


def footer_html(rel, up):
    partnote = PARTNOTE_SELF if rel == "shipped/index.html" else PARTNOTE.format(up=up)
    md_twin = f' · <a href="{up}index.md">this page as markdown</a>' if rel == "index.html" else ""
    cols = "\n".join(
        "  <div>\n"
        f"    <h4>{head}</h4>\n"
        + "\n".join(f'    <a href="{l if l.startswith("http") else up + l}">{t}</a>' for t, l in links)
        + "\n  </div>"
        for head, links in FOOTER)
    return (f'<footer class="site"><div class="cols">\n'
            f'  <div>\n'
            f'    <div class="brandline">subscriptions<span>.sgit.ai</span></div>\n'
            f'    <p>{BLURB}</p>\n'
            f'    <p class="netline">{NETLINE}</p>\n'
            f'    <p class="partnote">{partnote}</p>\n'
            f'    <p class="verline">site <a href="{up}admin/versions.html">{VERSION}</a> · '
            f'<a href="{up}admin/index.html">engineering</a>{md_twin}</p>\n'
            f'  </div>\n{cols}\n</div></footer>')


def stamp_text_twins():
    """The version also appears in llms.txt, llms-full.txt and index.md, and
    validate.js enforces that it agrees. Nothing used to SET it there on the
    sibling sites, so it was hand-edited every release — and hand-editing it
    silently missed more than once. Own it here instead."""
    out = []
    for name, pattern, repl in (
            ("llms.txt", r"Site version: v\d+\.\d+\.\d+", f"Site version: {VERSION}"),
            ("llms-full.txt", r"Site version: v\d+\.\d+\.\d+", f"Site version: {VERSION}"),
            ("index.md", r"· site v\d+\.\d+\.\d+ ·", f"· site {VERSION} ·")):
        p = ROOT / name
        if not p.exists():
            continue
        t = p.read_text()
        t2, n = re.subn(pattern, repl, t, count=1)
        if n and t2 != t:
            p.write_text(t2)
            out.append(name)
    return out


def main():
    changed = []
    for path in sorted(ROOT.rglob("*.html")):
        if ".git" in path.parts:
            continue
        rel = path.relative_to(ROOT).as_posix()
        up = "../" * (len(path.relative_to(ROOT).parts) - 1)
        text = path.read_text()
        before = text
        text, n_nav = re.subn(r'<nav class="site">.*?</nav>', lambda _: nav_html(rel, up),
                              text, count=1, flags=re.S)
        text, n_foot = re.subn(r'<footer class="site">.*?</footer>', lambda _: footer_html(rel, up),
                               text, count=1, flags=re.S)
        if not n_nav or not n_foot:
            print(f"  ! {rel}: missing {'nav' if not n_nav else ''}"
                  f"{' and ' if not n_nav and not n_foot else ''}"
                  f"{'footer' if not n_foot else ''} block", file=sys.stderr)
        if text != before:
            path.write_text(text)
            changed.append(rel)
    changed += stamp_text_twins()
    print(f"chrome: {VERSION} applied — {len(changed)} file(s) updated")
    for c in changed:
        print(f"  · {c}")


if __name__ == "__main__":
    try:
        main()
    except BrokenPipeError:
        sys.stdout = None