import os
import json
 
ROOT = "docs"
 
EXCLUDED_DIRS = {
    "spine",
    "_template",
    "assets",
    "images",
    "tools"
}
 
def find_domains():
    """Return all top-level domain directories under /docs."""
    domains = []
    for item in os.listdir(ROOT):
        path = os.path.join(ROOT, item)
        if os.path.isdir(path) and item not in EXCLUDED_DIRS:
            domains.append(path)
    return domains
 
def find_modules(domain_path):
    """Return all module directories inside a domain."""
    modules = []
    for root, dirs, files in os.walk(domain_path):
        if "module.json" in files:
            modules.append(root)
    return modules
 
def load_module_json(path):
    module_json_path = os.path.join(path, "module.json")
    if not os.path.exists(module_json_path):
        return None
 
    with open(module_json_path, "r", encoding="utf-8") as f:
        return json.load(f)
 
def generate_domain_overview(domain_path, modules):
    out_path = os.path.join(domain_path, "domain_overview.md")
 
    if os.path.exists(out_path):
        print(f"❌ domain_overview.md already exists in {domain_path}, skipping.")
        return
 
    domain_name = os.path.basename(domain_path)
 
    # Build module list
    module_lines = []
    for m in modules:
        module_name = os.path.basename(m)
        module_lines.append(f"- **{module_name}**")
 
    module_list = "\n".join(module_lines)
 
    content = f"""# {domain_name} — Domain Overview
 
## Purpose
This document provides a domain‑level overview for **{domain_name}**, summarizing its structural role within the TriadicFrameworks canon and listing all modules contained within this domain.
 
---
 
## Canon Context
This domain inherits the full TriadicFrameworks canon:
 
- RTT triads  
- TFT triads  
- Session context  
- RTT frozen source  
- AI initialization rules  
 
Canon reference: `/docs/spine/spine.json`
 
---
 
## Domain Role
The **{domain_name}** domain contributes a coherent set of modules that collectively define its conceptual, structural, and operational space within TriadicFrameworks.
 
Each module in this domain is canon‑aligned, drift‑resistant, and AI‑readable.
 
---
 
## Modules in This Domain
{module_list}
 
---
 
## AI Initialization
AI engines loading this domain should:
 
1. Load the spine first  
2. Load the canon triads  
3. Apply session context  
4. Validate triad descriptions  
5. Resolve triad aliases  
 
This ensures coherence and prevents drift across all modules in the domain.
 
---
 
Generated automatically by `generate_domain_overview.py`.
"""
 
    with open(out_path, "w", encoding="utf-8") as f:
        f.write(content)
 
    print(f"✔ Created {out_path}")
 
def main():
    print("\n=== TriadicFrameworks Domain Overview Generator ===\n")
 
    domains = find_domains()
 
    for domain in domains:
        modules = find_modules(domain)
        if modules:
            generate_domain_overview(domain, modules)
 
    print("\n✨ domain_overview.md generation complete.\n")
 
if __name__ == "__main__":
    main()