Vadym/obsidian

Fork 0

Vadym Samoilenko d6799adda2 vault backup: 2026-05-18 11:00:36

2026-05-18 11:00:36 +01:00

26 KiB

Raw Blame History

Graph Report - /Users/ai_leed/Documents/Projects/Oliver/modcomms (2026-05-18)

Corpus Check

cluster-only mode — file stats not available

Summary

1262 nodes · 2187 edges · 101 communities (86 shown, 15 thin omitted)
Extraction: 88% EXTRACTED · 12% INFERRED · 0% AMBIGUOUS · INFERRED: 260 edges (avg confidence: 0.72)
Token cost: 0 input · 0 output

Graph Freshness

Built from commit: 54eddd70
Run git rev-parse HEAD and compare to check if the graph is stale.
Run graphify update . after code changes (no API cost).

God Nodes (most connected - your core abstractions)

apiService.ts - 85 edges
campaigns table - 73 edges
GeminiService - 38 edges
knowledge_bases table - 27 edges
proof_repository.py - 26 edges
ReferenceDocsService - 22 edges
analysis_service.py - 22 edges
Lead Agent - 21 edges
add_textbox() - 20 edges
main() - 20 edges

Surprising Connections (you probably didn't know these)

Knowledge Base Pipeline Diagram --semantically_similar_to--> ADR: LlamaParse + Gemini Distillation for KB [INFERRED] [semantically similar] documentation/architecture/diagrams/rendered/07_knowledge_base_pipeline.png → docs/reference/adrs/2026-04-29-knowledge-base-pipeline.md
WebSocket Flow Diagram --conceptually_related_to--> Mod Comms Intelligent Review App [INFERRED] documentation/architecture/diagrams/rendered/03_websocket_flow.png → frontend/index.html
Database ERD Diagram --conceptually_related_to--> Mod Comms Intelligent Review App [INFERRED] documentation/architecture/diagrams/rendered/04_database_erd.png → frontend/index.html
Agent Pipeline Diagram --conceptually_related_to--> Mod Comms Intelligent Review App [INFERRED] documentation/architecture/diagrams/rendered/02_agent_pipeline.png → frontend/index.html
Auth RBAC Flow Diagram --conceptually_related_to--> Mod Comms Intelligent Review App [INFERRED] documentation/architecture/diagrams/rendered/06_auth_rbac_flow.png → frontend/index.html

Communities (101 total, 15 thin omitted)

Community 0 - "Community 0"

Cohesion: 0.06 Nodes (49): Config, DiffLine, KnowledgeBaseDetail, KnowledgeBaseListItem, Pydantic schemas for Knowledge Base API., SpecVersionDetail, SpecVersionListItem, AgencyAnalyticsItem (+41 more)

Community 1 - "Community 1"

Cohesion: 0.06 Nodes (48): ADR: LlamaParse + Gemini Distillation for KB, ADR: REST Polling over WebSocket, Agent Pipeline Diagram, Auth RBAC Flow Diagram, AnalysisJob In-Memory Store, Barclays Brand Identity, Digital Channel Strategy, Google Gemini API (+40 more)

Community 2 - "Community 2"

Cohesion: 0.05 Nodes (39): health_check(), HealthCheckFilter, info(), lifespan(), Health check endpoint., Get backend information. Requires authentication., Filter out health check endpoint logs from uvicorn access log., Initialize services on startup and cleanup on shutdown. (+31 more)

Community 3 - "Community 3"

Cohesion: 0.16 Nodes (37): ArchDocTemplate, build_agent_pipeline(), build_api_reference(), build_auth_rbac(), build_cover(), build_database_schema(), build_deployment(), build_env_vars() (+29 more)

Community 4 - "Community 4"

Cohesion: 0.07 Nodes (20): apiService.ts, delete_proof(), get_user_change_history(), Send support email - no auth required (for login page)., Delete a proof and its associated files., Get change history for a user (super_admin and oversight_admin)., Delete a proof type (super_admin only)., send_support_email() (+12 more)

Community 5 - "Community 5"

Cohesion: 0.07 Nodes (36): ModComms Project Overview (AGENTS.md), POST /api/analyze Endpoint, Audit API Endpoints, Campaigns API Endpoints, Knowledge Base API Endpoints, Apache HTTP Server, Auth Middleware (Azure AD JWT), KnowledgeBaseService (+28 more)

Community 6 - "Community 6"

Cohesion: 0.07 Nodes (20): IG_HERO_POST_1_FEEDBACK_V1, initialProjectAssets, initialProjects, ProjectsProps, agentIcons, StatusDashboardProps, StatusInfoProps, ToggleSwitchProps (+12 more)

Community 7 - "Community 7"

Cohesion: 0.06 Nodes (16): Get a single source document by ID., Update parse status of a source document., Get the active spec version for a given agent key., Repository for knowledge base database operations., List all spec versions for a knowledge base., Create a new spec version, auto-incrementing version number and deactivating pri, List all knowledge bases with eager-loaded relationships., Create a new processing job. (+8 more)

Community 8 - "Community 8"

Cohesion: 0.08 Nodes (32): gemini_service.py, geminiService.ts, main.py (FastAPI entry), Cloud Run ModComms Backend Service, Docker Compose Backend Service, Docker Compose PostgreSQL Service, ai_scorer.py (Claude-based), Anthropic API (Claude Sonnet) (+24 more)

Community 9 - "Community 9"

Cohesion: 0.08 Nodes (16): AssetPreviewProps, CampaignsProps, IG_HERO_POST_1_FEEDBACK_V1, IG_HERO_POST_1_FEEDBACK_V2, initialCampaignProofs, initialCampaigns, ProofDetailView(), SortDirection (+8 more)

Community 10 - "Community 10"

Cohesion: 0.09 Nodes (27): ADR: Five-Agent Parallel Analysis with Gemini 2.5 Pro, Channel Best Practices Agent - analyzes proofs for creative best practices and c, Initialize the Channel Best Practices Agent. Args: gemini_s, Build prompt section for revision-aware analysis., Analyze the proof for channel best practices and content strategy. Args, ModComms Technical Architecture PDF, Frontend Hierarchy Diagram, System Overview Diagram (+19 more)

Community 11 - "Community 11"

Cohesion: 0.08 Nodes (15): proof_repository.py, get_proof(), Create a new version of a proof., Get a specific version of a proof., Get proof version by ID., Get the latest version number for a proof., Get the file_hash from the latest version of a proof., Get the agent_review from the previous version (N-1) of a proof. Args: (+7 more)

Community 12 - "Community 12"

Cohesion: 0.09 Nodes (27): _check_campaign_access(), delete_campaign(), export_campaigns_csv(), get_analytics(), get_campaign(), get_me(), list_campaigns(), list_error_items() (+19 more)

Community 13 - "Community 13"

Cohesion: 0.11 Nodes (19): CheckDetail, specialistAgents, formatFeedbackText(), hasRevisionData(), LeadAgentSummary(), renderBoldMarkdown(), SubReviewCard(), PDFReportProps (+11 more)

Community 14 - "Community 14"

Cohesion: 0.08 Nodes (21): add_channel(), add_proof_type(), add_sub_channel(), delete_channel(), delete_sub_channel(), get_dropdown_options(), Get all dropdown options as hierarchical structure., Add a new channel (super_admin only). (+13 more)

Community 15 - "Community 15"

Cohesion: 0.08 Nodes (17): Analytics(), navigation, NavItem, Sidebar(), SidebarProps, ConfirmationContent, ErrorContent, FilePreviewContent (+9 more)

Community 16 - "Community 16"

Cohesion: 0.13 Nodes (26): Base, DeclarativeBase, Base, Base class for all SQLAlchemy models., Agency, ErrorItem, FlaggedItem, ProcessingJob (+18 more)

Community 17 - "Community 17"

Cohesion: 0.10 Nodes (25): activate_spec_version(), delete_source_document(), get_knowledge_base(), get_processing_job(), list_knowledge_bases(), list_spec_versions(), REST API routes for Knowledge Base management., Upload a source document to a knowledge base. (+17 more)

Community 18 - "Community 18"

Cohesion: 0.13 Nodes (18): ABC, analysis_service.py, BaseAgent, Abstract base class for all review agents., Channel Tech Specs Agent - analyzes proofs for technical specifications and form, Initialize the Channel Tech Specs Agent. Args: gemini_servi, LegalAgent, Legal Agent - analyzes proofs for legal compliance using Gemini. (+10 more)

Community 19 - "Community 19"

Cohesion: 0.11 Nodes (15): CopyGenAI(), mockConversations, DEFAULT_AGENCIES, INITIAL_USERS, Settings(), SettingsProps, Tab, User (+7 more)

Community 20 - "Community 20"

Cohesion: 0.11 Nodes (13): Load and return all channel guideline documents as a single context string., Load and return the Channel Best Practices specification., Load and return the Channel Tech Specs specification., Load and return the Legal specification., Load all .md files from a directory and concatenate them. Args:, Return summary info about loaded documents., Load active spec content from DB for all agent keys., Service to load and provide reference documents for agents. (+5 more)

Community 21 - "Community 21"

Cohesion: 0.12 Nodes (17): GeminiService, Run a single agent with callback notifications., Analyze a proof using all agents in parallel. Args: file_da, getAccessToken(), Analyze multiple images with Gemini and return a structured SubReview., Service wrapper for Google Gemini API calls., Initialize the Gemini service. Args: api_key: Google Gemini, Generate a text summary (for lead agent). Args: prompt: The (+9 more)

Community 22 - "Community 22"

Cohesion: 0.10 Nodes (12): create_agency(), list_users(), List all users (super_admin and oversight_admin)., Update a user's role and/or agency (super_admin only)., Create a new agency (super_admin only)., update_user(), Update user role and/or agency. Pass agency_id=None to unassign., Insert a user change log entry. (+4 more)

Community 23 - "Community 23"

Cohesion: 0.11 Nodes (13): AgencyFilterBar(), Auditing(), AuditingProps, Hero(), HeroProps, AppContent(), View, ErrorItem (+5 more)

Community 24 - "Community 24"

Cohesion: 0.11 Nodes (12): StorageService, Generate a data URL for the file (for small previews)., Calculate MD5 checksum of file data., Store a knowledge base source document and return the storage key., Service for storing and retrieving proof files., Ensure the storage directory exists., Generate a unique storage key for a file., Get the full file path for a storage key. (+4 more)

Community 25 - "Community 25"

Cohesion: 0.13 Nodes (12): Login(), accounts, msalInstance, payload, root, rootElement, BarclaysLogo(), MicrosoftLogo() (+4 more)

Community 26 - "Community 26"

Cohesion: 0.13 Nodes (15): Analysis Pipeline, analysis_routes.py, Format reviews as a readable string for the prompt., Determine overall status using local logic (without Gemini). This can b, Build revision context section for the synthesis prompt., Lead Agent - synthesizes specialist agent reviews into a final summary. App, Synthesize specialist reviews into final status and summary. Args:, reference_docs.py (ReferenceDocsService) (+7 more)

Community 27 - "Community 27"

Cohesion: 0.19 Nodes (18): add_rich_textbox(), add_textbox(), make_agenda_slide(), make_closing_slide(), make_problem_slide(), make_section_divider(), make_solution_slide(), make_title_slide() (+10 more)

Community 28 - "Community 28"

Cohesion: 0.17 Nodes (12): CampaignList(), Profile(), ProfileProps, ROLE_LABELS, UserContext, UserContextValue, UserProvider(), useUser() (+4 more)

Community 29 - "Community 29"

Cohesion: 0.11 Nodes (17): compilerOptions, allowImportingTsExtensions, allowJs, experimentalDecorators, isolatedModules, jsx, lib, module (+9 more)

Community 30 - "Community 30"

Cohesion: 0.13 Nodes (9): create_campaign(), Create a new campaign., Get campaigns with proof counts., Repository for campaign-related database operations., Get campaign by ID with related data., Get campaign by name., List campaigns, optionally filtered by agency., Update campaign fields. (+1 more)

Community 31 - "Community 31"

Cohesion: 0.16 Nodes (11): Brand Agent - analyzes proofs against Barclays brand guidelines using Gemini., Get the appropriate brand specification based on the brand selection. A, Build prompt section for revision-aware analysis., Analyze the proof for brand guideline adherence. Args: imag, Initialize the Lead Agent. Args: gemini_service: Service fo, AnalysisService (Orchestrator), Brand Agent, Channel Agent (+3 more)

Community 32 - "Community 32"

Cohesion: 0.13 Nodes (14): get_current_db_user(), get_current_user(), FastAPI authentication dependencies. Provides dependency functions for securing, Dependency factory that restricts access to users with specific roles. Usag, Dependency for write/mutation operations., FastAPI dependency to verify the access token and return user claims. Use a, Resolve Azure AD claims to a full User ORM object with agency loaded. Creat, require_role() (+6 more)

Community 33 - "Community 33"

Cohesion: 0.13 Nodes (10): Background task: run the full analysis pipeline and update job state., _run_analysis(), flag_proof_version(), Flag an issue on a proof version., Resolve an issue on a proof version., resolve_proof_version(), Create a new error item., Create a new flagged item. (+2 more)

Community 34 - "Community 34"

Cohesion: 0.15 Nodes (15): CAP/BCAP Code Requirements, COBS 4.5 Communication Standards, Comparative Advertising Requirements, Consumer Duty Requirements, Disclaimers and Terms Requirements, FCA Principles for Business, Financial Promotion Definition, Third-Party and Influencer Content Rules (+7 more)

Community 35 - "Community 35"

Cohesion: 0.14 Nodes (11): Return flat rows for CSV export: Campaign → Proof → ProofVersion joined with Age, PDFService, PDF Rasterization Service. Converts PDF pages to PNG images for analysis and di, Service for PDF rasterization operations., Convert PDF pages to PNG images. Args: pdf_data: Raw PDF fi, Get the number of pages in a PDF. Args: pdf_data: Raw PDF f, str, downgrade() (+3 more)

Community 36 - "Community 36"

Cohesion: 0.21 Nodes (10): knowledge_bases table, DiffLine, DiffResult, KnowledgeBaseListItem, ProcessingJob, ProofVersion, SourceDocument, SpecVersionDetail (+2 more)

Community 37 - "Community 37"

Cohesion: 0.23 Nodes (10): AnalyzeRequest, poll_analysis(), Submit a proof for analysis. Returns job_id immediately., Poll the status of an analysis job., submit_analysis(), AnalysisJob, _cleanup_old_jobs(), create_job() (+2 more)

Community 38 - "Community 38"

Cohesion: 0.20 Nodes (3): agentPerformance, BugIcon(), UploadIcon()

Community 39 - "Community 39"

Cohesion: 0.17 Nodes (12): Cyan Brand Asset Usage, Eagle Brand Asset Usage, Logo Brand Asset Usage, Barclays Sacred Assets (Logo, Eagle, Cyan), Barclays Expression Brand Architecture, Barclays Expression Sacred Assets, Endorsed Brand Architecture, Brand Architecture Expression Guidelines (+4 more)

Community 40 - "Community 40"

Cohesion: 0.18 Nodes (12): add_connector_line(), add_rounded_rect(), make_admin_three_col_slide(), make_campaign_lifecycle_slide(), make_knowledge_base_slide(), make_tech_architecture_slide(), Slide 21: Analytics, Auditing & Settings (3-column)., Slide 23: Technical Architecture (layered diagram). (+4 more)

Community 41 - "Community 41"

Cohesion: 0.22 Nodes (11): Barclays Accessibility Guidelines, Diversity Equity Inclusion Guidelines, Barclays Portal Asset, Barclays Expression Core Principles, Barclays Expression Sustainability, Barclays Expression Voice Guidelines, Digital Colour System, Digital Optimised Eagle (+3 more)

Community 42 - "Community 42"

Cohesion: 0.24 Nodes (10): Barclaycard Capturing Possibilities Platform, Barclaycard Card Portal, Barclaycard Colour Palette, Barclaycard Design Principles, Barclaycard Logo Guidelines, Barclaycard Sacred Assets, Barclaycard Core Principles, Barclaycard Brand Voice (+2 more)

Community 43 - "Community 43"

Cohesion: 0.24 Nodes (10): Barclaycard Atom Design, Barclaycard Blueprint Digital System, Barclaycard Digital Colour, Barclaycard GDE, Barclaycard Digital Logo, Barclaycard Digital Photography Types, Barclaycard Digital Guidelines, Atomic Design System (+2 more)

Community 44 - "Community 44"

Cohesion: 0.20 Nodes (10): add_bullet_list(), make_content_slide(), make_legal_agent_slide(), make_user_roles_slide(), make_websocket_slide(), Slide 22: User Roles & Access Control (table-style)., Standard content slide with heading and bullet list., Slide 9: Legal Agent deep dive. (+2 more)

Community 45 - "Community 45"

Cohesion: 0.28 Nodes (9): main(), make_brand_agent_slide(), make_channel_agents_slide(), make_feedback_reports_slide(), make_two_column_slide(), Two-column content slide., Slide 10: Brand Agent deep dive., Slide 11: Channel agents deep dive. (+1 more)

Community 46 - "Community 46"

Cohesion: 0.25 Nodes (4): Get all error items, optionally filtered by agency., Get combined audit log with flagged, resolved, and error items., Get all flagged items, optionally filtered by agency., Get all resolved items, optionally filtered by agency.

Community 47 - "Community 47"

Cohesion: 0.39 Nodes (6): get_url(), Run migrations in 'offline' mode., Run migrations in 'online' mode with async engine., run_async_migrations(), run_migrations_offline(), run_migrations_online()

Community 48 - "Community 48"

Cohesion: 0.25 Nodes (8): Connected Brand Voice Trait, Barclays Language and Lexicon, Optimistic Brand Voice Trait, Pioneering Brand Voice Trait, Professional Brand Voice Trait, Barclays Brand Voice Toolkit, Tone Flexing Guidance, Barclays Writing Style Guidelines

Community 49 - "Community 49"

Cohesion: 0.33 Nodes (7): User Management and Authentication, Campaigns Management Feature, Core App Navigation Structure, Proofs Asset Level Management, Mod Comms App Requirements Document, BAR TYE Digital Clock Display Proof, BAR TYE Web Banners 320x50 Proof

Community 50 - "Community 50"

Cohesion: 0.33 Nodes (6): get_spec_diff(), get_spec_version(), Get full spec content for a version., Compute diff between two spec versions., DiffResponse, Get a spec version by ID.

Community 51 - "Community 51"

Cohesion: 0.33 Nodes (6): Social Media Accessibility, Social Media Co-branding Guidelines, Social Media Logo Guidelines, Social Media Motion Guidelines, Social Media Portal Sizes, Barclays Social Media Guideline

Community 52 - "Community 52"

Cohesion: 0.33 Nodes (6): add_circle(), make_agent_architecture_slide(), make_rag_status_slide(), Add a circle shape with centered text., Slide 8: Agent architecture diagram., Slide 12: RAG Status & Decision Logic.

Community 53 - "Community 53"

Cohesion: 0.40 Nodes (5): buildUrl(), pushUrlState(), UrlNavigationState, VALID_VIEWS, View

Community 54 - "Community 54"

Cohesion: 0.40 Nodes (5): Enum, OverallStatus, RagStatus, Overall status for the proof review., RAG status for agent reviews.

Community 55 - "Community 55"

Cohesion: 0.40 Nodes (3): Application settings loaded from environment variables., Validate required settings are present., Settings

Community 56 - "Community 56"

Cohesion: 0.40 Nodes (5): BDL Colour Guidance, BDL Materials Guidance, BDL Sustainability Guidelines, BDL Toolkit, Brand Design Language Core

Community 57 - "Community 57"

Cohesion: 0.40 Nodes (4): EmailService, Email service for sending support emails via Mailgun., Send a support email via Mailgun API. Args: message: The me, Service for sending emails via Mailgun API.

Community 58 - "Community 58"

Cohesion: 0.40 Nodes (4): downgrade(), Remove all seeded data., Seed default channel/sub-channel/proof-type options, agencies, and brand guideli, upgrade()

Community 59 - "Community 59"

Cohesion: 0.40 Nodes (4): downgrade(), Add proof types for Meta sub-channel if they don't exist., Remove Meta proof types added by this migration., upgrade()

Community 60 - "Community 60"

Cohesion: 0.40 Nodes (4): downgrade(), Remove unique constraints (cannot restore deleted duplicates)., Remove duplicate dropdown options, keeping the ones with children (proof types)., upgrade()

Community 61 - "Community 61"

Cohesion: 0.50 Nodes (4): get_file(), get_pdf_pages(), Rasterize a stored PDF and return pages as data URLs., Retrieve a stored file by its storage key.

Community 64 - "Community 64"

Cohesion: 0.50 Nodes (3): description, name, requestFramePermissions

Community 65 - "Community 65"

Cohesion: 0.67 Nodes (3): get_analytics_by_agency(), Get per-agency analytics breakdown (admin only)., Get analytics data grouped by agency.

Knowledge Gaps

195 isolated node(s): msalInstance, accounts, payload, rootElement, root (+190 more) These have ≤1 connection - possible missing edges or undocumented components.
15 thin communities (<3 nodes) omitted from report — run graphify query to explore isolated nodes.

26 KiB Raw Blame History