Ki(dZddlmZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z dd lmZdd lmZmZej&eZdd Zdd Z d dd ZddZy)zWiki generation from community structure. Generates markdown pages for each detected community and an index page, providing a navigable documentation wiki for the codebase architecture. ) annotationsN)Counter)Path)Any)get_communities) get_flows) GraphStore_sanitize_namec|tjdd|jjd}|ddxsdS)z1Convert a community name to a safe filename slug.z [^a-z0-9]+-NPunnamed)resublowerstrip)nameslugs b/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/code_review_graph/wiki.py_slugifyrs6 66-djjl 3 9 9# >D 9 ! !c |d}|d}|jdd}|jdd}|jdd}g}|jd||jd|jd |jd|r#|j||jd|jd |d |jd |d |r|jd||jd|jdg}|jd|jd|r)|jd|jdd} |ddD]} |j| } | s| jdk7s't | j } |jd| d| jd| j d| jd| jd | dz } | s1|j|j|jdt|dkDrD|jd|jdt|dz dn|jd|jd|jd |jdt|} t|d!d"#}g}|D]-}|j|d$}|| zs|j|/|r|dd%D]]}t |jdd&}|jd!d}|jd'd}|jd(|d)|d*d+|d,_t|d%kDr3|jd-t|d%z d.n|jd/|jd|jd2|jd t%}t%}|r[t'|}|j)|D]}|| vs||xxdz cc<|j+|D]}|| vs||xxdz cc<|rm|jd3|jd|j-d4D]&\}}|jd5t |d6|d7(|jd|rm|jd8|jd|j-d4D]&\}}|jd5t |d6|d7(|jd|s$|s"|jd9|jdd23  078 LLy"-J LL LL 56 56 Sb/ "B>>"%D V+*4995   3tyykT^^4DE)4==/=!  " IIK IIK LL5 6 z?R  LL  LL9S_r%9$:/J K () LL LL%& LLZJ;e]#F &( -D55d4jAH*$&&t,  - ', *488FI+FG "hh}c: !, 9+%6{36GyQVPWWXY  ?#b( {3+?"+D*E]ST LLJ K LL LL"# LL$)0)0 z"C//4 -J&$Q'1,' - //4 -J&$Q'1,' -  LL ( LL !1!=!=b!A P  s> ":#eWINO P LL   LL ( LL !1!=!=b!A P  s> ":#eWINO P LL (8 LLD E LL  99U ]  # #; 8#> 9::;R  # # =sC 56 RsD0.UB;U9V'V0DVV''VVW1/8W,,W1c 4t|}|jddt|}d}d}d}g}t} |D]} | d} t | } | } d}| | vr| d|} |dz }| | vr| j | | d}||z }t || }|jr6|s4|jd }||k(r|dz }|j| | | d f|j}|j|d |r|dz }n|dz }|j| | | d fg}|jd |jd |jd|jd |jdt||jd |jd|jd |jd|jdt|dD]$\} } }|jd| d|d| d| d &|jd dj|}|dz }|jr8|s6|jd }||k(r|dz }n1|j|d |dz }n|j|d |dz }|||dS)aGenerate a markdown wiki from the community structure. For each community, generates a markdown page. Also generates an index.md with links to all community pages. Args: store: The graph store. wiki_dir: Directory to write wiki pages into. force: If True, regenerate all pages even if content unchanged. Returns: Dict with pages_generated, pages_updated, pages_unchanged counts. T)parentsexist_okrrr r.mdutf-8encodingrz # Code WikirzOAuto-generated documentation from the code knowledge graph community structure.z**Total communities**: z## Communitiesz| Community | Size | Link |z|-----------|------|------|c |dS)Nr)xs rzgenerate_wiki..s qtr)keyr"r#z | [z.md](z.md) |r-zindex.md)pages_generated pages_updatedpages_unchanged)rmkdirrr7raddrZexists read_textr/ write_textr6sortedrA)rBwiki_dirforce wiki_path communitiesrhrirj page_entries used_slugscommr base_slugrsuffixfilenamefilepathcontentexistingalready_existed index_linesr index_content index_pathexisting_indexs r generate_wikirs$XI OOD4O0!%(KOMO/1L5J8F|TN j [&*D aKFj  tV3<x'*5$7 ?? U))7);H7"1$##T4f$>?"//+Gg6  Q M q OT4f6798> K}%rYr0[1A0BCDr'(r4545"<^DLdDRvSd4&dV6JKLrIIk*MZ'J5#--w-? ] * q O  ! !-' ! B Q Mmg>1+&* rct|}t|}||dz }|jr|jdS||z j }|jr1|j |j r|jdS|j rG|jD]4}|jdk(s||jvs"|jdcSy)aRetrieve a specific wiki page by community name. Args: wiki_dir: Directory containing wiki pages. page_name: Community name (will be slugified for filename lookup). Returns: Page content as a string, or None if the page does not exist. r_r`raN) rris_filernresolveis_relative_tois_diriterdirrystem)rq page_namersrr{ exact_pathps r get_wiki_pagersXI I DdV3<'H!!7!33i'002J 9 9):K:K:M N##W#55""$ 5Axx5 TQVV^{{G{44 5 r)rstrreturnr)rBr rCdict[str, Any]rr)F)rBr rq str | Pathrrboolrr)rqrrrrz str | None)__doc__ __future__rloggingrr9 collectionsrpathlibrtypingrrtrflowsr graphr r getLogger__name__r;rrZrrrdrrrs # (-   8 $" Kbg gg g gTr