KixdZddlmZddlmZddlmZmZddlm Z ddl m Z m Z dd l mZ d dd Z d dd Z d dd Zy )zCTools 13, 14, 15: community listing, detail, architecture overview.) annotations)Any)get_architecture_overviewget_communities) node_to_dict)generate_hints get_session) _get_storeNct|\}} t|||}|dk(r|Dcgc]}|d|d|dd}}ddt|d |d }td |t |d <||j Scc}w#t $r(} d t| dcYd} ~ |j Sd} ~ wwxYw#|j wxYw)aList detected code communities in the codebase. [EXPLORE] Retrieves stored communities from the knowledge graph. Each community represents a cluster of related code entities (functions, classes) detected via the Leiden algorithm or file-based grouping. Args: repo_root: Repository root path. Auto-detected if omitted. sort_by: Sort column: size, cohesion, or name. min_size: Minimum community size to include (default: 0). detail_level: "standard" (default) returns full community data; "minimal" returns only name, size, and cohesion per community. Returns: List of communities with size and cohesion scores. )sort_bymin_sizeminimalnamesizecohesion)rrrokzFound z communities)statussummary communitieslist_communities_hintserrorrrN)r rlenr r close Exceptionstr) repo_rootrr detail_levelstorerootrcresultexcs s/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/code_review_graph/tools/community_tools.pylist_communities_funcr(s0Y'KE4% 7X  9 $%6AfI1Z=QK K 01>&%  *   x  ! 6!CH55 6  s?BA<.B<B B2 B-B2B5-B22B55Cct|\}} d}t|}| |D]}|jd|k(s|}n2n0|.|D])}|j|djvs'|}n|ddd|j S|rA|jd} | .|j | } | D cgc] } t | } } | |d<dd |dd |d d |d d|d} td| t| d<| |j Scc} w#t$r(}dt|dcYd}~|j Sd}~wwxYw#|j wxYw)a$Get details of a single code community. [EXPLORE] Retrieves a community by its database ID or by name match. Optionally includes the full list of member nodes. Args: community_name: Name to search for (partial match). Ignored if community_id given. community_id: Database ID of the community. include_members: If True, include full member node details. repo_root: Repository root path. Auto-detected if omitted. Returns: Community details, or not_found status. Nidr not_foundz/No community found matching the given criteria.rrmember_detailsrz Community 'z': rz nodes, cohesion rz.4f)rr community get_communityrrr) r rgetlowerrget_nodes_by_community_idrr r rr)community_name community_idinclude_membersr r"r#r.all_communitiesr$cid member_nodesnmembersr%r&s r'get_community_funcr;Gs*Y'KE4.!% )%0  #$ 55;,. !I  '$ !'')QvY__->> !I   %E<  / --%C$>>sC 4@Aq<?AA.5 *+i/0V$%&%j1#68# * V[] x  'B 6!CH55 6  sR(D0D* D*D0D 9D D E D='E(E=EEEct|\}} t|}t|d}t|d}t|d}dd|d|d|dd |}td |t |d <||j S#t $r(}d t|d cYd}~|j Sd}~wwxYw#|j wxYw)aGenerate an architecture overview based on community structure. [EXPLORE] Builds a high-level view of the codebase architecture by analyzing community boundaries and cross-community coupling. Includes warnings for high coupling between communities. Args: repo_root: Repository root path. Auto-detected if omitted. Returns: Architecture overview with communities, cross-community edges, and warnings. rcross_community_edgeswarningsrzArchitecture: z communities, z cross-community edges, z warning(s)r,rrrrN)r rrr r rrr) r r"r#overview n_communitiesn_cross n_warningsr%r&s r'get_architecture_overview_funcrCs Y'KE4,U3H]34 h678*-.  ~)3,k+  * ' x   6!CH55 6  s0AB B1 B,B1B4,B11B44C)Nrrstandard) r str | Nonerrrintr!rreturndict[str, Any])NNFN) r3rEr4z int | Noner5boolr rErGrH)N)r rErGrH)__doc__ __future__rtypingrrrrgraphrhintsr r _commonr r(r;rCr'rRsI"D /!" .. .. .  .n"&#! DDDD D  DZ!&&&rQ